From 815cca195735d9089ab2852d1e3b0689e631895a Mon Sep 17 00:00:00 2001 From: Marcelo Trylesinski Date: Fri, 20 Feb 2026 11:31:47 +0100 Subject: [PATCH 1/2] Add CLAUDE.md with project structure and commands --- CLAUDE.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000000..bf28b1e654 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,36 @@ +# OpenTelemetry Python Contrib + +Monorepo with 50+ OpenTelemetry instrumentation packages for Python. + +## Structure + +- `instrumentation/` - instrumentation packages (Flask, Django, FastAPI, gRPC, databases, etc.) +- `instrumentation-genai/` - GenAI instrumentations (Anthropic, Vertex AI, LangChain, etc.) +- `util/` - shared utilities (`util-http`, `util-genai`) +- `exporter/` - custom exporters +- `propagator/` - context propagators + +Each package lives under `src/opentelemetry/instrumentation/{name}/` with its own `pyproject.toml` and `tests/`. + +## Commands + +```sh +# Install all packages and dev tools +uv sync --frozen --all-packages + +# Lint (runs ruff via pre-commit) +uv run pre-commit run ruff --all-files + +# Test a specific package (append -0, -1, etc. for version variants) +uv run tox -e py312-test-instrumentation-flask-0 + +# Type check +uv run tox -e typecheck +``` + +## Guidelines + +- Each package has its own `pyproject.toml` with version, dependencies, and entry points. +- The monorepo uses `uv` workspaces. +- `tox.ini` defines the test matrix - check it for available test environments. +- Do not add `type: ignore` comments. If a type error arises, solve it properly or write a follow-up plan to address it in another PR. From 168e916b15bbf675779a60a059bede2b57ef272d Mon Sep 17 00:00:00 2001 From: Marcelo Trylesinski Date: Sun, 22 Feb 2026 12:03:08 +0100 Subject: [PATCH 2/2] Add AGENTS.md symlink to CLAUDE.md --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) create mode 120000 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 120000 index 0000000000..681311eb9c --- /dev/null +++ b/AGENTS.md @@ -0,0 +1 @@ +CLAUDE.md \ No newline at end of file