Merge branch 'main' into mike/config-exporter-plugin-loading

lzchen · web-flow · commit b080ae1a289f · 2026-05-15T10:48:10.000-05:00
diff --git a/.changelog/4854.added b/.changelog/4854.added
@@ -0,0 +1 @@
+`opentelemetry-api`, `opentelemetry-sdk`: add support for 'random-trace-id' flags in W3C traceparent header trace flags. Implementations of `IdGenerator` that do randomly generate the 56 least significant bits, should also implement a `is_trace_id_random` methods that returns `True`.
diff --git a/.changelog/4908.added b/.changelog/4908.added
@@ -0,0 +1 @@
+logs: add exception support to Logger emit and LogRecord attributes
diff --git a/.changelog/4917.added b/.changelog/4917.added
@@ -0,0 +1 @@
+`opentelemetry-exporter-otlp-proto-grpc`: make retryable gRPC error codes configurable for gRPC exporters
diff --git a/.changelog/4990.added b/.changelog/4990.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: Add `create_logger_provider`/`configure_logger_provider` to declarative file configuration, enabling LoggerProvider instantiation from config files without reading env vars
diff --git a/.changelog/4996.added b/.changelog/4996.added
@@ -0,0 +1 @@
+`opentelemetry-exporter-otlp-json-common`: add 'opentelemetry-exporter-otlp-json-common' package for OTLP JSON exporters
diff --git a/.changelog/5003.added b/.changelog/5003.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: Add `service` resource detector support to declarative file configuration via `detection_development.detectors[].service`
diff --git a/.changelog/5055.added b/.changelog/5055.added
@@ -0,0 +1 @@
+Add `registry` keyword argument to `PrometheusMetricReader` to allow passing a custom Prometheus registry
diff --git a/.changelog/5076.removed b/.changelog/5076.removed
@@ -0,0 +1 @@
+Drop Python 3.9 support
diff --git a/.changelog/5077.fixed b/.changelog/5077.fixed
@@ -0,0 +1 @@
+Fix incorrect code example in `create_tracer()` docstring
diff --git a/.changelog/5083.fixed b/.changelog/5083.fixed
@@ -0,0 +1 @@
+`opentelemetry-sdk`: Fix `ProcessResourceDetector` to use `sys.orig_argv` so that `process.command`, `process.command_line`, and `process.command_args` reflect the original invocation for `python -m <module>` runs (where `sys.argv[0]` is rewritten to the module path)
diff --git a/.changelog/5088.added b/.changelog/5088.added
@@ -0,0 +1 @@
+Add WeaverLiveCheck test util
diff --git a/.changelog/5091.fixed b/.changelog/5091.fixed
@@ -0,0 +1 @@
+`opentelemetry-sdk`: fix YAML structure injection via environment variable substitution in declarative file configuration; values containing newlines are now emitted as quoted YAML scalars per spec requirement
diff --git a/.changelog/5093.added b/.changelog/5093.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: add `load_entry_point` shared utility to declarative file configuration for loading plugins via entry points; refactor propagator loading to use it
diff --git a/.changelog/5095.added b/.changelog/5095.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: add sampler plugin loading to declarative file configuration via the `opentelemetry_sampler` entry point group, matching the spec's PluginComponentProvider mechanism
diff --git a/.changelog/5096.changed b/.changelog/5096.changed
@@ -0,0 +1 @@
+`opentelemetry-semantic-conventions`: use `X | Y` union annotation
diff --git a/.changelog/5098.added b/.changelog/5098.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: add propagator plugin loading to declarative file configuration via the `opentelemetry_propagator` entry point group, matching the spec's PluginComponentProvider mechanism
diff --git a/.changelog/5106.fixed b/.changelog/5106.fixed
@@ -0,0 +1 @@
+`opentelemetry-sdk`: Fix mutable attributes reference in metrics, attributes passed to instrument `add`/`record` are now copied so that subsequent mutations do not affect recorded data points
diff --git a/.changelog/5119.changed b/.changelog/5119.changed
@@ -0,0 +1 @@
+`opentelemetry-api`: update `EnvironmentGetter` and `EnvironmentSetter` to use normalized environment variable names
diff --git a/.changelog/5120.fixed b/.changelog/5120.fixed
@@ -0,0 +1 @@
+`opentelemetry-sdk`: make resource detector ordering deterministic
diff --git a/.changelog/5129.added b/.changelog/5129.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: add generic resource detector plugin loading to declarative file configuration via the `opentelemetry_resource_detector` entry point group, matching the spec's PluginComponentProvider mechanism
diff --git a/.changelog/5131.added b/.changelog/5131.added
@@ -0,0 +1 @@
+`opentelemetry-sdk`: add `additional_properties` support to generated config models via custom `datamodel-codegen` template, enabling plugin/custom component names to flow through typed dataclasses
diff --git a/.changelog/5133.changed b/.changelog/5133.changed
@@ -0,0 +1 @@
+Apply fixes for `UP` ruff rule
diff --git a/.changelog/5135.fixed b/.changelog/5135.fixed
@@ -0,0 +1 @@
+Fix incorrect type annotation on `detectors` parameter of `get_aggregated_resources`
diff --git a/.changelog/5145.changed b/.changelog/5145.changed
@@ -0,0 +1 @@
+`opentelemetry-sdk`: only load entrypoints for resource detectors if they are configured via `OTEL_EXPERIMENTAL_RESOURCE_DETECTORS`
diff --git a/.changelog/5149.changed b/.changelog/5149.changed
@@ -0,0 +1 @@
+ci: wait for tracecontext server readiness instead of a fixed sleep in `scripts/tracecontext-integration-test.sh`
diff --git a/.changelog/5151.added b/.changelog/5151.added
@@ -0,0 +1 @@
+Add ability to selectively enable exporting of SDK internal metrics with the `OTEL_PYTHON_SDK_INTERNAL_METRICS_ENABLED` environment variable.
diff --git a/.changelog/5163.fixed b/.changelog/5163.fixed
@@ -0,0 +1 @@
+`opentelemetry-api`: Enforce W3C Baggage size limits on outbound propagation in `W3CBaggagePropagator.inject()`. Previously only inbound extraction enforced limits; now inject also caps entries at 180, individual pairs at 4096 bytes, and total header at 8192 bytes per the W3C Baggage spec. The extract path max_pairs limit now counts all size-valid entries rather than only successfully parsed ones.
diff --git a/.changelog/5177.changed b/.changelog/5177.changed
@@ -0,0 +1 @@
+Switch to SPDX license headers and add CI enforcement
diff --git a/.changelog/5179.fixed b/.changelog/5179.fixed
@@ -0,0 +1 @@
+`opentelemetry-sdk`: fix multi-processor `force_flush` skipping remaining processors when one returns `None`
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -20,61 +20,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- changelog start -->
 
