Skip to main content

Crate geneweb

Crate geneweb 

Source
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:

  1. A faithful, lossless .gw syntax 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.
  2. 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 .gw date grammar.
encoding
Character encoding and physical line handling for .gw files.
error
Error types for the .gw reader.
gedcom
Converting a .gw file into oxidged’s GEDCOM model.
lexer
Tokenization of .gw lines.
model
A lossless syntax tree for the .gw format.
parser
The .gw block reader.