/pretix-plugin-cookiecutter

Cookiecutter template for pretix plugins

Primary LanguagePython

pretix-plugin-cookiecutter

A simple cookiecutter template to bootstrap a pretix plugin.

Usage

Let's pretend you want to create a pretix plugin called "superplugin". First, create a virtual environment and install the cookiecutter package using pip. Next, use it to bootstrap your project folder:

$ cd <your-project-folder-parent>
$ cookiecutter https://github.com/pretix/pretix-plugin-cookiecutter

You'll be prompted for some questions. Answer them, and you will find a project folder created for you:

repo_name [pretix-superplugin]: pretix-superplugin
repo_url [GitHub repository URL]: https://github.com/myuser/pretix-superplugin
module_name [pretix_superplugin]: pretix_superplugin
human_name [The pretix super plugin]: Super Plugin
author_name [Your name]: J Random Developer
author_email [Your email]: jrandom@example.org
year [Current year]: 2017
short_description [Short description]: The best plugin

Now, change to the newly created directory:

$ cd pretix-superplugin

VoilĂ , there's your plugin structure! See pretix' documentation for more info.