Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
@bobisageek
Latest commit d8a0018 Nov 13, 2022 History
* add lib test for sluj (#1269)

* changelog

* add sluj to projects.md
7 contributors

Users who have contributed to this file

@borkdude @bobisageek @cldwalker @lispyclouds @The-Alchemist @brandonstubbs @bhb

Projects

The following libraries and projects are known to work with babashka.

Also keep an eye on the news page for new projects, gists and other developments around babashka.

Libraries

For a full list of libraries, see libraries.csv. To add a library, see these instructions.

tools.namespace

A fork of tools.namespace. This is used by other libraries and enables them to be supported by babashka.

test-runner

This library works with the tools.namespace fork. See its readme for an example task for running tests.

spec.alpha

A fork of clojure.spec.alpha that includes support for generation and instrumentation! Its readme also contains instructions on how to use clojure.core.specs.alpha.

clj-http-lite

Example:

$ export BABASHKA_CLASSPATH="$(clojure -Sdeps '{:deps {org.clj-commons/clj-http-lite {:mvn/version "0.4.392"}}}' -Spath)"

$ bb "(require '[clj-http.lite.client :as client]) (:status (client/get \"https://www.clojure.org\"))"
200

spartan.spec

An babashka-compatible implementation of clojure.spec.alpha. See spec.alpha for a more complete implementation.

missing.test.assertions

This library checks if no assertions have been made in a test:

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {borkdude/missing.test.assertions {:git/url "https://github.com/borkdude/missing.test.assertions" :sha "603cb01bee72fb17addacc53c34c85612684ad70"}}}')

$ lein bb "(require '[missing.test.assertions] '[clojure.test :as t]) (t/deftest foo) (t/run-tests)"

Testing user
WARNING: no assertions made in test foo

Ran 1 tests containing 0 assertions.
0 failures, 0 errors.
{:test 1, :pass 0, :fail 0, :error 0, :type :summary}

medley

Example:

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {medley/medley {:mvn/version "1.3.0"}}}')

$ bb -e "(require '[medley.core :as m]) (m/index-by :id [{:id 1} {:id 2}])"
{1 {:id 1}, 2 {:id 2}}

limit-break

A debug REPL library.

Latest coordinates checked with with bb:

{:git/url "https://github.com/technomancy/limit-break" :sha "050fcfa0ea29fe3340927533a6fa6fffe23bfc2f" :deps/manifest :deps}

Example:

$ export BABASHKA_CLASSPATH="$(clojure -Sdeps '{:deps {limit-break {:git/url "https://github.com/technomancy/limit-break" :sha "050fcfa0ea29fe3340927533a6fa6fffe23bfc2f" :deps/manifest :deps}}}' -Spath)"

$ bb "(require '[limit.break :as lb]) (let [x 1] (lb/break))"
Babashka v0.0.49 REPL.
Use :repl/quit or :repl/exit to quit the REPL.
Clojure rocks, Bash reaches.

break> x
1

clojure-csv

A library for reading and writing CSV files. Note that babashka already comes with clojure.data.csv, but in case you need this other library, this is how you can use it:

export BABASHKA_CLASSPATH="$(clojure -Sdeps '{:deps {clojure-csv {:mvn/version "RELEASE"}}}' -Spath)"

