FitTrack_GarminSync/examples/GarminSync/DEVELOPMENT_WORKFLOW.md

GarminSync Development Workflow

This document describes the new development workflow for GarminSync using UV and justfile.

Dependency Management

We've switched from pip/requirements.txt to UV for faster dependency installation. The dependency specification is in pyproject.toml.

Key Commands:

# Install dependencies with UV
just run_build

# Create and activate virtual environment
uv venv .venv
source .venv/bin/activate

# Update dependencies
uv pip install -r pyproject.toml

Tooling Integration

justfile Commands

Our workflow is managed through a justfile with these commands:

just run_dev      # Run server in development mode with live reload
just run_test     # Run validation tests
just run_lint     # Run linter (Ruff)
just run_format   # Run formatter (Black)
just run_migrate  # Run database migrations

Pre-commit Hooks

We've added pre-commit hooks for automatic formatting and linting:

# Install pre-commit hooks
pre-commit install

# Run pre-commit on all files
pre-commit run --all-files

The hooks enforce:

• Code formatting with Black
• Linting with Ruff
• Type checking with mypy