Skip to content

README.md

Latest commit

 

History

History
53 lines (37 loc) · 2.09 KB

README.md

File metadata and controls

53 lines (37 loc) · 2.09 KB
Raw

Python downstream gate (dd-trace-py)

Paired 3.14 (baseline) and 3.15 (candidate) prof-correctness scenarios exercise the Python profiling stack for the 3.14 → 3.15 migration. They are the intended default set when dd-trace-py triggers downstream CI on profiling changes.

Scenarios land in follow-up PRs (core families first, then feature-specific pairs). This directory is an index only — not a runnable scenario.

Scenarios

Family 3.14 (baseline) 3.15 (candidate) PR
(pending) — — Core scenarios in follow-up PRs

Default downstream regexp

Once scenarios are added, dd-trace-py should pass an explicit regexp (not the downstream workflow default of python.*). The regexp grows as families merge; see each PR for the current value.

Override via workflow_dispatch → test_scenarios, or when triggering downstream-python.yml manually.

Wheel install

Every scenario builds against a dd-trace-py wheel via DDTRACE_INSTALL_URL (as downstream-python.yml does: https://dd-trace-py-builds.s3.amazonaws.com/<sha>/install.sh), pre-installed in the base image.

  • All *_3.15 folders — PyPI wheels may not be published for 3.15 yet; excluded from prof-correctness main CI (see test_scenarios_exclude in .github/workflows/ci.yml).
  • Wheel-only 3.14 folders — scenarios that depend on unreleased ddtrace features are also excluded from main CI until the feature ships.

Local run

export DDTRACE_INSTALL_URL="https://dd-trace-py-builds.s3.amazonaws.com/<commit-sha>/install.sh"
TEST_SCENARIOS='<gate-regexp>' go test -v -run TestScenarios

Gate lifecycle

This gate tests the migration delta (3.14 → 3.15). It is time-boxed: retire the paired 14v15 framing at 3.15 GA and fold workloads into steady-state prof-correctness on {oldest, newest} supported Python versions.

Further reading

  • prof-correctness downstream wiring: README