Questions, feature requests and bug reports are all welcome as issues. To report a security vulnerability, please see our security policy instead.
To make it as simple as possible for us to help you, please include the versions of:
- Your operative system
It should be extremely simple to get started and create a Pull Request. cookiecutter-python-project is released regularly so you should see your improvements release in a matter of days or weeks.
Unless your change is trivial (typo, docs tweak etc.), please create an issue to discuss the change before creating a pull request.
If you're looking for something to get your teeth into, check out the "help wanted" label on github.
To make contributing as easy and fast as possible, you'll want to run tests and linting locally.
make format to fix formatting,
make to run tests and linting &
make docs to build the docs.
You'll need to have python 3.6, 3.7, or 3.8, virtualenv, git, and make installed.
Clone your fork and go into the repository directory:
git clone email@example.com:<your username>/cookiecutter-python-project.git cd cookiecutter-python-project
Set up the virtualenv for running tests:
virtualenv -p `which python3.7` env source env/bin/activate
Install npm dependencies
npm install markdownlint-cli
Install cookiecutter-python-project, dependencies and configure the pre-commits:
Checkout a new branch and make your changes:
git checkout -b my-new-feature-branch
Run tests and linting:
There are more sub-commands in Makefile like
securitywhich you might want to use, but generally
makeshould be all you need.
If you need to pass specific arguments to pytest use the
ARGSvariable, for example
make test ARGS='-k test_markdownlint_passes'.
Build documentation: If you have changed the documentation, make sure it builds the static site. Once built it will serve the documentation at
Commit, push, and create your pull request.
Make a new release: To generate the changelog of the new changes, build the package, upload to pypi and clean the build files use
We'd love you to contribute to cookiecutter-python-project!