phel-lang Phel Patterns
Core Library Structure (src/phel/)
| Module | Purpose |
|---|---|
core.phel |
Fundamental functions (map, filter, reduce, etc.) |
string.phel |
String manipulation |
html.phel |
HTML generation |
http.phel |
HTTP request/response |
json.phel |
JSON encoding/decoding |
test.phel |
Test framework (deftest, is, are) |
pprint.phel |
Pretty printing |
walk.phel |
Tree walking (postwalk, prewalk) |
mock.phel |
Mocking utilities for tests |
reflect.phel |
PHP reflection / attribute bridging |
repl.phel |
REPL functionality |
base64.phel |
Base64 encoding/decoding |
Common Idioms
; Function definition with metadata
(defn my-fn
{:doc "Description of what it does"
:see-also ["related-fn" "other-fn"]
:example "(my-fn arg) => result"}
[arg]
(body))
; Private function (not exported)
(defn- helper-fn [x] ...)
; Struct definition
(defstruct my-struct [field-a field-b])
; Threading macros
(-> value (fn1 arg) (fn2 arg)) ; thread-first
(->> value (fn1 arg) (fn2 arg)) ; thread-last
Testing Patterns
(ns phel-test.module-name
(:require phel.test :refer [deftest is are]))
(deftest test-descriptive-name
(is (= expected (function-under-test input)))
(is (thrown? Exception (function-that-throws))))
Run: ./bin/phel test (all) or ./bin/phel test tests/phel/<file> (specific)
Conventions
conjoverputfor collections- Keyword arguments via maps:
(fn opts)not positional args - Destructuring in
letandfnparameter lists - Prefer pure functions, isolate side effects