marshmallow 0,0,1,1,0,1 travis-ci python

A lightweight library for converting complex objects to and from simple Python datatypes.


marshmallow: simplified object serialization


.. image:: https://badge.fury.io/py/marshmallow.svg :target: http://badge.fury.io/py/marshmallow :alt: Latest version

.. image:: https://travis-ci.org/marshmallow-code/marshmallow.svg?branch=pypi :target: https://travis-ci.org/marshmallow-code/marshmallow :alt: Travis-CI

.. image:: https://readthedocs.org/projects/marshmallow/badge/ :target: http://marshmallow.readthedocs.io/ :alt: Documentation

marshmallow is an ORM/ODM/framework-agnostic library for converting complex datatypes, such as objects, to and from native Python datatypes.

.. code-block:: python

from datetime import date
from marshmallow import Schema, fields, pprint

class ArtistSchema(Schema):
    name = fields.Str()

class AlbumSchema(Schema):
    title = fields.Str()
    release_date = fields.Date()
    artist = fields.Nested(ArtistSchema())

bowie = dict(name='David Bowie')
album = dict(artist=bowie, title='Hunky Dory', release_date=date(1971, 12, 17))

schema = AlbumSchema()
result = schema.dump(album)
pprint(result.data, indent=2)
# { 'artist': {'name': 'David Bowie'},
#   'release_date': '1971-12-17',
#   'title': 'Hunky Dory'}

In short, marshmallow schemas can be used to:

  • Validate input data.
  • Deserialize input data to app-level objects.
  • Serialize app-level objects to primitive Python types. The serialized objects can then be rendered to standard formats such as JSON for use in an HTTP API.

Get It Now

::

$ pip install -U marshmallow --pre

Documentation

Full documentation is available at http://marshmallow.readthedocs.io/ .

Requirements

  • Python >= 2.7 or >= 3.4

marshmallow has no external dependencies outside of the Python standard library, although python-dateutil <https://pypi.python.org/pypi/python-dateutil>_ is recommended for robust datetime deserialization.

Ecosystem

A list of marshmallow-related libraries can be found at the GitHub wiki here:

https://github.com/marshmallow-code/marshmallow/wiki/Ecosystem

Project Links

License

MIT licensed. See the bundled LICENSE <https://github.com/marshmallow-code/marshmallow/blob/pypi/LICENSE>_ file for more details.

Related Repositories

digitus

digitus

A library that heavily simplifies the use of Marshmallow's Fingerprint API (Nexu ...

PermissionUtils

PermissionUtils

Check marshmallow permission easily ...

flask-marshmallow

flask-marshmallow

Flask + marshmallow for beautiful APIs ...

assent

assent

A very simple solution to Marshmallow runtime permissions. ...

django-rest-marshmallow

django-rest-marshmallow

Marshmallow schemas for Django REST framework ...


Top Contributors

sloria philtay svenstaro eprikazc taion dwieeb jmcarp aganezov kelvinhammond tvuotila deckar01 ecarreras DamianHeard 0xDCA daniloakamine immerrr franciscod kalasjocke Tim-Erwin evgeny-sureev iakbar justanr amikholap asteinlein d-sutherland ewang jeffwidman hakjoon praveen-p ryanlowe0

Releases

-   2.10.1 zip tar
-   2.10.0 zip tar
-   2.9.1 zip tar
-   2.9.0 zip tar
-   2.8.0 zip tar
-   2.7.3 zip tar
-   2.7.2 zip tar
-   2.7.1 zip tar
-   2.7.0 zip tar
-   2.6.1 zip tar
-   2.6.0 zip tar
-   2.5.0 zip tar
-   2.4.2 zip tar
-   2.4.1 zip tar
-   2.4.0 zip tar
-   2.3.0 zip tar
-   2.2.1 zip tar
-   2.2.0 zip tar
-   2.1.3 zip tar
-   2.1.2 zip tar
-   2.1.1 zip tar
-   2.1.0 zip tar
-   2.0.0 zip tar
-   2.0.0rc2 zip tar
-   2.0.0rc1 zip tar
-   2.0.0b5 zip tar
-   2.0.0b4 zip tar
-   2.0.0b3 zip tar
-   2.0.0b2 zip tar
-   2.0.0b1 zip tar