| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200 |
- Metadata-Version: 2.3
- Name: marshmallow
- Version: 3.26.1
- Summary: A lightweight library for converting complex datatypes to and from native Python datatypes.
- Author-email: Steven Loria <sloria1@gmail.com>
- Maintainer-email: Steven Loria <sloria1@gmail.com>, Jérôme Lafréchoux <jerome@jolimont.fr>, Jared Deckard <jared@shademaps.com>
- Requires-Python: >=3.9
- Description-Content-Type: text/x-rst
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Intended Audience :: Developers
- Classifier: License :: OSI Approved :: MIT License
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Programming Language :: Python :: 3.10
- Classifier: Programming Language :: Python :: 3.11
- Classifier: Programming Language :: Python :: 3.12
- Classifier: Programming Language :: Python :: 3.13
- Requires-Dist: packaging>=17.0
- Requires-Dist: marshmallow[tests] ; extra == "dev"
- Requires-Dist: tox ; extra == "dev"
- Requires-Dist: pre-commit>=3.5,<5.0 ; extra == "dev"
- Requires-Dist: autodocsumm==0.2.14 ; extra == "docs"
- Requires-Dist: furo==2024.8.6 ; extra == "docs"
- Requires-Dist: sphinx-copybutton==0.5.2 ; extra == "docs"
- Requires-Dist: sphinx-issues==5.0.0 ; extra == "docs"
- Requires-Dist: sphinx==8.1.3 ; extra == "docs"
- Requires-Dist: sphinxext-opengraph==0.9.1 ; extra == "docs"
- Requires-Dist: pytest ; extra == "tests"
- Requires-Dist: simplejson ; extra == "tests"
- Project-URL: Changelog, https://marshmallow.readthedocs.io/en/latest/changelog.html
- Project-URL: Funding, https://opencollective.com/marshmallow
- Project-URL: Issues, https://github.com/marshmallow-code/marshmallow/issues
- Project-URL: Source, https://github.com/marshmallow-code/marshmallow
- Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-marshmallow?utm_source=pypi-marshmallow&utm_medium=pypi
- Provides-Extra: dev
- Provides-Extra: docs
- Provides-Extra: tests
- ********************************************
- marshmallow: simplified object serialization
- ********************************************
- |pypi| |build-status| |pre-commit| |docs|
- .. |pypi| image:: https://badgen.net/pypi/v/marshmallow
- :target: https://pypi.org/project/marshmallow/
- :alt: Latest version
- .. |build-status| image:: https://github.com/marshmallow-code/marshmallow/actions/workflows/build-release.yml/badge.svg
- :target: https://github.com/marshmallow-code/marshmallow/actions/workflows/build-release.yml
- :alt: Build status
- .. |pre-commit| image:: https://results.pre-commit.ci/badge/github/marshmallow-code/marshmallow/dev.svg
- :target: https://results.pre-commit.ci/latest/github/marshmallow-code/marshmallow/dev
- :alt: pre-commit.ci status
- .. |docs| image:: https://readthedocs.org/projects/marshmallow/badge/
- :target: https://marshmallow.readthedocs.io/
- :alt: Documentation
- .. start elevator-pitch
- **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 pprint import pprint
- from marshmallow import Schema, fields
- 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, 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
- ==========
- .. code-block:: shell-session
- $ pip install -U marshmallow
- .. end elevator-pitch
- Documentation
- =============
- Full documentation is available at https://marshmallow.readthedocs.io/ .
- Ecosystem
- =========
- A list of marshmallow-related libraries can be found at the GitHub wiki here:
- https://github.com/marshmallow-code/marshmallow/wiki/Ecosystem
- Credits
- =======
- Contributors
- ------------
- This project exists thanks to all the people who contribute.
- **You're highly encouraged to participate in marshmallow's development.**
- Check out the `Contributing Guidelines <https://marshmallow.readthedocs.io/en/latest/contributing.html>`_ to see how you can help.
- Thank you to all who have already contributed to marshmallow!
- .. image:: https://opencollective.com/marshmallow/contributors.svg?width=890&button=false
- :target: https://marshmallow.readthedocs.io/en/latest/authors.html
- :alt: Contributors
- Backers
- -------
- If you find marshmallow useful, please consider supporting the team with
- a donation. Your donation helps move marshmallow forward.
- Thank you to all our backers! [`Become a backer`_]
- .. _`Become a backer`: https://opencollective.com/marshmallow#backer
- .. image:: https://opencollective.com/marshmallow/backers.svg?width=890
- :target: https://opencollective.com/marshmallow#backers
- :alt: Backers
- Sponsors
- --------
- .. start sponsors
- marshmallow is sponsored by `Route4Me <https://route4me.com>`_.
- .. image:: https://github.com/user-attachments/assets/018c2e23-032e-4a11-98da-8b6dc25b9054
- :target: https://route4me.com
- :alt: Routing Planner
- Support this project by becoming a sponsor (or ask your company to support this project by becoming a sponsor).
- Your logo will be displayed here with a link to your website. [`Become a sponsor`_]
- .. _`Become a sponsor`: https://opencollective.com/marshmallow#sponsor
- .. end sponsors
- Professional Support
- ====================
- Professionally-supported marshmallow is now available through the
- `Tidelift Subscription <https://tidelift.com/subscription/pkg/pypi-marshmallow?utm_source=pypi-marshmallow&utm_medium=readme>`_.
- Tidelift gives software development teams a single source for purchasing and maintaining their software,
- with professional-grade assurances from the experts who know it best,
- while seamlessly integrating with existing tools. [`Get professional support`_]
- .. _`Get professional support`: https://tidelift.com/subscription/pkg/pypi-marshmallow?utm_source=marshmallow&utm_medium=referral&utm_campaign=github
- .. image:: https://user-images.githubusercontent.com/2379650/45126032-50b69880-b13f-11e8-9c2c-abd16c433495.png
- :target: https://tidelift.com/subscription/pkg/pypi-marshmallow?utm_source=pypi-marshmallow&utm_medium=readme
- :alt: Get supported marshmallow with Tidelift
- Project Links
- =============
- - Docs: https://marshmallow.readthedocs.io/
- - Changelog: https://marshmallow.readthedocs.io/en/latest/changelog.html
- - Contributing Guidelines: https://marshmallow.readthedocs.io/en/latest/contributing.html
- - PyPI: https://pypi.org/project/marshmallow/
- - Issues: https://github.com/marshmallow-code/marshmallow/issues
- - Donate: https://opencollective.com/marshmallow
- License
- =======
- MIT licensed. See the bundled `LICENSE <https://github.com/marshmallow-code/marshmallow/blob/dev/LICENSE>`_ file for more details.
|