`IPython.core.magics.history:HistoryMagics.history`

source: /IPython/core/magics/history.py :40

Signature

def history ( self , parameter_s = '' )

Summary

Extended Summary

%history [-n] [-o] [-p] [-t] [-f FILENAME] [-y] [-g [PATTERN ...]] [-l [LIMIT]] [-u] [range ...]

Print input history (_i<n> variables), with most recent last.

By default, input history is printed without line numbers so it can be directly pasted into an editor. Use -n to show them.

By default, all input history from the current session is displayed. Ranges of history can be indicated using the syntax:

4: Line 4, current session
4-6: Lines 4-6, current session
4-: Lines 4 onward (to end), current session
243/1-5: Lines 1-5, session 243
~2/: All lines of session 2 before current
~4/4-: Lines 4 onward (to end), session 4 before current
~2/7: Line 7, session 2 before current
~8/1-~6/5: From the first line of 8 sessions ago, to the fifth line of 6 sessions ago.

Multiple ranges can be entered, separated by spaces

The same syntax is used by %macro, %save, %edit, %rerun

Examples

:: In [6]: %history -n 4-6 4:a = 12 5:print(a**2) 6:%history -n 4-6 positional arguments: range options: -n print line numbers for each input. This feature is only available if numbered prompts are in use. -o also print outputs for each input. -p print classic '>>>' python prompts before each input. This is useful for making documentation, and in conjunction with -o, for producing doctest-ready output. -t print the 'translated' history, as IPython understands it. IPython filters your input and converts it all into valid Python source before executing it (things like magics or aliases are turned into function calls, for example). With this option, you'll see the native history instead of the user-entered version: '%cd /' will be seen as 'get_ipython().run_line_magic("cd", "/")' instead of '%cd /'. -f FILENAME FILENAME: instead of printing the output to the screen, redirect it to the given file. The file is always overwritten, though *when it can*, IPython asks for confirmation first. In particular, running the command 'history -f FILENAME' from the IPython Notebook interface will replace FILENAME even if it already exists *without* confirmation. -y yes, overwrite filename even if exists -g <[PATTERN ...]> treat the arg as a glob pattern to search for in (full) history. This includes the saved history (almost all commands ever written). The pattern may contain '?' to match one unknown character and '*' to match any number of unknown characters. Use '%hist -g' to show full saved history (may be very long). -l <[LIMIT]> get the last n lines from all sessions. Specify n as a single arg, or the default is the last 10 lines. -u when searching history using `-g`, show only unique history.

Aliases

IPython.core.magics.HistoryMagics.history