Organizing cookiecutters in directories

.. _directories:

Organizing cookiecutters in directories

New in Cookiecutter 1.7

Cookiecutter introduces the ability to organize several templates in one repository or zip file, separating them by directories. This allows using symlinks for general files. Here's an example repository demonstrating this feature::

https://github.com/user/repo-name.git
    ├── directory1-name/
    |   ├── {{cookiecutter.project_slug}}/
    |   └── cookiecutter.json
    └── directory2-name/
        ├── {{cookiecutter.project_slug}}/
        └── cookiecutter.json

To activate one of templates within a subdirectory, use the --directory option:

.. code-block:: bash

cookiecutter https://github.com/user/repo-name.git --directory="directory1-name"