(rontolisp) docs
← Reference

Namespaces

Every namespace has its own vars: a definition belongs to the current namespace, a name resolves to that namespace's own var and then to a referred one, and alias/name or full.name/name reaches another namespace's public var. A namespace form switches to its namespace and wires its clauses: :as registers an alias, :refer/:use unqualified names, :import class names for interop, (:refer-clojure :only/:exclude ...) narrows the visible core; metadata on the name (^{...}, #^{...}), a docstring and an attr map are skipped. The built-in namespaces need no file; any other namespace is one the program declares with ns, or one loaded once from its file on the source path (Semantics). A namespace no root holds is an error (require: inside a function or a try, where the code runs).

NameExampleResult
ns(do (ns demo (:require [clojure.string :as s])) (s/upper-case "hi"))HI
require(do (require '[clojure.string :as s]) (s/join "," ["a"]))a
use(do (use '[clojure.string :only [upper-case]]) (upper-case "hi"))HI
import(do (import java.util.Date) nil)nil
in-ns(do (in-ns 'demo) nil)nil
the-ns(str (the-ns 'user))"user"
find-ns(find-ns 'no-such)nil
ns-name(ns-name *ns*)user
ns-resolve(ns-resolve 'clojure.core 'inc)#'clojure.core/inc
all-ns(contains? (set (map str (all-ns))) "clojure.core")true
create-ns(ns-name (create-ns 'demo))demo
remove-ns(do (create-ns 'gone) (remove-ns 'gone) (some? (find-ns 'gone)))false
loaded-libs(do (require 'clojure.string) (contains? (set (map str (loaded-libs))) "clojure.string"))true
intern(intern 'user 'eg 7)#'user/eg
var-set(try (var-set (intern 'user 'eg) 1) (catch IllegalStateException e :refused)):refused
with-redefs-fn(def rd-x 1) (with-redefs-fn {(var rd-x) 99} (fn [] rd-x))99
ns-publics(get (ns-publics 'clojure.core) 'map)#'clojure.core/map
ns-interns(contains? (ns-interns 'clojure.core) 'map)true
ns-map(get (ns-map 'user) 'map)#'clojure.core/map
ns-refers(do (refer 'clojure.string :only '[join]) (some? (get (ns-refers 'user) 'join)))true
ns-aliases(do (alias 's 'clojure.string) (ns-name (get (ns-aliases 'user) 's)))clojure.string
ns-imports(get (ns-imports 'user) 'String)java.lang.String
alias(do (alias 's 'clojure.string) (s/join "-" ["a"]))a-b
refer(do (refer 'clojure.string :only '[upper-case]) (upper-case "ab"))AB
refer-clojure(do (refer-clojure :rename '{map core-map}) (core-map inc [1 2]))(2 3)
ns-unmap(do (refer 'clojure.string :only '[join]) (ns-unmap 'user 'join) (get (ns-refers 'user) 'join))nil
ns-unalias(do (alias 's 'clojure.string) (ns-unalias 'user 's) (get (ns-aliases 'user) 's))nil
requiring-resolve(requiring-resolve 'clojure.string/join)#'clojure.string/join
load-string(load-string "(+ 1 2)")3
load-file(load-file "helper.clj")the file's last value

Built-in namespaces

A built-in namespace written in Clojure loads like a project file, after every source root, so a file of its name on the source path takes precedence -- except clojure.walk, clojure.core.protocols, clojure.instant, clojure.uuid, clojure.java.io and clojure.main, which are loaded before the program, as in Clojure: a qualified name such as clojure.walk/postwalk reaches one without a require, as it does clojure.edn's and clojure.string's. A clojure.* namespace that is not part of Clojure itself (a contrib library such as clojure.data.json) loads from the source path like any other; any other namespace of Clojure's own is an error.

NamespacePage
clojure.string(clojure.string)
clojure.set(clojure.set)
clojure.walkclojure.walk
clojure.ednclojure.edn
clojure.instantclojure.instant
clojure.uuid (no vars: #uuid reads through the reader)Instants and UUIDs
clojure.dataclojure.data
clojure.zipclojure.zip
clojure.datafy, clojure.core.protocolsclojure.datafy
clojure.core.reducersclojure.core.reducers
clojure.stacktraceclojure.stacktrace
clojure.mathclojure.math
clojure.pprintclojure.pprint
clojure.templateclojure.template
clojure.java.ioclojure.java.io
clojure.java.shell (interpreter and JVM)clojure.java.shell
clojure.xmlclojure.xml
clojure.reflect (refused when called on WebAssembly)clojure.reflect
clojure.replclojure.repl
clojure.mainclojure.main
clojure.testTests (clojure.test)
ring.adapter.rontolispRing adapter
ring.util.*, ring.middleware.*Ring utilities
riddley.walk, riddley.compilerCode walking (riddley)
rontolisp.http-clientHTTP client
rontolisp.http-urls (no vars: clojure.java.io reads http: URLs through rontolisp:fetch)HTTP URLs