-## Unreleased
-
-- `opentelemetry-sdk`: fix multi-processor `force_flush` skipping remaining processors when one returns `None`
-  ([#5179](https://github.com/open-telemetry/opentelemetry-python/pull/5179))
-- Apply fixes for `UP` ruff rule
-  ([#5133](https://github.com/open-telemetry/opentelemetry-python/pull/5133))
-- Switch to SPDX license headers and add CI enforcement
-  ([#5177](https://github.com/open-telemetry/opentelemetry-python/pull/5177))
-- `opentelemetry-api`: Enforce W3C Baggage size limits on outbound propagation in `W3CBaggagePropagator.inject()`. Previously only inbound extraction enforced limits; now inject also caps entries at 180, individual pairs at 4096 bytes, and total header at 8192 bytes per the W3C Baggage spec. The extract path max_pairs limit now counts all size-valid entries rather than only successfully parsed ones.
-  ([#5163](https://github.com/open-telemetry/opentelemetry-python/pull/5163))
-- `opentelemetry-sdk`: add `additional_properties` support to generated config models via custom `datamodel-codegen` template, enabling plugin/custom component names to flow through typed dataclasses
-  ([#5131](https://github.com/open-telemetry/opentelemetry-python/pull/5131))
-- Fix incorrect code example in `create_tracer()` docstring
-  ([#5072](https://github.com/open-telemetry/opentelemetry-python/issues/5072))
-- `opentelemetry-sdk`: add `load_entry_point` shared utility to declarative file configuration for loading plugins via entry points; refactor propagator loading to use it
-  ([#5093](https://github.com/open-telemetry/opentelemetry-python/pull/5093))
-- `opentelemetry-sdk`: fix YAML structure injection via environment variable substitution in declarative file configuration; values containing newlines are now emitted as quoted YAML scalars per spec requirement
-  ([#5091](https://github.com/open-telemetry/opentelemetry-python/pull/5091))
-- `opentelemetry-sdk`: Add `create_logger_provider`/`configure_logger_provider` to declarative file configuration, enabling LoggerProvider instantiation from config files without reading env vars
-  ([#4990](https://github.com/open-telemetry/opentelemetry-python/pull/4990))
-- `opentelemetry-sdk`: Add `service` resource detector support to declarative file configuration via `detection_development.detectors[].service`
-  ([#5003](https://github.com/open-telemetry/opentelemetry-python/pull/5003))
-- logs: add exception support to Logger emit and LogRecord attributes
-  ([#4907](https://github.com/open-telemetry/opentelemetry-python/issues/4907))
-- Drop Python 3.9 support
-  ([#5076](https://github.com/open-telemetry/opentelemetry-python/pull/5076))
-- `opentelemetry-semantic-conventions`: use `X | Y` union annotation
-  ([#5096](https://github.com/open-telemetry/opentelemetry-python/pull/5096))
-- `opentelemetry-sdk`: Fix `ProcessResourceDetector` to use `sys.orig_argv` so that `process.command`, `process.command_line`, and `process.command_args` reflect the original invocation for `python -m <module>` runs (where `sys.argv[0]` is rewritten to the module path)
-  ([#5083](https://github.com/open-telemetry/opentelemetry-python/pull/5083))
-- `opentelemetry-sdk`: make resource detector ordering deterministic
-  ([#5120](https://github.com/open-telemetry/opentelemetry-python/pull/5120))
-- Add WeaverLiveCheck test util
-  ([#5088](https://github.com/open-telemetry/opentelemetry-python/pull/5088))
-- Fix incorrect type annotation on `detectors` parameter of `get_aggregated_resources`
-  ([#5135](https://github.com/open-telemetry/opentelemetry-python/pull/5135))
-- ci: wait for tracecontext server readiness instead of a fixed sleep in `scripts/tracecontext-integration-test.sh`
-  ([#5149](https://github.com/open-telemetry/opentelemetry-python/pull/5149))
-- `opentelemetry-api`: update `EnvironmentGetter` and `EnvironmentSetter` to use normalized environment variable names
-  ([#5119](https://github.com/open-telemetry/opentelemetry-python/pull/5119))
-- `opentelemetry-sdk`: only load entrypoints for resource detectors if they are configured via `OTEL_EXPERIMENTAL_RESOURCE_DETECTORS`
-  ([#5145](https://github.com/open-telemetry/opentelemetry-python/pull/5145))
-- `opentelemetry-exporter-otlp-json-common`: add 'opentelemetry-exporter-otlp-json-common' package for OTLP JSON exporters
-  ([#4996](https://github.com/open-telemetry/opentelemetry-python/pull/4996))
-- `opentelemetry-exporter-otlp-proto-grpc`: make retryable gRPC error codes configurable for gRPC exporters
-  ([#4917](https://github.com/open-telemetry/opentelemetry-python/pull/4917))
-- `opentelemetry-sdk`: add sampler plugin loading to declarative file configuration via the `opentelemetry_sampler` entry point group, matching the spec's PluginComponentProvider mechanism
-  ([#5095](https://github.com/open-telemetry/opentelemetry-python/pull/5095))
-- Add `registry` keyword argument to `PrometheusMetricReader` to allow passing a custom Prometheus registry
-  ([#5055](https://github.com/open-telemetry/opentelemetry-python/pull/5055))
-- Add ability to selectively enable exporting of SDK internal metrics with the `OTEL_PYTHON_SDK_INTERNAL_METRICS_ENABLED` environment variable.
-  ([#5151](https://github.com/open-telemetry/opentelemetry-python/pull/5151))
-- `opentelemetry-api`, `opentelemetry-sdk`: add support for 'random-trace-id' flags in W3C traceparent header trace flags. Implementations of `IdGenerator` that do randomly generate the 56 least significant bits, should also implement a `is_trace_id_random` methods that returns `True`.
-  ([#4854](https://github.com/open-telemetry/opentelemetry-python/pull/4854))
-
 ## Version 1.41.0/0.62b0 (2026-04-09)
 
 
diff --git a/opentelemetry-sdk/src/opentelemetry/sdk/_configuration/_propagator.py b/opentelemetry-sdk/src/opentelemetry/sdk/_configuration/_propagator.py
@@ -18,25 +18,41 @@
     TraceContextTextMapPropagator,
 )
 
-
-def _load_entry_point_propagator(name: str) -> TextMapPropagator:
-    """Load and instantiate a propagator by name."""
-    return load_entry_point("opentelemetry_propagator", name)()
+# Propagators bundled with the SDK — no entry point lookup needed.
+_PROPAGATOR_REGISTRY: dict[str, type[TextMapPropagator]] = {
+    "tracecontext": TraceContextTextMapPropagator,
+    "baggage": W3CBaggagePropagator,
+}
 
 
 def _propagators_from_textmap_config(
     config: TextMapPropagatorConfig,
 ) -> list[TextMapPropagator]:
-    """Resolve a single TextMapPropagator config entry to a list of propagators."""
+    """Resolve a TextMapPropagator config to a list of propagators.
+
+    Known names (tracecontext, baggage) are bootstrapped directly via
+    _PROPAGATOR_REGISTRY. Known schema fields not in the registry (b3, b3multi)
+    and unknown plugin names from additional_properties are loaded via the
+    ``opentelemetry_propagator`` entry point group.
+    """
     result: list[TextMapPropagator] = []
-    if config.tracecontext is not None:
-        result.append(TraceContextTextMapPropagator())
-    if config.baggage is not None:
-        result.append(W3CBaggagePropagator())
-    if config.b3 is not None:
-        result.append(_load_entry_point_propagator("b3"))
-    if config.b3multi is not None:
-        result.append(_load_entry_point_propagator("b3multi"))
+    for name, cls in _PROPAGATOR_REGISTRY.items():
+        if getattr(config, name, None) is not None:
+            result.append(cls())
+
+    # Known schema fields not in registry (b3, b3multi) — loaded via entry point
+    for name in ("b3", "b3multi"):
+        if getattr(config, name, None) is not None:
+            result.append(load_entry_point("opentelemetry_propagator", name)())
+
+    # Plugin propagators from additional_properties
+    for name, plugin_config in config.additional_properties.items():
+        result.append(
+            load_entry_point("opentelemetry_propagator", name)(
+                **(plugin_config or {})
+            )
+        )
+
     return result
 
 
@@ -72,7 +88,7 @@ def create_propagator(
             name = name.strip()
             if not name or name.lower() == "none":
                 continue
-            propagator = _load_entry_point_propagator(name)
+            propagator = load_entry_point("opentelemetry_propagator", name)()
             propagators.setdefault(type(propagator), propagator)
 
     return CompositePropagator(list(propagators.values()))
diff --git a/opentelemetry-sdk/src/opentelemetry/sdk/_configuration/_resource.py b/opentelemetry-sdk/src/opentelemetry/sdk/_configuration/_resource.py
@@ -3,13 +3,16 @@
 
 from __future__ import annotations
 
+import dataclasses
 import fnmatch
 import logging
 import os
 import uuid
 from collections.abc import Callable
+from typing import Any
 from urllib import parse
 
+from opentelemetry.sdk._configuration._common import load_entry_point
 from opentelemetry.sdk._configuration.models import (
     AttributeNameValue,
     AttributeType,
@@ -26,7 +29,7 @@
     Resource,
     _HostResourceDetector,
 )
-from opentelemetry.util._importlib_metadata import entry_points
+from opentelemetry.util.types import AttributeValue
 
 _logger = logging.getLogger(__name__)
 
@@ -135,55 +138,57 @@ def create_resource(config: ResourceConfig | None) -> Resource:
     return result.merge(config_resource)
 
 
+def _detect_service(_config: Any) -> dict[str, AttributeValue]:
+    """Service detector: generates instance ID and reads OTEL_SERVICE_NAME."""
+    attrs: dict[str, AttributeValue] = {
+        SERVICE_INSTANCE_ID: str(uuid.uuid4()),
+    }
+    if service_name := os.environ.get(OTEL_SERVICE_NAME):
+        attrs[SERVICE_NAME] = service_name
+    return attrs
+
+
+_RESOURCE_DETECTOR_REGISTRY: dict[
+    str, Callable[[Any], dict[str, AttributeValue]]
+] = {
+    "service": _detect_service,
+    "host": lambda _: dict(_HostResourceDetector().detect().attributes),
+    "process": lambda _: dict(ProcessResourceDetector().detect().attributes),
+}
+
+
 def _run_detectors(
     detector_config: ExperimentalResourceDetector,
     detected_attrs: dict[str, object],
 ) -> None:
-    """Run any detectors present in a single detector config entry.
+    """Run detectors present in a single detector config entry.
 
-    Each detector PR adds its own branch here. The detected_attrs dict
-    is updated in-place; later detectors overwrite earlier ones for the
-    same key.
+    Known detectors (service, host, process) are handled directly via
+    _RESOURCE_DETECTOR_REGISTRY. All other detectors — including known
+    schema fields like container that require contrib packages, and
+    unknown plugin detectors captured in additional_properties — are
+    loaded via the ``opentelemetry_resource_detector`` entry point group.
+
+    The detected_attrs dict is updated in-place; later detectors overwrite
+    earlier ones for the same key.
     """
-    if detector_config.service is not None:
-        attrs: dict[str, object] = {
-            SERVICE_INSTANCE_ID: str(uuid.uuid4()),
-        }
-        service_name = os.environ.get(OTEL_SERVICE_NAME)
-        if service_name:
-            attrs[SERVICE_NAME] = service_name
-        detected_attrs.update(attrs)
-
-    if detector_config.host is not None:
-        detected_attrs.update(_HostResourceDetector().detect().attributes)
-
-    if detector_config.container is not None:
-        # The container detector is not part of the core SDK. It is provided
-        # by the opentelemetry-resource-detector-containerid contrib package,
-        # which registers itself under the opentelemetry_resource_detector
-        # entry point group as "container". Loading via entry point matches
-        # the env-var config counterpart (OTEL_EXPERIMENTAL_RESOURCE_DETECTORS)
-        # and avoids a hard import dependency on contrib. See also:
-        # https://github.com/open-telemetry/opentelemetry-configuration/issues/570
-        ep = next(
-            iter(
-                entry_points(
-                    group="opentelemetry_resource_detector", name="container"
-                )
-            ),
-            None,
-        )
-        if ep is None:
-            _logger.warning(
-                "container resource detector requested but "
-                "'opentelemetry-resource-detector-containerid' is not "
-                "installed; install it to enable container detection"
+    for name in dataclasses.fields(detector_config):
+        value = getattr(detector_config, name.name, None)
+        if value is None:
+            continue
+        if name.name in _RESOURCE_DETECTOR_REGISTRY:
+            detected_attrs.update(
+                _RESOURCE_DETECTOR_REGISTRY[name.name](value)
             )
         else:
-            detected_attrs.update(ep.load()().detect().attributes)
+            cls = load_entry_point(
+                "opentelemetry_resource_detector", name.name
+            )
+            detected_attrs.update(cls(**(value or {})).detect().attributes)
 
-    if detector_config.process is not None:
-        detected_attrs.update(ProcessResourceDetector().detect().attributes)
+    for name, plugin_config in detector_config.additional_properties.items():
+        cls = load_entry_point("opentelemetry_resource_detector", name)
+        detected_attrs.update(cls(**(plugin_config or {})).detect().attributes)
 
 
 def _filter_attributes(
diff --git a/opentelemetry-sdk/src/opentelemetry/sdk/metrics/_internal/_view_instrument_match.py b/opentelemetry-sdk/src/opentelemetry/sdk/metrics/_internal/_view_instrument_match.py
@@ -94,7 +94,7 @@ def consume_measurement(
                 if key in self._view._attribute_keys:
                     attributes[key] = value
         elif measurement.attributes is not None:
-            attributes = measurement.attributes
+            attributes = dict(measurement.attributes)
         else:
             attributes = {}
 
diff --git a/opentelemetry-sdk/tests/_configuration/test_propagator.py b/opentelemetry-sdk/tests/_configuration/test_propagator.py
@@ -225,6 +225,40 @@ def test_unknown_composite_list_propagator_raises(self):
             with self.assertRaises(ConfigurationError):
                 create_propagator(config)
 
+    def test_plugin_propagator_via_entry_point(self):
+        mock_propagator = MagicMock()
+        mock_ep = MagicMock()
+        mock_ep.load.return_value = lambda: mock_propagator
+
+        with patch(
+            "opentelemetry.sdk._configuration._common.entry_points",
+            return_value=[mock_ep],
+        ):
+            config = PropagatorConfig(
+                composite=[
+                    # pylint: disable=unexpected-keyword-arg
+                    TextMapPropagatorConfig(my_custom_propagator={})
+                ]
+            )
+            result = create_propagator(config)
+
+        self.assertEqual(len(result._propagators), 1)  # type: ignore[attr-defined]
+        self.assertIs(result._propagators[0], mock_propagator)  # type: ignore[attr-defined]
+
+    def test_unknown_composite_propagator_raises(self):
+        with patch(
+            "opentelemetry.sdk._configuration._common.entry_points",
+            return_value=[],
+        ):
+            config = PropagatorConfig(
+                composite=[
+                    # pylint: disable=unexpected-keyword-arg
+                    TextMapPropagatorConfig(nonexistent={})
+                ]
+            )
+            with self.assertRaises(ConfigurationError):
+                create_propagator(config)
+
 
 class TestConfigurePropagator(unittest.TestCase):
     def test_configure_propagator_calls_set_global_textmap(self):
diff --git a/opentelemetry-sdk/tests/_configuration/test_resource.py b/opentelemetry-sdk/tests/_configuration/test_resource.py
diff --git a/opentelemetry-sdk/tests/metrics/test_view_instrument_match.py b/opentelemetry-sdk/tests/metrics/test_view_instrument_match.py

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+`opentelemetry-api`, `opentelemetry-sdk`: add support for 'random-trace-id' flags in W3C traceparent header trace flags. Implementations of `IdGenerator` that do randomly generate the 56 least significant bits, should also implement a `is_trace_id_random` methods that returns `True`.
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+logs: add exception support to Logger emit and LogRecord attributes`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+`opentelemetry-exporter-otlp-proto-grpc`: make retryable gRPC error codes configurable for gRPC exporters
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+`opentelemetry-sdk`: Add `create_logger_provider`/`configure_logger_provider` to declarative file configuration, enabling LoggerProvider instantiation from config files without reading env vars
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+`opentelemetry-exporter-otlp-json-common`: add 'opentelemetry-exporter-otlp-json-common' package for OTLP JSON exporters
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+`opentelemetry-sdk`: Add `service` resource detector support to declarative file configuration via `detection_development.detectors[].service`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+Add `registry` keyword argument to `PrometheusMetricReader` to allow passing a custom Prometheus registry
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+Fix incorrect code example in `create_tracer()` docstring
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+`opentelemetry-sdk`: Fix `ProcessResourceDetector` to use `sys.orig_argv` so that `process.command`, `process.command_line`, and `process.command_args` reflect the original invocation for `python -m <module>` runs (where `sys.argv[0]` is rewritten to the module path)