msgspec-xml 0.2.0

XML Serialization/Deserialization using msgspec

msgspec-xml

XML Serialization/Deserialization using msgspec.

Installation

pdm add msgspec-xml

Usage

from decimal import Decimal
from typing import Annotated

from msgspec import Struct
from msgspec_xml import XML, decode, encode


class Price(Struct):
    currency: Annotated[str, XML(attr=True)]
    cost: Annotated[Decimal, XML(text=True)]


class Book(Struct, rename="pascal"):
    title: str
    prices: Annotated[list[Price], XML(wrapper="Prices", tag="Price")]


book = Book(
    title="Example Book",
    prices=[
        Price(currency="USD", cost=Decimal("3.99")),
        Price(currency="GBP", cost=Decimal("1.51")),
    ],
)

xml = encode(book)
# <Book>
#   <Title>Example Book</Title>
#   <Prices>
#     <Price currency="USD">3.99</Price>
#     <Price currency="GBP">1.51</Price>
#   </Prices>
# </Book>

decoded = decode(xml, type_=Book)

assert decoded == book

Socials