openregs text

The text of a unit on a date, on either time axis.

Two independent questions about the same unit. —as-of asks valid time: what was in force on that day. —known-at asks transaction time: what this corpus would have answered before it learned whatever it has learned since - which is how a past release is reproduced rather than re-derived. Without —known-at the answer is the corpus as it stands; with it, a version learned later is out of sight and a window closed by such a version is reopened, because the closing bound is the trace of learning it.

openregs text [-h] --as-of <date> [--known-at <instant>] [--regime <name>]
                     [--work <work-key>] [--language <code>] [--canon <path>] [--root <path>]
                     <eId>

Argument
<eId>	the unit to read, for example art_5__para_3 (required)

Option
--as-of <date>	valid time: the day to answer for, ISO 8601 (YYYY-MM-DD) (required)
--known-at <instant>	transaction time: answer as the corpus stood at this RFC 3339 instant (default: as it stands now)
--regime <name>	which regime’s canon to read (default: the checkout’s only regime)
--work <work-key>	disambiguate when more than one act in the canon declares this eId
--language <code>	read this language’s Expressions, for example eng
--canon <path>	read this canon directory instead of regimes/<regime>/canon
--root <path>	read regimes/ under this directory instead of the checkout