From b38ef90c3c7dba4606f9b17cd57d02621802987a Mon Sep 17 00:00:00 2001 From: Andrey Antukh Date: Thu, 21 Dec 2023 12:32:34 +0100 Subject: [PATCH] Generate book --- clojurescript-unraveled.pdf | Bin 0 -> 716785 bytes clojurescript-unraveled.xml | 6892 +++++++++++++++++++++++++++++++++++ index.html | 2777 ++++++-------- 3 files changed, 7991 insertions(+), 1678 deletions(-) create mode 100644 clojurescript-unraveled.pdf create mode 100644 clojurescript-unraveled.xml diff --git a/clojurescript-unraveled.pdf b/clojurescript-unraveled.pdf new file mode 100644 index 0000000000000000000000000000000000000000..2e721812bdc72421bf95c9245600544102d0b1f4 GIT binary patch literal 716785 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 z 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

QkOvkD@qmqpF?!(ms(2Yo+CJ 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

OW&oB~8cpY6!O-12g2wrOcUEnv&!7zT23Grogl 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

fUf5R|bT;-U#% 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%0DSS)knray* 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

eP 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 literal 0 HcmV?d00001 diff --git a/clojurescript-unraveled.xml b/clojurescript-unraveled.xml new file mode 100644 index 0000000..ee8655c --- /dev/null +++ b/clojurescript-unraveled.xml @@ -0,0 +1,6892 @@ + + + + + + +ClojureScript Unraveled (2nd edition) +2019-07-16 + + +Andrey +Antukh +niwi@niwi.nz + + +Alejandro +Gómez +alejandro@dialelo.com + + + + +6 +2019-07-16 +AA + + + + +About this book +This book covers the ClojureScript programming language, serves as a detailed guide +of its tooling for development, and presents a series of articles about topics that +are applicable to day-to-day programming in ClojureScript. +It is not an introductory book to programming in that it assumes the reader has +experience programming in at least one language. However, it doesn’t assume +experience with Clojure or functional programming. We’ll try to include links to +reference material when talking about the theoretical underpinnings of ClojureScript +that may not be familiar to everyone. +Since the ClojureScript documentation is good but sparse, we wanted to write a +compendium of reference information and extensive examples to serve as a +ClojureScript primer as well as a series of practical how-to’s. This document will +evolve with the ClojureScript language, both as a reference of the language features +and as a sort of cookbook with practical programming recipes. +You’ll get the most out of this book if you: + + +are curious about ClojureScript or functional programming and have some programming +experience; + + +write JavaScript or any other language that compiles to it and want to know what +ClojureScript has to offer; + + +already know some Clojure and want to learn how ClojureScript differs from it, plus +practical topics like how to target both languages with the same code base. + + +Don’t be turned off if you don’t see yourself in any of the above groups. We +encourage you to give this book a try and to give us feedback on how we can make it +more accessible. Our goal is to make ClojureScript more friendly to newcomers and +spread the ideas about programming that Clojure has helped popularize, as we see a +lot of value in them. +This is a list of translations of the book: + + +Ukrainian: https://lambdabooks.github.io/clojurescript-unraveled/ + + + + +Introduction +

+ +Rich Hickey + +Why are we doing this? Because Clojure rocks, and JavaScript reaches. +
+ClojureScript is an implementation of the Clojure programming language that +targets JavaScript. Because of this, it can run in many different execution +environments including web browsers, Node.js, Nashorn (and many other). +Unlike other languages that intend to compile to JavaScript (like TypeScript, +FunScript, or CoffeeScript), ClojureScript is designed to use JavaScript like +bytecode. It embraces functional programming and has very safe and consistent +defaults. Its semantics differ significantly from those of JavaScript. +Another big difference (and in our opinion an advantage) over other languages is +that Clojure(Script) is designed to be a guest. It is a language without its own +virtual machine that can be easily adapted to the nuances of its execution +environment. This has the benefit that Clojure (and hence ClojureScript) has +access to all the existing libraries written for the host language. +Before we jump in, let us summarize some of the core ideas that ClojureScript +brings to the table. Don’t worry if you don’t understand all of them right now, +they’ll become clear throughout the book. + + +ClojureScript enforces the functional programming paradigm with its design +decisions and idioms. Although being strongly opinionated about functional +programming it’s a pragmatic language rather than pursuing theoretical purity. + + +Encourages programming with immutable data, offering highly performant and +state of the art immutable collection implementations. + + +It makes a clear distinction of identity and its state, with explicit constructs +for managing change as a series of immutable values over time. + + +It has type-based and value-based polymorphism, elegantly solving the expression +problem. + + +It is a Lisp dialect so programs are written in the programming language’s own +data structures, a property known as homoiconicity that makes metaprogramming +(programs that write programs) as simple as it can be. + + +These ideas together have a great influence in the way you design and implement +software, even if you are not using ClojureScript. Functional programming, +decoupling of data (which is immutable) from the operations to transform it, +explicit idioms for managing change over time and polymorphic constructs for +programming to abstractions greatly simplify the systems we write. +
+ +Rich Hickey + +We can make the same exact software we are making today with dramatically +simpler stuff — dramatically simpler languages, tools, techniques, approaches. +
+We hope you enjoy the book and ClojureScript brings the same joy and inspiration that +has brought to us. + + +Language (the basics) +This chapter will be a little introduction to ClojureScript without assumptions about +previous knowledge of the Clojure language, providing a quick tour over all the +things you will need to know about ClojureScript and understand the rest of this +book. +You can run the code snippets in the online interactive repl: +http://www.clojurescript.io/ +
+First steps with Lisp syntax +Invented by John McCarthy in 1958, Lisp is one of the oldest programming languages +that is still around. It has evolved into many derivatives called dialects, +ClojureScript being one of them. It is a programming language written in its own +data structures — originally lists enclosed in parentheses — but Clojure(Script) has +evolved the Lisp syntax with more data structures, making it more pleasant to write +and read. +A list with a function in the first position is used for calling a function in +ClojureScript. In the example below, we apply the addition function to three +arguments. Note that unlike in other languages, + is not an operator but a +function. Lisp has no operators; it only has functions. +(+ 1 2 3) +;; => 6 +In the example above, we’re applying the addition function + to the arguments 1, +2 and 3. ClojureScript allows many unusual characters like ? or - in symbol +names, which makes it easier to read: +(zero? 0) +;; => true +To distinguish function calls from lists of data items, we can quote lists to keep +them from being evaluated. The quoted lists will be treated as data instead of as a +function call: +'(+ 1 2 3) +;; => (+ 1 2 3) +ClojureScript uses more than lists for its syntax. The full details will be covered +later, but here is an example of the usage of a vector (enclosed in brackets) for +defining local bindings: +(let [x 1 + y 2 + z 3] + (+ x y z)) +;; => 6 +This is practically all the syntax we need to know for using not only ClojureScript, +but any Lisp. Being written in its own data structures (often referred to as +homoiconicity) is a great property since the syntax is uniform and simple; also, +code generation via macros is easier than in any other +language, giving us plenty of power to extend the language to suit our needs. +
+
+The base data types +The ClojureScript language has a rich set of data types like most programming +languages. It provides scalar data types that will be very familiar to you, such as +numbers, strings, and floats. Beyond these, it also provides a great number of +others that might be less familiar, such as symbols, keywords, regexes (regular +expressions), vars, atoms, and volatiles. +ClojureScript embraces the host language, and where possible, uses the host’s +provided types. For example: numbers and strings are used as is and behave in the +same way as in JavaScript. +
+Numbers +In ClojureScript, numbers include both integers and floating points. Keeping in +mind that ClojureScript is a guest language that compiles to JavaScript, integers +are actually JavaScript’s native floating points under the hood. +As in any other language, numbers in ClojureScript are represented in the +following ways: +23 ++23 +-100 +1.7 +-2 +33e8 +12e-14 +3.2e-4 +
+
+Keywords +Keywords in ClojureScript are objects that always evaluate to themselves. They are +usually used in map data structures to efficiently represent the +keys. +:foobar +:2 +:? +As you can see, the keywords are all prefixed with :, but this character is +only part of the literal syntax and is not part of the name of the object. +You can also create a keyword by calling the keyword function. Don’t worry if +you don’t understand or are unclear about anything in the following example; +functions are discussed in a later section. +(keyword "foo") +;; => :foo +
+Namespaced keywords +When prefixing keywords with a double colon ::, the keyword will be prepended +by the name of the current namespace. Note that namespacing keywords affects +equality comparisons. +::foo +;; => :cljs.user/foo + +(= ::foo :foo) +;; => false +Another alternative is to include the namespace in the keyword +literal, this is useful when creating namespaced keywords for other +namespaces: +:cljs.unraveled/foo +;; => :cljs.unraveled/foo +The keyword function has an arity-2 variant where we can specify the namespace as the first parameter: +(keyword "cljs.unraveled" "foo") +;; => :cljs.unraveled/foo +
+
+
+Symbols +Symbols in ClojureScript are very, very similar to keywords (which you now know +about). But instead of evaluating to themselves, symbols are evaluated to something +that they refer to, which can be functions, variables, etc. +Symbols start with a non numeric character and can contain alphanumeric characters +as well as *, +, !, -, _, ', and ? such as : +sample-symbol +othersymbol +f1 +my-special-swap! +Don’t worry if you don’t understand right away; symbols are used in almost all of +our examples, which will give you the opportunity to learn more as we go on. +
+
+Strings +There is almost nothing new we can explain about strings that you don’t already +know. In ClojureScript, they work the same as in any other language. One point of +interest, however, is that they are immutable. +In this case they are the same as in JavaScript: +"An example of a string" +One peculiar aspect of strings in ClojureScript is due to the language’s Lisp +syntax: single and multiline strings have the same syntax: +"This is a multiline + string in ClojureScript." +
+
+Characters +ClojureScript also lets you write single characters using Clojure’s character +literal syntax. +\a ; The lowercase a character +\newline ; The newline character +Since the host language doesn’t contain character literals, ClojureScript +characters are transformed behind the scenes into single character JavaScript +strings. +
+
+Collections +Another big step in explaining a language is to explain its collections and +collection abstractions. ClojureScript is not an exception to this rule. +ClojureScript comes with many types of collections. The main difference between +ClojureScript collections and collections in other languages is that they are +persistent and immutable. +Before moving on to these (possibly) unknown concepts, we’ll present a high-level +overview of existing collection types in ClojureScript. +
+Lists +This is a classic collection type in languages based on Lisp. Lists are the simplest +type of collection in ClojureScript. Lists can contain items of any type, +including other collections. +Lists in ClojureScript are represented by items enclosed between parentheses: +'(1 2 3 4 5) +'(:foo :bar 2) +As you can see, all list examples are prefixed with the ' char. This is because +lists in Lisp-like languages are often used to express things like function or macro +calls. In that case, the first item should be a symbol that will evaluate to +something callable, and the rest of the list elements will be function +arguments. However, in the preceding examples, we don’t want the first item as a +symbol; we just want a list of items. +The following example shows the difference between a list without and with the +preceding single quote mark: +(inc 1) +;; => 2 + +'(inc 1) +;; => (inc 1) +As you can see, if you evaluate (inc 1) without prefixing it with ', it will +resolve the inc symbol to the inc function and will execute it with 1 as the +first argument, returning the value 2. +You can also explicitly create a list with the list function: +(list 1 2 3 4 5) +;; => (1 2 3 4 5) + +(list :foo :bar 2) +;; => (:foo :bar 2) +Lists have the peculiarity that they are very efficient if you access them +sequentially or access their first elements, but a list is not a very good option if +you need random (index) access to its elements. +
+
+Vectors +Like lists, vectors store a series of values, but in this case, with very +efficient index access to their elements, as opposed to lists, which are evaluated +in order. Don’t worry; in the following sections we’ll go in depth with details, but +at this moment, this simple explanation is more than enough. +Vectors use square brackets for the literal syntax; let’s see some examples: +[:foo :bar] +[3 4 5 nil] +Like lists, vectors can contain objects of any type, as you can observe in the +preceding example. +You can also explicitly create a vector with the vector function, but this is not +commonly used in ClojureScript programs: +(vector 1 2 3) +;; => [1 2 3] + +(vector "blah" 3.5 nil) +;; => ["blah" 3.5 nil] +
+
+Maps +Maps are a collection abstraction that allow you to store key/value pairs. In other +languages, this type of structure is commonly known as a hash-map or dict +(dictionary). Map literals in ClojureScript are written with the pairs between +curly braces. +{:foo "bar", :baz 2} +{:alphabet [:a :b :c]} + +Commas are frequently used to separate a key-value pair, but they are +completely optional. In ClojureScript syntax, commas are treated like spaces. + +Like vectors, every item in a map literal is evaluated before the result is stored +in a map, but the order of evaluation is not guaranteed. +
+
+Sets +And finally, sets. +Sets store zero or more unique items of any type and are unordered. Like maps, they +use curly braces for their literal syntax, with the difference being that they use a +# as the leading character. You can also use the set function to convert a +collection to a set: +#{1 2 3 :foo :bar} +;; => #{1 :bar 3 :foo 2} +(set [1 2 1 3 1 4 1 5]) +;; => #{1 2 3 4 5} +In subsequent sections, we’ll go in depth about sets and the other collection types +you’ve seen in this section. +
+
+
+
+Vars +ClojureScript is a mostly functional language that focuses on +immutability. Because of that, it does not have the concept of variables as you know +them in most other programming languages. The closest analogy to variables are the +variables you define in algebra; when you say x = 6 in mathematics, you are saying +that you want the symbol x to stand for the number six. +In ClojureScript, vars are represented by symbols and store a single value +together with metadata. +You can define a var using the def special form: +(def x 22) +(def y [1 2 3]) +Vars are always top level in the namespace (which we will +explain later). If you use def in a function call, the var will be defined at +the namespace level, but we do not recommend this - instead, you should use let to +define variables within a function. +
+
+Functions +
+The first contact +It’s time to make things happen. ClojureScript has what are known as first class +functions. They behave like any other type; you can pass them as parameters and you +can return them as values, always respecting the lexical scope. ClojureScript also +has some features of dynamic scoping, but this will be discussed in another section. +If you want to know more about scopes, this +Wikipedia article is +very extensive and explains different types of scoping. +As ClojureScript is a Lisp dialect, it uses the prefix notation for calling a +function: +(inc 1) +;; => 2 +In the example above, inc is a function and is part of the ClojureScript +runtime, and 1 is the first argument for the inc function. +(+ 1 2 3) +;; => 6 +The + symbol represents an add function. It allows multiple parameters, whereas +in ALGOL-type languages, + is an operator and only allows two parameters. +The prefix notation has huge advantages, some of them not always +obvious. ClojureScript does not make a distinction between a function and an +operator; everything is a function. The immediate advantage is that the prefix +notation allows an arbitrary number of arguments per "operator". It also completely +eliminates the problem of operator precedence. +
+
+Defining your own functions +You can define an unnamed (anonymous) function with the fn special form. This is +one type of function definition; in the following example, the function takes two +parameters and returns their average. +(fn [param1 param2] + (/ (+ param1 param2) 2.0)) +You can define a function and call it at the same time (in a single expression): +((fn [x] (* x x)) 5) +;; => 25 +Let’s start creating named functions. But what does a named function really mean? +It is very simple; in ClojureScript, functions are first-class and behave like any +other value, so naming a function is done by simply binding the function to a +symbol: +(def square (fn [x] (* x x))) + +(square 12) +;; => 144 +ClojureScript also offers the defn macro as a little syntactic sugar for making +function definition more idiomatic: +(defn square + "Return the square of a given number." + [x] + (* x x)) +The string that comes between the function name and the parameter vector is called a +docstring (documentation string); programs that automatically create web +documentation from your source files will use these docstrings. +
+
+Functions with multiple arities +ClojureScript also comes with the ability to define functions with an arbitrary +number of arguments. (The term arity means the number of arguments that a function +takes.) The syntax is almost the same as for defining an ordinary function, with the +difference that it has more than one body. +Let’s see an example, which will explain it better: +(defn myinc + "Self defined version of parameterized `inc`." + ([x] (myinc x 1)) + ([x increment] + (+ x increment))) +This line: ([x] (myinc x 1)) says that if there is only one argument, call the +function myinc with that argument and the number 1 as the second argument. The +other function body ([x increment] (+ x increment)) says that if there are two +arguments, return the result of adding them. +Here are some examples using the previously defined multi-arity function. Observe +that if you call a function with the wrong number of arguments, the compiler will +emit an error message. +(myinc 1) +;; => 2 + +(myinc 1 3) +;; => 4 + +(myinc 1 3 3) +;; Compiler error + +Explaining the concept of "arity" is out of the scope of this book, however +you can read about that in this Wikipedia +article. + +
+
+Variadic functions +Another way to accept multiple parameters is defining variadic functions. Variadic +functions are functions that accept an arbitrary number of arguments: +(defn my-variadic-set + [& params] + (set params)) + +(my-variadic-set 1 2 3 1) +;; => #{1 2 3} +The way to denote a variadic function is using the & symbol prefix on its +arguments vector. +
+
+Short syntax for anonymous functions +ClojureScript provides a shorter syntax for defining anonymous functions using the +#() reader macro (usually leads to one-liners). Reader macros are "special" +expressions that will be transformed to the appropriate language form at compile +time; in this case, to some expression that uses the fn special form. +(def average #(/ (+ %1 %2) 2)) + +(average 3 4) +;; => 3.5 +The preceding definition is shorthand for: +(def average-longer (fn [a b] (/ (+ a b) 2))) + +(average-longer 7 8) +;; => 7.5 +The %1, %2…​ %N are simple markers for parameter positions that are +implicitly declared when the reader macro will be interpreted and converted to a +fn expression. +If a function only accepts one argument, you can omit the number after the % +symbol, e.g., a function that squares a number: #(* %1 %1)) can be written +#(* % %)). +Additionally, this syntax also supports the variadic form with the %& symbol: +(def my-variadic-set #(set %&)) + +(my-variadic-set 1 2 2) +;; => #{1 2} +
+
+
+Flow control +ClojureScript has a very different approach to flow control than languages like +JavaScript, C, etc. +
+Branching with <literal>if</literal> +Let’s start with a basic one: if. In ClojureScript, the if is an expression +and not a statement, and it has three parameters: the first one is the condition +expression, the second one is an expression that will be evaluated if the condition +expression evaluates to logical true, and the third expression will be evaluated +otherwise. +(defn discount + "You get 5% discount for ordering 100 or more items" + [quantity] + (if (>= quantity 100) + 0.05 + 0)) + +(discount 30) +;; => 0 + +(discount 130) +;; => 0.05 +The block expression do can be used to have multiple expressions in an if +branch. do is explained in the next section. +
+
+Branching with <literal>cond</literal> +Sometimes, the if expression can be slightly limiting because it does not have the +"else if" part to add more than one condition. The cond macro comes to the rescue. +With the cond expression, you can define multiple conditions: +(defn mypos? + [x] + (cond + (> x 0) "positive" + (< x 0) "negative" + :else "zero")) + +(mypos? 0) +;; => "zero" + +(mypos? -2) +;; => "negative" +Also, cond has another form, called condp, that works very similarly to the +simple cond but looks cleaner when the condition (also called a predicate) is the +same for all conditions: +(defn translate-lang-code + [code] + (condp = (keyword code) + :es "Spanish" + :en "English" + "Unknown")) + +(translate-lang-code "en") +;; => "English" + +(translate-lang-code "fr") +;; => "Unknown" +The line condp = (keyword code) means that, in each of the following lines, +ClojureScript will apply the = function to the result of evaluating (keyword +code). +
+
+Branching with <literal>case</literal> +The case branching expression has a similar use as our previous example with +condp. The main differences are that case always uses the = predicate/function +and its branching values are evaluated at compile time. This results in a more +performant form than cond or condp but has the disadvantage that the condition +value must be static. +Here is the previous example rewritten to use case: +(defn translate-lang-code + [code] + (case code + "es" "Spanish" + "en" "English" + "Unknown")) + +(translate-lang-code "en") +;; => "English" + +(translate-lang-code "fr") +;; => "Unknown" +
+
+
+Truthiness +This is the aspect where each language has its own semantics (mostly wrongly). The +majority of languages consider empty collections, the integer 0, and other things +like this to be false. In ClojureScript, unlike in other languages, only two +values are considered as false: nil and false. Everything else is treated as +logical true. +Jointly with the ability to implement the callable protocol (the IFn, explained +more in detail later), data structures like sets can be used just as predicates, +without need of additional wrapping them in a function: +(def valid? #{1 2 3}) + +(filter valid? (range 1 10)) +;; => (1 2 3) +This works because a set returns either the value itself for all contained elements +or nil: +(valid? 1) +;; => 1 + +(valid? 4) +;; => nil +
+
+Locals, Blocks, and Loops +
+Locals +ClojureScript does not have the concept of variables as in ALGOL-like languages, +but it does have locals. Locals, as per usual, are immutable, and if you try to +mutate them, the compiler will throw an error. +Locals are defined with the let expression. The expression starts with a vector as +the first parameter followed by an arbitrary number of expressions. The first +parameter (the vector) should contain an arbitrary number of pairs that give a +binding form (usually a symbol) followed by an expression whose value will be +bound to this new local for the remainder of the let expression. +(let [x (inc 1) + y (+ x 1)] + (println "Simple message from the body of a let") + (* x y)) +;; Simple message from the body of a let +;; => 6 +In the preceding example, the symbol x is bound to the value (inc 1), which +comes out to 2, and the symbol y is bound to the sum of x and 1, which comes out +to 3. Given those bindings, the expressions (println "Simple message from the body +of a let") and (* x y) are evaluated. +
+
+Blocks +In JavaScript, braces { and } delimit a block of code that “belongs +together”. Blocks in ClojureScript are created using the do expression and are +usually used for side effects, like printing something to the console or writing a +log in a logger. +A side effect is something that is not necessary for the return value. +The do expression accepts as its parameter an arbitrary number of other +expressions, but it returns the return value only from the last one: +(do + (println "hello world") + (println "hola mundo") + (* 3 5) ;; this value will not be returned; it is thrown away + (+ 1 2)) + +;; hello world +;; hola mundo +;; => 3 +The body of the let expression, explained in the previous section, is very similar +to the do expression in that it allows multiple expressions. In fact, the let +has an implicit do. +
+
+Loops +The functional approach of ClojureScript means that it does not have standard, +well-known, statement-based loops such as for in JavaScript. The loops in +ClojureScript are handled using recursion. Recursion sometimes requires +additional thinking about how to model your problem in a slightly different way than +imperative languages. +Many of the common patterns for which for is used in other languages are achieved +through higher-order functions - functions that accept other functions as +parameters. +
+Looping with loop/recur +Let’s take a look at how to express loops using recursion with the loop and +recur forms. loop defines a possibly empty list of bindings (notice the +symmetry with let) and recur jumps execution back to the looping point with new +values for those bindings. +Let’s see an example: +(loop [x 0] + (println "Looping with " x) + (if (= x 2) + (println "Done looping!") + (recur (inc x)))) +;; Looping with 0 +;; Looping with 1 +;; Looping with 2 +;; Done looping! +;; => nil +In the above snippet, we bind the name x to the value 0 and execute the +body. Since the condition is not met the first time, it’s rerun with recur, +incrementing the binding value with the inc function. We do this once more until +the condition is met and, since there aren’t any more recur calls, exit the loop. +Note that loop isn’t the only point we can recur to; using recur inside a +function executes the body of the function recursively with the new bindings: +(defn recursive-function + [x] + (println "Looping with" x) + (if (= x 2) + (println "Done looping!") + (recur (inc x)))) + +(recursive-function 0) +;; Looping with 0 +;; Looping with 1 +;; Looping with 2 +;; Done looping! +;; => nil +
+
+Replacing for loops with higher-order functions +In imperative programming languages it is common to use for loops to iterate over +data and transform it, usually with the intent being one of the following: + + +Transform every value in the iterable yielding another iterable + + +Filter the elements of the iterable by certain criteria + + +Convert the iterable to a value where each iteration depends on the result from +the previous one + + +Run a computation for every value in the iterable + + +The above actions are encoded in higher-order functions and syntactic constructs in +ClojureScript; let’s see an example of the first three. +For transforming every value in an iterable data structure we use the map +function, which takes a function and a sequence and applies the function to every +element: +(map inc [0 1 2]) +;; => (1 2 3) +The first parameter for map can be any function that takes one argument and +returns a value. For example, if you had a graphing application and you wanted to +graph the equation y = 3x + 5 for a set of x values, you +could get the y values like this: +(defn y-value [x] (+ (* 3 x) 5)) + +(map y-value [1 2 3 4 5]) +;; => (8 11 14 17 20) +If your function is short, you can use an anonymous function instead, either the +normal or short syntax: +(map (fn [x] (+ (* 3 x) 5)) [1 2 3 4 5]) +;; => (8 11 14 17 20) + +(map #(+ (* 3 %) 5) [1 2 3 4 5]) +;; => (8 11 14 17 20) +For filtering the values of a data structure we use the filter function, which +takes a predicate and a sequence and gives a new sequence with only the elements +that returned true for the given predicate: +(filter odd? [1 2 3 4]) +;; => (1 3) +Again, you can use any function that returns true or false as the first argument +to filter. Here is an example that keeps only words less than five characters +long. (The count function returns the length of its argument.) +(filter (fn [word] (< (count word) 5)) ["ant" "baboon" "crab" "duck" "echidna" "fox"]) +;; => ("ant" "crab" "duck" "fox") +Converting an iterable to a single value, accumulating the intermediate result at +every step of the iteration can be achieved with reduce, which takes a function +for accumulating values, an optional initial value and a collection: +(reduce + 0 [1 2 3 4]) +;; => 10 +Yet again, you can provide your own function as the first argument to reduce, but +your function must have two parameters. The first one is the "accumulated value" +and the second parameter is the collection item being processed. The function +returns a value that becomes the accumulator for the next item in the list. For +example, here is how you would find the sum of squares of a set of numbers (this is +an important calculation in statistics). Using a separate function: +(defn sum-squares + [accumulator item] + (+ accumulator (* item item))) + +(reduce sum-squares 0 [3 4 5]) +;; => 50 +…​and with an anonymous function: +(reduce (fn [acc item] (+ acc (* item item))) 0 [3 4 5]) +;; => 50 +Here is a reduce that finds the total number of characters in a set of words: +(reduce (fn [acc word] (+ acc (count word))) 0 ["ant" "bee" "crab" "duck"]) +;; => 14 +We have not used the short syntax here because, although it requires less typing, it +can be less readable, and when you are starting with a new language, it’s important +to be able to read what you wrote! If you are comfortable with the short syntax, +feel free to use it. +Remember to choose your starting value for the accumulator carefully. If you wanted +to use reduce to find the product of a series of numbers, you would have to start +with one rather than zero, otherwise all the numbers would be multiplied by zero! +;; wrong starting value +(reduce * 0 [3 4 5]) +;; => 0 + +;; correct starting accumulator +(reduce * 1 [3 4 5]) +;; => 60 +
+
+<literal>for</literal> sequence comprehensions +In ClojureScript, the for construct isn’t used for iteration but for generating +sequences, an operation also known as "sequence comprehension". In this section +we’ll learn how it works and use it to declaratively build sequences. +for takes a vector of bindings and an expression and generates a sequence of the +result of evaluating the expression. Let’s take a look at an example: +(for [x [1 2 3]] + [x (* x x)]) +;; => ([1 1] [2 4] [3 9]) +In this example, x is bound to each of the items in the vector [1 2 3] in turn, +and returns a new sequence of two-item vectors with the original item squared. +for supports multiple bindings, which will cause the collections to be iterated in +a nested fashion, much like nesting for loops in imperative languages. The +innermost binding iterates “fastest.” +(for [x [1 2 3] + y [4 5]] + [x y]) + +;; => ([1 4] [1 5] [2 4] [2 5] [3 4] [3 5]) +We can also follow the bindings with three modifiers: :let for creating local +bindings, :while for breaking out of the sequence generation, and :when for +filtering out values. +Here’s an example of local bindings using the :let modifier; note that the +bindings defined with it will be available in the expression: +(for [x [1 2 3] + y [4 5] + :let [z (+ x y)]] + z) +;; => (5 6 6 7 7 8) +We can use the :while modifier for expressing a condition that, when it is no +longer met, will stop the sequence generation. Here’s an example: +(for [x [1 2 3] + y [4 5] + :while (= y 4)] + [x y]) + +;; => ([1 4] [2 4] [3 4]) +For filtering out generated values, use the :when modifier as in the following +example: +(for [x [1 2 3] + y [4 5] + :when (= (+ x y) 6)] + [x y]) + +;; => ([1 5] [2 4]) +We can combine the modifiers shown above for expressing complex sequence generations +or more clearly expressing the intent of our comprehension: +(for [x [1 2 3] + y [4 5] + :let [z (+ x y)] + :when (= z 6)] + [x y]) + +;; => ([1 5] [2 4]) +When we outlined the most common usages of the for construct in imperative +programming languages, we mentioned that sometimes we want to run a computation for +every value in a sequence, not caring about the result. Presumably we do this for +achieving some sort of side-effect with the values of the sequence. +ClojureScript provides the doseq construct, which is analogous to for but +executes the expression, discards the resulting values, and returns nil. +(doseq [x [1 2 3] + y [4 5] + :let [z (+ x y)]] + (println x "+" y "=" z)) + +;; 1 + 4 = 5 +;; 1 + 5 = 6 +;; 2 + 4 = 6 +;; 2 + 5 = 7 +;; 3 + 4 = 7 +;; 3 + 5 = 8 +;; => nil +If you want just iterate and apply some side effectfull operation (like println) +over each item in the collection, you can just use the specialized function run! +that internally uses fast reduction: +(run! println [1 2 3]) +;; 1 +;; 2 +;; 3 +;; => nil +This function explicitly returns nil. +
+
+
+
+Collection types +
+Immutable and persistent +We mentioned before that ClojureScript collections are persistent and immutable, but +we didn’t explain what that meant. +An immutable data structure, as its name suggests, is a data structure that cannot +be changed. In-place updates are not allowed in immutable data structures. +Let’s illustrate that with an example: appending values to a vector using the conj +(conjoin) operation. +(let [xs [1 2 3] + ys (conj xs 4)] + (println "xs:" xs) + (println "ys:" ys)) + +;; xs: [1 2 3] +;; ys: [1 2 3 4] +;; => nil +As you can see, we derived a new version of the xs vector appending an element +to it and got a new vector ys with the element added. However, the xs vector +remained unchanged because it is immutable. +A persistent data structure is a data structure that returns a new version of +itself when transforming it, leaving the original unmodified. ClojureScript makes +this memory and time efficient using an implementation technique called structural +sharing, where most of the data shared between two versions of a value is not +duplicated and transformations of a value are implemented by copying the minimal +amount of data required. +If you want to see an example of how structural sharing works, read on. If you’re +not interested in more details you can skip over to the +next section. +For illustrating the structural sharing of ClojureScript data structures, let’s +compare whether some parts of the old and new versions of a data structure are +actually the same object with the identical? predicate. We’ll use the list data +type for this purpose: +(let [xs (list 1 2 3) + ys (cons 0 xs)] + (println "xs:" xs) + (println "ys:" ys) + (println "(rest ys):" (rest ys)) + (identical? xs (rest ys))) + +;; xs: (1 2 3) +;; ys: (0 1 2 3) +;; (rest ys): (1 2 3) +;; => true +As you can see in the example, we used cons (construct) to prepend a value to +the xs list and we got a new list ys with the element added. The rest of +the ys list (all the values but the first) are the same object in memory as the +xs list, thus xs and ys share structure. +
+
+The sequence abstraction +One of the central ClojureScript abstractions is the sequence which can be +thought of as a list and can be derived from any of the collection types. It is +persistent and immutable like all collection types, and many of the core +ClojureScript functions return sequences. +The types that can be used to generate a sequence are called "seqables"; we can +call seq on them and get a sequence back. Sequences support two basic operations: +first and rest. They both call seq on the argument we provide them: +(first [1 2 3]) +;; => 1 + +(rest [1 2 3]) +;; => (2 3) +Calling seq on a seqable can yield different results if the seqable is empty or +not. It will return nil when empty and a sequence otherwise: +(seq []) +;; => nil + +(seq [1 2 3]) +;; => (1 2 3) +next is a similar sequence operation to rest, but it differs from the latter +in that it yields a nil value when called with a sequence with one or zero +elements. Note that, when given one of the aforementioned sequences, the empty +sequence returned by rest will evaluate as a boolean true whereas the nil +value returned by next will evaluate as false +(see the section on truthiness later in this chapter). +(rest []) +;; => () + +(next []) +;; => nil + +(rest [1 2 3]) +;; => (2 3) + +(next [1 2 3]) +;; => (2 3) +
+nil-punning +Since seq returns nil when the collection is empty, and nil evaluates to +false in boolean context, you can check to see if a collection is empty by using +the seq function. The technical term for this is nil-punning. +(defn print-coll + [coll] + (when (seq coll) + (println "Saw " (first coll)) + (recur (rest coll)))) + +(print-coll [1 2 3]) +;; Saw 1 +;; Saw 2 +;; Saw 3 +;; => nil + +(print-coll #{1 2 3}) +;; Saw 1 +;; Saw 3 +;; Saw 2 +;; => nil +Though nil is neither a seqable nor a sequence, it is supported by all the +functions we saw so far: +(seq nil) +;; => nil + +(first nil) +;; => nil + +(rest nil) +;; => () +
+
+Functions that work on sequences +The ClojureScript core functions for transforming collections make sequences out +of their arguments and are implemented in terms of the generic sequence operations +we learned about in the preceding section. This makes them highly generic because +we can use them on any data type that is seqable. Let’s see how we can use map +with a variety of seqables: +(map inc [1 2 3]) +;; => (2 3 4) + +(map inc #{1 2 3}) +;; => (2 4 3) + +(map count {:a 41 :b 40}) +;; => (2 2) + +(map inc '(1 2 3)) +;; => (2 3 4) + +When you use the map function on a map collection, your higher-order +function will receive a two-item vector containing a key and value from the map. +The following example uses destructuring to access +the key and value. + +(map (fn [[key value]] (* value value)) + {:ten 10 :seven 7 :four 4}) +;; => (100 49 16) +Obviously the same operation can be done in more idiomatic way only obtaining a seq +of values: +(map (fn [value] (* value value)) + (vals {:ten 10 :seven 7 :four 4})) +;; => (100 49 16) +As you may have noticed, functions that operate on sequences are safe to use with +empty collections or even nil values since they don’t need to do anything but +return an empty sequence when encountering such values. +(map inc []) +;; => () + +(map inc #{}) +;; => () + +(map inc nil) +;; => () +We already saw examples with the usual suspects like map, filter, and reduce, +but ClojureScript offers a plethora of generic sequence operations in its core +namespace. Note that many of the operations we’ll learn about either work with +seqables or are extensible to user-defined types. +We can query a value to know whether it’s a collection type with the coll? +predicate: +(coll? nil) +;; => false + +(coll? [1 2 3]) +;; => true + +(coll? {:language "ClojureScript" :file-extension "cljs"}) +;; => true + +(coll? "ClojureScript") +;; => false +Similar predicates exist for checking if a value is a sequence (with seq?) or a +seqable (with seqable?): +(seq? nil) +;; => false +(seqable? nil) +;; => false + +(seq? []) +;; => false +(seqable? []) +;; => true + +(seq? #{1 2 3}) +;; => false +(seqable? #{1 2 3}) +;; => true + +(seq? "ClojureScript") +;; => false +(seqable? "ClojureScript") +;; => false +For collections that can be counted in constant time, we can use the count +operation. This operation also works on strings, even though, as you have seen, +they are not collections, sequences, or seqable. +(count nil) +;; => 0 + +(count [1 2 3]) +;; => 3 + +(count {:language "ClojureScript" :file-extension "cljs"}) +;; => 2 + +(count "ClojureScript") +;; => 13 +We can also get an empty variant of a given collection with the empty function: +(empty nil) +;; => nil + +(empty [1 2 3]) +;; => [] + +(empty #{1 2 3}) +;; => #{} +The empty? predicate returns true if the given collection is empty: +(empty? nil) +;; => true + +(empty? []) +;; => true + +(empty? #{1 2 3}) +;; => false +The conj operation adds elements to collections and may add them in different +"places" depending on the type of collection. It adds them where it is most +performant for the collection type, but note that not every collection has a +defined order. +We can pass as many elements as we want to add to conj; let’s see it in action: +(conj nil 42) +;; => (42) + +(conj [1 2] 3) +;; => [1 2 3] + +(conj [1 2] 3 4 5) +;; => [1 2 3 4 5] + +(conj '(1 2) 0) +;; => (0 1 2) + +(conj #{1 2 3} 4) +;; => #{1 3 2 4} + +(conj {:language "ClojureScript"} [:file-extension "cljs"]) +;; => {:language "ClojureScript", :file-extension "cljs"} +
+
+Laziness +Most of ClojureScript’s sequence-returning functions generate lazy sequences instead +of eagerly creating a whole new sequence. Lazy sequences generate their contents as +they are requested, usually when iterating over them. Laziness ensures that we don’t +do more work than we need to and gives us the possibility of treating potentially +infinite sequences as regular ones. +Consider the range function, which generates a range of integers: +(range 5) +;; => (0 1 2 3 4) +(range 1 10) +;; => (1 2 3 4 5 6 7 8 9) +(range 10 100 15) +;; (10 25 40 55 70 85) +If you just say (range), you will get an infinite sequence of all the integers. +Do not try this in the REPL, unless you are prepared to wait for a very, very long +time, because the REPL wants to fully evaluate the expression. +Here is a contrived example. Let’s say you are writing a graphing program and you +are graphing the equation y= 2 x 2 + 5, and you want only those values of x +for which the y value is less than 100. You can generate all the numbers 0 through +100, which will certainly be enough, and then take-while the condition holds: +(take-while (fn [x] (< (+ (* 2 x x) 5) 100)) + (range 0 100)) +;; => (0 1 2 3 4 5 6) +
+
+
+Collections in depth +Now that we’re acquainted with ClojureScript’s sequence abstraction and some of the +generic sequence manipulating functions, it’s time to dive into the concrete +collection types and the operations they support. +
+Lists +In ClojureScript, lists are mostly used as a data structure for grouping symbols +together into programs. Unlike in other Lisps, many of the syntactic constructs of +ClojureScript use data structures different from the list (vectors and maps). This +makes code less uniform, but the gains in readability are well worth the price. +You can think of ClojureScript lists as singly linked lists, where each node +contains a value and a pointer to the rest of the list. This makes it natural (and +fast!) to add items to the front of the list, since adding to the end would require +traversal of the entire list. The prepend operation is performed using the cons +function. +(cons 0 (cons 1 (cons 2 ()))) +;; => (0 1 2) +We used the literal () to represent the empty list. Since it doesn’t contain any +symbols, it is not treated as a function call. However, when using list literals +that contain elements, we need to quote them to prevent ClojureScript from +evaluating them as a function call: +(cons 0 '(1 2)) +;; => (0 1 2) +Since the head is the position that has constant time addition in the list +collection, the conj operation on lists naturally adds items to the front: +(conj '(1 2) 0) +;; => (0 1 2) +Lists and other ClojureScript data structures can be used as stacks using the +peek, pop, and conj functions. Note that the top of the stack will be the +"place" where conj adds elements, making conj equivalent to the stack’s push +operation. In the case of lists, conj adds elements to the front of the list, +peek returns the first element of the list, and pop returns a list with all the +elements but the first one. +Note that the two operations that return a stack (conj and pop) don’t change the +type of the collection used for the stack. +(def list-stack '(0 1 2)) + +(peek list-stack) +;; => 0 + +(pop list-stack) +;; => (1 2) + +(type (pop list-stack)) +;; => cljs.core/List + +(conj list-stack -1) +;; => (-1 0 1 2) + +(type (conj list-stack -1)) +;; => cljs.core/List +One thing that lists are not particularly good at is random indexed access. Since +they are stored in a single linked list-like structure in memory, random access to a +given index requires a linear traversal in order to either retrieve the requested +item or throw an index out of bounds error. Non-indexed ordered collections like +lazy sequences also suffer from this limitation. +
+
+Vectors +Vectors are one of the most common data structures in ClojureScript. They are used +as a syntactic construct in many places where more traditional Lisps use lists, for +example in function argument declarations and let bindings. +ClojureScript vectors have enclosing brackets [] in their syntax literals. They +can be created with vector and from another collection with vec: +(vector? [0 1 2]) +;; => true + +(vector 0 1 2) +;; => [0 1 2] + +(vec '(0 1 2)) +;; => [0 1 2] +Vectors are, like lists, ordered collections of heterogeneous values. Unlike lists, +vectors grow naturally from the tail, so the conj operation appends items to the +end of a vector. Insertion on the end of a vector is effectively constant time: +(conj [0 1] 2) +;; => [0 1 2] +Another thing that differentiates lists and vectors is that vectors are indexed +collections and as such support efficient random index access and non-destructive +updates. We can use the nth function to retrieve values given an index: +(nth [0 1 2] 0) +;; => 0 +Since vectors associate sequential numeric keys (indexes) to values, we can treat +them as an associative data structure. ClojureScript provides the assoc function +that, given an associative data structure and a set of key-value pairs, yields a new +data structure with the values corresponding to the keys modified. Indexes begin at +zero for the first element in a vector. +(assoc ["cero" "uno" "two"] 2 "dos") +;; => ["cero" "uno" "dos"] +Note that we can only assoc to a key that is either contained in the vector +already or if it is the last position in a vector: +(assoc ["cero" "uno" "dos"] 3 "tres") +;; => ["cero" "uno" "dos" "tres"] + +(assoc ["cero" "uno" "dos"] 4 "cuatro") +;; Error: Index 4 out of bounds [0,3] +Perhaps surprisingly, associative data structures can also be used as +functions. They are functions of their keys to the values they are associated +with. In the case of vectors, if the given key is not present an exception is +thrown: +(["cero" "uno" "dos"] 0) +;; => "cero" + +(["cero" "uno" "dos"] 2) +;; => "dos" + +(["cero" "uno" "dos"] 3) +;; Error: Not item 3 in vector of length 3 +As with lists, vectors can also be used as stacks with the peek, pop, and conj +functions. Note, however, that vectors grow from the opposite end of the collection +as lists: +(def vector-stack [0 1 2]) + +(peek vector-stack) +;; => 2 + +(pop vector-stack) +;; => [0 1] + +(type (pop vector-stack)) +;; => cljs.core/PersistentVector + +(conj vector-stack 3) +;; => [0 1 2 3] + +(type (conj vector-stack 3)) +;; => cljs.core/PersistentVector +The map and filter operations return lazy sequences, but as it is common to need +a fully realized sequence after performing those operations, vector-returning +counterparts of such functions are available as mapv and filterv. They have the +advantages of being faster than building a vector from a lazy sequence and making +your intent more explicit: +(map inc [0 1 2]) +;; => (1 2 3) + +(type (map inc [0 1 2])) +;; => cljs.core/LazySeq + +(mapv inc [0 1 2]) +;; => [1 2 3] + +(type (mapv inc [0 1 2])) +;; => cljs.core/PersistentVector +
+
+Maps +Maps are ubiquitous in ClojureScript. Like vectors, they are also used as a +syntactic construct, particularly for attaching metadata to +vars. Any ClojureScript data structure can be used as a key in a map, although it’s +common to use keywords since they can also be called as functions. +ClojureScript maps are written literally as key-value pairs enclosed in braces +{}. Alternatively, they can be created with the hash-map function: +(map? {:name "Cirilla"}) +;; => true + +(hash-map :name "Cirilla") +;; => {:name "Cirilla"} + +(hash-map :name "Cirilla" :surname "Fiona") +;; => {:name "Cirilla" :surname "Fiona"} +Since regular maps don’t have a specific order, the conj operation just adds one +or more key-value pairs to a map. conj for maps expects one or more sequences of +key-value pairs as its last arguments: +(def ciri {:name "Cirilla"}) + +(conj ciri [:surname "Fiona"]) +;; => {:name "Cirilla", :surname "Fiona"} + +(conj ciri [:surname "Fiona"] [:occupation "Wizard"]) +;; => {:name "Cirilla", :surname "Fiona", :occupation "Wizard"} +In the preceding example, it just so happens that the order was preserved, but if +you have many keys, you will see that the order is not preserved. +Maps associate keys to values and, as such, are an associative data structure. They +support adding associations with assoc and, unlike vectors, removing them with +dissoc. assoc will also update the value of an existing key. Let’s explore these +functions: +(assoc {:name "Cirilla"} :surname "Fiona") +;; => {:name "Cirilla", :surname "Fiona"} +(assoc {:name "Cirilla"} :name "Alfonso") +;; => {:name "Alfonso"} +(dissoc {:name "Cirilla"} :name) +;; => {} +Maps are also functions of their keys, returning the values related to the given +keys. Unlike vectors, they return nil if we supply a key that is not present in +the map: +({:name "Cirilla"} :name) +;; => "Cirilla" + +({:name "Cirilla"} :surname) +;; => nil +ClojureScript also offers sorted hash maps which behave like their unsorted versions +but preserve order when iterating over them. We can create a sorted map with default +ordering with sorted-map: +(def sm (sorted-map :c 2 :b 1 :a 0)) +;; => {:a 0, :b 1, :c 2} + +(keys sm) +;; => (:a :b :c) +If we need a custom ordering we can provide a comparator function to +sorted-map-by, let’s see an example inverting the value returned by the built-in +compare function. Comparator functions take two items to compare and return -1 (if +the first item is less than the second), 0 (if they are equal), or 1 (if the first +item is greater than the second). +(defn reverse-compare [a b] (compare b a)) + +(def sm (sorted-map-by reverse-compare :a 0 :b 1 :c 2)) +;; => {:c 2, :b 1, :a 0} + +(keys sm) +;; => (:c :b :a) +
+
+Sets +Sets in ClojureScript have literal syntax as values enclosed in #{} and they can +be created with the set constructor. They are unordered collections of values +without duplicates. +(set? #{\a \e \i \o \u}) +;; => true + +(set [1 1 2 3]) +;; => #{1 2 3} +Set literals cannot contain duplicate values. If you accidentally write a set +literal with duplicates an error will be thrown: +#{1 1 2 3} +;; clojure.lang.ExceptionInfo: Duplicate key: 1 +There are many operations that can be performed with sets, although they are located +in the clojure.set namespace and thus need to be imported. You’ll learn +the details of namespacing later; for now, you only need to +know that we are loading a namespace called clojure.set and binding it to the s +symbol. +(require '[clojure.set :as s]) + +(def danish-vowels #{\a \e \i \o \u \æ \ø \å}) +;; => #{"a" "e" "å" "æ" "i" "o" "u" "ø"} + +(def spanish-vowels #{\a \e \i \o \u}) +;; => #{"a" "e" "i" "o" "u"} + +(s/difference danish-vowels spanish-vowels) +;; => #{"å" "æ" "ø"} + +(s/union danish-vowels spanish-vowels) +;; => #{"a" "e" "å" "æ" "i" "o" "u" "ø"} + +(s/intersection danish-vowels spanish-vowels) +;; => #{"a" "e" "i" "o" "u"} +A nice property of immutable sets is that they can be nested. Languages that have +mutable sets can end up containing duplicate values, but that can’t happen in +ClojureScript. In fact, all ClojureScript data structures can be nested arbitrarily +due to immutability. +Sets also support the generic conj operation just like every other collection does. +(def spanish-vowels #{\a \e \i \o \u}) +;; => #{"a" "e" "i" "o" "u"} + +(def danish-vowels (conj spanish-vowels \æ \ø \å)) +;; => #{"a" "e" "i" "o" "u" "æ" "ø" "å"} + +(conj #{1 2 3} 1) +;; => #{1 3 2} +Sets act as read-only associative data that associates the values it contains to +themselves. Since every value except nil and false is truthy in ClojureScript, +we can use sets as predicate functions: +(def vowels #{\a \e \i \o \u}) +;; => #{"a" "e" "i" "o" "u"} + +(get vowels \b) +;; => nil + +(contains? vowels \b) +;; => false + +(vowels \a) +;; => "a" + +(vowels \z) +;; => nil + +(filter vowels "Hound dog") +;; => ("o" "u" "o") +Sets have a sorted counterpart like maps do that are created using the functions +sorted-set and sorted-set-by which are analogous to map’s sorted-map and +sorted-map-by. +(def unordered-set #{[0] [1] [2]}) +;; => #{[0] [2] [1]} + +(seq unordered-set) +;; => ([0] [2] [1]) + +(def ordered-set (sorted-set [0] [1] [2])) +;; =># {[0] [1] [2]} + +(seq ordered-set) +;; => ([0] [1] [2]) +
+
+Queues +ClojureScript also provides a persistent and immutable queue. Queues are not used as +pervasively as other collection types. They can be created using the #queue [] +literal syntax, but there are no convenient constructor functions for them. +(def pq #queue [1 2 3]) +;; => #queue [1 2 3] +Using conj to add values to a queue adds items onto the rear: +(def pq #queue [1 2 3]) +;; => #queue [1 2 3] + +(conj pq 4 5) +;; => #queue [1 2 3 4 5] +A thing to bear in mind about queues is that the stack operations don’t follow the +usual stack semantics (pushing and popping from the same end). pop takes values +from the front position, and conj pushes (appends) elements to the back. +(def pq #queue [1 2 3]) +;; => #queue [1 2 3] + +(peek pq) +;; => 1 + +(pop pq) +;; => #queue [2 3] + +(conj pq 4) +;; => #queue [1 2 3 4] +Queues are not as frequently used as lists or vectors, but it is good to know that +they are available in ClojureScript, as they may occasionally come in handy. +
+
+
+
+Destructuring +Destructuring, as its name suggests, is a way of taking apart structured data such +as collections and focusing on individual parts of them. ClojureScript offers a +concise syntax for destructuring both indexed sequences and associative data +structures that can be used any place where bindings are declared. +Let’s see an example of what destructuring is useful for that will help us +understand the previous statements better. Imagine that you have a sequence but are +only interested in the first and third item. You could get a reference to them +easily with the nth function: +(let [v [0 1 2] + fst (nth v 0) + thrd (nth v 2)] + [thrd fst]) +;; => [2 0] +However, the previous code is overly verbose. Destructuring lets us extract values +of indexed sequences more succintly using a vector on the left-hand side of a +binding: +(let [[fst _ thrd] [0 1 2]] + [thrd fst]) +;; => [2 0] +In the above example, [fst _ thrd] is a destructuring form. It is represented as a +vector and used for binding indexed values to the symbols fst and thrd, +corresponding to the index 0 and 2, respectively. The _ symbol is used as a +placeholder for indexes we are not interested in — in this case 1. +Note that destructuring is not limited to the let binding form; it works in almost +every place where we bind values to symbols such as in the for and doseq special +forms or in function arguments. We can write a function that takes a pair and swaps +its positions very concisely using destructuring syntax in function arguments: +(defn swap-pair [[fst snd]] + [snd fst]) + +(swap-pair [1 2]) +;; => [2 1] + +(swap-pair '(3 4)) +;; => [4 3] +Positional destructuring with vectors is quite handy for taking indexed values out +of sequences, but sometimes we don’t want to discard the rest of the elements in the +sequence when destructuring. Similarly to how & is used for accepting variadic +function arguments, the ampersand can be used inside a vector destructuring form for +grouping together the rest of a sequence: +(let [[fst snd & more] (range 10)] + {:first fst + :snd snd + :rest more}) +;; => {:first 0, :snd 1, :rest (2 3 4 5 6 7 8 9)} +Notice how the value in the 0 index got bound to fst, the value in the 1 index +got bound to snd, and the sequence of elements from 2 onwards got bound to the +more symbol. +We may still be interested in a data structure as a whole even when we are +destructuring it. This can be achieved with the :as keyword. If used inside a +destructuring form, the original data structure is bound to the symbol following +that keyword: +(let [[fst snd & more :as original] (range 10)] + {:first fst + :snd snd + :rest more + :original original}) +;; => {:first 0, :snd 1, :rest (2 3 4 5 6 7 8 9), :original (0 1 2 3 4 5 6 7 8 9)} +Not only can indexed sequences be destructured, but associative data can also be +destructured. Its destructuring binding form is represented as a map instead of a +vector, where the keys are the symbols we want to bind values to and the values are +the keys that we want to look up in the associative data structure. Let’s see an +example: +(let [{language :language} {:language "ClojureScript"}] + language) +;; => "ClojureScript" +In the above example, we are extracting the value associated with the :language +key and binding it to the language symbol. When looking up keys that are not +present, the symbol will get bound to nil: +(let [{name :name} {:language "ClojureScript"}] + name) +;; => nil +Associative destructuring lets us give default values to bindings which will be used +if the key isn’t found in the data structure we are taking apart. A map following +the :or keyword is used for default values as the following examples show: +(let [{name :name :or {name "Anonymous"}} {:language "ClojureScript"}] + name) +;; => "Anonymous" + +(let [{name :name :or {name "Anonymous"}} {:name "Cirilla"}] + name) +;; => "Cirilla" +Associative destructuring also supports binding the original data structure to a +symbol placed after the :as keyword: +(let [{name :name :as person} {:name "Cirilla" :age 49}] + [name person]) +;; => ["Cirilla" {:name "Cirilla" :age 49}] +Keywords aren’t the only things that can be the keys of associative data structures. +Numbers, strings, symbols and many other data structures can be used as keys, so we +can destructure using those, too. Note that we need to quote the symbols to prevent +them from being resolved as a var lookup: +(let [{one 1} {0 "zero" 1 "one"}] + one) +;; => "one" + +(let [{name "name"} {"name" "Cirilla"}] + name) +;; => "Cirilla" + +(let [{lang 'language} {'language "ClojureScript"}] + lang) +;; => "ClojureScript" +Since the values corresponding to keys are usually bound to their equivalent symbol +representation (for example, when binding the value of :language to the symbol +language) and keys are usually keywords, strings, or symbols, ClojureScript offers +shorthand syntax for these cases. +We’ll show examples of all of these, starting with destructuring keywords using +:keys: +(let [{:keys [name surname]} {:name "Cirilla" :surname "Fiona"}] + [name surname]) +;; => ["Cirilla" "Fiona"] +As you can see in the example, if we use the :keys keyword and associate it with a +vector of symbols in a binding form, the values corresponding to the keywordized +version of the symbols will be bound to them. The {:keys [name surname]} +destructuring is equivalent to {name :name surname :surname}, only shorter. +The string and symbol shorthand syntax works exactly like :keys, but using the +:strs and :syms keywords respectively: +(let [{:strs [name surname]} {"name" "Cirilla" "surname" "Fiona"}] + [name surname]) +;; => ["Cirilla" "Fiona"] + +(let [{:syms [name surname]} {'name "Cirilla" 'surname "Fiona"}] + [name surname]) +;; => ["Cirilla" "Fiona"] +If the map you want to destructure has namespaced keywords as keys, you also can +do it using the keyword syntax inside :keys vector: +(let [{:keys [::name ::surname]} {::name "Cirilla" ::surname "Fiona"}] + [name surname]) +;; => ["Cirilla" "Fiona"] +An interesting property of destructuring is that we can nest destructuring forms +arbitrarily, which makes code that accesses nested data on a collection very easy to +understand, as it mimics the collection’s structure: +(let [{[fst snd] :languages} {:languages ["ClojureScript" "Clojure"]}] + [snd fst]) +;; => ["Clojure" "ClojureScript"] +
+
+Threading Macros +Threading macros, also known as arrow functions, enables one to write +more readable code when multiple nested function calls are performed. +Imagine you have (f (g (h x))) where a function f receives as its first +parameter the result of executing function g, repeated multiple times. With +the most basic → threading macro you can convert that into (-> x (h) (g) +(f)) which is easier to read. +The result is syntactic sugar, because the arrow functions are defined as macros +and it does not imply any runtime performance. The (-> x (h) (g) (f)) is +automatically converted to (f (g (h x))) at compile time. +Take note that the parenthesis on h, g and f are optional, and can be +ommited: (f (g (h x))) is the same as (-> x h g f). +
+<literal>-></literal> (thread-first macro) +This is called thread first because it threads the first argument throught the +different expressions as first arguments. +Using a more concrete example, this is how the code looks without using +threading macros: +(def book {:name "Lady of the Lake" + :readers 0}) + +(update (assoc book :age 1999) :readers inc) +;; => {:name "Lady of the lake" :age 1999 :readers 1} +We can rewrite that code to use the -> threading macro: +(-> book + (assoc :age 1999) + (update :readers inc)) +;; => {:name "Lady of the lake" :age 1999 :readers 1} +This threading macro is especially useful for transforming data structures, +because ClojureScript (and Clojure) functions for data structures +transformations consistently uses the first argument for receive the data +structure. +
+
+<literal>->></literal> (thread-last macro) +The main difference between the thread-last and thread-first macros is that instead +of threading the first argument given as the first argument on the following expresions, +it threads it as the last argument. +Let’s look at an example: +(def numbers [1 2 3 4 5 6 7 8 9 0]) + +(take 2 (filter odd? (map inc numbers))) +;; => (3 5) +The same code written using ->> threading macro: +(->> numbers + (map inc) + (filter odd?) + (take 2)) +;; => (3 5) +This threading macro is especially useful for transforming sequences or collections +of data because ClojureScript functions that work with sequences and collections +consistently use the last argument position to receive them. +
+
+<literal>as-></literal> (thread-as macro) +Finally, there are cases where neither -> nor ->> are applicable. In these +cases, you’ll need to use as->, the more flexible alternative, that allows +you to thread into any argument position, not just the first or last. +It expects two fixed arguments and an arbitrary number of expressions. As with +->, the first argument is a value to be threaded through the following +forms. The second argument is the name of a binding. In each of the subsequent +forms, the bound name can be used for the prior expression’s result. +Let’s see an example: +(as-> numbers $ + (map inc $) + (filter odd? $) + (first $) + (hash-map :result $ :id 1)) +;; => {:result 3 :id 1} +
+
+<literal>some-></literal>, <literal>some->></literal> (thread-some macros) +Two of the more specialized threading macros that ClojureScript comes with. They work +in the same way as their analagous -> and ->> macros with the additional +support for short-circuiting the expression if one of the expresions evaluates +to nil. +Let’s see another example: +(some-> (rand-nth [1 nil]) + (inc)) +;; => 2 + +(some-> (rand-nth [1 nil]) + (inc)) +;; => nil +This is an easy way avoid null pointer exceptions. +
+
+<literal>cond-></literal>, <literal>cond->></literal> (thread-cond macros) +The cond-> and cond->> macros are analogous to -> and ->> that offers +the ability to conditionally skip some steps from the pipeline. Let see an example: +(defn describe-number + [n] + (cond-> [] + (odd? n) (conj "odd") + (even? n) (conj "even") + (zero? n) (conj "zero") + (pos? n) (conj "positive"))) + +(describe-number 3) +;; => ["odd" "positive"] + +(describe-number 4) +;; => ["even" "positive"] +The value threading only happens when the corresponding condition evaluates to +logical true. +
+
+Additional Readings + + +http://www.spacjer.com/blog/2015/11/09/lesser-known-clojure-variants-of-threading-macro/ + + +http://clojure.org/guides/threading_macros + + +
+
+
+Reader Conditionals +This language feature allows different dialects of Clojure to share common code that +is mostly platform independent but need some platform dependent code. +To use reader conditionals, all you need is to rename your source file with +.cljs extension to one with .cljc, because reader conditionals only work if +they are placed in files with .cljc extension. +
+Standard (<literal>#?</literal>) +There are two types of reader conditionals, standard and splicing. The standard +reader conditional behaves similarly to a traditional cond and the syntax looks +like this: +(defn parse-int + [v] + #?(:clj (Integer/parseInt v) + :cljs (js/parseInt v))) +As you can observe, #? reading macro looks very similar to cond, the difference is +that the condition is just a keyword that identifies the platform, where :cljs is +for ClojureScript and :clj is for Clojure. The advantage of this approach, is +that it is evaluated at compile time so no runtime performance overhead exists for +using this. +
+
+Splicing (<literal>#?@</literal>) +The splicing reader conditional works in the same way as the standard and allows +splice lists into the containing form. The #?@ reader macro is used for that +and the code looks like this: +(defn make-list + [] + (list #?@(:clj [5 6 7 8] + :cljs [1 2 3 4]))) + +;; On ClojureScript +(make-list) +;; => (1 2 3 4) +The ClojureScript compiler will read that code as this: +(defn make-list + [] + (list 1 2 3 4)) +The splicing reader conditional can’t be used to splice multiple top level forms, +so the following code is ilegal: +#?@(:cljs [(defn func-a [] :a) + (defn func-b [] :b)]) +;; => #error "Reader conditional splicing not allowed at the top level." +If you need so, you can use multiple forms or just use do block for group +multiple forms together: +#?(:cljs (defn func-a [] :a)) +#?(:cljs (defn func-b [] :b)) + +;; Or + +#?(:cljs + (do + (defn func-a [] :a) + (defn func-b [] :b))) +
+
+More readings + + +http://clojure.org/guides/reader_conditionals + + +https://danielcompton.net/2015/06/10/clojure-reader-conditionals-by-example + + +https://github.com/funcool/cuerdas (example small project that uses +reader conditionals) + + +
+
+
+Namespaces +
+Defining a namespace +The namespace is ClojureScript’s fundamental unit of code modularity. Namespaces +are analogous to Java packages or Ruby and Python modules and can be defined with +the ns macro. If you have ever looked at a little bit of ClojureScript source, you +may have noticed something like this at the beginning of the file: +(ns myapp.core + "Some docstring for the namespace.") + +(def x "hello") +Namespaces are dynamic, meaning you can create one at any time. However, the +convention is to have one namespace per file. Naturally, a namespace definition is +usually at the beginning of the file, followed by an optional docstring. +Previously we have explained vars and symbols. Every var that you define will be +associated with its namespace. If you do not define a concrete namespace, then the +default one called "cljs.user" will be used: +(def x "hello") +;; => #'cljs.user/x +
+
+Loading other namespaces +Defining a namespace and the vars in it is really easy, but it’s not very useful if +we can’t use symbols from other namespaces. For this purpose, the ns macro offers +a simple way to load other namespaces. +Observe the following: +(ns myapp.main + (:require myapp.core + clojure.string)) + +(clojure.string/upper-case myapp.core/x) +;; => "HELLO" +As you can observe, we are using fully qualified names (namespace + var name) for +access to vars and functions from different namespaces. +While this will let you access other namespaces, it’s also repetitive and overly +verbose. It will be especially uncomfortable if the name of a namespace is very +long. To solve that, you can use the :as directive to create an additional +(usually shorter) alias to the namespace. This is how it can be done: +(ns myapp.main + (:require [myapp.core :as core] + [clojure.string :as str])) + +(str/upper-case core/x) +;; => "HELLO" +One peculiarity of the namespace aliases, is that they can be used to obtain +namespaced keywords from a specific namespace: +(ns myapp.main + (:require [myapp.core :as c])) + +::c/foo +;; => :myapp.core/foo +In the same way, you can namespace all the keys on the moment of creation of a +map: +(def x #::c {:a 1}) + +x +;; => #:myapp.core{:a 1} + +(::c/a x) +;; => 1 +Additionally, ClojureScript offers a simple way to refer to specific vars or +functions from a concrete namespace using the :refer directive, followed by a +sequence of symbols that will refer to vars in the namespace. Effectively, it is as +if those vars and functions are now part of your namespace, and you do not need to +qualify them at all. +(ns myapp.main + (:require [clojure.string :refer [upper-case]])) +(upper-case x) +;; => "HELLO" +And finally, you should know that everything located in the cljs.core namespace is +automatically loaded and you should not require it explicitly. Sometimes you may +want to declare vars that will clash with some others defined in the cljs.core +namespace. To do this, the ns macro offers another directive that allows you to +exclude specific symbols and prevent them from being automatically loaded. +Observe the following: +(ns myapp.main + (:refer-clojure :exclude [min])) + +(defn min + [x y] + (if (> x y) + y + x)) +The ns macro also has other directives for loading host classes (with :import) +and macros (with :refer-macros), but these are explained in other sections. +
+
+Namespaces and File Names +When you have a namespace like myapp.core, the code must be in a file named +core.cljs inside the myapp directory. So, the preceding examples with +namespaces myapp.core and myapp.main would be found in project with a file +structure like this: +myapp +└── src + └── myapp + ├── core.cljs + └── main.cljs +
+
+
+Abstractions and Polymorphism +I’m sure that at more than one time you have found yourself in this situation: you +have defined a great abstraction (using interfaces or something similar) for your +"business logic", and you have found the need to deal with another module over which +you have absolutely no control, and you probably were thinking of creating adapters, +proxies, and other approaches that imply a great amount of additional complexity. +Some dynamic languages allow "monkey-patching"; languages where the classes are open +and any method can be defined and redefined at any time. Also, it is well known that +this technique is a very bad practice. +We can not trust languages that allow you to silently overwrite methods that you are +using when you import third party libraries; you cannot expect consistent behavior +when this happens. +These symptoms are commonly called the "expression problem"; +see http://en.wikipedia.org/wiki/Expression_problem for more details +
+Protocols +The ClojureScript primitive for defining "interfaces" is called a protocol. A +protocol consists of a name and set of functions. All the functions have at least +one argument corresponding to the this in JavaScript or self in Python. +Protocols provide a type-based polymorphism, and the dispatch is always done by the +first argument (equivalent to JavaScript’s this, as previously mentioned). +A protocol looks like this: +(ns myapp.testproto) + +(defprotocol IProtocolName + "A docstring describing the protocol." + (sample-method [this] "A doc string associated with this function.")) + +the "I" prefix is commonly used to designate the separation of protocols and +types. In the Clojure community, there are many different opinions about how the "I" +prefix should be used. In our opinion, it is an acceptable solution to avoid name +clashing and possible confusion. But not using the prefix is not considered bad +practice. + +From the user perspective, protocol functions are simply plain functions defined in +the namespace where the protocol is defined. This enables an easy and simple aproach +for avoid conflicts between different protocols implemented for the same type that +have conflicting function names. +Here is an example. Let’s create a protocol called IInvertible for data that can +be "inverted". It will have a single method named invert. +(defprotocol IInvertible + "This is a protocol for data types that are 'invertible'" + (invert [this] "Invert the given item.")) +
+Extending existing types +One of the big strengths of protocols is the ability to extend existing and maybe +third party types. This operation can be done in different ways. +The majority of time you will tend to use the extend-protocol or the extend-type +macros. This is how extend-type syntax looks: +(extend-type TypeA + ProtocolA + (function-from-protocol-a [this] + ;; implementation here + ) + + ProtocolB + (function-from-protocol-b-1 [this parameter1] + ;; implementation here + ) + (function-from-protocol-b-2 [this parameter1 parameter2] + ;; implementation here + )) +You can observe that with extend-type you are extending a single type with +different protocols in a single expression. +Let’s play with our IInvertible protocol defined previously: +(extend-type string + IInvertible + (invert [this] (apply str (reverse this)))) + +(extend-type cljs.core.List + IInvertible + (invert [this] (reverse this))) + +(extend-type cljs.core.PersistentVector + IInvertible + (invert [this] (into [] (reverse this)))) +You may note that a special symbol string is used instead of js/String for +extend the protol for string. This is because the builtin javascript types have +special treatment and if you replace the string with js/String the compiler +will emit a warning about that. +So if you want extend your protocol to javascript primitive types, instead of using +js/Number, js/String, js/Object, js/Array, js/Boolean and js/Function +you should use the respective special symbols: number, string, object, +array, boolean and function. +Now, it’s time to try our protocol implementation: +(invert "abc") +;; => "cba" + +(invert 0) +;; => 0 + +(invert '(1 2 3)) +;; => (3 2 1) + +(invert [1 2 3]) +;; => [3 2 1] +In comparison, extend-protocol does the inverse; given a protocol, it adds +implementations for multiple types. This is how the syntax looks: +(extend-protocol ProtocolA + TypeA + (function-from-protocol-a [this] + ;; implementation here + ) + + TypeB + (function-from-protocol-a [this] + ;; implementation here + )) +Thus, the previous example could have been written equally well with this way: +(extend-protocol IInvertible + string + (invert [this] (apply str (reverse this))) + + cljs.core.List + (invert [this] (reverse this)) + + cljs.core.PersistentVector + (invert [this] (into [] (reverse this)))) +
+
+Participate in ClojureScript abstractions +ClojureScript itself is built up on abstractions defined as protocols. Almost all +behavior in the ClojureScript language itself can be adapted to third party +libraries. Let’s look at a real life example. +In previous sections, we have explained the different kinds of built-in +collections. For this example we will use a set. See this snippet of code: +(def mynums #{1 2}) + +(filter mynums [1 2 4 5 1 3 4 5]) +;; => (1 2 1) +What happened? In this case, the set type implements the ClojureScript internal +IFn protocol that represents an abstraction for functions or anything +callable. This way it can be used like a callable predicate in filter. +OK, but what happens if we want to use a regular expression as a predicate function +for filtering a collection of strings: +(filter #"^foo" ["haha" "foobar" "baz" "foobaz"]) +;; TypeError: Cannot call undefined +The exception is raised because the RegExp type does not implement the IFn +protocol so it cannot behave like a callable, but that can be easily fixed: +(extend-type js/RegExp + IFn + (-invoke + ([this a] + (re-find this a)))) +Let’s analyze this: we are extending the js/RegExp type so that it implements the +invoke function in the IFn protocol. To invoke a regular expression a as if it +were a function, call the re-find function with the object of the function and the +pattern. +Now, you will be able use the regex instances as predicates in a filter operation: +(filter #"^foo" ["haha" "foobar" "baz" "foobaz"]) +;; => ("foobar" "foobaz") +
+
+Introspection using Protocols +ClojureScript comes with a useful function that allows runtime introspection: +satisfies?. The purpose of this function is to determine at runtime if some object +(instance of some type) satisfies the concrete protocol. +So, with the previous examples, if we check if a set instance satisfies an IFn +protocol, it should return true: +(satisfies? IFn #{1}) +;; => true +
+
+
+Multimethods +We have previously talked about protocols which solve a very common use case of +polymorphism: dispatch by type. But in some circumstances, the protocol approach can +be limiting. And here, multimethods come to the rescue. +These multimethods are not limited to type dispatch only; instead, they also offer +dispatch by types of multiple arguments and by value. They also allow ad-hoc +hierarchies to be defined. Also, like protocols, multimethods are an "Open System", +so you or any third parties can extend a multimethod for new types. +The basic constructions of multimethods are the defmulti and defmethod +forms. The defmulti form is used to create the multimethod with an initial +dispatch function. This is a model of what it looks like: +(defmulti say-hello + "A polymorphic function that return a greetings message + depending on the language key with default lang as `:en`" + (fn [param] (:locale param)) + :default :en) +The anonymous function defined within the defmulti form is a dispatch function. It +will be called in every call to the say-hello function and should return some kind +of marker object that will be used for dispatch. In our example, it returns the +contents of the :locale key of the first argument. +And finally, you should add implementations. That is done with the defmethod form: +(defmethod say-hello :en + [person] + (str "Hello " (:name person "Anonymous"))) + +(defmethod say-hello :es + [person] + (str "Hola " (:name person "Anónimo"))) +So, if you execute that function over a hash map containing the :locale and +optionally the :name key, the multimethod will first call the dispatch function to +determine the dispatch value, then it will search for an implementation for that +value. If an implementation is found, the dispatcher will execute it. Otherwise, the +dispatch will search for a default implementation (if one is specified) and execute +it. +(say-hello {:locale :es}) +;; => "Hola Anónimo" + +(say-hello {:locale :en :name "Ciri"}) +;; => "Hello Ciri" + +(say-hello {:locale :fr}) +;; => "Hello Anonymous" +If the default implementation is not specified, an exception will be raised +notifying you that some value does not have an implementation for that multimethod. +
+
+Hierarchies +Hierarchies are ClojureScript’s way to let you build whatever relations that your +domain may require. Hierarchies are defined in term of relations between named +objects, such as symbols, keywords, or types. +Hierarchies can be defined globally or locally, depending on your needs. Like +multimethods, hierarchies are not limited to a single namespace. You can extend a +hierarchy from any namespace, not only from the one in which it is defined. +The global namespace is more limited, for good reasons. Keywords or symbols that are +not namespaced can not be used in the global hierarchy. That behavior helps prevent +unexpected situations when two or more third party libraries use the same symbol for +different semantics. +
+Defining a hierarchy +The hierarchy relations should be established using the derive function: +(derive ::circle ::shape) +(derive ::box ::shape) +We have just defined a set of relationships between namespaced keywords. In this +case the ::circle is a child of ::shape, and ::box is also a child of +::shape. + +The ::circle keyword syntax is a shorthand for :current.ns/circle. So if +you are executing it in a REPL, ::circle will be evaluated as :cljs.user/circle. + +
+
+Hierarchies and introspection +ClojureScript comes with a little toolset of functions that allows runtime +introspection of globally or locally defined hierarchies. This toolset consists of +three functions: isa?, ancestors, and descendants. +Let’s see an example of how it can be used with the hierarchy defined in the +previous example: +(ancestors ::box) +;; => #{:cljs.user/shape} + +(descendants ::shape) +;; => #{:cljs.user/circle :cljs.user/box} + +(isa? ::box ::shape) +;; => true + +(isa? ::rect ::shape) +;; => false +
+
+Locally defined hierarchies +As we mentioned previously, in ClojureScript you also can define local +hierarchies. This can be done with the make-hierarchy function. Here is an example +of how you can replicate the previous example using a local hierarchy: +(def h (-> (make-hierarchy) + (derive :box :shape) + (derive :circle :shape))) +Now you can use the same introspection functions with that locally defined +hierarchy: +(isa? h :box :shape) +;; => true + +(isa? :box :shape) +;; => false +As you can observe, in local hierarchies we can use normal (not namespace qualified) +keywords, and if we execute the isa? without passing the local hierarchy +parameter, it returns false as expected. +
+
+Hierarchies in multimethods +One of the big advantages of hierarchies is that they work very well together with +multimethods. This is because multimethods by default use the isa? function for +the last step of dispatching. +Let’s see an example to clearly understand what that means. First, we define the +multimethod with the defmulti form: +(defmulti stringify-shape + "A function that prints a human readable representation + of a shape keyword." + identity + :hierarchy #'h) +With the :hierarchy keyword parameter, we indicate to the multimethod what +hierarchy we want to use; if it is not specified, the global hierarchy will be used. +Second, we define an implementation for our multimethod using the defmethod form: +(defmethod stringify-shape :box + [_] + "A box shape") + +(defmethod stringify-shape :shape + [_] + "A generic shape") + +(defmethod stringify-shape :default + [_] + "Unexpected object") +Now, let’s see what happens if we execute that function with a box: +(stringify-shape :box) +;; => "A box shape" +Now everything works as expected; the multimethod executes the direct matching +implementation for the given parameter. Next, let’s see what happens if we execute +the same function but with the :circle keyword as the parameter which does not +have the direct matching dispatch value: +(stringify-shape :circle) +;; => "A generic shape" +The multimethod automatically resolves it using the provided hierarchy, and since +:circle is a descendant of :shape, the :shape implementation is executed. +Finally, if you give a keyword that isn’t part of the hierarchy, you get the +:default implementation: +(stringify-shape :triangle) +;; => "Unexpected object" +
+
+
+
+Data types +Until now, we have used maps, sets, lists, and vectors to represent our data. And in +most cases, this is a really great approach. But sometimes we need to define our own +types, and in this book we will call them data types. +A data type provides the following: + + +A unique host-backed type, either named or anonymous. + + +The ability to implement protocols (inline). + + +Explicitly declared structure using fields or closures. + + +Map-like behavior (via records, see below). + + +
+Deftype +The most low-level construction in ClojureScript for creating your own types is +the deftype macro. As a demonstration, we will define a type called User: +(deftype User [firstname lastname]) +Once the type has been defined, we can create an instance of our User. In the +following example, the . after User indicates that we are calling a constructor. +(def person (User. "Triss" "Merigold")) +Its fields can be accessed using the prefix dot notation: +(.-firstname person) +;; => "Triss" +Types defined with deftype (and defrecord, which we will see later) create a +host-backed class-like object associated with the current namespace. For +convenience, ClojureScript also defines a constructor function called →User +that can be imported using the :require directive. +We personally do not like this type of function, and we prefer to define our own +constructors with more idiomatic names: +(defn make-user + [firstname lastname] + (User. firstname lastname)) +We use this in our code instead of →User. +
+
+Defrecord +The record is a slightly higher-level abstraction for defining types in +ClojureScript and should be the preferred way to do it. +As we know, ClojureScript tends to use plain data types such as maps, but in most +cases we need a named type to represent the entities of our application. Here come +the records. +A record is a data type that implements the map protocol and therefore can be used +like any other map. And since records are also proper types, they support +type-based polymorphism through protocols. +In summary: with records, we have the best of both worlds, maps that can play in +different abstractions. +Let’s start defining the User type but using records: +(defrecord User [firstname lastname]) +It looks really similar to the deftype syntax; in fact, it uses deftype behind +the scenes as a low-level primitive for defining types. +Now, look at the difference with raw types for access to its fields: +(def person (User. "Yennefer" "of Vengerberg")) + +(:firstname person) +;; => "Yennefer" + +(get person :firstname) +;; => "Yennefer" +As we mentioned previously, records are maps and act like them: +(map? person) +;; => true +And like maps, they support extra fields that are not initially defined: +(def person2 (assoc person :age 92)) + +(:age person2) +;; => 92 +As we can see, the assoc function works as expected and returns a new instance of +the same type but with new key value pair. But take care with dissoc! Its behavior +with records is slightly different than with maps; it will return a new record if +the field being dissociated is an optional field, but it will return a plain map if +you dissociate a mandatory field. +Another difference with maps is that records do not act like functions: +(def plain-person {:firstname "Yennefer", :lastname "of Vengerberg"}) + +(plain-person :firstname) +;; => "Yennefer" + +(person :firstname) +;; => person.User does not implement IFn protocol. +For convenience, the defrecord macro, like deftype, exposes a →User function, +as well as an additional map→User constructor function. We have the same opinion +about that constructor as with deftype defined ones: we recommend defining your +own instead of using the other ones. But as they exist, let’s see how they can be +used: +(def cirilla (->User "Cirilla" "Fiona")) +(def yen (map->User {:firstname "Yennefer" + :lastname "of Vengerberg"})) +
+
+Implementing protocols +Both type definition primitives that we have seen so far allow inline +implementations for protocols (explained in a previous section). Let’s define one +for example purposes: +(defprotocol IUser + "A common abstraction for working with user types." + (full-name [_] "Get the full name of the user.")) +Now, you can define a type with inline implementation for an abstraction, in our +case the IUser: +(defrecord User [firstname lastname] + IUser + (full-name [_] + (str firstname " " lastname))) + +;; Create an instance. +(def user (User. "Yennefer" "of Vengerberg")) + +(full-name user) +;; => "Yennefer of Vengerberg" +
+
+Reify +The reify macro is an ad hoc constructor you can use to create objects without +pre-defining a type. Protocol implementations are supplied the same as deftype +and defrecord, but in contrast, reify does not have accessible fields. +This is how we can emulate an instance of the user type that plays well with the +IUser abstraction: +(defn user + [firstname lastname] + (reify + IUser + (full-name [_] + (str firstname " " lastname)))) + +(def yen (user "Yennefer" "of Vengerberg")) +(full-name yen) +;; => "Yennefer of Vengerberg" +
+
+Specify +specify! is an advanced alternative to reify, allowing you to add protocol +implementations to an existing JavaScript object. This can be useful if you want to +graft protocols onto a JavaScript library’s components. +(def obj #js {}) + +(specify! obj + IUser + (full-name [_] + "my full name")) + +(full-name obj) +;; => "my full name" +specify is an immutable version of specify! that can be used on immutable, +copyable values implementing ICloneable (e.g. ClojureScript collections). +(def a {}) + +(def b (specify a + IUser + (full-name [_] + "my full name"))) + +(full-name a) +;; Error: No protocol method IUser.full-name defined for type cljs.core/PersistentArrayMap: {} + +(full-name b) +;; => "my full name" +
+
+
+Host interoperability +ClojureScript, in the same way as its brother Clojure, is designed to be a "guest" +language. This means that the design of the language works well on top of an +existing ecosystem such as JavaScript for ClojureScript and the JVM for Clojure. +
+The types +ClojureScript, unlike what you might expect, tries to take advantage of every type +that the platform provides. This is a (perhaps incomplete) list of things that +ClojureScript inherits and reuses from the underlying platform: + + +ClojureScript strings are JavaScript Strings. + + +ClojureScript numbers are JavaScript Numbers. + + +ClojureScript nil is a JavaScript null. + + +ClojureScript regular expressions are JavaScript RegExp instances. + + +ClojureScript is not interpreted; it is always compiled down to JavaScript. + + +ClojureScript allows easy call to platform APIs with the same semantics. + + +ClojureScript data types internally compile to objects in JavaScript. + + +On top of it, ClojureScript builds its own abstractions and types that do not +exist in the platform, such as Vectors, Maps, Sets, and others that are explained in +preceding sections of this chapter. +
+
+Interacting with platform types +ClojureScript comes with a little set of special forms that allows it to interact +with platform types such as calling object methods, creating new instances, and +accessing object properties. +
+Access to the platform +ClojureScript has a special syntax for access to the entire platform environment +through the js/ special namespace. This is an example of an expression to execute +JavaScript’s built-in parseInt function: +(js/parseInt "222") +;; => 222 +
+
+Creating new instances +ClojureScript has two ways to create instances: +Using the new special form +(new js/RegExp "^foo$") +Using the . special form +(js/RegExp. "^foo$") +The last one is the recommended way to create instances. We are not aware of any +real differences between the two forms, but in the ClojureScript community, the last +one is used most often. +
+
+Invoke instance methods +To invoke methods of some object instance, as opposed to how it is done in +JavaScript (e.g., obj.method(), the method name comes first like any other +standard function in Lisp languages but with a little variation: the function name +starts with special form .. +Let’s see how we can call the .test() method of a regexp instance: +(def re (js/RegExp "^Clojure")) + +(.test re "ClojureScript") +;; => true +You can invoke instance methods on JavaScript objects. The first example follows the +pattern you have seen; the last one is a shortcut: +(.sqrt js/Math 2) +;; => 1.4142135623730951 +(js/Math.sqrt 2) +;; => 1.4142135623730951 +
+
+Access to object properties +Access to an object’s properties is really very similar to calling a method. The +difference is that instead of using the . you use .-. Let’s see an example: +(.-multiline re) +;; => false +(.-PI js/Math) +;; => 3.141592653589793 +
+
+Property access shorthand +Symbols with the js/ prefix can contain dots to denote nested property access. +Both of the following expressions invoke the same function: +(.log js/console "Hello World") + +(js/console.log "Hello World") +And both of the following expressions access the same property: +(.-PI js/Math) +;; => 3.141592653589793 + +js/Math.PI +;; => 3.141592653589793 +
+
+JavaScript objects +ClojureScript has different ways to create plain JavaScript objects; each one has +its own purpose. The basic one is the js-obj function. It accepts a variable +number of pairs of keys and values and returns a JavaScript object: +(js-obj "country" "FR") +;; => #js {:country "FR"} +The return value can be passed to some kind of third party library that accepts a +plain JavaScript object, but you can observe the real representation of the return +value of this function. It is really another form for doing the same thing. +Using the reader macro #js consists of prepending it to a ClojureScript map or +vector, and the result will be transformed to plain JavaScript: +(def myobj #js {:country "FR"}) +The translation of that to plain JavaScript is similar to this: +var myobj = {country: "FR"}; +As explained in the previous section, you can also access the plain object +properties using the .- syntax: +(.-country myobj) +;; => "FR" +And as JavaScript objects are mutable, you can set a new value for some property +using the set! function: +(set! (.-country myobj) "KR") +
+
+Conversions +The inconvenience of the previously explained forms is that they do not make +recursive transformations, so if you have nested objects, the nested objects will +not be converted. Consider this example that uses Clojurescript maps, then a +similar one with JavaScript objects: +(def clj-map {:country {:code "FR" :name "France"}}) +;; => {:country {:code "FR", :name "France"}} +(:code (:country clj-map)) +;; => "FR" + +(def js-obj #js {:country {:code "FR" :name "France"}}) +;; => #js {:country {:code "FR", :name "France"} +(.-country js-obj) +;; => {:code "FR", :name "France"} +(.-code (.-country js-obj) +;; => nil +To solve that use case, ClojureScript comes with the clj→js and js→clj +functions that transform Clojure collection types into JavaScript and back. Note +that the conversion to ClojureScript changes the :country keyword to a string. +(clj->js {:foo {:bar "baz"}}) +;; => #js {:foo #js {:bar "baz"}} +(js->clj #js {:country {:code "FR" :name "France"}})) +;; => {"country" {:code "FR", :name "France"}} +In the case of arrays, there is a specialized function into-array that behaves as +expected: +(into-array ["France" "Korea" "Peru"]) +;; => #js ["France" "Korea" "Peru"] +
+
+Arrays +In the previous example, we saw how we can create an array from an existing +ClojureScript collection. But there is another function for creating arrays: +make-array. + +Creating a preallocated array with length 10 + +(def a (make-array 10)) +;; => #js [nil nil nil nil nil nil nil nil nil nil] + + +In ClojureScript, arrays also play well with sequence abstractions, so you can +iterate over them or simply get the number of elements with the count function: +(count a) +;; => 10 +As arrays in the JavaScript platform are a mutable collection type, you can access a +concrete index and set the value at that position: +(aset a 0 2) +;; => 2 +a +;; => #js [2 nil nil nil nil nil nil nil nil nil] +Or access in an indexed way to get its values: +(aget a 0) +;; => 2 +In JavaScript, array index access is equivalent to object property access, so you +can use the same functions for interacting with plain objects: +(def b #js {:hour 16}) +;; => #js {:hour 16} + +(aget b "hour") +;; => 16 + +(aset b "minute" 22) +;; => 22 + +b +;; => #js {:hour 16, :minute 22} +
+
+
+
+State management +We’ve learned that one of ClojureScript’s fundamental ideas is immutability. Both +scalar values and collections are immutable in ClojureScript, except those mutable +types present in the JS host like Date. +Immutability has many great properties but we are sometimes faced with the need to +model values that change over time. How can we achieve this if we can’t change data +structures in place? +
+Vars +Vars can be redefined at will inside a namespace but there is no way to know when +they change. The inability to redefine vars from other namespaces is a bit limiting; +also, if we are modifying state, we’re probably interested in knowing when it +occurs. +
+
+Atoms +ClojureScript gives us the Atom type, which is an object containing a value that +can be altered at will. Besides altering its value, it also supports observation +through watcher functions that can be attached and detached from it and validation +for ensuring that the value contained in the atom is always valid. +If we were to model an identity corresponding to a person called Ciri, we could wrap +an immutable value containing Ciri’s data in an atom. Note that we can get the +atom’s value with the deref function or using its shorthand @ notation: +(def ciri (atom {:name "Cirilla" :lastname "Fiona" :age 20})) +;; #<Atom: {:name "Cirilla", :lastname "Fiona", :age 20}> + +(deref ciri) +;; {:name "Cirilla", :lastname "Fiona", :age 20} + +@ciri +;; {:name "Cirilla", :lastname "Fiona", :age 20} +We can use the swap! function on an atom to alter its value with a function. Since +Ciri’s birthday is today, let’s increment her age count: +(swap! ciri update :age inc) +;; {:name "Cirilla", :lastname "Fiona", :age 21} + +@ciri +;; {:name "Cirilla", :lastname "Fiona", :age 21} +The reset! functions replaces the value contained in the atom with a new one: +(reset! ciri {:name "Cirilla", :lastname "Fiona", :age 22}) +;; {:name "Cirilla", :lastname "Fiona", :age 22} + +@ciri +;; {:name "Cirilla", :lastname "Fiona", :age 22} +
+Observation +We can add and remove watcher functions for atoms. Whenever the atom’s value is +changed through a swap! or reset!, all the atom’s watcher functions will be +called. Watchers are added with the add-watch function. Notice that each watcher +has a key associated (:logger in the example) to it which is later used to remove +the watch from the atom. +(def a (atom)) + +(add-watch a :logger (fn [key the-atom old-value new-value] + (println "Key:" key "Old:" old-value "New:" new-value))) + +(reset! a 42) +;; Key: :logger Old: nil New: 42 +;; => 42 + +(swap! a inc) +;; Key: :logger Old: 42 New: 43 +;; => 43 + +(remove-watch a :logger) +
+
+
+Volatiles +Volatiles, like atoms, are objects containing a value that can be altered. However, +they don’t provide the observation and validation capabilities that atoms +provide. This makes them slightly more performant and a more suitable mutable +container to use inside stateful functions that don’t need observation nor +validation. +Their API closely resembles that of atoms. They can be dereferenced to grab the +value they contain and support swapping and resetting with vswap! and vreset! +respectively: +(def ciri (volatile! {:name "Cirilla" :lastname "Fiona" :age 20})) +;; #<Volatile: {:name "Cirilla", :lastname "Fiona", :age 20}> + +(volatile? ciri) +;; => true + +(deref ciri) +;; {:name "Cirilla", :lastname "Fiona", :age 20} + +(vswap! ciri update :age inc) +;; {:name "Cirilla", :lastname "Fiona", :age 21} + +(vreset! ciri {:name "Cirilla", :lastname "Fiona", :age 22}) +;; {:name "Cirilla", :lastname "Fiona", :age 22} +Note that another difference with atoms is that the constructor of volatiles uses a +bang at the end. You create volatiles with volatile! and atoms with atom. +
+
+ + +Tooling & Compiler +This chapter will cover a little introduction to existing tooling for making +things easy when developing using ClojureScript. Unlike the previous chapter, +this chapter intends to tell different stories each independent of the other. +
+Getting Started with the Compiler +At this point, you are surely very bored with the constant theoretical explanations +about the language itself and will want to write and execute some code. The goal of +this section is to provide a little practical introduction to the ClojureScript +compiler. +The ClojureScript compiler takes the source code that has been split over numerous +directories and namespaces and compiles it down to JavaScript. Today, JavaScript has +a great number of different environments where it can be executed - each with its own +peculiarities. +This chapter intends to explain how to use ClojureScript without any additional +tooling. This will help you understand how the compiler works and how you can use it +when other tooling is not available (such as leiningen +cljsbuild or +boot). +
+Execution environments +What is an execution environment? An execution environment is an engine where +JavaScript can be executed. For example, the most popular execution environment is a +browser (Chrome, Firefox, …​) followed by the second most popular - +nodejs. +There are others, such as Rhino (JDK 6+), Nashorn (JDK 8+), QtQuick (QT),…​ but +none of them have significant differences from the first two. So, +ClojureScript at the moment may compile code to run in the browser or in +nodejs-like environments out of the box. +
+
+Download the compiler +The fastest way to obtain all the tooling needed for ClojureScript compilaition is +installing the Clojure CLI Tools: +curl -O https://download.clojure.org/install/linux-install-1.10.1.462.sh +chmod +x linux-install-1.10.1.462.sh +sudo ./linux-install-1.10.1.462.sh +If you are using other operating system other than linux, refer to +https://clojure.org/guides/getting_started page. +Although the ClojureScript is self hosted, in this book we will use +the JVM implementation, with in turn requires JDK8 or JDK11 +installed. You can obtain it using your distribution default package +manager or download it from +Oracle +or Azul + +Example installing it using a apt in a debian-like distribution + +sudo apt-get install openjdk-8-jdk rlwrap + + +
+
+Compile for Node.js +Let’s start with a practical example compiling code that will target Node.js +(hereafter simply "nodejs"). For this example, you should have nodejs installed. +There are different ways to install nodejs, but the recommended way is using nvm +("Node.js Version Manager"). You can read the instructions on how to install and use +nvm on its home page. +When you have installed nvm, follow installing the latest version of nodejs: +nvm install v10.16.0 +nvm alias default v10.16.0 +You can test if nodejs is installed in your system with this command: +$ node --version +v10.16.0 +
+Create the example application +For the first step of our practical example, we will create our application directory +structure and populate it with example code. +Start by creating the directory tree structure for our “hello world” application: +mkdir -p myapp/src/myapp +touch myapp/src/myapp/core.cljs +Resulting in this directory tree: +myapp +└── src + └── myapp + └── core.cljs +Second, write the example code into the previously created +myapp/src/myapp/core.cljs file: +(ns myapp.core + (:require [cljs.nodejs :as nodejs])) + +(nodejs/enable-util-print!) + +(defn -main + [& args] + (println "Hello world!")) + +(set! *main-cli-fn* -main) + +It is very important that the declared namespace in the file exactly matches +the directory structure. This is the way ClojureScript structures its source code. + +And finally, lets create the myapp/deps.edn declaring the clojure +and clojurescript versions: +{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"} + org.clojure/clojure {:mvn/version "1.10.1"}} + :paths ["src"]} +
+
+Compile the example application +In order to compile that source code, we need a simple build script that tells the +ClojureScript compiler the source directory and the output file. ClojureScript +has a lot of other options, but at this moment we can ignore that. +Let’s create the myapp/build.clj file with the following content: +(require '[cljs.build.api :as b]) + +(b/build "src" {:main 'myapp.core + :output-to "main.js" + :output-dir "out" + :target :nodejs + :verbose true}) +This is a brief explanation of the compiler options used in this example: + + +The :output-to parameter indicates to the compiler the destination of the compiled +code, in this case to the "main.js" file. + + +The :main property indicates to the compiler the namespace that will act as the entry +point of your application when it’s executed. + + +The :target property indicates the platform where you want to execute the compiled +code. In this case, we are going to use nodejs. If you omit this +parameter, the source will be compiled to run in the browser environment. + + +To run the compilation, just execute the following command: +cd myapp +clojure build.clj +And when it finishes, execute the compiled file using node: +$ node main.js +Hello world! +
+
+
+Compile for the Browser +In this section we are going to create an application similar to the "hello world" +example from the previous section to run in the browser environment. The minimal +requirement for this application is just a browser that can execute JavaScript. +The process is almost the same, and the directory structure is the same. The only +things that changes is the entry point of the application and the build script. So, +start re-creating the directory tree from previous example in a different directory. +mkdir -p mywebapp/src/mywebapp +touch mywebapp/src/mywebapp/core.cljs +Resulting in this directory tree: +mywebapp +└── src + └── mywebapp + └── core.cljs +Then, write new content to the mywebapp/src/mywebapp/core.cljs file: +(ns mywebapp.core) + +(enable-console-print!) + +(println "Hello world!") +In the browser environment we do not need a specific entry point for the application, +so the entry point is the entire namespace. +
+Compile the example application +In order to compile the source code to run properly in a browser, overwrite the +mywebapp/build.clj file with the following content: +(require '[cljs.build.api :as b]) + +(b/build "src" {:output-to "main.js" + :source-map true + :output-dir "out/" + :main 'mywebapp.core + :verbose true + :optimizations :none}) +This is a brief explanation of the compiler options we’re using: + + +The :output-to parameter indicates to the compiler the destination of the +compiled code, in this case the "main.js" file. + + +The :main property indicates to the compiler the namespace that will act as +the entry point of your application when it’s executed. + + +:source-map indicates the destination of the source map. (The source map +connects the ClojureScript source to the generated JavaScript so that error +messages can point you back to the original source.) + + +:output-dir indicates the destination directory for all file sources used in a +compilation. It is just for making source maps work properly with the rest of the +code, not only your source. + + +:optimizations indicates the compilation optimization. There are different +values for this option, but that will be covered in subsequent sections in +more detail. + + +To run the compilation, just execute the following command: +cd mywebapp; +clojure build.clj +This process can take some time, so do not worry; wait a little bit. The JVM +bootstrap with the Clojure compiler is slightly slow. In the following sections, we +will explain how to start a watch process to avoid constantly starting and stopping +this slow process. +While waiting for the compilation, let’s create a dummy HTML file to make it easy to +execute our example app in the browser. Create the index.html file with the +following content; it goes in the main mywebapp directory. +<!DOCTYPE html> +<html> + <header> + <meta charset="utf-8" /> + <title>Hello World from ClojureScript</title> + </header> + <body> + <script src="main.js"></script> + </body> +</html> +Now, when the compilation finishes and you have the basic HTML file you can just open +it with your favorite browser and take a look in the development tools console. The +"Hello world!" message should appear there. +
+
+
+Watch process +You may have already noticed the slow startup time of the ClojureScript +compiler. To solve this, the ClojureScript standalone compiler comes with a +tool to watch for changes in your source code, and re-compile modified files as +soon as they are written to disk. +Let’s start converting our build.clj script to something that can accept +arguments and execute different tasks. Let’s create a tools.clj script file +with the following content: +(require '[cljs.build.api :as b]) + +(defmulti task first) + +(defmethod task :default + [args] + (let [all-tasks (-> task methods (dissoc :default) keys sort) + interposed (->> all-tasks (interpose ", ") (apply str))] + (println "Unknown or missing task. Choose one of:" interposed) + (System/exit 1))) + +(def build-opts + {:output-to "main.js" + :source-map true + :output-dir "out/" + :main 'mywebapp.core + :verbose true + :optimizations :none}) + +(defmethod task "build" + [args] + (b/build "src" build-opts)) + +(defmethod task "watch" + [args] + (b/watch"src" build-opts)) + +(task *command-line-args*) +Now you can start the watch process with the following command: +clojure tools.clj watch +Go back to the mywebapp.core namespace, and change the print text to "Hello World, +Again!". You’ll see that the file src/mywebapp/core.cljs the file is immediately +recompiled, and if you reload index.html in your browser the new text is displayed +in the developer console. +You also can start the simple build with: +clojure tools.clj build +And finally, if you execute the build.clj script with no params, a help message +with available "tasks" will be printed: +$ clojure tools.clj +Unknown or missing task. Choose one of: build, watch +
+
+Optimization levels +The ClojureScript compiler has different levels of optimization. Behind the scenes, +those compilation levels are coming from the Google Closure Compiler. +A simplified overview of the compilation process is: + + +The reader reads the code and does some analysis. This compiler may raise some +warnings during this phase. + + +Then, the ClojureScript compiler emits JavaScript code. The result is one +JavaScript output file for each ClojureScript input file. + + +The generated JavaScript files are passed through the Google Closure Compiler +which, depending on the optimization level and other options (sourcemaps, output +dir output to, …​), generates the final output file(s). + + +The final output format depends on the optimization level chosen: +
+none +This optimization level causes the generated JavaScript to be written into separate +output files for each namespace, without any additional transformations to the code. +
+
+whitespace +This optimization level causes the generated JavaScript files to be concatenated into +a single output file, in dependency order. Line breaks and other whitespace are +removed. +This reduces compilation speed somewhat, resulting in a slower compilations. However, +it is not terribly slow and it is quite usable for small-to-medium sized +applications. +
+
+simple +The simple compilation level builds on the work from the whitespace optimization +level, and additionally performs optimizations within expressions and functions, such +as renaming local variables and function parameters to have shorter names. +Compilation with the :simple optimization always preserves the functionality of +syntactically valid JavaScript, so it does not interfere with the interaction between +the compiled ClojureScript and other JavaScript. +
+
+advanced +The advanced compilation level builds on the simple optimization level, and +additionally performs more aggressive optimizations and dead code elimination. This +results in a significantly smaller output file. +The :advanced optimizations only work for a strict subset of JavaScript which +follows the Google Closure Compiler rules. ClojureScript generates valid +JavaScript within this strict subset, but if you are interacting with third party +JavaScript code, some additional work is required to make everything work as +expected. +This interaction with third party javascript libraries will be explained in later +sections. +
+
+
+
+Working with the REPL +
+Introduction +Although you can create a source file and compile it every time you want to try +something out in ClojureScript, it’s easier to use the REPL. REPL stands for: + + +Read - get input from the keyboard + + +Evaluate the input + + +Print the result + + +Loop back for more input + + +In other words, the REPL lets you try out ClojureScript concepts and get immediate +feedback. +ClojureScript comes with support for executing the REPL in different execution +environments, each of which has its own advantages and disadvantages. For example, +you can run a REPL in nodejs but in that environment you don’t have any access to the +DOM. Which REPL environment is best for you depends on your specific needs and +requirements. +
+
+Nashorn REPL +The Nashorn REPL is the easiest and perhaps most painless REPL environment because it +does not require any special stuff. +Let’s start creating a new script file for our repl playground called +tools.clj in a new directory (in our case repl_playground/tools.clj): +(require '[cljs.repl :as repl]) +(require '[cljs.repl.nashorn :as nashorn]) + +(defmulti task first) + +(defmethod task :default + [args] + (let [all-tasks (-> task methods (dissoc :default) keys sort) + interposed (->> all-tasks (interpose ", ") (apply str))] + (println "Unknown or missing task. Choose one of:" interposed) + (System/exit 1))) + +(defmethod task "repl:nashorn" + [args] + (repl/repl (nashorn/repl-env) + :output-dir "out/nashorn" + :cache-analysis true)) + +(task *command-line-args*) +Create the repl_playground/deps.edn file with the following content (identical +from previous examples): +{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"} + org.clojure/clojure {:mvn/version "1.10.1"}} + :paths ["src"]} +And now, we can execute the REPL: +$ clj tools.clj repl:nashorn +ClojureScript 1.10.520 +cljs.user=> (prn "Hello world") +"Hello world" +nil +You may have noticed that in this example we have used clj command instead of +clojure. That two commands are practically identical, the main difference is +that clj executes clojure command wrapped in rlwrap. The rlwrap tool +gives the "readline" capabilities which enables history, code navigation, and +other shell-like features that will make your REPL experience much more +pleasant. +If you don’t have installed it previously, you can install it with sudo apt +install -y rlwrap. + +This is a basic repl, in the following chapters we will explain how to +have a more advanced repl experience with code-highlighting, code-completion and +multiline edition. + +
+
+Node.js REPL +You must, of course, have nodejs installed on your system to use this REPL. +You may be wondering why we might want a nodejs REPL, when we already have the +nashorn REPL available which doesn’t have any external dependencies. The answer is +very simple: nodejs is the most used JavaScript execution environment on the backend, +and it has a great number of community packages built around it. +The good news is that starting a nodejs REPL is very easy once you have it installed +in your system. Start adding the following content into tools.clj script: +(require '[cljs.repl.node :as node]) + +(defmethod task "node:repl" + [args] + (repl/repl (node/repl-env) + :output-dir "out/nodejs" + :cache-analysis true)) +And start the REPL: +$ clj tools.clj repl:node +ClojureScript 1.10.520 +cljs.user=> (prn "Hello world") +"Hello world" +nil +
+
+Browser REPL +This REPL is the most laborious to get up and running. This is because it uses a +browser for its execution environment and it has additional requirements. +Let’s start by adding the following content to the tools.clj script file: +(require '[cljs.build.api :as b]) +(require '[cljs.repl.browser :as browser]) + +(defmethod task "repl:browser" + [args] + (println "Building...") + (b/build "src" + {:output-to "out/browser/main.js" + :output-dir "out/browser" + :source-map true + :main 'myapp.core + :optimizations :none}) + + (println "Launching REPL...") + (repl/repl (browser/repl-env :port 9001) + :output-dir "out/browser")) +The main difference with the previous examples, is that browser REPL requires +that some code be execution in the browser before the REPL gets working. To do +that, just re-create the application structure very similar to the one that we +have used in previous sections: +mkdir -p src/myapp +touch src/myapp/core.cljs +Then, write new content to the src/myapp/core.cljs file: +(ns myapp.core + (:require [clojure.browser.repl :as repl])) + +(defonce conn + (repl/connect "http://localhost:9001/repl")) + +(enable-console-print!) + +(println "Hello, world!") +And finally, create the missing index.html file that is going to be used as +the entry point for running the browser side code of the REPL: +<!DOCTYPE html> +<html> + <header> + <meta charset="utf-8" /> + <title>Hello World from ClojureScript</title> + </header> + <body> + <script src="out/browser/main.js"></script> + </body> +</html> +Well, that was a lot of setup! But trust us, it’s all worth it when you see it in +action. To do that, just execute the tools.clj in the same way that we have done +it in previous examples: +$ clj tools.clj repl:browser +Building... +Launching REPL... +ClojureScript 1.10.520 +cljs.user=> +And finally, open your favourite browser and go to http://localhost:9001/. Once the +page is loaded (the page will be blank), switch back to the console where you have +run the REPL and you will see that it is up and running: +[...] +To quit, type: :cljs/quit +cljs.user=> (+ 14 28) +42 +One of the big advantages of the browser REPL is that you have access to everything +in the browser environment. For example, type (js/alert "hello world") in the +REPL. This will cause the browser to display an alert box. Nice! + +This is just a preview of how to use the builtin REPL capabilities of the +ClojureScript compiler. There are better and more user/developer friendly repl +environments with code-highlighting, code-completion and multiline edition (and +in case of web development, also with code hot reloading) that will be explained +in the following chapters. + +
+
+Rebel Readline (REPL library) +This is a library that adds more advanced features to the Clojure(Script) +builtin REPL and enables code-highlighting, code-completion and multiline +edition. +Let’s start adding rebel dependency into deps.edn file: +{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"} + org.clojure/clojure {:mvn/version "1.10.1"} + com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"} + com.bhauman/rebel-readline {:mvn/version "0.1.4"}} + :paths ["src"]} +And adding the followin code to the tools.clj script file: +(require '[rebel-readline.core] + '[rebel-readline.clojure.main] + '[rebel-readline.clojure.line-reader] + '[rebel-readline.cljs.service.local] + '[rebel-readline.cljs.repl]) + +(defmethod task "repl:rebel:node" + [args] + (rebel-readline.core/with-line-reader + (rebel-readline.clojure.line-reader/create + (rebel-readline.cljs.service.local/create)) + (repl/repl (node/repl-env) + :prompt (fn []) + :read (rebel-readline.cljs.repl/create-repl-read) + :output-dir "out/nodejs" + :cache-analysis true))) +And start the REPL: +$ clojure tools.clj repl:rebel:node +ClojureScript 1.10.520 +cljs.user=> (println +cljs.core/println: ([& objs]) +You can find that while you writing in the repl, it automatically suggest and +shows se function signature that you want to execute. +You can find more information about all rebel-readline capabilities on +https://github.com/bhauman/rebel-readline +
+
+
+The Closure Library +The Google Closure Library is a javascript library developed by Google. It has a +modular architecture, and provides cross-browser functions for DOM manipulations and +events, ajax and JSON, and other features. +The Google Closure Library is written specifically to take advantage of the Closure +Compiler (which is used internally by the ClojureScript compiler). +ClojureScript is built on the Google Closure Compiler and Closure Library. In fact, +ClojureScript namespaces are Closure modules. This means that you can interact with +the Closure Library very easily: +(ns yourapp.core + (:require [goog.dom :as dom])) + +(def element (dom/getElement "body")) +This code snippet shows how you can import the dom module of the Closure library +and use a function declared in that module. +Additionally, the closure library exposes "special" modules that behave like a class +or object. To use these features, you must use the :import directive in the (ns +…​) form: +(ns yourapp.core + (:import goog.History)) + +(def instance (History.)) +In a Clojure program, the :import directive is used for host (Java) interop to +import Java classes. If, however, you define types (classes) in ClojureScript, you +should use the standard :require directive and not the :import directive. +You can found the reference to all namespaces in the closure library here: +http://google.github.io/closure-library/api/ +
+
+Dependency management +Until now, we have used the builtin Clojure(Script) toolchain to compile our +source files to JavaScript. Now this is a time to understand how manage external +and/or third party dependencies. +
+First project +The best way to show how a tool works is by creating a toy project with it. In +this case, we will create a small application that determines if a year is a +leap year or not. +Let’s start creating the project layout: +mkdir -p leapyears/src/leapyears +mkdir -p leapyears/target/public +touch leapyears/target/public/index.html +touch leapyears/src/leapyears/core.cljs +touch leapyears/tools.cljs +touch leapyears/deps.edn +The project has the following structure: +leapyears +├── deps.edn +├── src +│   └── leapyears +│   └── core.cljs +├── target +│   └── public +│   └── index.html +└── tools.clj +The deps.edn file contains information about all the packaged dependencies +needed to build or execute the application. Packaged dependencies are libraries +packaged as jar files and uploaded to clojars/maven repository. + +But ClojureScript can consume external code in many different ways: + + +google closure library module + + +global export module + + +es6/commonjs module (experimental) + + +This will be explained in the following sections. + +Let’s start with a simple deps.edn file: +{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"} + org.clojure/clojure {:mvn/version "1.10.1"} + com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"} + com.bhauman/rebel-readline {:mvn/version "0.1.4"}} + :paths ["src" "target"]} +And simple build script (tools.clj file): +(require '[cljs.build.api :as b]) +(require '[cljs.repl :as repl]) +(require '[cljs.repl.node :as node]) + +(defmulti task first) + +(defmethod task :default + [args] + (let [all-tasks (-> task methods (dissoc :default) keys sort) + interposed (->> all-tasks (interpose ", ") (apply str))] + (println "Unknown or missing task. Choose one of:" interposed) + (System/exit 1))) + +(def build-opts + {:output-to "target/public/js/leapyears.js" + :source-map true + :output-dir "target/public/js/leapyears" + :main 'leapyears.core + :verbose true + :optimizations :none}) + +(defmethod task "repl" + [args] + (repl/repl (node/repl-env) + :output-dir "target/nodejs" + :cache-analysis true)) + +(defmethod task "build" + [args] + (b/build "src" build-opts)) + +(defmethod task "watch" + [args] + (b/watch "src" build-opts)) + +(task *command-line-args*) +Then, write the following content into target/public/index.html file: +<!DOCTYPE html> +<html> + <head> + <title>leapyears</title> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + </head> + <body> + <section class="viewport"> + <div id="result"> + ---- + </div> + + <form action="" method=""> + <label for="year">Input a year</label> + <input id="year" name="year" /> + </form> + </section> + + <script src="./js/leapyears.js" type="text/javascript"></script> + </body> +</html> +The next step consist in add some code to make the form interactive. Put the +following code into the src/leapyears/core.cljs: +(ns leapyears.core + (:require [goog.dom :as dom] + [goog.events :as events] + [cljs.reader :refer (read-string)])) + +(enable-console-print!) + +(def input (dom/getElement "year")) +(def result (dom/getElement "result")) + +(defn leap? + [year] + (or (zero? (js-mod year 400)) + (and (pos? (js-mod year 100)) + (zero? (js-mod year 4))))) + +(defn on-change + [event] + (let [target (.-target event) + value (read-string (.-value target))] + (if (leap? value) + (set! (.-innerHTML result) "YES") + (set! (.-innerHTML result) "NO")))) + +(events/listen input "keyup" on-change) +Now, we can compile the project with: +clojure tools.clj watch +Finally, open the target/public/index.html file in a browser. Typing a year in the textbox +should display an indication of its leap year status. +
+
+Adding native dependencies +Until now we have used only the batteries included in the ClojureScript runtime, +let improve our project including a native dependency. In this example we will +use the Cuerdas (a string manipulation +library build especifically for Clojure(Script)). +Add funcool/cuerdas {:mvn/version "2.2.0"} into the :deps section inside the +deps.edn file. And add the corresponding modifications to the +leapyears/core.cljs file: +(ns leapyears.core + (:require [goog.dom :as dom] + [goog.events :as events] + [cuerdas.core :as str] + [cljs.reader :refer (read-string)])) + +;; [...] + +(defn on-change + [event] + (let [target (.-target event) + value (read-string (.-value target))] + + (if (str/blank? value) + (set! (.-innerHTML result) "---") + (if (leap? value) + (set! (.-innerHTML result) "YES") + (set! (.-innerHTML result) "NO"))))) +Now, if you run the build or watch command, the new declared dependency will be +downloaded and the application will be compiled with this dependency included. +Clojure packages are often published on Clojars. You can +also find many third party libraries on the +ClojureScript Wiki. +
+
+External dependencies +In some circumstances you may found yourself that you need some library but that +does not exists in ClojureScript but it is already implemented in javascript +and you want to use it on your project. +There are many ways that you can do it mainly depending on the library that you +want to include. Many of that libraries are packaged and uploaded to clojars, so +you can declare them in the deps.edn in the same way as native dependencies +(with some peculirities in usage, see below). +
+
+Closure compatible module +If you have a library that is written to be compatible with google closure +module system and you want to include it on your project: put the source into +the classpath (inside src or vendor directory in leapyears project) and +access it like any other clojure namespace. +This is the most simplest case, because google closure modules are directly +compatible and you can mix your clojure code with javascript code written using +google closure module system without any additional steps. +Reusing the leapyears project, lets implement the leap? function in +a javascript using google closure module format. Start creating the +directory structure: +touch src/leapyears/util.js +And add the implementation using closure module format: + +src/leapyears/util.js + +goog.provide("leapyears.util"); + +goog.scope(function() { + var module = leapyears.util; + + module.isLeap = function(val) { + return (0 === (val % 400)) || (((val % 100) > 0) && (0 === (val % 4))); + }; +}); + + +Now, if you open the repl, you can import the namespace and use the isLeap +function +(require '[leapyears.util :as util]) + +(util/isLeap 2112) +;; => true + +(util/isLeap 211) +;; => false + +you can open the nodejs repl just executing clj tools.clj repl in the +root of the project. + + +this is the approach used by many projects to implement some performance +sensitive logic directly in javascript and export it in an easy way to +ClojureScript + +
+
+Global Export +This is the most extended and the most reliable way to consume external +javascript libraries from ClojureScript and it has many facilities. +Let’s play with that. Start creating a simple file using commonjs module format +(pretty analogous to the previous example using google closure modules): +The fastest way to include a javascript library is looking if it is available in +CLJSJS. If it is available, just include the +dependency in the deps.edn file and use it. +That libraries has two ways of use it, let’s see some examples. +Start adding moment dependency to deps.edn file: +cljsjs/moment {:mvn/version "2.24.0-0"} +Then, open the repl and try the following: + +using the <literal>js/</literal> special namespace + +(require '[cljsjs.moment]) ;; just require, no alias + +(.format (js/moment) "LLLL") +;; => "Monday, July 15, 2019 5:32 PM" + + + +using the alias + +(require '[moment :as m]) + +(.format (m) "LLLL") +;; => "Monday, July 15, 2019 5:33 PM" + + +Behind the scenes that packages uses the ClojureScript compiler facilities +descibed +here for provide the compiler with enough information about the files and +global exports to use. +So, if don’t find a library in cljsjs, we can include it using the same +facilities. Let’s assume that moment is not available on cljsjs and we need it +on our project. +For include an foreign dependency we need to pass :foreign-libs and :externs +params to the ClojureScript compiler, and we have two ways: + + +passing them to the build or repl functions. + + +inside the deps.cljs file located on the root of the classpath. + + +The deps.cljs approach requires that files should be localted on the local +directories, but the first approach allows specify directly external urls. We +will use the first approach on our example. +This is how looks the deps.edn file with the changes applied: +;; [...] + +(def foreign-libs + [{:file "https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.24.0/moment.js" + :file-min "https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.24.0/moment.min.js" + :provides ["vendor.moment"]}]) + + +(def build-opts + {:output-to "target/public/js/leapyears.js" + :source-map true + :output-dir "target/public/js/leapyears" + :main 'leapyears.core + :verbose true + :optimizations :none + :foreign-libs foreign-libs}) + +(defmethod task "repl" + [args] + (repl/repl (node/repl-env) + :foreign-libs foreign-libs + :output-dir "target/node" + :cache-analysis true)) + +;; [...] +Now, if you excute the repl, you will be able to import vendor.moment in the same way +if you are using the cljsjs package. +Finally, there are the :externs option, that will be needed only for the +production build, and the externs file consists in plain javascript files that +declares the public API of the included foreign libraries and make them +understandable to the google closure compiler. +The moment externs are available +here +and if you include some library that you want to use, and then want to compile +your app with advanced optimizations you will need to include a file similar to +the moment.ext.js on the project and referenciate it with :externs option to +the ClojureScript compiler. +More info on clojurescript.org. +
+
+ES6/CommonJS modules +Google Closure Compiler has an advanced feature that allows convert from +different module types (commonjs and ES) into google closure module +type. Although this feature is still experimental. With simple modules it works, +but with more complex modules (many submodules and directories) still doest +not complies correctly. +In any way I invite you to experiment with it. You can found more documentation +on +clojurescript.org. +The best way to use ES6 and/or CommonJS module is combining a javascript bundler +like rollup or webpack to generate a single build with external dependencies +and thn use the global exports method to use it in ClojureScript. An example +of this is explained on clojurescript.org. +
+
+
+Interactive development with Figwheel +And finally we will introduce figwheel, that enables fully interactive, +REPL-based and hot reloading enabled development environment. +We will reuse the leapyears project structure for the following examples. + +Although we use figwheel here for web application, it works in the same +way on the application that targets nodejs as execution environment. + +As first step, we need to add figwheel dependency to the deps.edn file: +com.bhauman/figwheel-main {:mvn/version "0.2.1"} +Then, add new task to the tools.clj script: +(def figwheel-opts + {:open-url false + :load-warninged-code true + :auto-testing false + :ring-server-options {:port 3448 :host "0.0.0.0"} + :watch-dirs ["src"]}) + +(defmethod task "figwheel" + [args] + (figwheel/start figwheel-opts {:id "main" :options build-opts})) +And then, run clojure tools.clj fighweel. This will start the figwheel process +that automatically will launch a http server that will serve the +target/public/ directory and index to index.html file. +If you update the code, that code will be automatically loaded to the browser, +without page reload. +For more info: figwheel.org. +
+
+Unit testing +As you might expect, testing in ClojureScript consists of the same concepts widely +used by other language such as Clojure, Java, Python, JavaScript, etc. +Regardless of the language, the main objective of unit testing is to run some test +cases, verifying that the code under test behaves as expected and returns without +raising unexpected exceptions. +The immutablity of ClojureScript data structures helps to make programs less error +prone, and facilitates testing a little bit. Another advantage of ClojureScript is +that it tends to use plain data instead of complex objects. Building "mock" objects +for testing is thus greatly simplified. +
+First steps +The "official" ClojureScript testing framework is in the "cljs.test" namespace. It +is a very simple library, but it should be more than enough for our purposes. +There are other libraries that offer additional features or directly different +approaches to testing, such as +test.check. However, we will not cover +them here. +We will reuse the leapyears project structure and we will add testing to it. Let’s create +the test related files and directories: +mkdir -p test/leapyears/test +touch test/leapyears/test/main.cljs +Also we will need to create new tasks on our tools.clj file for build, watch and run +tests: +(require '[clojure.java.shell :as shell]) + +;; [...] + +(defmethod task "build:tests" + [args] + (b/build (b/inputs "src" "vendor" "test") + (assoc build-opts + :main 'leapyears.test.main + :output-to "out/tests.js" + :output-dir "out/tests" + :target :nodejs))) + +(defmethod task "watch:test" + [args] + (letfn [(run-tests [] + (let [{:keys [out err]} (shell/sh "node" "out/tests.js")] + (println out err)))] + (println "Start watch loop...") + (try + (b/watch (b/inputs "src", "test") + (assoc build-opts + :main 'leapyears.test.main + :watch-fn run-tests + :output-to "out/tests.js" + :output-dir "out/tests" + :target :nodejs)) + + (catch Exception e + (println "Error on running tests:" e) + ;; (Thread/sleep 2000) + (task args))))) +Next, put some test code in the test/leapyears/test/main.cljs file: +(ns leapyears.test.main + (:require [cljs.test :as t])) + +(enable-console-print!) + +(t/deftest my-first-test + (t/is (= 1 2))) + +(set! *main-cli-fn* #(t/run-tests)) + +;; This extension is required for correctly set the return code +;; depending if the test passes or not. +(defmethod t/report [:cljs.test/default :end-run-tests] + [m] + (if (t/successful? m) + (set! (.-exitCode js/process) 0) + (set! (.-exitCode js/process) 1))) +The relevant part of that code snippet is: +(t/deftest my-first-test + (t/is (= 1 2))) +The deftest macro is a basic primitive for defining our tests. It takes a name as +its first parameter, followed by one or multiple assertions using the is macro. In +this example, we try to assert that (= 1 2) is true. +Let’s try to run this: +$ clojure tools build:tests +$ node out/tests.js +Testing mytestingapp.core-tests + +FAIL in (my-first-test) (cljs/test.js:374:14) +expected: (= 1 2) + actual: (not (= 1 2)) + +Ran 1 tests containing 1 assertions. +1 failures, 0 errors. +You can see that the expected assert failure is successfully printed in the +console. To fix the test, just change the = with not= and run the file again: +$ clojure tools build:tests +$ node out/mytestingapp.js + +Testing mytestingapp.core-tests + +Ran 1 tests containing 1 assertions. +0 failures, 0 errors. +It is fine to test these kinds of assertions, but they are not very +useful. Let’s go to test some application code. For this, we will use a function +to check if a year is a leap year or not: +(ns leapyears.test.main + (:require [cljs.test :as t] + [leapyears.vendor.util-closure :as util])) + +;; [...] + +(t/deftest my-second-test + (t/is (util/isLeap 1980)) + (t/is (not (util/isLeap 1981)))) + +;; [...] +Run the compiled file again to see that there are now two tests running. The +first test passes as before, and our two new leap year tests pass as well. +
+
+Async Testing +One of the peculiarities of ClojureScript is that it runs in an asynchronous, +single-threaded execution environment, which has its challenges. +In an async execution environment, we should be able to test asynchronous functions. +To this end, the ClojureScript testing library offers the async macro, allowing +you to create tests that play well with asynchronous code. +First, we need to write a function that works in an asynchronous way. For this +purpose, we will create the async-leap? predicate that will do the same operation +but asychronously return a result using a callback: +(defn async-leap? + [year callback] + (js/setImmediate #(callback (util/isLeap year)))) +The JavaScript function setImmediate is used to emulate an asynchronous task, and +the callback is executed with the result of that predicate. +To test it, we should write a test case using the previously mentioned async macro: +(t/deftest my-async-test + (t/async done + (async-leap? 1980 (fn [result] + (t/is (true? result)) + (done))))) +The done function exposed by the async macro should be called after the +asynchronous operation is finished and all assertions have run. +It is very important to execute the done function only once. Omitting it or +executing it twice may cause strange behavior and should be avoided. +
+
+ + +Language (advanced topics) +This chapter intends to explain some advanced topics that are part of the language +and that does not fit in the first chapter. The good candidates for this section are +transducers, core protocols, transients, metadata. In summary: topics that are not +mandatory for understand the language. +
+Transducers +
+Data transformation +ClojureScript offers a rich vocabulary for data transformation in terms of the +sequence abstraction, which makes such transformations highly general and +composable. Let’s see how we can combine several collection processing functions to +build new ones. We will be using a simple problem throughout this section: splitting +grape clusters, filtering out the rotten ones, and cleaning them. We have a +collection of grape clusters like the following: +(def grape-clusters + [{:grapes [{:rotten? false :clean? false} + {:rotten? true :clean? false}] + :color :green} + {:grapes [{:rotten? true :clean? false} + {:rotten? false :clean? false}] + :color :black}]) +We are interested in splitting the grape clusters into individual grapes, discarding +the rotten ones and cleaning the remaining grapes so they are ready for eating. We +are well-equipped in ClojureScript for this data transformation task; we could +implement it using the familiar map, filter and mapcat functions: +(defn split-cluster + [c] + (:grapes c)) + +(defn not-rotten + [g] + (not (:rotten? g))) + +(defn clean-grape + [g] + (assoc g :clean? true)) + +(->> grape-clusters + (mapcat split-cluster) + (filter not-rotten) + (map clean-grape)) +;; => ({rotten? false :clean? true} {:rotten? false :clean? true}) +In the above example we succintly solved the problem of selecting and cleaning the +grapes, and we can even abstract such transformations by combining the mapcat, +filter and map operations using partial application and function composition: +(def process-clusters + (comp + (partial map clean-grape) + (partial filter not-rotten) + (partial mapcat split-cluster))) + +(process-clusters grape-clusters) +;; => ({rotten? false :clean? true} {:rotten? false :clean? true}) +The code is very clean, but it has a few problems. For example, each call to map, +filter and mapcat consumes and produces a sequence that, although lazy, generates +intermediate results that will be discarded. Each sequence is fed to the next step, +which also returns a sequence. Wouldn’t be great if we could do the transformation in +a single transversal of the grape-cluster collection? +Another problem is that even though our process-clusters function works with any +sequence, we can’t reuse it with anything that is not a sequence. Imagine that +instead of having the grape cluster collection available in memory it is being pushed +to us asynchronously in a stream. In that situation we couldn’t reuse +process-clusters since usually map, filter and mapcat have concrete +implementations depending on the type. +
+
+Generalizing to process transformations +The process of mapping, filtering or mapcatting isn’t necessarily tied to a concrete +type, but we keep reimplementing them for different types. Let’s see how we can +generalize such processes to be context independent. We’ll start by implementing +naive versions of map and filter first to see how they work internally: +(defn my-map + [f coll] + (when-let [s (seq coll)] + (cons (f (first s)) (my-map f (rest s))))) + +(my-map inc [0 1 2]) +;; => (1 2 3) + +(defn my-filter + [pred coll] + (when-let [s (seq coll)] + (let [f (first s) + r (rest s)] + (if (pred f) + (cons f (my-filter pred r)) + (my-filter pred r))))) + +(my-filter odd? [0 1 2]) +;; => (1) +As we can see, they both assume that they receive a seqable and return a +sequence. Like many recursive functions they can be implemented in terms of the +already familiar reduce function. Note that functions that are given to reduce +receive an accumulator and an input and return the next accumulator. We’ll call these +types of functions reducing functions from now on. +(defn my-mapr + [f coll] + (reduce (fn [acc input] ;; reducing function + (conj acc (f input))) + [] ;; initial value + coll)) ;; collection to reduce + +(my-mapr inc [0 1 2]) +;; => [1 2 3] + +(defn my-filterr + [pred coll] + (reduce (fn [acc input] ;; reducing function + (if (pred input) + (conj acc input) + acc)) + [] ;; initial value + coll)) ;; collection to reduce + +(my-filterr odd? [0 1 2]) +;; => [1] +We’ve made the previous versions more general since using reduce makes our +functions work on any thing that is reducible, not just sequences. However you may +have noticed that, even though my-mapr and my-filterr don’t know anything about +the source (coll) they are still tied to the output they produce (a vector) both +with the initial value of the reduce ([]) and the hardcoded conj operation in the +body of the reducing function. We could have accumulated results in another data +structure, for example a lazy sequence, but we’d have to rewrite the functions in +order to do so. +How can we make these functions truly generic? They shouldn’t know about either the +source of inputs they are transforming nor the output that is generated. Have you +noticed that conj is just another reducing function? It takes an accumulator and an +input and returns another accumulator. So, if we parameterise the reducing function +that my-mapr and my-filterr use, they won’t know anything about the type of the +result they are building. Let’s give it a shot: +(defn my-mapt + [f] ;; function to map over inputs + (fn [rfn] ;; parameterised reducing function + (fn [acc input] ;; transformed reducing function, now it maps `f`! + (rfn acc (f input))))) + +(def incer (my-mapt inc)) + +(reduce (incer conj) [] [0 1 2]) +;; => [1 2 3] + +(defn my-filtert + [pred] ;; predicate to filter out inputs + (fn [rfn] ;; parameterised reducing function + (fn [acc input] ;; transformed reducing function, now it discards values based on `pred`! + (if (pred input) + (rfn acc input) + acc)))) + +(def only-odds (my-filtert odd?)) + +(reduce (only-odds conj) [] [0 1 2]) +;; => [1] +That’s a lot of higher-order functions so let’s break it down for a better +understanding of what’s going on. We’ll examine how my-mapt works step by +step. The mechanics are similar for my-filtert, so we’ll leave it out for now. +First of all, my-mapt takes a mapping function; in the example we are giving +it inc and getting another function back. Let’s replace f with inc to see +what we are building: +(def incer (my-mapt inc)) +;; (fn [rfn] +;; (fn [acc input] +;; (rfn acc (inc input)))) +;; ^^^ +The resulting function is still parameterised to receive a reducing function to +which it will delegate, let’s see what happens when we call it with conj: +(incer conj) +;; (fn [acc input] +;; (conj acc (inc input))) +;; ^^^^ +We get back a reducing function which uses inc to transform the inputs and the +conj reducing function to accumulate the results. In essence, we have defined +map as the transformation of a reducing function. The functions that transform +one reducing function into another are called transducers in ClojureScript. +To ilustrate the generality of transducers, let’s use different sources and +destinations in our call to reduce: +(reduce (incer str) "" [0 1 2]) +;; => "123" + +(reduce (only-odds str) "" '(0 1 2)) +;; => "1" +The transducer versions of map and filter transform a process that carries +inputs from a source to a destination but don’t know anything about where the +inputs come from and where they end up. In their implementation they contain the +essence of what they accomplish, independent of context. +Now that we know more about transducers we can try to implement our own version +of mapcat. We already have a fundamental piece of it: the map +transducer. What mapcat does is map a function over an input and flatten the +resulting structure one level. Let’s try to implement the catenation part as a +transducer: +(defn my-cat + [rfn] + (fn [acc input] + (reduce rfn acc input))) + +(reduce (my-cat conj) [] [[0 1 2] [3 4 5]]) +;; => [0 1 2 3 4 5] +The my-cat transducer returns a reducing function that catenates its inputs +into the accumulator. It does so reducing the input reducible with the rfn +reducing function and using the accumulator (acc) as the initial value for +such reduction. mapcat is simply the composition of map and cat. The order +in which transducers are composed may seem backwards but it’ll become clear in a +moment. +(defn my-mapcat + [f] + (comp (my-mapt f) my-cat)) + +(defn dupe + [x] + [x x]) + +(def duper (my-mapcat dupe)) + +(reduce (duper conj) [] [0 1 2]) +;; => [0 0 1 1 2 2] +
+
+Transducers in ClojureScript core +Some of the ClojureScript core functions like map, filter and mapcat +support an arity 1 version that returns a transducer. Let’s revisit our +definition of process-cluster and define it in terms of transducers: +(def process-clusters + (comp + (mapcat split-cluster) + (filter not-rotten) + (map clean-grape))) +A few things changed since our previous definition process-clusters. First of +all, we are using the transducer-returning versions of mapcat, filter and +map instead of partially applying them for working on sequences. +Also you may have noticed that the order in which they are composed is reversed, +they appear in the order they are executed. Note that all map, filter and +mapcat return a transducer. filter transforms the reducing function returned +by map, applying the filtering before proceeding; mapcat transforms the +reducing function returned by filter, applying the mapping and catenation +before proceeding. +One of the powerful properties of transducers is that they are combined using +regular function composition. What’s even more elegant is that the composition +of various transducers is itself a transducer! This means that our +process-cluster is a transducer too, so we have defined a composable and +context-independent algorithmic transformation. +Many of the core ClojureScript functions accept a transducer, let’s look at some +examples with our newly created process-cluster: +(into [] process-clusters grape-clusters) +;; => [{:rotten? false, :clean? true} {:rotten? false, :clean? true}] + +(sequence process-clusters grape-clusters) +;; => ({:rotten? false, :clean? true} {:rotten? false, :clean? true}) + +(reduce (process-clusters conj) [] grape-clusters) +;; => [{:rotten? false, :clean? true} {:rotten? false, :clean? true}] +Since using reduce with the reducing function returned from a transducer is so +common, there is a function for reducing with a transformation called +transduce. We can now rewrite the previous call to reduce using transduce: +(transduce process-clusters conj [] grape-clusters) +;; => [{:rotten? false, :clean? true} {:rotten? false, :clean? true}] +
+
+Initialisation +In the last example we provided an initial value to the transduce function +([]) but we can omit it and get the same result: +(transduce process-clusters conj grape-clusters) +;; => [{:rotten? false, :clean? true} {:rotten? false, :clean? true}] +What’s going on here? How can transduce know what initial value use as an +accumulator when we haven’t specified it? Try calling conj without any arguments +and see what happens: +(conj) +;; => [] +The conj function has a arity 0 version that returns an empty vector but is +not the only reducing function that supports arity 0. Let’s explore some others: +(+) +;; => 0 + +(*) +;; => 1 + +(str) +;; => "" + +(= identity (comp)) +;; => true +The reducing function returned by transducers must support the arity 0 as well, +which will typically delegate to the transformed reducing function. There is no +sensible implementation of the arity 0 for the transducers we have implemented +so far, so we’ll simply call the reducing function without arguments. Here’s how +our modified my-mapt could look like: +(defn my-mapt + [f] + (fn [rfn] + (fn + ([] (rfn)) ;; arity 0 that delegates to the reducing fn + ([acc input] + (rfn acc (f input)))))) +The call to the arity 0 of the reducing function returned by a transducer will +call the arity 0 version of every nested reducing function, eventually calling +the outermost reducing function. Let’s see an example with our already defined +process-clusters transducer: +((process-clusters conj)) +;; => [] +The call to the arity 0 flows through the transducer stack, eventually calling +(conj). +
+
+Stateful transducers +So far we’ve only seen purely functional transducer; they don’t have any +implicit state and are very predictable. However, there are many data +transformation functions that are inherently stateful, like take. take +receives a number n of elements to keep and a collection and returns a +collection with at most n elements. +(take 10 (range 100)) +;; => (0 1 2 3 4 5 6 7 8 9) +Let’s step back for a bit and learn about the early termination of the reduce +function. We can wrap an accumulator in a type called reduced for telling +reduce that the reduction process should terminate immediately. Let’s see an +example of a reduction that aggregates the inputs in a collection and finishes +as soon as there are 10 elements in the accumulator: +(reduce (fn [acc input] + (if (= (count acc) 10) + (reduced acc) + (conj acc input))) + [] + (range 100)) +;; => [0 1 2 3 4 5 6 7 8 9] +Since transducers are modifications of reducing functions they also use +reduced for early termination. Note that stateful transducers may need to do +some cleanup before the process terminates, so they must support an arity 1 as a +"completion" step. Usually, like with arity 0, this arity will simply delegate +to the transformed reducing function’s arity 1. +Knowing this we are able to write stateful transducers like take. We’ll be +using mutable state internally for tracking the number of inputs we have seen so +far, and wrap the accumulator in a reduced as soon as we’ve seen enough +elements: +(defn my-take + [n] + (fn [rfn] + (let [remaining (volatile! n)] + (fn + ([] (rfn)) + ([acc] (rfn acc)) + ([acc input] + (let [rem @remaining + nr (vswap! remaining dec) + result (if (pos? rem) + (rfn acc input) ;; we still have items to take + acc)] ;; we're done, acc becomes the result + (if (not (pos? nr)) + (ensure-reduced result) ;; wrap result in reduced if not already + result))))))) +This is a simplified version of the take function present in ClojureScript +core. There are a few things to note here so let’s break it up in pieces to +understand it better. +The first thing to notice is that we are creating a mutable value inside the +transducer. Note that we don’t create it until we receive a reducing function to +transform. If we created it before returning the transducer we couldn’t use +my-take more than once. Since the transducer is handed a reducing function to +transform each time it is used, we can use it multiple times and the mutable +variable will be created in every use. +(fn [rfn] + (let [remaining (volatile! n)] ;; make sure to create mutable variables inside the transducer + (fn + ;; ... +))) + +(def take-five (my-take 5)) + +(transduce take-five conj (range 100)) +;; => [0 1 2 3 4] + +(transduce take-five conj (range 100)) +;; => [0 1 2 3 4] +Let’s now dig into the reducing function returned from my-take. First of all +we deref the volatile to get the number of elements that remain to be taken +and decrement it to get the next remaining value. If there are still remaining +items to take, we call rfn passing the accumulator and input; if not, we +already have the final result. +([acc input] + (let [rem @remaining + nr (vswap! remaining dec) + result (if (pos? rem) + (rfn acc input) + acc)] + ;; ... +)) +The body of my-take should be obvious by now. We check whether there are still +items to be processed using the next remainder (nr) and, if not, wrap the +result in a reduced using the ensure-reduced function. ensure-reduced will +wrap the value in a reduced if it’s not reduced already or simply return the +value if it’s already reduced. In case we are not done yet, we return the +accumulated result for further processing. +(if (not (pos? nr)) + (ensure-reduced result) + result) +We’ve seen an example of a stateful transducer but it didn’t do anything in its +completion step. Let’s see an example of a transducer that uses the completion +step to flush an accumulated value. We’ll implement a simplified version of +partition-all, which given a n number of elements converts the inputs in +vectors of size n. For understanding its purpose better let’s see what the +arity 2 version gives us when providing a number and a collection: +(partition-all 3 (range 10)) +;; => ((0 1 2) (3 4 5) (6 7 8) (9)) +The transducer returning function of partition-all will take a number n and +return a transducer that groups inputs in vectors of size n. In the completion +step it will check if there is an accumulated result and, if so, add it to the +result. Here’s a simplified version of ClojureScript core partition-all +function, where array-list is a wrapper for a mutable JavaScript array: +(defn my-partition-all + [n] + (fn [rfn] + (let [a (array-list)] + (fn + ([] (rfn)) + ([result] + (let [result (if (.isEmpty a) ;; no inputs accumulated, don't have to modify result + result + (let [v (vec (.toArray a))] + (.clear a) ;; flush array contents for garbage collection + (unreduced (rfn result v))))] ;; pass to `rfn`, removing the reduced wrapper if present + (rfn result))) + ([acc input] + (.add a input) + (if (== n (.size a)) ;; got enough results for a chunk + (let [v (vec (.toArray a))] + (.clear a) + (rfn acc v)) ;; the accumulated chunk becomes input to `rfn` + acc)))))) + +(def triples (my-partition-all 3)) + +(transduce triples conj (range 10)) +;; => [[0 1 2] [3 4 5] [6 7 8] [9]] +
+
+Eductions +Eductions are a way to combine a collection and one or more transformations that +can be reduced and iterated over, and that apply the transformations every time +we do so. If we have a collection that we want to process and a transformation +over it that we want others to extend, we can hand them a eduction, +encapsulating the source collection and our transformation. We can create an +eduction with the eduction function: +(def ed (eduction (filter odd?) (take 5) (range 100))) + +(reduce + 0 ed) +;; => 25 + +(transduce (partition-all 2) conj ed) +;; => [[1 3] [5 7] [9]] +
+
+More transducers in ClojureScript core +We learned about map, filter, mapcat, take and partition-all, but there are +a lot more transducers available in ClojureScript. Here is an incomplete list of some +other intersting ones: + + +drop is the dual of take, dropping up to n values before passing inputs to +the reducing function + + +distinct only allows inputs to occur once + + +dedupe removes succesive duplicates in input values + + +We encourage you to explore ClojureScript core to see what other transducers are out +there. +
+
+Defining our own transducers +There a few things to consider before writing our own transducers so in this +section we will learn how to properly implement one. First of all, we’ve learned +that the general structure of a transducer is the following: +(fn [xf] + (fn + ([] ;; init + ...) + ([r] ;; completion + ...) + ([acc input] ;; step + ...))) +Usually only the code represented with …​ changes between transducers, these are +the invariants that must be preserved in each arity of the resulting function: + + +arity 0 (init): must call the arity 0 of the nested transform xf + + +arity 1 (completion): used to produce a final value and potentially flush state, +must call the arity 1 of the nested transform xf exactly once + + +arity 2 (step): the resulting reducing function which will call the arity 2 of +the nested transform xf zero, one or more times + + +
+
+Transducible processes +A transducible process is any process that is defined in terms of a succession +of steps ingesting input values. The source of input varies from one process to +another. Most of our examples dealt with inputs from a collection or a lazy +sequence, but it could be an asynchronous stream of values or a core.async +channel. The outputs produced by each step are also different for every process; +into creates a collection with every output of the transducer, sequence +yields a lazy sequence, and asynchronous streams would probably push the outputs +to their listeners. +In order to improve our understanding of transducible processes, we’re going to +implement an unbounded queue, since adding values to a queue can be thought in +terms of a succession of steps ingesting input. First of all we’ll define a +protocol and a data type that implements the unbounded queue: +(defprotocol Queue + (put! [q item] "put an item into the queue") + (take! [q] "take an item from the queue") + (shutdown! [q] "stop accepting puts in the queue")) + +(deftype UnboundedQueue [^:mutable arr ^:mutable closed] + Queue + (put! [_ item] + (assert (not closed)) + (assert (not (nil? item))) + (.push arr item) + item) + (take! [_] + (aget (.splice arr 0 1) 0)) + (shutdown! [_] + (set! closed true))) +We defined the Queue protocol and as you may have noticed the implementation +of UnboundedQueue doesn’t know about transducers at all. It has a put! +operation as its step function and we’re going to implement the transducible +process on top of that interface: +(defn unbounded-queue + ([] + (unbounded-queue nil)) + ([xform] + (let [put! (completing put!) + xput! (if xform (xform put!) put!) + q (UnboundedQueue. #js [] false)] + (reify + Queue + (put! [_ item] + (when-not (.-closed q) + (let [val (xput! q item)] + (if (reduced? val) + (do + (xput! @val) ;; call completion step + (shutdown! q) ;; respect reduced + @val) + val)))) + (take! [_] + (take! q)) + (shutdown! [_] + (shutdown! q)))))) +As you can see, the unbounded-queue constructor uses an UnboundedQueue +instance internally, proxying the take! and shutdown! calls and implementing +the transducible process logic in the put! function. Let’s deconstruct it to +understand what’s going on. +(let [put! (completing put!) + xput! (if xform (xform put!) put!) + q (UnboundedQueue. #js [] false)] + ;; ... +) +First of all, we use completing for adding the arity 0 and arity 1 to the +Queue protocol’s put! function. This will make it play nicely with +transducers in case we give this reducing function to xform to derive another. +After that, if a transducer (xform) was provided, we derive a reducing +function applying the transducer to put!. If we’re not handed a transducer we +will just use put!. q is the internal instance of UnboundedQueue. +(reify + Queue + (put! [_ item] + (when-not (.-closed q) + (let [val (xput! q item)] + (if (reduced? val) + (do + (xput! @val) ;; call completion step + (shutdown! q) ;; respect reduced + @val) + val)))) + ;; ... +) +The exposed put! operation will only be performed if the queue hasn’t been +shut down. Notice that the put! implementation of UnboundedQueue uses an +assert to verify that we can still put values to it and we don’t want to break +that invariant. If the queue isn’t closed we can put values into it, we use the +possibly transformed xput! for doing so. +If the put operation gives back a reduced value it’s telling us that we should +terminate the transducible process. In this case that means shutting down the +queue to not accept more values. If we didn’t get a reduced value we can happily +continue accepting puts. +Let’s see how our queue behaves without transducers: +(def q (unbounded-queue)) +;; => #<[object Object]> + +(put! q 1) +;; => 1 +(put! q 2) +;; => 2 + +(take! q) +;; => 1 +(take! q) +;; => 2 +(take! q) +;; => nil +Pretty much what we expected, let’s now try with a stateless transducer: +(def incq (unbounded-queue (map inc))) +;; => #<[object Object]> + +(put! incq 1) +;; => 2 +(put! incq 2) +;; => 3 + +(take! incq) +;; => 2 +(take! incq) +;; => 3 +(take! incq) +;; => nil +To check that we’ve implemented the transducible process, let’s use a stateful +transducer. We’ll use a transducer that will accept values while they aren’t +equal to 4 and will partition inputs in chunks of 2 elements: +(def xq (unbounded-queue (comp + (take-while #(not= % 4)) + (partition-all 2)))) + +(put! xq 1) +(put! xq 2) +;; => [1 2] +(put! xq 3) +(put! xq 4) ;; shouldn't accept more values from here on +(put! xq 5) +;; => nil + +(take! xq) +;; => [1 2] +(take! xq) ;; seems like `partition-all` flushed correctly! +;; => [3] +(take! xq) +;; => nil +The example of the queue was heavily inspired by how core.async channels use +transducers in their internal step. We’ll discuss channels and their usage with +transducers in a later section. +Transducible processes must respect reduced as a way for signaling early +termination. For example, building a collection stops when encountering a +reduced and core.async channels with transducers are closed. The reduced +value must be unwrapped with deref and passed to the completion step, which +must be called exactly once. +Transducible processes shouldn’t expose the reducing function they generate when +calling the transducer with their own step function since it may be stateful and +unsafe to use from elsewhere. +
+
+
+Transients +Although ClojureScript’s immutable and persistent data structures are reasonably +performant there are situations in which we are transforming large data +structures using multiple steps to only share the final result. For example, the +core into function takes a collection and eagerly populates it with the +contents of a sequence: +(into [] (range 100)) +;; => [0 1 2 ... 98 99] +In the above example we are generating a vector of 100 elements conj-ing one at a +time. Every intermediate vector that is not the final result won’t be seen by anybody +except the into function and the array copying required for persistence is an +unnecesary overhead. +For these situations ClojureScript provides a special version of some of its +persistent data structures, which are called transients. Maps, vectors and sets have +a transient counterpart. Transients are always derived from a persistent data +structure using the transient function, which creates a transient version in +constant time: +(def tv (transient [1 2 3])) +;; => #<[object Object]> +Transients support the read API of their persistent counterparts: +(def tv (transient [1 2 3])) + +(nth tv 0) +;; => 1 + +(get tv 2) +;; => 3 + +(def tm (transient {:language "ClojureScript"})) + +(:language tm) +;; => "ClojureScript" + +(def ts (transient #{:a :b :c})) + +(contains? ts :a) +;; => true + +(:a ts) +;; => :a +Since transients don’t have persistent and immutable semantics for updates they +can’t be transformed using the already familiar conj or assoc +functions. Instead, the transforming functions that work on transients end with +a bang. Let’s look at an example using conj! on a transient: +(def tv (transient [1 2 3])) + +(conj! tv 4) +;; => #<[object Object]> + +(nth tv 3) +;; => 4 +As you can see, the transient version of the vector is neither immutable nor +persistent. Instead, the vector is mutated in place. Although we could transform +tv repeatedly using conj! on it we shouldn’t abandon the idioms used with +the persistent data structures: when transforming a transient, use the returned +version of it for further modifications like in the following example: +(-> [1 2 3] + transient + (conj! 4) + (conj! 5)) +;; => #<[object Object]> +We can convert a transient back to a persistent and immutable data structure by +calling persistent! on it. This operation, like deriving a transient from a +persistent data structure, is done in constant time. +(-> [1 2 3] + transient + (conj! 4) + (conj! 5) + persistent!) +;; => [1 2 3 4 5] +A peculiarity of transforming transients into persistent structures is that the +transient version is invalidated after being converted to a persistent data +structure and we can’t do further transformations to it. This happens because +the derived persistent data structure uses the transient’s internal nodes and +mutating them would break the immutability and persistent guarantees: +(def tm (transient {})) +;; => #<[object Object]> + +(assoc! tm :foo :bar) +;; => #<[object Object]> + +(persistent! tm) +;; => {:foo :bar} + +(assoc! tm :baz :frob) +;; Error: assoc! after persistent! +Going back to our initial example with into, here’s a very simplified +implementation of it that uses a transient for performance, returning a +persistent data structure and thus exposing a purely functional interface +although it uses mutation internally: +(defn my-into + [to from] + (persistent! (reduce conj! (transient to) from))) + +(my-into [] (range 100)) +;; => [0 1 2 ... 98 99] +
+
+Metadata +ClojureScript symbols, vars and persistent collections support attaching +metadata to them. Metadata is a map with information about the entity it’s +attached to. The ClojureScript compiler uses metadata for several purposes such +as type hints, and the metadata system can be used by tooling, library and +application developers too. +There may not be many cases in day-to-day ClojureScript programming where you +need metadata, but it is a nice language feature to have and know about; it may +come in handy at some point. It makes things like runtime code introspection and +documentation generation very easy. You’ll see why throughout this section. +
+Vars +Let’s define a var and see what metadata is attached to it by default. Note that +this code is executed in a REPL, and thus the metadata of a var defined in a +source file may vary. We’ll use the meta function to retrieve the metadata of +the given value: +(def answer-to-everything 42) +;; => 42 + +#'answer-to-everything +;; => #'cljs.user/answer-to-everyhing + +(meta #'answer-to-everything) +;; => {:ns cljs.user, +;; :name answer-to-everything, +;; :file "NO_SOURCE_FILE", +;; :source "answer-to-everything", +;; :column 6, +;; :end-column 26, +;; :line 1, +;; :end-line 1, +;; :arglists (), +;; :doc nil, +;; :test nil} +Few things to note here. First of all, #'answer-to-everything gives us a +reference to the Var that holds the value of the answer-to-everything +symbol. We see that it includes information about the namespace (:ns) in which +it was defined, its name, file (although, since it was defined at a REPL doesn’t +have a source file), source, position in the file where it was defined, argument +list (which only makes sense for functions), documentation string and test +function. +Let’s take a look at a function var’s metadata: +(defn add + "A function that adds two numbers." + [x y] + (+ x y)) + +(meta #'add) +;; => {:ns cljs.user, +;; :name add, +;; :file "NO_SOURCE_FILE", +;; :source "add", +;; :column 7, +;; :end-column 10, +;; :line 1, +;; :end-line 1, +;; :arglists (quote ([x y])), +;; :doc "A function that adds two numbers.", +;; :test nil} +We see that the argument lists are stored in the :arglists field of the var’s +metadata and its documentation in the :doc field. We’ll now define a test +function to learn about what :test is used for: +(require '[cljs.test :as t]) + +(t/deftest i-pass + (t/is true)) + +(meta #'i-pass) +;; => {:ns cljs.user, +;; :name i-pass, +;; :file "NO_SOURCE_FILE", +;; :source "i-pass", +;; :column 12, +;; :end-column 18, +;; :line 1, +;; :end-line 1, +;; :arglists (), +;; :doc "A function that adds two numbers.", +;; :test #<function (){ ... }>} +The :test attribute (truncated for brevity) in the i-pass var’s metadata is +a test function. This is used by the cljs.test library for discovering and +running tests in the namespaces you tell it to. +
+
+Values +We learned that vars can have metadata and what kind of metadata is added to +them for consumption by the compiler and the cljs.test testing +library. Persistent collections can have metadata too, although they don’t have +any by default. We can use the with-meta function to derive an object with the +same value and type with the given metadata attached. Let’s see how: +(def map-without-metadata {:language "ClojureScript"}) +;; => {:language "ClojureScript"} + +(meta map-without-metadata) +;; => nil + +(def map-with-metadata (with-meta map-without-metadata + {:answer-to-everything 42})) +;; => {:language "ClojureScript"} + +(meta map-with-metadata) +;; => {:answer-to-everything 42} + +(= map-with-metadata + map-without-metadata) +;; => true + +(identical? map-with-metadata + map-without-metadata) +;; => false +It shouldn’t come as a surprise that metadata doesn’t affect equality between +two data structures since equality in ClojureScript is based on value. Another +interesting thing is that with-meta creates another object of the same type +and value as the given one and attaches the given metadata to it. +Another open question is what happens with metadata when deriving new values +from a persistent data structure. Let’s find out: +(def derived-map (assoc map-with-metadata :language "Clojure")) +;; => {:language "Clojure"} + +(meta derived-map) +;; => {:answer-to-everything 42} +As you can see in the example above, metadata is preserved in derived versions +of persistent data structures. There are some subtleties, though. As long as the +functions that derive new data structures return collections with the same type, +metadata will be preserved; this is not true if the types change due to the +transformation. To ilustrate this point, let’s see what happens when we derive a +seq or a subvector from a vector: +(def v (with-meta [0 1 2 3] {:foo :bar})) +;; => [0 1 2 3] + +(def sv (subvec v 0 2)) +;; => [0 1] + +(meta sv) +;; => nil + +(meta (seq v)) +;; => nil +
+
+Syntax for metadata +The ClojureScript reader has syntactic support for metadata annotations, which +can be written in different ways. We can prepend var definitions or collections +with a caret (^) followed by a map for annotating it with the given metadata +map: +(def ^{:doc "The answer to Life, Universe and Everything."} answer-to-everything 42) +;; => 42 + +(meta #'answer-to-everything) +;; => {:ns cljs.user, +;; :name answer-to-everything, +;; :file "NO_SOURCE_FILE", +;; :source "answer-to-everything", +;; :column 6, +;; :end-column 26, +;; :line 1, +;; :end-line 1, +;; :arglists (), +;; :doc "The answer to Life, Universe and Everything.", +;; :test nil} + +(def map-with-metadata ^{:answer-to-everything 42} {:language "ClojureScript"}) +;; => {:language "ClojureScript"} + +(meta map-with-metadata) +;; => {:answer-to-everything 42} +Notice how the metadata given in the answer-to-everything var definition is +merged with the var metadata. +A very common use of metadata is to set certain keys to a true value. For example +we may want to add to a var’s metadata that the variable is dynamic or a +constant. For such cases, we have a shorthand notation that uses a caret followed by +a keyword. Here are some examples: +(def ^:dynamic *foo* 42) +;; => 42 + +(:dynamic (meta #'*foo*)) +;; => true + +(def ^:foo ^:bar answer 42) +;; => 42 + +(select-keys (meta #'answer) [:foo :bar]) +;; => {:foo true, :bar true} +There is another shorthand notation for attaching metadata. If we use a caret +followed by a symbol it will be added to the metadata map under the :tag +key. Using tags such as ^boolean gives the ClojureScript compiler hints about +the type of expressions or function return types. +(defn ^boolean will-it-blend? [_] true) +;; => #<function ... > + +(:tag (meta #'will-it-blend?)) +;; => boolean + +(not ^boolean (js/isNaN js/NaN)) +;; => false +
+
+Functions for working with metadata +We’ve learned about meta and with-meta so far but ClojureScript offers a few +functions for transforming metadata. There is vary-meta which is similar to +with-meta in that it derives a new object with the same type and value as the +original but it doesn’t take the metadata to attach directly. Instead, it takes +a function to apply to the metadata of the given object to transform it for +deriving new metadata. This is how it works: +(def map-with-metadata ^{:foo 40} {:language "ClojureScript"}) +;; => {:language "ClojureScript"} + +(meta map-with-metadata) +;; => {:foo 40} + +(def derived-map (vary-meta map-with-metadata update :foo + 2)) +;; => {:language "ClojureScript"} + +(meta derived-map) +;; => {:foo 42} +If instead we want to change the metadata of an existing var or value we can use +alter-meta! for changing it by applying a function or reset-meta! for +replacing it with another map: +(def map-with-metadata ^{:foo 40} {:language "ClojureScript"}) +;; => {:language "ClojureScript"} + +(meta map-with-metadata) +;; => {:foo 40} + +(alter-meta! map-with-metadata update :foo + 2) +;; => {:foo 42} + +(meta map-with-metadata) +;; => {:foo 42} + +(reset-meta! map-with-metadata {:foo 40}) +;; => {:foo 40} + +(meta map-with-metadata) +;; => {:foo 40} +
+
+
+Core protocols +One of the greatest qualities of the core ClojureScript functions is that they are +implemented around protocols. This makes them open to work on any type that we +extend with such protocols, be it defined by us or a third party. +
+Functions +As we’ve learned in previous chapters not only functions can be invoked. Vectors are +functions of their indexes, maps are functions of their keys and sets are functions +of their values. +We can extend types to be callable as functions implementing the IFn protocol. A +collection that doesn’t support calling it as a function is the queue, let’s +implement IFn for the PersistentQueue type so we’re able to call queues as +functions of their indexes: +(extend-type PersistentQueue + IFn + (-invoke + ([this idx] + (nth this idx)))) + +(def q #queue[:a :b :c]) +;; => #queue [:a :b :c] + +(q 0) +;; => :a + +(q 1) +;; => :b + +(q 2) +;; => :c +
+
+Printing +For learning about some of the core protocols we’ll define a Pair type, which will +hold a pair of values. +(deftype Pair [fst snd]) +If we want to customize how types are printed we can implement the +IPrintWithWriter protocol. It defines a function called -pr-writer that receives +the value to print, a writer object and options; this function uses the writer +object’s -write function to write the desired Pair string representation: +(extend-type Pair + IPrintWithWriter + (-pr-writer [p writer _] + (-write writer (str "#<Pair " (.-fst p) "," (.-snd p) ">")))) +
+
+Sequences +In a previous section we learned about sequences, one +of ClojureScript’s main abstractions. Remember the first and rest functions for +working with sequences? They are defined in the ISeq protocol, so we can extend +types for responding to such functions: +(extend-type Pair + ISeq + (-first [p] + (.-fst p)) + + (-rest [p] + (list (.-snd p)))) + +(def p (Pair. 1 2)) +;; => #<Pair 1,2> + +(first p) +;; => 1 + +(rest p) +;; => (2) +Another handy function for working with sequences is next. Although next works +as long as the given argument is a sequence, we can implement it explicitly with the +INext protocol: +(def p (Pair. 1 2)) + +(next p) +;; => (2) + +(extend-type Pair + INext + (-next [p] + (println "Our next") + (list (.-snd p)))) + +(next p) +;; Our next +;; => (2) +Finally, we can make our own types seqable implementing the ISeqable +protocol. This means we can pass them to seq for getting a sequence back. +ISeqable +(def p (Pair. 1 2)) + +(extend-type Pair + ISeqable + (-seq [p] + (list (.-fst p) (.-snd p)))) + +(seq p) +;; => (1 2) +Now our Pair type works with the plethora of ClojureScript functions for working +with sequences: +(def p (Pair. 1 2)) +;; => #<Pair 1,2> + +(map inc p) +;; => (2 3) + +(filter odd? p) +;; => (1) + +(reduce + p) +;; => 3 +
+
+Collections +Collection functions are also defined in terms of protocols. For this section +examples we will make the native JavaScript string act like a collection. +The most important function for working with collection is conj, defined in the +ICollection protocol. Strings are the only type which makes sense to conj to a +string, so the conj operation for strings will be simply a concatenation: +(extend-type string + ICollection + (-conj [this o] + (str this o))) + +(conj "foo" "bar") +;; => "foobar" + +(conj "foo" "bar" "baz") +;; => "foobarbaz" +Another handy function for working with collections is empty, which is part of the +IEmptyableCollection protocol. Let’s implement it for the string type: +(extend-type string + IEmptyableCollection + (-empty [_] + "")) + +(empty "foo") +;; => "" +We used the string special symbol for extending the native JavaScript string. If +you want to learn more about it check the section +about extending JavaScript types. +
+Collection traits +There are some qualities that not all collections have, such as being countable in +constant time or being reversible. These traits are splitted into different +protocols since not all of them make sense for every collection. For illustrating +these protocols we’ll use the Pair type we defined earlier. +For collections that can be counted in constant time using the count function we +can implement the ICounted protocol. It should be easy to implement it for the +Pair type: +(extend-type Pair + ICounted + (-count [_] + 2)) + +(def p (Pair. 1 2)) + +(count p) +;; => 2 +Some collection types such as vectors and lists can be indexed by a number using the +nth function. If our types are indexed we can implement the IIndexed protocol: +(extend-type Pair + IIndexed + (-nth + ([p idx] + (case idx + 0 (.-fst p) + 1 (.-snd p) + (throw (js/Error. "Index out of bounds")))) + ([p idx default] + (case idx + 0 (.-fst p) + 1 (.-snd p) + default)))) + +(nth p 0) +;; => 1 + +(nth p 1) +;; => 2 + +(nth p 2) +;; Error: Index out of bounds + +(nth p 2 :default) +;; => :default +
+
+
+Associative +There are many data structures that are associative: they map keys to values. We’ve +encountered a few of them already and we know many functions for working with them +like get, assoc or dissoc. Let’s explore the protocols that these functions +build upon. +First of all, we need a way to look up keys on an associative data structure. The +ILookup protocol defines a function for doing so, let’s add the ability to look up +keys in our Pair type since it is an associative data structure that maps the indices +0 and 1 to values. +(extend-type Pair + ILookup + (-lookup + ([p k] + (-lookup p k nil)) + ([p k default] + (case k + 0 (.-fst p) + 1 (.-snd p) + default)))) + +(get p 0) +;; => 1 + +(get p 1) +;; => 2 + +(get p :foo) +;; => nil + +(get p 2 :default) +;; => :default +For using assoc on a data structure it must implement the IAssociative +protocol. For our Pair type only 0 and 1 will be allowed as keys for associating +values. IAssociative also has a function for asking whether a key is present or +not. +(extend-type Pair + IAssociative + (-contains-key? [_ k] + (contains? #{0 1} k)) + + (-assoc [p k v] + (case k + 0 (Pair. v (.-snd p)) + 1 (Pair. (.-fst p) v) + (throw (js/Error. "Can only assoc to 0 and 1 keys"))))) + +(def p (Pair. 1 2)) +;; => #<Pair 1,2> + +(assoc p 0 2) +;; => #<Pair 2,2> + +(assoc p 1 1) +;; => #<Pair 1,1> + +(assoc p 0 0 1 1) +;; => #<Pair 0,1> + +(assoc p 2 3) +;; Error: Can only assoc to 0 and 1 keys +The complementary function for assoc is dissoc and it’s part of the IMap +protocol. It doesn’t make much sense for our Pair type but we’ll implement it +nonetheless. Dissociating 0 or 1 will mean putting a nil in such position and +invalid keys will be ignored. +(extend-type Pair + IMap + (-dissoc [p k] + (case k + 0 (Pair. nil (.-snd p)) + 1 (Pair. (.-fst p) nil) + p))) + +(def p (Pair. 1 2)) +;; => #<Pair 1,2> + +(dissoc p 0) +;; => #<Pair ,2> + +(dissoc p 1) +;; => #<Pair 1,> + +(dissoc p 2) +;; => #<Pair 1,2> + +(dissoc p 0 1) +;; => #<Pair ,> +Associative data structures are made of key and value pairs we can call entries. The +key and val functions allow us to query the key and value of such entries and +they are built upon the IMapEntry protocol. Let’s see a few examples of key and +val and how map entries can be used to build up maps: +(key [:foo :bar]) +;; => :foo + +(val [:foo :bar]) +;; => :bar + +(into {} [[:foo :bar] [:baz :xyz]]) +;; => {:foo :bar, :baz :xyz} +Pairs can be map entries too, we treat their first element as the key and the second +as the value: +(extend-type Pair + IMapEntry + (-key [p] + (.-fst p)) + + (-val [p] + (.-snd p))) + +(def p (Pair. 1 2)) +;; => #<Pair 1,2> + +(key p) +;; => 1 + +(val p) +;; => 2 + +(into {} [p]) +;; => {1 2} +
+
+Comparison +For checking whether two or more values are equivalent with = we must implement +the IEquiv protocol. Let’s do it for our Pair type: +(def p (Pair. 1 2)) +(def p' (Pair. 1 2)) +(def p'' (Pair. 1 2)) + +(= p p') +;; => false + +(= p p' p'') +;; => false + +(extend-type Pair + IEquiv + (-equiv [p other] + (and (instance? Pair other) + (= (.-fst p) (.-fst other)) + (= (.-snd p) (.-snd other))))) + +(= p p') +;; => true + +(= p p' p'') +;; => true +We can also make types comparable. The function compare takes two values and +returns a negative number if the first is less than the second, 0 if both are equal +and 1 if the first is greater than the second. For making our types comparable we +must implement the IComparable protocol. +For pairs, comparison will mean checking if the two first values are equal. If they +are, the result will be the comparison of the second values. If not, we will return +the result of the first comparison: +(extend-type Pair + IComparable + (-compare [p other] + (let [fc (compare (.-fst p) (.-fst other))] + (if (zero? fc) + (compare (.-snd p) (.-snd other)) + fc)))) + +(compare (Pair. 0 1) (Pair. 0 1)) +;; => 0 + +(compare (Pair. 0 1) (Pair. 0 2)) +;; => -1 + +(compare (Pair. 1 1) (Pair. 0 2)) +;; => 1 + +(sort [(Pair. 1 1) (Pair. 0 2) (Pair. 0 1)]) +;; => (#<Pair 0,1> #<Pair 0,2> #<Pair 1,1>) +
+
+Metadata +The meta and with-meta functions are also based upon two protocols: IMeta and +IWithMeta respectively. We can make our own types capable of carrying metadata +adding an extra field for holding the metadata and implementing both protocols. +Let’s implement a version of Pair that can have metadata: +(deftype Pair [fst snd meta] + IMeta + (-meta [p] meta) + + IWithMeta + (-with-meta [p new-meta] + (Pair. fst snd new-meta))) + + +(def p (Pair. 1 2 {:foo :bar})) +;; => #<Pair 1,2> + +(meta p) +;; => {:foo :bar} + +(def p' (with-meta p {:bar :baz})) +;; => #<Pair 1,2> + +(meta p') +;; => {:bar :baz} +
+
+Interoperability with JavaScript +Since ClojureScript is hosted in a JavaScript VM we often need to convert +ClojureScript data structures to JavaScript ones and viceversa. We also may want to +make native JS types participate in an abstraction represented by a protocol. +
+Extending JavaScript types +When extending JavaScript objects instead of using JS globals like js/String, +js/Date and such, special symbols are used. This is done for avoiding mutating +global JS objects. +The symbols for extending JS types are: object, array, number, string, +function, boolean and nil is used for the null object. The dispatch of the +protocol to native objects uses Google Closure’s +goog.typeOf +function. There’s a special default symbol that can be used for making a default +implementation of a protocol for every type. +For illustrating the extension of JS types we are going to define a MaybeMutable +protocol that’ll have a mutable? predicate as its only function. Since in +JavaScript mutability is the default we’ll extend the default JS type returning true +from mutable?: +(defprotocol MaybeMutable + (mutable? [this] "Returns true if the value is mutable.")) + +(extend-type default + MaybeMutable + (mutable? [_] true)) + +;; object +(mutable? #js {}) +;; => true + +;; array +(mutable? #js []) +;; => true + +;; string +(mutable? "") +;; => true + +;; function +(mutable? (fn [x] x)) +;; => true +Since fortunately not all JS object’s values are mutable we can refine the +implementation of MaybeMutable for returning false for strings and functions. +(extend-protocol MaybeMutable + string + (mutable? [_] false) + + function + (mutable? [_] false)) + + +;; object +(mutable? #js {}) +;; => true + +;; array +(mutable? #js []) +;; => true + +;; string +(mutable? "") +;; => false + +;; function +(mutable? (fn [x] x)) +;; => false +There is no special symbol for JavaScript dates so we have to extend js/Date +directly. The same applies to the rest of the types found in the global js +namespace. +
+
+Converting data +For converting values from ClojureScript types to JavaScript ones and viceversa we +use the clj→js and js→clj functions, which are based in the IEncodeJS and +IEncodeClojure protocols respectively. +For the examples we’ll use the Set type introduced in ES6. Note that is not +available in every JS runtime. +
+From ClojureScript to JS +First of all we’ll extend ClojureScript’s set type for being able to convert it to +JS. By default sets are converted to JavaScript arrays: +(clj->js #{1 2 3}) +;; => #js [1 3 2] +Let’s fix it, clj→js is supposed to convert values recursively so we’ll make sure +to convert all the set contents to JS and creating the set with the converted +values: +(extend-type PersistentHashSet + IEncodeJS + (-clj->js [s] + (js/Set. (into-array (map clj->js s))))) + +(def s (clj->js #{1 2 3})) +(es6-iterator-seq (.values s)) +;; => (1 3 2) + +(instance? js/Set s) +;; => true + +(.has s 1) +;; => true +(.has s 2) +;; => true +(.has s 3) +;; => true +(.has s 4) +;; => false +The es6-iterator-seq is an experimental function in ClojureScript core for +obtaining a seq from an ES6 iterable. +
+
+From JS to ClojureScript +Now it’s time to extend the JS set to convert to ClojureScript. As with clj→js, +js→clj recursively converts the value of the data structure: +(extend-type js/Set + IEncodeClojure + (-js->clj [s options] + (into #{} (map js->clj (es6-iterator-seq (.values s)))))) + +(= #{1 2 3} + (js->clj (clj->js #{1 2 3}))) +;; => true + +(= #{[1 2 3] [4 5] [6]} + (js->clj (clj->js #{[1 2 3] [4 5] [6]}))) +;; => true +Note that there is no one-to-one mapping between ClojureScript and JavaScript +values. For example, ClojureScript keywords are converted to JavaScript strings when +passed to clj→js. +
+
+
+
+Reductions +The reduce function is based on the IReduce protocol, which enables us to make +our own or third-party types reducible. Apart from using them with reduce they +will automatically work with transduce too, which will allow us to make a +reduction with a transducer. +The JS array is already reducible in ClojureScript: +(reduce + #js [1 2 3]) +;; => 6 + +(transduce (map inc) conj [] [1 2 3]) +;; => [2 3 4] +However, the new ES6 Set type isn’t so let’s implement the IReduce protocol. We’ll +get an iterator using the Set’s values method and convert it to a seq with the +es6-iterator-seq function; after that we’ll delegate to the original reduce +function to reduce the obtained sequence. +(extend-type js/Set + IReduce + (-reduce + ([s f] + (let [it (.values s)] + (reduce f (es6-iterator-seq it)))) + ([s f init] + (let [it (.values s)] + (reduce f init (es6-iterator-seq it)))))) + +(reduce + (js/Set. #js [1 2 3])) +;; => 6 + +(transduce (map inc) conj [] (js/Set. #js [1 2 3])) +;; => [2 3 4] +Associative data structures can be reduced with the reduce-kv function, which is +based in the IKVReduce protocol. The main difference between reduce and +reduce-kv is that the latter uses a three-argument function as a reducer, +receiving the accumulator, key and value for each item. +Let’s look at an example, we will reduce a map to a vector of pairs. Note that, +since vectors associate indexes to values, they can also be reduced with +reduce-kv. +(reduce-kv (fn [acc k v] + (conj acc [k v])) + [] + {:foo :bar + :baz :xyz}) +;; => [[:foo :bar] [:baz :xyz]] +We’ll extend the new ES6 map type to support reduce-kv, we’ll do this by getting a +sequence of key-value pairs and calling the reducing function with the accumulator, +key and value as positional arguments: +(extend-type js/Map + IKVReduce + (-kv-reduce [m f init] + (let [it (.entries m)] + (reduce (fn [acc [k v]] + (f acc k v)) + init + (es6-iterator-seq it))))) + +(def m (js/Map.)) +(.set m "foo" "bar") +(.set m "baz" "xyz") + +(reduce-kv (fn [acc k v] + (conj acc [k v])) + [] + m) +;; => [["foo" "bar"] ["baz" "xyz"]] +In both examples we ended up delegating to the reduce function, which is aware of +reduced values and terminates when encountering one. Take into account that if you +don’t implement these protocols in terms of reduce you will have to check for +reduced values for early termination. +
+
+Delayed computation +There are some types that have the notion of asynchronous computation, the value +they represent may not be realized yet. We can ask whether a value is realized using +the realized? predicate. +Let’s ilustrate it with the Delay type, which takes a computation and executes it +when the result is needed. When we dereference a delay the computation is run and +the delay is realized: +(defn computation [] + (println "running!") + 42) + +(def d (delay (computation))) + +(realized? d) +;; => false + +(deref d) +;; running! +;; => 42 + +(realized? d) +;; => true + +@d +;; => 42 +Both realized? and deref sit atop two protocols: IPending and IDeref. +
+
+State +The ClojureScript state constructs such as the Atom and the Volatile have different +characteristics and semantics, and the operations on them like add-watch, reset! +or swap! are backed by protocols. +
+Atom +For ilustrating such protocols we will implement our own simplified version of an +Atom. It won’t support validators nor metadata, but we will be able to: + + +deref the atom for getting its current value + + +reset! the value contained in the atom + + +swap! the atom with a function for transforming its state + + +deref is based on the IDeref protocol. reset! is based on the IReset +protocol and swap! on ISwap. We’ll start by defining a data type and a +constructor for our atom implementation: +(deftype MyAtom [^:mutable state ^:mutable watches] + IPrintWithWriter + (-pr-writer [p writer _] + (-write writer (str "#<MyAtom " (pr-str state) ">")))) + +(defn my-atom + ([] + (my-atom nil)) + ([init] + (MyAtom. init {}))) + +(my-atom) +;; => #<MyAtom nil> + +(my-atom 42) +;; => #<MyAtom 42> +Note that we’ve marked both the current state of the atom (state) and the map of +watchers (watches) with the {:mutable true} metadata. We’ll be modifying them +and we’re making this explicit with the annotations. +Our MyAtom type is not very useful yet, we’ll start by implementing the IDeref +protocol so we can dereference its current value: +(extend-type MyAtom + IDeref + (-deref [a] + (.-state a))) + +(def a (my-atom 42)) + +@a +;; => 42 +Now that we can dereference it we’ll implement the IWatchable protocol, which will +let us add and remove watches to our custom atom. We’ll store the watches in the +watches map of MyAtom, associating keys to callbacks. +(extend-type MyAtom + IWatchable + (-add-watch [a key f] + (let [ws (.-watches a)] + (set! (.-watches a) (assoc ws key f)))) + + (-remove-watch [a key] + (let [ws (.-watches a)] + (set! (.-watches a) (dissoc ws key)))) + + (-notify-watches [a oldval newval] + (doseq [[key f] (.-watches a)] + (f key a oldval newval)))) +We can now add watches to our atom but is not very useful since we still can’t +change it. For incorporating change we have to implement the IReset protocol and +make sure we notify the watches every time we reset the atom’s value. +(extend-type MyAtom + IReset + (-reset! [a newval] + (let [oldval (.-state a)] + (set! (.-state a) newval) + (-notify-watches a oldval newval) + newval))) +Now let’s check that we got it right. We’ll add a watch, change the atom’s value +making sure the watch gets called and then remove it: +(def a (my-atom 41)) +;; => #<MyAtom 41> + +(add-watch a :log (fn [key a oldval newval] + (println {:key key + :old oldval + :new newval}))) +;; => #<MyAtom 41> + +(reset! a 42) +;; {:key :log, :old 41, :new 42} +;; => 42 + +(remove-watch a :log) +;; => #<MyAtom 42> + +(reset! a 43) +;; => 43 +Our atom is still missing the swapping functionality so we’ll add that now, let’s +implement the ISwap protocol. There are four arities for the -swap! method of +the protocol since the function passed to swap! may take one, two, three or more +arguments: +(extend-type MyAtom + ISwap + (-swap! + ([a f] + (let [oldval (.-state a) + newval (f oldval)] + (reset! a newval))) + + ([a f x] + (let [oldval (.-state a) + newval (f oldval x)] + (reset! a newval))) + + ([a f x y] + (let [oldval (.-state a) + newval (f oldval x y)] + (reset! a newval))) + + ([a f x y more] + (let [oldval (.-state a) + newval (apply f oldval x y more)] + (reset! a newval))))) +We now have a custom implementation of the atom abstraction, let’s test it in the +REPL and see if it behaves like we expect: +(def a (my-atom 0)) +;; => #<MyAtom 0> + +(add-watch a :log (fn [key a oldval newval] + (println {:key key + :old oldval + :new newval}))) +;; => #<MyAtom 0> + +(swap! a inc) +;; {:key :log, :old 0, :new 1} +;; => 1 + +(swap! a + 2) +;; {:key :log, :old 1, :new 3} +;; => 3 + +(swap! a - 2) +;; {:key :log, :old 3, :new 1} +;; => 1 + +(swap! a + 2 3) +;; {:key :log, :old 1, :new 6} +;; => 6 + + +(swap! a + 4 5 6) +;; {:key :log, :old 6, :new 21} +;; => 21 + +(swap! a * 2) +;; {:key :log, :old 21, :new 42} +;; => 42 + +(remove-watch a :log) +;; => #<MyAtom 42> +We did it! We implemented a version of ClojureScript Atom without support for +metadata nor validators, extending it to support such features is left as an +exercise for the reader. Note that you’ll need to modify the MyAtom type for being +able to store metadata and a validator. +
+
+Volatile +Volatiles are simpler than atoms in that they don’t support watching for +changes. All changes override the previous value much like the mutable variables +present in almost every programming language. Volatiles are based on the IVolatile +protocol that only defines a method for vreset!, since vswap! is implemented as +a macro. +Let’s start by creating our own volatile type and constructor: +(deftype MyVolatile [^:mutable state] + IPrintWithWriter + (-pr-writer [p writer _] + (-write writer (str "#<MyVolatile " (pr-str state) ">")))) + +(defn my-volatile + ([] + (my-volatile nil)) + ([v] + (MyVolatile. v))) + +(my-volatile) +;; => #<MyVolatile nil> + +(my-volatile 42) +;; => #<MyVolatile 42> +Our MyVolatile still needs to support dereferencing and reseting it, let’s +implement IDeref and IVolatile, which will enable use to use deref, vreset! +and vswap! in our custom volatile: +(extend-type MyVolatile + IDeref + (-deref [v] + (.-state v)) + + IVolatile + (-vreset! [v newval] + (set! (.-state v) newval) + newval)) + +(def v (my-volatile 0)) +;; => #<MyVolatile 42> + +(vreset! v 1) +;; => 1 + +@v +;; => 1 + +(vswap! v + 2 3) +;; => 6 + +@v +;; => 6 +
+
+
+Mutation +In the section about transients we learned about the mutable +counterparts of the immutable and persistent data structures that ClojureScript +provides. These data structures are mutable, and the operations on them end with a +bang (!) to make that explicit. As you may have guessed every operation on +transients is based on protocols. +
+From persistent to transient and viceversa +We’ve learned that we can transform a persistent data structure with the transient +function, which is based on the IEditableCollection protocol; for transforming a +transient data structure to a persistent one we use persistent!, based on +ITransientCollection. +Implementing immutable and persistent data structures and their transient +counterparts is out of the scope of this book but we recommend taking a look at +ClojureScript’s data structure implementation if you are curious. +
+
+Transient vectors and sets +We’ve learned about most of the protocols for transient data structures but we’re +missing two: ITransientVector for using assoc! on transient vectors and +ITransientSet for using disj! on transient sets. +For illustrating the ITransientVector protocol we’ll extend the JavaScript array +type for making it an associative transient data structure: +(extend-type array + ITransientAssociative + (-assoc! [arr key val] + (if (number? key) + (-assoc-n! arr key val) + (throw (js/Error. "Array's key for assoc! must be a number.")))) + + ITransientVector + (-assoc-n! [arr n val] + (.splice arr n 1 val) + arr)) + +(def a #js [1 2 3]) +;; => #js [1 2 3] + +(assoc! a 0 42) +;; => #js [42 2 3] + +(assoc! a 1 43) +;; => #js [42 43 3] + +(assoc! a 2 44) +;; => #js [42 43 44] +For illustrating the ITransientSet protocol we’ll extend the ES6 Set type for +making it a transient set, supporting the conj!, disj! and persistent! +operations. Note that we’ve extended the Set type previously for being able to +convert it to ClojureScript and we’ll take advantage of that fact. +(extend-type js/Set + ITransientCollection + (-conj! [s v] + (.add s v) + s) + + (-persistent! [s] + (js->clj s)) + + ITransientSet + (-disjoin! [s v] + (.delete s v) + s)) + +(def s (js/Set.)) + +(conj! s 1) +(conj! s 1) +(conj! s 2) +(conj! s 2) + +(persistent! s) +;; => #{1 2} + +(disj! s 1) + +(persistent! s) +;; => #{2} +
+
+
+
+CSP (with core.async) +CSP stands for Communicating Sequential Processes, which is a formalism for +describing concurrent systems pioneered by C. A. R. Hoare in 1978. It is a +concurrency model based on message passing and synchronization through channels. An +in-depth look at the theoretical model behind CSP is beyond the scope of this book; +instead we’ll focus on presenting the concurrency primitives that core.async +offers. +core.async is not part of ClojureScript core but it’s implemented as a library. +Even though it is not part of the core language it’s widely used. Many libraries build +on top of the core.async primitives, so we think it is worth covering in the book. +It’s also a good example of the syntactic abstractions that can be achieved by +transforming code with ClojureScript macros, so we’ll jump right in. You’ll need to +have core.async installed to run the examples presented in this section. +
+Channels +Channels are like conveyor belts, we can put and take a single value at a time from +them. They can have multiple readers and writers, and they are the fundamental +message-passing mechanism of core.async. In order to see how it works, we’ll +create a channel to perform some operations on it. +(require '[cljs.core.async :refer [chan put! take!]]) + +(enable-console-print!) + +(def ch (chan)) + +(take! ch #(println "Got a value:" %)) +;; => nil + +;; there is a now a pending take operation, let's put something on the channel + +(put! ch 42) +;; Got a value: 42 +;; => 42 +In the above example we created a channel ch using the chan constructor. After +that we performed a take operation on the channel, providing a callback that will be +invoked when the take operation succeeds. After using put! to put a value on the +channel the take operation completed and the "Got a value: 42" string was +printed. Note that put! returned the value that was just put to the channel. +The put! function accepts a callback like take! does but we didn’t provide any +in the last example. For puts the callback will be called whenever the value we +provided has been taken. Puts and takes can happen in any order, let’s do a few puts +followed by takes to illustrate the point: +(require '[cljs.core.async :refer [chan put! take!]]) + +(def ch (chan)) + +(put! ch 42 #(println "Just put 42")) +;; => true +(put! ch 43 #(println "Just put 43")) +;; => true + +(take! ch #(println "Got" %)) +;; Got 42 +;; Just put 42 +;; => nil + +(take! ch #(println "Got" %)) +;; Got 43 +;; Just put 43 +;; => nil +You may be asking yourself why the put! operations return true. It signals that +the put operation could be performed, even though the value hasn’t yet been taken. +Channels can be closed, which will cause the put operations to not succeed: +(require '[cljs.core.async :refer [chan put! close!]]) + +(def ch (chan)) + +(close! ch) +;; => nil + +(put! ch 42) +;; => false +The above example was the simplest possible situation but what happens with pending +operations when a channel is closed? Let’s do a few takes and close the channel and +see what happens: +(require '[cljs.core.async :refer [chan put! take! close!]]) + +(def ch (chan)) + +(take! ch #(println "Got value:" %)) +;; => nil +(take! ch #(println "Got value:" %)) +;; => nil + +(close! ch) +;; Got value: nil +;; Got value: nil +;; => nil +We see that if the channel is closed all the take! operations receive a nil +value. nil in channels is a sentinel value that signals to takers that the channel +has been closed. Because of that, putting a nil value on a channel is not allowed: +(require '[cljs.core.async :refer [chan put!]]) + +(def ch (chan)) + +(put! ch nil) +;; Error: Assert failed: Can't put nil in on a channel +
+Buffers +We’ve seen that pending take and put operations are enqueued in a channel but, what +happens when there are many pending take or put operations? Let’s find out by +hammering a channel with many puts and takes: +(require '[cljs.core.async :refer [chan put! take!]]) + +(def ch (chan)) + +(dotimes [n 1025] + (put! ch n)) +;; Error: Assert failed: No more than 1024 pending puts are allowed on a single channel. + +(def ch (chan)) + +(dotimes [n 1025] + (take! ch #(println "Got" %))) +;; Error: Assert failed: No more than 1024 pending takes are allowed on a single channel. +As the example above shows there’s a limit of pending puts or takes on a channel, +it’s currently 1024 but that is an implementation detail that may change. Note that +there can’t be both pending puts and pending takes on a channel since puts will +immediately succeed if there are pending takes and viceversa. +Channels support buffering of put operations. If we create a channel with a buffer +the put operations will succeed immediately if there’s room in the buffer and be +enqueued otherwise. Let’s illustrate the point creating a channel with a buffer of +one element. The chan constructors accepts a number as its first argument which +will cause it to have a buffer with the given size: +(require '[cljs.core.async :refer [chan put! take!]]) + +(def ch (chan 1)) + +(put! ch 42 #(println "Put succeeded!")) +;; Put succeeded! +;; => true + +(dotimes [n 1024] + (put! ch n)) +;; => nil + +(put! ch 42) +;; Error: Assert failed: No more than 1024 pending puts are allowed on a single channel. +What happened in the example above? We created a channel with a buffer of size 1 and +performed a put operation on it that succeeded immediately because the value was +buffered. After that we did another 1024 puts to fill the pending put queue and, +when trying to put one value more the channel complained about not being able to +enqueue more puts. +Now that we know about how channels work and what are buffers used for let’s explore +the different buffers that core.async implements. Different buffers have different +policies and it’s interesting to know all of them to know when to use what. Channels +are unbuffered by default. +
+Fixed +The fixed size buffer is the one that is created when we give the chan constructor +a number and it will have the size specified by the given number. It is the simplest +possible buffer: when full, puts will be enqueued. +The chan constructor accepts either a number or a buffer as its first argument. +The two channels created in the following example both use a fixed buffer of size +32: +(require '[cljs.core.async :refer [chan buffer]]) + +(def a-ch (chan 32)) + +(def another-ch (chan (buffer 32))) +
+
+Dropping +The fixed buffer allows put operations to be enqueued. However, as we saw before, +puts are still queued when the fixed buffer is full. If we wan’t to discard the put +operations that happen when the buffer is full we can use a dropping buffer. +Dropping buffers have a fixed size and, when they are full puts will complete but +their value will be discarded. Let’s illustrate the point with an example: +(require '[cljs.core.async :refer [chan dropping-buffer put! take!]]) + +(def ch (chan (dropping-buffer 2))) + +(put! ch 40) +;; => true +(put! ch 41) +;; => true +(put! ch 42) +;; => true + +(take! ch #(println "Got" %)) +;; Got 40 +;; => nil +(take! ch #(println "Got" %)) +;; Got 41 +;; => nil +(take! ch #(println "Got" %)) +;; => nil +We performed three put operations and the three of them succeded but, since the +dropping buffer of the channel has size 2, only the first two values were delivered +to the takers. As you can observe the third take is enqueued since there is no value +available, the third put’s value (42) was discarded. +
+
+Sliding +The sliding buffer has the opposite policy than the dropping buffer. When full puts +will complete and the oldest value will be discarded in favor of the new one. The +sliding buffer is useful when we are interested in processing the last puts only and +we can afford discarding old values. +(require '[cljs.core.async :refer [chan sliding-buffer put! take!]]) + +(def ch (chan (sliding-buffer 2))) + +(put! ch 40) +;; => true +(put! ch 41) +;; => true +(put! ch 42) +;; => true + +(take! ch #(println "Got" %)) +;; Got 41 +;; => nil +(take! ch #(println "Got" %)) +;; Got 42 +;; => nil +(take! ch #(println "Got" %)) +;; => nil +We performed three put operations and the three of them succeded but, since the +sliding buffer of the channel has size 2, only the last two values were delivered to +the takers. As you can observe the third take is enqueued since there is no value +available since the first put’s value was discarded. +
+
+
+Transducers +As mentioned in the section about transducers, putting values in a channel can be +thought as a transducible process. This means that we can create channels and hand +them a transducer, giving us the ability to transform the input values before being +put in the channel. +If we want to use a transducer with a channel we must supply a buffer since the +reducing function that will be modified by the transducer will be the buffer’s add +function. A buffer’s add function is a reducing function since it takes a buffer and +an input and returns a buffer with such input incorporated. +(require '[cljs.core.async :refer [chan put! take!]]) + +(def ch (chan 1 (map inc))) + +(put! ch 41) +;; => true + +(take! ch #(println "Got" %)) +;; Got 42 +;; => nil +You may be wondering what happens to a channel when the reducing function returns a +reduced value. It turns out that the notion of termination for channels is being +closed, so channels will be closed when a reduced value is encountered: +(require '[cljs.core.async :refer [chan put! take!]]) + +(def ch (chan 1 (take 2))) + +(take! ch #(println "Got" %)) +;; => nil +(take! ch #(println "Got" %)) +;; => nil +(take! ch #(println "Got" %)) +;; => nil + +(put! ch 41) +;; => true +(put! ch 42) +;; Got 41 +;; => true +(put! ch 43) +;; Got 42 +;; Got nil +;; => false +We used the take stateful transducer to allow maximum 2 puts into the channel. We +then performed three take operations on the channel and we expect only two to +receive a value. As you can see in the above example the third take got the sentinel +nil value which indicates that the channel was closed. Also, the third put +operation returned false indicating that it didn’t take place. +
+
+Handling exceptions +If adding a value to a buffer throws an exception core.async the operation will +fail and the exception will be logged to the console. However, channel constructors +accept a third argument: a function for handling exceptions. +When creating a channel with an exception handler it will be called with the +exception whenever an exception occurs. If the handler returns nil the operation +will fail silently and if it returns another value the add operation will be retried +with such value. +(require '[cljs.core.async :refer [chan put! take!]]) + +(enable-console-print!) + +(defn exception-xform + [rfn] + (fn [acc input] + (throw (js/Error. "I fail!")))) + +(defn handle-exception + [ex] + (println "Exception message:" (.-message ex)) + 42) + +(def ch (chan 1 exception-xform handle-exception)) + +(put! ch 0) +;; Exception message: I fail! +;; => true + +(take! ch #(println "Got:" %)) +;; Got: 42 +;; => nil +
+
+Offer and Poll +We’ve learned about the two basic operations on channels so far: put! and take!. +They either take or put a value and are enqueued if they can’t be performed +immediately. Both functions are asynchronous because of their nature: they can +succeed but be completed at a later time. +core.async has two synchronous operations for putting or taking values: offer! +and poll!. Let’s see how they work through examples. +offer! puts a value in a channel if it’s possible to do so immediately. It returns +true if the channel received the value and false otherwise. Note that, unlike +with put!, offer! cannot distinguish between closed and open channels. +(require '[cljs.core.async :refer [chan offer!]]) + +(def ch (chan 1)) + +(offer! ch 42) +;; => true + +(offer! ch 43) +;; => false +poll! takes a value from a channel if it’s possible to do so immediately. Returns +the value if succesful and nil otherwise. Unlike take!, poll! cannot +distinguish closed and open channels. +(require '[cljs.core.async :refer [chan offer! poll!]]) + +(def ch (chan 1)) + +(poll! ch) +;; => nil + +(offer! ch 42) +;; => true + +(poll! ch) +;; => 42 +
+
+
+Processes +We learned all about channels but there is still a missing piece in the puzzle: +processes. Processes are pieces of logic that run independently and use channels +for communication and coordination. Puts and takes inside a process will stop the +process until the operation completes. Stopping a process doesn’t block the only +thread we have in the environments where ClojureScript runs. Instead, it will be +resumed at a later time when the operation is waiting for being performed. +Processes are launched using the go macro and puts and takes use the <! and >! +placeholders. The go macro rewrites your code to use callbacks but inside go +everything looks like synchronous code, which makes understanding it +straightforward: +(require '[cljs.core.async :refer [chan <! >!]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(enable-console-print!) + +(def ch (chan)) + +(go + (println [:a] "Gonna take from channel") + (println [:a] "Got" (<! ch))) + +(go + (println [:b] "Gonna put on channel") + (>! ch 42) + (println [:b] "Just put 42")) + +;; [:a] Gonna take from channel +;; [:b] Gonna put on channel +;; [:b] Just put 42 +;; [:a] Got 42 +In the above example we are launching a process with go that takes a value from +ch and prints it to the console. Since the value isn’t immediately available it +will park until it can resume. After that we launch another process that puts a +value on the channel. +Since there is a pending take the put operation succeeds and the value is delivered +to the first process, then both processes terminate. +Both go blocks run independently and, even though they are executed +asynchronously, they look like synchronous code. The above go blocks are fairly +simple but being able to write concurrent processes that coordinate via channels is +a very powerful tool for implementing complex asynchronous workflows. Channels also +offer a great decoupling of producers and consumers. +Processes can wait for an arbitrary amount of time too, there is a timeout +function that return a channel that will be closed after the given amount of +miliseconds. Combining a timeout channel with a take operation inside a go block +gives us the ability to sleep: +(require '[cljs.core.async :refer [<! timeout]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(enable-console-print!) + +(defn seconds + [] + (.getSeconds (js/Date.))) + +(println "Launching go block") + +(go + (println [:a] "Gonna take a nap" (seconds)) + (<! (timeout 1000)) + (println [:a] "I slept one second, bye!" (seconds))) + +(println "Block launched") + +;; Launching go block +;; Block launched +;; [:a] Gonna take a nap 9 +;; [:a] I slept one second, bye! 10 +As we can see in the messages printed, the process does nothing for one second when +it blocks in the take operation of the timeout channel. The program continues and +after one second the process resumes and terminates. +
+Choice +Apart from putting and taking one value at a time inside a go block we can also make +a non-deterministic choice on multiple channel operations using alts!. alts! is +given a series of channel put or take operations (note that we can also try to put +and take in a channel at the same time) and only performs one as soon as is ready; +if multiple operations can be performed when calling alts! it will do a pseudo +random choice by default. +We can easily try an operation on a channel and cancel it after a certain amount of +time combining the timeout function and alts!. Let’s see how: +(require '[cljs.core.async :refer [chan <! timeout alts!]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(enable-console-print!) + +(def ch (chan)) + +(go + (println [:a] "Gonna take a nap") + (<! (timeout 1000)) + (println [:a] "I slept one second, trying to put a value on channel") + (>! ch 42) + (println [:a] "I'm done!")) + +(go + (println [:b] "Gonna try taking from channel") + (let [cancel (timeout 300) + [value ch] (alts! [ch cancel])] + (if (= ch cancel) + (println [:b] "Too slow, take from channel cancelled") + (println [:b] "Got" value)))) + +;; [:a] Gonna take a nap +;; [:b] Gonna try taking from channel +;; [:b] Too slow, take from channel cancelled +;; [:a] I slept one second, trying to put a value on channel +In the example above we launched a go block that, after waiting for a second, puts a +value in the ch channel. The other go block creates a cancel channel, which will +be closed after 300 miliseconds. After that, it tries to read from both ch and +cancel at the same time using alts!, which will succeed whenever it can take a +value from either of those channels. Since cancel is closed after 300 miliseconds, +alts! will succeed since takes from closed channel return the nil sentinel. Note +that alts! returns a two-element vector with the returned value of the operation +and the channel where it was performed. +This is why we are able to detect whether the read operation was performed in the +cancel channel or in ch. I suggest you copy this example and set the first +process timeout to 100 miliseconds to see how the read operation on ch succeeds. +We’ve learned how to choose between read operations so let’s look at how to express +a conditional write operation in alts!. Since we need to provide the channel and a +value to try to put on it, we’ll use a two element vector with the channel and the +value for representing write operations. +Let’s see an example: +(require '[cljs.core.async :refer [chan <! alts!]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(enable-console-print!) + +(def a-ch (chan)) +(def another-ch (chan)) + +(go + (println [:a] "Take a value from `a-ch`") + (println [:a] "Got" (<! a-ch)) + (println [:a] "I'm done!")) + +(go + (println [:b] "Take a value from `another-ch`") + (println [:a] "Got" (<! another-ch)) + (println [:b] "I'm done!")) + +(go + (println [:c] "Gonna try putting in both channels simultaneously") + (let [[value ch] (alts! [[a-ch 42] + [another-ch 99]])] + (if (= ch a-ch) + (println [:c] "Put a value in `a-ch`") + (println [:c] "Put a value in `another-ch`")))) + +;; [:a] Take a value from `a-ch` +;; [:b] Take a value from `another-ch` +;; [:c] Gonna try putting in both channels simultaneously +;; [:c] Put a value in `a-ch` +;; [:a] Got 42 +;; [:a] I'm done! +When running the above example only the put operation on the a-ch channel has +succeeded. Since both channels are ready to take a value when the alts! occurs you +may get different results when running this code. +
+
+Priority +alts! default is to make a non-deterministic choice whenever several operations +are ready to be performed. We can instead give priority to the operations passing +the :priority option to alts!. Whenever :priority is true, if more than one +operation is ready they will be tried in order. +(require '[cljs.core.async :refer [chan >! alts!]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(enable-console-print!) + +(def a-ch (chan)) +(def another-ch (chan)) + +(go + (println [:a] "Put a value on `a-ch`") + (>! a-ch 42) + (println [:a] "I'm done!")) + +(go + (println [:b] "Put a value on `another-ch`") + (>! another-ch 99) + (println [:b] "I'm done!")) + +(go + (println [:c] "Gonna try taking from both channels with priority") + (let [[value ch] (alts! [a-ch another-ch] :priority true)] + (if (= ch a-ch) + (println [:c] "Got" value "from `a-ch`") + (println [:c] "Got" value "from `another-ch`")))) + +;; [:a] Put a value on `a-ch` +;; [:a] I'm done! +;; [:b] Put a value on `another-ch` +;; [:b] I'm done! +;; [:c] Gonna try taking from both channels with priority +;; [:c] Got 42 from `a-ch` +Since both a-ch and another-ch had a value to read when the alts! was executed +and we set the :priority option to true, a-ch has preference. You can try +deleting the :priority option and running the example multiple times to see that, +without priority, alts! makes a non-deterministic choice. +
+
+Defaults +Another interesting bit of alts! is that it can return immediately if no operation +is ready and we provide a default value. We can conditionally do a choice on the +operations if and only if any of them is ready, returning a default value if it’s +not. +(require '[cljs.core.async :refer [chan alts!]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(def a-ch (chan)) +(def another-ch (chan)) + +(go + (println [:a] "Gonna try taking from any of the channels without blocking") + (let [[value ch] (alts! [a-ch another-ch] :default :not-ready)] + (if (and (= value :not-ready) + (= ch :default)) + (println [:a] "No operation is ready, aborting") + (println [:a] "Got" value)))) + +;; [:a] Gonna try taking from any of the channels without blocking +;; [:a] No operation is ready, aborting +As you can see in the above example, if no operation is ready the value returned by +alts! is the one we supplied after the :default key when calling it and the +channel is the :default keyword itself. +
+
+
+Combinators +Now that we’re acquainted with channels and processes it’s time to explore some +interesting combinators for working with channels that are present in core.async. +This section includes a brief description of all of them together with a simple +example of their usage. +
+pipe +pipe takes an input and output channels and pipes all the values put on the input +channel to the output one. The output channel is closed whenever the source is +closed unless we provide a false third argument: +(require '[cljs.core.async :refer [chan pipe put! <! close!]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +(def in (chan)) +(def out (chan)) + +(pipe in out) + +(go-loop [value (<! out)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Got" value) + (println [:a] "Waiting for a value") + (recur (<! out))))) + +(put! in 0) +;; => true +(put! in 1) +;; => true +(close! in) + +;; [:a] Got 0 +;; [:a] Waiting for a value +;; [:a] Got 1 +;; [:a] Waiting for a value +;; [:a] I'm done! +In the above example we used the go-loop macro for reading values recursively +until the out channel is closed. Notice that when we close the in channel the +out channel is closed too, making the go-loop terminate. +
+
+pipeline-async +pipeline-async takes a number for controlling parallelism, an output channel, an +asynchronous function and an input channel. The asynchronous function has two +arguments: the value put in the input channel and a channel where it should put the +result of its asynchronous operation, closing the result channel after finishing. +The number controls the number of concurrent go blocks that will be used for calling +the asynchronous function with the inputs. +The output channel will receive outputs in an order relative to the input channel, +regardless the time each asynchronous function call takes to complete. It has an +optional last parameter that controls whether the output channel will be closed when +the input channel is closed, which defaults to true. +(require '[cljs.core.async :refer [chan pipeline-async put! <! close!]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +(def in (chan)) +(def out (chan)) +(def parallelism 3) + +(defn wait-and-put [value ch] + (let [wait (rand-int 1000)] + (js/setTimeout (fn [] + (println "Waiting" wait "miliseconds for value" value) + (put! ch wait) + (close! ch)) + wait))) + +(pipeline-async parallelism out wait-and-put in) + +(go-loop [value (<! out)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Got" value) + (println [:a] "Waiting for a value") + (recur (<! out))))) + +(put! in 1) +(put! in 2) +(put! in 3) +(close! in) + +;; Waiting 164 miliseconds for value 3 +;; Waiting 304 miliseconds for value 2 +;; Waiting 908 miliseconds for value 1 +;; [:a] Got 908 +;; [:a] Waiting for a value +;; [:a] Got 304 +;; [:a] Waiting for a value +;; [:a] Got 164 +;; [:a] Waiting for a value +;; [:a] I'm done! +
+
+pipeline +pipeline is similar to pipeline-async but instead of taking and asynchronous +function it takes a transducer instead. The transducer will be applied independently +to each input. +(require '[cljs.core.async :refer [chan pipeline put! <! close!]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +(def in (chan)) +(def out (chan)) +(def parallelism 3) + +(pipeline parallelism out (map inc) in) + +(go-loop [value (<! out)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Got" value) + (println [:a] "Waiting for a value") + (recur (<! out))))) + +(put! in 1) +(put! in 2) +(put! in 3) +(close! in) + +;; [:a] Got 2 +;; [:a] Waiting for a value +;; [:a] Got 3 +;; [:a] Waiting for a value +;; [:a] Got 4 +;; [:a] Waiting for a value +;; [:a] I'm done! +
+
+split +split takes a predicate and a channel and returns a vector with two channels, the +first of which will receive the values for which the predicate is true, the second +will receive those for which the predicate is false. We can optionally pass a buffer +or number for the channels with the third (true channel) and fourth (false channel) +arguments. +(require '[cljs.core.async :refer [chan split put! <! close!]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +(def in (chan)) +(def chans (split even? in)) +(def even-ch (first chans)) +(def odd-ch (second chans)) + +(go-loop [value (<! even-ch)] + (if (nil? value) + (println [:evens] "I'm done!") + (do + (println [:evens] "Got" value) + (println [:evens] "Waiting for a value") + (recur (<! even-ch))))) + +(go-loop [value (<! odd-ch)] + (if (nil? value) + (println [:odds] "I'm done!") + (do + (println [:odds] "Got" value) + (println [:odds] "Waiting for a value") + (recur (<! odd-ch))))) + +(put! in 0) +(put! in 1) +(put! in 2) +(put! in 3) +(close! in) + +;; [:evens] Got 0 +;; [:evens] Waiting for a value +;; [:odds] Got 1 +;; [:odds] Waiting for a value +;; [:odds] Got 3 +;; [:odds] Waiting for a value +;; [:evens] Got 2 +;; [:evens] Waiting for a value +;; [:evens] I'm done! +;; [:odds] I'm done! +
+
+reduce +reduce takes a reducing function, initial value and an input channel. It returns a +channel with the result of reducing over all the values put on the input channel +before closing it using the given initial value as the seed. +(require '[cljs.core.async :as async :refer [chan put! <! close!]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(def in (chan)) + +(go + (println "Result" (<! (async/reduce + (+) in)))) + +(put! in 0) +(put! in 1) +(put! in 2) +(put! in 3) +(close! in) + +;; Result: 6 +
+
+onto-chan +onto-chan takes a channel and a collection and puts the contents of the collection +into the channel. It closes the channel after finishing although it accepts a third +argument for specifying if it should close it or not. Let’s rewrite the reduce +example using onto-chan: +(require '[cljs.core.async :as async :refer [chan put! <! close! onto-chan]]) +(require-macros '[cljs.core.async.macros :refer [go]]) + +(def in (chan)) + +(go + (println "Result" (<! (async/reduce + (+) in)))) + +(onto-chan in [0 1 2 3]) + +;; Result: 6 +
+
+to-chan +to-chan takes a collection and returns a channel where it will put every value in +the collection, closing the channel afterwards. +(require '[cljs.core.async :refer [chan put! <! close! to-chan]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +(def ch (to-chan (range 3))) + +(go-loop [value (<! ch)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Got" value) + (println [:a] "Waiting for a value") + (recur (<! ch))))) + +;; [:a] Got 0 +;; [:a] Waiting for a value +;; [:a] Got 1 +;; [:a] Waiting for a value +;; [:a] Got 2 +;; [:a] Waiting for a value +;; [:a] I'm done! +
+
+merge +merge takes a collection of input channels and returns a channel where it will put +every value that is put on the input channels. The returned channel will be closed +when all the input channels have been closed. The returned channel will be +unbuffered by default but a number or buffer can be provided as the last argument. +(require '[cljs.core.async :refer [chan put! <! close! merge]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +(def in1 (chan)) +(def in2 (chan)) +(def in3 (chan)) + +(def out (merge [in1 in2 in3])) + +(go-loop [value (<! out)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Got" value) + (println [:a] "Waiting for a value") + (recur (<! out))))) + +(put! in1 1) +(close! in1) +(put! in2 2) +(close! in2) +(put! in3 3) +(close! in3) + +;; [:a] Got 3 +;; [:a] Waiting for a value +;; [:a] Got 2 +;; [:a] Waiting for a value +;; [:a] Got 1 +;; [:a] Waiting for a value +;; [:a] I'm done! +
+
+
+Higher-level abstractions +We’ve learned the about the low-level primitives of core.async and the combinators +that it offers for working with channels. core.async also offers some useful, +higher-level abstractions on top of channels that can serve as building blocks for +more advanced functionality. +
+Mult +Whenever we have a channel whose values have to be broadcasted to many others, we +can use mult for creating a multiple of the supplied channel. Once we have a mult, +we can attach channels to it using tap and dettach them using untap. Mults also +support removing all tapped channels at once with untap-all. +Every value put in the source channel of a mult is broadcasted to all the tapped +channels, and all of them must accept it before the next item is broadcasted. For +preventing slow takers from blocking the mult’s values we must use buffering on the +tapped channels judiciously. +Closed tapped channels are removed automatically from the mult. When putting a value +in the source channels when there are still no taps such value will be dropped. +(require '[cljs.core.async :refer [chan put! <! close! timeout mult tap]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +;; Source channel and mult +(def in (chan)) +(def m-in (mult in)) + +;; Sink channels +(def a-ch (chan)) +(def another-ch (chan)) + +;; Taker for `a-ch` +(go-loop [value (<! a-ch)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Got" value) + (recur (<! a-ch))))) + +;; Taker for `another-ch`, which sleeps for 3 seconds between takes +(go-loop [value (<! another-ch)] + (if (nil? value) + (println [:b] "I'm done!") + (do + (println [:b] "Got" value) + (println [:b] "Resting 3 seconds") + (<! (timeout 3000)) + (recur (<! another-ch))))) + +;; Tap the two channels to the mult +(tap m-in a-ch) +(tap m-in another-ch) + +;; See how the values are delivered to `a-ch` and `another-ch` +(put! in 1) +(put! in 2) + +;; [:a] Got 1 +;; [:b] Got 1 +;; [:b] Resting for 3 seconds +;; [:a] Got 2 +;; [:b] Got 2 +;; [:b] Resting for 3 seconds +
+
+Pub-sub +After learning about mults you could imagine how to implement a pub-sub abstraction +on top of mult, tap and untap but since it’s a widely used communication +mechanism core.async already implements this functionality. +Instead of creating a mult from a source channel, we create a publication with pub +giving it a channel and a function that will be used for extracting the topic of the +messages. +We can subscribe to a publication with sub, giving it the publication we want to +subscribe to, the topic we are interested in and a channel to put the messages that +have the given topic. Note that we can subscribe a channel to multiple topics. +unsub can be given a publication, topic and channel for unsubscribing such channel +from the topic. unsub-all can be given a publication and a topic to unsubscribe +every channel from the given topic. +(require '[cljs.core.async :refer [chan put! <! close! pub sub]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +;; Source channel and publication +(def in (chan)) +(def publication (pub in :action)) + +;; Sink channels +(def a-ch (chan)) +(def another-ch (chan)) + +;; Channel with `:increment` action +(sub publication :increment a-ch) + +(go-loop [value (<! a-ch)] + (if (nil? value) + (println [:a] "I'm done!") + (do + (println [:a] "Increment:" (inc (:value value))) + (recur (<! a-ch))))) + +;; Channel with `:double` action +(sub publication :double another-ch) + +(go-loop [value (<! another-ch)] + (if (nil? value) + (println [:b] "I'm done!") + (do + (println [:b] "Double:" (* 2 (:value value))) + (recur (<! another-ch))))) + +;; See how values are delivered to `a-ch` and `another-ch` depending on their action +(put! in {:action :increment :value 98}) +(put! in {:action :double :value 21}) + +;; [:a] Increment: 99 +;; [:b] Double: 42 +
+
+Mixer +As we learned in the section about core.async combinators, we can use the merge +function for combining multiple channels into one. When merging multiple channels, +every value put in the input channels will end up in the merged channel. However, we +may want more finer-grained control over which values put in the input channels end +up in the output channel, that’s where mixers come in handy. +core.async gives us the mixer abstraction, which we can use to combine multiple +input channnels into an output channel. The interesting part of the mixer is that we +can mute, pause and listen exclusively to certain input channels. +We can create a mixer given an output channel with mix. Once we have a mixer we +can add input channels into the mix using admix, remove it using unmix or remove +every input channel with unmix-all. +For controlling the state of the input channel we use the toggle function giving +it the mixer and a map from channels to their states. Note that we can add channels +to the mix using toggle, since the map will be merged with the current state of +the mix. The state of a channel is a map which can have the keys :mute, :pause +and :solo mapped to a boolean. +Let’s see what muting, pausing and soloing channels means: + + +A muted input channel means that, while still taking values from it, they won’t +be forwarded to the output channel. Thus, while a channel is muted, all the values +put in it will be discarded. + + +A paused input channel means that no values will be taken from it. This means +that values put in the channel won’t be forwarded to the output channel nor +discarded. + + +When soloing one or more channels the output channel will only receive the values +put in soloed channels. By default non-soloed channels are muted but we can use +solo-mode to decide between muting or pausing non-soloed channels. + + +That was a lot of information so let’s see an example to improve our understanding. +First of all, we’ll set up a mixer with an out channel and add three input +channels to the mix. After that, we’ll be printing all the values received on the +out channel to illustrate the control over input channels: +(require '[cljs.core.async :refer [chan put! <! close! mix admix + unmix toggle solo-mode]]) +(require-macros '[cljs.core.async.macros :refer [go-loop]]) + +;; Output channel and mixer +(def out (chan)) +(def mixer (mix out)) + +;; Input channels +(def in-1 (chan)) +(def in-2 (chan)) +(def in-3 (chan)) + +(admix mixer in-1) +(admix mixer in-2) +(admix mixer in-3) + +;; Let's listen to the `out` channel and print what we get from it +(go-loop [value (<! out)] + (if (nil? value) + (println [:a] "I'm done") + (do + (println [:a] "Got" value) + (recur (<! out))))) +By default, every value put in the input channels will be put in the out channel: +(do + (put! in-1 1) + (put! in-2 2) + (put! in-3 3)) + +;; [:a] Got 1 +;; [:a] Got 2 +;; [:a] Got 3 +Let’s pause the in-2 channel, put a value in every input channel and resume in-2: +(toggle mixer {in-2 {:pause true}}) +;; => true + +(do + (put! in-1 1) + (put! in-2 2) + (put! in-3 3)) + +;; [:a] Got 1 +;; [:a] Got 3 + +(toggle mixer {in-2 {:pause false}}) + +;; [:a] Got 2 +As you can see in the example above, the values put in the paused channels aren’t +discarded. For discarding values put in an input channel we have to mute it, let’s +see an example: +(toggle mixer {in-2 {:mute true}}) +;; => true + +(do + (put! in-1 1) + (put! in-2 2) ;; `out` will never get this value since it's discarded + (put! in-3 3)) + +;; [:a] Got 1 +;; [:a] Got 3 + +(toggle mixer {in-2 {:mute false}}) +We put a value 2 in the in-2 channel and, since the channel was muted at the +time, the value is discarded and never put into out. Let’s look at the third state +a channel can be inside a mixer: solo. +As we mentioned before, soloing channels of a mixer implies muting the rest of them +by default: +(toggle mixer {in-1 {:solo true} + in-2 {:solo true}}) +;; => true + +(do + (put! in-1 1) + (put! in-2 2) + (put! in-3 3)) ;; `out` will never get this value since it's discarded + +;; [:a] Got 1 +;; [:a] Got 2 + +(toggle mixer {in-1 {:solo false} + in-2 {:solo false}}) +However, we can set the mode the non-soloed channels will be in while there are +soloed channels. Let’s set the default non-solo mode to pause instead of the default +mute: +(solo-mode mixer :pause) +;; => true +(toggle mixer {in-1 {:solo true} + in-2 {:solo true}}) +;; => true + +(do + (put! in-1 1) + (put! in-2 2) + (put! in-3 3)) + +;; [:a] Got 1 +;; [:a] Got 2 + +(toggle mixer {in-1 {:solo false} + in-2 {:solo false}}) + +;; [:a] Got 3 +
+
+
+ + +Acknowledgments +Special thanks to: + + +J David Eisenberg: For the huge amount of time spend in fixing all kind of errors and +writing entire sections of the book, as well as making very valuable suggestions. + + +And here is an inevitably incomplete list of MUCH-APPRECIATED CONTRIBUTORS — people who have submitted corrections, new ideas and generally made the +ClojureScript Unraveled book much better: + + +Anler Hernández Peral (@anler) + + +Diego Sevilla Ruiz (@dsevilla) + + +Eduardo Ferro Aldama (@eferro) + + +Tyler Anderson (@Tyler-Anderson) + + +Chris Ulrich (@chrisulrich) + + +Jean Hadrien Chabran (@jhchabran) + + +Tienson Qin (@tiensonqin) + + +FungusHumungus (@FungusHumungus), + + +Chris Charles (@ccharles) + + +Jearvon Dharrie (@iamjarvo) + + +Shaun LeBron (@shaunlebron) + + +Wodin (@wodin) + + +Crocket (@crocket) + + + + +Further Reading +Here is a list of more resources about ClojureScript. + + +ClojureScript wiki: a community-mantained wiki about ClojureScript. + + +API Reference: a community-maintained complete language api reference. + + +ClojureScript Cheatsheet: a comprehensive reference of the ClojureScript language. + + +Études for ClojureScript: a collection of exercises for learning ClojureScript. + + +ClojureScript made easy: a collection of short articles about solving common problems in ClojureScript. + + +The Google Closure Library API reference + + + + \ No newline at end of file diff --git a/index.html b/index.html index 91cb06a..f724a46 100644 --- a/index.html +++ b/index.html @@ -4,22 +4,98 @@ - + -ClojureScript Unraveled (2nd edition) +ClojureScript Unraveled (3nd edition) + @@ -512,6 +580,9 @@

3.2.2. Keywords

;; => :foo +
+

In the end, keywords are a special case of Symbols which will be explained later.

+
Namespaced keywords
@@ -548,6 +619,11 @@
Namespa ;; => :cljs.unraveled/foo
+
+

Just as keywords are usually used to define keys on a map, namespaced +keywords allow defining attributes dedicated to a specific domain +without colliding with other keywords that may have the same name.

+
@@ -570,8 +646,25 @@

3.2.3. Symbols

-

Don’t worry if you don’t understand right away; symbols are used in almost all of -our examples, which will give you the opportunity to learn more as we go on.

+

The symbols themselves are not usually used as data but are used by +the language to resolve function calls. In other words, let’s use this +example:

+
+
+
+
(println hello-world)
+
+
+
+

In this case, the println symbol is telling the compiler to look in +its resolution table to see if it has a bound implementation of a +function that prints data to standard output.

+
+
+

And by wrapping the symbol in parentheses, you are telling the +compiler that what you want is to execute that function. All elements +other than the println symbol, which is in the first place, are +considered parameters.

@@ -619,7 +712,39 @@

3.2.5. Characters

-

3.2.6. Collections

+

3.2.6. Booleans

+
+

The same for booleans:

+
+
+
+
true
+false
+
+
+
+

The really interesting part of the booleans is the concepts of logical +booleans. Is a concept in which we assign a boolean meaning to an expression +(if it is falsy or truthy even if it is not of boolean type).

+
+
+

This is the aspect where each language has its own semantics (mostly wrongly in +my opinion). The majority of languages consider empty collections, the integer +0, and other things like this to be false. In ClojureScript, unlike in other +languages, only two values are considered as logical false: nil and +false. Everything else is treated as logical true.

+
+
+
+
(boolean nil)     ;; => false
+(boolean 0)       ;; => true
+(boolean [])      ;; => true
+(boolean :false)  ;; => true
+
+
+
+
+

3.2.7. Collections

Another big step in explaining a language is to explain its collections and collection abstractions. ClojureScript is not an exception to this rule.

@@ -650,12 +775,13 @@
Lists
-

As you can see, all list examples are prefixed with the ' char. This is because -lists in Lisp-like languages are often used to express things like function or macro -calls. In that case, the first item should be a symbol that will evaluate to -something callable, and the rest of the list elements will be function -arguments. However, in the preceding examples, we don’t want the first item as a -symbol; we just want a list of items.

+

As you can see, all list examples are prefixed with the ' char. This is +because lists in Lisp-like languages are often used to express things like +function or macro calls (just as we have seen before). In that case, the first +item should be a symbol that will evaluate to something callable, and the rest +of the list elements will be function arguments. However, in the preceding +examples, we don’t want the first item as a symbol; we just want a list of +items.

The following example shows the difference between a list without and with the @@ -842,7 +968,8 @@

3.4.1. The

In the example above, inc is a function and is part of the ClojureScript -runtime, and 1 is the first argument for the inc function.

+runtime (standard library), and 1 is the first argument for the inc +function.

@@ -994,9 +1121,98 @@

3.4.4. Va

The way to denote a variadic function is using the & symbol prefix on its arguments vector.

+
+

The variadic function can also be combined with multiple arities:

+
+
+
+
(defn max
+  ([a] a)
+  ([a b] (special-max a b))
+  ([a b c] (special-max a b c))
+  ([a b c d] (special-max a b c d))
+  ([a b c d e] (special-max a b c d e))
+  ([a b c d e f] (special-max a b c d e f))
+  ([a b c d e f & other]
+   (reduce max (special-max a b c d e f) other)))
+
+
+
+

You may wonder why I really need this syntax and define all that arities. Well, +sometimes it is for documentation, since it prefers to name the first required +parameters and leave the rest in a sequence. It is also a performance issue, +since calling an arity with fixed variables will always be faster than calling a +variadic function.

+
+
+ + + + + +
+
Note
+		 +special-max is an invented function, just for make an example. +
+
+
+

In the function parameters you can apply +destructuring, which is explained in detail later.

+
+
+
+

3.4.5. Named Parameters

+
+

Parameters by name in ClojureScript is nothing more than a special case of +destructuring. See the destructuring section to better +understand all the concepts.

+
+
+

There are times when we want to pass optional parameters to a function, +something like options and it is better to give those options a name to be +concise:

+
+
+
+
(defn my-prefix
+  [value & {:keys [default] :or {default "foo-"}}]
+  (str default value))
+
+
+
+

When you call this function, you just can omit the options, and the default will +be used:

+
+
+
+
(my-prefix "hello")
+;; => "foo-hello"
+
+
+
+

Then, provide a different prefix using named parameters:

+
+
+
+
(my-prefix "hello" :default "bar-")
+;; => "bar-hello"
+
+
+
+

The good part is that the name parameters do not impose a fixed calling +convention. Nothing really prevents you from calling that function with a map as +a second parameter with all the options you want to pass.

+
+
+
+
(my-prefix "hello" {:default "bar-"})
+;; => "bar-hello"
+
+
-

3.4.5. Short syntax for anonymous functions

+

3.4.6. Short syntax for anonymous functions

ClojureScript provides a shorter syntax for defining anonymous functions using the #() reader macro (usually leads to one-liners). Reader macros are "special" @@ -1043,13 +1259,18 @@

;; => #{1 2}

+
+

This way of defining functions is generally useful for defining single line +functions.

+

3.5. Flow control

-

ClojureScript has a very different approach to flow control than languages like -JavaScript, C, etc.

+

ClojureScript has a very different approach to flow control than languages +like JavaScript, C, etc. In an expression based language as it is CLJS, flow +control structures also returns values.

3.5.1. Branching with if

@@ -1058,7 +1279,7 @@

3.5.1. Bran and not a statement, and it has three parameters: the first one is the condition expression, the second one is an expression that will be evaluated if the condition expression evaluates to logical true, and the third expression will be evaluated -otherwise.

+otherwise. The else part is optional.

@@ -1107,6 +1328,11 @@

3.5.2.

+

The :else keyword has no special meaning in cond. It just a truthy value +and in reallity can be any keyword os anything that evaluates to a logical +true.

+
+

Also, cond has another form, called condp, that works very similarly to the simple cond but looks cleaner when the condition (also called a predicate) is the same for all conditions:

@@ -1164,45 +1390,38 @@

3.5.3.

-

3.6. Truthiness

+

3.6. Locals, Blocks, and Loops

+
+

3.6.1. Blocks

-

This is the aspect where each language has its own semantics (mostly wrongly). The -majority of languages consider empty collections, the integer 0, and other things -like this to be false. In ClojureScript, unlike in other languages, only two -values are considered as false: nil and false. Everything else is treated as -logical true.

+

In JavaScript, braces { and } delimit a block of code that “belongs +together”. Blocks in ClojureScript are created using the do expression and are +usually used for side effects, like printing something to the console or writing a +log in a logger.

-

Jointly with the ability to implement the callable protocol (the IFn, explained -more in detail later), data structures like sets can be used just as predicates, -without need of additional wrapping them in a function:

-
-
-
-
(def valid? #{1 2 3})
-
-(filter valid? (range 1 10))
-;; => (1 2 3)
-
+

A side effect is something that is not necessary for the return value.

-

This works because a set returns either the value itself for all contained elements -or nil:

+

The do expression accepts as its parameter an arbitrary number of other +expressions, but it returns the return value only from the last one:

-
(valid? 1)
-;; => 1
+
(do
+  (println "hello world")
+  (println "hola mundo")
+  (* 3 5) ;; this value will not be returned; it is thrown away
+  (+ 1 2))
 
-(valid? 4)
-;; => nil

+;; hello world
+;; hola mundo
+;; => 3
-
-

3.7. Locals, Blocks, and Loops

-

3.7.1. Locals

+

3.6.2. Locals

ClojureScript does not have the concept of variables as in ALGOL-like languages, but it does have locals. Locals, as per usual, are immutable, and if you try to @@ -1226,48 +1445,18 @@

3.7.1. Locals

-

In the preceding example, the symbol x is bound to the value (inc 1), which -comes out to 2, and the symbol y is bound to the sum of x and 1, which comes out -to 3. Given those bindings, the expressions (println "Simple message from the body -of a let") and (* x y) are evaluated.

-
-
-
-

3.7.2. Blocks

-
-

In JavaScript, braces { and } delimit a block of code that “belongs -together”. Blocks in ClojureScript are created using the do expression and are -usually used for side effects, like printing something to the console or writing a -log in a logger.

-
-
-

A side effect is something that is not necessary for the return value.

-
-
-

The do expression accepts as its parameter an arbitrary number of other -expressions, but it returns the return value only from the last one:

-
-
-
-
(do
-  (println "hello world")
-  (println "hola mundo")
-  (* 3 5) ;; this value will not be returned; it is thrown away
-  (+ 1 2))
-
-;; hello world
-;; hola mundo
-;; => 3
-
+

In the preceding example, the symbol x is bound to the value of executing the +(inc 1) expression, which comes out to 2, and the symbol y is bound to the +sum of x and 1, which comes out to 3. Given those bindings, the expressions +(println "Simple message from the body of a let") and (* x y) are evaluated.

-

The body of the let expression, explained in the previous section, is very similar -to the do expression in that it allows multiple expressions. In fact, the let -has an implicit do.

+

The body of the let expression has an implicit do, so you can put there +multiple expressions, where the last one will be used as return value.

-

3.7.3. Loops

+

3.6.3. Loops

The functional approach of ClojureScript means that it does not have standard, well-known, statement-based loops such as for in JavaScript. The loops in @@ -1634,9 +1823,9 @@

-

3.8. Collection types

+

3.7. Collection types

-

3.8.1. Immutable and persistent

+

3.7.1. Immutable and persistent

We mentioned before that ClojureScript collections are persistent and immutable, but we didn’t explain what that meant.

@@ -1708,7 +1897,7 @@

-

3.8.2. The sequence abstraction

+

3.7.2. The sequence abstraction

One of the central ClojureScript abstractions is the sequence which can be thought of as a list and can be derived from any of the collection types. It is @@ -1748,7 +1937,7 @@

see the section on truthiness later in this chapter).

+(see the section on booleans and truthiness).

@@ -1957,6 +2146,12 @@
+

It must be taken into account that there are data types such as lists or lazy +lists that do not have a defined size, in this case when calling count on +them, it will linearly traverse the list to know how many elements it has and +this can have an impact on the performance.

+
+

We can also get an empty variant of a given collection with the empty function:

@@ -2057,10 +2252,16 @@
Laziness
;; => (0 1 2 3 4 5 6)
+
+

When we have used map and filter in the previous examples, the result when +printed on the screen is evaluated to see the return value, but if we save the +content without printing it, no operation will be executed until we request the +first element of the sequence.

+
-

3.8.3. Collections in depth

+

3.7.3. Collections in depth

Now that we’re acquainted with ClojureScript’s sequence abstraction and some of the generic sequence manipulating functions, it’s time to dive into the concrete @@ -2567,7 +2768,7 @@

Queues
-

3.9. Destructuring

+

3.8. Destructuring

Destructuring, as its name suggests, is a way of taking apart structured data such as collections and focusing on individual parts of them. ClojureScript offers a @@ -2799,7 +3000,7 @@

3.9

-

3.10. Threading Macros

+

3.9. Threading Macros

Threading macros, also known as arrow functions, enables one to write more readable code when multiple nested function calls are performed.

@@ -2820,7 +3021,7 @@

3.10. Threadi ommited: (f (g (h x))) is the same as (-> x h g f).

-

3.10.1. -> (thread-first macro)

+

3.9.1. -> (thread-first macro)

This is called thread first because it threads the first argument throught the different expressions as first arguments.

@@ -2852,12 +3053,12 @@

3.10.1. <

This threading macro is especially useful for transforming data structures, because ClojureScript (and Clojure) functions for data structures -transformations consistently uses the first argument for receive the data +transformations consistently uses the first argument to receive the data structure.

-

3.10.2. ->> (thread-last macro)

+

3.9.2. ->> (thread-last macro)

The main difference between the thread-last and thread-first macros is that instead of threading the first argument given as the first argument on the following expresions, @@ -2893,7 +3094,7 @@

3.10.2.

-

3.10.3. as-> (thread-as macro)

+

3.9.3. as-> (thread-as macro)

Finally, there are cases where neither -> nor ->> are applicable. In these cases, you’ll need to use as->, the more flexible alternative, that allows @@ -2920,7 +3121,7 @@

3.10.3. <

-

3.10.4. some->, some->> (thread-some macros)

+

3.9.4. some->, some->> (thread-some macros)

Two of the more specialized threading macros that ClojureScript comes with. They work in the same way as their analagous -> and ->> macros with the additional @@ -2946,9 +3147,9 @@

-

3.10.5. cond->, cond->> (thread-cond macros)

+

3.9.5. cond->, cond->> (thread-cond macros)

-

The cond-> and cond->> macros are analgous to -> and ->> that offers +

The cond-> and cond->> macros are analogous to -> and ->> that offers the ability to conditionally skip some steps from the pipeline. Let see an example:

@@ -2974,7 +3175,7 @@

-

3.10.6. Additional Readings

+

3.9.6. Additional Readings

-

3.11. Reader Conditionals

-
-

This language feature allows different dialects of Clojure to share common code that -is mostly platform independent but need some platform dependent code.

-
-
-

To use reader conditionals, all you need is to rename your source file with -.cljs extension to one with .cljc, because reader conditionals only work if -they are placed in files with .cljc extension.

-
+

3.10. Namespaces

-

3.11.1. Standard (#?)

+

3.10.1. Defining a namespace

-

There are two types of reader conditionals, standard and splicing. The standard -reader conditional behaves similarly to a traditional cond and the syntax looks -like this:

+

The namespace is ClojureScript’s fundamental unit of code modularity. Namespaces +are analogous to Java packages or Ruby and Python modules and can be defined with +the ns macro. If you have ever looked at a little bit of ClojureScript source, you +may have noticed something like this at the beginning of the file:

-
(defn parse-int
-  [v]
-  #?(:clj  (Integer/parseInt v)
-     :cljs (js/parseInt v)))
+
(ns myapp.core
+  "Some docstring for the namespace.")
+
+(def x "hello")
-

As you can observe, #? reading macro looks very similar to cond, the difference is -that the condition is just a keyword that identifies the platform, where :cljs is -for ClojureScript and :clj is for Clojure. The advantage of this approach, is -that it is evaluated at compile time so no runtime performance overhead exists for -using this.

-
+

Namespaces are dynamic, meaning you can create one at any time. However, the +convention is to have one namespace per file. Naturally, a namespace definition is +usually at the beginning of the file, followed by an optional docstring.

-
-

3.11.2. Splicing (#?@)

-

The splicing reader conditional works in the same way as the standard and allows -splice lists into the containing form. The #?@ reader macro is used for that -and the code looks like this:

-
-
-
-
(defn make-list
-  []
-  (list #?@(:clj  [5 6 7 8]
-            :cljs [1 2 3 4])))
-
-;; On ClojureScript
-(make-list)
-;; => (1 2 3 4)
-
-
-
-

The ClojureScript compiler will read that code as this:

-
-
-
-
(defn make-list
-  []
-  (list 1 2 3 4))
-
-
-
-

The splicing reader conditional can’t be used to splice multiple top level forms, -so the following code is ilegal:

-
-
-
-
#?@(:cljs [(defn func-a [] :a)
-           (defn func-b [] :b)])
-;; => #error "Reader conditional splicing not allowed at the top level."
-
-
-
-

If you need so, you can use multiple forms or just use do block for group -multiple forms together:

-
-
-
-
#?(:cljs (defn func-a [] :a))
-#?(:cljs (defn func-b [] :b))
-
-;; Or
-
-#?(:cljs
-   (do
-     (defn func-a [] :a)
-     (defn func-b [] :b)))
-
-
-
-
-

3.11.3. More readings

-
- -
-
-
-
-

3.12. Namespaces

-
-

3.12.1. Defining a namespace

-
-

The namespace is ClojureScript’s fundamental unit of code modularity. Namespaces -are analogous to Java packages or Ruby and Python modules and can be defined with -the ns macro. If you have ever looked at a little bit of ClojureScript source, you -may have noticed something like this at the beginning of the file:

-
-
-
-
(ns myapp.core
-  "Some docstring for the namespace.")
-
-(def x "hello")
-
-
-
-

Namespaces are dynamic, meaning you can create one at any time. However, the -convention is to have one namespace per file. Naturally, a namespace definition is -usually at the beginning of the file, followed by an optional docstring.

-
-
-

Previously we have explained vars and symbols. Every var that you define will be -associated with its namespace. If you do not define a concrete namespace, then the -default one called "cljs.user" will be used:

+

Previously we have explained vars and symbols. Every var that you define will be +associated with its namespace. If you do not define a concrete namespace, then the +default one called "cljs.user" will be used:

@@ -3133,7 +3224,7 @@

3.12.

-

3.12.2. Loading other namespaces

+

3.10.2. Loading other namespaces

Defining a namespace and the vars in it is really easy, but it’s not very useful if we can’t use symbols from other namespaces. For this purpose, the ns macro offers @@ -3153,8 +3244,8 @@

-

As you can observe, we are using fully qualified names (namespace + var name) for -access to vars and functions from different namespaces.

+

As you can observe, we are using fully qualified names (namespace + var name) to +access vars and functions from different namespaces.

While this will let you access other namespaces, it’s also repetitive and overly @@ -3203,7 +3294,7 @@

Additionally, ClojureScript offers a simple way to refer to specific vars or functions from a concrete namespace using the :refer directive, followed by a -sequence of symbols that will refer to vars in the namespace. Effectively, it is as +sequence of symbols that will refer to vars in the namespace. Effectively, it’s as if those vars and functions are now part of your namespace, and you do not need to qualify them at all.

@@ -3243,7 +3334,7 @@

-

3.12.3. Namespaces and File Names

+

3.10.3. Namespaces and File Names

When you have a namespace like myapp.core, the code must be in a file named core.cljs inside the myapp directory. So, the preceding examples with @@ -3262,7 +3353,7 @@

-

3.13. Abstractions and Polymorphism

+

3.11. Abstractions and Polymorphism

I’m sure that at more than one time you have found yourself in this situation: you have defined a great abstraction (using interfaces or something similar) for your @@ -3276,7 +3367,7 @@

-

We can not trust languages that allow you to silently overwrite methods that you are +

You can’t trust languages that allow you to silently overwrite methods that you’re using when you import third party libraries; you cannot expect consistent behavior when this happens.

@@ -3285,7 +3376,7 @@

http://en.wikipedia.org/wiki/Expression_problem for more details

-

3.13.1. Protocols

+

3.11.1. Protocols

The ClojureScript primitive for defining "interfaces" is called a protocol. A protocol consists of a name and set of functions. All the functions have at least @@ -3317,7 +3408,7 @@

3.13.1. Protocols

the "I" prefix is commonly used to designate the separation of protocols and types. In the Clojure community, there are many different opinions about how the "I" prefix should be used. In our opinion, it is an acceptable solution to avoid name -clashing and possible confusion. But not using the prefix is not considered bad +clashing and possible confusion. But omitting the prefix is not considered bad practice. @@ -3325,12 +3416,12 @@

3.13.1. Protocols

From the user perspective, protocol functions are simply plain functions defined in -the namespace where the protocol is defined. This enables an easy and simple aproach -for avoid conflicts between different protocols implemented for the same type that +the namespace where the protocol is defined. This enables an easy and simple approach +for avoiding conflicts between different protocols implemented for the same type that have conflicting function names.

-

Here is an example. Let’s create a protocol called IInvertible for data that can +

Here’s an example. Let’s create a protocol called IInvertible for data that can be "inverted". It will have a single method named invert.

@@ -3343,12 +3434,12 @@

3.13.1. Protocols

Extending existing types
-

One of the big strengths of protocols is the ability to extend existing and maybe +

One of the big strengths of protocols is the ability to extend existing, and possibly, third party types. This operation can be done in different ways.

-

The majority of time you will tend to use the extend-protocol or the extend-type -macros. This is how extend-type syntax looks:

+

Most of the time you will tend to use the extend-protocol or the extend-type +macros to do this. This is how extend-type syntax looks:

@@ -3390,13 +3481,13 @@
-

You may note that a special symbol string is used instead of js/String for -extend the protol for string. This is because the builtin javascript types have +

You may note that a special symbol string is used instead of js/String to +extend the protocol for string. This is because the built-in javascript types have special treatment and if you replace the string with js/String the compiler will emit a warning about that.

-

So if you want extend your protocol to javascript primitive types, instead of using +

So, if you want to extend your protocol to javascript primitive types, instead of using js/Number, js/String, js/Object, js/Array, js/Boolean and js/Function you should use the respective special symbols: number, string, object, array, boolean and function.

@@ -3537,7 +3628,7 @@
-

3.13.2. Multimethods

+

3.11.2. Multimethods

We have previously talked about protocols which solve a very common use case of polymorphism: dispatch by type. But in some circumstances, the protocol approach can @@ -3609,7 +3700,7 @@

3.13.2. Multimethods<

-

3.13.3. Hierarchies

+

3.11.3. Hierarchies

Hierarchies are ClojureScript’s way to let you build whatever relations that your domain may require. Hierarchies are defined in term of relations between named @@ -3720,7 +3811,7 @@

Hierarchies in multimethods

One of the big advantages of hierarchies is that they work very well together with -multimethods. This is because multimethods by default use the isa? function for +multimethods. This is because multimethods by default use the isa? function for the last step of dispatching.

@@ -3797,7 +3888,7 @@
-

3.14. Data types

+

3.12. Data types

Until now, we have used maps, sets, lists, and vectors to represent our data. And in most cases, this is a really great approach. But sometimes we need to define our own @@ -3823,7 +3914,7 @@

3.14. Data types

-

3.14.1. Deftype

+

3.12.1. Deftype

The most low-level construction in ClojureScript for creating your own types is the deftype macro. As a demonstration, we will define a type called User:

@@ -3873,7 +3964,7 @@

3.14.1. Deftype

-

3.14.2. Defrecord

+

3.12.2. Defrecord

The record is a slightly higher-level abstraction for defining types in ClojureScript and should be the preferred way to do it.

@@ -3940,7 +4031,7 @@

3.14.2. Defrecord

As we can see, the assoc function works as expected and returns a new instance of -the same type but with new key value pair. But take care with dissoc! Its behavior +the same type but with new key-value pair. But take care with dissoc! Its behavior with records is slightly different than with maps; it will return a new record if the field being dissociated is an optional field, but it will return a plain map if you dissociate a mandatory field.

@@ -3975,7 +4066,7 @@

3.14.2. Defrecord

-

3.14.3. Implementing protocols

+

3.12.3. Implementing protocols

Both type definition primitives that we have seen so far allow inline implementations for protocols (explained in a previous section). Let’s define one @@ -4008,7 +4099,7 @@

3

-

3.14.4. Reify

+

3.12.4. Reify

The reify macro is an ad hoc constructor you can use to create objects without pre-defining a type. Protocol implementations are supplied the same as deftype @@ -4034,7 +4125,7 @@

3.14.4. Reify

-

3.14.5. Specify

+

3.12.5. Specify

specify! is an advanced alternative to reify, allowing you to add protocol implementations to an existing JavaScript object. This can be useful if you want to @@ -4076,14 +4167,14 @@

3.14.5. Specify

-

3.15. Host interoperability

+

3.13. Host interoperability

ClojureScript, in the same way as its brother Clojure, is designed to be a "guest" language. This means that the design of the language works well on top of an existing ecosystem such as JavaScript for ClojureScript and the JVM for Clojure.

-

3.15.1. The types

+

3.13.1. The types

ClojureScript, unlike what you might expect, tries to take advantage of every type that the platform provides. This is a (perhaps incomplete) list of things that @@ -4121,7 +4212,7 @@

3.15.1. The types

-

3.15.2. Interacting with platform types

+

3.13.2. Interacting with platform types

ClojureScript comes with a little set of special forms that allows it to interact with platform types such as calling object methods, creating new instances, and @@ -4130,7 +4221,7 @@

Access to the platform
-

ClojureScript has a special syntax for access to the entire platform environment +

ClojureScript has a special syntax to access the entire platform environment through the js/ special namespace. This is an example of an expression to execute JavaScript’s built-in parseInt function:

@@ -4301,7 +4392,7 @@

Conversions

The inconvenience of the previously explained forms is that they do not make recursive transformations, so if you have nested objects, the nested objects will -not be converted. Consider this example that uses Clojurescript maps, then a +not be converted. Consider this example that uses Clojurescript maps, then a similar one with JavaScript objects:

@@ -4315,7 +4406,7 @@
Conversions
;; => #js {:country {:code "FR", :name "France"} (.-country js-obj) ;; => {:code "FR", :name "France"} -(.-code (.-country js-obj) +(.-code (.-country js-obj)) ;; => nil
@@ -4328,7 +4419,7 @@
Conversions
(clj->js {:foo {:bar "baz"}})
 ;; => #js {:foo #js {:bar "baz"}}
-(js->clj #js {:country {:code "FR" :name "France"}}))
+(js->clj #js {:country {:code "FR" :name "France"}})
 ;; => {"country" {:code "FR", :name "France"}}
@@ -4342,6 +4433,13 @@
Conversions
;; => #js ["France" "Korea" "Peru"]
+
+

Keep in mind that clj→js is not the canonical way to transform data from +clojurescript to js, that function is for debugging, because it is not exactly +the most efficient way to do this operation. It is recommended that you build +the transformation data structures specific to your domain rather than using the +generic clj→js.

+
Arrays
@@ -4411,7 +4509,7 @@
Arrays
-

3.16. State management

+

3.14. State management

We’ve learned that one of ClojureScript’s fundamental ideas is immutability. Both scalar values and collections are immutable in ClojureScript, except those mutable @@ -4423,7 +4521,7 @@

3.16. State m structures in place?

-

3.16.1. Vars

+

3.14.1. Vars

Vars can be redefined at will inside a namespace but there is no way to know when they change. The inability to redefine vars from other namespaces is a bit limiting; @@ -4432,7 +4530,7 @@

3.16.1. Vars

-

3.16.2. Atoms

+

3.14.2. Atoms

ClojureScript gives us the Atom type, which is an object containing a value that can be altered at will. Besides altering its value, it also supports observation @@ -4511,7 +4609,7 @@

Observation
-

3.16.3. Volatiles

+

3.14.3. Volatiles

Volatiles, like atoms, are objects containing a value that can be altered. However, they don’t provide the observation and validation capabilities that atoms @@ -4561,23 +4659,23 @@

4. Tooling &a

4.1. Getting Started with the Compiler

-

At this point, you are surely very bored with the constant theoretical explanations -about the language itself and will want to write and execute some code. The goal of -this section is to provide a little practical introduction to the ClojureScript -compiler.

+

At this point, you are surely very bored with the constant theoretical +explanations about the language itself and will want to write and +execute some code. The goal of this section is to provide a little +practical introduction to the ClojureScript compiler.

-

The ClojureScript compiler takes the source code that has been split over numerous -directories and namespaces and compiles it down to JavaScript. Today, JavaScript has -a great number of different environments where it can be executed - each with its own +

The ClojureScript compiler takes the source code that has been split +over numerous directories and namespaces and compiles it down to +JavaScript. Today, JavaScript has a great number of different +environments where it can be executed - each with its own peculiarities.

-

This chapter intends to explain how to use ClojureScript without any additional -tooling. This will help you understand how the compiler works and how you can use it -when other tooling is not available (such as leiningen
-cljsbuild or -boot).

+

For this case we are going to use shadow-cljs as a frontend for the +compiler. It is possible to use the compiler directly or use other +frontends, but in this case we will focus on just one, which in my +opinion best resolves usability.

4.1.1. Execution environments

@@ -4595,108 +4693,84 @@

4

-

4.1.2. Download the compiler

+

4.1.2. Setup for NodeJS

-

The fastest way to obtain all the tooling needed for ClojureScript compilaition is -installing the Clojure CLI Tools:

-
-
-
-
curl -O https://download.clojure.org/install/linux-install-1.10.1.462.sh
-chmod +x linux-install-1.10.1.462.sh
-sudo ./linux-install-1.10.1.462.sh
-
+

This chapter supposes you have a properly installed nodejs (v20.10.0) +and JVM (JDK21). Other versions probably work but all this is tested +under specified versions.

-

If you are using other operating system other than linux, refer to -https://clojure.org/guides/getting_started page.

-
-
-

Although the ClojureScript is self hosted, in this book we will use -the JVM implementation, with in turn requires JDK8 or JDK11 -installed. You can obtain it using your distribution default package -manager or download it from -Oracle -or Azul

+

It also will be nice to have the rlwrap tool, which can be installed +this way on a debian like linux distributions:

-
Example installing it using a apt in a debian-like distribution
-
sudo apt-get install openjdk-8-jdk rlwrap
-
-
+
sudo apt-get install rlwrap
-
-

4.1.3. Compile for Node.js

-
-

Let’s start with a practical example compiling code that will target Node.js -(hereafter simply "nodejs"). For this example, you should have nodejs installed.

-
-
-

There are different ways to install nodejs, but the recommended way is using nvm -("Node.js Version Manager"). You can read the instructions on how to install and use -nvm on its home page.

-

When you have installed nvm, follow installing the latest version of nodejs:

+

So, lets create our directory stucture and the first package.json file:

-
nvm install v10.16.0
-nvm alias default v10.16.0
+
mkdir -p mynodeapp/src/mynodeapp
+touch mynodeapp/package.json
+touch mynodeapp/shadow-cljs.edn
+touch mynodeapp/src/mynodeapp/main.cljs
-

You can test if nodejs is installed in your system with this command:

+

Then, lets define our package.json content:

-
$ node --version
-v10.16.0
+
{
+  "name": "mynodeapp",
+  "version": "1.0.0",
+  "description": "",
+  "scripts": {
+    "server": "shadow-cljs server",
+    "watch": "shadow-cljs watch app",
+    "compile": "shadow-cljs compile app"
+  },
+  "author": "",
+  "license": "MPL-2.0",
+  "devDependencies": {
+    "shadow-cljs": "^2.26.2"
+  }
+}
-
-
Create the example application
-
-

For the first step of our practical example, we will create our application directory -structure and populate it with example code.

-
-

Start by creating the directory tree structure for our “hello world” application:

-
-
-
-
mkdir -p myapp/src/myapp
-touch myapp/src/myapp/core.cljs
-
+

And execute the npm install for correctly install shadow-cljs dependency

-

Resulting in this directory tree:

+

Then, setup the basic shadow-cljs.edn confguration:

-
myapp
-└── src
-    └── myapp
-        └── core.cljs
+
{:dependencies
+ []
+
+ :source-paths
+ ["src"]
+
+ :builds
+ {:app {:target :node-script
+        :output-to "target/app.js"
+        :main mynodeapp.main/main}}}
-

Second, write the example code into the previously created -myapp/src/myapp/core.cljs file:

+

And finally, put the following content on the mynodeapp/main.cljs file:

-
(ns myapp.core
-  (:require [cljs.nodejs :as nodejs]))
+
(ns mynodeapp.main)
 
-(nodejs/enable-util-print!)
-
-(defn -main
+(defn main
   [& args]
-  (println "Hello world!"))
-
-(set! *main-cli-fn* -main)

+  (println "Hello world!"))
@@ -4706,199 +4780,147 @@
Note
-It is very important that the declared namespace in the file exactly matches -the directory structure. This is the way ClojureScript structures its source code. +It is very important that the declared namespace in the file exactly matches the +directory structure. This is the way ClojureScript structures its source code.
-

And finally, lets create the myapp/deps.edn declaring the clojure -and clojurescript versions:

-
-
-
-
{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"}
-        org.clojure/clojure {:mvn/version "1.10.1"}}
- :paths ["src"]}
-
-
-
-
-
Compile the example application
-
-

In order to compile that source code, we need a simple build script that tells the -ClojureScript compiler the source directory and the output file. ClojureScript -has a lot of other options, but at this moment we can ignore that.

-
-
-

Let’s create the myapp/build.clj file with the following content:

+

Now it’s time to compile the project:

-
(require '[cljs.build.api :as b])
+
$ npm run compile
 
-(b/build "src" {:main 'myapp.core
-                :output-to "main.js"
-                :output-dir "out"
-                :target :nodejs
-                :verbose true})

-
-
-
-

This is a brief explanation of the compiler options used in this example:

-
-
-
    -
  • -

    The :output-to parameter indicates to the compiler the destination of the compiled -code, in this case to the "main.js" file.

    -
    • -
  • -

    The :main property indicates to the compiler the namespace that will act as the entry -point of your application when it’s executed.

    -
    • -
  • -

    The :target property indicates the platform where you want to execute the compiled -code. In this case, we are going to use nodejs. If you omit this -parameter, the source will be compiled to run in the browser environment.

    -
    • -
-
-
-

To run the compilation, just execute the following command:

-
-
-
-
cd myapp
-clojure build.clj
+> mynodeapp@1.0.0 compile +> shadow-cljs compile app + +shadow-cljs - config: /home/user/playground/mynodeapp/shadow-cljs.edn +[:app] Compiling ... +[:app] Build completed. (45 files, 1 compiled, 0 warnings, 1.65s)
-

And when it finishes, execute the compiled file using node:

+

And when it finishes, execute the result using node binary:

-
$ node main.js
+
$ node target/main.js
 Hello world!
+
+

The shadow-cljs guide is very extensive, and you can read more detailed documentation +here: https://shadow-cljs.github.io/docs/UsersGuide.html#target-node

-

4.1.4. Compile for the Browser

+

4.1.3. Setup for Browser

In this section we are going to create an application similar to the "hello world" example from the previous section to run in the browser environment. The minimal requirement for this application is just a browser that can execute JavaScript.

-

The process is almost the same, and the directory structure is the same. The only -things that changes is the entry point of the application and the build script. So, -start re-creating the directory tree from previous example in a different directory.

+

The process is almost the same, and the directory structure is very similar, with few +additions.

-
mkdir -p mywebapp/src/mywebapp
-touch mywebapp/src/mywebapp/core.cljs
+
mkdir -p mywebapp/public
+mkdir -p mywebapp/src/mywebapp
+touch mywebapp/public/index.html
+touch mywebapp/src/mywebapp/main.cljs
+touch mywebapp/package.json
+touch mywebapp/shadow-cljs.edn
-

Resulting in this directory tree:

+

Set setup the package.json file:

-
mywebapp
-└── src
-    └── mywebapp
-        └── core.cljs
+
{
+  "name": "mywebapp",
+  "version": "1.0.0",
+  "description": "",
+  "scripts": {
+    "server": "shadow-cljs server",
+    "watch": "shadow-cljs watch app",
+    "compile": "shadow-cljs compile app"
+  },
+  "author": "",
+  "license": "MPL-2.0",
+  "devDependencies": {
+    "shadow-cljs": "^2.26.2"
+  }
+}
+
+
+

Execute the npm install for correctly install the shadow-cljs dependency.

-

Then, write new content to the mywebapp/src/mywebapp/core.cljs file:

+

Then, setup shadow-cljs configuration on shadow-cljs.edn file:

-
(ns mywebapp.core)
+
{:dev-http {8888 "public"}
 
-(enable-console-print!)
+ :dependencies
+ []
 
-(println "Hello world!")

-
+ :source-paths + ["src"] + + :builds + {:app {:target :browser + :output-dir "public/js" + :asset-path "/js" + :modules {:main {:entries [mywebapp.main] + :init-fn mywebapp.main/main}}}}}
-
-

In the browser environment we do not need a specific entry point for the application, -so the entry point is the entire namespace.

-
-
Compile the example application
-

In order to compile the source code to run properly in a browser, overwrite the -mywebapp/build.clj file with the following content:

+

Write new content to the src/mywebapp/main.cljs file:

-
(require '[cljs.build.api :as b])
+
(ns mywebapp.core)
 
-(b/build "src" {:output-to "main.js"
-                :source-map true
-                :output-dir "out/"
-                :main 'mywebapp.core
-                :verbose true
-                :optimizations :none})

-
-
-
-

This is a brief explanation of the compiler options we’re using:

+(defn main + [] + (println "Hello world!"))
-
-
    -
  • -

    The :output-to parameter indicates to the compiler the destination of the -compiled code, in this case the "main.js" file.

    -
    • -
  • -

    The :main property indicates to the compiler the namespace that will act as -the entry point of your application when it’s executed.

    -
    • -
  • -

    :source-map indicates the destination of the source map. (The source map -connects the ClojureScript source to the generated JavaScript so that error -messages can point you back to the original source.)

    -
    • -
  • -

    :output-dir indicates the destination directory for all file sources used in a -compilation. It is just for making source maps work properly with the rest of the -code, not only your source.

    -
    • -
  • -

    :optimizations indicates the compilation optimization. There are different -values for this option, but that will be covered in subsequent sections in -more detail.

    -
    • -
-

To run the compilation, just execute the following command:

+

Once all this is ready, instead of just compiling it, we start a watch process:

-
cd mywebapp;
-clojure build.clj
-
+
$ npm run watch
+
+> mywebapp@1.0.0 watch
+> shadow-cljs watch app
+
+shadow-cljs - config: /home/user/playground/mywebapp/shadow-cljs.edn
+shadow-cljs - HTTP server available at http://localhost:8888
+shadow-cljs - server version: 2.26.2 running at http://localhost:9630
+shadow-cljs - nREPL server started on port 44159
+shadow-cljs - watching build :app
+[:app] Configuring build.
+[:app] Compiling ...
+[:app] Build completed. (119 files, 0 compiled, 0 warnings, 2.58s)
-
-

This process can take some time, so do not worry; wait a little bit. The JVM -bootstrap with the Clojure compiler is slightly slow. In the following sections, we -will explain how to start a watch process to avoid constantly starting and stopping -this slow process.

-

While waiting for the compilation, let’s create a dummy HTML file to make it easy to -execute our example app in the browser. Create the index.html file with the -following content; it goes in the main mywebapp directory.

+

The watch also starts a development http server at http://localhost:8888 for access our +brand new web application. But we still need a last step: we need to create an index.html +where we’re going to load our recently compiled js.

+
On the file public/index.html
<!DOCTYPE html>
 <html>
@@ -4907,526 +4929,162 @@ 
<title>Hello World from ClojureScript</title>
   </header>
   <body>
-    <script src="main.js"></script>
+    <script src="js/main.js"></script>
   </body>
 </html>
-

Now, when the compilation finishes and you have the basic HTML file you can just open -it with your favorite browser and take a look in the development tools console. The -"Hello world!" message should appear there.

+

So, open the browser on http://localhost:8888 and open the devconsole with F12 key and +see the Hello World printed on the console tab.

+
+

The shadow-cljs guide is very extensive, and you can read more detailed documentation +here: https://shadow-cljs.github.io/docs/UsersGuide.html#target-browser

-

4.1.5. Watch process

+

4.1.4. Working with the REPL

-

You may have already noticed the slow startup time of the ClojureScript -compiler. To solve this, the ClojureScript standalone compiler comes with a -tool to watch for changes in your source code, and re-compile modified files as -soon as they are written to disk.

-
-
-

Let’s start converting our build.clj script to something that can accept -arguments and execute different tasks. Let’s create a tools.clj script file -with the following content:

+

Although you can create a source file and compile it every time you want to try +something out in ClojureScript, it’s easier to use the REPL. REPL stands for:

-
-
-
(require '[cljs.build.api :as b])
-
-(defmulti task first)
-
-(defmethod task :default
-  [args]
-  (let [all-tasks  (-> task methods (dissoc :default) keys sort)
-        interposed (->> all-tasks (interpose ", ") (apply str))]
-    (println "Unknown or missing task. Choose one of:" interposed)
-    (System/exit 1)))
-
-(def build-opts
-  {:output-to "main.js"
-   :source-map true
-   :output-dir "out/"
-   :main 'mywebapp.core
-   :verbose true
-   :optimizations :none})
-
-(defmethod task "build"
-  [args]
-  (b/build "src" build-opts))
-
-(defmethod task "watch"
-  [args]
-  (b/watch"src" build-opts))
-
-(task *command-line-args*)
+
+
    +
  • +

    Read - get input from the keyboard

    +
    • +
  • +

    Evaluate the input

    +
    • +
  • +

    Print the result

    +
    • +
  • +

    Loop back for more input

    +
    • +
+
+

In other words, the REPL lets you try out ClojureScript concepts and get immediate +feedback.

-

Now you can start the watch process with the following command:

+

ClojureScript comes with support for executing the REPL in different execution +environments, each of which has its own advantages and disadvantages. For example, you can +run a REPL in nodejs but in that environment you don’t have any access to the DOM. Which +REPL environment is best for you depends on your specific needs and requirements.

+
+
Node REPL
-
clojure tools.clj watch
+
$ shadow-cljs node-repl
-

Go back to the mywebapp.core namespace, and change the print text to "Hello World, -Again!". You’ll see that the file src/mywebapp/core.cljs the file is immediately -recompiled, and if you reload index.html in your browser the new text is displayed -in the developer console.

+

This starts a blank CLJS REPL with an already connected node process.

+
+
+ + + + + +
+
Important
+		 +If you exit the Node REPL the node process is also killed! +
-

You also can start the simple build with:

+

The node-repl lets you get started without any additional configuration. It has access +to all your code via the usual means, ie. (require '[your.core :as x]). Since it is not +connected to any build it does not do any automatic rebuilding of code when your files +change and does not provide hot-reload.

+
+
+
Browser REPL
-
clojure tools.clj build
+
$ shadow-cljs browser-repl
-

And finally, if you execute the build.clj script with no params, a help message -with available "tasks" will be printed:

+

This starts a blank CLJS REPL and will open an associated Browser window where the code +will execute. Besides running in the Browser this has all the same functionality as the +above node-repl.

-
-
-
$ clojure tools.clj
-Unknown or missing task. Choose one of: build, watch
+
+ + + + + +
+
Important
+		 +If you close the Browser window the REPL will stop working. +
-

4.1.6. Optimization levels

+

4.1.5. Build-specific REPL

-

The ClojureScript compiler has different levels of optimization. Behind the scenes, -those compilation levels are coming from the Google Closure Compiler.

+

The node-repl and browser-repl work without any specific build configuration. That +means they will only do whatever you tell them to do but nothing on their own.

-

A simplified overview of the compilation process is:

+

But there is also an option to connect to a build specific repl, for which to work +correctly you need 2 things:

-
-
    -
  1. -

    The reader reads the code and does some analysis. This compiler may raise some -warnings during this phase.

    -
    2. +
    +
    • -

      Then, the ClojureScript compiler emits JavaScript code. The result is one -JavaScript output file for each ClojureScript input file.

      +

      a running watch for your build

    • -

      The generated JavaScript files are passed through the Google Closure Compiler -which, depending on the optimization level and other options (sourcemaps, output -dir output to, …​), generates the final output file(s).

      +

      connect the JS runtime of the :target. Meaning if you are using the :browser target you +need to open a Browser that has the generated JS loaded. For node.js builds that means +running the node process.

      • -
-
-
-

The final output format depends on the optimization level chosen:

+
-
-
none
-

This optimization level causes the generated JavaScript to be written into separate -output files for each namespace, without any additional transformations to the code.

+

Once you have both you can connect to the CLJS REPL via the command line or from the Clojure REPL.

+
+
+
# One terminal
+$ npx shadow-cljs watch app
+...
+
+# different terminal
+$ npx shadow-cljs cljs-repl app
+shadow-cljs - connected to server
+[3:1]~cljs.user=>
+REPL
-
-
whitespace
-
-

This optimization level causes the generated JavaScript files to be concatenated into -a single output file, in dependency order. Line breaks and other whitespace are -removed.

-
-

This reduces compilation speed somewhat, resulting in a slower compilations. However, -it is not terribly slow and it is quite usable for small-to-medium sized -applications.

+
+ + + + + +
+
Tip
+		 +type :repl/quit to exit the REPL. This will only exit the REPL, the watch will remain running. +TIP: You may run multiple watch "workers" in parallel and connect/disconnect to their REPLs at any given time. +
-
-
simple
-
-

The simple compilation level builds on the work from the whitespace optimization -level, and additionally performs optimizations within expressions and functions, such -as renaming local variables and function parameters to have shorter names.

-
-

Compilation with the :simple optimization always preserves the functionality of -syntactically valid JavaScript, so it does not interfere with the interaction between -the compiled ClojureScript and other JavaScript.

-
-
-
-
advanced
-
-

The advanced compilation level builds on the simple optimization level, and -additionally performs more aggressive optimizations and dead code elimination. This -results in a significantly smaller output file.

-
-
-

The :advanced optimizations only work for a strict subset of JavaScript which -follows the Google Closure Compiler rules. ClojureScript generates valid -JavaScript within this strict subset, but if you are interacting with third party -JavaScript code, some additional work is required to make everything work as -expected.

-
-
-

This interaction with third party javascript libraries will be explained in later -sections.

-
-
-
-
-
-

4.2. Working with the REPL

-
-

4.2.1. Introduction

-
-

Although you can create a source file and compile it every time you want to try -something out in ClojureScript, it’s easier to use the REPL. REPL stands for:

-
-
-
    -
  • -

    Read - get input from the keyboard

    -
    • -
  • -

    Evaluate the input

    -
    • -
  • -

    Print the result

    -
    • -
  • -

    Loop back for more input

    -
    • -
-
-
-

In other words, the REPL lets you try out ClojureScript concepts and get immediate -feedback.

-
-
-

ClojureScript comes with support for executing the REPL in different execution -environments, each of which has its own advantages and disadvantages. For example, -you can run a REPL in nodejs but in that environment you don’t have any access to the -DOM. Which REPL environment is best for you depends on your specific needs and -requirements.

-
-
-
-

4.2.2. Nashorn REPL

-
-

The Nashorn REPL is the easiest and perhaps most painless REPL environment because it -does not require any special stuff.

-
-
-

Let’s start creating a new script file for our repl playground called -tools.clj in a new directory (in our case repl_playground/tools.clj):

-
-
-
-
(require '[cljs.repl :as repl])
-(require '[cljs.repl.nashorn :as nashorn])
-
-(defmulti task first)
-
-(defmethod task :default
-  [args]
-  (let [all-tasks  (-> task methods (dissoc :default) keys sort)
-        interposed (->> all-tasks (interpose ", ") (apply str))]
-    (println "Unknown or missing task. Choose one of:" interposed)
-    (System/exit 1)))
-
-(defmethod task "repl:nashorn"
-  [args]
-  (repl/repl (nashorn/repl-env)
-             :output-dir "out/nashorn"
-             :cache-analysis true))
-
-(task *command-line-args*)
-
-
-
-

Create the repl_playground/deps.edn file with the following content (identical -from previous examples):

-
-
-
-
{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"}
-        org.clojure/clojure {:mvn/version "1.10.1"}}
- :paths ["src"]}
-
-
-
-

And now, we can execute the REPL:

-
-
-
-
$ clj tools.clj repl:nashorn
-ClojureScript 1.10.520
-cljs.user=> (prn "Hello world")
-"Hello world"
-nil
-
-
-
-

You may have noticed that in this example we have used clj command instead of -clojure. That two commands are practically identical, the main difference is -that clj executes clojure command wrapped in rlwrap. The rlwrap tool -gives the "readline" capabilities which enables history, code navigation, and -other shell-like features that will make your REPL experience much more -pleasant.

-
-
-

If you don’t have installed it previously, you can install it with sudo apt -install -y rlwrap.

-
-
- - - - - -
-
Note
-		 -This is a basic repl, in the following chapters we will explain how to -have a more advanced repl experience with code-highlighting, code-completion and -multiline edition. -
-
-
-
-

4.2.3. Node.js REPL

-
-

You must, of course, have nodejs installed on your system to use this REPL.

-
-
-

You may be wondering why we might want a nodejs REPL, when we already have the -nashorn REPL available which doesn’t have any external dependencies. The answer is -very simple: nodejs is the most used JavaScript execution environment on the backend, -and it has a great number of community packages built around it.

-
-
-

The good news is that starting a nodejs REPL is very easy once you have it installed -in your system. Start adding the following content into tools.clj script:

-
-
-
-
(require '[cljs.repl.node :as node])
-
-(defmethod task "node:repl"
-  [args]
-  (repl/repl (node/repl-env)
-             :output-dir "out/nodejs"
-             :cache-analysis true))
-
-
-
-

And start the REPL:

-
-
-
-
$ clj tools.clj repl:node
-ClojureScript 1.10.520
-cljs.user=> (prn "Hello world")
-"Hello world"
-nil
-
-
-
-
-

4.2.4. Browser REPL

-
-

This REPL is the most laborious to get up and running. This is because it uses a -browser for its execution environment and it has additional requirements.

-
-
-

Let’s start by adding the following content to the tools.clj script file:

-
-
-
-
(require '[cljs.build.api :as b])
-(require '[cljs.repl.browser :as browser])
-
-(defmethod task "repl:browser"
-  [args]
-  (println "Building...")
-  (b/build "src"
-           {:output-to "out/browser/main.js"
-            :output-dir "out/browser"
-            :source-map true
-            :main 'myapp.core
-            :optimizations :none})
-
-  (println "Launching REPL...")
-  (repl/repl (browser/repl-env :port 9001)
-             :output-dir "out/browser"))
-
-
-
-

The main difference with the previous examples, is that browser REPL requires -that some code be execution in the browser before the REPL gets working. To do -that, just re-create the application structure very similar to the one that we -have used in previous sections:

-
-
-
-
mkdir -p src/myapp
-touch src/myapp/core.cljs
-
-
-
-

Then, write new content to the src/myapp/core.cljs file:

-
-
-
-
(ns myapp.core
- (:require [clojure.browser.repl :as repl]))
-
-(defonce conn
-  (repl/connect "http://localhost:9001/repl"))
-
-(enable-console-print!)
-
-(println "Hello, world!")
-
-
-
-

And finally, create the missing index.html file that is going to be used as -the entry point for running the browser side code of the REPL:

-
-
-
-
<!DOCTYPE html>
-<html>
-  <header>
-    <meta charset="utf-8" />
-    <title>Hello World from ClojureScript</title>
-  </header>
-  <body>
-    <script src="out/browser/main.js"></script>
-  </body>
-</html>
-
-
-
-

Well, that was a lot of setup! But trust us, it’s all worth it when you see it in -action. To do that, just execute the tools.clj in the same way that we have done -it in previous examples:

-
-
-
-
$ clj tools.clj repl:browser
-Building...
-Launching REPL...
-ClojureScript 1.10.520
-cljs.user=>
-
-
-
-

And finally, open your favourite browser and go to http://localhost:9001/. Once the -page is loaded (the page will be blank), switch back to the console where you have -run the REPL and you will see that it is up and running:

-
-
-
-
[...]
-To quit, type: :cljs/quit
-cljs.user=> (+ 14 28)
-42
-
-
-
-

One of the big advantages of the browser REPL is that you have access to everything -in the browser environment. For example, type (js/alert "hello world") in the -REPL. This will cause the browser to display an alert box. Nice!

-
-
- - - - - -
-
Note
-		 -This is just a preview of how to use the builtin REPL capabilities of the -ClojureScript compiler. There are better and more user/developer friendly repl -environments with code-highlighting, code-completion and multiline edition (and -in case of web development, also with code hot reloading) that will be explained -in the following chapters. -
-
-
-
-

4.2.5. Rebel Readline (REPL library)

-
-

This is a library that adds more advanced features to the Clojure(Script) -builtin REPL and enables code-highlighting, code-completion and multiline -edition.

-
-
-

Let’s start adding rebel dependency into deps.edn file:

-
-
-
-
{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"}
-        org.clojure/clojure {:mvn/version "1.10.1"}
-        com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}
-        com.bhauman/rebel-readline {:mvn/version "0.1.4"}}
- :paths ["src"]}
-
-
-
-

And adding the followin code to the tools.clj script file:

-
-
-
-
(require '[rebel-readline.core]
-         '[rebel-readline.clojure.main]
-         '[rebel-readline.clojure.line-reader]
-         '[rebel-readline.cljs.service.local]
-         '[rebel-readline.cljs.repl])
-
-(defmethod task "repl:rebel:node"
-  [args]
-  (rebel-readline.core/with-line-reader
-    (rebel-readline.clojure.line-reader/create
-     (rebel-readline.cljs.service.local/create))
-    (repl/repl (node/repl-env)
-               :prompt (fn [])
-               :read (rebel-readline.cljs.repl/create-repl-read)
-               :output-dir "out/nodejs"
-               :cache-analysis true)))
-
-
-
-

And start the REPL:

-
-
-
-
$ clojure tools.clj repl:rebel:node
-ClojureScript 1.10.520
-cljs.user=> (println
-cljs.core/println: ([& objs])
-
-
-
-

You can find that while you writing in the repl, it automatically suggest and -shows se function signature that you want to execute.

-
-
-

You can find more information about all rebel-readline capabilities on -https://github.com/bhauman/rebel-readline

-
-
-
-
-

4.3. The Closure Library

+
+

4.2. The Closure Library

The Google Closure Library is a javascript library developed by Google. It has a modular architecture, and provides cross-browser functions for DOM manipulations and @@ -5475,142 +5133,12 @@

4.3. Th

You can found the reference to all namespaces in the closure library here: http://google.github.io/closure-library/api/

-
-
-

4.4. Dependency management

-
-

Until now, we have used the builtin Clojure(Script) toolchain to compile our -source files to JavaScript. Now this is a time to understand how manage external -and/or third party dependencies.

-
-
-

4.4.1. First project

-
-

The best way to show how a tool works is by creating a toy project with it. In -this case, we will create a small application that determines if a year is a -leap year or not.

-
-
-

Let’s start creating the project layout:

-
-
-
-
mkdir -p leapyears/src/leapyears
-mkdir -p leapyears/target/public
-touch leapyears/target/public/index.html
-touch leapyears/src/leapyears/core.cljs
-touch leapyears/tools.cljs
-touch leapyears/deps.edn
-
-
-
-

The project has the following structure:

-
-
-
-
leapyears
-├── deps.edn
-├── src
-│   └── leapyears
-│       └── core.cljs
-├── target
-│   └── public
-│       └── index.html
-└── tools.clj
-
-
-
-

The deps.edn file contains information about all the packaged dependencies -needed to build or execute the application. Packaged dependencies are libraries -packaged as jar files and uploaded to clojars/maven repository.

-
-
- - - - - -
-
Note
-		 -
-

But ClojureScript can consume external code in many different ways:

-
-
-
    -
  • -

    google closure library module

    -
    • -
  • -

    global export module

    -
    • -
  • -

    es6/commonjs module (experimental)

    -
    • -
-
-
-

This will be explained in the following sections.

-
-
-
-
-

Let’s start with a simple deps.edn file:

-
-
-
-
{:deps {org.clojure/clojurescript {:mvn/version "1.10.520"}
-        org.clojure/clojure {:mvn/version "1.10.1"}
-        com.bhauman/rebel-readline-cljs {:mvn/version "0.1.4"}
-        com.bhauman/rebel-readline {:mvn/version "0.1.4"}}
- :paths ["src" "target"]}
-
-
-

And simple build script (tools.clj file):

-
-
-
-
(require '[cljs.build.api :as b])
-(require '[cljs.repl :as repl])
-(require '[cljs.repl.node :as node])
-
-(defmulti task first)
-
-(defmethod task :default
-  [args]
-  (let [all-tasks  (-> task methods (dissoc :default) keys sort)
-        interposed (->> all-tasks (interpose ", ") (apply str))]
-    (println "Unknown or missing task. Choose one of:" interposed)
-    (System/exit 1)))
-
-(def build-opts
-  {:output-to "target/public/js/leapyears.js"
-   :source-map true
-   :output-dir "target/public/js/leapyears"
-   :main 'leapyears.core
-   :verbose true
-   :optimizations :none})
-
-(defmethod task "repl"
-  [args]
-  (repl/repl (node/repl-env)
-             :output-dir "target/nodejs"
-             :cache-analysis true))
-
-(defmethod task "build"
-  [args]
-  (b/build "src" build-opts))
-
-(defmethod task "watch"
-  [args]
-  (b/watch "src" build-opts))
-
-(task *command-line-args*)
-
+

To properly understand how we can use the "batteries included" of google closure library, +lets add some functionality to our mywebapp example application.

-

Then, write the following content into target/public/index.html file:

+

Lets update our public/index.html with the following content:

@@ -5632,26 +5160,21 @@

4.4.1. First projec </form> </section> - <script src="./js/leapyears.js" type="text/javascript"></script> + <script src="/js/main.js"></script> </body> </html>

-

The next step consist in add some code to make the form interactive. Put the -following code into the src/leapyears/core.cljs:

+

And then, update the src/mywebapp/main.cljs file with:

-
(ns leapyears.core
-  (:require [goog.dom :as dom]
-            [goog.events :as events]
-            [cljs.reader :refer (read-string)]))
-
-(enable-console-print!)
-
-(def input (dom/getElement "year"))
-(def result (dom/getElement "result"))
+
(ns mywebapp.main
+  (:require
+   [goog.dom :as dom]
+   [goog.events :as events]
+   [cljs.reader :refer [read-string]]))
 
 (defn leap?
   [year]
@@ -5662,47 +5185,85 @@ 
4.4.1. First projec
 (defn on-change
   [event]
   (let [target (.-target event)
+        result (dom/getElement "result")
         value (read-string (.-value target))]
     (if (leap? value)
       (set! (.-innerHTML result) "YES")
       (set! (.-innerHTML result) "NO"))))
 
-(events/listen input "keyup" on-change)

+(defn main
+  []
+  (let [input (dom/getElement "year")]
+    (events/listen input "keyup" on-change)))
-

Now, we can compile the project with:

+

Now, we can compile the project in the same way as previously

-
clojure tools.clj watch
+
npm run watch
+
+
+
+

Finally, open the http://locahost:8888 in a browser. Typing a year in the textbox should +display an indication of its leap year status.

+
+
+

4.3. Dependency management

+
+

Until now, we have used the builtin Clojure(Script) toolchain to compile our source +files to JavaScript. Now this is a time to understand how manage external and/or third +party dependencies. Lets use our mywebapp to add some functionality with help of an +external dependencies.

-

Finally, open the target/public/index.html file in a browser. Typing a year in the textbox -should display an indication of its leap year status.

+

With shadow-cljs we have the following approaches to add dependencies:

+
+
    +
  • +

    Adding a native/cljs dependency

    +
    • +
  • +

    Adding a npm dependency

    +
    • +
  • +

    Adding a global dependency

    +
    • +
-

4.4.2. Adding native dependencies

+

4.3.1. Adding native dependencies

+
+

In this example we will use the Cuerdas (a string +manipulation library build especifically for Clojure(Script)) for improve the previous +functionality of the mywebapp.

+
-

Until now we have used only the batteries included in the ClojureScript runtime, -let improve our project including a native dependency. In this example we will -use the Cuerdas (a string manipulation -library build especifically for Clojure(Script)).

+

Let’s update our shadow-cljs.edn file with the dependency:

+
+
+
+
{:dependencies
+ [[funcool/cuerdas "2022.06.16-403"]]
+
+ ;; [...]
+ }
+
-

Add funcool/cuerdas {:mvn/version "2.2.0"} into the :deps section inside the -deps.edn file. And add the corresponding modifications to the -leapyears/core.cljs file:

+

And the following modifications to the src/mywebapp/main.cljs file:

-
(ns leapyears.core
-  (:require [goog.dom :as dom]
-            [goog.events :as events]
-            [cuerdas.core :as str]
-            [cljs.reader :refer (read-string)]))
+
(ns mywebapp.main
+  (:require
+    [goog.dom :as dom]
+    [goog.events :as events]
+    [cuerdas.core :as str]
+    [cljs.reader :refer [read-string]]))
 
 ;; [...]
 
@@ -5722,320 +5283,212 @@ 

-
Clojure packages are often published on Clojars. You can
-also find many third party libraries on the
-ClojureScript Wiki.

-
-
-
-

4.4.3. External dependencies

-
-

In some circumstances you may found yourself that you need some library but that -does not exists in ClojureScript but it is already implemented in javascript -and you want to use it on your project.

-
-
-

There are many ways that you can do it mainly depending on the library that you -want to include. Many of that libraries are packaged and uploaded to clojars, so -you can declare them in the deps.edn in the same way as native dependencies -(with some peculirities in usage, see below).

-
-

4.4.4. Closure compatible module

-
-

If you have a library that is written to be compatible with google closure -module system and you want to include it on your project: put the source into -the classpath (inside src or vendor directory in leapyears project) and -access it like any other clojure namespace.

-
+

4.3.2. NPM Dependencies

-

This is the most simplest case, because google closure modules are directly -compatible and you can mix your clojure code with javascript code written using -google closure module system without any additional steps.

+

On the other hand, not all dependencies are available as native packages. But one of the +advantages of ClojureScript is that it embraces being able to integrate with the host +language, in this case JS. For this case, shadow-cljs integrates quite well with the NPM +ecosystem.

-

Reusing the leapyears project, lets implement the leap? function in -a javascript using google closure module format. Start creating the -directory structure:

+

Lets add the date-fns NPM dependency:

-
touch src/leapyears/util.js
+
$ npm add date-fns
-

And add the implementation using closure module format:

+

And then, lets modify our code to use that library:

-
src/leapyears/util.js
-
goog.provide("leapyears.util");
-
-goog.scope(function() {
-  var module = leapyears.util;
-
-  module.isLeap = function(val) {
-    return (0 === (val % 400)) || (((val % 100) > 0) && (0 === (val % 4)));
-  };
-});
-
-
-
-

Now, if you open the repl, you can import the namespace and use the isLeap -function

-
-
-
-
(require '[leapyears.util :as util])
-
-(util/isLeap 2112)
-;; => true
+
(ns mywebapp.main
+  (:require
+   ["date-fns" :as df]
+   [goog.dom :as dom]
+   [cuerdas.core :as str]
+   [goog.events :as events]))
 
-(util/isLeap 211)
-;; => false

-
-
-
- - - - - -
-
Note
-		 -you can open the nodejs repl just executing clj tools.clj repl in the -root of the project. -
-
-
- - - - - -
-
Note
-		 -this is the approach used by many projects to implement some performance -sensitive logic directly in javascript and export it in an easy way to -ClojureScript -
-
-
-
-

4.4.5. Global Export

-
-

This is the most extended and the most reliable way to consume external -javascript libraries from ClojureScript and it has many facilities.

-
-
-

The fastest way to include a javascript library is looking if it is available in -CLJSJS. If it is available, just include the -dependency in the deps.edn file and use it.

-
-
-

That libraries has two ways of use it, let’s see some examples.

-
-
-

Start adding moment dependency to deps.edn file:

-
-
-
-
cljsjs/moment {:mvn/version "2.24.0-0"}
-
-
-
-

Then, open the repl and try the following:

-
-
-
using the js/ special namespace
-
-
(require '[cljsjs.moment]) ;; just require, no alias
+(defn on-change
+  [event]
+  (let [result (dom/getElement "result")
+        target (.-target event)
+        value  (.-value target)]
 
-(.format (js/moment) "LLLL")
-;; => "Monday, July 15, 2019 5:32 PM"
-
-
-
-
using the alias
-
-
(require '[moment :as m])
+    (if (str/blank? value)
+      (set! (.-innerHTML result) "---")
+      (if (df/isLeapYear value)
+        (set! (.-innerHTML result) "YES")
+        (set! (.-innerHTML result) "NO")))))
 
-(.format (m) "LLLL")
-;; => "Monday, July 15, 2019 5:33 PM"
-
+(defn main + [] + (let [input (dom/getElement "year")] + (events/listen input "keyup" on-change)))
-
-

Behind the scenes that packages uses the ClojureScript compiler facilities -descibed -here for provide the compiler with enough information about the files and -global exports to use.

-

So, if don’t find a library in cljsjs, we can include it using the same -facilities. Let’s assume that moment is not available on cljsjs and we need it -on our project.

+

You can observe that, NPM depenencies are declared as strings on the ns section. Then, +you just use the isLeapYear exported function from the date-fns library like any other +function.

-

For include an foreign dependency we need to pass :foreign-libs and :externs -params to the ClojureScript compiler, and we have two ways:

+

You can read the whole detail on how it works here: +https://shadow-cljs.github.io/docs/UsersGuide.html#npm

-
-
    -
  • -

    passing them to the build or repl functions.

    -
    • -
  • -

    inside the deps.cljs file located on the root of the classpath.

    -
    • -
+
+

4.3.3. Glonal dependency

-

The deps.cljs approach requires that files should be localted on the local -directories, but the first approach allows specify directly external urls. We -will use the first approach on our example.

+

There’s not much to really explain here, in this case, include whatever library is needed +from the CDN or elsewhere in the index.html and access the global export that that library +uses using clojurescript’s js/ syntax to access globally defined things. Just as you +would do, for example, to access the location object.

-

This is how looks the deps.edn file with the changes applied:

+

Example:

-
-
;; [...]
-
-(def foreign-libs
-  [{:file "https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.24.0/moment.js"
-    :file-min "https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.24.0/moment.min.js"
-    :provides ["vendor.moment"]}])
-
-
-(def build-opts
-  {:output-to "target/public/js/leapyears.js"
-   :source-map true
-   :output-dir "target/public/js/leapyears"
-   :main 'leapyears.core
-   :verbose true
-   :optimizations :none
-   :foreign-libs foreign-libs})
-
-(defmethod task "repl"
-  [args]
-  (repl/repl (node/repl-env)
-             :foreign-libs foreign-libs
-             :output-dir "target/node"
-             :cache-analysis true))
-
-;; [...]
+
+
(js/console.log (.-href js/location))
-
-

Now, if you excute the repl, you will be able to import vendor.moment in the same way -if you are using the cljsjs package.

+
+
+

4.4. Dealing with JS files

-

Finally, there are the :externs option, that will be needed only for the -production build, and the externs file consists in plain javascript files that -declares the public API of the included foreign libraries and make them -understandable to the google closure compiler.

+

There are also circumstances in which it is better to use the host’s native language to +implement some feature or you already have a piece of code implementing some algorithm and +you want to be able to use it from CLJS.

-

The moment externs are available -here -and if you include some library that you want to use, and then want to compile -your app with advanced optimizations you will need to include a file similar to -the moment.ext.js on the project and referenciate it with :externs option to -the ClojureScript compiler.

+

For this case, we have two options: an ESM module or a Closure module.

+
+

4.4.1. Closure compatible module

-

More info on clojurescript.org.

+

Lets start with a Closure module definition.

+
+

The main advantage of this approach is that there are no distinction between a +clojurescript namespace and a file defined using closure module style. You import it in +the same way independently on how it is implemented. Also if you have a library that is +written to be compatible with closure module system and you want to include it on your +project. And finally, it is the standard way how clojurescript compiler generates code +from your .cljs files, so it works with or without shadow-cljs tooling.

-
-

4.4.6. ES6/CommonJS modules

-

Google Closure Compiler has an advanced feature that allows convert from -different module types (commonjs and ES) into google closure module -type. Although this feature is still experimental. With simple modules it works, -but with more complex modules (many submodules and directories) still doest -not complies correctly.

+

Obviously, the main disadvantage is that is uses a custom, not very common approach for +defining it.

-

In any way I invite you to experiment with it. You can found more documentation -on -clojurescript.org.

+

So, for understand it correctly, lets use our mywebapp application and add an util +module. This is the most simplest case, because closure modules are directly compatible +with cljs and you can mix your clojurescript code with javascript code without any +additional steps.

+
+
+
+
touch src/mywebapp/util.js
+
-

The best way to use ES6 and/or CommonJS module is combining a javascript bundler -like rollup or webpack to generate a single build with external dependencies -and thn use the global exports method to use it in ClojureScript. An example -of this is explained on clojurescript.org.

+

And then, we implement the isLeapYear in javascript:

+
+
src/mywebapp/util.js
+
+
goog.provide("mywebapp.util");
+
+goog.scope(function() {
+  let module = mywebapp.util;
+
+  module.isLeapYear = function(val) {
+    val = parseInt(val, 10);
+    return (0 === (val % 400)) || (((val % 100) > 0) && (0 === (val % 4)));
+  };
+});
-
-

4.5. Interactive development with Figwheel

-

And finally we will introduce figwheel, that enables fully interactive, -REPL-based and hot reloading enabled development environment.

+

Then modify the src/mywebapp/main.cljs file to use our util module:

+
+
+
+
(ns mywebapp.main
+  (:require
+   [mywebapp.util :as util]
+   [goog.dom :as dom]
+   [cuerdas.core :as str]
+   [goog.events :as events]))
+
+(defn on-change
+  [event]
+  (let [result (dom/getElement "result")
+        target (.-target event)
+        value  (.-value target)]
+
+    (if (str/blank? value)
+      (set! (.-innerHTML result) "---")
+      (if (util/isLeapYear value)
+        (set! (.-innerHTML result) "YES")
+        (set! (.-innerHTML result) "NO")))))
+
+(defn main
+  []
+  (let [input (dom/getElement "year")]
+    (events/listen input "keyup" on-change)))
+
-

We will reuse the leapyears project structure for the following examples.

+

As you can observe, the require entry is indistinguible from any other, because it +integrates 100% with the cljs build process.

-
- - - - - -
-
Note
-		 -Although we use figwheel here for web application, it works in the same -way on the application that targets nodejs as execution environment. -
+
+
+

4.4.2. ESM Modules

+
+

This is other way to define an companion modules using JS language; is the recommended way +to do it on shadow-cljs and the main advantage of it is the familiar ESM syntax.

-

As first step, we need to add figwheel dependency to the deps.edn file:

+

So, lets proceed to define/overwrite the same module used in previous example to use the +ESM syntax.

-
com.bhauman/figwheel-main {:mvn/version "0.2.1"}
+
export function isLeapYear (val) {
+  val = parseInt(val, 10);
+  return (0 === (val % 400)) || (((val % 100) > 0) && (0 === (val % 4)));
+}
-

Then, add new task to the tools.clj script:

+

Then, change the require on the src/mywebapp/main.cljs file to:

-
(def figwheel-opts
-  {:open-url false
-   :load-warninged-code true
-   :auto-testing false
-   :ring-server-options {:port 3448 :host "0.0.0.0"}
-   :watch-dirs ["src"]})
+
(ns mywebapp.main
+  (:require
+   ["./util.js" :as util]
+   [goog.dom :as dom]
+   [cuerdas.core :as str]
+   [goog.events :as events]))
 
-(defmethod task "figwheel"
-  [args]
-  (figwheel/start figwheel-opts {:id "main" :options build-opts}))

-
+;; [...]
-
-

And then, run clojure tools.clj fighweel. This will start the figwheel process -that automatically will launch a http server that will serve the -target/public/ directory and index to index.html file.

-

If you update the code, that code will be automatically loaded to the browser, -without page reload.

+

You can read a more detailed information about this here: https://shadow-cljs.github.io/docs/UsersGuide.html#classpath-js

-
-

For more info: figwheel.org.

-

4.6. Unit testing

+

4.5. Unit testing

As you might expect, testing in ClojureScript consists of the same concepts widely used by other language such as Clojure, Java, Python, JavaScript, etc.

@@ -6052,7 +5505,7 @@

4.6. Unit testing for testing is thus greatly simplified.

-

4.6.1. First steps

+

4.5.1. Setup first Test

The "official" ClojureScript testing framework is in the "cljs.test" namespace. It is a very simple library, but it should be more than enough for our purposes.

@@ -6064,152 +5517,80 @@

4.6.1. First steps< them here.

-

We will reuse the leapyears project structure and we will add testing to it. Let’s create -the test related files and directories:

-
-
-
-
mkdir -p test/leapyears/test
-touch test/leapyears/test/main.cljs
-
-
-
-

Also we will need to create new tasks on our tools.clj file for build, watch and run -tests:

+

We will reuse the mywebapp project structure and we will add testing to it. Let’s create +the test file src/mywebapp/util_test.cljs:

-
(require '[clojure.java.shell :as shell])
-
-;; [...]
-
-(defmethod task "build:tests"
-  [args]
-  (b/build (b/inputs "src" "vendor" "test")
-           (assoc build-opts
-                  :main 'leapyears.test.main
-                  :output-to "out/tests.js"
-                  :output-dir "out/tests"
-                  :target :nodejs)))
+
(ns mywebapp.util-test
+  (:require
+   [cljs.test :as t]
+   ["./util.js" :as util]))
 
-(defmethod task "watch:test"
-  [args]
-  (letfn [(run-tests []
-            (let [{:keys [out err]} (shell/sh "node" "out/tests.js")]
-              (println out err)))]
-    (println "Start watch loop...")
-    (try
-      (b/watch (b/inputs "src", "test")
-               (assoc build-opts
-                      :main 'leapyears.test.main
-                      :watch-fn run-tests
-                      :output-to "out/tests.js"
-                      :output-dir "out/tests"
-                      :target :nodejs))
-
-      (catch Exception e
-        (println "Error on running tests:" e)
-        ;; (Thread/sleep 2000)
-        (task args)))))

+(t/deftest is-leap
+  (t/is (true? (util/isLeapYear "2024"))))
-

Next, put some test code in the test/leapyears/test/main.cljs file:

+

Now, lets add a new build target to our shadow-cljs.edn configuration file:

-
(ns leapyears.test.main
-  (:require [cljs.test :as t]))
-
-(enable-console-print!)
+
{:dev-http {8888 "public"}
 
-(t/deftest my-first-test
-  (t/is (= 1 2)))
+ :dependencies
+ [[funcool/cuerdas "2022.06.16-403"]]
 
-(set! *main-cli-fn* #(t/run-tests))
+ :source-paths
+ ["src" "test"]
 
-;; This extension is required for correctly set the return code
-;; depending if the test passes or not.
-(defmethod t/report [:cljs.test/default :end-run-tests]
-  [m]
-  (if (t/successful? m)
-    (set! (.-exitCode js/process) 0)
-    (set! (.-exitCode js/process) 1)))

+ :builds
+ {:app
+  {:target :browser
+   :output-dir "public/js"
+   :asset-path "/js"
+   :modules {:main {:entries [mywebapp.main]
+                    :init-fn mywebapp.main/main}}}
+  :test
+  {:target    :node-test
+   :output-to "target/test.js"
+   :ns-regexp "-test$"
+   :autorun   true}}}
-

The relevant part of that code snippet is:

+

Now, lets comple it and run tests:

-
(t/deftest my-first-test
-  (t/is (= 1 2)))
-
+
~~~~
+$ npx shadow-cljs watch test
+shadow-cljs - config: /home/user/playground/mywebapp/shadow-cljs.edn
+shadow-cljs - HTTP server available at http://localhost:8888
+shadow-cljs - server version: 2.26.2 running at http://localhost:9630
+shadow-cljs - nREPL server started on port 40217
+shadow-cljs - watching build :test
+[:test] Configuring build.
+[:test] Compiling ...
-
-

The deftest macro is a basic primitive for defining our tests. It takes a name as -its first parameter, followed by one or multiple assertions using the is macro. In -this example, we try to assert that (= 1 2) is true.

-

Let’s try to run this:

-
-
-
-
$ clojure tools build:tests
-$ node out/tests.js
-Testing mytestingapp.core-tests
-
-FAIL in (my-first-test) (cljs/test.js:374:14)
-expected: (= 1 2)
-  actual: (not (= 1 2))
-
-Ran 1 tests containing 1 assertions.
-1 failures, 0 errors.
-
+

Testing mywebapp.util-test

-

You can see that the expected assert failure is successfully printed in the -console. To fix the test, just change the = with not= and run the file again:

-
-
-
-
$ clojure tools build:tests
-$ node out/mytestingapp.js
-
-Testing mytestingapp.core-tests
-
-Ran 1 tests containing 1 assertions.
-0 failures, 0 errors.
-
+

Ran 1 tests containing 1 assertions. +0 failures, 0 errors.

-

It is fine to test these kinds of assertions, but they are not very -useful. Let’s go to test some application code. For this, we will use a function -to check if a year is a leap year or not:

-
-
-
-
(ns leapyears.test.main
-  (:require [cljs.test :as t]
-            [leapyears.vendor.util-closure :as util]))
-
-;; [...]
-
-(t/deftest my-second-test
-  (t/is (util/isLeap 1980))
-  (t/is (not (util/isLeap 1981))))
-
-;; [...]
-
+

[:test] Build completed. (52 files, 2 compiled, 0 warnings, 2.38s) +~~

-

Run the compiled file again to see that there are now two tests running. The -first test passes as before, and our two new leap year tests pass as well.

+

It will recompile and rerun the tests on each code change.

-

4.6.2. Async Testing

+

4.5.2. Async Testing

One of the peculiarities of ClojureScript is that it runs in an asynchronous, single-threaded execution environment, which has its challenges.

@@ -6270,8 +5651,119 @@

5.1. Transducers

+ +

+
+

5.2. Reader Conditionals

+
+

This language feature allows different dialects of Clojure to share common code that +is mostly platform independent but need some platform dependent code.

+
+
+

To use reader conditionals, all you need is to rename your source file with +.cljs extension to one with .cljc, because reader conditionals only work if +they are placed in files with .cljc extension.

+
+
+

5.2.1. Standard (#?)

+
+

There are two types of reader conditionals, standard and splicing. The standard +reader conditional behaves similarly to a traditional cond and the syntax looks +like this:

+
+
+
+
(defn parse-int
+  [v]
+  #?(:clj  (Integer/parseInt v)
+     :cljs (js/parseInt v)))
+
+
+
+

As you can observe, #? reading macro looks very similar to cond, the difference is +that the condition is just a keyword that identifies the platform, where :cljs is +for ClojureScript and :clj is for Clojure. The advantage of this approach, is +that it is evaluated at compile time so no runtime performance overhead introduced for +using this.

+
+
+
+

5.2.2. Splicing (#?@)

+
+

The splicing reader conditional works in the same way as the standard but also allows +splicing lists into the containing form. The #?@ reader macro is used for that +and the code looks like this:

+
+
+
+
(defn make-list
+  []
+  (list #?@(:clj  [5 6 7 8]
+            :cljs [1 2 3 4])))
+
+;; On ClojureScript
+(make-list)
+;; => (1 2 3 4)
+
+
+
+

The ClojureScript compiler will read that code as this:

+
+
+
+
(defn make-list
+  []
+  (list 1 2 3 4))
+
+
+
+

The splicing reader conditional can’t be used to splice multiple top level forms, +so the following code is illegal:

+
+
+
+
#?@(:cljs [(defn func-a [] :a)
+           (defn func-b [] :b)])
+;; => #error "Reader conditional splicing not allowed at the top level."
+
+
+
+

If you need so, you can use multiple forms or just use do block to group +multiple forms together:

+
+
+
+
#?(:cljs (defn func-a [] :a))
+#?(:cljs (defn func-b [] :b))
+
+;; Or
+
+#?(:cljs
+   (do
+     (defn func-a [] :a)
+     (defn func-b [] :b)))
+
+
+
+
+

5.2.3. More readings

+
+ +
+
-

5.1.1. Data transformation

+

5.2.4. Data transformation

ClojureScript offers a rich vocabulary for data transformation in terms of the sequence abstraction, which makes such transformations highly general and @@ -6352,7 +5844,7 @@

5.1.1.

-

5.1.2. Generalizing to process transformations

+

5.2.5. Generalizing to process transformations

The process of mapping, filtering or mapcatting isn’t necessarily tied to a concrete type, but we keep reimplementing them for different types. Let’s see how we can @@ -6559,7 +6051,7 @@

-

5.1.3. Transducers in ClojureScript core

+

5.2.6. Transducers in ClojureScript core

Some of the ClojureScript core functions like map, filter and mapcat support an arity 1 version that returns a transducer. Let’s revisit our @@ -6623,7 +6115,7 @@

-

5.1.4. Initialisation

+

5.2.7. Initialisation

In the last example we provided an initial value to the transduce function ([]) but we can omit it and get the same result:

@@ -6700,7 +6192,7 @@

5.1.4. Initialisa

-

5.1.5. Stateful transducers

+

5.2.8. Stateful transducers

So far we’ve only seen purely functional transducer; they don’t have any implicit state and are very predictable. However, there are many data @@ -6881,7 +6373,7 @@

5.1.5

-

5.1.6. Eductions

+

5.2.9. Eductions

Eductions are a way to combine a collection and one or more transformations that can be reduced and iterated over, and that apply the transformations every time @@ -6903,7 +6395,7 @@

5.1.6. Eductions

-

5.1.7. More transducers in ClojureScript core

+

5.2.10. More transducers in ClojureScript core

We learned about map, filter, mapcat, take and partition-all, but there are a lot more transducers available in ClojureScript. Here is an incomplete list of some @@ -6929,7 +6421,7 @@

-

5.1.8. Defining our own transducers

+

5.2.11. Defining our own transducers

There a few things to consider before writing our own transducers so in this section we will learn how to properly implement one. First of all, we’ve learned @@ -6968,7 +6460,7 @@

-

5.1.9. Transducible processes

+

5.2.12. Transducible processes

A transducible process is any process that is defined in terms of a succession of steps ingesting input values. The source of input varies from one process to @@ -7179,7 +6671,7 @@

5

-

5.2. Transients

+

5.3. Transients

Although ClojureScript’s immutable and persistent data structures are reasonably performant there are situations in which we are transforming large data @@ -7327,7 +6819,7 @@

5.2. Transients

-

5.3. Metadata

+

5.4. Metadata

ClojureScript symbols, vars and persistent collections support attaching metadata to them. Metadata is a map with information about the entity it’s @@ -7342,7 +6834,7 @@

5.3. Metadata documentation generation very easy. You’ll see why throughout this section.

-

5.3.1. Vars

+

5.4.1. Vars

Let’s define a var and see what metadata is attached to it by default. Note that this code is executed in a REPL, and thus the metadata of a var defined in a @@ -7437,7 +6929,7 @@

5.3.1. Vars

-

5.3.2. Values

+

5.4.2. Values

We learned that vars can have metadata and what kind of metadata is added to them for consumption by the compiler and the cljs.test testing @@ -7513,7 +7005,7 @@

5.3.2. Values

-

5.3.3. Syntax for metadata

+

5.4.3. Syntax for metadata

The ClojureScript reader has syntactic support for metadata annotations, which can be written in different ways. We can prepend var definitions or collections @@ -7590,7 +7082,7 @@

5.3.3.

-

5.3.4. Functions for working with metadata

+

5.4.4. Functions for working with metadata

We’ve learned about meta and with-meta so far but ClojureScript offers a few functions for transforming metadata. There is vary-meta which is similar to @@ -7643,14 +7135,14 @@

-

5.4. Core protocols

+

5.5. Core protocols

One of the greatest qualities of the core ClojureScript functions is that they are implemented around protocols. This makes them open to work on any type that we extend with such protocols, be it defined by us or a third party.

-

5.4.1. Functions

+

5.5.1. Functions

As we’ve learned in previous chapters not only functions can be invoked. Vectors are functions of their indexes, maps are functions of their keys and sets are functions @@ -7685,7 +7177,7 @@

5.4.1. Functions

-

5.4.2. Printing

+

5.5.2. Printing

For learning about some of the core protocols we’ll define a Pair type, which will hold a pair of values.

@@ -7711,7 +7203,7 @@

5.4.2. Printing

-

5.4.3. Sequences

+

5.5.3. Sequences

In a previous section we learned about sequences, one of ClojureScript’s main abstractions. Remember the first and rest functions for @@ -7802,7 +7294,7 @@

5.4.3. Sequences

-

5.4.4. Collections

+

5.5.4. Collections

Collection functions are also defined in terms of protocols. For this section examples we will make the native JavaScript string act like a collection.

@@ -7908,7 +7400,7 @@
Collection
-

5.4.5. Associative

+

5.5.5. Associative

There are many data structures that are associative: they map keys to values. We’ve encountered a few of them already and we know many functions for working with them @@ -8061,7 +7553,7 @@

5.4.5. Associative<

-

5.4.6. Comparison

+

5.5.6. Comparison

For checking whether two or more values are equivalent with = we must implement the IEquiv protocol. Let’s do it for our Pair type:

@@ -8128,7 +7620,7 @@

5.4.6. Comparison

-

5.4.7. Metadata

+

5.5.7. Metadata

The meta and with-meta functions are also based upon two protocols: IMeta and IWithMeta respectively. We can make our own types capable of carrying metadata @@ -8163,7 +7655,7 @@

5.4.7. Metadata

-

5.4.8. Interoperability with JavaScript

+

5.5.8. Interoperability with JavaScript

Since ClojureScript is hosted in a JavaScript VM we often need to convert ClojureScript data structures to JavaScript ones and viceversa. We also may want to @@ -8341,7 +7833,7 @@

-

5.4.9. Reductions

+

5.5.9. Reductions

The reduce function is based on the IReduce protocol, which enables us to make our own or third-party types reducible. Apart from using them with reduce they @@ -8441,7 +7933,7 @@

5.4.9. Reductions

-

5.4.10. Delayed computation

+

5.5.10. Delayed computation

There are some types that have the notion of asynchronous computation, the value they represent may not be realized yet. We can ask whether a value is realized using @@ -8479,7 +7971,7 @@

5.4.10.

-

5.4.11. State

+

5.5.11. State

The ClojureScript state constructs such as the Atom and the Volatile have different characteristics and semantics, and the operations on them like add-watch, reset! @@ -8766,7 +8258,7 @@

Volatile
-

5.4.12. Mutation

+

5.5.12. Mutation

In the section about transients we learned about the mutable counterparts of the immutable and persistent data structures that ClojureScript @@ -8868,7 +8360,7 @@

-

5.5. CSP (with core.async)

+

5.6. CSP (with core.async)

CSP stands for Communicating Sequential Processes, which is a formalism for describing concurrent systems pioneered by C. A. R. Hoare in 1978. It is a @@ -8886,7 +8378,7 @@

5.5. CS have core.async installed to run the examples presented in this section.

-

5.5.1. Channels

+

5.6.1. Channels

Channels are like conveyor belts, we can put and take a single value at a time from them. They can have multiple readers and writers, and they are the fundamental @@ -9331,7 +8823,7 @@

Offer and Poll
-

5.5.2. Processes

+

5.6.2. Processes

We learned all about channels but there is still a missing piece in the puzzle: processes. Processes are pieces of logic that run independently and use channels @@ -9620,7 +9112,7 @@

Defaults
-

5.5.3. Combinators

+

5.6.3. Combinators

Now that we’re acquainted with channels and processes it’s time to explore some interesting combinators for working with channels that are present in core.async. @@ -9955,7 +9447,7 @@

merge
-

5.5.4. Higher-level abstractions

+

5.6.4. Higher-level abstractions

We’ve learned the about the low-level primitives of core.async and the combinators that it offers for working with channels. core.async also offers some useful, @@ -10386,80 +9878,9 @@

7. Further Read

- \ No newline at end of file