Skip to content

Cookiecutter template for a Python package using poetry and pre-commit hooks.

License

Notifications You must be signed in to change notification settings

thomascamminady/cookiecutter-pypackage

 
 

Repository files navigation

Cookiecutter PyPackage

Cookiecutter template for a Python package.

Features

  • Uses poetry for dependency management and packaging.
  • Uses pre-commit hooks.
  • Deploys pdoc documentation via Github Pages.
  • Can be configured with a single call of make.
  • Strikes a balance between complexity and simplicity, tailored towards data scientists.

Development

Install the latest Cookiecutter if you haven't installed it yet (this requires Cookiecutter 1.4.0 or higher):

pip install -U cookiecutter

Generate a Python package project:

cookiecutter https://github.com/thomascamminady/cookiecutter-pypackage

Create a remote repository with the specified name and enable Github Actions as the deployment method for Github Pages.

Change into the new project folder and run:

make

And you're done!

Note that for this to work, you must not be in an active poetry environment.

About

Cookiecutter template for a Python package using poetry and pre-commit hooks.

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • Python 70.1%
  • Makefile 19.4%
  • Jupyter Notebook 10.5%