feat: switch to python 3.9 (#4780)

Minimum Python version is now 3.9.18.

https://www.python.org/downloads/release/python-3918/
---

By submitting this pull request, I confirm that my contribution is made under the terms of the [Apache 2.0 license].

[Apache 2.0 license]: https://www.apache.org/licenses/LICENSE-2.0

Author: iankhou

.github/workflows/gh-pages.yml

@@ -24,7 +24,7 @@ jobs:
         with:
           cache: 'pip'
           cache-dependency-path: 'gh-pages/requirements-dev.txt'
-          python-version: '3.8'
+          python-version: '3.9'
       - name: Install Dependencies
         run: |-
           python3 -m venv ${{ runner.temp }}/venv

.github/workflows/main.yml

@@ -43,10 +43,10 @@ jobs:
         with:
           cache: yarn
           node-version: 'lts/*'
-      - name: Set up Python 3.8
+      - name: Set up Python 3.9
         uses: actions/setup-python@v5
         with:
-          python-version: '3.8'
+          python-version: '3.9'
           cache: pip
       - name: Install python3-venv
         run: sudo apt install -y python3-venv
@@ -125,10 +125,10 @@ jobs:
         with:
           cache: yarn
           node-version: 'lts/*'
-      - name: Set up Python 3.8
+      - name: Set up Python 3.9
         uses: actions/setup-python@v5
         with:
-          python-version: '3.8'
+          python-version: '3.9'
           cache: pip
       - name: Install python3-venv
         run: sudo apt install -y python3-venv
@@ -191,7 +191,7 @@ jobs:
         java: ['8']
         node: ['18'] # EOL 2025-04-30
         os: [ubuntu-latest]
-        python: ['3.8']
+        python: ['3.9']
         # Add specific combinations to be tested against (to restrict cardinality)
         include:
           # Test using Windows
@@ -201,69 +201,62 @@ jobs:
             go: '1.18'
             java: '8'
             node: '18'
-            python: '3.8'
+            python: '3.9'
           # Test using macOS
           - title: 'macOS'
             os: macos-latest
             dotnet: '6.0.x'
             go: '1.18'
             java: '8'
             node: '18'
-            python: '3.8'
+            python: '3.9'
           # Test alternate Nodes
           - title: 'Node 18'
             java: '8'
             dotnet: '6.0.x'
             go: '1.18'
             node: '18' # EOL 2025-04-30
             os: ubuntu-latest
-            python: '3.8'
+            python: '3.9'
           - title: 'Node 20'
             java: '8'
             dotnet: '6.0.x'
             go: '1.18'
             node: '20' # EOL 2026-04-30
             os: ubuntu-latest
-            python: '3.8'
+            python: '3.9'
           - title: 'Node 22'
             java: '8'
             dotnet: '6.0.x'
             go: '1.18'
             node: '22' # EOL 2027-04-30
             os: ubuntu-latest
-            python: '3.8'
+            python: '3.9'
           # Test alternate .NETs
           - title: '.NET 7.0'
             java: '8'
             dotnet: '7.0.x'
             go: '1.18'
             node: '18'
             os: ubuntu-latest
-            python: '3.8'
+            python: '3.9'
           # Test alternate Gos
           - title: 'Go 1.19'
             java: '8'
             dotnet: '6.0.x'
             go: '1.19'
             node: '18'
             os: ubuntu-latest
-            python: '3.8'
+            python: '3.9'
           # Test alternate Javas
           - title: 'Java 11'
             java: '11'
             dotnet: '6.0.x'
             go: '1.18'
             node: '18'
             os: ubuntu-latest
-            python: '3.8'
+            python: '3.9'
           # Test alternate Pythons
-          - title: 'Python 3.8'
-            python: '3.8'
-            dotnet: '6.0.x'
-            go: '1.18'
-            java: '8'
-            node: '18'
-            os: ubuntu-latest
           - title: 'Python 3.9'
             python: '3.9'
             dotnet: '6.0.x'

CONTRIBUTING.md

@@ -33,7 +33,7 @@ in your development environment.
   - [`maven >= 3.0.5`](https://maven.apache.org)
 - [.NET `6.0`] or later
   - *Recommended:* [`mono >= 6`](https://www.mono-project.com)
-- [Python `3.8.10`] or later
+- [Python `3.9.18`] or later
   - [`pip`](https://pip.pypa.io/en/stable/installing/)
   - [`setuptools >= 38.6.0`](https://pypi.org/project/setuptools/)
   - [`wheel`](https://pypi.org/project/wheel/)
@@ -45,7 +45,7 @@ in your development environment.
 [Oracle's OpenJDK8]: http://openjdk.java.net/install/
 [Amazon Corretto 8]: https://aws.amazon.com/corretto/
 [.NET `6.0`]: https://www.microsoft.com/net/download
-[Python `3.8.10`]: https://www.python.org/downloads/release/python-3810/
+[Python `3.9.18`]: https://www.python.org/downloads/release/python-3918/
 [Go]: https://go.dev/dl/
 
 ## Getting Started

gh-pages/content/user-guides/language-support/index.md

@@ -69,7 +69,7 @@ in significant re-engineering effort:
   - How are dependencies modeled? If [semantic versioning] is not the norm, what is the strategy to correctly represent
     semantic version ranges?
 - What are the toolchain and platform requirements?
-  - For example, **Java** requires an OpenJDK 8 distribution and `maven`, **Python** requires `python` 3.8 or above,
+  - For example, **Java** requires an OpenJDK 8 distribution and `maven`, **Python** requires `python` 3.9 or above,
     etc...
 
 ## Code Generation

gh-pages/content/user-guides/lib-author/configuration/targets/python.md

@@ -16,7 +16,6 @@ The `python` target requires two configuration entries:
   - Additionally, the following `Programming Language ::` classifiers are already set (more could be added by the user
     if relevant):
     - `Programming Language :: Python :: 3 :: Only`
-    - `Programming Language :: Python :: 3.8`
     - `Programming Language :: Python :: 3.9`
     - `Programming Language :: Python :: 3.10`
     - `Programming Language :: Python :: 3.11`

gh-pages/content/user-guides/lib-author/index.md

@@ -19,7 +19,7 @@ to produce releasable artifacts.
 | .NET              | .NET ≥ 6.0                |
 | Go                | Go ≥ 1.18                 |
 | Java              | JDK ≥ 8 _and_ Maven ≥ 3.6 |
-| Python            | Python ≥ 3.8              |
+| Python            | Python ≥ 3.9              |
 
 ## :octicons-desktop-download-24: Download Locations
 

packages/@jsii/python-runtime/pyproject.toml

@@ -3,14 +3,14 @@ requires = ["setuptools~=62.2", "wheel~=0.37"]
 build-backend = 'setuptools.build_meta'
 
 [tool.black]
-target-version = ['py38', 'py39', 'py310', 'py311']
+target-version = ['py39', 'py310', 'py311']
 include = '\.pyi?$'
 exclude = '\.(git|mypy_cache|env)'
 
 [tool.mypy]
 ignore_missing_imports = true
 
 [tool.pyright]
-pythonVersion = "3.8"
+pythonVersion = "3.9"
 venv = ".env"
 venvPath = "."

packages/@jsii/python-runtime/setup.py

@@ -39,14 +39,13 @@
         "python-dateutil",
         "typing_extensions>=3.8,<5.0",
     ],
-    python_requires="~=3.8",
+    python_requires="~=3.9",
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "License :: OSI Approved :: Apache Software License",
         "Programming Language :: JavaScript",
         "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",

packages/jsii-pacmak/lib/targets/python.ts

@@ -2164,7 +2164,7 @@ class Package {
       package_dir: { '': 'src' },
       packages: modules.map((m) => m.pythonName),
       package_data: packageData,
-      python_requires: '~=3.8',
+      python_requires: '~=3.9',
       install_requires: [
         `jsii${toPythonVersionRange(`^${VERSION}`)}`,
         'publication>=0.0.3',
@@ -2178,7 +2178,6 @@ class Package {
         'Operating System :: OS Independent',
         'Programming Language :: JavaScript',
         'Programming Language :: Python :: 3 :: Only',
-        'Programming Language :: Python :: 3.8',
         'Programming Language :: Python :: 3.9',
         'Programming Language :: Python :: 3.10',
         'Programming Language :: Python :: 3.11',
@@ -2300,7 +2299,7 @@ class Package {
     code.line();
     code.line('[tool.pyright]');
     code.line('defineConstant = { DEBUG = true }');
-    code.line('pythonVersion = "3.8"');
+    code.line('pythonVersion = "3.9"');
     code.line('pythonPlatform = "All"');
     code.line('reportSelfClsParameterName = false');
     code.closeFile('pyproject.toml');