Bootstrap Python Service

Create production-oriented FastAPI starter layouts using shared uv project/workspace scaffolding.

Workflow

1. Choose mode:

• Project: single FastAPI service scaffold.
• Workspace: multi-member uv workspace scaffold.

2. Run scripts/init_python_service.sh with explicit --name and optional --path, --python, --force, --no-git-init, --initial-commit.
3. For workspace mode, optionally pass --members and --profile-map.
4. Verify quality checks:

• uv run pytest
• uv run ruff check .
• uv run mypy .

5. Return exact next run/test commands.

Commands

# Project mode (default)
scripts/init_python_service.sh --name my-service

# Project mode with explicit options
scripts/init_python_service.sh --name my-service --mode project --python 3.13 --path /tmp/my-service

# Workspace mode with defaults (core-lib package + api-service service)
scripts/init_python_service.sh --name platform --mode workspace

# Workspace mode with explicit members and profile mapping
scripts/init_python_service.sh \
  --name platform \
  --mode workspace \
  --members "core-lib,billing-service,orders-service" \
  --profile-map "core-lib=package,billing-service=service,orders-service=service"

# Allow non-empty target directory
scripts/init_python_service.sh --name my-service --force

# Skip git initialization
scripts/init_python_service.sh --name my-service --no-git-init

# Create initial commit
scripts/init_python_service.sh --name my-service --initial-commit

FastAPI Guidance

Use uv FastAPI integration style as primary guidance:

uv add fastapi --extra standard
uv run fastapi dev app/main.py
# optional production-style local run
uv run fastapi run app/main.py

Guardrails

• Refuse non-empty target directories unless --force is set.
• Require uv and git (unless --no-git-init is set and no initial commit is requested).
• Fail when workspace-only options are used in project mode.
• Fail when --initial-commit is used with --no-git-init.

Defaults

• Mode: project
• Python version: 3.13
• Quality tooling: pytest, ruff, mypy
• Workspace defaults (when mode is workspace):
• Members: core-lib,api-service
• Profiles: first member package, remaining members service

Resources

scripts/

• init_python_service.sh: thin orchestrator that delegates to bootstrap-uv-python-workspace scripts.

references/

• conventions.md: runtime, dependency, and quality defaults.

assets/

• README.md.tmpl: README template for service-focused output.