Provisionally enable 3.12 (#424)

* Provisionally enable 3.12

* Maybe fix?

* Remove 3.7

* Update history

Author: Tinche

.github/workflows/main.yml

@@ -15,7 +15,7 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "pypy-3.8"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "pypy-3.8"]
       fail-fast: false
 
     steps:
@@ -24,6 +24,7 @@ jobs:
       - uses: "actions/setup-python@v4"
         with:
           python-version: "${{ matrix.python-version }}"
+          allow-prereleases: true
 
       - name: "Run Tox"
         run: |

HISTORY.md

@@ -8,6 +8,8 @@
 - **Potentially breaking**: {py:func}`cattrs.gen.make_dict_structure_fn` and {py:func}`cattrs.gen.typeddicts.make_dict_structure_fn` will use the values for the `detailed_validation` and `forbid_extra_keys` parameters from the given converter by default now.
   If you're using these functions directly, the old behavior can be restored by passing in the desired values directly.
   ([#410](https://github.com/python-attrs/cattrs/issues/410) [#411](https://github.com/python-attrs/cattrs/pull/411))
+- Python 3.12 is now supported. Python 3.7 is no longer supported; use older releases there.
+  ([#424](https://github.com/python-attrs/cattrs/pull/424))
 - Introduce the `use_class_methods` strategy. Learn more [here](https://catt.rs/en/latest/strategies.html#using-class-specific-structure-and-unstructure-methods).
   ([#405](https://github.com/python-attrs/cattrs/pull/405))
 - Implement the `union passthrough` strategy, enabling much richer union handling for preconfigured converters. [Learn more here](https://catt.rs/en/stable/strategies.html#union-passthrough).

README.md

@@ -108,7 +108,7 @@ destructure them.
 
 - Free software: MIT license
 - Documentation: https://catt.rs
-- Python versions supported: 3.7 and up. (Older Python versions, like 2.7, 3.5 and 3.6 are supported by older versions; see the changelog.)
+- Python versions supported: 3.8 and up. (Older Python versions are supported by older versions; see the changelog.)
 
 ## Features
 

docs/structuring.md

@@ -260,7 +260,6 @@ Generic TypedDicts work on Python 3.11 and later, since that is the first Python
 
 [`typing.Required` and `typing.NotRequired`](https://peps.python.org/pep-0655/) are supported.
 
-On Python 3.7, using `typing_extensions.TypedDict` is required since `typing.TypedDict` doesn't exist there.
 On Python 3.8, using `typing_extensions.TypedDict` is recommended since `typing.TypedDict` doesn't support all necessary features, so certain combinations of subclassing, totality and `typing.Required` won't work.
 
 [Similar to _attrs_ classes](customizing.md#using-cattrsgen-generators), structuring can be customized using {meth}`cattrs.gen.typeddicts.make_dict_structure_fn`.

docs/unstructuring.md

@@ -52,7 +52,6 @@ False
 
 Generic TypedDicts work on Python 3.11 and later, since that is the first Python version that supports them in general.
 
-On Python 3.7, using `typing_extensions.TypedDict` is required since `typing.TypedDict` doesn't exist there.
 On Python 3.8, using `typing_extensions.TypedDict` is recommended since `typing.TypedDict` doesn't support all necessary features, so certain combinations of subclassing, totality and `typing.Required` won't work.
 
 [Similar to _attrs_ classes](customizing.md#using-cattrsgen-generators), unstructuring can be customized using {meth}`cattrs.gen.typeddicts.make_dict_unstructure_fn`.

pdm.lock

@@ -19,7 +19,7 @@ test = [
     "hypothesis>=6.79.4",
     "pytest>=7.4.0",
     "pytest-benchmark>=4.0.0",
-    "immutables>=0.19",
+    "immutables>=0.20",
     "typing-extensions>=4.7.1",
     "coverage>=7.2.7",
 ]
@@ -53,10 +53,23 @@ dependencies = [
     "typing-extensions>=4.1.0, !=4.6.3; python_version < '3.11'",
     "exceptiongroup>=1.1.1; python_version < '3.11'",
 ]
-requires-python = ">=3.7"
+requires-python = ">=3.8"
 readme = "README.md"
 license = {text = "MIT"}
 keywords = ["attrs", "serialization", "dataclasses"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "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",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Typing :: Typed",
+]
 
 [project.urls]
 Homepage = "https://catt.rs"

pyproject.toml

@@ -6,19 +6,19 @@
 from dataclasses import fields as dataclass_fields
 from dataclasses import is_dataclass
 from typing import AbstractSet as TypingAbstractSet
-from typing import Any, Deque, Dict, FrozenSet, List
+from typing import Any, Deque, Dict, Final, FrozenSet, List
 from typing import Mapping as TypingMapping
 from typing import MutableMapping as TypingMutableMapping
 from typing import MutableSequence as TypingMutableSequence
 from typing import MutableSet as TypingMutableSet
-from typing import NewType, Optional
+from typing import NewType, Optional, Protocol
 from typing import Sequence as TypingSequence
 from typing import Set as TypingSet
-from typing import Tuple, get_type_hints
+from typing import Tuple, get_args, get_origin, get_type_hints
 
-from attr import NOTHING, Attribute, Factory
-from attr import fields as attrs_fields
-from attr import resolve_types
+from attrs import NOTHING, Attribute, Factory
+from attrs import fields as attrs_fields
+from attrs import resolve_types
 
 __all__ = ["ExceptionGroup", "ExtensionsTypedDict", "TypedDict", "is_typeddict"]
 
@@ -27,18 +27,6 @@
 except ImportError:
     ExtensionsTypedDict = None
 
-if sys.version_info >= (3, 8):
-    from typing import Final, Protocol, get_args, get_origin
-
-else:
-
-    def get_args(cl):
-        return cl.__args__
-
-    def get_origin(cl):
-        return getattr(cl, "__origin__", None)
-
-    from typing_extensions import Final, Protocol
 
 if sys.version_info >= (3, 11):
     from builtins import ExceptionGroup
@@ -355,16 +343,11 @@ def get_full_type_hints(obj, globalns=None, localns=None):
     TupleSubscriptable = Tuple
 
     from collections import Counter as ColCounter
-    from typing import Counter, Union, _GenericAlias
+    from typing import Counter, TypedDict, Union, _GenericAlias
 
     from typing_extensions import Annotated, NotRequired, Required
     from typing_extensions import get_origin as te_get_origin
 
-    if sys.version_info >= (3, 8):
-        from typing import TypedDict
-    else:
-        TypedDict = ExtensionsTypedDict
-
     def is_annotated(type) -> bool:
         return te_get_origin(type) is Annotated
 
@@ -440,16 +423,10 @@ def is_counter(type):
             or getattr(type, "__origin__", None) is ColCounter
         )
 
-    if sys.version_info >= (3, 8):
-        from typing import Literal
-
-        def is_literal(type) -> bool:
-            return type.__class__ is _GenericAlias and type.__origin__ is Literal
+    from typing import Literal
 
-    else:
-        # No literals in 3.7.
-        def is_literal(_) -> bool:
-            return False
+    def is_literal(type) -> bool:
+        return type.__class__ is _GenericAlias and type.__origin__ is Literal
 
     def is_generic(obj):
         return isinstance(obj, _GenericAlias)

src/cattrs/_compat.py

@@ -819,7 +819,7 @@ def __init__(
         if OriginAbstractSet in co:
             if OriginMutableSet not in co:
                 co[OriginMutableSet] = co[OriginAbstractSet]
-                co[AbcMutableSet] = co[OriginAbstractSet]  # For 3.7/3.8 compatibility.
+                co[AbcMutableSet] = co[OriginAbstractSet]  # For 3.8 compatibility.
             if FrozenSetSubscriptable not in co:
                 co[FrozenSetSubscriptable] = co[OriginAbstractSet]
 
@@ -828,7 +828,7 @@ def __init__(
             co[set] = co[OriginMutableSet]
 
         if FrozenSetSubscriptable in co:
-            co[frozenset] = co[FrozenSetSubscriptable]  # For 3.7/3.8 compatibility.
+            co[frozenset] = co[FrozenSetSubscriptable]  # For 3.8 compatibility.
 
         # abc.Sequence overrides, if defined, can apply to MutableSequences, lists and
         # tuples

src/cattrs/converters.py

@@ -41,7 +41,7 @@ def format_exception(exc: BaseException, type: Union[type, None]) -> str:
             res = f"invalid value for type, expected {tn}"
     elif isinstance(exc, ForbiddenExtraKeysError):
         res = f"extra fields found ({', '.join(exc.extra_fields)})"
-    elif isinstance(exc, AttributeError) and exc.args[0].endswith(  # noqa: SIM114
+    elif isinstance(exc, AttributeError) and exc.args[0].endswith(
         "object has no attribute 'items'"
     ):
         # This was supposed to be a mapping (and have .items()) but it something else.