./bb -e "
(require '[clojure-csv.core :as csv])
(csv/write-csv (csv/parse-csv \"a,b,c\n1,2,3\"))
"

regal

Example:

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {lambdaisland/regal {:mvn/version "0.0.143"}}}')

$ bb -e "(require '[lambdaisland.regal :as regal]) (regal/regex [:* \"ab\"])"
#"(?:\Qab\E)*"

cprop

A clojure configuration library. Latest test version: "0.1.16".

comb

Simple templating system for Clojure. Latest tested version: "0.1.1".

(require '[babashka.deps :as deps])

(deps/add-deps '{:deps {comb/comb {:mvn/version "0.1.1"}}})

(require '[comb.template :as template])

(template/eval "<% (dotimes [x 3] %>foo<% ) %>") ;;=> "foofoofoo"

nubank/docopt

Docopt implementation in Clojure, compatible with babashka.

arrangement

A micro-library which provides a total-ordering comparator for Clojure values. Tested with version 1.2.0.

clojure.math.combinatorics

$ bb --classpath "$(clojure -Spath -Sdeps '{:deps {org.clojure/math.combinatorics {:mvn/version "0.1.6"}}}')" \
     -e "(use 'clojure.math.combinatorics) (permutations [:a :b])"
((:a :b) (:b :a))

testdoc

Yet another doctest implementation in Clojure.

$ export BABASHKA_CLASSPATH=$(clojure -Sdeps '{:deps {testdoc {:mvn/version "1.2.0"}}}' -Spath)

$ bb '(ns foo (:use clojure.test testdoc.core))
(defn foo "
  => (foo)
  :foox"
  [] :foo)

(deftest footest
  (is (testdoc (var foo))))

(test-var (var footest))'

FAIL in (footest) (:1)
(= (foo) :foox)
expected: :foox
  actual: :foo

doric

Library for printing tables.

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {doric {:mvn/version "0.9.0"}}}')
$ bb "(use 'doric.core) (println (table [:a :b :c] [{:a 1 :b 2 :c 3} {:a 4 :b 5 :c 6}]))"
|---+---+---|
| A | B | C |
|---+---+---|
| 1 | 2 | 3 |
| 4 | 5 | 6 |
|---+---+---|

clojure.data.zip

Utilities for clojure.zip, among other things a more fluent way to work with xml.

Small sample:

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {org.clojure/data.zip {:mvn/version "1.0.0"}}}')

$ cat data_zip_xml.clj
(require '[clojure.data.xml :as xml])
(require '[clojure.zip :as zip])
(require '[clojure.data.zip.xml :refer [text attr attr= xml-> xml1-> text=]])

(def data (str "<root>"
               "  <character type=\"person\" name=\"alice\" />"
               "  <character type=\"animal\" name=\"march hare\" />"
               "</root>"))

(let [xml  (-> data java.io.StringReader. xml/parse zip/xml-zip)]
  (prn :alice-is-a (xml1-> xml :character [(attr= :name "alice")] (attr :type)))
  (prn :animal-is-called (xml1-> xml :character [(attr= :type "animal")] (attr :name))))

$ bb data_zip_xml.clj
:alice-is-a "person"
:animal-is-called "march hare"

(see for exaple this article for more on clojure.data.zip).

clj-psql

A small Clojure wrapper for interacting with psql.

user> (psql/query conn "select name, subject from grades where grade = 100")
   => ({:name "Bobby Tables", :subject "Math"}
       {:name "Suzy Butterbean", :subject "Math"})

camel-snake-kebab

A library for word case conversions.

(require '[babashka.deps :as deps])

(deps/add-deps '{:deps {camel-snake-kebab/camel-snake-kebab {:mvn/version "0.4.2"}}})

(require '[camel-snake-kebab.core :as csk])

(csk/->camelCase 'flux-capacitor) ;;=> 'fluxCapacitor

aero

A small library for explicit, intentful configuration.

clojure.data.generators

Random data generators

honeysql

Turn Clojure data structures into SQL

bond

Spying and stubbing library, primarily intended for tests.

portal

A clojure tool to navigate through your data. This example will launch a browser to view your deps.edn:

$ cat deps.edn | bb -e "(babashka.deps/add-deps '{:deps {djblue/portal {:mvn/version \"0.9.0\"}}})" \
                    -e "(require 'portal.main)" \
                    -e '(portal.main/-main "edn")'

Also see examples.

version-clj

Analysis and comparison of artifact version numbers.

> export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {version-clj/version-clj {:mvn/version "0.1.2"}}}')
> bb --repl
...
user=> (require '[version-clj.core :as ver])
nil
user=> (ver/version->seq "1.0.0-SNAPSHOT")
[(1 0 0) ["snapshot"]]
user=> (ver/version-compare "1.2.3" "1.0.0")
1
user=> (ver/version-compare "1.0.0-SNAPSHOT" "1.0.0")
-1
user=> (ver/version-compare "1.0" "1.0.0")
0

matchete

Pattern matching library:

$ rlwrap bb -cp "$(clojure -Spath -Sdeps '{:deps {io.xapix/matchete {:mvn/version "1.2.0"}}}')"
user=> (require '[matchete.core :as mc])
nil
user=> (mc/matches '{?k 1} {:x 1 :y 1})"
({?k :y} {?k :x})

progrock

A functional Clojure progress bar for the command line.

Tested version: 0.1.2.

clj-commons/fs

File system utilities for Clojure.

(require '[babashka.deps :as deps])

(deps/add-deps '{:deps {clj-commons/fs {:mvn/version "1.5.2"}}})

(require '[me.raynes.fs :as fs])

(fs/link? "/tmp") ;; true

cljc.java-time

(require '[babashka.deps :as deps])

(deps/add-deps '{:deps {cljc.java-time/cljc.java-time {:mvn/version "0.1.12"}}})

(require  '[cljc.java-time.local-date :as ld])

(def a-date (ld/parse "2019-01-01"))

(ld/plus-days a-date 99)

environ

Library for managing environment variables in Clojure.

(require '[babashka.deps :as deps])

(babashka.deps/add-deps '{:deps {environ/environ {:mvn/version "1.2.0"}}})

(require '[environ.core :refer [env]])

(prn (:path env))

gaka

(ns script
  (:require [babashka.deps :as deps]))

(deps/add-deps '{:deps {gaka/gaka {:mvn/version "0.3.0"}}})

(require '[gaka.core :as gaka])

(def rules [:div#foo
            :margin "0px"
            [:span.bar
             :color "black"
             :font-weight "bold"
             [:a:hover
              :text-decoration "none"]]])

(println (gaka/css rules))

Output:

div#foo {
  margin: 0px;}

  div#foo span.bar {
    color: black;
    font-weight: bold;}

    div#foo span.bar a:hover {
      text-decoration: none;}

failjure

Working with failed computations in Clojure.

(require '[babashka.deps :as deps])

(deps/add-deps '{:deps {failjure/failjure {:mvn/version "2.1.1"}}})

(require '[failjure.core :as f])

(f/fail "foo")

pretty

The io.aviso.ansi namespace provides ANSI font and background color support.

(require '[babashka.deps :as deps])

(deps/add-deps
 '{:deps {io.aviso/pretty {:mvn/version "0.1.36"}}})

(require '[io.aviso.ansi :as ansi])

(println
 (str "The following text will be "
      ansi/bold-red-font "bold and red "
      ansi/reset-font "but this text will not."))

clojure-term-colors

Clojure ASCII color formatting for terminal output.

(require '[babashka.deps :as deps])

(deps/add-deps
 '{:deps {clojure-term-colors/clojure-term-colors {:mvn/version "0.1.0"}}})

(require '[clojure.term.colors :as c])

(println
 (c/yellow "Yellow")
 (c/red "Red")
 "No color")

binf

Handling binary formats in all shapes and forms.

rewrite-edn

Rewrite EDN with preservation of whitespace, based on rewrite-clj.

Example:

#!/usr/bin/env bb

(require '[babashka.deps :as deps])
(deps/add-deps '{:deps {borkdude/rewrite-edn {:mvn/version "0.0.2"}}})
(require '[borkdude.rewrite-edn :as r])

(def edn-string (slurp "deps.edn"))
(def nodes (r/parse-string edn-string))

(println (str (r/assoc-in nodes [:deps 'my-other-dep] {:mvn/version "0.1.2"})))

expound

Formats spartan.spec error messages in a way that is optimized for humans to read.

Example:

#!/usr/bin/env bb

(ns expound
  (:require [babashka.deps :as deps]))

(deps/add-deps
 '{:deps {borkdude/spartan.spec {:git/url "https://github.com/borkdude/spartan.spec"
                                 :sha "bf4ace4a857c29cbcbb934f6a4035cfabe173ff1"}
          expound/expound {:mvn/version "0.8.9"}}})

;; Loading spartan.spec will create a namespace clojure.spec.alpha for compatibility:
(require 'spartan.spec)
(alias 's 'clojure.spec.alpha)

;; Expound expects some vars to be there, like `fdef`. Spartan prints warnings that these are used, but doesn't implement them yet.
(require '[expound.alpha :as expound])

(s/def ::a (s/cat :i int? :j string?))

(expound/expound ::a [1 2])

omniconf

script.clj:

#!/usr/bin/env bb

(ns script
  (:require [babashka.deps :as deps]))

(deps/add-deps
 '{:deps {com.grammarly/omniconf {:mvn/version "0.4.3"}}})

(require '[omniconf.core :as cfg])
(cfg/define {:foo {}})
(cfg/populate-from-env)
(cfg/get :foo)
FOO=1 script.clj
Populating Omniconf from env: 1 value(s)
"1"

slingshot

Enhanced try and throw for Clojure leveraging Clojure's capabilities.

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {slingshot/slingshot {:mvn/version "0.12.2"}}}')
$ bb -e "(require '[slingshot.slingshot :as s]) (s/try+ (s/throw+ {:type ::foo}) (catch [:type ::foo] [] 1))"
1

NOTE: slingshot's tests pass with babashka except one: catching a record types by name. This is due to a difference in how records are implemented in babashka. This may be fixed later if this turns out to be really useful.

hasch

Cross-platform (JVM and JS atm.) edn data structure hashing for Clojure.

$ export BABASHKA_CLASSPATH=$(clojure -Spath -Sdeps '{:deps {io.replikativ/hasch {:mvn/version "0.3.7"}}}')
$ bb -e "(use 'hasch.core) (edn-hash (range 100))"
(168 252 48 247 180 148 51 182 108 76 20 251 155 187 66 8 124 123 103 28 250 151 26 139 10 216 119 168 101 123 130 225 66 168 48 63 53 99 25 117 173 29 198 229 101 196 162 30 23 145 7 166 232 193 57 239 226 238 240 41 254 78 135 122)

NOTE: hasch's tests pass with babashka except the test around hashing records. This is due to a difference in how records are implemented in babashka. This may be fixed later if this turns out to be really useful.

crispin

Populate a configuration map from multiple sources (environment variables, system variables, config files, etc.)

Example:

script.clj

#!/usr/bin/env bb

(ns script
  (:require [babashka.deps :as deps]))

(deps/add-deps
 '{:deps {crispin/crispin {:mvn/version "0.3.8"}}})

(require '[crispin.core :as crispin])
(def app-cfg (crispin/cfg))
(app-cfg :foo)
FOO=1 script.clj
"1"

ffclj

A wrapper around executing ffmpeg and ffprobe. Supports progress reporting via core.async channels.

multigrep

Regex-based file grepping and/or text substitution.

Example:

  • find the words that are exactly four letters long in some strings:
(ns multigrep-demo
  (:require [babashka.deps :as deps]
            [clojure.pprint :refer [pprint]])
  (:import (java.io StringReader)))

(deps/add-deps '{:deps {clj-commons/multigrep {:mvn/version "0.5.0"}}})

(require '[multigrep.core :as grep])

; the StringReaders could be anything that clojure.java.io/reader will accept (files, URLs, etc.)
(let [sentence1 (StringReader. "the quick brown fox jumps over the lazy dog")
      sentence2 (StringReader. "Lorem ipsum dolor sit amet")]
  (pprint (grep/grep #"\b[a-z]{4}\b" [sentence1 sentence2])))

outputs:

({:file
  #object[java.io.StringReader...],
  :line "the quick brown fox jumps over the lazy dog",
  :line-number 1,
  :regex #"\b[a-z]{4}\b",
  :re-seq ("over" "lazy")}
 {:file
  #object[java.io.StringReader...],
  :line "Lorem ipsum dolor sit amet",
  :line-number 1,
  :regex #"\b[a-z]{4}\b",
  :re-seq ("amet")})

java-http-clj

Http client based on java.net.http.

component

A tiny Clojure framework for managing the lifecycle and dependencies of software components which have runtime state.

minimallist

A minimalist data-driven data model library, inspired by Clojure Spec and Malli.

Example partially borrowed from minimallist's cljdoc

(require '[babashka.deps :refer [add-deps]])


(add-deps '{:deps {minimallist/minimallist {:git/url "https://github.com/green-coder/minimallist"
                                            :sha     "b373bb18b8868526243735c760bdc67a88dd1e9a"}}})

(require '[minimallist.core :as m])
(require '[minimallist.helper :as h])

(def contact (h/map [:name  (h/fn string?)]
                    [:phone (h/fn string?)]))
(m/valid? contact {:name "Lucy" :phone "5551212"})   ;=> true
(m/valid? contact {:name "Lucy" :phone 5551212}) ;=> false

(m/describe contact {:name "Lucy" :phone "5551212"})   ;=> {:valid? true, :entries {...}}
(m/describe contact {:name "Lucy" :phone 5551212}) ;=> {:valid? false, :entries {... :phone {:valid? false...}}}

;; Does not work for now.
;(require '[clojure.test.check.generators :as tcg])
;(require '[minimallist.generator :as mg])
;(tcg/sample (mg/gen (h/fn int?)))

ruuter

A zero-dependency router where each route is a map. Works with the httpkit server built into babashka.

clj-commons.digest

A message digest library, providing functions for MD5, SHA-1, SHA-256, etc.

contajners

An idiomatic, data-driven, REPL friendly clojure client for OCI container engines.

Example:

#!/usr/bin/env bb

(require '[babashka.deps :as deps])

(deps/add-deps '{:deps {org.clojars.lispyclouds/contajners {:mvn/version "0.0.6"}}})

(require '[contajners.core :as c])

(def images-docker (c/client {:engine   :docker
                              :category :images
                              :version  "v1.41"
                              :conn     {:uri "unix:///var/run/docker.sock"}}))

; Pull an image
(c/invoke images-docker {:op     :ImageCreate
                         :params {:fromImage "busybox:musl"}})

; list all images
(c/invoke images-docker {:op :ImageList})

dependency

Represent dependency graphs as a directed acylic graph.

specmonstah

Write concise, maintainable test fixtures with clojure.spec.alpha.

markdown-clj

Markdown parser that translates markdown to html.

algo.monads

Macros for defining monads, and definition of the most common monads.

datalog-parser

Datalog parser that is compliant with datomic, datascript and datahike.

at-at

Ahead-of-time function scheduler. Compatible with babashka 0.7.7+.

aysylu/loom

Graph library for Clojure. Compatible with babashka 0.7.8+.

Clarktown

An extensible and modular zero-dependency, pure-Clojure Markdown parser.

Malli

Data-Driven Schemas for Clojure/Script

Meander

Tools for transparent data transformation

Schema

Clojure(Script) library for declarative data description and validation

Sluj

Sluj is a very small library for converting strings of UTF-16 text to slugs. A slug is a piece of text that is URL safe.

Pods

Babashka pods are programs that can be used as Clojure libraries by babashka. See pod-registry for an overview of available pods.

Pods not available in the pod registry:

Projects

babashka-test-action

Github Action to run clojure.test by Babashka.

deps.clj

A port of the clojure bash script to Clojure / babashka.

Also see deps.clj documentation.

4bb

4clojure as a babashka script!

babashka lambda layer

Babashka Lambda runtime packaged as a Lambda layer.

Release on push Github action

Github Action to create a git tag + release when pushed to master. Written in babashka.

justone/bb-scripts

A collection of scripts developed by @justone.

nativity

Turn babashka scripts into binaries using GraalVM native-image.

cldwalker/bb-clis

A collection of scripts developed by @cldwalker.

krell template

Babashka script for creating React Native (Krell) project

wee-httpd

A wee multi-threaded web server

covid19-babashka

A babashka script to obtain covid-19 related information.

bb-spotify

Control your spotify player using babashka.

lambdaisland/open-source

Internal tooling used by Lambda Island projects. Noteworthy: a babashka-compatible hiccup script.

There's also subshell which is like sh/sh, but it inherits stdin/stdout/stderr, so that the user sees in real time what the subprocess is doing, and can possibly interact with it. More like how shelling out in a bash script works.

dharrigan/spotifyd-notification

An example of using babashka to show spotifyd notifications via dunst.

nextjournal/ssh-github-auth

A babashka script which uses github auth to fetch SSH public keys. It can be useful to ensure only a certain team of people can access machines with SSH.

turtlequeue/setup-babashka

Github Action to install Babashka in your workflows. Useful to run bb scripts in your CI.

interdep

Manage interdependent dependencies using Clojure's tools.deps and babashka.

sha-words

A clojure program to turn a sha hash into list of nouns in a predictable jar.

adam-james-v/scripts

A collection of useful scripts. Mainly written with Clojure/babashka

oidc-client

Tired of being forced to use the browser every time you need to refresh an OIDC token to authenticate with a backend service? Finally there is a CLI tool for that - the babashka and Docker powered oidc_client.clj.

Upon first invocation it opens up a browser for the OIDC provider login, thereafter it caches the refresh token and uses it as long as it remains valid.

jirazzz

A babashka JIRA client by Randy Stauner

Babashka + scittle guestbook

Luminus guestbook example for Babashka + Scittle.

bb htmx todo app

Quick example of a todo list SPA using Babashka and htmx.

bb aws lambda runtime

AWS Lambda custom runtime for Babashka scripts.

bb-github-app

An example Babashka script that can authenticate as a Github Application, this example focuses on the checks api.