astronomer / astro-cli / 7fbd087c-0308-4fa9-af77-861aba9664f4

36%

main: 39%

Build Type

Pull #2055

circleci

Committed by kaxil

Commit Message

Add pyproject.toml as project definition format

Replace the Dockerfile-centric project definition with pyproject.toml
(PEP 621) for Airflow 3 projects. This aligns with the Python ecosystem,
enables the uv-based standalone runtime, and lays the groundwork for
multi-target compilation.

Parser and detection (airflow/project.go):
- ReadProject(), IsPyProject(), DetectProjectFormat(), PinRuntimeVersion()
- Detection requires [tool.astro] to avoid false positives from
  ruff/pytest pyproject.toml files

astro dev init --format pyproject:
- Scaffolds pyproject.toml projects with no Dockerfile or requirements.txt
- Resolves airflow-version and runtime-version from the API
- Validates: AF3 only, mutual exclusion with --from-template

Standalone mode reads pyproject.toml:
- Reads versions and dependencies from [tool.astro] and [project]
- Falls back to Dockerfile parsing for legacy projects

Docker mode generates Dockerfile from pyproject.toml:
- GenerateDockerfile() produces FROM + optional apt-get for system packages
- EnsureDockerfile() called at build time so pyproject.toml edits are
  always picked up
- Generated file written to .astro/Dockerfile.pyproject (gitignored)
- System package names validated against Debian naming rules

Runtime version resolution:
- runtime-version is optional in pyproject.toml — resolved from
  airflow-version on first start/build and pinned back to pyproject.toml
- Mismatch between airflow-version and runtime-version triggers a warning
- Warns users that multiple runtimes exist per Airflow version to prevent
  accidental upgrades on deploy

Pull Request Pull Request #2055: Add pyproject.toml as project definition format

Coverage Stats

261 of 368 new or added lines in 8 files covered. (70.92%)

1 existing line in 1 file now uncovered.

24708 of 68179 relevant lines covered (36.24%)

8.64 hits per line