Clojure

Homepage / Notes / Computer Science / Programming Languages / Clojure

A Lisp on the JVM

Misc

(print) to print for humans
(println) to print with newline for humans
(pr) to print for data
(prn) to print with newline for data

Numbers

(+ 1 1)

Sum:

(reduce + [1 2 3])

Strings

"Damien"

Damien

(apply str (reverse "Damien"))

neimaD

String Interpolation

(def name "Damien")
(str "Hello " name)

#'user/name

"Hello Damien"

Join elements in lists

(clojure.string/join ", " ["element 1" "element 2" "element 3"])

element 1, element 2, element 3

Includes?

(clojure.string/includes? "Damien" "en")

true

Characters

Clojure characters are Java characters

\a

Special characters

special character	result
`\newline`	`"\n"`
`\space`	`" "`
`\tab`	`"\t"`
`\formfeed`	`"\f"`
`\backspace`	`"\b"`
`\return`	`"\r"`

Keywords

Keywords are symbolic identifiers that evaluate to themselves.

Example:

:foo

Convert to keyword

(keyword 'foo)

:foo

(keyword "foo")

:foo

Check if keyword

(keyword? :foo)

true

(keyword? "foo")

false

Variables

(def x 42)
x

#'user/x

`defonce`

defonce defines variable only if it has never been defined before:

(defonce y 9)
y

If you try to re-define it, it won't work:

(defonce y 10)
y

Array destructuring

(let [[a b c] '(1 2 3)] (println a b c))

1 2 3

nil

Check if something is nil:

(nil? nil)

true

Check if something is NOT nil:

(some? nil)

false

(some? 1)

Scope

let can be used to define a variable in a specific scope:

(let [z 5] z)

z is not defined outside of the scope:

class clojure.lang.Compiler$CompilerException

Functions

"defn" = "def" + "fn" (define function)

(defn greet [name] (str "Hello, " name))
(greet "Damien")

#'user/greet

"Hello, Damien"

Multi-Arity Functions

(defn greet
  ([] (greet "World!"))
  ([name] (str "Hello, " name)))

(greet "Damien")
(greet)

#'user/greet

"Hello, Damien"

"Hello, World!"

Anonymous Function Syntax

#() with % used as arguments (%1, %2 for first and second arguments)

(map #(* 2 %) '(1 2 3))

(2 4 6)

Data Structures

Collections

All Clojure collections are immutable and persistent.

Lists

(list 1 2 3)

(1 2 3)

Syntactic sugar:

'(1 2 3)

(1 2 3)

(first '(1 2 3))

(last '(1 2 3))

Check if element in list

(some #(= 3 %) '(1 2 3))

true

(some) alone only returns nil, not false

(some? (some #(= 4 %) '(1 2 3)))

false

Vectors

(vector 1 2 3)

[1 2 3]

Sets

Collections of unique values.

(set [1 2 3 1 2 3])

#{1 3 2}

Maps

(get {:a 1 :b 2} :a)

"get" can be omitted

({:a 1 :b 2} :b)

(get-in {:error {:code 404 :message "Wrong location"}} [:error :code])

Conditionals

If/if-not statements

(if true "this is true" "this is false")

this is true

(if false "this is true" "this is false")

this is false

When/when-not

Only handles "true", and wrapped in an implicit (do) statement

(when true (println "this is true") (println "this is also true"))

this is true
this is also true

Cond

(def x 10)
(cond (= x 10) "true")

#'user/x

"true"

Note: for this type of conds, if the first is true, it won't continue

(def x (rand-int 50))
(cond
  (> x 40) "more than 40"
  (> x 30) "more than 30"
  (> x 20) "more than 20"
  (> x 10) "more than 10"
  :else "neither")

#'user/x

"more than 30"

Another example

(def x (rand-int 50))
(cond
  (> x 40) "more than 40"
  (> x 30) "more than 30"
  (> x 20) "more than 20"
  (> x 10) "more than 10"
  :else "neither")

#'user/x

"neither"

Case

(let [name "Damien"]
  (case name
    "Damien" "my real name"
    "Émilie" "my wife's name"
    "Nicolas" "my brother's name"))

my real name

(let [name "Émilie"]
  (case name
    "Damien" "my real name"
    "Émilie" "my wife's name"
    "Nicolas" "my brother's name"))

my wife's name

Can provide a default:

(let [name "Hugo"]
  (case name
    "Damien" "my real name"
    "Émilie" "my wife's name"
    "Nicolas" "my brother's name"
    "Unknown name"))

Unknown name

Can "match" multiple values using a list:

(let [name "Émilie"]
  (case name
    ("Damien" "Émilie" "Nicolas") "a family member"
    "not a family member"))

a family member

Metadata

https://clojure.org/reference/metadata
Metadata allows to attach arbitrary annotation to data.
Metadata isn't considered an integral of the value of the object. It doesn't impact equality of the data.
"Two objects that differ only in metadata are equal."

(pprint (meta #'+))

{:added "1.2",
 :ns #namespace[clojure.core],
 :name +,
 :file "clojure/core.clj",
 :inline-arities #function[clojure.core/>1?],
 :column 1,
 :line 986,
 :arglists ([] [x] [x y] [x y & more]),
 :doc
 "Returns the sum of nums. (+) returns 0. Does not auto-promote\n  longs, will throw on overflow. See also: +'",
 :inline #function[clojure.core/nary-inline/fn--5606]}

(def m ^:hi [1 2 3])
(meta (with-meta m {:bye true}))

#'user/m

{:bye true}

Threading Macros

Thread-First

(require '[clojure.string :as str])

(str/split (str/upper-case "a b c") #" ")

["A" "B" "C"]

Becomes

(-> "a b c" (str/upper-case) (str/split #" "))

["A" "B" "C"]

Thread-Last

Insert as last argument

(->> (range 10) (filter odd?))

(1 3 5 7 9)

ClojureScript

JavaScript interop

https://lwhorton.github.io/2018/10/20/clojurescript-interop-with-javascript.html

Google Closure Library

https://google.github.io/closure-library/api/

Packages

Reagent

https://github.com/reagent-project/reagent
http://reagent-project.github.io/
A minimalistic ClojureScript interface to React.js
https://github.com/reagent-project/reagent/blob/master/doc/CreatingReagentComponents.md

nbb

https://github.com/babashka/nbb

Babahska for ClojureScript / Node.js

scittle

https://github.com/babashka/scittle

The Small Clojure Interpreter exposed for usage in browser script tags

shadow-cljs

https://github.com/thheller/shadow-cljs

ClojureScript compilation made easy

secretary

https://github.com/clj-commons/secretary

A client-side router for ClojureScript

Cherry

https://github.com/squint-cljs/cherry

Experimental ClojureScript to ES6 module compiler

Squint

https://github.com/squint-cljs/squint

ClojureScript syntax to JavaScript compiler

Resources

https://cljs.info/cheatsheet/

ClojureScript for React Developer

https://www.youtube.com/playlist?list=PLUGfdBfjve9VGzp7G1C9FYfH8Yk1Px-11

Packages

babashka

https://github.com/babashka/babashka

Native, fast starting Clojure interpreter for scripting

clj-kondo

https://github.com/clj-kondo/clj-kondo

A linter for Clojure code that sparks joy.

Coast

https://coast.swlkr.com/

The Fullest Full Stack Clojure Web Framework

Hiccup

https://github.com/weavejester/hiccup

Fast library for rendering HTML in Clojure

ClojureDart

https://github.com/Tensegritics/ClojureDart

A port of Clojure that compiles to Dart (mostly for Flutter framework)

DataScript

https://github.com/tonsky/datascript

Immutable database and Datalog query engine for Clojure, ClojureScript and JS

Quickdoc

https://github.com/borkdude/quickdoc

Quick and minimal API doc generation for Clojure

Pedestal

http://pedestal.io/

Pedestal is a set of libraries that we use to build services and applications. It runs in the back end and can serve up whole HTML pages or handle API requests.

Portal

https://github.com/djblue/portal

A clojure tool to navigate through your data.

Leiningen

https://leiningen.org/

Automate Clojure projects without setting your hair on fire.

Neil

https://github.com/babashka/neil

A CLI to add common aliases and features to deps.edn-based projects.

Krell

https://github.com/vouch-opensource/krell

Simple ClojureScript React Native Tooling

Resources

Syntax

Clojure by Example

https://kimh.github.io/clojure-by-example/

Lambda Island videos

Clojure

Misc

Numbers

Strings

String Interpolation

Join elements in lists

Includes?

Characters

Special characters

Keywords

Convert to keyword

Check if keyword

Variables

defonce

Array destructuring

nil

Scope

Functions

Multi-Arity Functions

Anonymous Function Syntax

Data Structures

Collections

Lists

Check if element in list

Vectors

Sets

Maps

Conditionals

If/if-not statements

When/when-not

Cond

Case

Metadata

Threading Macros

Thread-First

Thread-Last

ClojureScript

JavaScript interop

Google Closure Library

Packages

Reagent

nbb

scittle

shadow-cljs

secretary

Cherry

Squint

Resources

ClojureScript for React Developer

Packages

babashka

clj-kondo

Coast

Hiccup

ClojureDart

DataScript

Quickdoc

Pedestal

Portal

Leiningen

Neil

Krell

Resources

Syntax

Clojure by Example

Lambda Island videos

List Comprehension with clojure.core/for

Seq and Seqable

Using JavaScript libraries in ClojureScript

Clojure Keyword Arguments

ClojureScript Interop

Clojure Docs

`defonce`