Skip to content

Commit

Permalink
smaller changes in dev startup guide
Browse files Browse the repository at this point in the history
  • Loading branch information
puredanger committed Jan 2, 2024
1 parent 1b84d9b commit 70b00b3
Showing 1 changed file with 3 additions and 7 deletions.
10 changes: 3 additions & 7 deletions content/guides/dev_startup_time.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -24,17 +24,13 @@ The `compile` function takes a namespace symbol and compiles that namespace and

Subsequently, when any of those compiled namespaces are required, the class file will be loaded, rather than the original `.clj` file. If a source file is updated (and thus newer), it will be loaded instead. Periodically, you will need to re-compile to account for new dependencies or changing code.

NOTE: Compilation happens as a side-effect of loading a namespace, and thus has no effect on already required ones. Use `*compile-files*` with `:reload-all` as suggested below to compile already loaded namespaces.

One special case is the `user.clj` file loaded automatically by the Clojure runtime, before any other code is loaded. (Though this applies equally to compiling any namespace that has already been loaded into the REPL.) If you are using a `user.clj` in dev, you need to force a reload because it has already been loaded automatically:
Note that compilation is a side effect of loading, so has no effect on already loaded namespaces. In particular, one special case is the `user.clj` file, which is loaded automatically by the Clojure runtime. If you are using a `user.clj` in dev (or need to compile namespaces that are already compiled), you can do so by forcing a reload while compiling:

[source,clojure]
----
(binding [*compile-files* true] ; <1>
(require 'user :reload-all)) ; <2>
(binding [*compile-files* true] ;; compile during load
(require 'user :reload-all)) ;; reload this and all transitively loaded namespaces
----
<1> Tell Clojure to compile any namespace it is loading
<2> Tell Clojure to reload this and all required namespaces

That's it! This technique can substantially reduce your startup time during development, particularly as the number of dependencies you load increases.

Expand Down

0 comments on commit 70b00b3

Please sign in to comment.