deprecate python 3.9

arembridge · arembridge · commit b2fcd069de6d · 2025-12-24T14:47:02.000Z
Manual changes (that weren't addressed by `uvx pyupgrade`)
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -32,7 +32,7 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        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"]
         pydantic-version: ["1.10", "2.0"]
         sqla-version: ["1.4", "2"]
         exclude:
diff --git a/.sourcery.yaml b/.sourcery.yaml
@@ -15,7 +15,7 @@ rule_settings:
     - refactoring
     - suggestion
     - comment
-  python_version: "3.8"
+  python_version: "3.10"
 
 rules: []
 
diff --git a/docs/conf.py b/docs/conf.py
@@ -105,7 +105,7 @@
 autodoc_member_order = "bysource"
 autodoc_typehints_format = "short"
 
-auto_pytabs_min_version = (3, 8)
+auto_pytabs_min_version = (3, 10)
 auto_pytabs_max_version = (3, 11)
 auto_pytabs_compat_mode = True
 
diff --git a/docs/examples/configuration/test_example_11.py b/docs/examples/configuration/test_example_11.py
@@ -6,7 +6,7 @@
 from polyfactory.factories import DataclassFactory
 
 # Define a recursive type using forward reference
-RecursiveType = Union[list["RecursiveType"], int]
+RecursiveType = list["RecursiveType"] | int
 
 
 @dataclass
diff --git a/docs/reference/constants.rst b/docs/reference/constants.rst
diff --git a/polyfactory/constants.py b/polyfactory/constants.py
@@ -3,15 +3,6 @@
 from collections import abc, defaultdict, deque
 from collections.abc import Iterable, Mapping, Sequence
 from random import Random
-from typing import (
-    Union,
-)
-
-try:
-    from types import UnionType
-except ImportError:
-    UnionType = Union  # type: ignore[misc,assignment]
-
 
 # Mapping of type annotations into concrete types.
 TYPE_MAPPING = {
@@ -29,7 +20,6 @@
     abc.Mapping: dict,
     abc.Sequence: list,
     abc.Set: set,
-    UnionType: Union,
 }
 
 
diff --git a/polyfactory/factories/odmantic_odm_factory.py b/polyfactory/factories/odmantic_odm_factory.py
@@ -18,7 +18,7 @@
     msg = "odmantic is not installed"
     raise MissingDependencyException(msg) from e
 
-T = TypeVar("T", bound=Union[Model, EmbeddedModel])
+T = TypeVar("T", bound=Model | EmbeddedModel)
 
 if TYPE_CHECKING:
     from typing import TypeGuard
diff --git a/polyfactory/value_generators/constrained_strings.py b/polyfactory/value_generators/constrained_strings.py
@@ -7,7 +7,7 @@
 from polyfactory.value_generators.primitives import create_random_bytes, create_random_string
 from polyfactory.value_generators.regex import RegexFactory
 
-T = TypeVar("T", bound=Union[bytes, str])
+T = TypeVar("T", bound=bytes | str)
 
 if TYPE_CHECKING:
     from random import Random
diff --git a/pyproject.toml b/pyproject.toml
@@ -17,7 +17,6 @@ classifiers = [
   "License :: OSI Approved :: MIT License",
   "Natural Language :: English",
   "Operating System :: OS Independent",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
@@ -36,7 +35,7 @@ version = "3.2.0"
 description = "Mock data generation factories"
 readme = "docs/PYPI_README.md"
 license = { text = "MIT" }
-requires-python = ">=3.9,<4.0"
+requires-python = ">=3.10,<4.0"
 dependencies = ["faker>=5.0.0", "typing-extensions>=4.6.0"]
 
 [project.optional-dependencies]
@@ -184,7 +183,7 @@ exclude_lines = [
 [tool.ruff]
 line-length = 120
 src = ["polyfactory", "tests", "docs/examples"]
-target-version = "py39"
+target-version = "py310"
 
 [tool.ruff.format]
 docstring-code-format = true
diff --git a/tests/constraints/test_list_constraints.py b/tests/constraints/test_list_constraints.py
@@ -1,12 +1,9 @@
-import sys
 from typing import Any
 
 import pytest
 from hypothesis import given
 from hypothesis.strategies import integers
 
-from pydantic import VERSION
-
 from polyfactory.exceptions import ParameterException
 from polyfactory.factories.pydantic_factory import ModelFactory, PydanticFieldMeta
 from polyfactory.value_generators.constrained_collections import (
@@ -74,10 +71,6 @@ def test_handle_constrained_list_with_min_items(
     assert len(result) >= min_items
 
 
-@pytest.mark.skipif(
-    sys.version_info < (3, 9) and VERSION.startswith("2"),
-    reason="fails on python 3.8 with pydantic v2",
-)
 @pytest.mark.parametrize("t_type", tuple(ModelFactory.get_provider_map()))
 def test_handle_constrained_list_with_different_types(t_type: Any) -> None:
     field_meta = PydanticFieldMeta.from_type(list[t_type], name="test")
diff --git a/tests/test_generics.py b/tests/test_generics.py
@@ -83,7 +83,7 @@ class APIResponseFactory(ModelFactory):
 
 def test_generic_factory_union_response() -> None:
     class APIResponseFactory(ModelFactory):
-        __model__ = APIResponse[Union[OneResponse, TwoResponse, ThreeResponse]]
+        __model__ = APIResponse[OneResponse | TwoResponse | ThreeResponse]
 
     result = APIResponseFactory.build()
 
diff --git a/tests/test_msgspec_factory.py b/tests/test_msgspec_factory.py
@@ -130,7 +130,6 @@ class FooFactory(MsgspecFactory[Foo]):
     assert isinstance(foo.ext, msgspec.msgpack.Ext)
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason="flaky in 3.8")
 def test_with_constraints() -> None:
     class Foo(Struct):
         int_field: Annotated[int, msgspec.Meta(ge=10, le=500, multiple_of=2)]
@@ -150,7 +149,6 @@ class FooFactory(MsgspecFactory[Foo]):
     assert foo == validated_foo
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason="flaky in 3.8")
 def test_dict_constraints() -> None:
     class Foo(Struct):
         dict_field: Annotated[dict[str, int], msgspec.Meta(min_length=1)]
@@ -165,7 +163,6 @@ class FooFactory(MsgspecFactory[Foo]):
     assert foo == validated_foo
 
 
-@pytest.mark.skipif(sys.version_info < (3, 9), reason="flaky in 3.8")
 @pytest.mark.parametrize("t", (dt.datetime, dt.time))
 def test_datetime_constraints(t: type[dt.datetime] | type[dt.time]) -> None:
     class Foo(Struct):
diff --git a/tests/test_pydantic_factory.py b/tests/test_pydantic_factory.py
@@ -107,7 +107,6 @@ class AFactory(ModelFactory[A]):
     assert isinstance(AFactory.build().a, float)
 
 
-@pytest.mark.skipif(sys.version_info < (3, 10), reason="requires python3.9 or higher")
 def test_list_unions() -> None:
     # issue: https://github.com/litestar-org/polyfactory/issues/300, no error reproduced
     class A(BaseModel):
@@ -732,7 +731,6 @@ class A(BaseModel):
     assert AFactory.build()
 
 
-@pytest.mark.skipif(sys.version_info < (3, 10), reason="requires modern union types")
 @pytest.mark.skipif(IS_PYDANTIC_V1, reason="pydantic 2 only test")
 def test_optional_custom_type() -> None:
     from pydantic_core import core_schema
@@ -801,8 +799,9 @@ class A(BaseModel):
         e: Annotated[list[int], MinLen(10)] | Annotated[list[str], MaxLen(9)] | None
         f: Annotated[list[int], MinLen(10)] | list[str] | None
         g: None | (
-                Annotated[list[int], MinLen(10)] |
-                Annotated[list[str], MaxLen(9)] | Annotated[Decimal, Field(max_digits=4, decimal_places=2)]
+            Annotated[list[int], MinLen(10)]
+            | Annotated[list[str], MaxLen(9)]
+            | Annotated[Decimal, Field(max_digits=4, decimal_places=2)]
         )
 
     AFactory = ModelFactory.create_factory(A, __allow_none_optionals__=False)
@@ -817,13 +816,12 @@ class A(BaseModel):
         b: list[Annotated[str, MinLen(100)]] | int
         c: Annotated[list[int], MinLen(100)] | None
         d: Annotated[list[int], MinLen(100)] | Annotated[list[str], MaxLen(99)]
-        e: None | (
-            Annotated[list[Annotated[int, Gt(100), Lt(105)]], MinLen(10)] | Annotated[list[str], MaxLen(9)]
-        )
+        e: None | (Annotated[list[Annotated[int, Gt(100), Lt(105)]], MinLen(10)] | Annotated[list[str], MaxLen(9)])
         f: Annotated[list[int], MinLen(10)] | list[str] | None
         g: None | (
-                Annotated[list[int], MinLen(10)] |
-                Annotated[list[str], MaxLen(9)] | Annotated[Decimal, Field(max_digits=4, decimal_places=2)]
+            Annotated[list[int], MinLen(10)]
+            | Annotated[list[str], MaxLen(9)]
+            | Annotated[Decimal, Field(max_digits=4, decimal_places=2)]
         )
         # This annotation is not allowed in pydantic 1
         h: Annotated[list[int] | list[str], MinLen(10)]
@@ -1082,10 +1080,6 @@ class MyFactory(ModelFactory):
     assert result.my_str_dict_field
 
 
-@pytest.mark.skipif(
-    IS_PYDANTIC_V1 or sys.version_info < (3, 9),
-    reason="pydantic 2 only test, does not work correctly in py 3.8",
-)
 def test_nested_constrained_attribute_handling_pydantic_2() -> None:
     # subclassing the constrained fields is not documented by pydantic,
     # but is supported apparently
diff --git a/tests/test_random_configuration.py b/tests/test_random_configuration.py
@@ -1,14 +1,13 @@
 from dataclasses import dataclass
 from random import Random
-from typing import Union
 
 import pytest
 from faker import Faker
 from faker.config import AVAILABLE_LOCALES
 
 from polyfactory.factories.dataclass_factory import DataclassFactory
 
-FakerLocaleType = Union[str, list[str]]
+FakerLocaleType = str | list[str]
 
 RANDINT_MAP = {i: Random(i).randint(0, 10) for i in range(3)}
 FAKER_LOCALES: list[FakerLocaleType] = [
diff --git a/tests/test_recursive_models.py b/tests/test_recursive_models.py
@@ -108,7 +108,7 @@ class RecursiveTypeModel(BaseModel):
     assert _get_types(result.json_value for result in factory.coverage()) == valid_types
 
 
-RecursiveType = Union[list["RecursiveType"], int]
+RecursiveType = list["RecursiveType"] | int
 
 
 def test_recursive_model_with_forward_ref() -> None:
diff --git a/tests/utils/test_predicates.py b/tests/utils/test_predicates.py
@@ -1,4 +1,4 @@
-from typing import Literal, Union
+from typing import Literal
 
 import pytest
 
@@ -9,8 +9,8 @@
     "annotation,expected",
     [
         (Literal[1, 2, 3], True),
-        (Union[int, str], False),
-        (Union[Literal[1], Literal[2]], False),  # noqa: PYI030
+        (int | str, False),
+        (Literal[1] | Literal[2], False),  # noqa: PYI030
         (int, False),
     ],
 )
diff --git a/uv.lock b/uv.lock
