Opinionated Python template for new packages.

• Source code
• PyPI package
• Snyk Advisor

1. Go to or create the package folder.
2. Get the template files:

npx degit github:joaopalmeiro/template-python-package

or

npx degit github:joaopalmeiro/template-python-package --force

3. Search for template-python-package and replace it with the package name. Ignore the template repository URL in the NOTES.md file.
4. Search for template_python_package and replace it with the underscored version of the package name.
5. Search for Opinionated Python template for new packages. and replace it with the (short) package description.
6. Search for João Palmeiro and replace it with the author's name.
7. Search for [email protected] and replace it with the author's email address.
8. Open the pyproject.toml file and add the package-specific dependencies. See the Dependency configuration and Environment configuration pages in the Hatch documentation for more information (if necessary).
9. Update the Source code link at the top to the package repository link (if necessary).
10. Change GitHub in the Deployment section to GitLab or Codeberg and update the link to the corresponding Tags page (if necessary).
11. Update the Issues and Source fields in the pyproject.toml file with their respective repository-related links (if necessary).
12. Remove hatch-demo/ from the .gitignore file.
13. Delete the TEMPLATE.md file.
14. Delete the Getting Started section.

Install pyenv (if necessary).

pyenv install && pyenv versions

pip install hatch==1.12.0 && hatch --version

hatch config set dirs.env.virtual .hatch

hatch config show

hatch env create

hatch status

hatch env show

hatch dep show table

hatch run qa:lint

hatch run qa:format

hatch project metadata

hatch version micro

hatch version minor

hatch version major

hatch build --clean

echo "v$(hatch version)" | pbcopy

• Commit and push changes.
• Create a tag on GitHub Desktop.
• Check GitHub.

hatch publish

• Check PyPI.