Add Python 3.11 and 3.13 support (#4236)

<!-- CURSOR_SUMMARY -->
> [!NOTE]
> **Medium Risk**
> Broader Python version support and CI matrix changes are mostly
low-impact, but dependency constraint updates (notably
`unstructured-ingest`) and new interpreter compatibility can surface
runtime/packaging issues.
> 
> **Overview**
> Adds **Python 3.11 and 3.13 support** by widening `requires-python` to
`>=3.11, <3.14`, updating package classifiers, and bumping the
`unstructured[ingest]` extra’s `unstructured-ingest` lower bound to
`>=1.4.0`.
> 
> Expands CI to run `lint` and multiple unit-test jobs across Python
3.11/3.12/3.13, and moves `test_json_to_html`/`test_json_to_markdown` to
`ubuntu-latest` runners. Also aligns static tooling by setting `ruff`
`target-version=py311` and `pyright` `pythonVersion=3.11`, bumps the
library version to `0.20.0`, and removes a dead pre-3.8 conditional
import in `unstructured/nlp/patterns.py`.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
72e9dd8. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: PastelStorm

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
   setup:
     strategy:
       matrix:
-        python-version: ["3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
@@ -44,7 +44,7 @@ jobs:
   lint:
     strategy:
       matrix:
-        python-version: ["3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
     runs-on: ubuntu-latest
     needs: [setup, changelog]
     steps:
@@ -75,7 +75,7 @@ jobs:
   test_unit:
     strategy:
       matrix:
-        python-version: ["3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
     runs-on: ubuntu-latest
     needs: [setup, lint]
     steps:
@@ -105,7 +105,7 @@ jobs:
   test_unit_no_extras:
     strategy:
       matrix:
-        python-version: ["3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
     runs-on: ubuntu-latest
     needs: [setup, lint]
     steps:
@@ -129,7 +129,7 @@ jobs:
   test_unit_dependency_extras:
     strategy:
       matrix:
-        python-version: ["3.12"]
+        python-version: ["3.11", "3.12", "3.13"]
         extra: ["csv", "docx", "odt", "markdown", "pypandoc", "pdf-image", "pptx", "xlsx"]
         include:
           - extra: csv
@@ -256,7 +256,7 @@ jobs:
     strategy:
       matrix:
         python-version: ["3.12"]
-    runs-on: opensource-linux-8core
+    runs-on: ubuntu-latest
     needs: [setup, lint]
     steps:
     - uses: 'actions/checkout@v4'
@@ -274,7 +274,7 @@ jobs:
     strategy:
       matrix:
         python-version: ["3.12"]
-    runs-on: opensource-linux-8core
+    runs-on: ubuntu-latest
     needs: [setup, lint]
     steps:
     - uses: 'actions/checkout@v4'

CHANGELOG.md

@@ -1,3 +1,13 @@
+## 0.20.0
+
+### Enhancements
+- Add Python 3.11 and 3.13 support (`requires-python = ">=3.11, <3.14"`)
+- Expand CI matrix to test against Python 3.11, 3.12, and 3.13 for lint, unit tests, no-extras tests, and per-extra tests
+- Move lightweight CI jobs (`test_json_to_html`, `test_json_to_markdown`) from `opensource-linux-8core` to `ubuntu-latest` runners
+- Bump `unstructured-ingest` lower bound to `>=1.4.0` (first release with Python 3.11 and 3.13 support)
+- Remove dead `sys.version_info < (3, 8)` conditional import in `unstructured/nlp/patterns.py`
+- Update ruff `target-version` to `py311` and pyright `pythonVersion` to `3.11` to match new minimum
+
 ## 0.19.3
 
 ### Enhancements

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "unstructured"
 description = "A library that prepares raw documents for downstream ML tasks."
-requires-python = ">=3.12"
+requires-python = ">=3.11, <3.14"
 authors = [{name = "Unstructured Technologies", email = "devops@unstructuredai.io"}]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -11,7 +11,9 @@ classifiers = [
     "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
 ]
 readme = "README.md"
@@ -120,7 +122,7 @@ paddleocr = [
     "unstructured-paddleocr==2.10.0",
 ]
 ingest = [
-    "unstructured-ingest[airtable,astradb,azure,azure-ai-search,bedrock,biomed,box,chroma,confluence,couchbase,databricks-volumes,delta-table,discord,dropbox,elasticsearch,gcs,github,gitlab,google-drive,hubspot,huggingface,jira,kafka,kdbai,milvus,mongodb,notion,octoai,onedrive,openai,opensearch,outlook,pinecone,postgres,qdrant,reddit,remote,s3,salesforce,sftp,sharepoint,singlestore,slack,vectara,vertexai,voyageai,weaviate,wikipedia]>=1.3.1, <2.0.0",
+    "unstructured-ingest[airtable,astradb,azure,azure-ai-search,bedrock,biomed,box,chroma,confluence,couchbase,databricks-volumes,delta-table,discord,dropbox,elasticsearch,gcs,github,gitlab,google-drive,hubspot,huggingface,jira,kafka,kdbai,milvus,mongodb,notion,octoai,onedrive,openai,opensearch,outlook,pinecone,postgres,qdrant,reddit,remote,s3,salesforce,sftp,sharepoint,singlestore,slack,vectara,vertexai,voyageai,weaviate,wikipedia]>=1.4.0, <2.0.0",
 ]
 
 [project.urls]
@@ -186,7 +188,7 @@ constraint-dependencies = [
 
 [tool.pyright]
 pythonPlatform = "Linux"
-pythonVersion = "3.12"
+pythonVersion = "3.11"
 reportUnnecessaryCast = true
 reportUnnecessaryTypeIgnoreComment = true
 stubPath = "./typings"
@@ -195,7 +197,7 @@ verboseOutput = true
 
 [tool.ruff]
 line-length = 100
-target-version = "py312"
+target-version = "py311"
 
 [tool.ruff.lint]
 ignore = [

unstructured/__version__.py

@@ -1 +1 @@
-__version__ = "0.19.3"  # pragma: no cover
+__version__ = "0.20.0"  # pragma: no cover

unstructured/nlp/patterns.py

@@ -1,12 +1,5 @@
-import sys
-from typing import List
-
-if sys.version_info < (3, 8):
-    from typing_extensions import Final
-else:
-    from typing import Final
-
 import re
+from typing import Final, List
 
 # NOTE(robinson) - Modified from answers found on this stackoverflow post
 # ref: https://stackoverflow.com/questions/16699007/