Skip to content

Installation

Prerequisites

Requirement	Version	Notes
Python	3.14+	Enforced by the package
uv	latest	Package manager and tool runner

Install uv if you do not have it:

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

End-user install

uv tool install git+https://gitlab.com/oreohub/projects/copydeck

Verify the install:

copydeck --version

Developer install

Clone the repository and install dependencies:

git clone https://gitlab.com/oreohub/projects/copydeck
cd copydeck

uv sync

uv sync --dev

uv sync installs runtime dependencies only. uv sync --dev adds pre-commit, pytest, and ruff.

Using the task runner

The project ships a Taskfile.yml for common workflows:

task install      # equivalent to: uv sync
task install:dev  # equivalent to: uv sync --dev
task lint         # ruff check
task fmt          # ruff format
task test         # pytest
task coverage     # pytest with coverage report

Runtime dependencies

Package	Role
`click`	CLI framework
`copier`	Template engine
`inquirer`	Interactive prompts
`pydantic` + `pydantic-settings`	Config models and env-var integration
`python-gitlab`	GitLab API client
`requests`	HTTP
`rich`	Terminal table rendering

Next steps