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.

Getting started

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

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

>>> from tests.fixtures.primer import PurchaseOrder
>>> from xsdata.formats.dataclass.parsers import XmlParser
>>>
>>> parser = XmlParser()
>>> order = parser.parse("tests/fixtures/primer/sample.xml", 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 for more ✨✨✨

Features

Code Generator

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: 25.7 (2025-07-06)

Fixes

Ignore dynamic classes in auto-discovery mode.
(#1144)
Parsing tail content with nested mixed classes
(#1151)

Dependency	Optional
typing-extensions	false
click	true
click-default-group	true
docformatter	true
jinja2	true
lxml	true
markdown-exec	true
mkdocs	true
mkdocs-gen-files	true
mkdocs-literate-nav	true
mkdocs-material	true
mkdocs-minify-plugin	true
mkdocstrings	true
pre-commit	true
pymdownx-superfence-filter-lines	true
pytest	true
pytest-benchmark	true
pytest-cov	true
requests	true
ruff	true
toposort	true

Package profile

xsdata

Releases

Release table

PyPI Downloads

Dependencies

Details

Project URLs

Dependencies

Package description