Liking cljdoc? Tell your friends :D

hive.connectors.digest.announce

The release roundup, end to end: read every public library of the Maven group (Clojars artifact API for downloads and sibling dependencies, Maven metadata for the release date, GitHub for which repositories are public), sort it into tiers, render it, and post it to the announcement channel at most once per ISO week, with the raw text in a thread for Clojurians.

Effects arrive in deps, on top of the digest's: :list-artifacts! (fn [group]) -> artifact names :artifact-info! (fn [group artifact]) -> Clojars artifact JSON :public-repos! (fn [org]) -> {repo-name description} :fetch-text! (fn [url]) -> Maven metadata XML :post! :read-state :write-state!

The release roundup, end to end: read every public library of the Maven
group (Clojars artifact API for downloads and sibling dependencies, Maven
metadata for the release date, GitHub for which repositories are public),
sort it into tiers, render it, and post it to the announcement channel at
most once per ISO week, with the raw text in a thread for Clojurians.

Effects arrive in `deps`, on top of the digest's:
  :list-artifacts!  (fn [group]) -> artifact names
  :artifact-info!   (fn [group artifact]) -> Clojars artifact JSON
  :public-repos!    (fn [org]) -> {repo-name description}
  :fetch-text!      (fn [url]) -> Maven metadata XML
  :post! :read-state :write-state!
raw docstring

announce!clj

(announce! {:keys [post! read-state write-state!] :as deps}
           settings
           now
           {:keys [force?]})

Post this week's roundup unless the week already has one, or nothing was released since the last one. force? posts regardless. No libraries read means nothing is posted and nothing recorded.

Post this week's roundup unless the week already has one, or nothing was
released since the last one. `force?` posts regardless. No libraries read
means nothing is posted and nothing recorded.
sourceraw docstring

build!clj

(build! deps settings now [since-at since-label])

Read the libraries and render the roundup for releases after since, a [instant label] pair from since.

Read the libraries and render the roundup for releases after `since`,
a [instant label] pair from `since`.
sourceraw docstring

iso-weekclj

(iso-week now zone)

"2026-W40" for now in zone.

"2026-W40" for `now` in `zone`.
sourceraw docstring

libraries!clj

(libraries! {:keys [list-artifacts! public-repos!] :as deps}
            {:digest/keys [maven-group maven-repo org]})

Every library of the group whose repository is public. A library that cannot be read is an error line, not a missing tier.

Every library of the group whose repository is public. A library that
cannot be read is an error line, not a missing tier.
sourceraw docstring

preview!clj

(preview! {:keys [read-state] :as deps} settings now)
source

sinceclj

(since state settings now)

[instant label]: releases after the instant are fresh. The last roundup, or :announce/default-days (7 unless set) back when there was none, and the words the header uses for it.

[instant label]: releases after the instant are fresh. The last roundup,
or :announce/default-days (7 unless set) back when there was none, and
the words the header uses for it.
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