Development Status
- 3 - Alpha
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Operating System
- Unix
- POSIX
- Microsoft :: Windows
Programming Language
- Python
- Python :: 3
- Python :: 3.6
- Python :: 3.7
- Python :: Implementation :: CPython
- Python :: Implementation :: PyPy
Topic
- Utilities
Union fields for marshmallow.
Free software: MIT license
Warning
This library works by trying a list of fields one by one, and (de)serializing with the first one not to raise an error. The type of the values is not taken into account, so if one of the fields in the union accepts values of an unexpected type, they will be used for serialization. This can lead to a surprising behavior, because :
u = Union(fields=[fields.Integer(), fields.String()]) # the Integer field accepts string representations of integers type(u.deserialize('0')) # -> intIf you want to have precise control of which field will be used for which value, you can use marshmallow-polyfield instead of this library.
Documentation
https://python-marshmallow-union.readthedocs.io/
0.1.15 (2020-05-30)
Changes
Fix #32 : Never ignore the value passed to _serialize. Notably, this fixes the serialization of lists of unions, such as List(Union([Int(), String()]))
0.1.12 (2019-10-24)
Backward-incompatible Changes
On serialization, marshmallow_union.ExceptionGroup is raised if all candidate fields fail. #24
0.1.11 (2019-06-19)
Changes
Override the underscore-prefixed methods instead of the plain ones #22
Changelog
0.1.10 (2019-06-08)
Changes
Use Towncrier for changelog. #18
0.1.0 (2019-06-07)
First release on PyPI.
Wheel compatibility matrix
Files in release
marshmallow
(>=3.0.0)