Skip to content

AGENTS.md

Latest commit

 

History

History
37 lines (32 loc) · 1.61 KB

AGENTS.md

File metadata and controls

37 lines (32 loc) · 1.61 KB
Raw

deploydiff

Purpose

Compare deployment configurations across environments. Detect drift between staging and production configs. Preview infrastructure changes with human-readable diffs, cost impact estimation, and rollback commands.

Build & Test Commands

  • Install (editable, from this repo): pip install -e .
  • Install (from source): pip install git+https://github.com/Coding-Dev-Tools/deploydiff.git
  • NOTE: deploydiff is NOT on public PyPI and the self-hosted pypi-index is unavailable (returns 404, verified dead 2026-08-21 Run 217). Use the git+ form above — it is the only verified-working pip install.
  • Test: pytest tests/ (or python -m pytest tests/ -v --tb=short)
  • Lint: ruff check .
  • Build: pip install build twine && python -m build && twine check dist/*
  • CLI check: deploydiff --help

Architecture

Key directories:

  • src/deploydiff/ — Main package (CLI, diff engine, cost estimator, rollback generator)
  • tests/ — Test suite
  • .github/workflows/ — CI/CD (auto-code-review.yml, ci.yml, pages.yml, publish.yml)
  • dist/ — Built distributions
  • scripts/ — Automation scripts

Conventions

  • Language: Python 3.10+
  • Test framework: pytest
  • CI: GitHub Actions (auto-code-review.yml, ci.yml, pages.yml, publish.yml)
  • Linting: ruff
  • Build system: setuptools
  • Package layout: src/ layout
  • Dependencies: click, rich, pyyaml, tomli, jinja2
  • CLI entry point: deploydiff.cli:cli
  • Default branch: main
  • Versioning: Semantic versioning (semver)
  • Documentation: Markdown

Contributing

See CONTRIBUTING.md for detailed contribution guidelines and development workflow.