Drop python 3.9 support (#930)

mattwang44 · web-flow · commit 02f87ce564af · 2026-02-06T11:55:54.000Z
* Drop py3.9 support

* Fix lint issues

* Upgrade ruff hook and fix lint issues
diff --git a/.github/workflows/codspeed.yml b/.github/workflows/codspeed.yml
@@ -16,7 +16,7 @@ jobs:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
         with:
-          python-version: "3.9"
+          python-version: "3.10"
 
       - name: Get full Python version
         id: full-python-version
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -21,14 +21,14 @@ jobs:
             platform: linux
           - os: windows
             ls: dir
-            interpreter: 3.9 3.10 3.11 3.12 3.13 3.14 pypy3.11
+            interpreter: 3.10 3.11 3.12 3.13 3.14 pypy3.11
           - os: windows
             ls: dir
             target: aarch64
             interpreter: 3.11 3.12 3.13 3.14
           - os: macos
             target: aarch64
-            interpreter: 3.9 3.10 3.11 3.12 3.13 3.14 pypy3.11
+            interpreter: 3.10 3.11 3.12 3.13 3.14 pypy3.11
           - os: ubuntu
             platform: linux
             target: aarch64
@@ -44,11 +44,11 @@ jobs:
           - os: ubuntu
             platform: linux
             target: ppc64le
-            interpreter: 3.9 3.10 3.11 3.12 3.13 3.14
+            interpreter: 3.10 3.11 3.12 3.13 3.14
           - os: ubuntu
             platform: linux
             target: s390x
-            interpreter: 3.9 3.10 3.11 3.12 3.13 3.14
+            interpreter: 3.10 3.11 3.12 3.13 3.14
 
     runs-on: ${{ matrix.os }}-latest
     steps:
@@ -66,7 +66,7 @@ jobs:
           target: ${{ matrix.target }}
           manylinux: ${{ matrix.manylinux || 'auto' }}
           container: ${{ matrix.container }}
-          args: --release --out dist --interpreter ${{ matrix.interpreter || '3.9 3.10 3.11 3.12 3.13 3.14 pypy3.11' }} ${{ matrix.extra-build-args }}
+          args: --release --out dist --interpreter ${{ matrix.interpreter || '3.10 3.11 3.12 3.13 3.14 pypy3.11' }} ${{ matrix.extra-build-args }}
           rust-toolchain: stable
           docker-options: -e CI
 
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -33,7 +33,7 @@ jobs:
     strategy:
       matrix:
         os: [Ubuntu, MacOS, Windows]
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
     defaults:
       run:
         shell: bash
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -12,7 +12,7 @@ repos:
       - id: debug-statements
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.2
+    rev: v0.14.11
     hooks:
       - id: ruff
       - id: ruff-format
diff --git a/README.rst b/README.rst
@@ -13,7 +13,7 @@ Pendulum
 
 Python datetimes made easy.
 
-Supports Python **3.9 and newer**.
+Supports Python **3.10 and newer**.
 
 
 .. code-block:: python
diff --git a/poetry.lock b/poetry.lock
diff --git a/pyproject.toml b/pyproject.toml
@@ -3,14 +3,13 @@ name = "pendulum"
 version = "3.2.0"
 description = "Python datetimes made easy"
 readme = "README.rst"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = { text = "MIT License" }
 authors = [{ name = "Sébastien Eustace", email = "sebastien@eustace.io" }]
 keywords = ['datetime', 'date', 'time']
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -72,7 +71,7 @@ include = [
 [tool.ruff]
 fix = true
 line-length = 88
-target-version = "py39"
+target-version = "py310"
 extend-exclude = [
     # External to the project's coding standards:
     "docs/*",
diff --git a/src/pendulum/__init__.py b/src/pendulum/__init__.py
@@ -5,7 +5,6 @@
 from functools import cache
 from typing import TYPE_CHECKING
 from typing import Any
-from typing import Union
 from typing import cast
 from typing import overload
 
@@ -117,7 +116,7 @@ def _safe_timezone(
 
             obj = int(offset.total_seconds())
 
-    obj = cast("Union[str, int]", obj)
+    obj = cast("str | int", obj)
 
     return timezone(obj)
 
diff --git a/src/pendulum/datetime.py b/src/pendulum/datetime.py
@@ -6,9 +6,7 @@
 
 from typing import TYPE_CHECKING
 from typing import Any
-from typing import Callable
 from typing import ClassVar
-from typing import Optional
 from typing import cast
 from typing import overload
 
@@ -42,7 +40,9 @@
 
 
 if TYPE_CHECKING:
-    from typing_extensions import Literal
+    from collections.abc import Callable
+    from typing import Literal
+
     from typing_extensions import Self
     from typing_extensions import SupportsIndex
 
@@ -1006,7 +1006,7 @@ def nth_of(self, unit: str, nth: int, day_of_week: WeekDay) -> Self:
         if unit not in ["month", "quarter", "year"]:
             raise ValueError(f'Invalid unit "{unit}" for first_of()')
 
-        dt = cast("Optional[Self]", getattr(self, f"_nth_of_{unit}")(nth, day_of_week))
+        dt = cast("Self | None", getattr(self, f"_nth_of_{unit}")(nth, day_of_week))
         if not dt:
             raise PendulumException(
                 f"Unable to find occurrence {nth}"
diff --git a/src/pendulum/formatting/formatter.py b/src/pendulum/formatting/formatter.py
@@ -6,7 +6,6 @@
 from re import Match
 from typing import TYPE_CHECKING
 from typing import Any
-from typing import Callable
 from typing import ClassVar
 from typing import cast
 
@@ -16,6 +15,7 @@
 
 
 if TYPE_CHECKING:
+    from collections.abc import Callable
     from collections.abc import Sequence
 
     from pendulum import Timezone
diff --git a/src/pendulum/parsing/__init__.py b/src/pendulum/parsing/__init__.py
@@ -9,7 +9,6 @@
 from datetime import datetime
 from datetime import time
 from typing import Any
-from typing import Optional
 from typing import cast
 
 from dateutil import parser
@@ -90,7 +89,7 @@ def _normalize(
         return parsed
 
     if isinstance(parsed, time):
-        now = cast("Optional[datetime]", options["now"]) or datetime.now()
+        now = cast("datetime | None", options["now"]) or datetime.now()
 
         return datetime(
             now.year,
diff --git a/src/pendulum/time.py b/src/pendulum/time.py
@@ -5,7 +5,6 @@
 from datetime import time
 from datetime import timedelta
 from typing import TYPE_CHECKING
-from typing import Optional
 from typing import cast
 from typing import overload
 
@@ -21,7 +20,8 @@
 
 
 if TYPE_CHECKING:
-    from typing_extensions import Literal
+    from typing import Literal
+
     from typing_extensions import Self
     from typing_extensions import SupportsIndex
 
@@ -284,7 +284,7 @@ def replace(
             minute,
             second,
             microsecond,
-            tzinfo=cast("Optional[datetime.tzinfo]", tzinfo),
+            tzinfo=cast("datetime.tzinfo | None", tzinfo),
             fold=fold,
         )
         return self.__class__(
diff --git a/tests/datetime/test_from_format.py b/tests/datetime/test_from_format.py
@@ -38,7 +38,7 @@ def test_from_format_with_timezone():
 
 
 def test_from_format_with_square_bracket_in_timezone():
-    with pytest.raises(ValueError, match="^String does not match format"):
+    with pytest.raises(ValueError, match=r"^String does not match format"):
         pendulum.from_format(
             "1975-05-21 22:32:11 Eu[rope/London",
             "YYYY-MM-DD HH:mm:ss z",
diff --git a/tox.ini b/tox.ini
@@ -1,6 +1,6 @@
 [tox]
 isolated_build = true
-envlist = py37, py38, py39, py310, pypy3
+envlist = py310, py311, py312, py313, pypy3
 
 [testenv]
 whitelist_externals = poetry
