Skip to main content

A python cookiecutter application to create a new python project that uses poetry to manage its dependencies.

Project description

Cookiecutter Poetry

Release Build status Supported Python versions Docs Commit activity License

This is a cookiecutter repository to generate the file structure for a Python project that uses Poetry for its dependency management.

Features

Example CI/CD Pipeline

Example pipeline

Quickstart

On your local machine, navigate to the directory in which you want to create a project directory, and run the following two commands:

pip install cookiecutter-poetry 
ccp

Alternatively, install cookiecutter and directly pass the URL to this Github repository to the cookiecutter command:

pip install cookiecutter
cookiecutter https://github.com/fpgmaas/cookiecutter-poetry.git

Then run the following commands, replacing <project-name>, with the name that you also gave the Github repository and <github_author_handle> with your Github username.

cd <project_name>
git init -b main
git add .
git commit -m "Init commit"
git remote add origin git@github.com:<github_author_handle>/<project_name>.git
git push -u origin main

Finally, install the environment with make install.

You are now ready to start development on your project! The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release.

To finalize the set-up for publishing to PyPi or Artifactory, see here. For activating the automatic documentation with MkDocs, see here.

Acknowledgements

This project is partially based on Audrey Feldroy's's great cookiecutter-pypackage repository.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cookiecutter-poetry-0.2.1.tar.gz (15.7 kB view hashes)

Uploaded Source

Built Distribution

cookiecutter_poetry-0.2.1-py3-none-any.whl (21.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page