TODO: Remove any unnecessary sections.
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. |
$ make hooks
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.
To be completed by you.
To be completed by you.
To be completed by you.
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.
Create and activate a virtual environment:
$ python3 -m venv .venv
$ source .venv/bin/activate
> .venv\Scripts\activate
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
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.