@fnndsc/brasa 0.45.0 → 0.46.0

package/dist/core/variables.js

@@ -0,0 +1,316 @@
+/**
+ * @file The session's variables: a name a line gives to what a command
+ * answered, so a later line can say which thing it means.
+ *
+ * `A=$(pl-dcm2niix …)` holds the run's whole answer, its model, rather than
+ * the text it printed; `${A.instanceId}` reads one field of it. A command
+ * that answers no model is held as its text, one row per line. A literal,
+ * `LABEL='sag cohort'`, is one word and stays one.
+ *
+ * Variables belong to the session, so every surface attached to it sees the
+ * same ones. A manifest's play gets a scope of its own: it sees its
+ * parameters (read-only) and nothing of the caller's, and what it sets ends
+ * with it. A nested play gets its own again. The scope follows the async
+ * path, so a play running in the daemon never leaks into a line typed at
+ * another surface at the same moment.
+ *
+ * Reading follows one rule everywhere: a dot is a field of the model, as the
+ * model names it. A field holding a list reaches through it, one operand per
+ * element; a bare name is its rows when the answer has rows, and refuses by
+ * name when it is one thing with several fields. There is no indexing:
+ * naming one row is what the `@` handles are for.
+ *
+ * @module
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { answerRows_of } from '../session/answer.js';
+/** The kind a variable holding text has: a literal, a parameter, or a command with no model. */
+export const TEXT_KIND = 'text';
+/** What a name may be: a letter or underscore, then letters, digits, underscores. */
+export const VARIABLE_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** The session's own variables. */
+const sessionScope = new Map();
+/** The scope of the play running on this async path, when one is. */
+const playScope = new AsyncLocalStorage();
+/**
+ * The scope a line on this async path reads and writes.
+ *
+ * @returns The play's scope inside a play, else the session's.
+ */
+function scope_current() {
+    return playScope.getStore() ?? sessionScope;
+}
+/**
+ * Whether the work on this async path is a play's.
+ *
+ * @returns True inside a play's scope.
+ */
+export function variableScope_isPlay() {
+    return playScope.getStore() !== undefined;
+}
+/**
+ * A text answer: a literal, a parameter's value, or what a command printed.
+ *
+ * @param text - The text.
+ * @param source - The line that gave it.
+ * @returns The answer.
+ */
+export function textAnswer_make(text, source) {
+    return { source, kind: TEXT_KIND, rows: [], data: text };
+}
+/**
+ * Runs work in a fresh scope holding only the given parameters, read-only:
+ * a manifest's play.
+ *
+ * @param params - The parameters, already checked for completeness.
+ * @param operation - The work to run.
+ * @returns The operation's result.
+ */
+export async function variableScope_run(params, operation) {
+    const scope = new Map();
+    for (const [name, value] of params) {
+        scope.set(name, { answer: textAnswer_make(value, `@param ${name}`), readOnly: true });
+    }
+    return await playScope.run(scope, operation);
+}
+/**
+ * The variable a name holds in the current scope.
+ *
+ * @param name - The variable's name.
+ * @returns It, or undefined when the scope has none of that name.
+ */
+export function variable_get(name) {
+    return scope_current().get(name);
+}
+/**
+ * Sets a variable in the current scope.
+ *
+ * @param name - Its name, already checked.
+ * @param answer - What it holds.
+ * @returns A refusal, or null when it was set.
+ */
+export function variable_set(name, answer) {
+    const scope = scope_current();
+    if (scope.get(name)?.readOnly === true)
+        return `${name} is a parameter of this manifest; it is read-only`;
+    scope.set(name, { answer, readOnly: false });
+    return null;
+}
+/**
+ * Removes a variable from the current scope.
+ *
+ * @param name - Its name.
+ * @returns A refusal, or null when it was removed (or was never set).
+ */
+export function variable_unset(name) {
+    const scope = scope_current();
+    if (scope.get(name)?.readOnly === true)
+        return `${name} is a parameter of this manifest; it is read-only`;
+    scope.delete(name);
+    return null;
+}
+/**
+ * Every variable in the current scope, by name.
+ *
+ * @returns The variables, sorted by name.
+ */
+export function variables_list() {
+    return Array.from(scope_current().entries())
+        .map(([name, variable]) => ({ name, ...variable }))
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+/** Kind to its bare operands, for records that are not listings. */
+const operandReaders = new Map();
+/**
+ * Says what a bare `${NAME}` holding a record of this kind expands to. A
+ * listing's rows need no reader (its answer adapter numbers them); this is
+ * for a record that is not a listing and must not become the held one, as a
+ * scheduled pipeline's nodes are not rows to number.
+ *
+ * @param kind - The model kind.
+ * @param reader - Reads the operands out of that model.
+ */
+export function answerOperands_register(kind, reader) {
+    operandReaders.set(kind, reader);
+}
+/**
+ * A value's own field names, for a refusal that says what can be named.
+ *
+ * @param value - An object.
+ * @returns Its keys.
+ */
+function fields_of(value) {
+    return Object.keys(value).join(', ');
+}
+/**
+ * Whether a value is a scalar an operand can be made of.
+ *
+ * @param value - Anything.
+ * @returns True for a string, number or boolean.
+ */
+function scalar_is(value) {
+    return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+}
+/**
+ * The operands a value is, at the end of a dotted name.
+ *
+ * @param value - The value reached.
+ * @param trail - The name as far as it went, for a refusal.
+ * @param kind - The answer's kind, named when the whole model is an object.
+ * @returns Its operands, or why it has none.
+ */
+function leaf_read(value, trail, kind) {
+    if (value === null || value === undefined)
+        return { refused: `${trail} is empty` };
+    if (scalar_is(value))
+        return { values: [String(value)] };
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return { refused: `${trail} is empty` };
+        if (value.every(scalar_is))
+            return { values: value.map((element) => String(element)) };
+        const first = value.find((element) => element !== null && typeof element === 'object');
+        return { refused: `${trail} holds records; name a field: ${first === undefined ? '' : fields_of(first)}` };
+    }
+    return { refused: `${trail} is ${kind === null ? 'a record' : `a ${kind}`}; name a field: ${fields_of(value)}` };
+}
+/**
+ * Walks a dotted name into a value. A field that is a list is reached
+ * through: every element gives its operands.
+ *
+ * @param value - Where the walk stands.
+ * @param fields - The fields still to walk.
+ * @param trail - The name as far as it went.
+ * @param kind - The answer's kind, for the bare refusal.
+ * @returns The operands, or why there are none.
+ */
+function fields_walk(value, fields, trail, kind) {
+    if (fields.length === 0)
+        return leaf_read(value, trail, kind);
+    const [field, ...rest] = fields;
+    if (Array.isArray(value)) {
+        const values = [];
+        for (const element of value) {
+            const reading = fields_walk(element, fields, trail, null);
+            if ('refused' in reading)
+                return reading;
+            values.push(...reading.values);
+        }
+        if (values.length === 0)
+            return { refused: `${trail} is empty` };
+        return { values };
+    }
+    if (value === null || typeof value !== 'object')
+        return { refused: `${trail} is a value; it has no field ${field}` };
+    if (!(field in value))
+        return { refused: `${trail} has no field ${field}; it has ${fields_of(value)}` };
+    return fields_walk(value[field], rest, `${trail}.${field}`, null);
+}
+/**
+ * The lines of a text answer, the trailing newline not making an empty one.
+ *
+ * @param text - The text.
+ * @returns One string per line.
+ */
+function lines_of(text) {
+    const lines = text.split('\n');
+    if (lines.length > 0 && lines[lines.length - 1] === '')
+        lines.pop();
+    return lines;
+}
+/**
+ * Reads an answer by a dotted name: bare, its rows (or its lines, or its
+ * one value); with fields, the fields as the model names them.
+ *
+ * @param answer - What the variable holds.
+ * @param name - The variable's name, for a refusal.
+ * @param fields - The fields after it, in order.
+ * @returns The operands, or why there are none.
+ */
+export function answer_read(answer, name, fields) {
+    if (answer.kind === TEXT_KIND) {
+        if (fields.length > 0)
+            return { refused: `${name} is text; it has no field ${fields[0]}` };
+        const lines = lines_of(typeof answer.data === 'string' ? answer.data : '');
+        return lines.length === 0 ? { refused: `${name} is empty` } : { values: lines };
+    }
+    if (fields.length > 0)
+        return fields_walk(answer.data, fields, name, answer.kind);
+    const rows = answerRows_of(answer.kind, answer.data);
+    if (rows !== null) {
+        const values = rows.flatMap((row) => row.values);
+        return values.length === 0 ? { refused: `${name} is empty` } : { values };
+    }
+    const operands = operandReaders.get(answer.kind)?.(answer.data) ?? null;
+    if (operands !== null)
+        return operands.length === 0 ? { refused: `${name} is empty` } : { values: operands };
+    return leaf_read(answer.data, name, answer.kind);
+}
+/**
+ * Finds the end of a `$(…)` that opens at a position: the parenthesis that
+ * closes it, skipping any inside quotes or nested parentheses.
+ *
+ * @param text - The text.
+ * @param open - Where `$(` begins.
+ * @returns The index of the closing parenthesis, or -1 when it never closes.
+ */
+export function substitution_end(text, open) {
+    let depth = 0;
+    let quote = null;
+    for (let at = open + 1; at < text.length; at++) {
+        const char = text[at];
+        if (quote !== null) {
+            if (char === '\\' && quote === '"') {
+                at++;
+                continue;
+            }
+            if (char === quote)
+                quote = null;
+            continue;
+        }
+        if (char === '\\') {
+            at++;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            continue;
+        }
+        if (char === '(')
+            depth++;
+        else if (char === ')') {
+            depth--;
+            if (depth === 0)
+                return at;
+        }
+    }
+    return -1;
+}
+/**
+ * Reads a line as an assignment, when it is one: `NAME=$(command)` or
+ * `NAME=word`.
+ *
+ * @param line - The trimmed line.
+ * @returns The assignment, or null when the line is not one.
+ */
+export function assignment_parse(line) {
+    const match = line.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/s);
+    if (match === null)
+        return null;
+    const name = match[1];
+    const value = match[2];
+    if (!value.startsWith('$('))
+        return { name, literal: value };
+    const end = substitution_end(value, 0);
+    if (end === -1)
+        return { name, refused: `${name}=$(…): the $( never closes` };
+    if (value.slice(end + 1).trim() !== '')
+        return { name, refused: `${name}=$(…): a capture is the whole value; nothing may follow its )` };
+    const capture = value.slice(2, end).trim();
+    if (capture === '')
+        return { name, refused: `${name}=$(): there is no command to capture` };
+    if (capture.startsWith('$(') || /(^|[^\\])\$\(/.test(capture))
+        return { name, refused: `${name}=$(…): a capture holds one command line, not another capture` };
+    return { name, capture };
+}
+//# sourceMappingURL=variables.js.map

package/dist/core/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../src/core/variables.ts"],"names":[],"mappings":"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"}

package/dist/lib/parser.js

@@ -8,8 +8,8 @@
 /**
  * What a reference looks like: `${name}` or a bare `$NAME`.
  *
- * A braced name may carry dots, which is how a session pronoun names part
- * of what it refers to (`${gather.first.place}`); a bare one may not, so
+ * A braced name may carry dots, which is how a variable names a field
+ * of what it refers to (`${gather.series.folderPath}`); a bare one may not, so
  * `$HOME.txt` keeps its extension.
  */
 const REFERENCE_PATTERN = /^\$(?:\{([A-Za-z_][A-Za-z0-9_.]*)\}|([A-Za-z_][A-Za-z0-9_]*))/;