The primary goal of this release was to add command-line support for passing extra context, address minor bugs and make a number of
improvements.
New Features:
* Inject extra context with command-line arguments, thanks to [msabramo](https://github.com/msabramo) and [michaeljoseph](https://github.com/michaeljoseph) (#666).
* Updated conda installation instructions to work with the new conda-forge distribution of Cookiecutter, thanks to [pydanny](https://github.com/pydanny) and especially [bollwyvl](https://github.com/bollwyvl) (#232, 705).
* Refactor code responsible for interaction with version control systems and raise better error messages, thanks to [michaeljoseph](https://github.com/michaeljoseph) (#778).
* Add support for executing cookiecutter using `python -m cookiecutter` or from a checkout/zip file, thanks to [brettcannon](https://github.com/brettcannon) (#788).
* New CLI option `--debug-file PATH` to store a log file on disk. By default no log file is written. Entries for `DEBUG` level and higher. Thanks to [hackebrot](https://github.com/hackebrot)(#792).
* Existing templates in a user\'s `cookiecutters_dir` (default is `~/.cookiecutters/`) can now be referenced by directory name, thanks
to [michaeljoseph](https://github.com/michaeljoseph) (#825).
* Add support for dict values in `cookiecutter.json`, thanks to [freakboy3742](https://github.com/freakboy3742) and [hackebrot](https://github.com/hackebrot) (#815, 858).
* Add a `jsonify` filter to default jinja2 extensions that json.dumps a Python object into a string, thanks to [aroig](https://github.com/aroig) (#791).
Bug Fixes:
* Fix typo in the error logging text for when a hook did not exit successfully, thanks to [luzfcb](https://github.com/luzfcb) (#656)
* Fix an issue around **replay** file names when **cookiecutter** is used with a relative path to a template, thanks to [eliasdorneles](https://github.com/eliasdorneles) for raising the issue and [hackebrot](https://github.com/hackebrot) for the PR (#752, 753)
* Ignore hook files with tilde-suffixes, thanks to [hackebrot](https://github.com/hackebrot) (#768)
* Fix a minor issue with the code that generates a name for a template, thanks to [hackebrot](https://github.com/hackebrot)(#798)
* Handle empty hook file or other OS errors, thanks to [christianmlong](https://github.com/christianmlong) for raising this bug and [jcarbaugh](https://github.com/jcarbaugh) and [hackebrot](https://github.com/hackebrot) for the fix (#632, 729, 862)
* Resolve an issue with custom extensions not being loaded for `pre_gen_project` and `post_gen_project` hooks, thanks to [cheungnj](https://github.com/cheungnj) (#860)
Other Changes:
* Remove external dependencies from tests, so that tests can be run w/o network connection, thanks to [hackebrot](https://github.com/hackebrot) (#603)
* Remove execute permissions on Python files, thanks to [mozillazg](https://github.com/mozillazg) (#650)
* Report code coverage info from AppVeyor build to codecov, thanks to [ewjoachim](https://github.com/ewjoachim) (#670)
* Documented functions and methods lacking documentation, thanks to [pydanny](https://github.com/pydanny) (#673)
* Documented `__init__` methods for Environment objects, thanks to [pydanny](https://github.com/pydanny) (#677)
* Updated whichcraft to 0.4.0, thanks to [pydanny](https://github.com/pydanny).
* Updated documentation link to Read the Docs, thanks to [natim](https://github.com/Natim) (#687)
* Moved cookiecutter templates and added category links, thanks to [willingc](https://github.com/willingc) (#674)
* Added Github Issue Template, thanks to [luzfcb](https://github.com/luzfcb) (#700)
* Added `ssh` repository examples, thanks to [pokoli](https://github.com/pokoli/) (#702)
* Fix links to the cookiecutter-data-science template and its documentation, thanks to [tephyr](https://github.com/tephyr) for the PR and [willingc](https://github.com/willingc) for the review (#711, 714)
* Update link to docs for Django\'s `--template` command line option, thanks to [purplediane](https://github.com/purplediane) (#754)
* Create *hook backup files* during the tests as opposed to having them as static files in the repository, thanks to [hackebrot](https://github.com/hackebrot) (#789)
* Applied PEP 257 docstring conventions to:
* `environment.py`, thanks to [terryjbates](https://github.com/terryjbates) (#759)
* `find.py`, thanks to [terryjbates](https://github.com/terryjbates) (#761)
* `generate.py`, thanks to [terryjbates](https://github.com/terryjbates) (#764)
* `hooks.py`, thanks to [terryjbates](https://github.com/terryjbates) (#766)
* `repository.py`, thanks to [terryjbates](https://github.com/terryjbates) (#833)
* `vcs.py`, thanks to [terryjbates](https://github.com/terryjbates) (#831)
* Fix link to the Tryton cookiecutter, thanks to [cedk](https://github.com/cedk) and [nicoe](https://github.com/nicoe) (#697, 698)
* Added PyCon US 2016 sponsorship to README, thanks to [purplediane](https://github.com/purplediane) (#720)
* Added a sprint contributor doc, thanks to [phoebebauer](https://github.com/phoebebauer) (#727)
* Converted readthedocs links (.org -\> .io), thanks to [adamchainz](https://github.com/adamchainz) (#718)
* Added Python 3.6 support, thanks to [suledev](https://github.com/suledev) (#728)
* Update occurrences of `repo_name` in documentation, thanks to [palmerev](https://github.com/palmerev) (#734)
* Added case studies document, thanks to [pydanny](https://github.com/pydanny) (#735)
* Added first steps cookiecutter creation tutorial, thanks to [BruceEckel](https://github.com/BruceEckel) (#736)
* Reorganised tutorials and setup git submodule to external tutorial, thanks to [dot2dotseurat](https://github.com/dot2dotseurat) (#740)
* Debian installation instructions, thanks to [ivanlyon](https://github.com/ivanlyon) (#738)
* Usage documentation typo fix., thanks to [terryjbates](https://github.com/terryjbates) (#739)
* Updated documentation copyright date, thanks to [zzzirk](https://github.com/zzzirk) (#747)
* Add a make rule to update git submodules, thanks to [hackebrot](https://github.com/hackebrot) (#746)
* Split up advanced usage docs, thanks to [zzzirk](https://github.com/zzzirk) (#749)
* Documentation for the `no_input` option, thanks to [pokoli](https://github.com/pokoli/) (#701)
* Remove unnecessary shebangs from python files, thanks to [michaeljoseph](https://github.com/michaeljoseph) (#763)
* Refactor cookiecutter template identification, thanks to [michaeljoseph](https://github.com/michaeljoseph) (#777)
* Add a `cli_runner` test fixture to simplify CLI tests, thanks to [hackebrot](https://github.com/hackebrot) (#790)
* Add a check to ensure cookiecutter repositories have JSON context, thanks to [michaeljoseph](https://github.com/michaeljoseph)(#782)
* Rename the internal function that determines whether a file should be rendered, thanks to [audreyfeldroy](https://github.com/audreyfeldroy) for raising the issue and [hackebrot](https://github.com/hackebrot)for the PR (#741, 802)
* Fix typo in docs, thanks to [mwarkentin](https://github.com/mwarkentin) (#828)
* Fix broken link to *Invoke* docs, thanks to [B3QL](https://github.com/B3QL) (#820)
* Add documentation to `render_variable` function in `prompt.py`, thanks to [pydanny](https://github.com/pydanny) (#678)
* Fix python3.6 travis-ci and tox configuration, thanks to [luzfcb](https://github.com/luzfcb) (#844)
* Add missing encoding declarations to python files, thanks to [andytom](https://github.com/andytom) (#852)
* Disable poyo logging for tests, thanks to [hackebrot](https://github.com/hackebrot) (#855)
* Remove pycache directories in make clean-pyc, thanks to [hackebrot](https://github.com/hackebrot) (#849)
* Refactor hook system to only find the requested hook, thanks to [michaeljoseph](https://github.com/michaeljoseph) (#834)
* Add tests for custom extensions in `pre_gen_project` and `post_gen_project` hooks, thanks to [hackebrot](https://github.com/hackebrot) (#856)
* Make the build reproducible by avoiding nondeterministic keyword arguments, thanks to [lamby](https://github.com/lamby) and [hackebrot](https://github.com/hackebrot) (#800, 861)
* Extend CLI help message and point users to the github project to engage with the community, thanks to [hackebrot](https://github.com/hackebrot) (#859)
* Added more cookiecutter templates to the mix:
* [cookiecutter-funkload-friendly](https://github.com/tokibito/cookiecutter-funkload-friendly) by [tokibito](https://github.com/tokibito) (#657)
* [cookiecutter-reveal.js](https://github.com/keimlink/cookiecutter-reveal.js) by [keimlink](https://github.com/keimlink) (#660)
* [cookiecutter-python-app](https://github.com/mdklatt/cookiecutter-python-app) by [mdklatt](https://github.com/mdklatt) (#659)
* [morepath-cookiecutter](https://github.com/morepath/morepath-cookiecutter) by [href](https://github.com/href) (#672)
* [hovercraft-slides](https://github.com/Springerle/hovercraft-slides) by [jhermann](https://github.com/jhermann) (#665)
* [cookiecutter-es6-package](https://github.com/ratson/cookiecutter-es6-package) by [ratson](https://github.com/ratson) (#667)
* [cookiecutter-webpack](https://github.com/hzdg/cookiecutter-webpack) by [hzdg](https://github.com/hzdg) (#668)
* [cookiecutter-django-herokuapp](https://github.com/dulaccc/cookiecutter-django-herokuapp) by [dulaccc](https://github.com/dulaccc) (#374)
* [cookiecutter-django-aws-eb](https://github.com/dolphinkiss/cookiecutter-django-aws-eb) by [peterlauri](https://github.com/peterlauri) (#626)
* [wagtail-starter-kit](https://github.com/tkjone/wagtail-starter-kit) by [tkjone](https://github.com/tkjone) (#658)
* [cookiecutter-dpf-effect](https://github.com/SpotlightKid/cookiecutter-dpf-effect) by [SpotlightKid](https://github.com/SpotlightKid) (#663)
* [cookiecutter-dpf-audiotk](https://github.com/SpotlightKid/cookiecutter-dpf-audiotk) by [SpotlightKid](https://github.com/SpotlightKid) (#663)
* [cookiecutter-template](https://github.com/eviweb/cookiecutter-template) by [eviweb](https://github.com/eviweb) (#664)
* [cookiecutter-angular2](https://github.com/matheuspoleza/cookiecutter-angular2) by [matheuspoleza](https://github.com/matheuspoleza) (#675)
* [cookiecutter-data-science](http://drivendata.github.io/cookiecutter-data-science/) by [pjbull](https://github.com/pjbull) (#680)
* [cc\_django\_ember\_app](https://bitbucket.org/levit_scs/cc_django_ember_app) by [nanuxbe](https://github.com/nanuxbe) (#686)
* [cc\_project\_app\_drf](https://bitbucket.org/levit_scs/cc_project_app_drf) by [nanuxbe](https://github.com/nanuxbe) (#686)
* [cc\_project\_app\_full\_with\_hooks](https://bitbucket.org/levit_scs/cc_project_app_full_with_hooks) by [nanuxbe](https://github.com/nanuxbe) (#686)
* [beat-generator](https://github.com/elastic/beat-generator) by [ruflin](https://github.com/ruflin) (#695)
* [cookiecutter-scala](https://github.com/Plippe/cookiecutter-scala) by [Plippe](https://github.com/Plippe) (#751)
* [cookiecutter-snakemake-analysis-pipeline](https://github.com/xguse/cookiecutter-snakemake-analysis-pipeline) by [xguse](https://github.com/xguse) (#692)
* [cookiecutter-py3tkinter](https://github.com/ivanlyon/cookiecutter-py3tkinter) by [ivanlyon](https://github.com/ivanlyon) (#730)
* [pyramid-cookiecutter-alchemy](https://github.com/Pylons/pyramid-cookiecutter-alchemy) by [stevepiercy](https://github.com/stevepiercy) (#745)
* [pyramid-cookiecutter-starter](https://github.com/Pylons/pyramid-cookiecutter-starter) by [stevepiercy](https://github.com/stevepiercy) (#745)
* [pyramid-cookiecutter-zodb](https://github.com/Pylons/pyramid-cookiecutter-zodb) by [stevepiercy](https://github.com/stevepiercy) (#745)
* [substanced-cookiecutter](https://github.com/Pylons/substanced-cookiecutter) by [stevepiercy](https://github.com/stevepiercy) (#745)
* [cookiecutter-simple-django-cn](https://github.com/shenyushun/cookiecutter-simple-django-cn) by [shenyushun](https://github.com/shenyushun) (#765)
* [cookiecutter-pyqt5](https://github.com/mandeepbhutani/cookiecutter-pyqt5) by [mandeepbhutani](https://github.com/mandeepbhutani) (#797)
* [cookiecutter-xontrib](https://github.com/laerus/cookiecutter-xontrib) by [laerus](https://github.com/laerus) (#817)
* [cookiecutter-reproducible-science](https://github.com/mkrapp/cookiecutter-reproducible-science) by [mkrapp](https://github.com/mkrapp) (#826)
* [cc-automated-drf-template](https://github.com/TAMU-CPT/cc-automated-drf-template) by [elenimijalis](https://github.com/elenimijalis) (#832)