cookiecutter-nist-python

Cookiecutter template for python packages at NIST.

Overview

This template includes all NIST specific branding for creating a python package.

Features

• Testing with pytest
• Isolated testing, documentation building, etc, with nox
• Linting with pre-commit
• Documentation with Sphinx, MyST, using either the furo or sphinx-book-theme theme.
• Simple commands to upload package to [pypi], or a personal conda channel.
• Simple commands to release documentation to nist-pages
• Works with both conda and virtualenv based environments.
• Handle creation of requirements.txt and environment.yaml files with pyproject2conda

Status

This package is actively used by the author. Please feel free to create a pull request for wanted features and suggestions!

Quick start

Generate with cookiecutter:

cookiecutter [--checkout BRANCH-NAME] https://github.com/usnistgov/cookiecutter-nist-python.git

Generate with cruft:

cruft create [--checkout BRANCH-NAME] https://github.com/usnistgov/cookiecutter-nist-python.git

Generate with copier:

copier copy --trust [-r BRANCH-NAME] https://github.com/usnistgov/cookiecutter-nist-python.git destination/path

As the template uses jinja2, you'll need the --trust flag using copier.

Documentation

See the documentation for a look at cookiecutter-nist-python in action.

What's new?

See changelog.

License

This is free software. See LICENSE.

Related work

The following packages use this template:

• cmomy
• thermoextrap
• tmmc-lnpy
• module-utilities
• analphipy
• pyproject2conda
• open-notebook
• uv-workon

Other useful templates

• cookiecutter-pypackage. The template on which this work is based.
• cookiecutter-hypermodern-python

Contact

The author can be reached at wpk@nist.gov.

Credits

This template started as a fork of cookiecutter-pypackage.

TODO

• Github actions/automation