babashka

name

babashka

description

Babashka scripting conventions for the Epupp project. Use when: writing or modifying bb.edn tasks, scripts in scripts/, build or test automation, choosing between bb and npx/npm/shell/Python, using babashka.fs, babashka.process, or babashka.http-client, or running any bb command in this repo. Prefer bb tasks over direct npm/npx; keep bb.edn minimal and put code in scripts/tasks.clj. IMPORTANT: Also load when planning automation or build pipeline changes.

Using Babashka in This Project

This project uses Babashka, a fast-starting Clojure interpreter for scripting and automation.

bb Tasks

Don't put anything but the minimum code snippets in bb.edn. Use scripts/tasks.clj for code and call them from bb tasks.

Babashka utilities

Prefer Babashka built-in utilities over Python, shell scripts, or other external tools when functionality overlaps. The project uses Babashka extensively and has dependencies loaded.

Common replacements:

• HTTP server: Use bb test:server or babashka.http-server instead of python -m http.server
• File operations: Use babashka.fs instead of shell commands (cp, mv, rm, find, etc.)
• Process execution: Use babashka.process instead of raw shell scripts
• HTTP requests: Use babashka.http-client instead of curl or wget

Check bb.edn dependencies and existing tasks before reaching for external tools.