cattrs.preconf package#
Submodules#
cattrs.preconf.bson module#
cattrs.preconf.cbor2 module#
cattrs.preconf.json module#
Preconfigured converters for the stdlib json.
- class cattrs.preconf.json.JsonConverter(dict_factory=<class 'dict'>, unstruct_strat=UnstructureStrategy.AS_DICT, omit_if_default=False, forbid_extra_keys=False, type_overrides={}, unstruct_collection_overrides={}, prefer_attrib_converters=False, detailed_validation=True)[source]#
Bases:
Converter
- Parameters
dict_factory (Callable[[], Any]) –
unstruct_strat (UnstructureStrategy) –
omit_if_default (bool) –
forbid_extra_keys (bool) –
type_overrides (Mapping[Type, AttributeOverride]) –
unstruct_collection_overrides (Mapping[Type, Callable]) –
prefer_attrib_converters (bool) –
detailed_validation (bool) –
- forbid_extra_keys#
- loads(data, cl, **kwargs)[source]#
- Parameters
data (Union[bytes, str]) –
cl (Type[T]) –
- Return type
T
- omit_if_default#
- type_overrides#
- cattrs.preconf.json.configure_converter(converter)[source]#
Configure the converter for use with the stdlib json module.
bytes are serialized as base64 strings
datetimes are serialized as ISO 8601
counters are serialized as dicts
sets are serialized as lists
- Parameters
converter (BaseConverter) –
cattrs.preconf.msgpack module#
Preconfigured converters for msgpack.
- class cattrs.preconf.msgpack.MsgpackConverter(dict_factory=<class 'dict'>, unstruct_strat=UnstructureStrategy.AS_DICT, omit_if_default=False, forbid_extra_keys=False, type_overrides={}, unstruct_collection_overrides={}, prefer_attrib_converters=False, detailed_validation=True)[source]#
Bases:
Converter
- Parameters
dict_factory (Callable[[], Any]) –
unstruct_strat (UnstructureStrategy) –
omit_if_default (bool) –
forbid_extra_keys (bool) –
type_overrides (Mapping[Type, AttributeOverride]) –
unstruct_collection_overrides (Mapping[Type, Callable]) –
prefer_attrib_converters (bool) –
detailed_validation (bool) –
- forbid_extra_keys#
- omit_if_default#
- type_overrides#
- cattrs.preconf.msgpack.configure_converter(converter)[source]#
Configure the converter for use with the msgpack library.
datetimes are serialized as timestamp floats
sets are serialized as lists
- Parameters
converter (BaseConverter) –
cattrs.preconf.orjson module#
cattrs.preconf.pyyaml module#
Preconfigured converters for pyyaml.
- class cattrs.preconf.pyyaml.PyyamlConverter(dict_factory=<class 'dict'>, unstruct_strat=UnstructureStrategy.AS_DICT, omit_if_default=False, forbid_extra_keys=False, type_overrides={}, unstruct_collection_overrides={}, prefer_attrib_converters=False, detailed_validation=True)[source]#
Bases:
Converter
- Parameters
dict_factory (Callable[[], Any]) –
unstruct_strat (UnstructureStrategy) –
omit_if_default (bool) –
forbid_extra_keys (bool) –
type_overrides (Mapping[Type, AttributeOverride]) –
unstruct_collection_overrides (Mapping[Type, Callable]) –
prefer_attrib_converters (bool) –
detailed_validation (bool) –
- forbid_extra_keys#
- omit_if_default#
- type_overrides#
- cattrs.preconf.pyyaml.configure_converter(converter)[source]#
Configure the converter for use with the pyyaml library.
frozensets are serialized as lists
string enums are converted into strings explicitly
- Parameters
converter (BaseConverter) –
cattrs.preconf.tomlkit module#
Preconfigured converters for tomlkit.
- class cattrs.preconf.tomlkit.TomlkitConverter(dict_factory=<class 'dict'>, unstruct_strat=UnstructureStrategy.AS_DICT, omit_if_default=False, forbid_extra_keys=False, type_overrides={}, unstruct_collection_overrides={}, prefer_attrib_converters=False, detailed_validation=True)[source]#
Bases:
Converter
- Parameters
dict_factory (Callable[[], Any]) –
unstruct_strat (UnstructureStrategy) –
omit_if_default (bool) –
forbid_extra_keys (bool) –
type_overrides (Mapping[Type, AttributeOverride]) –
unstruct_collection_overrides (Mapping[Type, Callable]) –
prefer_attrib_converters (bool) –
detailed_validation (bool) –
- forbid_extra_keys#
- omit_if_default#
- type_overrides#
- cattrs.preconf.tomlkit.configure_converter(converter)[source]#
Configure the converter for use with the tomlkit library.
bytes are serialized as base85 strings
sets are serialized as lists
tuples are serializas as lists
mapping keys are coerced into strings when unstructuring
- Parameters
converter (BaseConverter) –