fireworks.core — io.github.paintparty/fireworks 0.5.0

!? clj/s

!?* clj/s

(!?*)

(!?* x)

(!?* _ x)

A no-op function which returns the value. Intended to temporarily silence the printing of a form while still keeping it wrapped.

!?- clj/s

!?-- clj/s

(!?--)

(!?-- x)

!?> clj/s

!?flop clj/s

!?i clj/s

!?l clj/s

!?log clj/s

!?log- clj/s

!?pp clj/s

!?pp- clj/s

!?trace clj/s

? clj/s macro

(?)

(? x)

(? a x)

Prints the form (or user-supplied label), the namespace info, and then the value.

The form (or optional label) is formatted with pprint. The value is formatted with fireworks.core/_p.

Returns the value.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

?- clj/s

(?-)

(?- x)

(?- a x)

Prints only the value. The value is formatted with fireworks.core/_p. Returns the value.

?-- clj/s macro

(?--)

(?-- x)

Prints a user-supplied label, following by the namespace info. Designed for providing commentary in your program.

If the label is multiline, the file-info is instead placed above the label.

The form (or optional label) is formatted with pprint.

?> clj/s

(?> x)

Passes value to clojure.core/tap> and returns value.

?flop clj/s macro

(?flop)

(?flop x)

(?flop x a)

Prints the form (or user-supplied label), the namespace info, and then the value. Same as fireworks.core/?, but order of arguments is reversed in the case of 2 arities. Inteded for use both internal to fireworks (tracing macros), and also for users wanting to drop a ? call into a thread-first form and also pass an options map.

The form (or optional label) is formatted with pprint. The value is formatted with fireworks.core/_p.

Returns the value.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

?i clj/s macro

(?i)

(?i x)

(?i a x)

Prints the namespace/file info, and then the value.

Returns the value.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

?l clj/s macro

(?l)

(?l x)

(?l a x)

Prints the form (or user-supplied label), and then the value.

The form (or optional label) is formatted with pprint. The value is formatted with fireworks.pp/_p.

Returns the value.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

?let clj/s macro

(?let & args)

Printing of bindings in let. Returns body. WIP. Currently undocumented, will probably fold into trace? functionality and remove this macro.

?log clj/s macro

(?log)

(?log x)

(?log a x)

Prints the form (or user-supplied label), the namespace info, and then logs the value using console.log or pp/pprint

The form (or optional label) and value are formatted with fireworks.core/_p.

Returns the value.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

?log- clj/s

(?log-)

(?log- x)

Prints just the value using console.log or pp/pprint. Returns the value.

?pp clj/s macro

(?pp)

(?pp x)

(?pp a x)

Prints the form (or user-supplied label), the namespace info, and then logs the value using pp/pprint.

The form (or optional label) and value are formatted with fireworks.core/_p.

Returns the value.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

?pp- clj/s

(?pp-)

(?pp- x)

Prints just the value using console.log or pp/pprint. Returns the value.

?trace clj/s macro

(?trace x)

(?trace user-opts x)

_log clj/s

(_log x)

_p clj/s

(_p opts x)

(_p a opts x)

Internal runtime dispatch target for fireworks macros.

Pretty-prints the value with syntax coloring. Takes an optional leading argument (custom label or options map). Returns the value.

_pp clj/s

(_pp x)

Called internally.

cast-var clj/s

(cast-var defd {:keys [ns-str]})

Needs to be public, used at runtime by macros

core-defs clj/s

core-defs-clj-classes clj/s

p-data clj/s macro

(p-data)

(p-data x)

(p-data a x)

Formats the namespace info, then the form (or user-supplied label), and then the value. The form (or optional label) and value are formatted with fireworks.core/p.

If value is a list whose first element is a member of fireworks.core/core-defs, the value gets evaluated first, then the quoted var is printed and returned.

Returns a map of data with the following shape:

{:formatted {:string "..." :css-styles [...]} :formatted+ {:string "..." :css-styles [...]} :file "sandbox/browser.cljs" :end-column 32 :ns-str "sandbox.browser" :file-info-str "sandbox.browser:119:22" :column 22 :line 119 :end-line 119 :quoted-value "..."}

The entries [:formatted :string], [:formatted+ :string], and [:quoted-value] represent the syntax-colored values. The tokens within these strings are wrapped with %c escaped codes for browser dev consoles, or sgr codes, for terminal emulators.

pprint clj/s

(pprint x)

(pprint x opts)

(pprint writer
        x
        {:keys [max-width map-entry-separator]
         :or {max-width 72 map-entry-separator ","}
         :as opts})

Pretty-print an object.

Given one arg (an object), pretty-print the object into out using the default options.

Given two args (an object and an options map), pretty-print the object into out using the given options.

Given three args (a java.io.Writer, a object, and an options map), pretty-print the object into the writer using the given options.

If print-dup is true, pprint does not attempt to pretty-print; instead, it falls back to default print-dup behavior. ClojureScript does not support print-dup.

Options:

:max-width (long or ##Inf, default: 72) Avoid printing anything beyond the column indicated by this value.

:map-entry-separator (string, default: ",") The string to print between map entries. To not print commas between map entries, use an empty string.

print-thread clj/s

(print-thread cfg-opts quoted-forms op)

sym<->str clj/s

(sym<->str {:keys [x pred f binding-sym?]})