Is there a way to have IPython automatically reload all changed code? Either before each line is executed in the shell or failing that when it is specifically requested to. I'm doing a lot of exploratory programming using IPython and SciPy and it's quite a pain to have to manually reload each module whenever I change it.
6 Answers
For IPython version 3.1, 4.x, and 5.x
%load_ext autoreload
%autoreload 2
Then your module will be auto-reloaded by default. This is the doc:
File: ...my/python/path/lib/python2.7/site-packages/IPython/extensions/autoreload.py
Docstring:
``autoreload`` is an IPython extension that reloads modules
automatically before executing the line of code typed.
This makes for example the following workflow possible:
.. sourcecode:: ipython
In [1]: %load_ext autoreload
In [2]: %autoreload 2
In [3]: from foo import some_function
In [4]: some_function()
Out[4]: 42
In [5]: # open foo.py in an editor and change some_function to return 43
In [6]: some_function()
Out[6]: 43
The module was reloaded without reloading it explicitly, and the
object imported with ``from foo import ...`` was also updated.
There is a trick: when you forget all of the above when using ipython
, just try:
import autoreload
?autoreload
# Then you get all the above
-
2Is there a way to do this in
ipdb
? Say, I am in ipd, and I notice a line didnt work. So I changed the line, and want to reload the file. Will this work? Mar 30, 2018 at 16:49 -
3
-
2the
2
in%autoreload 2
meansReload all modules (except those excluded by %aimport) every time before executing the Python code typed.
ipython.org/ipython-doc/3/config/extensions/autoreload.html– eth4ioJul 10, 2021 at 11:41 -
2I'm coming here every single time I have to do this. They are two lines that I cannot / don't want to remember Sep 27, 2022 at 8:40
-
2Same here @JuanLuisRuiz-tagle, about 5 years googling and coming to this thread haha Nov 3, 2022 at 19:22
As mentioned above, you need the autoreload
extension. If you want it to automatically start every time you launch ipython
, you need to add it to the ipython_config.py
startup file:
It may be necessary to generate one first:
ipython profile create
Then include these lines in ~/.ipython/profile_default/ipython_config.py
:
c.InteractiveShellApp.exec_lines = []
c.InteractiveShellApp.exec_lines.append('%load_ext autoreload')
c.InteractiveShellApp.exec_lines.append('%autoreload 2')
As well as an optional warning in case you need to take advantage of compiled Python code in .pyc
files:
c.InteractiveShellApp.exec_lines.append('print("Warning: disable autoreload in ipython_config.py to improve performance.")')
edit: the above works with version 0.12.1 and 0.13
-
1This is actually great. I was wondering why no one else was posting solutions to preserve it. Does this work with older versions of IPython as well? I've been using 0.12+. I recall that the way ipython stores customizations changed significantly. Dec 27, 2012 at 23:55
-
I'm using 0.12.1, and haven't yet tried 0.13, so I don't know whether it will work with 0.13+ Jan 2, 2013 at 18:12
-
6This is a good approach, but I think all you need to do is fill in the extenstions which should be around line 27:
c.InteractiveShellApp.extensions = ['autoreload']
– dvreed77May 16, 2013 at 16:15 -
11use
c.InteractiveShellApp.extensions = ['autoreload']
, andc.InteractiveShellApp.exec_lines = ['%autoreload 2']
. I am not sure but in the default profile of version 0.13 under Ubuntu 13.04 I found a 'startup' folder that contains a script '50_autoreload.ipy' to activate autoreload. Maybe nothing is required at all– spinxzMay 28, 2013 at 17:41 -
1I have to find this answer on any new install, this is the only sane config for development in iPython.– dashesySep 14, 2013 at 19:34
REVISED - please see Andrew_1510's answer below, as IPython has been updated.
...
It was a bit hard figure out how to get there from a dusty bug report, but:
It ships with IPython now!
import ipy_autoreload
%autoreload 2
%aimport your_mod
# %autoreload? for help
... then every time you call your_mod.dwim()
, it'll pick up the latest version.
-
4What if it is less direct?
%run sometest.py
containsimport themod
. After editingthemod.py
, I'd like to just%run sometest.py
, but it doesn't pick up the changes.– JedMay 22, 2011 at 8:20 -
2I think ipython 0.11 did away with this feature. Or is it just renamed/hidden someplace?– SirVerAug 1, 2011 at 8:51
-
1SirVer, you're right. Sigh. Evidently, it's in the 'quarantine' package: archlinux.org/packages/community/any/ipython/files Aug 19, 2011 at 5:51
-
Explanation here - with an invitation to port to 0.11 :) 'from IPython.quarantine import ipy_autoreload' succeeds, and creates an %autoreload command... but in my initial tests, it doesn't seem to work. Aug 19, 2011 at 5:58
-
1
If you add file ipython_config.py into the ~/.ipython/profile_default directory with lines like below, then the autoreload functionality will be loaded on IPython startup (tested on 2.0.0):
print "--------->>>>>>>> ENABLE AUTORELOAD <<<<<<<<<------------"
c = get_config()
c.InteractiveShellApp.exec_lines = []
c.InteractiveShellApp.exec_lines.append('%load_ext autoreload')
c.InteractiveShellApp.exec_lines.append('%autoreload 2')
There is an extension for that, but I have no usage experience yet:
http://ipython.scipy.org/ipython/ipython/attachment/ticket/154/ipy_autoreload.py