reference utilities

Standard and Workflow Utilities

Builtin values

The canonical runtime hierarchy exposes these value types:

bool, bytes, dict, float, frozenset, int, list, set, str, and tuple.

It also exposes these functions:

abs, all, any, bin, chr, divmod, enumerate, filter, format, hex, isinstance, len, map, max, min, oct, ord, parse_ymd, pow, range, recursive, repr, reversed, round, slice, sorted, sum, to_ymd, and zip.

parse_ymd converts strict eight-character YYYYMMDD strings to dates; to_ymd returns that string format. Integer inputs are rejected. recursive(builder) returns an eager fixed-point function suitable for recursive LCL programs.

Standard namespaces

STANDARD_PRESET supplies read-only namespaces assembled from reviewed manifests. Canonical Frames merge those bindings into LCL_BUILTINS:

• iter.collect and iter.first consume synchronous or asynchronous iterables.
• text.join and text.lines provide deterministic text operations.
• data.lookup and data.merge work with immutable mapping snapshots.
• json.encode and json.decode provide strict JSON conversion.

The iter, text, data and json helpers perform only their documented operations. The separately exposed env utility reads the live process environment. Calendar file loading can access the filesystem when explicitly configured by the application. These capabilities follow the trusted-code model.

Canonical Frames also expose the reviewed calendars namespace and explicit calendar-manager construction helpers. Filesystem access remains opt-in through use_file_system_hardcoded_calendar_loader; see the business day calendar reference.

Python integrations may import STANDARD_MANIFESTS, STANDARD_PRESET, StdlibEntry, StdlibManifest, StdlibNamespace, RecursiveFunction, assemble_stdlib, collect, first, join, lines, lookup, merge, json_encode, json_decode, and recursive from lclang.stdlib.

Environment and logging utilities

from lclang.utils import env returns the singleton live Environment view. env.NAME and env.get(name, default=None) consult os.environ at each call; missing names return the default and reads never snapshot or mutate the process environment. The canonical LCL env utility adds scoped Frame overrides on top of this view.

Process logging lives in lclang.logger. Its two async entry points are use_logger_handler(config) and use_logger(name=None, prefix="", emit_level=0). The handler scope owns console and named file output and restores stdlib logging on exit. CLI and Workflow applications resolve the same configuration from LCL and command-line overrides; see the logger reference.

Workflow status

lclang.workflow exports:

• ExecutionStatus: the status value used by tasks and steps.
• ExecutionTaskType: task classification.
• ExecutionStatusTree: an ordered public record of a task subtree.
• ExecutionStatusManager: creates and coordinates nested task cursors.
• ExecutionStatusStep: a scoped step whose description and status may be updated atomically.

Task and step context managers finalize successful scopes automatically, record failures, and allow exceptions to propagate. Parent aggregation is deterministic, subtree operations are locked, and snapshots preserve child order. FAILURE_COVERED records an exception handled by an explicit workflow context without disguising it as success. See the workflow reference for task definitions, mappings, execution, static rendering, and CLI conversion.

Safe representations

lclang.utils.safe_repr(value, *, max_length=200, renderer=None, masked=False) returns one physical line without a type prefix or task-local masking state. It uses repr or the supplied renderer(value), escapes CR and LF, and converts renderer exceptions (including BaseException) or non-string results to <repr failed: ExceptionType>. The length budget includes ...<truncated>; small budgets retain its prefix, zero returns empty text, and None disables truncation. A negative budget raises ValueError; non-integers, including bool, raise TypeError. With masked=True, the result is *masked* and no renderer runs; the masking marker is independent of the validated budget.

---

Edit the tested source.