Expand description
A reader for GeneWeb .gw genealogy files, with conversion to GEDCOM via oxidged.
.gw is the textual interchange format of the GeneWeb
genealogy software — the format produced by gwu and consumed by gwc, and the
backup format GeneWeb itself recommends. This crate reads it, including the gwplus
extension introduced in GeneWeb 7.00 that adds structured personal and family events.
§Two layers
Reading happens in two stages, because the two data models are not equivalent:
- A faithful, lossless
.gwsyntax tree. GeneWeb has concepts GEDCOM has no room for — per-person access rights, wizard notes, extended wiki pages, occurrence-numbered keys — and this layer keeps all of them. - A conversion of that tree into
oxidged’s GEDCOM model, where anything without a standard GEDCOM counterpart is preserved as a user-defined tag rather than dropped.
§Reference
The normative reference for the grammar is GeneWeb’s own OCaml implementation,
bin/gwc/gwcomp.ml, not the wiki page, which lags it. Where this crate reproduces a
non-obvious rule, the corresponding OCaml function is named in a comment.
Re-exports§
pub use error::GwError;pub use error::GwErrorKind;pub use error::Result;
Modules§
- database
- Turning a flat sequence of blocks into a connected genealogy.
- date
- The
.gwdate grammar. - encoding
- Character encoding and physical line handling for
.gwfiles. - error
- Error types for the
.gwreader. - gedcom
- Converting a
.gwfile intooxidged’s GEDCOM model. - lexer
- Tokenization of
.gwlines. - model
- A lossless syntax tree for the
.gwformat. - parser
- The
.gwblock reader.