tornado.compiler — org.clojars.jansuran03/tornado 0.1.0

The Tornado compiler, where you should only care about these 3 functions: css, repl-css, compile-expression.

*at-media-indent* clj

Extra indentation when nested inside a media query.

*flags* clj

The current flags for a tornado build compilation:

:indent-length - Specifies, how many indentation spaces should be in the compiled CSS file after any nesting in @rule or params map. Defaults to 4.

:pretty-print? - Specifies, whether the compiled CSS should be pretty printed. Defaults to true. If set to false, the CSS file will be compressed after compilation (removal of unnecessary characters like spaces and newlines) to make the CSS file a bit smaller.

:output-to - Specifies, where the compiled CSS file should be saved.

*in-params-context* clj

*keyframes-indent* clj

Extra indentation when nested inside keyframes.

*media-query-parents* clj

Current parents Used for compiling @media to temporarily store parents paths for compiling @media changes.

attr-map-to-css clj

(attr-map-to-css attributes-map)

Compiles an attributes map and translates the compiled data to CSS: (attr-map-to-css {:width (units/percent 50) :margin [[0 (units/px 15) (units/rem* 3) :auto]] :background-color (colors/rotate-hue "#ff0000" 60)} => width: 50%; margin: 0 15px rem3 auto; background-color: hsl(60 1 0.5);

calc-keywords clj

A special map for calc keywords

commajoin clj

(commajoin {:keys [compiles-to args]})

Redefining functions/commajoin because there would be a cyclic dependency otherwise.

compile-all-selectors-params-combinations clj

(compile-all-selectors-params-combinations prepared-hiccup)

Given a prepared hiccup vector (with precalculated and simplified combinations of all selectors, children and params, this function generates a CSS string from the data.

compile-at-rule clj multimethod

Generates CSS from a CSSAtRule record, at the moment, these are available: @media, @keyframes, @font-face.

E.g.: #tornado.types.CSSAtRule{:identifier "media" :value {:rules {:min-width "500px" :max-width "700px"} :changes [:.abc {:margin-top "20px"}]}}

Depending on the :identifier ("media" in this case), a relevant method is called.

compile-attributes-map clj

(compile-attributes-map attributes-map)

Compiles an attributes map, returns a sequence of [compiled-attribute compiled-value].

compile-color clj multimethod

Generates CSS from a color, calls a relevant method to do so depending on the color's type: "rgb", "rgba", "hsl", "hsla", keyword, string, keyword (for keywords, tries to get an exact hex-value of the color from colors/default-colors), otherwise prints out a warning and returns a string form of that keyword.

compile-css-record clj multimethod

Compiles a CSS record (unit, function, at-rule, color). For 4 different types of CSS selectors, there is a different multifunction "compile-selector".

compile-expression clj

(compile-expression expr)

Compiles an expression: a number, string, symbol or a record. If the expression is a vector of sequential structures, compiles each of the structures and str/joins them with a space. Then, str/joins all these str/spacejoined structures with a comma.

E.g.: (compile-expression [[(u/px 15) (u/percent 20)] [:red :chocolate]]) => "15px 20%, #FF0000 #D2691E"

compile-selector clj multimethod

Compiles a CSS combinator, attribute selector, pseudoclass or pseudoelement or a selector in a keyword/symbol/string form.

compile-selectors clj

(compile-selectors selectors-sequences)

Given a sequence of selectors paths, e.g. '([:iframe :.abc] [:#def sel/after :.ghi]), this function translates all the selectors paths to CSS and str/joins them with a comma, which is a shorthand that can be used in CSS to give different selectors paths the same parameters. ... => "iframe .abc, #def::after .ghi"

compile-selectors-and-params clj

(compile-selectors-and-params {:keys [paths params at-media at-font-face
                                      at-keyframes]})

For a current :paths & :params/:at-media map, translates the paths (selectors) which all have the equal params map or at-media record to CSS and str/joins them with a comma (a shorthand which can be used in CSS). Also translates the params map or at-media record to CSS and creates a CSS block from these compiled things, e.g.: (compile-selectors-and-params {:paths #{[:.abc :#def :iframe] [:td :span sel/hover]} :params {:color :font-black :margin [[(units/px 15) (units/em 2)]] :display :flex}} => .abc #def iframe, td span:hover { color: #1A1B1F; margin: 15px 2em; display: flex; }

compile-selectors-sequence clj

(compile-selectors-sequence selectors-path)

Given a selectors path, which can contain special selectors, this function generates a CSS string from the selectors.

conjs clj

(conjs s value)

Conj(oin)s to a (potentially empty) set,

css clj

(css css-hiccup)

(css flags css-hiccup)

Generates CSS from a hiccup vector or a (maybe multiple times) nested list of hiccup vectors (and/or with @keyframes, @font-face). If pretty-print? is set to false, compresses it as well. Then saves the compiled CSS string to a given file path.

You can also call this function without flags whenever you want to to just get the whole compiled CSS string printed out.

expand-hiccup-list-for-compilation clj

(expand-hiccup-list-for-compilation parents
                                    unevaluated-hiccup
                                    nested-hiccup-vectors-list)

Given a hiccup element path (parents) and current unevaluated hiccup, this function first expands all lists and lazy sequences until it comes across a structure which is neither of them. After that, the function recursively goes through all hiccup vectors in the expanded hiccup vectors list: The current vector of unevaluated hiccup combinations is passed to another expanding function which recursively calculates all combinations of a current hiccup vector by calling itself and then this function for deeper expanding again - all combinations of its selectors (+ selectors received from parents), params and children. It then inserts all these combinations to the unevaluated hiccup and returns it updated with the combinations inserted.

expand-hiccup-vector clj

(expand-hiccup-vector parents unevaluated-hiccup hiccup-vector)

Given a (potentially nil) current parents sequence, unevaluated hiccup combinations in a vector the current hiccup vector, which is in a form [sel1 maybe-sel2 maybe-sel3 ... {maybe-params-map} [maybe-child1] [maybe-child2] ... ] where each child is a hiccup vector as well, this function adds all combinations of selectors and descendant children and their selectors together with corresponding parameters (or skips the combination of params are nil) to the unevaluated-hiccup argument, recursively.

expand-seqs clj

(expand-seqs coll)

Expands lists and lazy sequences in a nested structure. Always expands the first collection. When any more deeply nested collection is neither a list nor a lazy-seq, this function does not expand it. (expand-seqs [:a :b]) => (:a :b) ... the first element is anything seqable -> transforms it to a list

(expand-seqs [[:a :b]]) => ([:a :b]) ... the 2nd element is neither a list nor a lazy-seq -> does not expand it

(expand-seqs [(list :a [:b (map identity [:c :d :e])])]) => (:a [:b (:c :d :e)]) ... 2nd element a vector -> does not expand the nested lazy-seq.

See clojure.core/flatten. This function just only expands seqs.

in-keyframes-context clj macro

(in-keyframes-context & body)

Temporarily adds extra + 1* globally used indent for compiling @keyframes.

in-params-context clj macro

(in-params-context & body)

A macro to bind in-params-context to true, which causes a css at-rule keyframes record to be compiled to {:anim-name} (assuming it is for :animation-name)

indent clj

(indent)

The actual globally used indent in a string form of X spaces.

just-css clj

(just-css css-hiccup)

Compiles the hiccup to a string of CSS. Does not do any printing or file output, that is what the functions below are. This one is separate to simplify both functions css and repl-css which just do something with the output of this function.

repl-css clj

(repl-css css-hiccup)

Generates CSS from a hiccup vector or a (maybe multiple times) nested list of hiccup vectors (and/or with @keyframes, @font-face). It then pretty prints the output string, which is useful for evaluating any tornado code in REPL.

selectors-params-children clj

(selectors-params-children hiccup)

Given a hiccup vector, this function returns a map with keys :selectors, :params, :children and :at-media, where each of these keys' value is a vector of those elements. Besides :params, which is returned as a map, since there cannot be more than 1 params map. Including incorrect elements or failing to comply the right order of the elements (selector -> & more-selectors -> maybe-params -> & maybe-children & maybe-at-media) will throw a detailed error message.

simplify-prepared-expanded-hiccup clj

(simplify-prepared-expanded-hiccup path-params-vector)

Simplifies the expanded hiccup vector: A new map will be created for every unique parameters map or at-media record with {:params {...}, :paths #{...}} (with :at-media instead of :params alternatively), where elements with equal params or at-media record will be inserted to a set behind the :paths key. This function returns a vector of these unique params/at-media maps.

special-media-rules-map clj

A special map for generating media queries rules, e.g.: (tornado.at-rules/at-media {:rules {:screen :only -> "only screen" :screen false -> "not screen" :screen true -> "screen"} ...

with-custom-flags clj macro

(with-custom-flags flags & body)

Given custom-flags & body, temporarily merges default flags with the given flags and executes the body.

with-media-query-parents clj macro

(with-media-query-parents -parents- & body)

Temporarily stores current parents paths for compiling @media and adds

• 1* globally used indent.