Development Environment Setup¶

This guide explains how to set up the development environment for contributing to Python Project Template.
The project provides a Makefile to simplify common development tasks.

Prerequisites¶

Install the following tools before starting development.

Tool	Version	Description
Python	>=3.13	Python programming language
uv	>=0.10	Python package and project manager

Clone the repository:

git clone https://github.com/oqtopus-team/oqtopus-cli.git
cd oqtopus-cli

Project Structure¶

The repository is organized as follows:

oqtopus-cli/
├─ docs/          # Documentation sources (MkDocs)
├─ .vscode/       # VSCode settings
├─ .github/       # GitHub workflows and repository settings
├─ pyproject.toml # Project configuration and dependencies
├─ Makefile       # Development commands
├─ mkdocs.yml     # MkDocs configuration
├─ uv.lock        # Locked dependency versions
└─ README.md      # Project overview

Installing Dependencies¶

Install the project dependencies and set up the local development environment:

make install

This command performs the following:

Installs all dependencies via uv.
Configures the Git commit message template.

Documentation¶

Lint Documentation¶

Run documentation linting:

make docs-lint

Build Documentation¶

Build the documentation:

make docs-build

Start the Documentation Server¶

This project uses MkDocs to generate the HTML documentation and Start the documentation server with:

make docs-serve

Open the documentation in your browser at http://localhost:8000.