What's Changed

• Fix the msgpack and cbor2 converters unstructuring naive datetimes as local time, which made the serialized value depend on the timezone of the machine doing the unstructuring; naive datetimes are now assumed to be UTC, matching what the structure hooks already read back. (#774 #775)
• Fix override(rename=...) targets containing a quote (or other characters not safe in a bare string literal) crashing code generation with SyntaxError; the rename key is now embedded with repr. (#771)
• Fix Counter keys not being unstructured with the key type's own hook; the single-type-arg branch passed the whole type-args tuple to the key hook lookup instead of the key type. (#768)
• Fix create_default_dis_func (aka create_uniq_field_dis_func) failing to disambiguate valid unions depending on the order of the member classes; unique fields are now resolved iteratively to a fixpoint. (#230 #765)
• Support more recursive types on 3.14+ with specialized factories for annotationlib.ForwardRef. (#740 #741)
• Converter now uses specialized hook factories to generate hooks for tuples, increasing speed. (#737)
• Fix an AttributeError in cattrs internals that could be triggered by using the include_subclasses strategy in a structure_hook_factory (#721, #722)
• Fix TypedDict codegen when keys contain single quotes. (#769)
• Add CattrsError exception type: all exceptions raised by cattrs inherit from this.
  Literal and date-time validation raise this directly, instead of Exception. (#728)
• Fix the detailed_validation parameter being passed under the wrong name in namedtuple_dict_structure_factory, causing it to be silently ignored. (#723)
• cattrs is now autoformatted using Ruff. (#732)
• Support running the test suite without cbor2 installed. (#748)
• The union passthrough strategy now supports PEP 695 type aliases as union members. (#753)
• BaseConverter.register_structure_hook_factory and BaseConverter.register_unstructure_hook_factory now properly return the factory when used as decorators. (#724)
• The msgspec preconf converter now properly handles recursive classes on Python 3.14+. (#757)

New Contributors

• @mm-andritz made their first contribution in #722
• @bysiber made their first contribution in #723
• @yzhkali made their first contribution in #753
• @maxtaran2010 made their first contribution in #766
• @vineethsaivs made their first contribution in #765
• @uttam12331 made their first contribution in #768
• @winklemad made their first contribution in #771
• @onk3sh made their first contribution in #775

Full Changelog: v26.1.0...v26.2.0

v26.1.0

• Add the tomllib preconf converter. See here for details. (#716)
• Customizing un/structuring of attrs classes, dataclasses, TypedDicts and dict NamedTuples is now possible by using Annotated[T, override()] on fields. See here for more details. (#717)
• Fix structuring of nested generic classes with stringified annotations. (#688)
• Python 3.9 is no longer supported, as it is end-of-life. Use previous versions on this Python version. (#698)
• Apply the attrs converter to the default value before checking if it is equal to the attribute's value, when omit_if_default is true and an attrs converter is specified. (#696)
• Use the optional _value_ type hint to structure and unstructure enums if present. (#699)
• Aliases (when in use) now properly generate rename metadata in generated hooks. (#706 #710)
• cattrs now tracks performance using codspeed. (#703)
• The tomlkit preconf converter now properly handles native date objects when structuring. (#707 #708)
• The tomlkit preconf converter now passes date objects directly to tomlkit for unstructuring. (#707 #708)
• Enum handling has been optimized by switching to hook factories, improving performance especially for plain enums. (#705)
• Fix cattrs.strategies.include_subclasses when used with cattrs.strategies.configure_tagged_union and classes using diamond inheritance. (#685 #713)
• Fix cattrs.strategies.configure_tagged_union when used with recursive type aliases. (#678 #714)

New Contributors

• @calebj made their first contribution in #688
• @antony-frolov made their first contribution in #696
• @reversefold made their first contribution in #702

Full Changelog: v25.3.0...v26.1.0

• Potentially breaking: Abstract sets are now structured into frozensets.
  This allows hashability, better immutability and is more consistent with the collections.abc.Set type.
  See Migrations for steps to restore legacy behavior. (#686)
• Python 3.14 is now supported and part of the test matrix. (#653)
• Fix unstructuring NewTypes with the {class}BaseConverter. (#684)
• Make some Hypothesis tests more robust. (#684)
• {func}cattrs.strategies.include_subclasses now works with generic parent classes and the tagged union strategy. (#683)

New Contributors

• @danarmak made their first contribution in #683

Full Changelog: v25.2.0...v25.3.0

• Potentially breaking: Sequences are now structured into tuples.
  This allows hashability, better immutability and is more consistent with the collections.abc.Sequence type. See Migrations for steps to restore legacy behavior. (#663)
• Add a use_alias parameter to cattrs.Converter.
  cattrs.gen.make_dict_unstructure_fn_from_attrs, cattrs.gen.make_dict_unstructure_fn,
  cattrs.gen.make_dict_structure_fn_from_attrs, cattrs.gen.make_dict_structure_fn
  and cattrs.gen.typeddicts.make_dict_structure_fn will use the value for the use_alias parameter 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 value directly. (#596 #660)
• The union passthrough strategy now by default accepts ints for unions that contain floats but not ints,
  when configured to be able to handle both ints and floats. This more closely matches the current typing behavior. (#656 #668)
• Fix unstructuring of generic classes with stringified annotations. (#661 #662)
• For cattrs.errors.StructureHandlerNotFoundError and cattrs.errors.ForbiddenExtraKeysError
  correctly set BaseException.args in super() and hence make them pickable. (#666)
• The default disambiguation hook factory is now only enabled for converters with unstructure_strat=AS_DICT (the default).
  Since the strategy doesn't support tuples, it is skipped for unstructure_strat=AS_TUPLE converters. (#673)
• Switch to uv and just in lieu of PDM, tox and Make. See the Contributing section for new workflow instructions. (#671)

New Contributors

• @hoodmane made their first contribution in #665
• @carltongibson made their first contribution in #677

Full Changelog: v25.1.1...v25.2.0

• Fixed AttributeError: no attribute '__parameters__' while structuring attrs classes that inherit from parametrized generic aliases from collections.abc.
  (#654 #655)

• Potentially breaking: The converters raise StructureHandlerNotFoundError more eagerly (on hook creation, instead of on hook use). This helps surfacing problems with missing hooks sooner. See Migrations for steps to restore legacy behavior.
  (#577)
• Add a Migrations page, with instructions on migrating changed behavior for each version.
  (#577)
• typing.Self is now supported in attrs classes, dataclasses, TypedDicts and the dict NamedTuple factories. See typing.Self for details.
  (#299 #627)
• PEP 695 type aliases can now be used with BaseConverter.register_structure_hook and BaseConverter.register_unstructure_hook. Previously, they required the use of BaseConverter.register_structure_hook_func (which is still supported).
  (#647)
• Expose cattrs.cols.mapping_unstructure_factory through cattrs.cols.
• Some defaultdicts are now supported by default, and
  cattrs.cols.is_defaultdict and cattrs.cols.defaultdict_structure_factory are exposed through cattrs.cols.
  (#519 #588)
• Generic PEP 695 type aliases are now supported.
  (#611 #618)
• The tagged union strategy now also supports type aliases of unions.
  (#649)
• Converter.copy and BaseConverter.copy are correctly annotated as returning Self.
  (#644)
• Many preconf converters (bson, stdlib JSON, cbor2, msgpack, msgspec, orjson, ujson) skip unstructuring int and str enums, leaving them to the underlying libraries to handle with greater efficiency.
  (#598)
• The msgspec JSON preconf converter now handles dataclasses with private attributes more efficiently.
  (#624)
• Literals containing enums are now unstructured properly, and their unstructuring is greatly optimized in the bson, stdlib JSON, cbor2, msgpack, msgspec, orjson and ujson preconf converters.
  (#598)
• Preconf converters now handle dictionaries with literal keys properly.
  (#599)
• Structuring TypedDicts from invalid inputs now properly raises a ClassValidationError.
  (#615 #616)
• cattrs.strategies.include_subclasses now properly works with generic parent classes.
  (#649)
• Replace cattrs.gen.MappingStructureFn with cattrs.SimpleStructureHook.
• Python 3.13 is now supported.
  (#543 #547)
• Python 3.8 is no longer supported, as it is end-of-life. Use previous versions on this Python version.
  (#591)
• Change type of Converter.__init__.unstruct_collection_overrides from Callable to Mapping[type, UnstructureHook]
  (#594).
• Adopt the Contributor Covenant Code of Conduct (just like attrs).

• Fix structuring of keyword-only dataclass fields when not using detailed validation.
  (#637 #638)

• Fix BaseConverter.register_structure_hook and BaseConverter.register_unstructure_hook type hints.
  (#581 #582)

24.1.1 (2024-09-11)

• Fix BaseConverter.register_structure_hook_factory and BaseConverter.register_unstructure_hook_factory type hints. (#578 #579)

• Potentially breaking: Unstructuring hooks for typing.Any are consistent now: values are unstructured using their runtime type. Previously this behavior was underspecified and inconsistent, but followed this rule in the majority of cases. Reverting old behavior is very dependent on the actual case; ask on the issue tracker if in doubt. (#473)
• Minor change: Heterogeneous tuples are now unstructured into tuples instead of lists by default; this is significantly faster and widely supported by serialization libraries. (#486)
• Minor change: cattrs.gen.make_dict_structure_fn will use the value for the prefer_attrib_converters parameter from the given converter by default now. If you're using this function directly, the old behavior can be restored by passing in the desired values explicitly. (#527 #528)
• Introduce BaseConverter.get_structure_hook and BaseConverter.get_unstructure_hook methods. (#432 #472)
• BaseConverter.register_structure_hook, BaseConverter.register_unstructure_hook, BaseConverter.register_unstructure_hook_factory and BaseConverter.register_structure_hook_factory can now be used as decorators and have gained new features. See here and here for more details. (#487)
• Introduce and document the cattrs.cols module for better collection customizations. (#504 #540)
• Enhance the cattrs.cols.is_mapping predicate function to also cover virtual subclasses of abc.Mapping. This enables map classes from libraries such as immutables or sortedcontainers to structure out-of-the-box. (#555 #556)
• Introduce the msgspec preconf converter <cattrs.preconf.msgspec>. Only JSON is supported for now, with other formats supported by msgspec to come later. (#481)
• The default union handler now properly takes renamed fields into account. (#472)
• The default union handler now also handles dataclasses. (#426 #477)
• Add support for PEP 695 type aliases. (#452)
• Add support for PEP 696 TypeVars with defaults. (#512)
• Add support for named tuples with type metadata (typing.NamedTuple). (#425 #491)
• Add support for optionally un/unstructuring named tuples using dictionaries. (#425 #549)
• The include_subclasses strategy now fetches the member hooks from the converter (making use of converter defaults) if overrides are not provided, instead of generating new hooks with no overrides. (#429 #472)
• The preconf make_converter factories are now correctly typed. (#481)
• The orjson preconf converter now passes through dates and datetimes to orjson while unstructuring, greatly improving speed. (#463)
• cattrs.gen generators now attach metadata to the generated functions, making them introspectable. (#472)
• Structure hook factories in cattrs.gen now handle recursive classes better. (#540)
• The tagged union strategy now leaves the tags in the payload unless forbid_extra_keys is set. (#533 #534)
• More robust support for Annotated and NotRequired in TypedDicts. (#450)
• typing_extensions.Literal is now automatically structured, just like typing.Literal. (#460 #467)
• typing_extensions.Any is now supported and handled like typing.Any. (#488 #490)
• Optional types can now be consistently customized using register_structure_hook and register_unstructure_hook. (#529 #530)
• The BaseConverter now properly generates detailed validation errors for mappings. (#496)
• PEP 695 generics are now tested. (#452)
• Imports are now sorted using Ruff.
• Tests are run with the pytest-xdist plugin by default.
• Rework the introductory parts of the documentation, introducing the Basics section. (#472)
• The documentation has been significantly reworked. (#473)
• The docs now use the Inter font.
• Make type annotations for include_subclasses and tagged_union strategies more lenient. (#431)

• Fix a regression when unstructuring dictionary values typed as Any.
  (#453 #462)
• Fix a regression when unstructuring unspecialized generic classes.
  (#465 #466)
• Optimize function source code caching.
  (#445 #464)
• Generate unique files only in case of linecache enabled.
  (#445 #441)

• Fix a regression when unstructuring Any | None. (#453)

23.2.1 (2023-11-18)

• Fix unnecessary typing_extensions import on Python 3.11. (#446 #447)

For the v23.2.0 release notes, see here.

23.2.0 (2023-11-17)

Welcome to cattrs 23.2.0! Thanks to all our wonderful contributors, this release happens to have the largest changelog so far.

Here are some of the noteworthy additions, see below for the entire changelog.

More Powerful Unions in preconf

Courtesy of the union passthrough strategy, the following class (and others like it, this is just a complex example) will work out-of-the-box on any preconf converter:

@define
class MyClass:
    my_field: str | Literal[1] | MyOtherClass

The strategy has been preapplied to all preconf converters, but it can be manually applied to any converter.

Default Disambiguation via Literals

When structuring a union of attrs classes, cattrs will default to the default union strategy.

This strategy works by finding required unique fields in the given classes. It has been enhanced with support for matching on fields annotated as Literals.

from typing import Literal

@define
class ClassA:
    field_one: Literal["one"]

@define
class ClassB:
    field_one: Literal["two"] = "two"

Un/structuring Hooks on Classes

cattrs defaults to having un/structuring hooks separate from the models. With the use class methods strategy, you are free to defy this design decision and configure a converter to look for hooks on the models themselves.

The Complete Changelog

• Potentially breaking: skip attrs fields marked as init=False by default. This change is potentially breaking for unstructuring. See here for instructions on how to restore the old behavior. (#40 #395)
• Potentially breaking: cattrs.gen.make_dict_structure_fn and 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 #411)
• Potentially breaking: The default union structuring strategy will also use fields annotated as typing.Literal to help guide structuring. See here for instructions on how to restore the old behavior. (#391)
• Python 3.12 is now supported. Python 3.7 is no longer supported; use older releases there. (#424)
• Implement the union passthrough strategy, enabling much richer union handling for preconfigured converters. Learn more here.
• Introduce the use_class_methods strategy. Learn more here. (#405)
• The omit parameter of cattrs.override is now of type bool | None (from bool). None is the new default and means to apply default cattrs handling to the attribute, which is to omit the attribute if it's marked as init=False, and keep it otherwise.
• Converters can now be initialized with custom fallback hook factories for un/structuring. (#331 #441)
• Add support for date to preconfigured converters. (#420)
• Add support for datetime.dates to the PyYAML preconfigured converter. (#393)
• Fix format_exception() parameter working for recursive calls to transform_error(). (#389)
• attrs aliases are now supported, although aliased fields still map to their attribute name instead of their alias by default when un/structuring. (#322 #391)
• Fix TypedDicts with periods in their field names. (#376 #377)
• Optimize and improve unstructuring of Optional (unions of one type and None). (#380 #381)
• Fix format_exception and transform_error type annotations.
• Improve the implementation of cattrs._compat.is_typeddict. The implementation is now simpler, and relies on fewer private implementation details from typing and typing_extensions. (#384)
• Improve handling of TypedDicts with forward references.
• Speed up generated attrs and TypedDict structuring functions by changing their signature slightly. (#388)
• Fix copying of converters with function hooks. (#398 #399)
• Broaden cattrs.preconf.orjson.OrjsonConverter.loads type definition for the preconf orjson converter. (#400)
• AttributeValidationNote and IterableValidationNote are now picklable. (#408)
• Fix structuring Final lists. (#412)
• Fix certain cases of structuring Annotated types. (#418)
• Fix the tagged union strategy to work with forbid_extra_keys. (#402 #443)
• Use PDM instead of Poetry.
• cattrs is now linted with Ruff.
• Remove some unused lines in the unstructuring code. (#416)
• Fix handling classes inheriting from non-generic protocols. (#374 #436)
• The documentation Makefile now supports the htmlview and htmllive targets. (#442)
• cattrs is now published using PyPI Trusted Publishers, and main branch commits are automatically deployed to Test PyPI.

• Improve typing_extensions version bound. (#372)

• Add typing_extensions as a direct dependency on 3.10. (#369 #370)

• Introduce the tagged_union strategy. (#318 #317)
• Introduce the cattrs.transform_error helper function for formatting validation exceptions. (258 342)
• Add support for typing.TypedDict and typing_extensions.TypedDict. (#296 #364)
• Add support for typing.Final. (#340 #349)
• Introduce override.struct_hook and override.unstruct_hook. Learn more here. (#326)
• Fix generating structuring functions for types with angle brackets (<>) and pipe symbols (|) in the name. (#319 #327)
• pathlib.Path is now supported by default. (#81)
• Add cbor2 serialization library to the cattrs.preconf package.
• Add optional dependencies for cattrs.preconf third-party libraries. (#337)
• All preconf converters now allow overriding the default unstruct_collection_overrides in make_converter. (#350 #353)
• Subclasses structuring and unstructuring is now supported via a custom include_subclasses strategy. (#312)
• Add support for typing_extensions.Annotated when the python version is less than 3.9. (#366)
• Add unstructuring and structuring support for the standard library deque. (#355)

• Potentially breaking: cattrs.Converter has been renamed to cattrs.BaseConverter, and cattrs.GenConverter to cattrs.Converter. The GenConverter name is still available for backwards compatibility, but is deprecated. If you were depending on functionality specific to the old Converter, change your import to from cattrs import BaseConverter.
• NewTypes are now supported by the cattrs.Converter. (#255 #94 #297)
• cattrs.Converter and cattrs.BaseConverter can now copy themselves using the copy method. (#284)
• Python 3.11 support.
• cattrs now supports un/structuring kw_only fields on attrs classes into/from dictionaries. (#247)
• PyPy support (and tests, using a minimal Hypothesis profile) restored. (#253)
• Fix propagating the detailed_validation flag to mapping and counter structuring generators.
• Fix typing.Set applying too broadly when used with the GenConverter.unstruct_collection_overrides parameter on Python versions below 3.9. Switch to typing.AbstractSet on those versions to restore the old behavior. (#264)
• Uncap the required Python version, to avoid problems detailed here (#275)
• Fix Converter.register_structure_hook_factory and cattrs.gen.make_dict_unstructure_fn type annotations. (#281)
• Expose all error classes in the cattr.errors namespace. Note that it is deprecated, just use cattrs.errors. (#252)
• Fix generating structuring functions for types with quotes in the name. (#291 #277)
• Fix usage of notes for the final version of PEP 678, supported since exceptiongroup>=1.0.0rc4. (#303)

• cattrs now uses the CalVer versioning convention.
• cattrs now has a detailed validation mode, which is enabled by default. Learn more here. The old behavior can be restored by creating the converter with detailed_validation=False.
• attrs and dataclass structuring is now ~25% faster.
• Fix an issue structuring bare typing.List s on Pythons lower than 3.9. (#209)
• Fix structuring of non-parametrized containers like list/dict/... on Pythons lower than 3.9. (#218)
• Fix structuring bare typing.Tuple on Pythons lower than 3.9. (#218)
• Fix a wrong AttributeError of an missing __parameters__ attribute. This could happen when inheriting certain generic classes – for example typing.* classes are affected. (#217)
• Fix structuring of enum.Enum instances in typing.Literal types. (#231)
• Fix unstructuring all tuples - unannotated, variable-length, homogenous and heterogenous - to list. (#226)
• For forbid_extra_keys raise custom ForbiddenExtraKeyError instead of generic Exception. (#225)
• All preconf converters now support loads and dumps directly. See an example here.
• Fix mappings with byte keys for the orjson, bson and tomlkit converters. (#241)

In this release, _cattrs_ introduces the {mod}`cattrs` package as the main entry point into the library, replacing the `cattr` package.

The `cattr` package is never going away, nor is it technically deprecated.
New functionality will be added only to the `cattrs` package, but there is no need to replace your current imports.

This change mirrors [a similar change in _attrs_](https://www.attrs.org/en/stable/names.html).

• Add PEP 563 (string annotations) support for dataclasses. (#195)
• Fix handling of dictionaries with string Enum keys for bson, orjson, and tomlkit.
• Rename the {func}cattrs.gen.make_dict_unstructure_fn omit_if_default parameter to _cattrs_omit_if_default, for consistency. The omit_if_default parameters to {class}GenConverter and {func}override are unchanged.
• Following the changes in attrs 21.3.0, add a {mod}cattrs package mirroring the existing cattr package. Both package names may be used as desired, and the cattr package isn't going away.

• Python 3.10 support, including support for the new union syntax (A | B vs Union[A, B]).
• The GenConverter can now properly structure generic classes with generic collection fields. (#149)
• omit=True now also affects generated structuring functions. (#166)
• cattr.gen.{make_dict_structure_fn, make_dict_unstructure_fn} now resolve type annotations automatically when PEP 563 is used. (#169)
• Protocols are now unstructured as their runtime types. (#177)
• Fix an issue generating structuring functions with renaming and _cattrs_forbid_extra_keys=True. (#190)

• Fix GenConverter mapping structuring for unannotated dicts on Python 3.8. (#151)
• The source code for generated un/structuring functions is stored in the linecache cache, which enables more informative stack traces when un/structuring errors happen using the GenConverter. This behavior can optionally be disabled to save memory.
• Support using the attr converter callback during structure. By default, this is a method of last resort, but it can be elevated to the default by setting prefer_attrib_converters=True on Converter or GenConverter. (#138)
• Fix structuring recursive classes. (#159)
• Converters now support un/structuring hook factories. This is the most powerful and complex venue for customizing un/structuring. This had previously been an internal feature.
• The Common Usage Examples documentation page now has a section on advanced hook factory usage.
• cattr.override now supports the omit parameter, which makes cattrs skip the atribute entirely when unstructuring.
• The cattr.preconf.bson module is now tested against the bson module bundled with the pymongo package, because that package is much more popular than the standalone PyPI bson package.

• Literal s are not supported on Python 3.9.0 (supported on 3.9.1 and later), so we skip importing them there. (#150)

• cattr.global_converter (which provides cattr.unstructure, cattr.structure etc.) is now an instance of cattr.GenConverter.
• Literal s are now supported and validated when structuring.
• Fix dependency metadata information for attrs. (#147)
• Fix GenConverter mapping structuring for unannotated dicts. (#148)

• cattrs now uses Poetry.
• GenConverter mapping structuring is now ~25% faster, and unstructuring heterogenous tuples is significantly faster.
• Add cattr.preconf. This package contains modules for making converters for particular serialization libraries. We currently support the standard library json, and third-party ujson, orjson, msgpack, bson, pyyaml and tomlkit libraries.

• Fix an issue with GenConverter unstructuring attrs classes and dataclasses with generic fields. (#65)
• GenConverter has support for easy overriding of collection unstructuring types (for example, unstructure all sets to lists) through its unstruct_collection_overrides argument. (#137)
• Unstructuring mappings with GenConverter is significantly faster.
• GenConverter supports strict handling of unexpected dictionary keys through its forbid_extra_keys argument. (#142)

• Fix an issue with GenConverter un/structuring hooks when a function hook is registered after the converter has already been used.
• Add support for collections.abc.{Sequence, MutableSequence, Set, MutableSet}. These should be used on 3.9+ instead of their typing alternatives, which are deprecated. (#128)
• The GenConverter will unstructure iterables (list[T], tuple[T, ...], set[T]) using their type argument instead of the runtime class if its elements, if possible. These unstructuring operations are up to 40% faster. (#129)
• Flesh out Converter and GenConverter initializer type annotations. (#131)
• Add support for typing.Annotated on Python 3.9+. cattrs will use the first annotation present. cattrs specific annotations may be added in the future. (#127)
• Add support for dataclasses. (#43)

• cattrs now has a benchmark suite to help make and keep cattrs the fastest it can be. The instructions on using it can be found under the Benchmarking section in the docs. (#123)
• Fix an issue unstructuring tuples of non-primitives. (#125)
• cattrs now calls attr.resolve_types on attrs classes when registering un/structuring hooks.
• GenConverter structuring and unstructuring of attrs classes is significantly faster.

• converter.unstructure now supports an optional parameter, unstructure_as, which can be used to unstructure something as a different type. Useful for unions.
• Improve support for union un/structuring hooks. Flesh out docs for advanced union handling. (#115)
• Fix GenConverter behavior with inheritance hierarchies of attrs classes. ([#117](https://github.com/python-attrs/cattrs/pull/117 #116)
• Refactor GenConverter.un/structure_attrs_fromdict into GenConverter.gen_un/structure_attrs_fromdict to allow calling back to Converter.un/structure_attrs_fromdict without sideeffects. (#118)

• The default disambiguator will not consider non-required fields any more. (#108)
• Fix a couple type annotations. (#107 #105)
• Fix a GenConverter unstructuring issue and tests.

• Add metadata for supported Python versions. (#103)

• Python 2, 3.5 and 3.6 support removal. If you need it, use a version below 1.1.0.
• Python 3.9 support, including support for built-in generic types (list[int] vs typing.List[int]).
• cattrs now includes functions to generate specialized structuring and unstructuring hooks. Specialized hooks are faster and support overrides (omit_if_default and rename). See the cattr.gen module.
• cattrs now includes a converter variant, cattr.GenConverter, that automatically generates specialized hooks for attrs classes. This converter will become the default in the future.
• Generating specialized structuring hooks now invokes attr.resolve_types on a class if the class makes use of the new PEP 563 annotations.
• cattrs now depends on attrs >= 20.1.0, because of attr.resolve_types.
• Specialized hooks now support generic classes. The default converter will generate and use a specialized hook upon encountering a generic class.

• attrs classes with private attributes can now be structured by default.
• Structuring from dictionaries is now more lenient: extra keys are ignored.
• cattrs has improved type annotations for use with Mypy.
• Unstructuring sets and frozensets now works properly.

• Python 3.7 support.

• The disambiguation function generator now supports unions of attrs classes and NoneType.

• Distribution fix.

• Removed the undocumented Converter.unstruct_strat property setter.
• Removed the ability to set the Converter.structure_attrs instance field.
• Some micro-optimizations were applied; a structure(unstructure(obj)) roundtrip is now up to 2 times faster.

• Packaging fixes. (#17)

• structure/unstructure now supports using functions as well as classes for deciding the appropriate function.
• added Converter.register_structure_hook_func, to register a function instead of a class for determining handler func.
• added Converter.register_unstructure_hook_func, to register a function instead of a class for determining handler func.
• vendored typing is no longer needed, nor provided.
• Attributes with default values can now be structured if they are missing in the input. (#15)
• Optional attributes can no longer be structured if they are missing in the input.
• cattr.typed removed since the functionality is now present in attrs itself. Replace instances of cattr.typed(type) with attr.ib(type=type).