Configuration

Using Revise by default

If you like Revise, you can ensure that every Julia session uses it by launching it from your .julia/config/startup.jl file.

Revise 2.6+ and Julia 1.5+

If you're using at least version 2.6 of Revise and version 1.5 or higher of Julia, this can be as simple as adding

using Revise

to your startup.jl.

If you use different package depots and do not always have Revise available,

try
    using Revise
catch e
    @warn(e.msg)
end

is recommended instead.

Earlier versions of Revise and/or Julia

If you sometimes use versions of Julia prior to 1.5, instead of the above add

atreplinit() do repl
    try
        @eval using Revise
        @async Revise.wait_steal_repl_backend()
    catch e
        @warn(e.msg)
    end
end

to your startup.jl.

Using Revise automatically within Jupyter/IJulia

If you want Revise to launch automatically within IJulia, then you should also create a .julia/config/startup_ijulia.jl file with the contents

try
    @eval using Revise
catch e
    @warn(e.msg)
end

Optional configuration

Revise can be configured by setting environment variables. These variables have to be set before you execute using Revise, because these environment variables are parsed only during execution of Revise's __init__ function.

There are several ways to set these environment variables:

• If you are Using Revise by default then you can include statements like ENV["JULIA_REVISE"] = "manual" in your .julia/config/startup.jl file prior to the line @eval using Revise.
• On Unix systems, you can set variables in your shell initialization script (e.g., put lines like export JULIA_REVISE=manual in your .bashrc file if you use bash).
• On Unix systems, you can launch Julia from the Unix prompt as $ JULIA_REVISE=manual julia to set options for just that session.

The function of specific environment variables is described below.

Manual revision: JULIA_REVISE

By default, Revise processes any modified source files every time you enter a command at the REPL. However, there might be times where you'd prefer to exert manual control over the timing of revisions. Revise looks for an environment variable JULIA_REVISE, and if it is set to anything other than "auto" it will require that you manually call revise() to update code.

Alternatively, you can omit the call to Revise.async_steal_repl_backend() from your startup.jl file (see Using Revise by default).

User scripts: JULIA_REVISE_INCLUDE

By default, Revise only tracks files that have been required as a consequence of a using or import statement; files loaded by include are not tracked, unless you explicitly use includet or Revise.track(filename). However, you can turn on automatic tracking by setting the environment variable JULIA_REVISE_INCLUDE to the string "1" (e.g., JULIA_REVISE_INCLUDE=1 in a bash script).

Configurations for fixing errors

No space left on device

Revise needs to be notified by your filesystem about changes to your code, which means that the files that define your modules need to be watched for updates. Some systems impose limits on the number of files and directories that can be watched simultaneously; if this limit is hit, on Linux this can result in a fairly cryptic error like

ERROR: start_watching (File Monitor): no space left on device (ENOSPC)

The cure is to increase the number of files that can be watched, by executing

echo 65536 | sudo tee -a /proc/sys/fs/inotify/max_user_watches

at the Linux prompt. (The maximum value is 524288, which will allocate half a gigabyte of RAM to file-watching). For more information see issue #26.

Changing the value this way may not last through the next reboot, but you can also change it permanently.

Polling and NFS-mounted code directories: JULIA_REVISE_POLL

Revise works by monitoring your filesystem for changes to the files that define your code. On most operating systems, Revise can work "passively" and wait to be signaled that one or more watched directories has changed.

Unfortunately, a few file systems systems (notably, the Unix-based Network File System NFS) don't support this approach. In such cases, Revise needs to "actively" check each file periodically to see whether it has changed since the last check. This active process is called polling. You turn on polling by setting the environment variable JULIA_REVISE_POLL to the string "1" (e.g., JULIA_REVISE_POLL=1 in a bash script).