Sourced from cattrs's releases.
24.1.0
- 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 theprefer_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
andBaseConverter.get_unstructure_hook
methods. (#432 #472)BaseConverter.register_structure_hook
,BaseConverter.register_unstructure_hook
,BaseConverter.register_unstructure_hook_factory
andBaseConverter.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 ofabc.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
TypeVar
s 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
andNotRequired
in TypedDicts.
... (truncated)
Sourced from cattrs's changelog.
24.1.0 (2024-08-28)
- 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: {py:func}
cattrs.gen.make_dict_structure_fn
will use the value for theprefer_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 {meth}
BaseConverter.get_structure_hook
and {meth}BaseConverter.get_unstructure_hook
methods. (#432 #472)- {meth}
BaseConverter.register_structure_hook
, {meth}BaseConverter.register_unstructure_hook
, {meth}BaseConverter.register_unstructure_hook_factory
and {meth}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 {mod}
cattrs.cols
module for better collection customizations. (#504 #540)- Enhance the {func}
cattrs.cols.is_mapping
predicate function to also cover virtual subclasses ofabc.Mapping
. This enables map classes from libraries such as immutables or sortedcontainers to structure out-of-the-box. (#555 #556)- Introduce the msgspec {mod}
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
TypeVar
s 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 {class}
orjson preconf converter <cattrs.preconf.orjson.OrjsonConverter>
now passes through dates and datetimes to orjson while unstructuring, greatly improving speed. (#463)- {mod}
cattrs.gen
generators now attach metadata to the generated functions, making them introspectable. (#472)- Structure hook factories in {mod}
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)
... (truncated)
3cb6707
v24.1.087eefe6
fix: wrong return type (#569)5fd0f5b
Let's not stick in the past1d72dcc
Restructure readme/index/reasons (#562)c393abc
Merge pull request #565 from python-attrs/artifacts-v4ca6d0b6
Switch to (up|down)load-artifact@v4ea7595b
Merge pull request #564 from python-attrs/coverage-md9ec4b49
Don't measure branch coverage for now2a9ff8e
html too0ae37d6
Use config