cookiecutter v0.7.0 Release Notes

Release Date: 2013-11-09 // over 10 years ago
  • ๐Ÿš€ This is a release with significant improvements and changes. Please read through this list before you upgrade.

    ๐Ÿ†• New features:

    • ๐Ÿ‘Œ Support for --checkout argument, thanks to @foobacca.
    • ๐Ÿ‘Œ Support for pre-generate and post-generate hooks, thanks to @raphigaziano. Hooks are Python or shell scripts that run before and/or after your project is generated.
    • ๐Ÿ‘Œ Support for absolute paths to cookiecutters, thanks to @krallin.
    • ๐Ÿ‘Œ Support for Mercurial version control system, thanks to @pokoli.
    • ๐Ÿ‘ When a cookiecutter contains invalid Jinja2 syntax, you get a better message that shows the location of the TemplateSyntaxError. Thanks to @benjixx.
    • 0๏ธโƒฃ Can now prompt the user to enter values during generation from a local cookiecutter, thanks to @ThomasChiroux. This is now always the default behavior. Prompts can also be suppressed with --no-input.
    • ๐Ÿ Your cloned cookiecutters are stored by default in your ~/.cookiecutters/ directory (or Windows equivalent). The location is configurable. (This is a major change from the pre-0.7.0 behavior, where cloned cookiecutters were deleted at the end of project generation.) Thanks @raphigaziano.
    • 0๏ธโƒฃ User config in a ~/.cookiecutterrc file, thanks to @raphigaziano. Configurable settings are cookiecutters_dir and default_context.
    • File permissions are now preserved during project generation, thanks to @benjixx.

    ๐Ÿ› Bug fixes:

    • ๐Ÿ›  Unicode issues with prompts and answers are fixed, thanks to @s-m-i-t-a.
    • ๐Ÿ The test suite now runs on Windows, which was a major effort. Thanks to @pydanny, who collaborated on this with me.

    Other changes:

    • ๐Ÿ”จ Quite a bit of refactoring and API changes.
    • ๐Ÿ“š Lots of documentation improvements. Thanks @sloria, @alex, @pydanny, @freakboy3742, @es128, @rolo.
    • ๐Ÿ‘ Better naming and organization of test suite.
    • โœ… A CookiecutterCleanSystemTestCase to use for unit tests affected by the user\'s config and cookiecutters directory.
    • ๐Ÿ‘Œ Improvements to the project\'s Makefile.
    • ๐Ÿ‘Œ Improvements to tests. Thanks @gperetin, @s-m-i-t-a.
    • Removal of subprocess32 dependency. Now using non-context manager version of subprocess.Popen for Python 2 compatibility.
    • Removal of cookiecutter\'s cleanup module.
    • A bit of setup.py cleanup, thanks to @oubiga.
    • Now depends on binaryornot 0.2.0.