feat: support Python 3.10-3.14, drop 3.8/3.9

- Fix missing `import importlib.util` that caused NameError on Python 3.12+
  (root cause of PR #374 failures)
- Replace deprecated `find_module`/`load_module` with `find_spec`/`module_from_spec`
  in plugin loader and doc generator
- Remove Python <3.8 `pkg_resources` fallback (dead code since 3.8 dropped)
- Update CI matrix: test Python 3.10/3.11/3.12/3.13/3.14
- Fix CI test step: use `--without plugins,lint` to avoid installing
  incompatible old plugin test deps on newer Python versions
  (plugin tests run in Docker, host only needs pytest + testcontainers)
- Mark plugins and lint dependency groups as optional
- Change plugin dep pins from exact versions to `>=` ranges so
  poetry lock resolves on newer Python (actual test versions unchanged,
  controlled by support_matrix in each plugin + Docker)
- Update deps: unpin psutil, loosen wrapt/uvloop/grpcio-tools constraints
- Remove uwsgi from dev deps (doesn't build on 3.12+, tested via e2e)
- Update testcontainers DockerCompose usage for v4 API compatibility
- Replace unapproved getsentry/paths-filter with dorny/paths-filter
- Update docker/Makefile and Container.md for 3.10-3.14

Verified: Docker images build and agent loads all 35 plugins successfully
on Python 3.10, 3.11, 3.12, 3.13, and 3.14.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: wu-sheng

.github/workflows/CI.yaml

@@ -45,10 +45,12 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: "3.11"
       - name: Lint codes
         run: |
-          make env
+          make poetry
+          poetry install --all-extras --with lint
+          make gen
           make lint
 
   # Check if the plugin doc is generated correctly
@@ -65,7 +67,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: "3.14"
       - name: Check plugin doc
         run: |
           make env
@@ -86,10 +88,9 @@ jobs:
         with:
           persist-credentials: false
       - name: Check for file changes
-        uses: getsentry/paths-filter@v2.11.1
+        uses: dorny/paths-filter@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
         id: filter
         with:
-          token: ${{ github.token }}
           # The following filters indicate a category along with
           # the files that should not be ignored by CI when modified.
           filters: |
@@ -138,7 +139,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix: # may support pypy in the future
-        python-version: [ "3.8-slim", "3.9-slim", "3.10-slim", "3.11-slim" ]
+        python-version: [ "3.10-slim", "3.11-slim", "3.12-slim", "3.13-slim", "3.14-slim" ]
       fail-fast: false
     env:
       BASE_PYTHON_IMAGE: ${{ matrix.python-version }}
@@ -171,7 +172,7 @@ jobs:
     timeout-minutes: 20
     strategy:
       matrix:
-        python-version: [ "3.8", "3.9", "3.10", "3.11" ]
+        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14" ]
         test-path: ${{fromJson(needs.prep-plugin-and-unit-tests.outputs.matrix)}}
       fail-fast: false
     env:
@@ -205,7 +206,9 @@ jobs:
           python-version: ${{ matrix.python-version }}
       - name: Run unit tests
         run: |
-          make env
+          make poetry
+          poetry install --all-extras --without plugins,lint
+          make gen
           poetry run pytest -v ${{ matrix.test-path }}
 
   docker-e2e:
@@ -219,7 +222,7 @@ jobs:
     timeout-minutes: 10
     strategy:
       matrix:
-        python-image-variant: [ "3.8-slim", "3.9-slim", "3.10-slim", "3.11-slim" ]
+        python-image-variant: [ "3.10-slim", "3.11-slim", "3.12-slim", "3.13-slim", "3.14-slim" ]
       fail-fast: false
     env:
       BASE_PYTHON_IMAGE: ${{ matrix.python-image-variant }}
@@ -251,7 +254,7 @@ jobs:
     timeout-minutes: 20
     strategy:
       matrix:
-        python-image-variant: [ "3.8-slim", "3.9-slim", "3.10-slim", "3.11-slim" ]
+        python-image-variant: [ "3.10-slim", "3.11-slim", "3.12-slim", "3.13-slim", "3.14-slim" ]
         case:
           - name: gRPC-single-process
             path: tests/e2e/case/grpc/single/e2e.yaml

Makefile

@@ -52,12 +52,12 @@ endif
 
 .PHONY: gen
 gen:
-	poetry run pip install grpcio-tools==1.68.0 packaging
+	poetry run pip install 'grpcio-tools>=1.68.0' packaging
 	poetry run python3 tools/grpc_code_gen.py
 
 .PHONY: gen-basic
 gen-basic:
-	python3 -m pip install grpcio-tools==1.68.0 packaging
+	python3 -m pip install 'grpcio-tools>=1.68.0' packaging
 	python3 tools/grpc_code_gen.py
 
 .PHONY: install
@@ -97,7 +97,7 @@ license: clean
 .PHONY: test
 test: env
 	sudo apt-get -y install jq
-	docker build --build-arg BASE_PYTHON_IMAGE=3.8-slim -t apache/skywalking-python-agent:latest-plugin --no-cache . -f tests/plugin/Dockerfile.plugin
+	docker build --build-arg BASE_PYTHON_IMAGE=3.11-slim -t apache/skywalking-python-agent:latest-plugin --no-cache . -f tests/plugin/Dockerfile.plugin
 	poetry run pytest -v $(bash tests/gather_test_paths.sh)
 
 .PHONY: package

docker/Makefile

@@ -21,34 +21,40 @@ D := docker
 
 P := grpc http kafka
 
-TARGETS := py3.8 py3.9 py3.10 py3.8-slim py3.9-slim py3.10-slim
+TARGETS := py3.10 py3.11 py3.12 py3.13 py3.14 py3.10-slim py3.11-slim py3.12-slim py3.13-slim py3.14-slim
 
-py3.8: BASE_PYTHON_IMAGE = python:3.8
-py3.9: BASE_PYTHON_IMAGE = python:3.9
 py3.10: BASE_PYTHON_IMAGE = python:3.10
 py3.11: BASE_PYTHON_IMAGE = python:3.11
-py3.8-slim: BASE_PYTHON_IMAGE = python:3.8-slim
-py3.9-slim: BASE_PYTHON_IMAGE = python:3.9-slim
+py3.12: BASE_PYTHON_IMAGE = python:3.12
+py3.13: BASE_PYTHON_IMAGE = python:3.13
+py3.14: BASE_PYTHON_IMAGE = python:3.14
 py3.10-slim: BASE_PYTHON_IMAGE = python:3.10-slim
 py3.11-slim: BASE_PYTHON_IMAGE = python:3.11-slim
+py3.12-slim: BASE_PYTHON_IMAGE = python:3.12-slim
+py3.13-slim: BASE_PYTHON_IMAGE = python:3.13-slim
+py3.14-slim: BASE_PYTHON_IMAGE = python:3.14-slim
 
-push-py3.8: BASE_PYTHON_IMAGE = python:3.8
-push-py3.9: BASE_PYTHON_IMAGE = python:3.9
 push-py3.10: BASE_PYTHON_IMAGE = python:3.10
 push-py3.11: BASE_PYTHON_IMAGE = python:3.11
-push-py3.8-slim: BASE_PYTHON_IMAGE = python:3.8-slim
-push-py3.9-slim: BASE_PYTHON_IMAGE = python:3.9-slim
+push-py3.12: BASE_PYTHON_IMAGE = python:3.12
+push-py3.13: BASE_PYTHON_IMAGE = python:3.13
+push-py3.14: BASE_PYTHON_IMAGE = python:3.14
 push-py3.10-slim: BASE_PYTHON_IMAGE = python:3.10-slim
 push-py3.11-slim: BASE_PYTHON_IMAGE = python:3.11-slim
+push-py3.12-slim: BASE_PYTHON_IMAGE = python:3.12-slim
+push-py3.13-slim: BASE_PYTHON_IMAGE = python:3.13-slim
+push-py3.14-slim: BASE_PYTHON_IMAGE = python:3.14-slim
 
-push-py3.8: BUILDER_PYTHON_IMAGE = python:3.8
-push-py3.9: BUILDER_PYTHON_IMAGE = python:3.9
 push-py3.10: BUILDER_PYTHON_IMAGE = python:3.10
 push-py3.11: BUILDER_PYTHON_IMAGE = python:3.11
-push-py3.8-slim: BUILDER_PYTHON_IMAGE = python:3.8
-push-py3.9-slim: BUILDER_PYTHON_IMAGE = python:3.9
+push-py3.12: BUILDER_PYTHON_IMAGE = python:3.12
+push-py3.13: BUILDER_PYTHON_IMAGE = python:3.13
+push-py3.14: BUILDER_PYTHON_IMAGE = python:3.14
 push-py3.10-slim: BUILDER_PYTHON_IMAGE = python:3.10
 push-py3.11-slim: BUILDER_PYTHON_IMAGE = python:3.11
+push-py3.12-slim: BUILDER_PYTHON_IMAGE = python:3.12
+push-py3.13-slim: BUILDER_PYTHON_IMAGE = python:3.13
+push-py3.14-slim: BUILDER_PYTHON_IMAGE = python:3.14
 
 PUSH_TARGETS := $(TARGETS:%=push-%)
 

docs/en/setup/Container.md

@@ -4,7 +4,7 @@
 source**
 
 This image hosts the SkyWalking Python agent package on top of official Python base images (full & slim) providing support from 
-Python 3.8 - 3.11.
+Python 3.10 - 3.14.
 
 ## How to use this image