Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

An unofficial extension to Marshmallow to allow for polymorphic fields

Project description

Documentation Status Build Status Coverage Status

This branch supports Marshmallow 3.0 and above. For 2.0 support see The 2.0 branch

An unofficial extension to Marshmallow to allow for polymorphic fields.

Marshmallow is a fantastic library for serialization and deserialization of data. For more on that project see its GitHub page or its Documentation.

This project adds a custom field designed for polymorphic types. This allows you to define a schema that says “This field accepts anything of type X”

The secret to this field is that you need to define two functions. One to be used when serializing, and another for deserializing. These functions take in the raw value and return the schema to use.

This field should support the same properties as other Marshmallow fields. I have worked with required allow_none and many.

Last version support v2 is tagged FINAL_V2_VERSION


$ pip install marshmallow-polyfield


Here is how to import the necessary field class

from marshmallow_polyfield import PolyField


The code below demonstrates how to setup a schema with a PolyField. For the full context check out the tests. Once setup the schema should act like any other schema. If it does not then please file an Issue.

def shape_schema_serialization_disambiguation(base_object, parent_obj):
    class_to_schema = {
        Rectangle.__name__: RectangleSchema,
        Triangle.__name__: TriangleSchema
        return class_to_schema[base_object.__class__.__name__]()
    except KeyError:

    raise TypeError("Could not detect type. "
                    "Did not have a base or a length. "
                    "Are you sure this is a shape?")

def shape_schema_deserialization_disambiguation(object_dict, parent_object_dict):
    if object_dict.get("base"):
        return TriangleSchema()
    elif object_dict.get("length"):
        return RectangleSchema()

    raise TypeError("Could not detect type. "
                    "Did not have a base or a length. "
                    "Are you sure this is a shape?")

class ContrivedShapeClass(object):
    def __init__(self, main, others):
        self.main = main
        self.others = others

    def __eq__(self, other):
        return self.__dict__ == other.__dict__

class ContrivedShapeClassSchema(Schema):
    main = PolyField(
    others = PolyField(

    def make_object(self, data):
        return TestPolyField.ContrivedShapeClass(

Project details

Download files

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

Files for marshmallow-polyfield, version 5.9
Filename, size File type Python version Upload date Hashes
Filename, size marshmallow-polyfield-5.9.tar.gz (8.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page