Data Bindings
=============

All the xsdata :ref:`XML <xsdata:XML Binding>` and :ref:`JSON <xsdata:JSON Binding>`
bindings are available. There is an extra requirement to specify the class type of
the data models to the :class:`~xsdata.formats.dataclass.context.XmlContext` that
among other stuff also acts as a compatibility layer between :mod:`python:dataclasses`
and :doc:`attrs <attrs:overview>`.



Specify ClassType
-----------------

.. code-block:: python
    :emphasize-lines: 7

    >>> from xsdata.formats.dataclass.parsers import XmlParser
    >>> from xsdata.formats.dataclass.parsers import JsonParser
    >>> from xsdata.formats.dataclass.serializers import XmlSerializer
    >>> from xsdata.formats.dataclass.serializers import JsonSerializer
    >>> from xsdata.formats.dataclass.context import XmlContext
    ...
    >>> context = XmlContext(class_type="attrs")  # Specify class type attrs
    >>> xml_parser = XmlParser(context=context)
    >>> xml_serializer = XmlSerializer(context=context)
    >>> json_parser = JsonParser(context=context)
    >>> json_serializer = JsonSerializer(context=context)


Binding Shortcuts
-----------------

For convenience this plugin comes with subclasses for all the xsdata binding modules
with the attrs context auto initialized.

.. code-block:: python

    >>> from xsdata_attrs.bindings import XmlContext
    >>> from xsdata_attrs.bindings import XmlParser
    >>> from xsdata_attrs.bindings import XmlSerializer
    >>> from xsdata_attrs.bindings import JsonParser
    >>> from xsdata_attrs.bindings import JsonSerializer
    >>> from xsdata_attrs.bindings import UserXmlParser