# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-cattrs
VERSION=		24.1.1
KEYWORDS=		python
VARIANTS=		v11 v12
SDESC[v11]=		Composable complex class support for attrs (3.11)
SDESC[v12]=		Composable complex class support for attrs (3.12)
HOMEPAGE=		https://catt.rs
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/ca/a1/90fa8e601c28937a8426eaae853e0009807e6287c7bf03fe7af4296ec510
DISTFILE[1]=		cattrs-24.1.1-py3-none-any.whl:main
DF_INDEX=		1
SPKGS[v11]=		single
SPKGS[v12]=		single

OPTIONS_AVAILABLE=	PY311 PY312
OPTIONS_STANDARD=	none
VOPTS[v11]=		PY311=ON PY312=OFF
VOPTS[v12]=		PY311=OFF PY312=ON

DISTNAME=		cattrs-24.1.1.dist-info

GENERATED=		yes

[PY311].RUN_DEPENDS_ON=			python-attrs:single:v11
[PY311].USES_ON=			python:v11,wheel

[PY312].RUN_DEPENDS_ON=			python-attrs:single:v12
[PY312].USES_ON=			python:v12,wheel

[FILE:3253:descriptions/desc.single]
# *cattrs*: Flexible Object Serialization and Validation

*Because validation belongs to the edges.*

[Documentation]
[![License: MIT]](https://github.com/hynek/stamina/blob/main/LICENSE)
[PyPI]
[Supported Python Versions]
[Downloads]
[Coverage]

---

<!-- begin-teaser -->

**cattrs** is a Swiss Army knife for (un)structuring and validating data in
Python.
In practice, that means it converts **unstructured dictionaries** into
**proper classes** and back, while **validating** their contents.

<!-- end-teaser -->

## Example

<!-- begin-example -->

_cattrs_ works best with [_attrs_] classes, and [dataclasses] where simple
(un-)structuring works out of the box, even for nested data, without
polluting your data model with serialization details:

```python
>>> from attrs import define
>>> from cattrs import structure, unstructure
>>> @define
... class C:
...     a: int
...     b: list[str]
>>> instance = structure({'a': 1, 'b': ['x', 'y']}, C)
>>> instance
C(a=1, b=['x', 'y'])
>>> unstructure(instance)
{'a': 1, 'b': ['x', 'y']}
```

<!-- end-teaser -->
<!-- end-example -->

Have a look at [*Why *cattrs*?*] for more examples!

<!-- begin-why -->

## Features

### Recursive Unstructuring

- _attrs_ classes and dataclasses are converted into dictionaries in a way
similar to `attrs.asdict()`, or into tuples in a way similar to
`attrs.astuple()`.
- Enumeration instances are converted to their values.
- Other types are let through without conversion. This includes types such
as integers, dictionaries, lists and instances of non-_attrs_ classes.
- Custom converters for any type can be registered using
`register_unstructure_hook`.

### Recursive Structuring

Converts unstructured data into structured data, recursively, according to
your specification given as a type.
The following types are supported:

- `typing.Optional[T]` and its 3.10+ form, `T | None`.
- `list[T]`, `typing.List[T]`, `typing.MutableSequence[T]`,
`typing.Sequence[T]` convert to a lists.
- `tuple` and `typing.Tuple` (both variants, `tuple[T, ...]` and `tuple[X,
Y, Z]`).
- `set[T]`, `typing.MutableSet[T]`, and `typing.Set[T]` convert to a sets.
- `frozenset[T]`, and `typing.FrozenSet[T]` convert to a frozensets.
- `dict[K, V]`, `typing.Dict[K, V]`, `typing.MutableMapping[K, V]`, and
`typing.Mapping[K, V]` convert to a dictionaries.
- [`typing.TypedDict`], ordinary and generic.
- [`typing.NewType`]
- [PEP 695 type aliases] on 3.12+
- _attrs_ classes with simple attributes and the usual `__init__`[^simple].
- All _attrs_ classes and dataclasses with the usual `__init__`, if their
complex attributes have type metadata.
- Unions of supported _attrs_ classes, given that all of the classes have a
unique field.
- Unions of anything, if you provide a disambiguation function for it.
- Custom converters for any type can be registered using
`register_structure_hook`.

[^simple]: Simple attributes are attributes that can be assigned
unstructured data, like numbers, strings, and collections of unstructured
data.

### Batteries Included

_cattrs_ comes with pre-configured converters for a number of serialization
libraries, including JSON (standard library, [_orjson_], [UltraJSON]),
[_msgpack_], [_cbor2_], [_bson_], [PyYAML], [_tomlkit_] and [_msgspec_]


[FILE:109:distinfo]
ec8ce8fdc725de9d07547cd616f968670687c6fa7a2e263b088370c46d834d97        66417 cattrs-24.1.1-py3-none-any.whl