fx-explore

Sandestin Effect Explorer

Discover and understand available effects, actions, and placeholders.

Important: All discoverability functions operate on the dispatch function, not registries. You must first create a dispatch via (s/​create-dispatch [registries...]) before using these functions.

About Sandestin

Sandestin is a Clojure effect dispatch library with schema-driven discoverability. Effects are dispatched as vectors like [:myapp/​save-user {:name "Alice"}].

GitHub: https://github.com/brianium/sandestin

Check if Installed

Look for the dependency in deps.edn:

io.github.brianium/​sandestin {:git/​tag "v0.3.0" :git/​sha "2be6acc"}

Install if Missing

Add to deps.edn under :deps:

{:deps
 {io.github.brianium/​sandestin {:git/​tag "v0.3.0" :git/​sha "2be6acc"}}}

Workflow

1. Find the Dispatch

Search for create-dispatch to locate the project's dispatch namespace.

2. Explore via REPL

(require '[ascolais.sandestin :as s])
(require '[<dispatch-ns> :refer [dispatch]])

;; List everything
(s/​describe dispatch)

;; Filter by type
(s/​describe dispatch :effects)
(s/​describe dispatch :actions)
(s/​describe dispatch :placeholders)

;; Search by keyword
(s/​grep dispatch "user")
(s/​grep dispatch #"save|create")

;; Get details on specific item
(s/​describe dispatch :some.ns/​effect-name)

;; Generate sample invocation
(s/​sample dispatch :some.ns/​effect-name)

;; See system requirements
(s/​system-schema dispatch)

Output Format

Summarize findings:

### Effects

**:myapp.db/​query** - Execute a SQL query
  Requires: [:datasource]
  Example: [:myapp.db/​query "SELECT * FROM users" 42]

### Actions

**:myapp.user/​create** - Create user and send welcome email
  Expands to: db insert + email send

Key Functions