The generators of a repository, declared in its configuration as data (commons repoctl 0002-repoctl-governanceFR-005; 0009-repoctl-configFR-003): each is a program (or a typed function) that makes files from sources and checks that they are what it makes, with the globs of what it reads and of what it writes and the generators it declares to come after. repoctl sync runs them in the order those facts give, repoctl merge knows a generated file by them and repoctl check runs each one's check.
type Generator = {
readonly id: StepId;
readonly summary: string;
/** Makes the files. */
readonly run: Step;
…(896 characters)
typeGenerator= {
readonlyid:StepId;
readonlysummary:string;
/** Makes the files. */readonlyrun:Step;
/** Writes nothing and ends with 0 where the files are what `run` makes and with 1 where they are not. */readonlycheck:Step;
/** What it reads, as globs from the repository's root (`*` is one segment's characters, `**` any number of segments). */readonlyinputs:readonlystring[];
/** What it writes, as globs from the repository's root. */readonlyoutputs:readonlystring[];
/** The generators it comes after, besides those whose outputs it reads. */readonlyafter:readonlyStepId[];
/** The outputs (globs, a subset of `outputs`) that also hold text a person wrote and that the generator leaves as it finds it, so that a merge keeps the lines of both sides of them before it makes the generated part again. */readonlymixed:readonlystring[];
};
A generator: what it is, how it makes its files and checks them, and what it reads and writes.
type Generator = {
readonly id: StepId;
readonly summary: string;
/** Makes the files. */
readonly run: Step;
…(896 characters)
typeGenerator= {
readonlyid:StepId;
readonlysummary:string;
/** Makes the files. */readonlyrun:Step;
/** Writes nothing and ends with 0 where the files are what `run` makes and with 1 where they are not. */readonlycheck:Step;
/** What it reads, as globs from the repository's root (`*` is one segment's characters, `**` any number of segments). */readonlyinputs:readonlystring[];
/** What it writes, as globs from the repository's root. */readonlyoutputs:readonlystring[];
/** The generators it comes after, besides those whose outputs it reads. */readonlyafter:readonlyStepId[];
/** The outputs (globs, a subset of `outputs`) that also hold text a person wrote and that the generator leaves as it finds it, so that a merge keeps the lines of both sides of them before it makes the generated part again. */readonlymixed:readonlystring[];
};
A generator: what it is, how it makes its files and checks them, and what it reads and writes.