Copyright (c) 2021 IIASA

Template repository for creating python packages and Sphinx-based documentation pages in line with the IIASA design guidelines

To start a new Python package from this repo, click on the green Use this template button on top-right of this page. Detailed instructions to create a new repository from a template can be found here.

Then, make the following changes:

0. Change the text of the LICENSE file (optional). Visit choosealicense.com to find out which license is right for your project.
1. Update the copyright (if other than IIASA) in this readme.
2. Update the url in the license badge in this readme to point to your new repository. This will automatically change the license badge (if you changed the license).
3. Rename the folder python_stub to the intended package name.
4. Update the package name, author info and url in setup.cfg.
5. Update the package name, author info and copyright in doc/source/conf.py.
6. Delete the configuration section from this readme and update the title and overview section.

Make sure to commit all changes to your new repository - then program away!

This package uses the Black code style. A GitHub Action workflow is configured to check that your commits conform to the style.

We recommend that you follow the numpydoc docstring formatting guide.

Looking for more best-practice tools for scientific software development? Take a look at the cookiecutter-hypermodern-python repository!

Install the package including the requirements for building the docs.

pip install --editable .[doc]

Run Sphinx to build the docs!

make --directory=doc html

The rendered html pages will be located in doc/build/html/index.html.