listgen: add Python 3.12 (#98)

* listgen: add Python 3.12

* README: bump Python version

* docs: bump Python version

* listgen: handle missing list case

* listgen: oops

* stdlib_list: add 3.12 to long_versions

* ci: run CI on 3.12

* pyproject: update description

Author: woodruffw

.github/workflows/ci.yml

@@ -17,6 +17,7 @@ jobs:
           - "3.9"
           - "3.10"
           - "3.11"
+          - "3.12"
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.github/workflows/listgen.yml

@@ -70,9 +70,14 @@ jobs:
           python ./support/walk-modules.py "${LISTGEN_PYTHON_VERSION}.txt" < pre-list.txt
           rm pre-list.txt
 
-          sort -u -o ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
-            ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
-            "${LISTGEN_PYTHON_VERSION}.txt"
+          if [[ -f "./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt"" ]]; then
+            sort -u -o ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
+              ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
+              "${LISTGEN_PYTHON_VERSION}.txt"
+          else
+            sort -u -o ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
+              "${LISTGEN_PYTHON_VERSION}.txt"
+          fi
 
           rm "${LISTGEN_PYTHON_VERSION}.txt"
 
@@ -102,6 +107,7 @@ jobs:
         python:
           - "3.10"
           - "3.11"
+          - "3.12"
 
     runs-on: ubuntu-latest
 
@@ -119,9 +125,14 @@ jobs:
         run: |
           python ./support/walk-modules.py "${LISTGEN_PYTHON_VERSION}.txt"
 
-          sort -u -o ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
-            ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
-            "${LISTGEN_PYTHON_VERSION}.txt"
+          if [[ -f "./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt"" ]]; then
+            sort -u -o ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
+              ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
+              "${LISTGEN_PYTHON_VERSION}.txt"
+          else
+            sort -u -o ./stdlib_list/lists/"${LISTGEN_PYTHON_VERSION}.txt" \
+              "${LISTGEN_PYTHON_VERSION}.txt"
+          fi
 
           rm "${LISTGEN_PYTHON_VERSION}.txt"
 

README.md

@@ -5,7 +5,7 @@
 [![CI](https://github.com/pypi/stdlib-list/actions/workflows/ci.yml/badge.svg)](https://github.com/pypi/stdlib-list/actions/workflows/ci.yml)
 
 This package includes lists of all of the standard libraries for Python 2.6
-through 3.11.
+through 3.12.
 
 **IMPORTANT**: If you're on Python 3.10 or newer, you **probably don't need this library**.
 See [`sys.stdlib_module_names`](https://docs.python.org/3/library/sys.html#sys.stdlib_module_names)

docs/index.rst

@@ -2,7 +2,7 @@ stdlib-list
 ===========
 
 This package includes lists of all of the standard libraries for Python 2.6
-through 3.11.
+through 3.12.
 
 .. note::
 

pyproject.toml

@@ -11,7 +11,7 @@ include = ["tests/"]
 [project]
 name = "stdlib-list"
 dynamic = ["version"]
-description = "A list of Python Standard Libraries (2.7 through 3.11)."
+description = "A list of Python Standard Libraries (2.7 through 3.12)."
 readme = "README.md"
 license = { file = "LICENSE" }
 authors = [{ name = "Jack Maney", email = "[email protected]" }]

stdlib_list/base.py

@@ -18,6 +18,7 @@
     "3.9",
     "3.10",
     "3.11",
+    "3.12",
 ]
 
 short_versions = [".".join(x.split(".")[:2]) for x in long_versions]