feat(config): extract declarative configuration into opentelemetry-configuration package

.changelog/5356.changed

@@ -0,0 +1 @@
+Declarative configuration moves from `opentelemetry.sdk._configuration` into the new public `opentelemetry-sdk-configuration` package (`opentelemetry.sdk.configuration` namespace), published experimentally and versioned independently of the SDK.

.github/workflows/lint.yml

@@ -119,6 +119,25 @@ jobs:
       - name: Run tests
         run: tox -e lint-opentelemetry-sdk
 
+  lint-opentelemetry-sdk-configuration:
+    name: opentelemetry-sdk-configuration
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e lint-opentelemetry-sdk-configuration
+
   lint-opentelemetry-semantic-conventions:
     name: opentelemetry-semantic-conventions
     runs-on: ubuntu-latest

.github/workflows/test.yml

@@ -923,6 +923,139 @@ jobs:
       - name: Run tests
         run: tox -e pypy3-test-opentelemetry-sdk -- -ra
 
+  py310-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration 3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py310-test-opentelemetry-sdk-configuration -- -ra
+
+  py311-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration 3.11 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py311-test-opentelemetry-sdk-configuration -- -ra
+
+  py312-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration 3.12 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py312-test-opentelemetry-sdk-configuration -- -ra
+
+  py313-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration 3.13 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py313-test-opentelemetry-sdk-configuration -- -ra
+
+  py314-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration 3.14 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py314-test-opentelemetry-sdk-configuration -- -ra
+
+  py314t-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration 3.14t Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14t
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14t"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py314t-test-opentelemetry-sdk-configuration -- -ra
+
+  pypy3-test-opentelemetry-sdk-configuration_ubuntu-latest:
+    name: opentelemetry-sdk-configuration pypy-3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python pypy-3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "pypy-3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e pypy3-test-opentelemetry-sdk-configuration -- -ra
+
   py310-test-opentelemetry-semantic-conventions_ubuntu-latest:
     name: opentelemetry-semantic-conventions 3.10 Ubuntu
     runs-on: ubuntu-latest
@@ -4489,6 +4622,153 @@ jobs:
       - name: Run tests
         run: tox -e pypy3-test-opentelemetry-sdk -- -ra
 
+  py310-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration 3.10 Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py310-test-opentelemetry-sdk-configuration -- -ra
+
+  py311-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration 3.11 Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py311-test-opentelemetry-sdk-configuration -- -ra
+
+  py312-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration 3.12 Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py312-test-opentelemetry-sdk-configuration -- -ra
+
+  py313-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration 3.13 Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py313-test-opentelemetry-sdk-configuration -- -ra
+
+  py314-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration 3.14 Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py314-test-opentelemetry-sdk-configuration -- -ra
+
+  py314t-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration 3.14t Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.14t
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14t"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py314t-test-opentelemetry-sdk-configuration -- -ra
+
+  pypy3-test-opentelemetry-sdk-configuration_windows-latest:
+    name: opentelemetry-sdk-configuration pypy-3.10 Windows
+    runs-on: windows-latest
+    timeout-minutes: 30
+    steps:
+      - name: Configure git to support long filenames
+        run: git config --system core.longpaths true
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python pypy-3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "pypy-3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e pypy3-test-opentelemetry-sdk-configuration -- -ra
+
   py310-test-opentelemetry-semantic-conventions_windows-latest:
     name: opentelemetry-semantic-conventions 3.10 Windows
     runs-on: windows-latest

docs/examples/declarative-config/README.rst

@@ -15,13 +15,12 @@ variables or hand-written provider setup.
 The source files of this example are available :scm_web:`here
 <docs/examples/declarative-config/>`.
 
-Install the SDK with the ``file-configuration`` extra (it pulls in ``pyyaml``
-and ``jsonschema``), the auto-instrumentation entry point, and the OTLP/HTTP
-exporter:
+Install the declarative-config package, the auto-instrumentation entry point,
+and the OTLP/HTTP exporter:
 
 .. code-block:: sh
 
-    pip install "opentelemetry-sdk[file-configuration]" \
+    pip install opentelemetry-sdk-configuration \
         opentelemetry-distro \
         opentelemetry-exporter-otlp-proto-http
 

docs/sdk/configuration.rst

@@ -21,12 +21,11 @@ configuration schema, and applies it globally.
 Installing
 ----------
 
-File configuration relies on optional dependencies (``pyyaml`` and
-``jsonschema``). Install them with the ``file-configuration`` extra:
+Declarative configuration lives in a separate, experimental package:
 
 .. code-block:: sh
 
-    pip install "opentelemetry-sdk[file-configuration]"
+    pip install opentelemetry-sdk-configuration
 
 Enabling with an environment variable
 -------------------------------------

opentelemetry-sdk-configuration/.pylintrc

@@ -0,0 +1,40 @@
+# Pylint config for opentelemetry-sdk-configuration. Extends the repo root
+# `.pylintrc` (which pylint discovers by walking upward from each file) and
+# adds disables that only apply to this package.
+#
+# `opentelemetry-sdk-configuration` extends the `opentelemetry.sdk.*`
+# namespace owned by `opentelemetry-sdk`. At runtime PEP 420 namespace
+# package merging makes `opentelemetry.sdk.configuration.*` resolvable, but
+# astroid (pylint's resolver) does not follow editable-install namespace
+# extensions across separate distributions, so it reports false positive
+# `import-error` / `no-name-in-module` on every import that crosses the
+# package boundary. These two messages are silenced for this package only.
+
+[MASTER]
+# Skip the codegen'd models.py (datamodel-code-generator output).
+ignore-patterns=^models\.py$
+# Run with multiple processes.
+jobs=0
+# Match the global pylintrc's no-self-use extension.
+load-plugins=pylint.extensions.no_self_use
+
+[MESSAGES CONTROL]
+disable=missing-docstring,
+      fixme,
+      too-few-public-methods,
+      too-many-instance-attributes,
+      too-many-arguments,
+      too-many-positional-arguments,
+      duplicate-code,
+      ungrouped-imports,
+      wrong-import-order,
+      line-too-long,
+      exec-used,
+      super-with-arguments,
+      isinstance-second-argument-not-valid-type,
+      raise-missing-from,
+      unused-argument,
+      redefined-builtin,
+      cyclic-import,
+      import-error,
+      no-name-in-module,