We welcome contributions! This document provides guidelines for contributing to the project.

We recommend using uv for managing Python versions and dependencies. Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Or using pip:

pip install uv

Python >= 3.11

With uv, you can create a project with the correct Python version:

uv python install 3.11

git clone https://github.com/elumobility/ocpi-python.git

cd ocpi-python

# Install all dependencies including dev tools
uv sync --all-extras

# Or install specific extras
uv sync --extra dev --extra docs

This will:

• Create a virtual environment
• Install all dependencies from pyproject.toml
• Install development and documentation dependencies

With uv, you can run commands in the virtual environment:

uv run <command>

Or activate the shell:

source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

uv run pre-commit install

To run tests, use:

uv run pytest

Or with coverage:

uv run pytest --cov=ocpi --cov-report=term-missing

To build documentation locally:

# Install docs dependencies first
uv sync --extra docs

# Build and serve documentation
uv run mkdocs serve

# Build static site
uv run mkdocs build

1. Create a feature branch
2. Make your changes
3. Run tests: uv run pytest
4. Run linting: uv run ruff check .
5. Run type checking: uv run mypy ocpi
6. Commit your changes (pre-commit hooks will run automatically)
7. Push and create a Pull Request