Result-file naming, filesystem lifecycle, and EDN sanitization for the CLI.
Result-file naming, filesystem lifecycle, and EDN sanitization for the CLI.
(concrete-var-backed-entry? entry)True when a canonical entry is attributable to a concrete test var.
True when a canonical entry is attributable to a concrete test var.
(concrete-var-symbol? x)True when x is a concrete namespace-qualified var symbol.
True when x is a concrete namespace-qualified var symbol.
(create-result-sink dir)(create-result-sink dir
{:keys [publish-entry! delete-temp! write-temp!]
:or {delete-temp! delete-temp-path!
write-temp! write-temp-entry!}})Create state for synchronous completed-entry artifact publication.
:publish-entry!, when supplied, receives dir, filename, and canonical entry.
:write-temp! and :delete-temp! customize the atomic publisher's filesystem
operations. Publication failures are recorded in the sink and never escape a
runner callback.
Create state for synchronous completed-entry artifact publication. `:publish-entry!`, when supplied, receives dir, filename, and canonical entry. `:write-temp!` and `:delete-temp!` customize the atomic publisher's filesystem operations. Publication failures are recorded in the sink and never escape a runner callback.
(edn-readable-data value)(edn-readable-data value opts)Recursively coerce data into bounded values readable by clojure.edn/read-string.
Accepts optional sanitizer limits such as :max-depth, :max-seq-length,
:max-string-length, and :seen (java.util.IdentityHashMap). Pathological
data is replaced with tagged placeholder maps.
Recursively coerce data into bounded values readable by clojure.edn/read-string. Accepts optional sanitizer limits such as `:max-depth`, `:max-seq-length`, `:max-string-length`, and `:seen` (`java.util.IdentityHashMap`). Pathological data is replaced with tagged placeholder maps.
(encode-file-segment segment)Encode a namespace or var-name segment for a deterministic result filename.
Encode a namespace or var-name segment for a deterministic result filename.
(failure-entry? entry)True when a canonical result entry should be written to a result file.
True when a canonical result entry should be written to a result file.
(handle-completed-entry! {:keys [state] :as sink} entry)Synchronously observe one completed canonical entry.
Every concrete entry advances its occurrence ordinal. Only failing/erroring concrete entries are published, and contained publication failures are kept in sink state for later reconciliation. Returns nil so this is observational.
Synchronously observe one completed canonical entry. Every concrete entry advances its occurrence ordinal. Only failing/erroring concrete entries are published, and contained publication failures are kept in sink state for later reconciliation. Returns nil so this is observational.
(prepare-results-dir! io-boundary)Clear and recreate the CLI results directory for a run.
Clear and recreate the CLI results directory for a run.
(reconcile-result-sink! sink entries)Reconcile a sink with normally returned canonical entries.
Retries the latest unpublished callback failure using its ordinally matching canonical occurrence when that occurrence still fails. It also publishes the latest failing occurrence for callback-ignoring runners and synthetic entries. Returns only successfully published final paths and unresolved identities; all individual publication failures remain contained.
Reconcile a sink with normally returned canonical entries. Retries the latest unpublished callback failure using its ordinally matching canonical occurrence when that occurrence still fails. It also publishes the latest failing occurrence for callback-ignoring runners and synthetic entries. Returns only successfully published final paths and unresolved identities; all individual publication failures remain contained.
(result-file-assignments entries)(result-file-assignments entries reserved-filenames)Return failing/erroring entries with deterministic result-file names.
Var-backed filenames keep the existing namespace-prefixed shape. Synthetic entries use per-status suite-level names with deterministic collision suffixes for file paths when needed.
Return failing/erroring entries with deterministic result-file names. Var-backed filenames keep the existing namespace-prefixed shape. Synthetic entries use per-status suite-level names with deterministic collision suffixes for file paths when needed.
(result-file-name entry)Return the namespace-prefixed result EDN filename for a var-backed entry.
Return the namespace-prefixed result EDN filename for a var-backed entry.
(results-dir {:keys [cwd]})Return the .scry-results directory for an IO boundary map containing :cwd.
Return the .scry-results directory for an IO boundary map containing :cwd.
(sink-exception-snapshot sink)Return the latest completed artifact state without retrying.
Once normal reconciliation has completed, includes its synthetic artifacts and unresolved diagnostics. Before then, returns callback-time state only.
Return the latest completed artifact state without retrying. Once normal reconciliation has completed, includes its synthetic artifacts and unresolved diagnostics. Before then, returns callback-time state only.
(sink-state sink)Return the current observable state of a result sink.
Return the current observable state of a result sink.
(synthetic-display-label entry token)Return a human progress label for a synthetic canonical entry.
Return a human progress label for a synthetic canonical entry.
(synthetic-token status ordinal)Return a synthetic suite-level display token for status and ordinal.
Return a synthetic suite-level display token for status and ordinal.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |