Bump minimal Python version to 3.10.

Author: andialbrecht

.github/workflows/python-app.yml

@@ -19,10 +19,6 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - python-version: "3.8"
-            os: ubuntu-latest
-          - python-version: "3.9"
-            os: ubuntu-latest
           - python-version: "3.10"
             os: ubuntu-latest
           - python-version: "3.11"

AGENTS.md

@@ -4,7 +4,7 @@ This file provides guidance to Agents when working with code in this repository.
 
 ## Project Overview
 
-sqlparse is a non-validating SQL parser for Python that provides support for parsing, splitting, and formatting SQL statements. It's compatible with Python 3.8+ and supports multiple SQL dialects (Oracle, MySQL, PostgreSQL/PL/pgSQL, HQL, MS Access, Snowflake, BigQuery).
+sqlparse is a non-validating SQL parser for Python that provides support for parsing, splitting, and formatting SQL statements. It's compatible with Python 3.10+ and supports multiple SQL dialects (Oracle, MySQL, PostgreSQL/PL/pgSQL, HQL, MS Access, Snowflake, BigQuery).
 
 ## Development Commands
 

CHANGELOG

@@ -1,9 +1,20 @@
 Development Version
 -------------------
 
+Notable Changes
+
+* Drop support for Python 3.8 and 3.9. Python 3.10+ is now required.
+* Migrate project dependencies and environment management from `pixi` to `uv`.
+* Replace `flake8` with `ruff` for code checking and linting.
+
+Enhancements
+
+* Modernize type annotations in top-level API functions using PEP 585 and PEP 604 syntax.
+
 Bug Fixes
 
 * Fix statement splitting (issue845).
+* Fix a late-binding closure bug in `TokenList.token_not_matching`.
 
 
 Release 0.5.5 (Dec 19, 2025)

Makefile

@@ -10,8 +10,6 @@ help:
 	@sed -n '/^[a-zA-Z0-9_.]*:/s/:.*//p' <Makefile | sort
 
 test:
-	uv run --group dev --python 3.8 pytest tests/
-	uv run --group dev --python 3.9 pytest tests/
 	uv run --group dev --python 3.10 pytest tests/
 	uv run --group dev --python 3.11 pytest tests/
 	uv run --group dev --python 3.12 pytest tests/

pyproject.toml

@@ -16,8 +16,6 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "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",
     "Programming Language :: Python :: 3.12",
@@ -27,8 +25,8 @@ classifiers = [
     "Programming Language :: Python :: Implementation :: PyPy",
     "Topic :: Database",
     "Topic :: Software Development",
-]
-requires-python = ">=3.8"
+ ]
+requires-python = ">=3.10"
 
 [project.urls]
 Home = "https://github.com/andialbrecht/sqlparse"
@@ -79,7 +77,7 @@ dev = [
 ]
 
 [tool.ruff]
-target-version = "py38"
+target-version = "py310"
 exclude = [
     "dist",
     "docs",

sqlparse/__init__.py

@@ -8,7 +8,8 @@
 """Parse SQL statements."""
 
 # Setup namespace
-from typing import IO, Any, Generator, List, Optional, Tuple, Union
+from collections.abc import Generator
+from typing import IO, Any
 
 from sqlparse import cli, engine, filters, formatter, sql, tokens
 
@@ -17,8 +18,8 @@
 
 
 def parse(
-    sql: str, encoding: Optional[str] = None
-) -> Tuple[sql.Statement, ...]:
+    sql: str, encoding: str | None = None
+) -> tuple[sql.Statement, ...]:
     """Parse sql and return a list of statements.
 
     :param sql: A string containing one or more SQL statements.
@@ -29,7 +30,7 @@ def parse(
 
 
 def parsestream(
-    stream: Union[str, IO[str]], encoding: Optional[str] = None
+    stream: str | IO[str], encoding: str | None = None
 ) -> Generator[sql.Statement, None, None]:
     """Parses sql statements from file-like object.
 
@@ -42,7 +43,7 @@ def parsestream(
     return stack.run(stream, encoding)
 
 
-def format(sql: str, encoding: Optional[str] = None, **options: Any) -> str:
+def format(sql: str, encoding: str | None = None, **options: Any) -> str:
     """Format *sql* according to *options*.
 
     Available options are documented in :ref:`formatting`.
@@ -60,8 +61,8 @@ def format(sql: str, encoding: Optional[str] = None, **options: Any) -> str:
 
 
 def split(
-    sql: str, encoding: Optional[str] = None, strip_semicolon: bool = False
-) -> List[str]:
+    sql: str, encoding: str | None = None, strip_semicolon: bool = False
+) -> list[str]:
     """Split *sql* into single statements.
 
     :param sql: A string containing one or more SQL statements.