repload's Introduction

repload

A Clojure utility function to reload all referred vars and aliased namespaces in a REPL.

Motivation

Restarting the REPL is stupid
Manually :reloading referred vars and aliases is a pain
tools.namespace has too much overhead (e.g. state management)

Install

repload was designed to be used in the REPL exclusively. If you are using Leiningen (which you should), you can inject repload into your profiles.clj to make it available in all your REPLs.

Edit your ~/.lein/profiles.clj file:

{:user
 {
   ; ...
   :dependencies [ ; ...
                   [john2x/repload "0.0.3"]]
   :injections   [ ; ...
                   (require 'repload)
                   (require '[repload :refer [repload]])]
  }
 }

Usage

Now open up a new REPL:

$ lein new myproject
$ lein repl

user=> (use 'myproject.core)
nil
user=> (require '[myproject.core :as mp])
nil
user=> (source foo)
(defn foo
  "I don't do a whole lot."
  [x]
  (println x "Hello, World!"))
nil
user=> (foo "test")
test Hello, World!
nil
user=> (mp/foo "test")
test Hello, World!
nil

;; make some changes to your project

user=> (repload)
Reloading myproject.core [foo]
Reloading myproject.core with alias mp
nil
user=> (source foo)
(defn foo
  "I don't do a whole lot."
  [x]
  (println x "Goodbye, World!"))
nil
user=> (foo "test")
test Goodbye, World!
nil
user=> (mp/foo "test")
test Goodbye, World!
nil

By default, repload excludes reloading namespaces starting with clojure and repload. You can override these prefixes with the following:

;; add "myproject" as an ignored prefix
user=> (repload/add-exclude-prefix! "myproject")
user=> (repload)
nil  ;; nothing reloaded

;; set "myproject" as the *only* ignored prefix
;; (causing a *lot* of `clojure.core` vars to be reloaded)
;; (*not recommended*)
user=> (repload/set-exclude-prefixes! ["myproject"])