installing xds-proto breaks opentelemetry-proto

[avelychko12]

Describe your environment

OS: (e.g, Ubuntu)
Python version: (e.g., Python 3.11.2)
SDK version: (e.g., 1.39.0)
API version: (e.g., 1.39.0)

What happened?

after installing xds-proto some opentelemetry-proto files becomes broken

Steps to Reproduce

$ uv pip uninstall xds-protos opentelemetry-proto
warning: Skipping opentelemetry-proto as it is not installed
warning: Skipping xds-protos as it is not installed
warning: No packages to uninstall

$ uv pip install opentelemetry-proto
 + opentelemetry-proto==1.39.0
 + protobuf==6.33.2

$ python -c "from opentelemetry.proto.common.v1.common_pb2 import InstrumentationScope"
// everything is fine

$ uv pip install xds-protos
 + grpcio==1.76.0
 + typing-extensions==4.15.0
 + xds-protos==1.76.0

$ python -c "from opentelemetry.proto.common.v1.common_pb2 import InstrumentationScope"
Traceback (most recent call last):
  File "<string>", line 1, in <module>
ImportError: cannot import name 'InstrumentationScope' from 'opentelemetry.proto.common.v1.common_pb2'

reinstalling opentelemetry-proto after it fixes ImportError

Expected Result

no ImportError after installing xds-proto

Actual Result

ImportError

Additional context

No response

Would you like to implement a fix?

None

Tip

_{React with 👍 to help prioritize this issue. Please use comments to provide useful context, avoiding +1 or me too, to help us triage it. Learn more here.}

[aabmass]

This problem seems to be only happening in a recent python change. I only see the issue on non-EOL versions and the most recent patch release. For example 3.13.7 but not 3.13.6. I'm guessing there was some backport that is causing the problem.

# Fine
/ # uvx --python 3.9 --with xds-protos --with opentelemetry-proto python -c "from opentelemetry.proto
.common.v1.common_pb2 import InstrumentationScope; print(InstrumentationScope(name='foo'))"
name: "foo"

# Fails
/ # uvx --python 3.13.7 --managed-python --with xds-protos --with opentelemetry-proto python -c "from
 opentelemetry.proto.common.v1.common_pb2 import InstrumentationScope; print(InstrumentationScope(nam
e='foo'))"
Traceback (most recent call last):
  File "<string>", line 1, in <module>
    from opentelemetry.proto.common.v1.common_pb2 import InstrumentationScope; print(InstrumentationScope(name='foo'))
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ImportError: cannot import name 'InstrumentationScope' from 'opentelemetry.proto.common.v1.common_pb2' (/root/.cache/uv/archive-v0/pwBxfZ3EgBCxfOQQxhWCK/lib/python3.13/site-packages/opentelemetry/proto/common/v1/common_pb2.py)

# Fine
/ # uvx --python 3.13.6 --managed-python --with xds-protos --with opentelemetry-proto python -c "from
 opentelemetry.proto.common.v1.common_pb2 import InstrumentationScope; print(InstrumentationScope(nam
e='foo'))"
Installed 5 packages in 208ms
name: "foo"

UV installed these versions btw

Installed 5 packages in 528ms
 + grpcio==1.76.0
 + opentelemetry-proto==1.39.0
 + protobuf==6.33.2
 + typing-extensions==4.15.0
 + xds-protos==1.76.0

[aabmass]

I'm not sure what's going on with the python versions, but the issue is that

1. Both packages provide opentelemetry proto code. See xds-protos source https://github.com/grpc/grpc/blob/46b1795eacc99065c46e3fb60fad808c19f71a87/tools/distrib/python/xds_protos/opentelemetry/proto/trace/v1/trace_pb2.py#L29
2. The xds-protos version is based on a much older release of open-telemetry/opentelemetry-proto repo:

$ docker run --rm -it ghcr.io/astral-sh/uv:python3.13-alpine /bin/sh
/ # uvx --python 3.13 --with opentelemetry-proto --with xds-protos python
Installed 5 packages in 541ms
Python 3.13.7 (main, Aug 15 2025, 22:06:01) [GCC 14.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from opentelemetry.proto.common.v1 import common_pb2
>>> common_pb2.InstrumentationLibrary()

@avelychko12 would you mind filing an issue in the grpc repo? I think this is generally undefined behavior for protobufs and you shouldn't install both. The gRPC team might be better equipped to field this issue than us.