xmppftw/xmpp-rs
Watch
1
0
Fork
You've already forked xmpp-rs
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

xso: implement transparent structs

Browse source
This commit is contained in:
Jonas Schäfer 2024-08-05 15:32:54 +02:00 • committed by Link Mauve
commit fda4a9ff29
6 changed files with 360 additions and 70 deletions
Download patch file Download diff file Expand all files Collapse all files

1
xso/ChangeLog
View file

@ -22,6 +22,7 @@ Version NEXT:
structs.
- Support for collecting all unknown children in a single field as
collection of `minidom::Element`.
- Support for "transparent" structs (newtype-like patterns for XSO).
Version 0.1.2:
2024-07-26 Jonas Schäfer <jonas@zombofant.net>

7
xso/src/from_xml_doc.md
View file

@ -50,6 +50,7 @@ The following keys are defined on structs:
| --- | --- | --- |
| `namespace` | *string literal* or *path* | The XML element namespace to match. If it is a *path*, it must point at a `&'static str`. |
| `name` | *string literal* or *path* | The XML element name to match. If it is a *path*, it must point at a `&'static NcNameStr`. |
| `transparent` | *flag* | If present, declares the struct as *transparent* struct (see below) |
| `builder` | optional *ident* | The name to use for the generated builder type. |
| `iterator` | optional *ident* | The name to use for the generated iterator type. |
@ -74,6 +75,12 @@ By default, the builder type uses the type's name suffixed with
`FromXmlBuilder` and the iterator type uses the type's name suffixed with
`AsXmlIterator`.
If the struct is marked as `transparent`, it must not have a `namespace` or
`name` set and it must have exactly one field. That field's type must
implement [`FromXml`] in order to derive `FromXml` and [`AsXml`] in order to
derive `AsXml`. The struct will be (de-)serialised exactly like the type of
that single field. This allows a newtype-like pattern for XSO structs.
### Enum meta
The following keys are defined on enums: