pynetex

pynetex provides generated Python dataclasses for reading and writing NeTEx 2.0 XML with xsdata.

The package intentionally exposes the complete generated model at the top level. Individual generated modules can also be imported directly.

Installation

pip install pynetex

Python 3.12 or newer is required.

Usage

Import a model from the complete top-level API:

from pynetex import PublicationDelivery

Or import it from its generated module:

from pynetex.publication_delivery import PublicationDelivery

Parse and serialize a NeTEx publication with xsdata:

from pathlib import Path

from xsdata.formats.dataclass.parsers import XmlParser
from xsdata.formats.dataclass.serializers import XmlSerializer
from xsdata.formats.dataclass.serializers.config import SerializerConfig

from pynetex import PublicationDelivery

source = Path("publication.xml")
publication = XmlParser().parse(source, PublicationDelivery)

xml = XmlSerializer(
    config=SerializerConfig(pretty_print=True),
).render(publication)

Parsing XML into dataclasses does not perform XML Schema validation. Validate documents separately when schema conformance is required.

Schema provenance

The bindings target the NeTEx v2.0 schemas in the external/NeTEx submodule, pinned at commit:

eea28c4424ec37aa3821d34be88b6ef289242b0e

The schema source and these generated bindings are distributed under the GNU General Public License version 3. See LICENSE and NOTICE.

Development

Install the locked development environment and run the tests:

git submodule update --init
uv sync --dev
uv run pytest

The Python modules are generated output and should not be edited manually. Regenerate them from the repository root with xsdata 26.2:

(
  cd src
  uv run xsdata generate \
    --config ../.xsdata.xml \
    ../external/NeTEx/xsd/NeTEx_publication.xsd
)

After regeneration, git diff --exit-code -- src/pynetex should report no changes. To verify a release artifact, build it with uv build --wheel, install the wheel in a clean environment outside the repository, and import pynetex.