From e6e82906f4679c405f68400585019a98c5100e91 Mon Sep 17 00:00:00 2001
From: Ben Brinckerhoff <ben@bbrinck.com>
Date: Sun, 25 Apr 2021 09:02:32 -0600
Subject: [PATCH] Adds Expound to projects.md (#803) [skip ci]

---
 doc/projects.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/doc/projects.md b/doc/projects.md
index 93f9e405..4194eef8 100644
--- a/doc/projects.md
+++ b/doc/projects.md
@@ -38,6 +38,7 @@ The following libraries and projects are known to work with babashka.
     - [clojure-term-colors](#clojure-term-colors)
     - [binf](#binf)
     - [rewrite-edn](#rewrite-edn)
+    - [expound](#expound)
   - [Pods](#pods)
   - [Projects](#projects-1)
     - [babashka-test-action](#babashka-test-action)
@@ -514,6 +515,35 @@ Example:
 (println (str (r/assoc-in nodes [:deps 'my-other-dep] {:mvn/version "0.1.2"})))
 ```
 
+### [expound](https://github.com/bhb/expound)
+
+Formats `spartan.spec` error messages in a way that is optimized for humans to read.
+
+Example:
+
+``` clojure
+#!/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])
+```
+
 ## Pods
 
 [Babashka pods](https://github.com/babashka/babashka.pods) are programs that can