Overview

This is a work in progress. It will be released as version 0.1.0 on October 7th, 2019. Until then, use at your own risk, but feel free to file issues.

A quick summary of features

• Provides two top-level parsing functions: parse and loose_parse. loose_parse is less strict on the format of the incoming EDI document.
• Parses a valid X12 EDI document into a struct called EdiDocument.
• Provides verbose error messages if the document being parsed is invalid.
• EdiDocument and all data it contains implement Serialize and Deserialize from serde, so zero-copy serialization and deserialization to any serde-able format is supported (this includes json).
• EdiDocument's fields are all public and it can be navigated like any other struct for simplicity

A quick summary of limitations

• Cannot accurately determine segment types, as that requires an implementation guide from the individual transactor
• Cannot detect loops for the same reason as above
• Only supports standard X12 EDI

Roadmap

• benches to identify regressions
• output back into EDI with proper padding in the ISA segment
• iterator over segments for the frequent cases in which there's only one transaction/functional group/interchange (EdiDocument.segmentsiter() -> SegmentIter?)
  • tostring(delimiters) is needed to output the edi document
• Convert panics into bubbling EdiParseErrors