Tutorials
Tutorials
Longer, start-to-finish walkthroughs you can follow at a keyboard. Each one builds something that runs, and explains the decisions along the way rather than only the API calls.
The tutorials
Your first message
From `cargo add` to a parsed, queried, validated ORU^R01.
Taming a vendor dialect
The three stages: look at it, write down what you learned, freeze what is stable.
An MLLP listener that answers
Accept a connection, reassemble frames, and send a correct acknowledgement.
A lossless round trip
ER7 to XML to ER7, as a shell pipeline and as a test.
How these differ from the guides
A guide answers “how do I do X” and assumes you already know why you want to. A tutorial starts from a situation — a vendor sent you a file, a hospital wants a listener — and walks the whole way to something that works, including the parts that are judgement rather than API.
They overlap on purpose. If you have read the guides and want to see them assembled, start here; if you have followed a tutorial and want the full surface of one step, the guides are linked throughout.
Before you start
- A Rust toolchain at or above the MSRV, and nothing else — there is no C dependency anywhere in the workspace.
- For the tutorials that use the shell,
cargo install hl7-2, which gives you a binary namedhl7-v2. See Install. - Enough of Concepts to know what a segment, a field, and a component are. The tutorials assume that vocabulary and no more.