Python Tools

Project Summary

Field Value

PRJ ID

PRJ-SPOKE-015

Owner

Evan Rosado

Priority

P2 (Medium)

Status

Active

Repository

~/atelier/_bibliotheca/domus-python

Antora Component

python-ops

Antora Title

Python Operations

Category

Development

2026 Commits

15

Site URL

docs.domusdigitalis.dev/python-ops/

Purpose

The Python Operations component documents Python tooling patterns, environment management with uv, PEP 723 inline script metadata, and Python automation scripts used across the Domus ecosystem.

It serves as the Python knowledge base, covering best practices for project structure, dependency management, and scripting patterns that feed into netapi, Kora, and other Python-based tools.

Scope

In Scope

  • Python environment management (uv, venv, pyenv)

  • PEP 723 inline script metadata patterns

  • Python 3.11+ best practices and type hints

  • Script documentation and examples

  • Testing patterns (pytest, hypothesis)

  • Package distribution and publishing

  • Integration with domus infrastructure (API clients, automation)

Out of Scope

  • netapi library source code (separate repo)

  • Kora CLI development (Go-based, separate repo)

  • reMarkable workbook generators (live in domus-captures/scripts/)

Status

Indicator Detail

Activity Level

Active — 15 commits, growing content

Maturity

Early Production — uv tooling and PEP 723 patterns documented

Last Activity

2026

Key Milestone

uv-first Python environment management documented

Deployment Status

Reference documentation, patterns actively used in daily scripting

Metadata

Field Value

PRJ ID

PRJ-SPOKE-015

Author

Evan Rosado

Date Created

2026-03-30

Last Updated

2026-03-30

Status

Active

Next Review

2026-04-15