Skip to content

Latest commit

 

History

History
196 lines (122 loc) · 3.82 KB

CONTRIBUTING.md

File metadata and controls

196 lines (122 loc) · 3.82 KB

Contributing to pyproject-patcher

Setting up pyproject-patcher for development

To set up pyproject-patcher, you need three things:

  1. The Python version manager pyenv.

  2. A system-wide Python installation.

  3. The Python dependency manager poetry.

Installing pyenv

The Python version manager pyenv makes sure you can always keep the exact Python version required by pyproject-patcher, regardless of your system Python.

Installing pyenv on Windows

While pyenv doesn’t support Windows, you can use a drop-in replacement called pyenv-win.

To install pyenv-win on Windows, go to github.com/pyenv-win/pyenv-win and follow one of the installation methods.

Installing pyenv on Linux

To install pyenv on Linux or WSL2, first make sure Python 3 is installed. Then follow the Basic GitHub Checkout method described at github.com/pyenv/pyenv.

Installing pyenv on macOS

To install pyenv on macOS, run:

brew install pyenv

Checking your system-wide pyenv installation

To verify your pyenv is working, run:

pyenv --version

Checking your system-wide Python installation

Make sure you have Python 3.12 or higher installed on your system and available in your PATH.

To check, run:

python --version

If that fails, try:

python3 --version

Proceed after you’ve confirmed one of those to work.

Installing Poetry

You’ll need poetry to manage development dependencies and the venv.

To install Poetry on Windows, use one of the installation methods described in Poetry’s documentation.

To install Poetry on macOS, run:

brew install poetry

If you’re on Linux or WSL2, use your system package manager to install Poetry.

Alternatively, use one of the installation methods described in Poetry’s documentation.

Checking your Poetry installation

To verify Poetry is working, run:

poetry --version

Setting up your virtual environment

To set up your virtual environment, follow these steps:

  1. Go to the project root directory.

  2. Run pyenv install -s.

  3. Run pyenv exec python -m venv .venv.

  4. Run poetry install.

You need to do the above steps only once.

To update your dependencies after a git pull, run poetry update.

Development scripts and tasks

To see a list of available tasks, run: poetry run poe tasks

Running the tests

To execute the tests, run:

poetry run poe tests

To execute a single test, run e. g.:

poetry run poe tests -vv tests/test_patcher.py::test_hello

Running the linter

To execute the linter, run:

poetry run poe linter

Running the static type check

To execute the static type check, run:

poetry run poe typecheck

Running the entire CI pipeline locally

If you have act installed and a Docker daemon active, run:

act

Generating project documentation

To generate project documentation, run:

poetry run poe doc

To open the generated documentation with man, run:

poetry run poe man

Maintenance

Refreshing dependencies

If you get errors after a Git pull, refresh your dependencies:

poetry update

Rebuilding the virtual environment

If you’ve run poetry update and you still get errors, rebuild the virtual environment:

poetry install

Checking pyproject-patcher’s dependencies for compatible updates

To check pyproject-patcher’s dependencies for compatible updates, run:

poetry update --dry-run