A Clojure babushka for the grey areas of Bash.
The main idea behind babashka is to leverage Clojure in places where you would be using bash otherwise.
As one user described it:
I’m quite at home in Bash most of the time, but there’s a substantial grey area of things that are too complicated to be simple in bash, but too simple to be worth writing a clj/s script for. Babashka really seems to hit the sweet spot for those cases.
- Fast starting Clojure scripting alternative for JVM Clojure
- Easy installation: grab the self-contained binary and run. No JVM needed.
- Familiar: targeted at JVM Clojure users
- Cross-platform: supports linux, macOS and Windows
- Interop with commonly used classes (
- Multi-threading support (
- Batteries included (tools.cli, cheshire, ...)
- Provide a mixed Clojure/Bash DSL (see portability).
- Replace existing shells. Babashka is a tool you can use inside existing shells like bash and it is designed to play well with them. It does not aim to replace them.
For installation options check Installation. For quick installation use:
$ bash < <(curl -s https://raw.githubusercontent.com/babashka/babashka/master/install)
or grab a binary from Github releases yourself and place it anywhere on the path.
Then you're ready to go:
$ ls | bb -i '(filter #(-> % io/file .isDirectory) *input*)'
("doc" "resources" "sci" "script" "src" "target" "test")
bb took 4ms.
Are you using babashka in your company or personal projects? Let us know here.
Babashka uses sci for interpreting Clojure. Sci implements a substantial subset of Clojure. Interpreting code is in general not as performant as executing compiled code. If your script takes more than a few seconds to run or has lots of loops, Clojure on the JVM may be a better fit as the performance on JVM is going to outweigh its startup time penalty. Read more about the differences with Clojure here.
java.lang can be considered stable and is unlikely to change. Changes may happen in other parts of babashka, although we will try our best to prevent them. Always check the release notes or CHANGELOG.md before upgrading.
To get an overview of babashka, you can watch this talk (slides):
The babashka book contains detailed information about how to get the most out of babashka scripting.
Read the output from a shell command as a lazy seq of strings:
$ ls | bb -i '(take 2 *input*)'
Read EDN from stdin and write the result to stdout:
$ bb '(vec (dedupe *input*))' <<< '[1 1 1 1 2]'
Read more about input and output flags here.
Execute a script. E.g. print the current time in California using the
(def now (java.time.ZonedDateTime/now))
(def LA-timezone (java.time.ZoneId/of "America/Los_Angeles"))
(def LA-time (.withZoneSameInstant now LA-timezone))
(def pattern (java.time.format.DateTimeFormatter/ofPattern "HH:mm"))
(println (.format LA-time pattern))
More examples can be found here.
You can try babashka online with Nextjournal's babashka notebook environment.
Linux and macOS binaries are provided via brew.
brew install borkdude/brew/babashka
brew upgrade babashka
babashka is available in the Arch User Repository. It can be installed using your favorite AUR helper such as yay, yaourt, apacman and pacaur. Here is an example using
yay -S babashka-bin
On Windows you can install using scoop and the scoop-clojure bucket.
Install via the installer script:
$ curl -sLO https://raw.githubusercontent.com/babashka/babashka/master/install
$ chmod +x install
By default this will install into
/usr/local/bin (you may need
sudo for this). To change this, provide the directory name:
$ ./install --dir .
To install a specific version, the script also supports
$ ./install --dir . --version 0.2.5
To force the download of the zip archive to a different directory than
/tmp use the
$ ./install --dir . --version 0.2.5 --download-dir .
You may also download a binary from Github. For linux there is a static binary available which can be used on Alpine.
Check out the image on Docker hub.
Check out the news page to keep track of babashka-related news items.
Go here to see the full list of built-in namespaces.
A list of projects (scripts, libraries, pods and tools) known to work with babashka.
Pods are programs that can be used as a Clojure library by babashka. Documentation is available in the pod library repo.
A list of available pods can be found here.
Babashka is implemented using the Small Clojure Interpreter. This means that a snippet or script is not compiled to JVM bytecode, but executed form by form by a runtime which implements a substantial subset of Clojure. Babashka is compiled to a native binary using GraalVM. It comes with a selection of built-in namespaces and functions from Clojure and other useful libraries. The data types (numbers, strings, persistent collections) are the same. Multi-threading is supported (
Differences with Clojure:
A pre-selected set of Java classes are supported. You cannot add Java classes at runtime.
Interpretation comes with overhead. Therefore loops are slower than in Clojure on the JVM. In general interpretation yields slower programs than compiled programs.
definterface and unboxed math.
defrecord are implemented using multimethods and regular maps. Ostensibly they work the same, but under the hood there are no Java classes that correspond to them.
reify works only for one class at a time
clojure.core.async/go macro is not (yet) supported. For compatibility it currently maps to
clojure.core.async/thread. More info here.
AWS Lambda runtime doesn't support signals, therefore babashka has to disable handling of SIGINT and SIGPIPE. This can be done by setting
- Automating Video Edits with Clojure and ffmpeg by Adam James
- Exporter for passwordstore.org by Eugen Stan
- Babashka and sci internals, a talk by Michiel Borkent at the London Clojurians Meetup.
- Writing Clojure on the Command Line with Babashka, a talk by Nate Jones.
- Using Clojure in Command Line with Babashka, a blog article by Kari Marttila.
- Babashka and GraalVM; taking Clojure to new places, a talk by Michiel Borkent at Clojure/NYC.
- Import a CSV into Kafka, using Babashka by Dave Martin
- Learning about babashka, a blog article by Andrew Montalenti
- Babashka Pods presentation by Michiel Borkent at the Dutch Clojure Meetup.
- AWS Logs using Babashka, a blog published by Toyokumo.
- The REPL podcast Michiel Borkent talks about clj-kondo, Jet, Babashka, and GraalVM with Daniel Compton.
- Implementing an nREPL server for babashka: impromptu presentation by Michiel Borkent at the online Dutch Clojure Meetup
- ClojureScript podcast with Jacek Schae interviewing Michiel Borkent
- Babashka talk at ClojureD (slides) by Michiel Borkent
- Babashka: a quick example by Malcolm Sparks
- Clojure Start Time in 2019 by Stuart Sierra
- Advent of Random Hacks by Arne Brasseur
- Clojure in the Shell by Arne Brasseur
- Clojure Tool by Eric Normand
Before new libraries or classes go into the standardly distributed babashka binary, these evaluation criteria are considered:
- The library or class is useful for general purpose scripting.
- Adding the library or class would make babashka more compatible with Clojure libraries relevant to scripting.
- The library cannot be interpreted by with babashka using
- The functionality can't be met by shelling out to another CLI or can't be written as a small layer over an existing CLI (like
- The library cannot be implemented a pod.
If not all of the criteria are met, but adding a feature is still useful to a particular company or niche, adding it behind a feature flag is still a possibility. This is currently the case for
next.jdbc and the
HSQLDB database drivers. Companies interested in these features can compile an instance of babashka for their internal use. Companies are also free to make forks of babashka and include their own internal libraries. If their customized babashka is interesting to share with the world, they are free to distribute it using a different binary name (like
bb-yourcompany, etc.). See the feature flag documentation and the implementation of the existing feature flags (example commit).
Thanks to all the people that contributed to babashka:
This project exists thanks to all the people who contribute. [Contribute].
Become a financial contributor and help us sustain our community. [Contribute]
Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]
Copyright © 2019-2020 Michiel Borkent
Distributed under the EPL License. See LICENSE.
This project contains code from:
- Clojure, which is licensed under the same EPL License.
Can you improve this documentation? These fine people already did:
Michiel Borkent, Arne Brasseur, Sameer Kolhar, Graham Carlyle, Gomotso Lilokoe, sogaiu, Rovanion Luckey, Chowlz, Édipo Féderle, Peter Nagy, Aleksandr Zhuravlёv, Jeff Evans, Dainius Jocas, Nikita Prokopov, Søren Sjørup, Teodor Heggelund, Eugen Stan, Martin Klepsch, c.p, Michael Wood, Will, miclill, Victor Bjelkholm, Peter Strömberg, Gabriel Horner, Nate Sutton, jess & David HarriganEdit on GitHub