py-project-template

Installation

TODO: Remove any unnecessary sections.

Project requirements

TODO: Update for appropriate minimum Python version and any other OS or project-level packages covered later. Optionally add more links.

OR use a table

Name Description
some-os-package Some description.
Python >= 3.6 Info about Python.
some-py-package Some description.

Install hooks

$ make hooks

Install system dependencies

TODO: Include any instructions or commands to install a package or application, other than Python. Example below using external reference and explicit instructions.

Install Python on your machine - see this Gist on How to install Python 3.

Ubuntu/Debian

To be completed by you.

macOS

To be completed by you.

Windows

To be completed by you.

Install project dependencies

It is usually best-practice in Python projects to install into a sandboxed virtual environment, This will be locked to a specific Python version and contain only the Python libraries that you install into it, so that your Python projects do not get affected.

TODO Update your template to use either pip or poetry only and removed unnecessary configs.

Install with Pip

Create and activate a virtual environment:

$ python3 -m venv .venv

Note: If you need more info, follow this guide to Set up a Python 3 Virtual Environment.

Install Python packages into the project’s virtual environment:

$ make install

Install with Poetry

Required - install Poetry on your system globally. See Gist.

Then Python packages into a virtual environment managed by Poetry:

$ poetry install

Upgrade packages when needed:

$ poetry update

You may continue to the Usage doc.