tethys-template 1.0.1

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. Install your package dependencies into your development environment
   • Install the package locally in editable mode using the command:

     pip install -e .
     

   • Install the package locally along with all testing libraries used by tox with the command:

     pip install -r requirements.txt
     

8. Add your code to the package while regularly committing your changes to your Github repository
9. Add your tests to the tests directory
10. 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
      ...
      

    • If you installed the requirements.txt file then you can run testing modules without tox in your local environment:

      pytest <my_package_name>
      flake8 <my_package_name> tests
      ...
      

11. Register on PyPI (and TestPyPI) and generate API tokens
12. Add your tokens as a secret variable named pypi_api_token and testpypi_api_token to your Github repository
13. Manually run the Publish Test action to verify that your token and package version are accepted using TestPyPI
14. 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.