Options during Setup

To use the package template run cookiecutter gh:astropy/package-template, once you have run this command you will be asked a series of questions. Below is a description of each of the prompts:

  1. package_name: This is a human readable name for your package, like Astropy or SunPy.
  2. module_name: This is the name of your python package i.e. astropy or sunpy.
  3. short_description: This is a one sentence description of your package.
  4. long_description: This is a multi-line description of your package.
  5. author_name: The name or names of the authors.
  6. author_email: A contact email for the authors.
  7. license: The license of your package.
  8. project_url: Project website.
  9. project_version: The version number for the package.
  10. include_example_code: This includes a set of example python files showing you how to use the package template. If you choose n then none of this will be included and you will have to populate the directory structure before you can import the package.
  11. include_example_cython_code: This includes a set of example Cython code, which demonstrates how to add compiled code to the package.
  12. include_cextern_folder: The cextern folder should be used if you are including non-python C code.
  13. edit_on_github_extension: Set to True to enable the edit on GitHub sphinx extension.
  14. github_project: This is the GitHub identifier for the edit on GitHub extension and the changelog link extension.
  15. use_travis_ci: If 'y' the template will include an example .travis.yml file for the Travis CI service.
  16. use_appveyor_ci: If 'y' the template will include an example appveyor.yml file for the Appveyor CI service.
  17. use_read_the_docs: If 'y' the read_the_docs.yml and .rtd-environment.yml files will be included for using conda on Read the Docs.
  18. sphinx_theme: The value of the html_theme variable in the sphinx configuration file.
  19. initialize_git_repo: If gitpython is installed this option will turn the rendered package into a git repository and add and initilize the astropy_helpers submodule.
  20. astropy_helpers_version: The version number of the astropy_helpers submodule to be used, only used if initialize_git_repo is true.

Once the project has been set up, any of the values can still be manually updated. In addition, further customization can also be carreid out in the Next Steps.