Skip to main content

Union fields for marshmallow.

Project description

Union fields for marshmallow.

  • Free software: MIT license


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')) # -> int

If you want to have precise control of which field will be used for which value, you can use marshmallow-polyfield instead of this library.


0.1.15 (2020-05-30)


  • 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)


  • Override the underscore-prefixed methods instead of the plain ones #22


0.1.10 (2019-06-08)


  • Use Towncrier for changelog. #18

0.1.0 (2019-06-07)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

marshmallow-union-0.1.15.tar.gz (17.5 kB view hashes)

Uploaded Source

Built Distribution

marshmallow_union-0.1.15-py2.py3-none-any.whl (4.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page