Fix: Unable to run ADOT Python unit tests with latest Tox release (#521)

Tox 3.27.1 was released on November 14, 2022 — before Python 3.12
(October 2023) and Python 3.13 (October 2024) — and does not officially
support either version.

This PR resolves the blocking issue caused by using the latest Tox
release 4.30.3.

Changes:
- Updated tox.ini to pass valid VCS requirement strings to pip and avoid
shell/INI parsing issues.
- Removed stray spaces before '@' in pip VCS requirement specifiers.
- Removed unnecessary wrapping quotes so strings are not passed with
quote characters.
- Escaped the '#' in INI fragments to ensure the tox/INI parser
preserves pip fragments (e.g., `#egg=...`).

Tested with:
```bash
python -m venv .venv
source .venv/bin/activate
pip install tox
tox -e lint
tox -e spellcheck
tox -e 3.9-test-aws-opentelemetry-distro
tox -e 3.10-test-aws-opentelemetry-distro
tox -e 3.11-test-aws-opentelemetry-distro
tox -e 3.12-test-aws-opentelemetry-distro
tox -e 3.13-test-aws-opentelemetry-distro
```

By submitting this pull request, I confirm that you can use, modify,
copy, and redistribute this contribution, under the terms of your
choice.

Author: lukeina2z

.github/actions/set_up/action.yml

@@ -27,7 +27,8 @@ runs:
 
     - name: Install tox
       shell: bash
-      run: pip install tox==3.27.1 tox-factor
+      run: |
+        pip install tox==4.30.3
 
     - name: Cache tox environment
       # Preserves .tox directory between runs for faster installs
@@ -41,4 +42,7 @@ runs:
     - name: Run unit tests/benchmarks with tox
       if: ${{ inputs.run_unit_tests == 'true' }}
       shell: bash
-      run: tox -f ${{ inputs.python_version }}-${{ inputs.package_name }} -- -ra
+      run: |
+        ENV_NAME="${{ inputs.python_version }}-test-${{ inputs.package_name }}"
+        echo "Running tox env: $ENV_NAME"
+        tox -e "$ENV_NAME" -- -ra

CHANGELOG.md

@@ -17,3 +17,5 @@ If your change does not need a CHANGELOG entry, add the "skip changelog" label t
     ([#497](https://github.com/aws-observability/aws-otel-python-instrumentation/pull/497))
 - Fix timeout handling for exceeded deadline in retry logic in OTLPAwsLogsExporter
   ([#501](https://github.com/aws-observability/aws-otel-python-instrumentation/pull/501))
+- Fix: Unable to run ADOT Python unit tests with latest Tox release
+  ([#521](https://github.com/aws-observability/aws-otel-python-instrumentation/pull/521))

tox.ini

@@ -35,11 +35,11 @@ commands_pre =
 ; cases but it saves a lot of boilerplate in this file.
   test: pip install botocore
   test: pip install gevent
-  test: pip install "opentelemetry-api[test] @ {env:CORE_REPO}#egg=opentelemetry-api&subdirectory=opentelemetry-api"
-  test: pip install "opentelemetry-sdk[test] @ {env:CORE_REPO}#egg=opentelemetry-sdk&subdirectory=opentelemetry-sdk"
-  test: pip install "opentelemetry-instrumentation[test] @ {env:CONTRIB_REPO}#egg=opentelemetry-instrumentation&subdirectory=opentelemetry-instrumentation"
-  test: pip install "opentelemetry-exporter-otlp[test] @ {env:CORE_REPO}#egg=opentelemetry-exporter-otlp&subdirectory=exporter/opentelemetry-exporter-otlp"
-  test: pip install "opentelemetry-test-utils @ {env:CORE_REPO}#egg=opentelemetry-test-utils&subdirectory=tests/opentelemetry-test-utils"
+  test: pip install opentelemetry-api[test]@{env:CORE_REPO}\#egg=opentelemetry-api&subdirectory=opentelemetry-api
+  test: pip install opentelemetry-sdk[test]@{env:CORE_REPO}\#egg=opentelemetry-sdk&subdirectory=opentelemetry-sdk
+  test: pip install opentelemetry-instrumentation[test]@{env:CONTRIB_REPO}\#egg=opentelemetry-instrumentation&subdirectory=opentelemetry-instrumentation
+  test: pip install opentelemetry-exporter-otlp[test]@{env:CORE_REPO}\#egg=opentelemetry-exporter-otlp&subdirectory=exporter/opentelemetry-exporter-otlp
+  test: pip install opentelemetry-test-utils@{env:CORE_REPO}\#egg=opentelemetry-test-utils&subdirectory=tests/opentelemetry-test-utils
   aws-opentelemetry-distro: pip install {toxinidir}/aws-opentelemetry-distro
 
 commands =