6445f461bb
The dashboard's missing-portable category is now EMPTY (was 35 when the issue was filed; this session's io/leaf work had already landed most of them). The final seven: - extenders — ctx-capturing clojure.core fn over the protocol type-registry: the type-tags implementing a protocol, as symbols; nil when none - find-keyword — keyword: jolt keywords have no intern table, so it always finds (babashka makes the same call) - inst-ms* — the raw Inst method; one inst representation, so = inst-ms - read+string — over the 50-io readers, which now expose :buf and :fill-fn; returns [form exact-text-consumed], EOF throws or yields [eof-value ""] with the 3-arity, works for string AND stdin readers - with-local-vars — fresh free-standing var cells (__local-var seam) bound as locals; var-get/var-set work on any cell - with-open — canonical recursive expansion closing through the __close seam: a map-like value's :close fn or a host file (no .close interop here); nested closes run inner-first, finally runs on throw - with-precision — body evaluates with precision/:rounding accepted and ignored (doubles, no BigDecimal context) — documented divergence 30 new spec rows (test/spec/missing-vars-spec.janet); coverage.md regenerated: implemented+tested 426 -> 433, missing-portable 7 -> 0. Gate: jpm exit 0, all tests passed.
359 lines
16 KiB
Clojure
359 lines
16 KiB
Clojure
;; clojure.core — macro tier. Macros expressed in Clojure (defmacro + syntax-quote)
|
|
;; rather than as hand-built Janet form-transformers. Loaded after the fn tiers,
|
|
;; so a macro here may use any already-frozen core fn/macro.
|
|
;;
|
|
;; IMPORTANT — only macros NOT used by the self-hosted compiler (jolt-core/jolt/*)
|
|
;; or by the earlier overlay tiers belong here; those (and/or/when/when-not/
|
|
;; when-let/cond/case/doseq/declare/cond->/->) must stay available before this
|
|
;; tier loads, so they remain in Janet for now. Everything here is user-facing.
|
|
;;
|
|
;; Migration: remove the Janet core-X macro fn AND its core-macro-names entry when
|
|
;; moving a macro here (defmacro installs the :macro flag itself).
|
|
|
|
(defmacro comment [& body] nil)
|
|
|
|
;; with-out-str: capture everything the body prints to *out* and return it as a
|
|
;; string. __with-out-str (clojure.core) runs the thunk with the output captured.
|
|
(defmacro with-out-str [& body]
|
|
`(__with-out-str (fn* [] ~@body)))
|
|
|
|
;; defmulti/defmethod are sugar over defmulti-setup/defmethod-setup (ctx-capturing
|
|
;; clojure.core fns) so they compile as plain invokes. name/mm are passed quoted;
|
|
;; the dispatch fn, options, and dispatch value evaluate normally, and the method
|
|
;; body becomes a compiled (fn …).
|
|
(defmacro defmulti [name dispatch & opts]
|
|
`(defmulti-setup (quote ~name) ~dispatch ~@opts))
|
|
|
|
(defmacro defmethod [mm dispatch-val & fn-tail]
|
|
`(defmethod-setup (quote ~mm) ~dispatch-val (fn ~@fn-tail)))
|
|
|
|
;; Multimethod table ops (tier 6c): a multimethod's method table lives on its
|
|
;; VAR (the value is just the dispatch closure), so these pass the name quoted
|
|
;; to ctx-capturing setups — the same shape as defmulti/defmethod above.
|
|
(defmacro prefer-method [mm dval-a dval-b]
|
|
`(prefer-method-setup (quote ~mm) ~dval-a ~dval-b))
|
|
|
|
(defmacro remove-method [mm dval]
|
|
`(remove-method-setup (quote ~mm) ~dval))
|
|
|
|
(defmacro remove-all-methods [mm]
|
|
`(remove-all-methods-setup (quote ~mm)))
|
|
|
|
(defmacro get-method [mm dval]
|
|
`(get-method-setup (quote ~mm) ~dval))
|
|
|
|
(defmacro methods [mm]
|
|
`(methods-setup (quote ~mm)))
|
|
|
|
;; instance?: class names don't evaluate to values on jolt, so the type arg is
|
|
;; passed quoted to the ctx-capturing checker; the value evaluates normally.
|
|
(defmacro instance? [t x]
|
|
`(instance-check (quote ~t) ~x))
|
|
|
|
;; Single-threaded host: evaluate the monitor expr (for its effects, matching
|
|
;; Clojure's evaluation order) and the body — no lock to take.
|
|
(defmacro locking [x & body]
|
|
`(do ~x ~@body))
|
|
|
|
;; defonce: define name only if it isn't already bound to a non-nil root;
|
|
;; returns the existing var untouched otherwise (matching the prior arm).
|
|
;; time: evaluate expr, print the elapsed wall-clock, return the value.
|
|
;; current-time-ms is the host's monotonic clock.
|
|
(defmacro time [expr]
|
|
`(let [start# (current-time-ms)
|
|
ret# ~expr]
|
|
(println (str "Elapsed time: " (- (current-time-ms) start#) " msecs"))
|
|
ret#))
|
|
|
|
;; with-redefs: temporary root rebinding, restored on exit (incl. throw).
|
|
;; Builds (hash-map (var n1) v1 ...) — a call form, since map-literal forms
|
|
;; can't carry call forms as keys.
|
|
(defmacro with-redefs [bindings & body]
|
|
(let [pairs (reduce (fn [acc p] (conj (conj acc `(var ~(first p))) (second p)))
|
|
[] (partition 2 bindings))]
|
|
`(with-redefs-fn (hash-map ~@pairs) (fn [] ~@body))))
|
|
|
|
;; Fresh free-standing var cells bound as locals; read/write with
|
|
;; var-get/var-set. The cells come from the host seam __local-var.
|
|
(defmacro with-local-vars [bindings & body]
|
|
(let [binds (reduce (fn [acc p] (conj (conj acc (first p)) `(__local-var ~(second p))))
|
|
[] (partition 2 bindings))]
|
|
`(let [~@binds] ~@body)))
|
|
|
|
;; Canonical recursive expansion; closing goes through the host seam __close
|
|
;; (a map-like value's :close fn or a host file — no .close interop here).
|
|
(defmacro with-open [bindings & body]
|
|
(if (zero? (count bindings))
|
|
`(do ~@body)
|
|
`(let [~(first bindings) ~(second bindings)]
|
|
(try
|
|
(with-open ~(vec (drop 2 bindings)) ~@body)
|
|
(finally (__close ~(first bindings)))))))
|
|
|
|
;; jolt numbers are doubles — there is no BigDecimal math context, so the
|
|
;; precision (and optional :rounding mode) is accepted and ignored.
|
|
(defmacro with-precision [precision & exprs]
|
|
(let [body (if (= :rounding (first exprs)) (drop 2 exprs) exprs)]
|
|
`(do ~@body)))
|
|
|
|
(defmacro with-bindings [binding-map & body]
|
|
`(with-bindings* ~binding-map (fn [] ~@body)))
|
|
|
|
(defmacro bound-fn [& fntail]
|
|
`(bound-fn* (fn ~@fntail)))
|
|
|
|
(defmacro defonce [name expr]
|
|
`(let [v# (resolve (quote ~name))]
|
|
(if (and v# (some? (var-get v#)))
|
|
v#
|
|
(def ~name ~expr))))
|
|
|
|
;; Single arglist (Jolt defmacro is single-arity); the optional else defaults nil
|
|
;; via rest-destructuring.
|
|
(defmacro if-not [test then & [else]]
|
|
`(if (not ~test) ~then ~else))
|
|
|
|
;; Conditional binding macros: the name is bound ONLY in the taken branch (the
|
|
;; auto-gensym temp# tests the value; the else/empty branch sees the surrounding
|
|
;; scope). temp# is a single template-local gensym — referenced twice, same symbol.
|
|
(defmacro if-let [bindings then & [else]]
|
|
(let [form (bindings 0) tst (bindings 1)]
|
|
`(let [temp# ~tst]
|
|
(if temp# (let [~form temp#] ~then) ~else))))
|
|
|
|
;; when-let lives in 00-syntax (not here): 20-coll uses it, which loads before this tier.
|
|
|
|
(defmacro if-some [bindings then & [else]]
|
|
(let [form (bindings 0) tst (bindings 1)]
|
|
`(let [temp# ~tst]
|
|
(if (some? temp#) (let [~form temp#] ~then) ~else))))
|
|
|
|
(defmacro when-some [bindings & body]
|
|
(let [form (bindings 0) tst (bindings 1)]
|
|
`(let [temp# ~tst]
|
|
(if (some? temp#) (let [~form temp#] ~@body) nil))))
|
|
|
|
(defmacro while [test & body]
|
|
`(loop [] (when ~test ~@body (recur))))
|
|
|
|
(defmacro dotimes [bindings & body]
|
|
(let [i (bindings 0) n (bindings 1)]
|
|
`(let [n# ~n]
|
|
(loop [~i 0]
|
|
(when (< ~i n#) ~@body (recur (inc ~i)))))))
|
|
|
|
;; A fresh jolt symbol inside a macro body: (gensym) here resolves to Janet's
|
|
;; builtin (a Janet symbol the destructurer rejects), so round-trip through str.
|
|
(defn- fresh-sym [] (symbol (str (gensym))))
|
|
|
|
;; Lazy-safe: take only the head via first (Clojure uses (seq coll), but Jolt's
|
|
;; eager seq would realize an infinite coll like (repeat nil) and hang). Matches
|
|
;; the prior Janet behavior; the nil/false-head distinction waits on Phase 5
|
|
;; laziness.
|
|
(defmacro when-first [bindings & body]
|
|
(let [x (bindings 0) coll (bindings 1)]
|
|
`(when-let [~x (first ~coll)] ~@body)))
|
|
|
|
;; doto threads a single fresh-bound value as the first arg of each form (side
|
|
;; effects), returning the value. A shared explicit gensym is needed because the
|
|
;; forms are built outside the let's template.
|
|
(defmacro doto [x & forms]
|
|
(let [g (fresh-sym)
|
|
steps (map (fn [f] (if (seq? f) (apply list (first f) g (rest f)) (list f g))) forms)]
|
|
`(let [~g ~x] ~@steps ~g)))
|
|
|
|
;; Threading-with-rebinding macros. The binding pairs are spliced into a TEMPLATE
|
|
;; vector (so core-let sees a tuple form, not a runtime pvec value).
|
|
(defn- thread-binds [g steps]
|
|
(reduce (fn [acc s] (conj (conj acc g) s)) [] (butlast steps)))
|
|
|
|
(defmacro as-> [expr name & forms]
|
|
(let [pairs (reduce (fn [acc f] (conj (conj acc name) f)) [] (butlast forms))]
|
|
`(let [~name ~expr ~@pairs] ~(if (empty? forms) name (last forms)))))
|
|
|
|
(defmacro some-> [expr & forms]
|
|
(let [g (fresh-sym)
|
|
steps (map (fn [f] `(if (nil? ~g) nil (-> ~g ~f))) forms)]
|
|
`(let [~g ~expr ~@(thread-binds g steps)] ~(if (empty? steps) g (last steps)))))
|
|
|
|
(defmacro some->> [expr & forms]
|
|
(let [g (fresh-sym)
|
|
steps (map (fn [f] `(if (nil? ~g) nil (->> ~g ~f))) forms)]
|
|
`(let [~g ~expr ~@(thread-binds g steps)] ~(if (empty? steps) g (last steps)))))
|
|
|
|
(defmacro cond->> [expr & clauses]
|
|
(let [g (fresh-sym)
|
|
steps (map (fn [pair] `(if ~(first pair) (->> ~g ~(second pair)) ~g))
|
|
(partition 2 clauses))]
|
|
`(let [~g ~expr ~@(thread-binds g steps)] ~(if (empty? steps) g (last steps)))))
|
|
|
|
(defmacro assert [x & [message]]
|
|
(let [msg (if message message (str "Assert failed: " (pr-str x)))]
|
|
`(when-not ~x (throw (ex-info ~msg {})))))
|
|
|
|
(defmacro delay [& body]
|
|
`(make-delay (fn [] ~@body)))
|
|
|
|
(defmacro future [& body]
|
|
`(future-call (fn [] ~@body)))
|
|
|
|
;; Build the fn* form via a template (a reader-list array): cons/list in a macro
|
|
;; body produce a plist the evaluator can't call as a form.
|
|
(defmacro letfn [fnspecs & body]
|
|
(let [binds (reduce (fn [acc spec] (conj (conj acc (first spec)) `(fn* ~@(rest spec))))
|
|
[] fnspecs)]
|
|
`(let* [~@binds] ~@body)))
|
|
|
|
;; Dynamic binding: install a thread-binding frame of var->value (array-map keeps
|
|
;; var-get happy, unlike a phm), restore on exit.
|
|
(defmacro binding [bindings & body]
|
|
(let [pairs (reduce (fn [acc p] (conj (conj acc `(var ~(first p))) (second p)))
|
|
[] (partition 2 bindings))]
|
|
`(let* [frame# (array-map ~@pairs)]
|
|
(push-thread-bindings frame#)
|
|
(try (do ~@body) (finally (pop-thread-bindings))))))
|
|
|
|
;; condp: clauses are test-expr result-expr, or test-expr :>> result-fn (calls
|
|
;; result-fn on the truthy (pred test-expr value)); a lone trailing expr is the
|
|
;; default. The recursive emit builds a nested if chain.
|
|
(defmacro condp [pred expr & clauses]
|
|
(let [gp (fresh-sym) ge (fresh-sym)
|
|
emit (fn emit [args]
|
|
(let [n (if (= :>> (second args)) 3 2)
|
|
clause (take n args)
|
|
more (drop n args)
|
|
cn (count clause)]
|
|
(cond
|
|
(= 0 cn) `(throw (ex-info (str "No matching clause: " ~ge) {}))
|
|
(= 1 cn) (first clause)
|
|
(= 2 cn) `(if (~gp ~(first clause) ~ge) ~(second clause) ~(emit more))
|
|
:else `(if-let [p# (~gp ~(first clause) ~ge)]
|
|
(~(nth clause 2) p#)
|
|
~(emit more)))))]
|
|
`(let [~gp ~pred ~ge ~expr] ~(emit clauses))))
|
|
|
|
;; --- protocols, records, types ---------------------------------------------
|
|
;; These emit Jolt's protocol/type special forms (protocol-dispatch,
|
|
;; register-method, make-reified, deftype).
|
|
|
|
;; Group a flat seq that starts with a head symbol followed by its list specs
|
|
;; into [[head spec spec ...] ...] runs. Used by extend-protocol and defrecord.
|
|
(defn- group-by-head [items]
|
|
(reduce (fn [acc x]
|
|
(if (symbol? x)
|
|
(conj acc [x])
|
|
(conj (pop acc) (conj (peek acc) x))))
|
|
[] items))
|
|
|
|
;; deftype is sugar over make-deftype-ctor (a ctx-capturing clojure.core fn that
|
|
;; bakes the ns-qualified type tag at def time) plus extend-type for any inline
|
|
;; protocol methods — so it compiles as a plain (do …). Each method body sees the
|
|
;; type's fields, bound from the instance (the method's first param), matching
|
|
;; Clojure's deftype scope. defrecord (below) expands to a bodyless (deftype …) and
|
|
;; handles its own methods, so this also serves the no-body case.
|
|
(defmacro deftype [tname fields & body]
|
|
;; strip ^meta off the type name and fields (the reader yields a (with-meta sym m)
|
|
;; form for e.g. (deftype ^{:doc …} Foo …)), so (name …) sees a bare symbol.
|
|
(let [unwrap (fn [x] (if (and (seq? x) (symbol? (first x)) (= "with-meta" (name (first x))))
|
|
(second x) x))
|
|
tname (unwrap tname)
|
|
fields (map unwrap fields)
|
|
arrow (symbol (str "->" (name tname)))
|
|
;; a seq of field keywords; spliced into a vector LITERAL below ([~@…]) so
|
|
;; the analyzer sees a vector form, not a runtime pvec value.
|
|
field-kws (map (fn [f] (keyword (name f))) fields)
|
|
impl (fn [proto specs]
|
|
`(extend-type ~tname ~proto
|
|
~@(map (fn [spec]
|
|
(let [argv (nth spec 1)
|
|
inst (first argv)
|
|
binds (vec (mapcat (fn [f] [f `(get ~inst ~(keyword (name f)))]) fields))]
|
|
`(~(first spec) ~argv (let [~@binds] ~@(drop 2 spec)))))
|
|
specs)))]
|
|
`(do
|
|
(def ~tname (make-deftype-ctor (quote ~tname) [~@field-kws]))
|
|
(def ~arrow ~tname)
|
|
~@(map (fn [g] (impl (first g) (rest g))) (group-by-head body))
|
|
~tname)))
|
|
|
|
;; The protocol value is built by make-protocol (a fn call) rather than an embedded
|
|
;; tagged map literal: the interpreter would otherwise self-evaluate such a struct
|
|
;; instead of evaluating its fields. methods is a {kw {:name str}} map (only :name
|
|
;; is consulted). Each method is a thin dispatch fn over protocol-dispatch.
|
|
(defmacro defprotocol [pname & sigs]
|
|
(let [methods (reduce (fn [m sig]
|
|
(assoc m (keyword (name (first sig))) {:name (name (first sig))}))
|
|
{} sigs)]
|
|
`(do
|
|
(def ~pname (make-protocol ~(name pname) ~methods))
|
|
~@(map (fn [sig]
|
|
`(def ~(first sig)
|
|
;; protocol-dispatch is a fn (clojure.core); pass the protocol /
|
|
;; method NAMES as strings (not the symbols) so it compiles as a
|
|
;; plain invoke rather than evaluating the symbols as vars.
|
|
(fn* [this# & rest#]
|
|
(protocol-dispatch ~(name pname) ~(name (first sig)) this# rest#))))
|
|
sigs))))
|
|
|
|
(defmacro extend-type [tsym psym & impls]
|
|
;; register-method is a fn (clojure.core); pass type/protocol/method NAMES as
|
|
;; strings (not the symbols) so the call compiles as a plain invoke.
|
|
`(do ~@(map (fn [spec]
|
|
`(register-method ~(name tsym) ~(name psym) ~(name (first spec))
|
|
(fn* ~(nth spec 1) ~@(drop 2 spec))))
|
|
impls)))
|
|
|
|
(defmacro extend-protocol [psym & type-impls]
|
|
`(do ~@(map (fn [g] `(extend-type ~(first g) ~psym ~@(rest g)))
|
|
(group-by-head type-impls))))
|
|
|
|
;; extend (the fn form) is not supported — stub to nil, as before.
|
|
(defmacro extend [& args] nil)
|
|
;; JVM proxies are unsupported.
|
|
(defmacro proxy [& args] nil)
|
|
;; definterface is JVM-only; bind the name to an empty marker.
|
|
(defmacro definterface [name-sym & body] `(def ~name-sym {}))
|
|
|
|
;; make-reified is a fn (clojure.core); the method map {kw (fn* ...)} is an
|
|
;; ordinary map literal that evaluates to {keyword fn}, and the protocol NAME is
|
|
;; passed as a string (not the symbol) so the call compiles as a plain invoke.
|
|
(defmacro reify [& forms]
|
|
(loop [items (seq forms) proto nil methods {}]
|
|
(if (empty? items)
|
|
`(make-reified ~(name proto) ~methods)
|
|
(let [x (first items)]
|
|
(if (symbol? x)
|
|
(recur (rest items) (if proto proto x) methods)
|
|
(recur (rest items) proto
|
|
(assoc methods (keyword (name (first x)))
|
|
`(fn* ~(nth x 1) ~@(drop 2 x)))))))))
|
|
|
|
(defmacro defrecord [name-sym fields & body]
|
|
(let [tn (name name-sym)
|
|
arrow (symbol (str "->" tn))
|
|
mapf (symbol (str "map->" tn))
|
|
m (fresh-sym)
|
|
;; each method body sees the record fields, bound from the instance (the
|
|
;; method's first param), matching Clojure's defrecord method scope. vec the
|
|
;; spliced binding seq so ~@ splices its elements, not the lazy-seq itself.
|
|
impl (fn [proto specs]
|
|
`(extend-type ~name-sym ~proto
|
|
~@(map (fn [spec]
|
|
(let [argv (nth spec 1)
|
|
inst (first argv)
|
|
binds (vec (mapcat (fn [f] [f `(get ~inst ~(keyword (name f)))]) fields))]
|
|
`(~(first spec) ~argv (let [~@binds] ~@(drop 2 spec)))))
|
|
specs)))]
|
|
`(do
|
|
;; deftype already defines ->name (= the ctor); no (name. …) interop needed,
|
|
;; so defrecord compiles too. map->name builds via that ctor.
|
|
(deftype ~name-sym ~fields)
|
|
(def ~mapf (fn* [~m] (~arrow ~@(map (fn [f] `(get ~m ~(keyword (name f)))) fields))))
|
|
~@(map (fn [g] (impl (first g) (rest g))) (group-by-head body)))))
|
|
|
|
;; --- laziness --------------------------------------------------------------
|
|
;; lazy-seq / lazy-cat moved to the 00-syntax tier: the seq/coll tiers (10-seq,
|
|
;; 20-coll) use lazy-seq, and in compile mode a tier's forms are compiled as it
|
|
;; loads — so the macro must be registered BEFORE those tiers, else (lazy-seq …)
|
|
;; compiles as a call to the macro-as-function and leaks its expansion at runtime
|
|
;; (jolt-r81). They only need seed fns (make-lazy-seq/coll->cells/concat).
|