fr.jeremyschoffen.prose.alpha.document.lib — io.github.pfeodrippe/dev-tooling 1.0.16

Api providing several tools to use inside or outside of prose document.

<> clj/s

(<> & content)

Fragment tag whose content is meant to be spliced into its parent's content.

add-classes clj/s

(add-classes t classes)

attr->set clj/s

(attr->set s)

Turn the string value of an html tag attribute into a set of strings (like the value class attribute).

conform-or-throw clj/s

(conform-or-throw spec v)

Conforms the value v using the spec spec and throws an ex-info if v is invalid.

def-s clj/s macro

(def-s & args)

Same as def except that it returns and empty string.

def-xml-tag clj/s≠ macro

clj

(def-xml-tag name docstring? keyword-name?)

cljs

(def-xml-tag & args)

Helper in making functions that construct tags.

Args:

• name: name of the function
• docstring?: a docstring for the function
• keyword-name?: the actual name of the tag, defaults to the keyword version of name

def-xml-tags clj/s macro

(def-xml-tags & tags)

defmacro-s clj/s macro

(defmacro-s & args)

Same as defmacro except that it returns and empty string.

defn-s clj/s macro

(defn-s & args)

Same as defn except that it returns and empty string.

eval-doc clj/s

(eval-doc & args)

Eval a document using the function given by get-eval-doc.

get-env clj/s

(get-env)

(get-env k)

Get the evaluation environment or the value for one of its keys.

get-eval-doc clj/s

(get-eval-doc)

Get the eval-forms function from the evaluation environment.

get-input clj/s

(get-input)

Get the input value from the evaluation environment.

get-read-doc clj/s

(get-read-doc)

Get the reading function from the evaluation environment.

get-slurp-doc clj/s

(get-slurp-doc)

Get the slurping function from the evaluation environment.

insert-doc clj/s macro

(insert-doc path)

Insert the slurped and read content of another document.

make-mixed-in clj/s

(make-mixed-in cstr classes)

Make a tag constructor that injects some css classes.

Args:

• cstr: a tag constructor (defined with def-xml-tag for instance)
• classes: a sequence of css classes names, can be string or keywords

ex: (def container (make-mixed-in div [:container])) (container "some text")

:=> {:tag :div :attrs {:classes "container"} :content "some text"}

read-doc clj/s

(read-doc & args)

Read a string using the function given by get-read-doc.

require-doc clj/s

(require-doc path)

Insert the slurped, read and evaluated content of another document.

set->attr clj/s

(set->attr s)

Turn a set of strings/keywords into a string to be used as the value of an html tag attribute (like the class attribute).

slurp-doc clj/s

(slurp-doc & args)

Slurp a document using the function given by get-slurp-doc.

special? clj/s

(special? x)

Determine if x is a special tag.

tag-type clj/s

(tag-type x)

Returns the type of a tag x or nil isn't a map or doesn't have a type.

tag? clj/s

(tag? x)

Determine if x is a normal tag.

xml-tag clj/s≠

clj

(xml-tag name attrs? & content)

cljs

(xml-tag & args)

Constructor of normal tags.

args:

• name: a keyword giving the tag his name (:div, :my-tag, etc...)
• attrs: a map of attributes
• content: the content of the tag, strings, other (special)tags or sequences of both.

Returns a map similar to:

{:type :tag
 :tag name
 :attrs attrs?
 :content content}