Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tefra/xsdata
Naive XML & JSON Bindings for python
https://github.com/tefra/xsdata
binding code-generator dataclass parser python python-library schema serializer soap wsdl xml xsd
Last synced: 5 days ago
JSON representation
Naive XML & JSON Bindings for python
- Host: GitHub
- URL: https://github.com/tefra/xsdata
- Owner: tefra
- License: mit
- Created: 2019-10-23T18:51:12.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-10-21T17:08:04.000Z (3 months ago)
- Last Synced: 2024-10-29T22:56:46.347Z (3 months ago)
- Topics: binding, code-generator, dataclass, parser, python, python-library, schema, serializer, soap, wsdl, xml, xsd
- Language: Python
- Homepage: https://xsdata.readthedocs.io
- Size: 6.11 MB
- Stars: 329
- Watchers: 9
- Forks: 60
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://xsdata.readthedocs.io/)
# Naive XML Bindings for python
[](https://github.com/tefra/xsdata/actions)
[](https://xsdata.readthedocs.io/)
[](https://codecov.io/gh/tefra/xsdata)
[](https://www.codefactor.io/repository/github/tefra/xsdata)
[](https://pypi.org/pypi/xsdata/)
[](https://pypi.org/pypi/xsdata/)
---
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
```console
$ # Install all dependencies
$ pip install xsdata[cli,lxml,soap]
```
```console
$ # Generate models
$ xsdata generate tests/fixtures/primer/order.xsd --package tests.fixtures.primer
```
```python
>>> 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](https://xsdata.readthedocs.io) 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: 24.12 (2024-12-22)
**Fixes**
- Set the default value of prohibited fields to None
([#1098](https://github.com/tefra/xsdata/pull/1098))
- Set body and fault as optional in output soap classes
([#1099](https://github.com/tefra/xsdata/pull/1099))
- Resolve a conflict with type location when an element and a complex type have the same
name ([#1107](https://github.com/tefra/xsdata/pull/1107))
**Features**
- Allow Xml Parser subclasses to override how the root class is located
([#1090](https://github.com/tefra/xsdata/pull/1090))
- Include common soap encoding schema
([#1100](https://github.com/tefra/xsdata/pull/1100))
**Deprecations**
- Remove subscritable types config option
- Remove Type,Tuple,List,Dict from stop words
- Deprecate xsdata shorthand, use xsdata generate instead