Command-line and clojure -X entry points for scry.
Command-line and `clojure -X` entry points for scry.
(run opts)clojure -X entry point for the scry CLI.
Normalizes EDN options, runs the shared CLI implementation, and returns the
successful outcome. Throws ex-info with structured outcome data when the CLI
run is non-zero so clojure -X exits non-zero without calling System/exit.
Returned outcome data includes the test :summary, :result-files, and
:scry.cli/outcome-kind when a run reaches normal classification. Completed
concrete failure/error entries are synchronously published as atomic final
.edn artifacts before the next test var begins; synthetic entries and
missed publications are reconciled after a normal runner return. A catchable
runner error preserves already published final paths in :result-files.
Contained artifact-publication failures preserve the test-derived outcome and
add bounded top-level :scry.cli/diagnostic-error metadata only while an
artifact remains unresolved. Its :phase is
:incremental-result-file-writing when the runner throws before returning,
otherwise :final-result-file-reconciliation. The diagnostic map has stable
inspectable keys: :phase, :message, :type, :root-type,
:root-message, and :failed-entry-count; when derivable it also includes
:first-failing-var and :first-root-cause.
clojure -X invokes the exec fn with nil when no :exec-args/key-value
overrides are supplied, so a bare clojure -X:alias (alias sets only
:exec-fn) arrives here as nil; treat that as an empty options map.
`clojure -X` entry point for the scry CLI. Normalizes EDN options, runs the shared CLI implementation, and returns the successful outcome. Throws ex-info with structured outcome data when the CLI run is non-zero so `clojure -X` exits non-zero without calling System/exit. Returned outcome data includes the test `:summary`, `:result-files`, and `:scry.cli/outcome-kind` when a run reaches normal classification. Completed concrete failure/error entries are synchronously published as atomic final `.edn` artifacts before the next test var begins; synthetic entries and missed publications are reconciled after a normal runner return. A catchable runner error preserves already published final paths in `:result-files`. Contained artifact-publication failures preserve the test-derived outcome and add bounded top-level `:scry.cli/diagnostic-error` metadata only while an artifact remains unresolved. Its `:phase` is `:incremental-result-file-writing` when the runner throws before returning, otherwise `:final-result-file-reconciliation`. The diagnostic map has stable inspectable keys: `:phase`, `:message`, `:type`, `:root-type`, `:root-message`, and `:failed-entry-count`; when derivable it also includes `:first-failing-var` and `:first-root-cause`. `clojure -X` invokes the exec fn with `nil` when no `:exec-args`/key-value overrides are supplied, so a bare `clojure -X:alias` (alias sets only `:exec-fn`) arrives here as `nil`; treat that as an empty options map.
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 |