Metadata-Version: 2.1
Name: xsdata
Version: 24.1
Summary: Python XML Binding
Author-email: Christodoulos Tsoulloftas <chris@komposta.net>
License: MIT
Project-URL: Homepage, https://github.com/tefra/xsdata
Project-URL: Source, https://github.com/tefra/xsdata
Project-URL: Documentation, https://xsdata.readthedocs.io/
Project-URL: Changelog, https://xsdata.readthedocs.io/en/latest/changelog.html
Keywords: xsd,wsdl,schema,dtd,binding,xml,json,dataclasses,generator,cli
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
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
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Text Processing :: Markup :: XML
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: typing-extensions
Provides-Extra: cli
Requires-Dist: click-default-group>=1.2; extra == "cli"
Requires-Dist: click>=5.0; extra == "cli"
Requires-Dist: docformatter>=1.7.2; extra == "cli"
Requires-Dist: jinja2>=2.10; extra == "cli"
Requires-Dist: ruff>=0.1.9; extra == "cli"
Requires-Dist: toposort>=1.5; extra == "cli"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-autobuild; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: sphinx-inline-tabs; extra == "docs"
Requires-Dist: sphinx-rtd-theme; extra == "docs"
Provides-Extra: lxml
Requires-Dist: lxml>=4.4.1; extra == "lxml"
Provides-Extra: soap
Requires-Dist: requests; extra == "soap"
Provides-Extra: test
Requires-Dist: pre-commit; extra == "test"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-benchmark; extra == "test"
Requires-Dist: pytest-cov; extra == "test"

Naive XML Bindings for python
=============================

xsData is a complete data binding library for python allowing developers to access and
use XML and JSON documents as simple objects rather than using DOM.

The code generator supports XML schemas, DTD, WSDL definitions, XML & JSON documents.
It produces simple dataclasses with type hints and simple binding metadata.

The included XML and JSON parser/serializer are highly optimized and adaptable, with
multiple handlers and configuration properties.

xsData is constantly tested against the
`W3C XML Schema 1.1 test suite <https://github.com/tefra/xsdata-w3c-tests>`_.

Getting started
---------------

.. code:: console

    $ # Install all dependencies
    $ pip install xsdata[cli,lxml,soap]

.. code:: console

    $ # Generate models
    $ xsdata tests/fixtures/primer/order.xsd --package tests.fixtures.primer

.. code:: python

    >>> # Parse XML
    >>> from pathlib import Path
    >>> from tests.fixtures.primer import PurchaseOrder
    >>> from xsdata.formats.dataclass.parsers import XmlParser
    >>>
    >>> xml_string = Path("tests/fixtures/primer/sample.xml").read_text()
    >>> parser = XmlParser()
    >>> order = parser.from_string(xml_string, PurchaseOrder)
    >>> order.bill_to
    Usaddress(name='Robert Smith', street='8 Oak Avenue', city='Old Town', state='PA', zip=Decimal('95819'), country='US')


Check the `documentation <https://xsdata.readthedocs.io>`_ for more
✨✨✨

Features
--------

- Generate code from:

  - XML Schemas 1.0 & 1.1
  - WSDL 1.1 definitions with SOAP 1.1 bindings
  - DTD external definitions
  - Directly from XML and JSON Documents
  - Extensive configuration to customize output
  - Pluggable code writer for custom output formats

- Default Output:

  - Pure python dataclasses with metadata
  - Type hints with support for forward references and unions
  - Enumerations and inner classes
  - Support namespace qualified elements and attributes

- Data Binding:

  - XML and JSON parser, serializer
  - PyCode serializer
  - Handlers and Writers based on lxml and native xml python
  - Support wildcard elements and attributes
  - Support xinclude statements and unknown properties
  - Customize behaviour through config



Changelog: 24.1 (2023-01-04)
----------------------------
- Fixed XmlParser to ignore xsi attrs when fail on unknown attributes is enabled (`#846 <https://github.com/tefra/xsdata/pull/846>`_)
- Fixed parsing mandatory byte elements with no value (`#873 <https://github.com/tefra/xsdata/pull/873>`_)
- Fixed issue in json binding with union fields (`#864 <https://github.com/tefra/xsdata/pull/864>`_)
- Fixed PycodeSerializer to escape unicode characters in string values (`#877 <https://github.com/tefra/xsdata/pull/877>`_)
- Fixed compound field choices with forward references (`#886 <https://github.com/tefra/xsdata/pull/886>`_)
- Fixed google style docstrings to add missing colon  (`#884 <https://github.com/tefra/xsdata/pull/884>`_)
- Fixed deprecation warnings for datetime.datetime.utcnow()
- Fixed XmlSerializer to ignore empty non-nillable/required tokens (`#902 <https://github.com/tefra/xsdata/pull/902>`_)
- Fixed issue with invalid variable names when using originalCase naming convention (`#881 <https://github.com/tefra/xsdata/pull/881>`_)
- Added type hints for compound fields (`#858 <https://github.com/tefra/xsdata/pull/858>`_, `#885 <https://github.com/tefra/xsdata/pull/885>`_)
- Added http header when loading remote resources (`#867 <https://github.com/tefra/xsdata/pull/867>`_)
- Added warning when converting parent field to a list (`#871 <https://github.com/tefra/xsdata/pull/871>`_)
- Added ruff to format generated code (`#892 <https://github.com/tefra/xsdata/pull/892>`_)
- Added option to use substitution group names for compound field name (`#905 <https://github.com/tefra/xsdata/pull/905>`_)
- Updated base64 decoding to enable validation (`#875 <https://github.com/tefra/xsdata/pull/875>`_)
- Updated generator to render prohibited parent fields with restriction extensions (`#908 <https://github.com/tefra/xsdata/pull/908>`_)
- Updated generator so plugins can easily override templates
