com.blockether.spel.ci — com.blockether/spel 0.3.1

CI utilities for assembling Allure report sites.

Replaces Python scripts in GitHub Actions workflow with native Clojure.

Usage: spel ci-assemble --help spel ci-assemble --site-dir=gh-pages-site --run=123 ...

-main clj

(-main & args)

Main entry point for ci-assemble command.

finalize-build! clj

(finalize-build! {:keys [site-dir run-number passed]})

Update a build from in-progress to completed/failed. Removes the 'in_progress' status from builds-meta.json. Should be called before generate-builds-metadata! which will regenerate builds.json with full test results.

Options: :site-dir - path to gh-pages-site directory :run-number - CI run number (string) :passed - whether tests passed (boolean)

generate-builds-metadata! clj

(generate-builds-metadata! {:keys [site-dir run-number commit-sha commit-msg
                                   commit-author commit-ts tests-passed repo-url
                                   run-url version version-badge test-counts]})

Generate builds.json and update builds-meta.json with current run info.

Options: :site-dir - path to gh-pages-site directory :run-number - current CI run number :commit-sha - full commit SHA :commit-msg - commit message :commit-author - commit author name :commit-ts - commit timestamp (ISO 8601) :tests-passed - whether tests passed (boolean) :repo-url - repository URL :run-url - CI run URL :version - project version :version-badge - version badge type (release/candidate) :test-counts - map with :passed :failed :broken :skipped :total

parse-args clj

(parse-args args)

Parse CLI arguments into options map.

patch-allure-history! clj

(patch-allure-history! {:keys [history-file report-url commit-sha commit-msg
                               run-number]})

Patch .allure-history.jsonl with URL and commit info for the latest entry.

Options: :history-file - path to .allure-history.jsonl (default: .allure-history.jsonl) :report-url - URL to inject into latest entry :commit-sha - full commit SHA :commit-msg - commit message (first line used) :run-number - CI run number

patch-index-html! clj

(patch-index-html! {:keys [index-file logo-file title subtitle]})

Patch index.html with logo and title placeholders.

Options: :index-file - path to index.html :logo-file - path to logo.svg (optional) :title - title to inject (optional) :subtitle - subtitle to inject (optional)

register-build-start! clj

(register-build-start! {:keys [site-dir run-number commit-sha commit-msg
                               commit-author repo-url run-url version
                               version-badge]})

Register a build as in-progress. Adds entry to builds-meta.json and regenerates builds.json so the landing page shows a yellow 'In Progress' badge.

Options: :site-dir - path to gh-pages-site directory :run-number - CI run number (string) :commit-sha - full commit SHA :commit-msg - commit message :commit-author - commit author name :repo-url - repository URL :run-url - CI run URL :version - project version :version-badge - version badge type