Liking cljdoc? Tell your friends :D

hive-addon.hot.failures

Addons a reload FAILED to load, and the refusal that keeps them out of the next one.

A reload whose namespace pass stops partway, or whose constructor namespace will not load, leaves the image half old and half new: protocols re-minted next to records and registries that were not. Remounting the addon on top of that hands it half-new code. Retrying the same reload on every git live pass re-mints protocols into the broken environment each time and spreads the half-loaded state further (card 20261118113047-64765ca8, axiom 20260824152125-5b78b916).

So a reload is all-or-nothing per addon. An addon whose code failed to load keeps its PREVIOUS instance mounted, untouched, and is marked :reload/failed here with the error. Every later reload whose slice reaches a marked addon is refused before any namespace is loaded, and the report says why. The mark is lifted by a restart (this state lives in the image), by a reload that asks for it (:retry-failed? or :force?), or by a reload that mounts the addon's new code successfully.

Pure apart from the one atom; the clock is the caller's.

Addons a reload FAILED to load, and the refusal that keeps them out of the
next one.

A reload whose namespace pass stops partway, or whose constructor namespace
will not load, leaves the image half old and half new: protocols re-minted
next to records and registries that were not. Remounting the addon on top
of that hands it half-new code. Retrying the same reload on every `git live`
pass re-mints protocols into the broken environment each time and spreads
the half-loaded state further (card 20261118113047-64765ca8, axiom
20260824152125-5b78b916).

So a reload is all-or-nothing per addon. An addon whose code failed to load
keeps its PREVIOUS instance mounted, untouched, and is marked :reload/failed
here with the error. Every later reload whose slice reaches a marked addon is
refused before any namespace is loaded, and the report says why. The mark is
lifted by a restart (this state lives in the image), by a reload that asks
for it (:retry-failed? or :force?), or by a reload that mounts the addon's
new code successfully.

Pure apart from the one atom; the clock is the caller's.
raw docstring

blockedclj/s

(blocked seeds closure marked)

Pure. {seed [marked-id ...]} for the seeds whose reload closure (closure seed -> #{id ...}, the seed included) reaches an addon in marked (a set or map keyed by id). Seeds with no marked addon in reach are absent.

Pure. {seed [marked-id ...]} for the seeds whose reload closure (`closure`
seed -> #{id ...}, the seed included) reaches an addon in `marked` (a set or
map keyed by id). Seeds with no marked addon in reach are absent.
sourceraw docstring

clear!clj/s

(clear!)
(clear! ids)

Lift the mark from ids (every mark when called with no ids). Returns the remaining marks.

Lift the mark from `ids` (every mark when called with no ids). Returns the
remaining marks.
sourceraw docstring

failed-lineclj/s

(failed-line ids {:reload/keys [phase error failed-ns]})

The plain sentence a reload that marks ids failed reports.

The plain sentence a reload that marks `ids` failed reports.
sourceraw docstring

failed?clj/s

(failed? id)

Is id marked :reload/failed?

Is `id` marked :reload/failed?
sourceraw docstring

failuresclj/s

(failures)

{addon-id mark} of every addon currently marked :reload/failed.

{addon-id mark} of every addon currently marked :reload/failed.
sourceraw docstring

next-marksclj/s

(next-marks marks report now)

Pure. The marks after report (a RemountReport) ran at now.

Ids under :hot/reload-failures are marked (attempts counted up from any earlier mark); ids whose NEW instance mounted (a :mounted row with :success? true) are cleared. Everything else keeps its mark.

Pure. The marks after `report` (a RemountReport) ran at `now`.

Ids under :hot/reload-failures are marked (attempts counted up from any
earlier mark); ids whose NEW instance mounted (a :mounted row with
:success? true) are cleared. Everything else keeps its mark.
sourceraw docstring

record!clj/s

(record! report now)

Fold report into the marks at now (epoch ms). Returns the marks.

Fold `report` into the marks at `now` (epoch ms). Returns the marks.
sourceraw docstring

refusal-lineclj/s

(refusal-line seed hits marks)

The plain sentence a refused seed reports.

The plain sentence a refused seed reports.
sourceraw docstring

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts
Ctrl+kJump to recent docs
←Move to previous article
→Move to next article
Ctrl+/Jump to the search field
× close