tethys-template 1.0.0

A python package template with tox testing environments.

Using this template

1. Create a new repository using Github's template interface, or run the following commands:

   git clone https://github.com/pcsagan/tethys <your_package_name>
   cd <your_package_name>
   rm -rf .git
   git init .
   

2. Find and replace all instances of tethys and tethys-template with your package name
   • Your project name can match your package name. The name tethys-template was required becausetethys already exists on PyPI
3. Update pyproject.toml to reflect its new author and requirements
   • Set the version to a value that hasn't already been published to PyPI (and TestPyPI)
   • List of Classifiers
   • Configuration for mypy
4. Update tox.ini to build the desired testing environments
   • Configuration for black
   • Configuration for flake8
   • Configuration for pycodestyle
   • Configuration for pydocstyle
   • Configuration for pytest
   • Configuration for pytest-cov
5. Update cli.py to customize the command line interface
   • Documentation for click
   • The entry point is defined in the project.scripts table in the pyproject.toml file
6. Update .git/workflows/tests.yaml to specify the various operating systems and python versions used for testing
7. Add your code to the package while regularly committing your changes to your Github repository
   • Use the tox command to test your changes locally. This is what the Tests action on Github does.
8. Add your tests to the tests directory
9. Test your package using tox
   • Run all tests in their own environments using the command:

     tox
     

   • Run specific tests using tox with the -e flag:

     tox -e pytest
     tox -e flake8
     

   • Install all the tools used by tox into your local environment using the command:

     pip install -r requirements.txt
     

10. Register on PyPI (and TestPyPI) and generate API tokens
11. Add your tokens as a secret variable named pypi_api_token and testpypi_api_token to your Github repository
12. Manually run the Publish Test action to verify that your token and package version are accepted using TestPyPI
13. Manually run the Publish action to publish your package on PyPI

Help

Usage: tethys [OPTIONS] COMMAND [ARGS]...

  Tethys is a moon of Saturn.

Options:
  --version  Show the version and exit.
  --debug    Run the command in debug mode.
  --help     Show this message and exit.

Commands:
  data  Print the shared context data to the screen.
  foo   Print the result of calling the foo function to the screen.