##// END OF EJS Templates
- applied Nicolas Pernetty's patch to improve support for (X)Emacs under Win32....
fperez -
Show More
@@ -1,7 +1,7 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """Tools for coloring text in ANSI terminals.
2 """Tools for coloring text in ANSI terminals.
3
3
4 $Id: ColorANSI.py 1005 2006-01-12 08:39:26Z fperez $"""
4 $Id: ColorANSI.py 2152 2007-03-18 20:13:35Z fperez $"""
5
5
6 #*****************************************************************************
6 #*****************************************************************************
7 # Copyright (C) 2002-2006 Fernando Perez. <fperez@colorado.edu>
7 # Copyright (C) 2002-2006 Fernando Perez. <fperez@colorado.edu>
@@ -79,6 +79,12 b' class InputTermColors:'
79 This class should be used as a mixin for building color schemes."""
79 This class should be used as a mixin for building color schemes."""
80
80
81 NoColor = '' # for color schemes in color-less terminals.
81 NoColor = '' # for color schemes in color-less terminals.
82
83 if os.name == 'nt' and os.environ.get('TERM','dumb') != 'emacs':
84 # (X)emacs on W32 gets confused with \001 and \002 so we remove them
85 Normal = '\033[0m' # Reset normal coloring
86 _base = '\033[%sm' # Template for all other colors
87 else:
82 Normal = '\001\033[0m\002' # Reset normal coloring
88 Normal = '\001\033[0m\002' # Reset normal coloring
83 _base = '\001\033[%sm\002' # Template for all other colors
89 _base = '\001\033[%sm\002' # Template for all other colors
84
90
@@ -5,7 +5,7 b' General purpose utilities.'
5 This is a grab-bag of stuff I find useful in most programs I write. Some of
5 This is a grab-bag of stuff I find useful in most programs I write. Some of
6 these things are also convenient when working at the command line.
6 these things are also convenient when working at the command line.
7
7
8 $Id: genutils.py 2108 2007-02-23 00:31:17Z fperez $"""
8 $Id: genutils.py 2152 2007-03-18 20:13:35Z fperez $"""
9
9
10 #*****************************************************************************
10 #*****************************************************************************
11 # Copyright (C) 2001-2006 Fernando Perez. <fperez@colorado.edu>
11 # Copyright (C) 2001-2006 Fernando Perez. <fperez@colorado.edu>
@@ -1247,7 +1247,8 b' def get_pager_start(pager,start):'
1247 return start_string
1247 return start_string
1248
1248
1249 #----------------------------------------------------------------------------
1249 #----------------------------------------------------------------------------
1250 if os.name == "nt":
1250 # (X)emacs on W32 doesn't like to be bypassed with msvcrt.getch()
1251 if os.name == 'nt' and os.environ.get('TERM','dumb') != 'emacs':
1251 import msvcrt
1252 import msvcrt
1252 def page_more():
1253 def page_more():
1253 """ Smart pausing between pages
1254 """ Smart pausing between pages
@@ -6,7 +6,7 b''
6 # the file COPYING, distributed as part of this software.
6 # the file COPYING, distributed as part of this software.
7 #*****************************************************************************
7 #*****************************************************************************
8
8
9 # $Id: usage.py 2010 2006-12-20 15:29:17Z vivainio $
9 # $Id: usage.py 2152 2007-03-18 20:13:35Z fperez $
10
10
11 from IPython import Release
11 from IPython import Release
12 __author__ = '%s <%s>' % Release.authors['Fernando']
12 __author__ = '%s <%s>' % Release.authors['Fernando']
@@ -53,19 +53,19 b' SPECIAL THREADING OPTIONS'
53 ization of ipython itself, before the normal option-handling mechanism
53 ization of ipython itself, before the normal option-handling mechanism
54 is active.
54 is active.
55
55
56 -gthread, -qthread, -wthread, -pylab
56 -gthread, -qthread, -q4thread, -wthread, -pylab
57
57
58 Only ONE of these can be given, and it can only be given as the
58 Only ONE of these can be given, and it can only be given as the
59 first option passed to IPython (it will have no effect in any
59 first option passed to IPython (it will have no effect in any
60 other position). They provide threading support for the GTK, QT
60 other position). They provide threading support for the GTK, QT
61 and WXWidgets toolkits, and for the matplotlib library.
61 and WXWidgets toolkits, and for the matplotlib library.
62
62
63 With any of the first three options, IPython starts running a
63 With any of the first four options, IPython starts running a
64 separate thread for the graphical toolkit's operation, so that
64 separate thread for the graphical toolkit's operation, so that
65 you can open and control graphical elements from within an
65 you can open and control graphical elements from within an
66 IPython command line, without blocking. All three provide
66 IPython command line, without blocking. All four provide
67 essentially the same functionality, respectively for GTK, QT and
67 essentially the same functionality, respectively for GTK, QT3,
68 WXWidgets (via their Python interfaces).
68 QT4 and WXWidgets (via their Python interfaces).
69
69
70 Note that with -wthread, you can additionally use the -wxversion
70 Note that with -wthread, you can additionally use the -wxversion
71 option to request a specific version of wx to be used. This
71 option to request a specific version of wx to be used. This
@@ -81,14 +81,14 b' SPECIAL THREADING OPTIONS'
81 execute (without blocking) any matplotlib-based script which
81 execute (without blocking) any matplotlib-based script which
82 calls show() at the end.
82 calls show() at the end.
83
83
84 -tk The -g/q/wthread options, and -pylab (if matplotlib is
84 -tk The -g/q/q4/wthread options, and -pylab (if matplotlib is
85 configured to use GTK, QT or WX), will normally block Tk
85 configured to use GTK, QT or WX), will normally block Tk
86 graphical interfaces. This means that when GTK, QT or WX
86 graphical interfaces. This means that when GTK, QT or WX
87 threading is active, any attempt to open a Tk GUI will result in
87 threading is active, any attempt to open a Tk GUI will result in
88 a dead window, and possibly cause the Python interpreter to
88 a dead window, and possibly cause the Python interpreter to
89 crash. An extra option, -tk, is available to address this
89 crash. An extra option, -tk, is available to address this
90 issue. It can ONLY be given as a SECOND option after any of the
90 issue. It can ONLY be given as a SECOND option after any of the
91 above (-gthread, -qthread, -wthread or -pylab).
91 above (-gthread, -qthread, q4thread, -wthread or -pylab).
92
92
93 If -tk is given, IPython will try to coordinate Tk threading
93 If -tk is given, IPython will try to coordinate Tk threading
94 with GTK, QT or WX. This is however potentially unreliable, and
94 with GTK, QT or WX. This is however potentially unreliable, and
@@ -1,3 +1,8 b''
1 2007-03-18 Fernando Perez <Fernando.Perez@colorado.edu>
2
3 * IPython/ColorANSI.py (InputTermColors.Normal): applied Nicolas
4 Pernetty's patch to improve support for (X)Emacs under Win32.
5
1 2007-03-17 Fernando Perez <Fernando.Perez@colorado.edu>
6 2007-03-17 Fernando Perez <Fernando.Perez@colorado.edu>
2
7
3 * IPython/Shell.py (hijack_wx): ipmort WX with current semantics
8 * IPython/Shell.py (hijack_wx): ipmort WX with current semantics
@@ -36,18 +36,18 b' The following special options are ONLY valid at the beginning of the command'
36 line, and not later. This is because they control the initialization of
36 line, and not later. This is because they control the initialization of
37 ipython itself, before the normal option-handling mechanism is active.
37 ipython itself, before the normal option-handling mechanism is active.
38 .TP
38 .TP
39 .B \-gthread, \-qthread, \-wthread, \-pylab
39 .B \-gthread, \-qthread, \-q4thread, \-wthread, \-pylab
40 Only ONE of these can be given, and it can only be given as the first option
40 Only ONE of these can be given, and it can only be given as the first option
41 passed to IPython (it will have no effect in any other position). They
41 passed to IPython (it will have no effect in any other position). They provide
42 provide threading support for the GTK, QT and WXWidgets toolkits, and for the
42 threading support for the GTK, QT3, QT4 and WXWidgets toolkits, and for the
43 matplotlib library.
43 matplotlib library.
44 .br
44 .br
45 .sp 1
45 .sp 1
46 With any of the first three options, IPython starts running a separate thread
46 With any of the first four options, IPython starts running a separate thread
47 for the graphical toolkit's operation, so that you can open and control
47 for the graphical toolkit's operation, so that you can open and control
48 graphical elements from within an IPython command line, without blocking. All
48 graphical elements from within an IPython command line, without blocking. All
49 three provide essentially the same functionality, respectively for GTK, QT and
49 four provide essentially the same functionality, respectively for GTK, QT3, QT4
50 WXWidgets (via their Python interfaces).
50 and WXWidgets (via their Python interfaces).
51 .br
51 .br
52 .sp 1
52 .sp 1
53 Note that with \-wthread, you can additionally use the \-wxversion option to
53 Note that with \-wthread, you can additionally use the \-wxversion option to
@@ -64,7 +64,7 b' backend requires it. It also modifies the %run command to correctly execute'
64 (without blocking) any matplotlib-based script which calls show() at the end.
64 (without blocking) any matplotlib-based script which calls show() at the end.
65 .TP
65 .TP
66 .B \-tk
66 .B \-tk
67 The \-g/q/wthread options, and \-pylab (if matplotlib is configured to use
67 The \-g/q/q4/wthread options, and \-pylab (if matplotlib is configured to use
68 GTK, QT or WX), will normally block Tk graphical interfaces. This means that
68 GTK, QT or WX), will normally block Tk graphical interfaces. This means that
69 when GTK, QT or WX threading is active, any attempt to open a Tk GUI will
69 when GTK, QT or WX threading is active, any attempt to open a Tk GUI will
70 result in a dead window, and possibly cause the Python interpreter to crash.
70 result in a dead window, and possibly cause the Python interpreter to crash.
This diff has been collapsed as it changes many lines, (3993 lines changed) Show them Hide them
@@ -1,5 +1,7 b''
1 #LyX 1.3 created this file. For more info see http://www.lyx.org/
1 #LyX 1.4.3 created this file. For more info see http://www.lyx.org/
2 \lyxformat 221
2 \lyxformat 245
3 \begin_document
4 \begin_header
3 \textclass article
5 \textclass article
4 \begin_preamble
6 \begin_preamble
5 %\usepackage{ae,aecompl}
7 %\usepackage{ae,aecompl}
@@ -51,12 +53,11 b''
51 \graphics default
53 \graphics default
52 \paperfontsize 11
54 \paperfontsize 11
53 \spacing single
55 \spacing single
54 \papersize Default
56 \papersize default
55 \paperpackage a4
57 \use_geometry true
56 \use_geometry 1
58 \use_amsmath 1
57 \use_amsmath 0
59 \cite_engine basic
58 \use_natbib 0
60 \use_bibtopic false
59 \use_numerical_citations 0
60 \paperorientation portrait
61 \paperorientation portrait
61 \leftmargin 1in
62 \leftmargin 1in
62 \topmargin 1in
63 \topmargin 1in
@@ -67,13 +68,16 b''
67 \paragraph_separation skip
68 \paragraph_separation skip
68 \defskip medskip
69 \defskip medskip
69 \quotes_language english
70 \quotes_language english
70 \quotes_times 2
71 \papercolumns 1
71 \papercolumns 1
72 \papersides 2
72 \papersides 2
73 \paperpagestyle fancy
73 \paperpagestyle fancy
74 \tracking_changes false
75 \output_changes true
76 \end_header
74
77
75 \layout Title
78 \begin_body
76
79
80 \begin_layout Title
77 IPython
81 IPython
78 \newline
82 \newline
79
83
@@ -84,33 +88,38 b' An enhanced Interactive Python'
84 \newline
88 \newline
85 User Manual, v.
89 User Manual, v.
86 __version__
90 __version__
87 \layout Author
91 \end_layout
88
92
93 \begin_layout Author
89 Fernando P�rez
94 Fernando P�rez
90 \begin_inset Foot
95 \begin_inset Foot
91 collapsed true
96 status collapsed
92
93 \layout Standard
94
97
98 \begin_layout Standard
95
99
96 \size scriptsize
100 \size scriptsize
97 Department of Applied Mathematics, University of Colorado at Boulder.
101 Department of Applied Mathematics, University of Colorado at Boulder.
98
102
99 \family typewriter
103 \family typewriter
100 <Fernando.Perez@colorado.edu>
104 <Fernando.Perez@colorado.edu>
101 \end_inset
105 \end_layout
102
106
107 \end_inset
103
108
104 \layout Standard
105
109
110 \end_layout
106
111
112 \begin_layout Standard
107 \begin_inset ERT
113 \begin_inset ERT
108 status Collapsed
114 status collapsed
115
116 \begin_layout Standard
109
117
110 \layout Standard
111
118
112 \backslash
119 \backslash
113 latex{
120 latex{
121 \end_layout
122
114 \end_inset
123 \end_inset
115
124
116
125
@@ -120,44 +129,60 b' latex{'
120
129
121
130
122 \begin_inset ERT
131 \begin_inset ERT
123 status Collapsed
132 status collapsed
133
134 \begin_layout Standard
124
135
125 \layout Standard
126 }
136 }
127 \end_inset
137 \end_layout
128
138
139 \end_inset
129
140
130 \layout Standard
131
141
142 \end_layout
132
143
144 \begin_layout Standard
133 \begin_inset ERT
145 \begin_inset ERT
134 status Open
146 status open
147
148 \begin_layout Standard
135
149
136 \layout Standard
137
150
138 \backslash
151 \backslash
139 html{
152 html{
140 \backslash
153 \backslash
141 bodytext{bgcolor=#ffffff}}
154 bodytext{bgcolor=#ffffff}}
155 \end_layout
156
142 \end_inset
157 \end_inset
143
158
144
159
145 \layout Section
160 \end_layout
146 \pagebreak_top
161
162 \begin_layout Standard
163
164 \newpage
165
166 \end_layout
167
168 \begin_layout Section
147 Overview
169 Overview
148 \layout Standard
170 \end_layout
149
171
172 \begin_layout Standard
150 One of Python's most useful features is its interactive interpreter.
173 One of Python's most useful features is its interactive interpreter.
151 This system allows very fast testing of ideas without the overhead of creating
174 This system allows very fast testing of ideas without the overhead of creating
152 test files as is typical in most programming languages.
175 test files as is typical in most programming languages.
153 However, the interpreter supplied with the standard Python distribution
176 However, the interpreter supplied with the standard Python distribution
154 is somewhat limited for extended interactive use.
177 is somewhat limited for extended interactive use.
155 \layout Standard
178 \end_layout
156
179
180 \begin_layout Standard
157 IPython is a free software project (released under the BSD license) which
181 IPython is a free software project (released under the BSD license) which
158 tries to:
182 tries to:
159 \layout Enumerate
183 \end_layout
160
184
185 \begin_layout Enumerate
161 Provide an interactive shell superior to Python's default.
186 Provide an interactive shell superior to Python's default.
162 IPython has many features for object introspection, system shell access,
187 IPython has many features for object introspection, system shell access,
163 and its own special command system for adding functionality when working
188 and its own special command system for adding functionality when working
@@ -165,30 +190,35 b" Provide an interactive shell superior to Python's default."
165 It tries to be a very efficient environment both for Python code development
190 It tries to be a very efficient environment both for Python code development
166 and for exploration of problems using Python objects (in situations like
191 and for exploration of problems using Python objects (in situations like
167 data analysis).
192 data analysis).
168 \layout Enumerate
193 \end_layout
169
194
195 \begin_layout Enumerate
170 Serve as an embeddable, ready to use interpreter for your own programs.
196 Serve as an embeddable, ready to use interpreter for your own programs.
171 IPython can be started with a single call from inside another program,
197 IPython can be started with a single call from inside another program,
172 providing access to the current namespace.
198 providing access to the current namespace.
173 This can be very useful both for debugging purposes and for situations
199 This can be very useful both for debugging purposes and for situations
174 where a blend of batch-processing and interactive exploration are needed.
200 where a blend of batch-processing and interactive exploration are needed.
175 \layout Enumerate
201 \end_layout
176
202
203 \begin_layout Enumerate
177 Offer a flexible framework which can be used as the base environment for
204 Offer a flexible framework which can be used as the base environment for
178 other systems with Python as the underlying language.
205 other systems with Python as the underlying language.
179 Specifically scientific environments like Mathematica, IDL and Matlab inspired
206 Specifically scientific environments like Mathematica, IDL and Matlab inspired
180 its design, but similar ideas can be useful in many fields.
207 its design, but similar ideas can be useful in many fields.
181 \layout Enumerate
208 \end_layout
182
209
210 \begin_layout Enumerate
183 Allow interactive testing of threaded graphical toolkits.
211 Allow interactive testing of threaded graphical toolkits.
184 IPython has support for interactive, non-blocking control of GTK, Qt and
212 IPython has support for interactive, non-blocking control of GTK, Qt and
185 WX applications via special threading flags.
213 WX applications via special threading flags.
186 The normal Python shell can only do this for Tkinter applications.
214 The normal Python shell can only do this for Tkinter applications.
187 \layout Subsection
215 \end_layout
188
216
217 \begin_layout Subsection
189 Main features
218 Main features
190 \layout Itemize
219 \end_layout
191
220
221 \begin_layout Itemize
192 Dynamic object introspection.
222 Dynamic object introspection.
193 One can access docstrings, function definition prototypes, source code,
223 One can access docstrings, function definition prototypes, source code,
194 source files and other details of any object accessible to the interpreter
224 source files and other details of any object accessible to the interpreter
@@ -201,8 +231,9 b' Dynamic object introspection.'
201 ??
231 ??
202 \family default
232 \family default
203 ' provides additional detail).
233 ' provides additional detail).
204 \layout Itemize
234 \end_layout
205
235
236 \begin_layout Itemize
206 Searching through modules and namespaces with `
237 Searching through modules and namespaces with `
207 \family typewriter
238 \family typewriter
208 *
239 *
@@ -216,19 +247,22 b' Searching through modules and namespaces with `'
216 %psearch
247 %psearch
217 \family default
248 \family default
218 command.
249 command.
219 \layout Itemize
250 \end_layout
220
251
252 \begin_layout Itemize
221 Completion in the local namespace, by typing TAB at the prompt.
253 Completion in the local namespace, by typing TAB at the prompt.
222 This works for keywords, methods, variables and files in the current directory.
254 This works for keywords, methods, variables and files in the current directory.
223 This is supported via the readline library, and full access to configuring
255 This is supported via the readline library, and full access to configuring
224 readline's behavior is provided.
256 readline's behavior is provided.
225 \layout Itemize
257 \end_layout
226
258
259 \begin_layout Itemize
227 Numbered input/output prompts with command history (persistent across sessions
260 Numbered input/output prompts with command history (persistent across sessions
228 and tied to each profile), full searching in this history and caching of
261 and tied to each profile), full searching in this history and caching of
229 all input and output.
262 all input and output.
230 \layout Itemize
263 \end_layout
231
264
265 \begin_layout Itemize
232 User-extensible `magic' commands.
266 User-extensible `magic' commands.
233 A set of commands prefixed with
267 A set of commands prefixed with
234 \family typewriter
268 \family typewriter
@@ -236,16 +270,19 b" User-extensible `magic' commands."
236 \family default
270 \family default
237 is available for controlling IPython itself and provides directory control,
271 is available for controlling IPython itself and provides directory control,
238 namespace information and many aliases to common system shell commands.
272 namespace information and many aliases to common system shell commands.
239 \layout Itemize
273 \end_layout
240
274
275 \begin_layout Itemize
241 Alias facility for defining your own system aliases.
276 Alias facility for defining your own system aliases.
242 \layout Itemize
277 \end_layout
243
278
279 \begin_layout Itemize
244 Complete system shell access.
280 Complete system shell access.
245 Lines starting with ! are passed directly to the system shell, and using
281 Lines starting with ! are passed directly to the system shell, and using
246 !! captures shell output into python variables for further use.
282 !! captures shell output into python variables for further use.
247 \layout Itemize
283 \end_layout
248
284
285 \begin_layout Itemize
249 Background execution of Python commands in a separate thread.
286 Background execution of Python commands in a separate thread.
250 IPython has an internal job manager called
287 IPython has an internal job manager called
251 \family typewriter
288 \family typewriter
@@ -256,8 +293,9 b' jobs'
256 %bg
293 %bg
257 \family default
294 \family default
258 .
295 .
259 \layout Itemize
296 \end_layout
260
297
298 \begin_layout Itemize
261 The ability to expand python variables when calling the system shell.
299 The ability to expand python variables when calling the system shell.
262 In a shell command, any python variable prefixed with
300 In a shell command, any python variable prefixed with
263 \family typewriter
301 \family typewriter
@@ -277,8 +315,9 b' $'
277 $PATH
315 $PATH
278 \family default
316 \family default
279 ).
317 ).
280 \layout Itemize
318 \end_layout
281
319
320 \begin_layout Itemize
282 Filesystem navigation, via a magic
321 Filesystem navigation, via a magic
283 \family typewriter
322 \family typewriter
284 %cd
323 %cd
@@ -288,20 +327,23 b' Filesystem navigation, via a magic'
288 %bookmark
327 %bookmark
289 \family default
328 \family default
290 ) for fast access to frequently visited directories.
329 ) for fast access to frequently visited directories.
291 \layout Itemize
330 \end_layout
292
331
332 \begin_layout Itemize
293 A lightweight persistence framework via the
333 A lightweight persistence framework via the
294 \family typewriter
334 \family typewriter
295 %store
335 %store
296 \family default
336 \family default
297 command, which allows you to save arbitrary Python variables.
337 command, which allows you to save arbitrary Python variables.
298 These get restored automatically when your session restarts.
338 These get restored automatically when your session restarts.
299 \layout Itemize
339 \end_layout
300
340
341 \begin_layout Itemize
301 Automatic indentation (optional) of code as you type (through the readline
342 Automatic indentation (optional) of code as you type (through the readline
302 library).
343 library).
303 \layout Itemize
344 \end_layout
304
345
346 \begin_layout Itemize
305 Macro system for quickly re-executing multiple lines of previous input with
347 Macro system for quickly re-executing multiple lines of previous input with
306 a single name.
348 a single name.
307 Macros can be stored persistently via
349 Macros can be stored persistently via
@@ -314,22 +356,26 b' Macro system for quickly re-executing multiple lines of previous input with'
314 \family default
356 \family default
315 .
357 .
316
358
317 \layout Itemize
359 \end_layout
318
360
361 \begin_layout Itemize
319 Session logging (you can then later use these logs as code in your programs).
362 Session logging (you can then later use these logs as code in your programs).
320 Logs can optionally timestamp all input, and also store session output
363 Logs can optionally timestamp all input, and also store session output
321 (marked as comments, so the log remains valid Python source code).
364 (marked as comments, so the log remains valid Python source code).
322 \layout Itemize
365 \end_layout
323
366
367 \begin_layout Itemize
324 Session restoring: logs can be replayed to restore a previous session to
368 Session restoring: logs can be replayed to restore a previous session to
325 the state where you left it.
369 the state where you left it.
326 \layout Itemize
370 \end_layout
327
371
372 \begin_layout Itemize
328 Verbose and colored exception traceback printouts.
373 Verbose and colored exception traceback printouts.
329 Easier to parse visually, and in verbose mode they produce a lot of useful
374 Easier to parse visually, and in verbose mode they produce a lot of useful
330 debugging information (basically a terminal version of the cgitb module).
375 debugging information (basically a terminal version of the cgitb module).
331 \layout Itemize
376 \end_layout
332
377
378 \begin_layout Itemize
333 Auto-parentheses: callable objects can be executed without parentheses:
379 Auto-parentheses: callable objects can be executed without parentheses:
334
380
335 \family typewriter
381 \family typewriter
@@ -340,8 +386,9 b' Auto-parentheses: callable objects can be executed without parentheses:'
340 `sin(3)
386 `sin(3)
341 \family default
387 \family default
342 '.
388 '.
343 \layout Itemize
389 \end_layout
344
390
391 \begin_layout Itemize
345 Auto-quoting: using `
392 Auto-quoting: using `
346 \family typewriter
393 \family typewriter
347 ,
394 ,
@@ -352,7 +399,7 b' Auto-quoting: using `'
352 \family default
399 \family default
353 ' as the first character forces auto-quoting of the rest of the line:
400 ' as the first character forces auto-quoting of the rest of the line:
354 \family typewriter
401 \family typewriter
355 `,my_function a\SpecialChar ~
402 `,my_function a\InsetSpace ~
356 b'
403 b'
357 \family default
404 \family default
358 becomes automatically
405 becomes automatically
@@ -361,7 +408,7 b" b'"
361 \family default
408 \family default
362 , while
409 , while
363 \family typewriter
410 \family typewriter
364 `;my_function a\SpecialChar ~
411 `;my_function a\InsetSpace ~
365 b'
412 b'
366 \family default
413 \family default
367 becomes
414 becomes
@@ -369,8 +416,9 b" b'"
369 `my_function("a b")'
416 `my_function("a b")'
370 \family default
417 \family default
371 .
418 .
372 \layout Itemize
419 \end_layout
373
420
421 \begin_layout Itemize
374 Extensible input syntax.
422 Extensible input syntax.
375 You can define filters that pre-process user input to simplify input in
423 You can define filters that pre-process user input to simplify input in
376 special situations.
424 special situations.
@@ -384,23 +432,26 b' Extensible input syntax.'
384 `...'
432 `...'
385 \family default
433 \family default
386 such as those from other python sessions or the standard Python documentation.
434 such as those from other python sessions or the standard Python documentation.
387 \layout Itemize
435 \end_layout
388
436
437 \begin_layout Itemize
389 Flexible configuration system.
438 Flexible configuration system.
390 It uses a configuration file which allows permanent setting of all command-line
439 It uses a configuration file which allows permanent setting of all command-line
391 options, module loading, code and file execution.
440 options, module loading, code and file execution.
392 The system allows recursive file inclusion, so you can have a base file
441 The system allows recursive file inclusion, so you can have a base file
393 with defaults and layers which load other customizations for particular
442 with defaults and layers which load other customizations for particular
394 projects.
443 projects.
395 \layout Itemize
444 \end_layout
396
445
446 \begin_layout Itemize
397 Embeddable.
447 Embeddable.
398 You can call IPython as a python shell inside your own python programs.
448 You can call IPython as a python shell inside your own python programs.
399 This can be used both for debugging code or for providing interactive abilities
449 This can be used both for debugging code or for providing interactive abilities
400 to your programs with knowledge about the local namespaces (very useful
450 to your programs with knowledge about the local namespaces (very useful
401 in debugging and data analysis situations).
451 in debugging and data analysis situations).
402 \layout Itemize
452 \end_layout
403
453
454 \begin_layout Itemize
404 Easy debugger access.
455 Easy debugger access.
405 You can set IPython to call up an enhanced version of the Python debugger
456 You can set IPython to call up an enhanced version of the Python debugger
406 (
457 (
@@ -430,8 +481,9 b' pdb'
430 \family default
481 \family default
431 has IPython-specific improvements, including tab-completion and traceback
482 has IPython-specific improvements, including tab-completion and traceback
432 coloring support.
483 coloring support.
433 \layout Itemize
484 \end_layout
434
485
486 \begin_layout Itemize
435 Profiler support.
487 Profiler support.
436 You can run single statements (similar to
488 You can run single statements (similar to
437 \family typewriter
489 \family typewriter
@@ -455,11 +507,13 b' profile'
455 `%run -p
507 `%run -p
456 \family default
508 \family default
457 ') convenient for rapid interactive work.
509 ') convenient for rapid interactive work.
458 \layout Subsection
510 \end_layout
459
511
512 \begin_layout Subsection
460 Portability and Python requirements
513 Portability and Python requirements
461 \layout Standard
514 \end_layout
462
515
516 \begin_layout Standard
463
517
464 \series bold
518 \series bold
465 Python requirements:
519 Python requirements:
@@ -468,16 +522,18 b' IPython requires with Python version 2.3 or newer.'
468 If you are still using Python 2.2 and can not upgrade, the last version
522 If you are still using Python 2.2 and can not upgrade, the last version
469 of IPython which worked with Python 2.2 was 0.6.15, so you will have to use
523 of IPython which worked with Python 2.2 was 0.6.15, so you will have to use
470 that.
524 that.
471 \layout Standard
525 \end_layout
472
526
527 \begin_layout Standard
473 IPython is developed under
528 IPython is developed under
474 \series bold
529 \series bold
475 Linux
530 Linux
476 \series default
531 \series default
477 , but it should work in any reasonable Unix-type system (tested OK under
532 , but it should work in any reasonable Unix-type system (tested OK under
478 Solaris and the *BSD family, for which a port exists thanks to Dryice Liu).
533 Solaris and the *BSD family, for which a port exists thanks to Dryice Liu).
479 \layout Standard
534 \end_layout
480
535
536 \begin_layout Standard
481
537
482 \series bold
538 \series bold
483 Mac OS X
539 Mac OS X
@@ -485,8 +541,9 b' Mac OS X'
485 : it works, apparently without any problems (thanks to Jim Boyle at Lawrence
541 : it works, apparently without any problems (thanks to Jim Boyle at Lawrence
486 Livermore for the information).
542 Livermore for the information).
487 Thanks to Andrea Riciputi, Fink support is available.
543 Thanks to Andrea Riciputi, Fink support is available.
488 \layout Standard
544 \end_layout
489
545
546 \begin_layout Standard
490
547
491 \series bold
548 \series bold
492 CygWin
549 CygWin
@@ -501,14 +558,15 b' ipythonrc'
501 configuration file if you experience problems.
558 configuration file if you experience problems.
502 If you have proper color support under cygwin, please post to the IPython
559 If you have proper color support under cygwin, please post to the IPython
503 mailing list so this issue can be resolved for all users.
560 mailing list so this issue can be resolved for all users.
504 \layout Standard
561 \end_layout
505
562
563 \begin_layout Standard
506
564
507 \series bold
565 \series bold
508 Windows
566 Windows
509 \series default
567 \series default
510 : it works well under Windows XP/2k, and I suspect NT should behave similarly.
568 : it works well under Windows XP/2k, and I suspect NT should behave similarly.
511 Section\SpecialChar ~
569 Section\InsetSpace ~
512
570
513 \begin_inset LatexCommand \ref{sub:Under-Windows}
571 \begin_inset LatexCommand \ref{sub:Under-Windows}
514
572
@@ -516,17 +574,19 b' Windows'
516
574
517 describes installation details for Windows, including some additional tools
575 describes installation details for Windows, including some additional tools
518 needed on this platform.
576 needed on this platform.
519 \layout Standard
577 \end_layout
520
578
579 \begin_layout Standard
521 Windows 9x support is present, and has been reported to work fine (at least
580 Windows 9x support is present, and has been reported to work fine (at least
522 on WinME).
581 on WinME).
523 \layout Standard
582 \end_layout
524
583
584 \begin_layout Standard
525 Note, that I have very little access to and experience with Windows development.
585 Note, that I have very little access to and experience with Windows development.
526 However, an excellent group of Win32 users (led by Ville Vainio), consistently
586 However, an excellent group of Win32 users (led by Ville Vainio), consistently
527 contribute bugfixes and platform-specific enhancements, so they more than
587 contribute bugfixes and platform-specific enhancements, so they more than
528 make up for my deficiencies on that front.
588 make up for my deficiencies on that front.
529 In fact, Win32 users report using IPython as a system shell (see Sec.\SpecialChar ~
589 In fact, Win32 users report using IPython as a system shell (see Sec.\InsetSpace ~
530
590
531 \begin_inset LatexCommand \ref{sec:IPython-as-shell}
591 \begin_inset LatexCommand \ref{sec:IPython-as-shell}
532
592
@@ -538,11 +598,13 b' Note, that I have very little access to and experience with Windows development.'
538 cmd.exe
598 cmd.exe
539 \family default
599 \family default
540 doesn't provide.
600 doesn't provide.
541 \layout Subsection
601 \end_layout
542
602
603 \begin_layout Subsection
543 Location
604 Location
544 \layout Standard
605 \end_layout
545
606
607 \begin_layout Standard
546 IPython is generously hosted at
608 IPython is generously hosted at
547 \begin_inset LatexCommand \htmlurl{http://ipython.scipy.org}
609 \begin_inset LatexCommand \htmlurl{http://ipython.scipy.org}
548
610
@@ -557,19 +619,21 b' IPython is generously hosted at'
557 \end_inset
619 \end_inset
558
620
559 ) and all of the SciPy team for their contribution.
621 ) and all of the SciPy team for their contribution.
560 \layout Section
622 \end_layout
561
562
623
624 \begin_layout Section
563 \begin_inset LatexCommand \label{sec:install}
625 \begin_inset LatexCommand \label{sec:install}
564
626
565 \end_inset
627 \end_inset
566
628
567 Installation
629 Installation
568 \layout Subsection
630 \end_layout
569
631
632 \begin_layout Subsection
570 Instant instructions
633 Instant instructions
571 \layout Standard
634 \end_layout
572
635
636 \begin_layout Standard
573 If you are of the impatient kind, under Linux/Unix simply untar/unzip the
637 If you are of the impatient kind, under Linux/Unix simply untar/unzip the
574 download, then install with
638 download, then install with
575 \family typewriter
639 \family typewriter
@@ -581,8 +645,9 b' If you are of the impatient kind, under Linux/Unix simply untar/unzip the'
581 .exe
645 .exe
582 \family default
646 \family default
583 binary installer.
647 binary installer.
584 \layout Standard
648 \end_layout
585
649
650 \begin_layout Standard
586 Then, take a look at Sections
651 Then, take a look at Sections
587 \begin_inset LatexCommand \ref{sec:good_config}
652 \begin_inset LatexCommand \ref{sec:good_config}
588
653
@@ -595,8 +660,9 b' Then, take a look at Sections'
595
660
596 for quick tips on efficient use of IPython.
661 for quick tips on efficient use of IPython.
597 You can later refer to the rest of the manual for all the gory details.
662 You can later refer to the rest of the manual for all the gory details.
598 \layout Standard
663 \end_layout
599
664
665 \begin_layout Standard
600 See the notes in sec.
666 See the notes in sec.
601
667
602 \begin_inset LatexCommand \ref{sec:upgrade}
668 \begin_inset LatexCommand \ref{sec:upgrade}
@@ -604,16 +670,19 b' See the notes in sec.'
604 \end_inset
670 \end_inset
605
671
606 for upgrading IPython versions.
672 for upgrading IPython versions.
607 \layout Subsection
673 \end_layout
608
674
675 \begin_layout Subsection
609 Detailed Unix instructions (Linux, Mac OS X, etc.)
676 Detailed Unix instructions (Linux, Mac OS X, etc.)
610 \layout Standard
677 \end_layout
611
678
679 \begin_layout Standard
612 For RPM based systems, simply install the supplied package in the usual
680 For RPM based systems, simply install the supplied package in the usual
613 manner.
681 manner.
614 If you download the tar archive, the process is:
682 If you download the tar archive, the process is:
615 \layout Enumerate
683 \end_layout
616
684
685 \begin_layout Enumerate
617 Unzip/untar the
686 Unzip/untar the
618 \family typewriter
687 \family typewriter
619 ipython-XXX.tar.gz
688 ipython-XXX.tar.gz
@@ -643,8 +712,9 b' setup.py'
643 \family default
712 \family default
644 nce you've completed the installation, you can safely remove this directory.
713 nce you've completed the installation, you can safely remove this directory.
645
714
646 \layout Enumerate
715 \end_layout
647
716
717 \begin_layout Enumerate
648 If you are installing over a previous installation of version 0.2.0 or earlier,
718 If you are installing over a previous installation of version 0.2.0 or earlier,
649 first remove your
719 first remove your
650 \family typewriter
720 \family typewriter
@@ -657,8 +727,9 b' $HOME/.ipython'
657 -upgrade
727 -upgrade
658 \family default
728 \family default
659 option and it will do this automatically for you.
729 option and it will do this automatically for you.
660 \layout Enumerate
730 \end_layout
661
731
732 \begin_layout Enumerate
662 IPython uses distutils, so you can install it by simply typing at the system
733 IPython uses distutils, so you can install it by simply typing at the system
663 prompt (don't type the
734 prompt (don't type the
664 \family typewriter
735 \family typewriter
@@ -676,22 +747,28 b' Note that this assumes you have root access to your machine.'
676 If you don't have root access or don't want IPython to go in the default
747 If you don't have root access or don't want IPython to go in the default
677 python directories, you'll need to use the
748 python directories, you'll need to use the
678 \begin_inset ERT
749 \begin_inset ERT
679 status Collapsed
750 status collapsed
751
752 \begin_layout Standard
680
753
681 \layout Standard
682
754
683 \backslash
755 \backslash
684 verb|--home|
756 verb|--home|
757 \end_layout
758
685 \end_inset
759 \end_inset
686
760
687 option (or
761 option (or
688 \begin_inset ERT
762 \begin_inset ERT
689 status Collapsed
763 status collapsed
764
765 \begin_layout Standard
690
766
691 \layout Standard
692
767
693 \backslash
768 \backslash
694 verb|--prefix|
769 verb|--prefix|
770 \end_layout
771
695 \end_inset
772 \end_inset
696
773
697 ).
774 ).
@@ -699,12 +776,15 b' verb|--prefix|'
699 \newline
776 \newline
700
777
701 \begin_inset ERT
778 \begin_inset ERT
702 status Collapsed
779 status collapsed
780
781 \begin_layout Standard
703
782
704 \layout Standard
705
783
706 \backslash
784 \backslash
707 verb|$ python setup.py install --home $HOME/local|
785 verb|$ python setup.py install --home $HOME/local|
786 \end_layout
787
708 \end_inset
788 \end_inset
709
789
710
790
@@ -719,12 +799,15 b' You can type'
719 \newline
799 \newline
720
800
721 \begin_inset ERT
801 \begin_inset ERT
722 status Collapsed
802 status collapsed
803
804 \begin_layout Standard
723
805
724 \layout Standard
725
806
726 \backslash
807 \backslash
727 verb|$ python setup.py --help|
808 verb|$ python setup.py --help|
809 \end_layout
810
728 \end_inset
811 \end_inset
729
812
730
813
@@ -733,12 +816,15 b' for more details.'
733 \newline
816 \newline
734 Note that if you change the default location for
817 Note that if you change the default location for
735 \begin_inset ERT
818 \begin_inset ERT
736 status Collapsed
819 status collapsed
820
821 \begin_layout Standard
737
822
738 \layout Standard
739
823
740 \backslash
824 \backslash
741 verb|--home|
825 verb|--home|
826 \end_layout
827
742 \end_inset
828 \end_inset
743
829
744 at installation, IPython may end up installed at a location which is not
830 at installation, IPython may end up installed at a location which is not
@@ -754,12 +840,15 b' IPython/'
754 \family default
840 \family default
755 directory ended (typically the value you give to
841 directory ended (typically the value you give to
756 \begin_inset ERT
842 \begin_inset ERT
757 status Collapsed
843 status collapsed
844
845 \begin_layout Standard
758
846
759 \layout Standard
760
847
761 \backslash
848 \backslash
762 verb|--home|
849 verb|--home|
850 \end_layout
851
763 \end_inset
852 \end_inset
764
853
765 plus
854 plus
@@ -767,11 +856,13 b' verb|--home|'
767 /lib/python
856 /lib/python
768 \family default
857 \family default
769 ).
858 ).
770 \layout Subsubsection
859 \end_layout
771
860
861 \begin_layout Subsubsection
772 Mac OSX information
862 Mac OSX information
773 \layout Standard
863 \end_layout
774
864
865 \begin_layout Standard
775 Under OSX, there is a choice you need to make.
866 Under OSX, there is a choice you need to make.
776 Apple ships its own build of Python, which lives in the core OSX filesystem
867 Apple ships its own build of Python, which lives in the core OSX filesystem
777 hierarchy.
868 hierarchy.
@@ -789,8 +880,9 b' Under OSX, there is a choice you need to make.'
789 users who favor each of the approaches.
880 users who favor each of the approaches.
790 Here I will simply list the known installation issues under OSX, along
881 Here I will simply list the known installation issues under OSX, along
791 with their solutions.
882 with their solutions.
792 \layout Standard
883 \end_layout
793
884
885 \begin_layout Standard
794 This page:
886 This page:
795 \begin_inset LatexCommand \htmlurl{http://geosci.uchicago.edu/~tobis/pylab.html}
887 \begin_inset LatexCommand \htmlurl{http://geosci.uchicago.edu/~tobis/pylab.html}
796
888
@@ -798,11 +890,13 b' This page:'
798
890
799 contains information on this topic, with additional details on how to make
891 contains information on this topic, with additional details on how to make
800 IPython and matplotlib play nicely under OSX.
892 IPython and matplotlib play nicely under OSX.
801 \layout Subsubsection*
893 \end_layout
802
894
895 \begin_layout Subsubsection*
803 GUI problems
896 GUI problems
804 \layout Standard
897 \end_layout
805
898
899 \begin_layout Standard
806 The following instructions apply to an install of IPython under OSX from
900 The following instructions apply to an install of IPython under OSX from
807 unpacking the
901 unpacking the
808 \family typewriter
902 \family typewriter
@@ -812,8 +906,9 b' The following instructions apply to an install of IPython under OSX from'
812 by Apple.
906 by Apple.
813 If you are using a fink install, fink will take care of these details for
907 If you are using a fink install, fink will take care of these details for
814 you, by installing IPython against fink's Python.
908 you, by installing IPython against fink's Python.
815 \layout Standard
909 \end_layout
816
910
911 \begin_layout Standard
817 IPython offers various forms of support for interacting with graphical applicati
912 IPython offers various forms of support for interacting with graphical applicati
818 ons from the command line, from simple Tk apps (which are in principle always
913 ons from the command line, from simple Tk apps (which are in principle always
819 supported by Python) to interactive control of WX, Qt and GTK apps.
914 supported by Python) to interactive control of WX, Qt and GTK apps.
@@ -824,8 +919,9 b' pythonw'
824 \family default
919 \family default
825 script at installation time, which takes care of coordinating things with
920 script at installation time, which takes care of coordinating things with
826 Apple's graphical environment.
921 Apple's graphical environment.
827 \layout Standard
922 \end_layout
828
923
924 \begin_layout Standard
829 So when installing under OSX, it is best to use the following command:
925 So when installing under OSX, it is best to use the following command:
830 \family typewriter
926 \family typewriter
831
927
@@ -834,12 +930,15 b' So when installing under OSX, it is best to use the following command:'
834 \family default
930 \family default
835
931
836 \begin_inset ERT
932 \begin_inset ERT
837 status Collapsed
933 status collapsed
934
935 \begin_layout Standard
838
936
839 \layout Standard
840
937
841 \backslash
938 \backslash
842 verb| $ sudo pythonw setup.py install --install-scripts=/usr/local/bin|
939 verb| $ sudo pythonw setup.py install --install-scripts=/usr/local/bin|
940 \end_layout
941
843 \end_inset
942 \end_inset
844
943
845
944
@@ -848,19 +947,23 b' verb| $ sudo pythonw setup.py install --install-scripts=/usr/local/bin|'
848 \newline
947 \newline
849
948
850 \begin_inset ERT
949 \begin_inset ERT
851 status Collapsed
950 status collapsed
951
952 \begin_layout Standard
852
953
853 \layout Standard
854
954
855 \backslash
955 \backslash
856 verb| $ sudo pythonw setup.py install --install-scripts=/usr/bin|
956 verb| $ sudo pythonw setup.py install --install-scripts=/usr/bin|
957 \end_layout
958
857 \end_inset
959 \end_inset
858
960
859
961
860 \newline
962 \newline
861 depending on where you like to keep hand-installed executables.
963 depending on where you like to keep hand-installed executables.
862 \layout Standard
964 \end_layout
863
965
966 \begin_layout Standard
864 The resulting script will have an appropriate shebang line (the first line
967 The resulting script will have an appropriate shebang line (the first line
865 in the script whic begins with
968 in the script whic begins with
866 \family typewriter
969 \family typewriter
@@ -883,16 +986,20 b' setup.py'
883 \family default
986 \family default
884 .
987 .
885
988
886 \layout Standard
989 \end_layout
887
990
991 \begin_layout Standard
888 It is also a good idea to use the special flag
992 It is also a good idea to use the special flag
889 \begin_inset ERT
993 \begin_inset ERT
890 status Collapsed
994 status collapsed
995
996 \begin_layout Standard
891
997
892 \layout Standard
893
998
894 \backslash
999 \backslash
895 verb|--install-scripts|
1000 verb|--install-scripts|
1001 \end_layout
1002
896 \end_inset
1003 \end_inset
897
1004
898 as indicated above, to ensure that the ipython scripts end up in a location
1005 as indicated above, to ensure that the ipython scripts end up in a location
@@ -911,11 +1018,13 b' $PATH'
911 $PATH
1018 $PATH
912 \family default
1019 \family default
913 , which may not be true by default).
1020 , which may not be true by default).
914 \layout Subsubsection*
1021 \end_layout
915
1022
1023 \begin_layout Subsubsection*
916 Readline problems
1024 Readline problems
917 \layout Standard
1025 \end_layout
918
1026
1027 \begin_layout Standard
919 By default, the Python version shipped by Apple does
1028 By default, the Python version shipped by Apple does
920 \emph on
1029 \emph on
921 not
1030 not
@@ -931,12 +1040,14 b' not'
931 \end_inset
1040 \end_inset
932
1041
933
1042
934 \layout Standard
1043 \end_layout
935
1044
1045 \begin_layout Standard
936 If you are using OSX 10.4 (Tiger), after installing this package you need
1046 If you are using OSX 10.4 (Tiger), after installing this package you need
937 to either:
1047 to either:
938 \layout Enumerate
1048 \end_layout
939
1049
1050 \begin_layout Enumerate
940 move
1051 move
941 \family typewriter
1052 \family typewriter
942 readline.so
1053 readline.so
@@ -950,68 +1061,80 b' readline.so'
950 /Library/Python/2.3/site-packages
1061 /Library/Python/2.3/site-packages
951 \family default
1062 \family default
952 , or
1063 , or
953 \layout Enumerate
1064 \end_layout
954
1065
1066 \begin_layout Enumerate
955 install
1067 install
956 \begin_inset LatexCommand \htmlurl{http://pythonmac.org/packages/TigerPython23Compat.pkg.zip}
1068 \begin_inset LatexCommand \htmlurl{http://pythonmac.org/packages/TigerPython23Compat.pkg.zip}
957
1069
958 \end_inset
1070 \end_inset
959
1071
960
1072
961 \layout Standard
1073 \end_layout
962
1074
1075 \begin_layout Standard
963 Users installing against Fink's Python or a properly hand-built one should
1076 Users installing against Fink's Python or a properly hand-built one should
964 not have this problem.
1077 not have this problem.
965 \layout Subsubsection*
1078 \end_layout
966
1079
1080 \begin_layout Subsubsection*
967 DarwinPorts
1081 DarwinPorts
968 \layout Standard
1082 \end_layout
969
1083
1084 \begin_layout Standard
970 I report here a message from an OSX user, who suggests an alternative means
1085 I report here a message from an OSX user, who suggests an alternative means
971 of using IPython under this operating system with good results.
1086 of using IPython under this operating system with good results.
972 Please let me know of any updates that may be useful for this section.
1087 Please let me know of any updates that may be useful for this section.
973 His message is reproduced verbatim below:
1088 His message is reproduced verbatim below:
974 \layout Quote
1089 \end_layout
975
1090
1091 \begin_layout Quote
976 From: Markus Banfi
1092 From: Markus Banfi
977 \family typewriter
1093 \family typewriter
978 <markus.banfi-AT-mospheira.net>
1094 <markus.banfi-AT-mospheira.net>
979 \layout Quote
1095 \end_layout
980
1096
1097 \begin_layout Quote
981 As a MacOS X (10.4.2) user I prefer to install software using DawinPorts instead
1098 As a MacOS X (10.4.2) user I prefer to install software using DawinPorts instead
982 of Fink.
1099 of Fink.
983 I had no problems installing ipython with DarwinPorts.
1100 I had no problems installing ipython with DarwinPorts.
984 It's just:
1101 It's just:
985 \layout Quote
1102 \end_layout
986
1103
1104 \begin_layout Quote
987
1105
988 \family typewriter
1106 \family typewriter
989 sudo port install py-ipython
1107 sudo port install py-ipython
990 \layout Quote
1108 \end_layout
991
1109
1110 \begin_layout Quote
992 It automatically resolved all dependencies (python24, readline, py-readline).
1111 It automatically resolved all dependencies (python24, readline, py-readline).
993 So far I did not encounter any problems with the DarwinPorts port of ipython.
1112 So far I did not encounter any problems with the DarwinPorts port of ipython.
994
1113
995 \layout Subsection
1114 \end_layout
996
997
1115
1116 \begin_layout Subsection
998 \begin_inset LatexCommand \label{sub:Under-Windows}
1117 \begin_inset LatexCommand \label{sub:Under-Windows}
999
1118
1000 \end_inset
1119 \end_inset
1001
1120
1002 Windows instructions
1121 Windows instructions
1003 \layout Standard
1122 \end_layout
1004
1123
1124 \begin_layout Standard
1005 Some of IPython's very useful features are:
1125 Some of IPython's very useful features are:
1006 \layout Itemize
1126 \end_layout
1007
1127
1128 \begin_layout Itemize
1008 Integrated readline support (Tab-based file, object and attribute completion,
1129 Integrated readline support (Tab-based file, object and attribute completion,
1009 input history across sessions, editable command line, etc.)
1130 input history across sessions, editable command line, etc.)
1010 \layout Itemize
1131 \end_layout
1011
1132
1133 \begin_layout Itemize
1012 Coloring of prompts, code and tracebacks.
1134 Coloring of prompts, code and tracebacks.
1013 \layout Standard
1135 \end_layout
1014
1136
1137 \begin_layout Standard
1015 These, by default, are only available under Unix-like operating systems.
1138 These, by default, are only available under Unix-like operating systems.
1016 However, thanks to Gary Bishop's work, Windows XP/2k users can also benefit
1139 However, thanks to Gary Bishop's work, Windows XP/2k users can also benefit
1017 from them.
1140 from them.
@@ -1019,8 +1142,9 b' These, by default, are only available under Unix-like operating systems.'
1019 and color support, so that IPython under Windows XP/2k can be as friendly
1142 and color support, so that IPython under Windows XP/2k can be as friendly
1020 and powerful as under Unix-like environments.
1143 and powerful as under Unix-like environments.
1021
1144
1022 \layout Standard
1145 \end_layout
1023
1146
1147 \begin_layout Standard
1024 This library, now named
1148 This library, now named
1025 \family typewriter
1149 \family typewriter
1026 PyReadline
1150 PyReadline
@@ -1028,8 +1152,9 b' PyReadline'
1028 , has been absorbed by the IPython team (J�rgen Stenarson, in particular),
1152 , has been absorbed by the IPython team (J�rgen Stenarson, in particular),
1029 and it continues to be developed with new features, as well as being distribute
1153 and it continues to be developed with new features, as well as being distribute
1030 d directly from the IPython site.
1154 d directly from the IPython site.
1031 \layout Standard
1155 \end_layout
1032
1156
1157 \begin_layout Standard
1033 The
1158 The
1034 \family typewriter
1159 \family typewriter
1035 PyReadline
1160 PyReadline
@@ -1043,8 +1168,9 b' CTypes'
1043 PyWin32
1168 PyWin32
1044 \family default
1169 \family default
1045 , so in all you need:
1170 , so in all you need:
1046 \layout Enumerate
1171 \end_layout
1047
1172
1173 \begin_layout Enumerate
1048
1174
1049 \family typewriter
1175 \family typewriter
1050 PyWin32
1176 PyWin32
@@ -1055,8 +1181,9 b' PyWin32'
1055 \end_inset
1181 \end_inset
1056
1182
1057 .
1183 .
1058 \layout Enumerate
1184 \end_layout
1059
1185
1186 \begin_layout Enumerate
1060
1187
1061 \family typewriter
1188 \family typewriter
1062 CTypes
1189 CTypes
@@ -1071,8 +1198,9 b' CTypes'
1071 must
1198 must
1072 \emph default
1199 \emph default
1073 use version 0.9.1 or newer).
1200 use version 0.9.1 or newer).
1074 \layout Enumerate
1201 \end_layout
1075
1202
1203 \begin_layout Enumerate
1076
1204
1077 \family typewriter
1205 \family typewriter
1078 PyReadline
1206 PyReadline
@@ -1085,8 +1213,9 b' PyReadline'
1085 .
1213 .
1086 That page contains further details on using and configuring the system
1214 That page contains further details on using and configuring the system
1087 to your liking.
1215 to your liking.
1088 \layout Standard
1216 \end_layout
1089
1217
1218 \begin_layout Standard
1090
1219
1091 \series bold
1220 \series bold
1092 Warning about a broken readline-like library:
1221 Warning about a broken readline-like library:
@@ -1104,11 +1233,13 b' Warning about a broken readline-like library:'
1104 and causes unpredictable crashes later.
1233 and causes unpredictable crashes later.
1105 If you wish to use IPython under Windows, you must NOT use this library,
1234 If you wish to use IPython under Windows, you must NOT use this library,
1106 which for all purposes is (at least as of version 1.6) terminally broken.
1235 which for all purposes is (at least as of version 1.6) terminally broken.
1107 \layout Subsubsection
1236 \end_layout
1108
1237
1238 \begin_layout Subsubsection
1109 Installation procedure
1239 Installation procedure
1110 \layout Standard
1240 \end_layout
1111
1241
1242 \begin_layout Standard
1112 Once you have the above installed, from the IPython download directory grab
1243 Once you have the above installed, from the IPython download directory grab
1113 the
1244 the
1114 \family typewriter
1245 \family typewriter
@@ -1125,8 +1256,9 b' ck to install.'
1125 IPython in the Windows list of applications, so you can later uninstall
1256 IPython in the Windows list of applications, so you can later uninstall
1126 it from the Control Panel.
1257 it from the Control Panel.
1127
1258
1128 \layout Standard
1259 \end_layout
1129
1260
1261 \begin_layout Standard
1130 IPython tries to install the configuration information in a directory named
1262 IPython tries to install the configuration information in a directory named
1131
1263
1132 \family typewriter
1264 \family typewriter
@@ -1168,19 +1300,23 b' sys.path'
1168 import
1300 import
1169 \family default
1301 \family default
1170 statements.
1302 statements.
1171 \layout Paragraph
1303 \end_layout
1172
1304
1305 \begin_layout Paragraph
1173 Upgrading
1306 Upgrading
1174 \layout Standard
1307 \end_layout
1175
1308
1309 \begin_layout Standard
1176 For an IPython upgrade, you should first uninstall the previous version.
1310 For an IPython upgrade, you should first uninstall the previous version.
1177 This will ensure that all files and directories (such as the documentation)
1311 This will ensure that all files and directories (such as the documentation)
1178 which carry embedded version strings in their names are properly removed.
1312 which carry embedded version strings in their names are properly removed.
1179 \layout Paragraph
1313 \end_layout
1180
1314
1315 \begin_layout Paragraph
1181 Manual installation under Win32
1316 Manual installation under Win32
1182 \layout Standard
1317 \end_layout
1183
1318
1319 \begin_layout Standard
1184 In case the automatic installer does not work for some reason, you can download
1320 In case the automatic installer does not work for some reason, you can download
1185 the
1321 the
1186 \family typewriter
1322 \family typewriter
@@ -1199,23 +1335,25 b' ipython-XXX.tar.gz'
1199 \family default
1335 \family default
1200 .
1336 .
1201
1337
1202 \layout Standard
1338 \end_layout
1203
1339
1340 \begin_layout Standard
1204 After the installation, run the supplied
1341 After the installation, run the supplied
1205 \family typewriter
1342 \family typewriter
1206 win32_manual_post_install.py
1343 win32_manual_post_install.py
1207 \family default
1344 \family default
1208 script, which creates the necessary Start Menu shortcuts for you.
1345 script, which creates the necessary Start Menu shortcuts for you.
1209 \layout Subsection
1346 \end_layout
1210
1211
1347
1348 \begin_layout Subsection
1212 \begin_inset LatexCommand \label{sec:upgrade}
1349 \begin_inset LatexCommand \label{sec:upgrade}
1213
1350
1214 \end_inset
1351 \end_inset
1215
1352
1216 Upgrading from a previous version
1353 Upgrading from a previous version
1217 \layout Standard
1354 \end_layout
1218
1355
1356 \begin_layout Standard
1219 If you are upgrading from a previous version of IPython, after doing the
1357 If you are upgrading from a previous version of IPython, after doing the
1220 routine installation described above, you should call IPython with the
1358 routine installation described above, you should call IPython with the
1221
1359
@@ -1229,8 +1367,9 b' If you are upgrading from a previous version of IPython, after doing the'
1229 made into the new files.
1367 made into the new files.
1230 It is a good idea to do this as there may be new options available in the
1368 It is a good idea to do this as there may be new options available in the
1231 new configuration files which you will not have.
1369 new configuration files which you will not have.
1232 \layout Standard
1370 \end_layout
1233
1371
1372 \begin_layout Standard
1234 Under Windows, if you don't know how to call python scripts with arguments
1373 Under Windows, if you don't know how to call python scripts with arguments
1235 from a command line, simply delete the old config directory and IPython
1374 from a command line, simply delete the old config directory and IPython
1236 will make a new one.
1375 will make a new one.
@@ -1253,35 +1392,40 b' Program Files'
1253 IPython
1392 IPython
1254 \backslash
1393 \backslash
1255 _ipython.
1394 _ipython.
1256 \layout Section
1395 \end_layout
1257
1258
1396
1397 \begin_layout Section
1259 \begin_inset LatexCommand \label{sec:good_config}
1398 \begin_inset LatexCommand \label{sec:good_config}
1260
1399
1261 \end_inset
1400 \end_inset
1262
1401
1263
1402
1264 \begin_inset OptArg
1403 \begin_inset OptArg
1265 collapsed true
1404 status collapsed
1266
1267 \layout Standard
1268
1405
1406 \begin_layout Standard
1269 Initial configuration
1407 Initial configuration
1270 \begin_inset ERT
1408 \begin_inset ERT
1271 status Collapsed
1409 status collapsed
1410
1411 \begin_layout Standard
1272
1412
1273 \layout Standard
1274
1413
1275 \backslash
1414 \backslash
1276 ldots
1415 ldots
1416 \end_layout
1417
1277 \end_inset
1418 \end_inset
1278
1419
1279
1420
1421 \end_layout
1422
1280 \end_inset
1423 \end_inset
1281
1424
1282 Initial configuration of your environment
1425 Initial configuration of your environment
1283 \layout Standard
1426 \end_layout
1284
1427
1428 \begin_layout Standard
1285 This section will help you set various things in your environment for your
1429 This section will help you set various things in your environment for your
1286 IPython sessions to be as efficient as possible.
1430 IPython sessions to be as efficient as possible.
1287 All of IPython's configuration information, along with several example
1431 All of IPython's configuration information, along with several example
@@ -1299,8 +1443,9 b' IPYTHONDIR'
1299 -ipythondir
1443 -ipythondir
1300 \family default
1444 \family default
1301 .
1445 .
1302 \layout Standard
1446 \end_layout
1303
1447
1448 \begin_layout Standard
1304 If all goes well, the first time you run IPython it should automatically
1449 If all goes well, the first time you run IPython it should automatically
1305 create a user copy of the config directory for you, based on its builtin
1450 create a user copy of the config directory for you, based on its builtin
1306 defaults.
1451 defaults.
@@ -1332,16 +1477,17 b' ipythonrc'
1332 .
1477 .
1333 Here we discuss the basic things you will want to make sure things are
1478 Here we discuss the basic things you will want to make sure things are
1334 working properly from the beginning.
1479 working properly from the beginning.
1335 \layout Subsection
1480 \end_layout
1336
1337
1481
1482 \begin_layout Subsection
1338 \begin_inset LatexCommand \label{sec:help-access}
1483 \begin_inset LatexCommand \label{sec:help-access}
1339
1484
1340 \end_inset
1485 \end_inset
1341
1486
1342 Access to the Python help system
1487 Access to the Python help system
1343 \layout Standard
1488 \end_layout
1344
1489
1490 \begin_layout Standard
1345 This is true for Python in general (not just for IPython): you should have
1491 This is true for Python in general (not just for IPython): you should have
1346 an environment variable called
1492 an environment variable called
1347 \family typewriter
1493 \family typewriter
@@ -1354,35 +1500,41 b' PYTHONDOCS'
1354 \family default
1500 \family default
1355 , check your local details or ask your systems administrator.
1501 , check your local details or ask your systems administrator.
1356
1502
1357 \layout Standard
1503 \end_layout
1358
1504
1505 \begin_layout Standard
1359 This is the directory which holds the HTML version of the Python manuals.
1506 This is the directory which holds the HTML version of the Python manuals.
1360 Unfortunately it seems that different Linux distributions package these
1507 Unfortunately it seems that different Linux distributions package these
1361 files differently, so you may have to look around a bit.
1508 files differently, so you may have to look around a bit.
1362 Below I show the contents of this directory on my system for reference:
1509 Below I show the contents of this directory on my system for reference:
1363 \layout Standard
1510 \end_layout
1364
1511
1512 \begin_layout Standard
1365
1513
1366 \family typewriter
1514 \family typewriter
1367 [html]> ls
1515 [html]> ls
1368 \newline
1516 \newline
1369 about.dat acks.html dist/ ext/ index.html lib/ modindex.html stdabout.dat tut/
1517 about.dat acks.html dist/ ext/ index.html lib/ modindex.html stdabout.dat
1370 about.html api/ doc/ icons/ inst/ mac/ ref/ style.css
1518 tut/ about.html api/ doc/ icons/ inst/ mac/ ref/ style.css
1371 \layout Standard
1519 \end_layout
1372
1520
1521 \begin_layout Standard
1373 You should really make sure this variable is correctly set so that Python's
1522 You should really make sure this variable is correctly set so that Python's
1374 pydoc-based help system works.
1523 pydoc-based help system works.
1375 It is a powerful and convenient system with full access to the Python manuals
1524 It is a powerful and convenient system with full access to the Python manuals
1376 and all modules accessible to you.
1525 and all modules accessible to you.
1377 \layout Standard
1526 \end_layout
1378
1527
1528 \begin_layout Standard
1379 Under Windows it seems that pydoc finds the documentation automatically,
1529 Under Windows it seems that pydoc finds the documentation automatically,
1380 so no extra setup appears necessary.
1530 so no extra setup appears necessary.
1381 \layout Subsection
1531 \end_layout
1382
1532
1533 \begin_layout Subsection
1383 Editor
1534 Editor
1384 \layout Standard
1535 \end_layout
1385
1536
1537 \begin_layout Standard
1386 The
1538 The
1387 \family typewriter
1539 \family typewriter
1388 %edit
1540 %edit
@@ -1415,8 +1567,9 b' Emacs'
1415 This way you can edit multi-line code quickly and with the power of a real
1567 This way you can edit multi-line code quickly and with the power of a real
1416 editor right inside IPython.
1568 editor right inside IPython.
1417
1569
1418 \layout Standard
1570 \end_layout
1419
1571
1572 \begin_layout Standard
1420 If you are a dedicated
1573 If you are a dedicated
1421 \family typewriter
1574 \family typewriter
1422 Emacs
1575 Emacs
@@ -1450,73 +1603,88 b' The code below, supplied by Francois Pinard, can then be used in your'
1450 .emacs
1603 .emacs
1451 \family default
1604 \family default
1452 file to enable the server:
1605 file to enable the server:
1453 \layout Standard
1606 \end_layout
1454
1607
1608 \begin_layout Standard
1455
1609
1456 \family typewriter
1610 \family typewriter
1457 (defvar server-buffer-clients)
1611 (defvar server-buffer-clients)
1458 \newline
1612 \newline
1459 (when (and (fboundp 'server-start) (string-equal (getenv "TERM") 'xterm))
1613 (when (and (fboundp 'server-start) (string-equal
1614 (getenv "TERM") 'xterm))
1460 \newline
1615 \newline
1461
1616
1462 \begin_inset ERT
1617 \begin_inset ERT
1463 status Collapsed
1618 status collapsed
1619
1620 \begin_layout Standard
1464
1621
1465 \layout Standard
1466
1622
1467 \backslash
1623 \backslash
1468 hspace*{0mm}
1624 hspace*{0mm}
1625 \end_layout
1626
1469 \end_inset
1627 \end_inset
1470
1628
1471 \SpecialChar ~
1629 \InsetSpace ~
1472 \SpecialChar ~
1630 \InsetSpace ~
1473 (server-start)
1631 (server-start)
1474 \newline
1632 \newline
1475
1633
1476 \begin_inset ERT
1634 \begin_inset ERT
1477 status Collapsed
1635 status collapsed
1636
1637 \begin_layout Standard
1478
1638
1479 \layout Standard
1480
1639
1481 \backslash
1640 \backslash
1482 hspace*{0mm}
1641 hspace*{0mm}
1642 \end_layout
1643
1483 \end_inset
1644 \end_inset
1484
1645
1485 \SpecialChar ~
1646 \InsetSpace ~
1486 \SpecialChar ~
1647 \InsetSpace ~
1487 (defun fp-kill-server-with-buffer-routine ()
1648 (defun fp-kill-server-with-buffer-routine ()
1488 \newline
1649 \newline
1489
1650
1490 \begin_inset ERT
1651 \begin_inset ERT
1491 status Collapsed
1652 status collapsed
1653
1654 \begin_layout Standard
1492
1655
1493 \layout Standard
1494
1656
1495 \backslash
1657 \backslash
1496 hspace*{0mm}
1658 hspace*{0mm}
1659 \end_layout
1660
1497 \end_inset
1661 \end_inset
1498
1662
1499 \SpecialChar ~
1663 \InsetSpace ~
1500 \SpecialChar ~
1664 \InsetSpace ~
1501 \SpecialChar ~
1665 \InsetSpace ~
1502 \SpecialChar ~
1666 \InsetSpace ~
1503 (and server-buffer-clients (server-done)))
1667 (and server-buffer-clients (server-done)))
1504 \newline
1668 \newline
1505
1669
1506 \begin_inset ERT
1670 \begin_inset ERT
1507 status Collapsed
1671 status collapsed
1672
1673 \begin_layout Standard
1508
1674
1509 \layout Standard
1510
1675
1511 \backslash
1676 \backslash
1512 hspace*{0mm}
1677 hspace*{0mm}
1678 \end_layout
1679
1513 \end_inset
1680 \end_inset
1514
1681
1515 \SpecialChar ~
1682 \InsetSpace ~
1516 \SpecialChar ~
1683 \InsetSpace ~
1517 (add-hook 'kill-buffer-hook 'fp-kill-server-with-buffer-routine))
1684 (add-hook 'kill-buffer-hook 'fp-kill-server-with-buffer-routine))
1518 \layout Standard
1685 \end_layout
1519
1686
1687 \begin_layout Standard
1520 You can also set the value of this editor via the commmand-line option '-
1688 You can also set the value of this editor via the commmand-line option '-
1521 \family typewriter
1689 \family typewriter
1522 editor'
1690 editor'
@@ -1529,11 +1697,13 b' ipythonrc'
1529 This is useful if you wish to use specifically for IPython an editor different
1697 This is useful if you wish to use specifically for IPython an editor different
1530 from your typical default (and for Windows users who tend to use fewer
1698 from your typical default (and for Windows users who tend to use fewer
1531 environment variables).
1699 environment variables).
1532 \layout Subsection
1700 \end_layout
1533
1701
1702 \begin_layout Subsection
1534 Color
1703 Color
1535 \layout Standard
1704 \end_layout
1536
1705
1706 \begin_layout Standard
1537 The default IPython configuration has most bells and whistles turned on
1707 The default IPython configuration has most bells and whistles turned on
1538 (they're pretty safe).
1708 (they're pretty safe).
1539 But there's one that
1709 But there's one that
@@ -1545,18 +1715,22 b' may'
1545 This is very useful, since IPython can show prompts and exception tracebacks
1715 This is very useful, since IPython can show prompts and exception tracebacks
1546 with various colors, display syntax-highlighted source code, and in general
1716 with various colors, display syntax-highlighted source code, and in general
1547 make it easier to visually parse information.
1717 make it easier to visually parse information.
1548 \layout Standard
1718 \end_layout
1549
1719
1720 \begin_layout Standard
1550 The following terminals seem to handle the color sequences fine:
1721 The following terminals seem to handle the color sequences fine:
1551 \layout Itemize
1722 \end_layout
1552
1723
1724 \begin_layout Itemize
1553 Linux main text console, KDE Konsole, Gnome Terminal, E-term, rxvt, xterm.
1725 Linux main text console, KDE Konsole, Gnome Terminal, E-term, rxvt, xterm.
1554 \layout Itemize
1726 \end_layout
1555
1727
1728 \begin_layout Itemize
1556 CDE terminal (tested under Solaris).
1729 CDE terminal (tested under Solaris).
1557 This one boldfaces light colors.
1730 This one boldfaces light colors.
1558 \layout Itemize
1731 \end_layout
1559
1732
1733 \begin_layout Itemize
1560 (X)Emacs buffers.
1734 (X)Emacs buffers.
1561 See sec.
1735 See sec.
1562 \begin_inset LatexCommand \ref{sec:emacs}
1736 \begin_inset LatexCommand \ref{sec:emacs}
@@ -1564,36 +1738,41 b' CDE terminal (tested under Solaris).'
1564 \end_inset
1738 \end_inset
1565
1739
1566 for more details on using IPython with (X)Emacs.
1740 for more details on using IPython with (X)Emacs.
1567 \layout Itemize
1741 \end_layout
1568
1742
1743 \begin_layout Itemize
1569 A Windows (XP/2k) command prompt
1744 A Windows (XP/2k) command prompt
1570 \emph on
1745 \emph on
1571 with Gary Bishop's support extensions
1746 with Gary Bishop's support extensions
1572 \emph default
1747 \emph default
1573 .
1748 .
1574 Gary's extensions are discussed in Sec.\SpecialChar ~
1749 Gary's extensions are discussed in Sec.\InsetSpace ~
1575
1750
1576 \begin_inset LatexCommand \ref{sub:Under-Windows}
1751 \begin_inset LatexCommand \ref{sub:Under-Windows}
1577
1752
1578 \end_inset
1753 \end_inset
1579
1754
1580 .
1755 .
1581 \layout Itemize
1756 \end_layout
1582
1757
1758 \begin_layout Itemize
1583 A Windows (XP/2k) CygWin shell.
1759 A Windows (XP/2k) CygWin shell.
1584 Although some users have reported problems; it is not clear whether there
1760 Although some users have reported problems; it is not clear whether there
1585 is an issue for everyone or only under specific configurations.
1761 is an issue for everyone or only under specific configurations.
1586 If you have full color support under cygwin, please post to the IPython
1762 If you have full color support under cygwin, please post to the IPython
1587 mailing list so this issue can be resolved for all users.
1763 mailing list so this issue can be resolved for all users.
1588 \layout Standard
1764 \end_layout
1589
1765
1766 \begin_layout Standard
1590 These have shown problems:
1767 These have shown problems:
1591 \layout Itemize
1768 \end_layout
1592
1769
1770 \begin_layout Itemize
1593 Windows command prompt in WinXP/2k logged into a Linux machine via telnet
1771 Windows command prompt in WinXP/2k logged into a Linux machine via telnet
1594 or ssh.
1772 or ssh.
1595 \layout Itemize
1773 \end_layout
1596
1774
1775 \begin_layout Itemize
1597 Windows native command prompt in WinXP/2k,
1776 Windows native command prompt in WinXP/2k,
1598 \emph on
1777 \emph on
1599 without
1778 without
@@ -1601,11 +1780,13 b' without'
1601 Gary Bishop's extensions.
1780 Gary Bishop's extensions.
1602 Once Gary's readline library is installed, the normal WinXP/2k command
1781 Once Gary's readline library is installed, the normal WinXP/2k command
1603 prompt works perfectly.
1782 prompt works perfectly.
1604 \layout Standard
1783 \end_layout
1605
1784
1785 \begin_layout Standard
1606 Currently the following color schemes are available:
1786 Currently the following color schemes are available:
1607 \layout Itemize
1787 \end_layout
1608
1788
1789 \begin_layout Itemize
1609
1790
1610 \family typewriter
1791 \family typewriter
1611 NoColor
1792 NoColor
@@ -1620,8 +1801,9 b' NoColor'
1620
1801
1621 strings).
1802 strings).
1622 This 'scheme' is thus fully safe to use in any terminal.
1803 This 'scheme' is thus fully safe to use in any terminal.
1623 \layout Itemize
1804 \end_layout
1624
1805
1806 \begin_layout Itemize
1625
1807
1626 \family typewriter
1808 \family typewriter
1627 Linux
1809 Linux
@@ -1630,8 +1812,9 b' Linux'
1630 fonts.
1812 fonts.
1631 It uses bright colors for information, so it is difficult to read if you
1813 It uses bright colors for information, so it is difficult to read if you
1632 have a light colored background.
1814 have a light colored background.
1633 \layout Itemize
1815 \end_layout
1634
1816
1817 \begin_layout Itemize
1635
1818
1636 \family typewriter
1819 \family typewriter
1637 LightBG
1820 LightBG
@@ -1642,16 +1825,19 b' Linux'
1642 \family default
1825 \family default
1643 scheme but darker.
1826 scheme but darker.
1644 It is easy to read in terminals with light backgrounds.
1827 It is easy to read in terminals with light backgrounds.
1645 \layout Standard
1828 \end_layout
1646
1829
1830 \begin_layout Standard
1647 IPython uses colors for two main groups of things: prompts and tracebacks
1831 IPython uses colors for two main groups of things: prompts and tracebacks
1648 which are directly printed to the terminal, and the object introspection
1832 which are directly printed to the terminal, and the object introspection
1649 system which passes large sets of data through a pager.
1833 system which passes large sets of data through a pager.
1650 \layout Subsubsection
1834 \end_layout
1651
1835
1836 \begin_layout Subsubsection
1652 Input/Output prompts and exception tracebacks
1837 Input/Output prompts and exception tracebacks
1653 \layout Standard
1838 \end_layout
1654
1839
1840 \begin_layout Standard
1655 You can test whether the colored prompts and tracebacks work on your system
1841 You can test whether the colored prompts and tracebacks work on your system
1656 interactively by typing
1842 interactively by typing
1657 \family typewriter
1843 \family typewriter
@@ -1685,8 +1871,9 b" this means that your terminal doesn't properly handle color escape sequences."
1685 \family default
1871 \family default
1686 '.
1872 '.
1687
1873
1688 \layout Standard
1874 \end_layout
1689
1875
1876 \begin_layout Standard
1690 You can try using a different terminal emulator program (Emacs users, see
1877 You can try using a different terminal emulator program (Emacs users, see
1691 below).
1878 below).
1692 To permanently set your color preferences, edit the file
1879 To permanently set your color preferences, edit the file
@@ -1698,11 +1885,13 b' and set the'
1698 colors
1885 colors
1699 \family default
1886 \family default
1700 option to the desired value.
1887 option to the desired value.
1701 \layout Subsubsection
1888 \end_layout
1702
1889
1890 \begin_layout Subsubsection
1703 Object details (types, docstrings, source code, etc.)
1891 Object details (types, docstrings, source code, etc.)
1704 \layout Standard
1892 \end_layout
1705
1893
1894 \begin_layout Standard
1706 IPython has a set of special functions for studying the objects you are
1895 IPython has a set of special functions for studying the objects you are
1707 working with, discussed in detail in Sec.
1896 working with, discussed in detail in Sec.
1708
1897
@@ -1736,15 +1925,17 b' more'
1736 more
1925 more
1737 \family default
1926 \family default
1738 simply can not understand colored text correctly.
1927 simply can not understand colored text correctly.
1739 \layout Standard
1928 \end_layout
1740
1929
1930 \begin_layout Standard
1741 In order to configure
1931 In order to configure
1742 \family typewriter
1932 \family typewriter
1743 less
1933 less
1744 \family default
1934 \family default
1745 as your default pager, do the following:
1935 as your default pager, do the following:
1746 \layout Enumerate
1936 \end_layout
1747
1937
1938 \begin_layout Enumerate
1748 Set the environment
1939 Set the environment
1749 \family typewriter
1940 \family typewriter
1750 PAGER
1941 PAGER
@@ -1754,8 +1945,9 b' PAGER'
1754 less
1945 less
1755 \family default
1946 \family default
1756 .
1947 .
1757 \layout Enumerate
1948 \end_layout
1758
1949
1950 \begin_layout Enumerate
1759 Set the environment
1951 Set the environment
1760 \family typewriter
1952 \family typewriter
1761 LESS
1953 LESS
@@ -1775,8 +1967,9 b' less'
1775 \family default
1967 \family default
1776 to properly interpret control sequences, which is how color information
1968 to properly interpret control sequences, which is how color information
1777 is given to your terminal.
1969 is given to your terminal.
1778 \layout Standard
1970 \end_layout
1779
1971
1972 \begin_layout Standard
1780 For the
1973 For the
1781 \family typewriter
1974 \family typewriter
1782 csh
1975 csh
@@ -1790,36 +1983,41 b' tcsh'
1790 ~/.cshrc
1983 ~/.cshrc
1791 \family default
1984 \family default
1792 file the lines:
1985 file the lines:
1793 \layout Standard
1986 \end_layout
1794
1987
1988 \begin_layout Standard
1795
1989
1796 \family typewriter
1990 \family typewriter
1797 setenv PAGER less
1991 setenv PAGER less
1798 \newline
1992 \newline
1799 setenv LESS -r
1993 setenv LESS -r
1800 \layout Standard
1994 \end_layout
1801
1995
1996 \begin_layout Standard
1802 There is similar syntax for other Unix shells, look at your system documentation
1997 There is similar syntax for other Unix shells, look at your system documentation
1803 for details.
1998 for details.
1804 \layout Standard
1999 \end_layout
1805
2000
2001 \begin_layout Standard
1806 If you are on a system which lacks proper data pagers (such as Windows),
2002 If you are on a system which lacks proper data pagers (such as Windows),
1807 IPython will use a very limited builtin pager.
2003 IPython will use a very limited builtin pager.
1808 \layout Subsection
2004 \end_layout
1809
1810
2005
2006 \begin_layout Subsection
1811 \begin_inset LatexCommand \label{sec:emacs}
2007 \begin_inset LatexCommand \label{sec:emacs}
1812
2008
1813 \end_inset
2009 \end_inset
1814
2010
1815 (X)Emacs configuration
2011 (X)Emacs configuration
1816 \layout Standard
2012 \end_layout
1817
2013
2014 \begin_layout Standard
1818 Thanks to the work of Alexander Schmolck and Prabhu Ramachandran, currently
2015 Thanks to the work of Alexander Schmolck and Prabhu Ramachandran, currently
1819 (X)Emacs and IPython get along very well.
2016 (X)Emacs and IPython get along very well.
1820
2017
1821 \layout Standard
2018 \end_layout
1822
2019
2020 \begin_layout Standard
1823
2021
1824 \series bold
2022 \series bold
1825 Important note:
2023 Important note:
@@ -1844,50 +2042,58 b' M-x py-version'
1844 \family default
2042 \family default
1845 .
2043 .
1846 Versions 4.68 and newer contain the necessary fixes for proper IPython support.
2044 Versions 4.68 and newer contain the necessary fixes for proper IPython support.
1847 \layout Standard
2045 \end_layout
1848
2046
2047 \begin_layout Standard
1849 The file
2048 The file
1850 \family typewriter
2049 \family typewriter
1851 ipython.el
2050 ipython.el
1852 \family default
2051 \family default
1853 is included with the IPython distribution, in the documentation directory
2052 is included with the IPython distribution, in the documentation directory
1854 (where this manual resides in PDF and HTML formats).
2053 (where this manual resides in PDF and HTML formats).
1855 \layout Standard
2054 \end_layout
1856
2055
2056 \begin_layout Standard
1857 Once you put these files in your Emacs path, all you need in your
2057 Once you put these files in your Emacs path, all you need in your
1858 \family typewriter
2058 \family typewriter
1859 .emacs
2059 .emacs
1860 \family default
2060 \family default
1861 file is:
2061 file is:
1862 \layout LyX-Code
2062 \end_layout
1863
2063
2064 \begin_layout LyX-Code
1864 (require 'ipython)
2065 (require 'ipython)
1865 \layout Standard
2066 \end_layout
1866
2067
2068 \begin_layout Standard
1867 This should give you full support for executing code snippets via IPython,
2069 This should give you full support for executing code snippets via IPython,
1868 opening IPython as your Python shell via
2070 opening IPython as your Python shell via
1869 \family typewriter
2071 \family typewriter
1870 C-c\SpecialChar ~
2072 C-c\InsetSpace ~
1871 !
2073 !
1872 \family default
2074 \family default
1873 , etc.
2075 , etc.
1874
2076
1875 \layout Standard
2077 \end_layout
1876
2078
2079 \begin_layout Standard
1877 If you happen to get garbage instead of colored prompts as described in
2080 If you happen to get garbage instead of colored prompts as described in
1878 the previous section, you may need to set also in your
2081 the previous section, you may need to set also in your
1879 \family typewriter
2082 \family typewriter
1880 .emacs
2083 .emacs
1881 \family default
2084 \family default
1882 file:
2085 file:
1883 \layout LyX-Code
2086 \end_layout
1884
2087
2088 \begin_layout LyX-Code
1885 (setq ansi-color-for-comint-mode t)
2089 (setq ansi-color-for-comint-mode t)
1886 \layout Subsubsection*
2090 \end_layout
1887
2091
2092 \begin_layout Subsubsection*
1888 Notes
2093 Notes
1889 \layout Itemize
2094 \end_layout
1890
2095
2096 \begin_layout Itemize
1891 There is one caveat you should be aware of: you must start the IPython shell
2097 There is one caveat you should be aware of: you must start the IPython shell
1892
2098
1893 \emph on
2099 \emph on
@@ -1895,31 +2101,35 b' before'
1895 \emph default
2101 \emph default
1896 attempting to execute any code regions via
2102 attempting to execute any code regions via
1897 \family typewriter
2103 \family typewriter
1898 C-c\SpecialChar ~
2104 C-c\InsetSpace ~
1899 |
2105 |
1900 \family default
2106 \family default
1901 .
2107 .
1902 Simply type
2108 Simply type
1903 \family typewriter
2109 \family typewriter
1904 C-c\SpecialChar ~
2110 C-c\InsetSpace ~
1905 !
2111 !
1906 \family default
2112 \family default
1907 to start IPython before passing any code regions to the interpreter, and
2113 to start IPython before passing any code regions to the interpreter, and
1908 you shouldn't experience any problems.
2114 you shouldn't experience any problems.
1909 \newline
2115 \newline
1910 This is due to a bug in Python itself, which has been fixed for Python 2.3,
2116 This is due to a bug in Python itself,
1911 but exists as of Python 2.2.2 (reported as SF bug [ 737947 ]).
2117 which has been fixed for Python 2.3, but exists as of Python 2.2.2 (reported
1912 \layout Itemize
2118 as SF bug [ 737947 ]).
2119 \end_layout
1913
2120
2121 \begin_layout Itemize
1914 The (X)Emacs support is maintained by Alexander Schmolck, so all comments/reques
2122 The (X)Emacs support is maintained by Alexander Schmolck, so all comments/reques
1915 ts should be directed to him through the IPython mailing lists.
2123 ts should be directed to him through the IPython mailing lists.
1916
2124
1917 \layout Itemize
2125 \end_layout
1918
2126
2127 \begin_layout Itemize
1919 This code is still somewhat experimental so it's a bit rough around the
2128 This code is still somewhat experimental so it's a bit rough around the
1920 edges (although in practice, it works quite well).
2129 edges (although in practice, it works quite well).
1921 \layout Itemize
2130 \end_layout
1922
2131
2132 \begin_layout Itemize
1923 Be aware that if you customize
2133 Be aware that if you customize
1924 \family typewriter
2134 \family typewriter
1925 py-python-command
2135 py-python-command
@@ -1929,16 +2139,17 b' py-python-command'
1929 ipython.el
2139 ipython.el
1930 \family default
2140 \family default
1931 does (because loading the customization variables comes later).
2141 does (because loading the customization variables comes later).
1932 \layout Section
2142 \end_layout
1933
1934
2143
2144 \begin_layout Section
1935 \begin_inset LatexCommand \label{sec:quick_tips}
2145 \begin_inset LatexCommand \label{sec:quick_tips}
1936
2146
1937 \end_inset
2147 \end_inset
1938
2148
1939 Quick tips
2149 Quick tips
1940 \layout Standard
2150 \end_layout
1941
2151
2152 \begin_layout Standard
1942 IPython can be used as an improved replacement for the Python prompt, and
2153 IPython can be used as an improved replacement for the Python prompt, and
1943 for that you don't really need to read any more of this manual.
2154 for that you don't really need to read any more of this manual.
1944 But in this section we'll try to summarize a few tips on how to make the
2155 But in this section we'll try to summarize a few tips on how to make the
@@ -1946,8 +2157,9 b' IPython can be used as an improved replacement for the Python prompt, and'
1946 things you might miss in the rest of the manual (which is getting long).
2157 things you might miss in the rest of the manual (which is getting long).
1947 We'll give references to parts in the manual which provide more detail
2158 We'll give references to parts in the manual which provide more detail
1948 when appropriate.
2159 when appropriate.
1949 \layout Standard
2160 \end_layout
1950
2161
2162 \begin_layout Standard
1951 The following article by Jeremy Jones provides an introductory tutorial
2163 The following article by Jeremy Jones provides an introductory tutorial
1952 about IPython:
2164 about IPython:
1953 \newline
2165 \newline
@@ -1957,8 +2169,9 b' The following article by Jeremy Jones provides an introductory tutorial'
1957 \end_inset
2169 \end_inset
1958
2170
1959
2171
1960 \layout Itemize
2172 \end_layout
1961
2173
2174 \begin_layout Itemize
1962 The TAB key.
2175 The TAB key.
1963 TAB-completion, especially for attributes, is a convenient way to explore
2176 TAB-completion, especially for attributes, is a convenient way to explore
1964 the structure of any object you're dealing with.
2177 the structure of any object you're dealing with.
@@ -1977,8 +2190,9 b' object_name.<TAB>'
1977 IPython's alias system allows you to do from within IPython many of the
2190 IPython's alias system allows you to do from within IPython many of the
1978 things you normally would need the system shell for.
2191 things you normally would need the system shell for.
1979
2192
1980 \layout Itemize
2193 \end_layout
1981
2194
2195 \begin_layout Itemize
1982 Explore your objects.
2196 Explore your objects.
1983 Typing
2197 Typing
1984 \family typewriter
2198 \family typewriter
@@ -2017,8 +2231,9 b' object_name?'
2017 \end_inset
2231 \end_inset
2018
2232
2019 for more.
2233 for more.
2020 \layout Itemize
2234 \end_layout
2021
2235
2236 \begin_layout Itemize
2022 The
2237 The
2023 \family typewriter
2238 \family typewriter
2024 %run
2239 %run
@@ -2083,20 +2298,22 b' debugger ('
2083 \family default
2298 \family default
2084 can be used as the main tool for efficient interactive development of code
2299 can be used as the main tool for efficient interactive development of code
2085 which you write in your editor of choice.
2300 which you write in your editor of choice.
2086 \layout Itemize
2301 \end_layout
2087
2302
2303 \begin_layout Itemize
2088 Use the Python debugger,
2304 Use the Python debugger,
2089 \family typewriter
2305 \family typewriter
2090 pdb
2306 pdb
2091 \family default
2307 \family default
2092
2308
2093 \begin_inset Foot
2309 \begin_inset Foot
2094 collapsed true
2310 status collapsed
2095
2096 \layout Standard
2097
2311
2312 \begin_layout Standard
2098 Thanks to Christian Hart and Matthew Arnison for the suggestions leading
2313 Thanks to Christian Hart and Matthew Arnison for the suggestions leading
2099 to IPython's improved debugger and profiler support.
2314 to IPython's improved debugger and profiler support.
2315 \end_layout
2316
2100 \end_inset
2317 \end_inset
2101
2318
2102 .
2319 .
@@ -2123,7 +2340,8 b' inside'
2123 and down the call stack to track down the true source of the problem (which
2340 and down the call stack to track down the true source of the problem (which
2124 often is many layers in the stack above where the exception gets triggered).
2341 often is many layers in the stack above where the exception gets triggered).
2125 \newline
2342 \newline
2126 Running programs with
2343 Runn
2344 ing programs with
2127 \family typewriter
2345 \family typewriter
2128 %run
2346 %run
2129 \family default
2347 \family default
@@ -2155,15 +2373,16 b' pdb'
2155 \family default
2373 \family default
2156 and automatically sets initial breakpoints for you to step through your
2374 and automatically sets initial breakpoints for you to step through your
2157 code, watch variables, etc.
2375 code, watch variables, etc.
2158 See Sec.\SpecialChar ~
2376 See Sec.\InsetSpace ~
2159
2377
2160 \begin_inset LatexCommand \ref{sec:cache_output}
2378 \begin_inset LatexCommand \ref{sec:cache_output}
2161
2379
2162 \end_inset
2380 \end_inset
2163
2381
2164 for details.
2382 for details.
2165 \layout Itemize
2383 \end_layout
2166
2384
2385 \begin_layout Itemize
2167 Use the output cache.
2386 Use the output cache.
2168 All output results are automatically stored in a global dictionary named
2387 All output results are automatically stored in a global dictionary named
2169
2388
@@ -2204,15 +2423,16 b' ___'
2204 are always kept updated with the for the last three results.
2423 are always kept updated with the for the last three results.
2205 This allows you to recall any previous result and further use it for new
2424 This allows you to recall any previous result and further use it for new
2206 calculations.
2425 calculations.
2207 See Sec.\SpecialChar ~
2426 See Sec.\InsetSpace ~
2208
2427
2209 \begin_inset LatexCommand \ref{sec:cache_output}
2428 \begin_inset LatexCommand \ref{sec:cache_output}
2210
2429
2211 \end_inset
2430 \end_inset
2212
2431
2213 for more.
2432 for more.
2214 \layout Itemize
2433 \end_layout
2215
2434
2435 \begin_layout Itemize
2216 Put a '
2436 Put a '
2217 \family typewriter
2437 \family typewriter
2218 ;
2438 ;
@@ -2231,8 +2451,9 b' Out[]'
2231 list do get updated with the contents of the output, even if it is not
2451 list do get updated with the contents of the output, even if it is not
2232 printed.
2452 printed.
2233 You can thus still access the generated results this way for further processing.
2453 You can thus still access the generated results this way for further processing.
2234 \layout Itemize
2454 \end_layout
2235
2455
2456 \begin_layout Itemize
2236 A similar system exists for caching input.
2457 A similar system exists for caching input.
2237 All input is stored in a global list called
2458 All input is stored in a global list called
2238 \family typewriter
2459 \family typewriter
@@ -2260,8 +2481,9 b' See sec.'
2260 \end_inset
2481 \end_inset
2261
2482
2262 for more.
2483 for more.
2263 \layout Itemize
2484 \end_layout
2264
2485
2486 \begin_layout Itemize
2265 Use your input history.
2487 Use your input history.
2266 The
2488 The
2267 \family typewriter
2489 \family typewriter
@@ -2280,8 +2502,9 b' Use your input history.'
2280 \family default
2502 \family default
2281 ; these logs can later be either reloaded as IPython sessions or used as
2503 ; these logs can later be either reloaded as IPython sessions or used as
2282 code for your programs.
2504 code for your programs.
2283 \layout Itemize
2505 \end_layout
2284
2506
2507 \begin_layout Itemize
2285 Define your own system aliases.
2508 Define your own system aliases.
2286 Even though IPython gives you access to your system shell via the
2509 Even though IPython gives you access to your system shell via the
2287 \family typewriter
2510 \family typewriter
@@ -2292,8 +2515,9 b' Define your own system aliases.'
2292 This allows you to work seamlessly from inside IPython with the same commands
2515 This allows you to work seamlessly from inside IPython with the same commands
2293 you are used to in your system shell.
2516 you are used to in your system shell.
2294 \newline
2517 \newline
2295 IPython comes with some pre-defined aliases and a complete system for changing
2518 IPython comes with some pre-defined
2296 directories, both via a stack (see
2519 aliases and a complete system for changing directories, both via a stack
2520 (see
2297 \family typewriter
2521 \family typewriter
2298 %pushd
2522 %pushd
2299 \family default
2523 \family default
@@ -2312,8 +2536,9 b' IPython comes with some pre-defined aliases and a complete system for changing'
2312 .
2536 .
2313 The latter keeps a history of visited directories and allows you to go
2537 The latter keeps a history of visited directories and allows you to go
2314 to any previously visited one.
2538 to any previously visited one.
2315 \layout Itemize
2539 \end_layout
2316
2540
2541 \begin_layout Itemize
2317 Use Python to manipulate the results of system commands.
2542 Use Python to manipulate the results of system commands.
2318 The `
2543 The `
2319 \family typewriter
2544 \family typewriter
@@ -2328,8 +2553,9 b' Use Python to manipulate the results of system commands.'
2328 %sx
2553 %sx
2329 \family default
2554 \family default
2330 magic commands allow you to capture system output into Python variables.
2555 magic commands allow you to capture system output into Python variables.
2331 \layout Itemize
2556 \end_layout
2332
2557
2558 \begin_layout Itemize
2333 Expand python variables when calling the shell (either via
2559 Expand python variables when calling the shell (either via
2334 \family typewriter
2560 \family typewriter
2335 `!'
2561 `!'
@@ -2344,40 +2570,43 b' $'
2344 \family default
2570 \family default
2345 in front of them.
2571 in front of them.
2346 You can also expand complete python expressions.
2572 You can also expand complete python expressions.
2347 See sec.\SpecialChar ~
2573 See sec.\InsetSpace ~
2348
2574
2349 \begin_inset LatexCommand \ref{sub:System-shell-access}
2575 \begin_inset LatexCommand \ref{sub:System-shell-access}
2350
2576
2351 \end_inset
2577 \end_inset
2352
2578
2353 for more.
2579 for more.
2354 \layout Itemize
2580 \end_layout
2355
2581
2582 \begin_layout Itemize
2356 Use profiles to maintain different configurations (modules to load, function
2583 Use profiles to maintain different configurations (modules to load, function
2357 definitions, option settings) for particular tasks.
2584 definitions, option settings) for particular tasks.
2358 You can then have customized versions of IPython for specific purposes.
2585 You can then have customized versions of IPython for specific purposes.
2359 See sec.\SpecialChar ~
2586 See sec.\InsetSpace ~
2360
2587
2361 \begin_inset LatexCommand \ref{sec:profiles}
2588 \begin_inset LatexCommand \ref{sec:profiles}
2362
2589
2363 \end_inset
2590 \end_inset
2364
2591
2365 for more.
2592 for more.
2366 \layout Itemize
2593 \end_layout
2367
2594
2595 \begin_layout Itemize
2368 Embed IPython in your programs.
2596 Embed IPython in your programs.
2369 A few lines of code are enough to load a complete IPython inside your own
2597 A few lines of code are enough to load a complete IPython inside your own
2370 programs, giving you the ability to work with your data interactively after
2598 programs, giving you the ability to work with your data interactively after
2371 automatic processing has been completed.
2599 automatic processing has been completed.
2372 See sec.\SpecialChar ~
2600 See sec.\InsetSpace ~
2373
2601
2374 \begin_inset LatexCommand \ref{sec:embed}
2602 \begin_inset LatexCommand \ref{sec:embed}
2375
2603
2376 \end_inset
2604 \end_inset
2377
2605
2378 for more.
2606 for more.
2379 \layout Itemize
2607 \end_layout
2380
2608
2609 \begin_layout Itemize
2381 Use the Python profiler.
2610 Use the Python profiler.
2382 When dealing with performance issues, the
2611 When dealing with performance issues, the
2383 \family typewriter
2612 \family typewriter
@@ -2395,30 +2624,34 b' Use the Python profiler.'
2395 \family default
2624 \family default
2396 command does a similar job for single Python expressions (like function
2625 command does a similar job for single Python expressions (like function
2397 calls).
2626 calls).
2398 \layout Itemize
2627 \end_layout
2399
2628
2629 \begin_layout Itemize
2400 Use the IPython.demo.Demo class to load any Python script as an interactive
2630 Use the IPython.demo.Demo class to load any Python script as an interactive
2401 demo.
2631 demo.
2402 With a minimal amount of simple markup, you can control the execution of
2632 With a minimal amount of simple markup, you can control the execution of
2403 the script, stopping as needed.
2633 the script, stopping as needed.
2404 See sec.\SpecialChar ~
2634 See sec.\InsetSpace ~
2405
2635
2406 \begin_inset LatexCommand \ref{sec:interactive-demos}
2636 \begin_inset LatexCommand \ref{sec:interactive-demos}
2407
2637
2408 \end_inset
2638 \end_inset
2409
2639
2410 for more.
2640 for more.
2411 \layout Subsection
2641 \end_layout
2412
2642
2643 \begin_layout Subsection
2413 Source code handling tips
2644 Source code handling tips
2414 \layout Standard
2645 \end_layout
2415
2646
2647 \begin_layout Standard
2416 IPython is a line-oriented program, without full control of the terminal.
2648 IPython is a line-oriented program, without full control of the terminal.
2417 Therefore, it doesn't support true multiline editing.
2649 Therefore, it doesn't support true multiline editing.
2418 However, it has a number of useful tools to help you in dealing effectively
2650 However, it has a number of useful tools to help you in dealing effectively
2419 with more complex editing.
2651 with more complex editing.
2420 \layout Standard
2652 \end_layout
2421
2653
2654 \begin_layout Standard
2422 The
2655 The
2423 \family typewriter
2656 \family typewriter
2424 %edit
2657 %edit
@@ -2432,8 +2665,9 b' ly.'
2432 %edit?
2665 %edit?
2433 \family default
2666 \family default
2434 for the full details on the edit command.
2667 for the full details on the edit command.
2435 \layout Standard
2668 \end_layout
2436
2669
2670 \begin_layout Standard
2437 If you have typed various commands during a session, which you'd like to
2671 If you have typed various commands during a session, which you'd like to
2438 reuse, IPython provides you with a number of tools.
2672 reuse, IPython provides you with a number of tools.
2439 Start by using
2673 Start by using
@@ -2444,14 +2678,17 b" If you have typed various commands during a session, which you'd like to"
2444 Let us say that you'd like to reuse lines 10 through 20, plus lines 24
2678 Let us say that you'd like to reuse lines 10 through 20, plus lines 24
2445 and 28.
2679 and 28.
2446 All the commands below can operate on these with the syntax
2680 All the commands below can operate on these with the syntax
2447 \layout LyX-Code
2681 \end_layout
2448
2682
2683 \begin_layout LyX-Code
2449 %command 10-20 24 28
2684 %command 10-20 24 28
2450 \layout Standard
2685 \end_layout
2451
2686
2687 \begin_layout Standard
2452 where the command given can be:
2688 where the command given can be:
2453 \layout Itemize
2689 \end_layout
2454
2690
2691 \begin_layout Itemize
2455
2692
2456 \family typewriter
2693 \family typewriter
2457 %macro <macroname>
2694 %macro <macroname>
@@ -2470,8 +2707,9 b' where the command given can be:'
2470 The combination of quick macros, persistent storage and editing, allows
2707 The combination of quick macros, persistent storage and editing, allows
2471 you to easily refine quick-and-dirty interactive input into permanent utilities
2708 you to easily refine quick-and-dirty interactive input into permanent utilities
2472 , always available both in IPython and as files for general reuse.
2709 , always available both in IPython and as files for general reuse.
2473 \layout Itemize
2710 \end_layout
2474
2711
2712 \begin_layout Itemize
2475
2713
2476 \family typewriter
2714 \family typewriter
2477 %edit
2715 %edit
@@ -2480,15 +2718,17 b' where the command given can be:'
2480 ion.
2718 ion.
2481 It will then execute the resulting file's contents as if you had typed
2719 It will then execute the resulting file's contents as if you had typed
2482 it at the prompt.
2720 it at the prompt.
2483 \layout Itemize
2721 \end_layout
2484
2722
2723 \begin_layout Itemize
2485
2724
2486 \family typewriter
2725 \family typewriter
2487 %save <filename>
2726 %save <filename>
2488 \family default
2727 \family default
2489 : this saves the lines directly to a named file on disk.
2728 : this saves the lines directly to a named file on disk.
2490 \layout Standard
2729 \end_layout
2491
2730
2731 \begin_layout Standard
2492 While
2732 While
2493 \family typewriter
2733 \family typewriter
2494 %macro
2734 %macro
@@ -2522,11 +2762,13 b' all'
2522 %save
2762 %save
2523 \family default
2763 \family default
2524 allows you to select which lines of input you need to save.
2764 allows you to select which lines of input you need to save.
2525 \layout Subsubsection*
2765 \end_layout
2526
2766
2767 \begin_layout Subsubsection*
2527 Lightweight 'version control'
2768 Lightweight 'version control'
2528 \layout Standard
2769 \end_layout
2529
2770
2771 \begin_layout Standard
2530 When you call
2772 When you call
2531 \family typewriter
2773 \family typewriter
2532 %edit
2774 %edit
@@ -2534,27 +2776,33 b' When you call'
2534 with no arguments, IPython opens an empty editor with a temporary file,
2776 with no arguments, IPython opens an empty editor with a temporary file,
2535 and it returns the contents of your editing session as a string variable.
2777 and it returns the contents of your editing session as a string variable.
2536 Thanks to IPython's output caching mechanism, this is automatically stored:
2778 Thanks to IPython's output caching mechanism, this is automatically stored:
2537 \layout LyX-Code
2779 \end_layout
2538
2780
2781 \begin_layout LyX-Code
2539 In [1]: %edit
2782 In [1]: %edit
2540 \layout LyX-Code
2783 \end_layout
2541
2784
2785 \begin_layout LyX-Code
2542 IPython will make a temporary file named: /tmp/ipython_edit_yR-HCN.py
2786 IPython will make a temporary file named: /tmp/ipython_edit_yR-HCN.py
2543 \layout LyX-Code
2787 \end_layout
2544
2788
2789 \begin_layout LyX-Code
2545 Editing...
2790 Editing...
2546 done.
2791 done.
2547 Executing edited code...
2792 Executing edited code...
2548 \layout LyX-Code
2793 \end_layout
2549
2794
2795 \begin_layout LyX-Code
2550 hello - this is a temporary file
2796 hello - this is a temporary file
2551 \layout LyX-Code
2797 \end_layout
2552
2798
2799 \begin_layout LyX-Code
2553 Out[1]: "print 'hello - this is a temporary file'
2800 Out[1]: "print 'hello - this is a temporary file'
2554 \backslash
2801 \backslash
2555 n"
2802 n"
2556 \layout Standard
2803 \end_layout
2557
2804
2805 \begin_layout Standard
2558 Now, if you call
2806 Now, if you call
2559 \family typewriter
2807 \family typewriter
2560 `%edit -p'
2808 `%edit -p'
@@ -2585,98 +2833,126 b' new file'
2585 NN
2833 NN
2586 \family default
2834 \family default
2587 is the number of the output prompt.
2835 is the number of the output prompt.
2588 \layout Standard
2836 \end_layout
2589
2837
2838 \begin_layout Standard
2590 Continuing with the example above, this should illustrate this idea:
2839 Continuing with the example above, this should illustrate this idea:
2591 \layout LyX-Code
2840 \end_layout
2592
2841
2842 \begin_layout LyX-Code
2593 In [2]: edit -p
2843 In [2]: edit -p
2594 \layout LyX-Code
2844 \end_layout
2595
2845
2846 \begin_layout LyX-Code
2596 IPython will make a temporary file named: /tmp/ipython_edit_nA09Qk.py
2847 IPython will make a temporary file named: /tmp/ipython_edit_nA09Qk.py
2597 \layout LyX-Code
2848 \end_layout
2598
2849
2850 \begin_layout LyX-Code
2599 Editing...
2851 Editing...
2600 done.
2852 done.
2601 Executing edited code...
2853 Executing edited code...
2602 \layout LyX-Code
2854 \end_layout
2603
2855
2856 \begin_layout LyX-Code
2604 hello - now I made some changes
2857 hello - now I made some changes
2605 \layout LyX-Code
2858 \end_layout
2606
2859
2860 \begin_layout LyX-Code
2607 Out[2]: "print 'hello - now I made some changes'
2861 Out[2]: "print 'hello - now I made some changes'
2608 \backslash
2862 \backslash
2609 n"
2863 n"
2610 \layout LyX-Code
2864 \end_layout
2611
2865
2866 \begin_layout LyX-Code
2612 In [3]: edit _1
2867 In [3]: edit _1
2613 \layout LyX-Code
2868 \end_layout
2614
2869
2870 \begin_layout LyX-Code
2615 IPython will make a temporary file named: /tmp/ipython_edit_gy6-zD.py
2871 IPython will make a temporary file named: /tmp/ipython_edit_gy6-zD.py
2616 \layout LyX-Code
2872 \end_layout
2617
2873
2874 \begin_layout LyX-Code
2618 Editing...
2875 Editing...
2619 done.
2876 done.
2620 Executing edited code...
2877 Executing edited code...
2621 \layout LyX-Code
2878 \end_layout
2622
2879
2880 \begin_layout LyX-Code
2623 hello - this is a temporary file
2881 hello - this is a temporary file
2624 \layout LyX-Code
2882 \end_layout
2625
2883
2884 \begin_layout LyX-Code
2626 IPython version control at work :)
2885 IPython version control at work :)
2627 \layout LyX-Code
2886 \end_layout
2628
2887
2888 \begin_layout LyX-Code
2629 Out[3]: "print 'hello - this is a temporary file'
2889 Out[3]: "print 'hello - this is a temporary file'
2630 \backslash
2890 \backslash
2631 nprint 'IPython version control at work :)'
2891 nprint 'IPython version control at work :)'
2632 \backslash
2892 \backslash
2633 n"
2893 n"
2634 \layout Standard
2894 \end_layout
2635
2895
2896 \begin_layout Standard
2636 This section was written after a contribution by Alexander Belchenko on
2897 This section was written after a contribution by Alexander Belchenko on
2637 the IPython user list.
2898 the IPython user list.
2638 \layout LyX-Code
2899 \end_layout
2900
2901 \begin_layout LyX-Code
2639
2902
2640 \layout Subsection
2903 \end_layout
2641
2904
2905 \begin_layout Subsection
2642 Effective logging
2906 Effective logging
2643 \layout Standard
2907 \end_layout
2644
2908
2909 \begin_layout Standard
2645 A very useful suggestion sent in by Robert Kern follows:
2910 A very useful suggestion sent in by Robert Kern follows:
2646 \layout Standard
2911 \end_layout
2647
2912
2913 \begin_layout Standard
2648 I recently happened on a nifty way to keep tidy per-project log files.
2914 I recently happened on a nifty way to keep tidy per-project log files.
2649 I made a profile for my project (which is called "parkfield").
2915 I made a profile for my project (which is called "parkfield").
2650 \layout LyX-Code
2916 \end_layout
2651
2917
2918 \begin_layout LyX-Code
2652 include ipythonrc
2919 include ipythonrc
2653 \layout LyX-Code
2920 \end_layout
2654
2921
2922 \begin_layout LyX-Code
2655 # cancel earlier logfile invocation:
2923 # cancel earlier logfile invocation:
2656 \layout LyX-Code
2924 \end_layout
2657
2925
2926 \begin_layout LyX-Code
2658 logfile ''
2927 logfile ''
2659 \layout LyX-Code
2928 \end_layout
2660
2929
2930 \begin_layout LyX-Code
2661 execute import time
2931 execute import time
2662 \layout LyX-Code
2932 \end_layout
2663
2933
2934 \begin_layout LyX-Code
2664 execute __cmd = '/Users/kern/research/logfiles/parkfield-%s.log rotate'
2935 execute __cmd = '/Users/kern/research/logfiles/parkfield-%s.log rotate'
2665 \layout LyX-Code
2936 \end_layout
2666
2937
2938 \begin_layout LyX-Code
2667 execute __IP.magic_logstart(__cmd % time.strftime('%Y-%m-%d'))
2939 execute __IP.magic_logstart(__cmd % time.strftime('%Y-%m-%d'))
2668 \layout Standard
2940 \end_layout
2669
2941
2942 \begin_layout Standard
2670 I also added a shell alias for convenience:
2943 I also added a shell alias for convenience:
2671 \layout LyX-Code
2944 \end_layout
2672
2945
2946 \begin_layout LyX-Code
2673 alias parkfield="ipython -pylab -profile parkfield"
2947 alias parkfield="ipython -pylab -profile parkfield"
2674 \layout Standard
2948 \end_layout
2675
2949
2950 \begin_layout Standard
2676 Now I have a nice little directory with everything I ever type in, organized
2951 Now I have a nice little directory with everything I ever type in, organized
2677 by project and date.
2952 by project and date.
2678 \layout Standard
2953 \end_layout
2679
2954
2955 \begin_layout Standard
2680
2956
2681 \series bold
2957 \series bold
2682 Contribute your own:
2958 Contribute your own:
@@ -2684,19 +2960,23 b' Contribute your own:'
2684 If you have your own favorite tip on using IPython efficiently for a certain
2960 If you have your own favorite tip on using IPython efficiently for a certain
2685 task (especially things which can't be done in the normal Python interpreter),
2961 task (especially things which can't be done in the normal Python interpreter),
2686 don't hesitate to send it!
2962 don't hesitate to send it!
2687 \layout Section
2963 \end_layout
2688
2964
2965 \begin_layout Section
2689 Command-line use
2966 Command-line use
2690 \layout Standard
2967 \end_layout
2691
2968
2969 \begin_layout Standard
2692 You start IPython with the command:
2970 You start IPython with the command:
2693 \layout Standard
2971 \end_layout
2694
2972
2973 \begin_layout Standard
2695
2974
2696 \family typewriter
2975 \family typewriter
2697 $ ipython [options] files
2976 $ ipython [options] files
2698 \layout Standard
2977 \end_layout
2699
2978
2979 \begin_layout Standard
2700 If invoked with no options, it executes all the files listed in sequence
2980 If invoked with no options, it executes all the files listed in sequence
2701 and drops you into the interpreter while still acknowledging any options
2981 and drops you into the interpreter while still acknowledging any options
2702 you may have set in your ipythonrc file.
2982 you may have set in your ipythonrc file.
@@ -2705,8 +2985,9 b' If invoked with no options, it executes all the files listed in sequence'
2705 python -i
2985 python -i
2706 \family default
2986 \family default
2707 will only execute one file and ignore your configuration setup.
2987 will only execute one file and ignore your configuration setup.
2708 \layout Standard
2988 \end_layout
2709
2989
2990 \begin_layout Standard
2710 Please note that some of the configuration options are not available at
2991 Please note that some of the configuration options are not available at
2711 the command line, simply because they are not practical here.
2992 the command line, simply because they are not practical here.
2712 Look into your ipythonrc configuration file for details on those.
2993 Look into your ipythonrc configuration file for details on those.
@@ -2737,29 +3018,32 b' YourUserName'
2737 IPYTHONDIR
3018 IPYTHONDIR
2738 \family default
3019 \family default
2739 .
3020 .
2740 \layout Subsection
3021 \end_layout
2741
2742
3022
3023 \begin_layout Subsection
2743 \begin_inset LatexCommand \label{sec:threading-opts}
3024 \begin_inset LatexCommand \label{sec:threading-opts}
2744
3025
2745 \end_inset
3026 \end_inset
2746
3027
2747 Special Threading Options
3028 Special Threading Options
2748 \layout Standard
3029 \end_layout
2749
3030
3031 \begin_layout Standard
2750 The following special options are ONLY valid at the beginning of the command
3032 The following special options are ONLY valid at the beginning of the command
2751 line, and not later.
3033 line, and not later.
2752 This is because they control the initial- ization of ipython itself, before
3034 This is because they control the initial- ization of ipython itself, before
2753 the normal option-handling mechanism is active.
3035 the normal option-handling mechanism is active.
2754 \layout List
3036 \end_layout
2755 \labelwidthstring 00.00.0000
2756
3037
3038 \begin_layout List
3039 \labelwidthstring 00.00.0000
2757
3040
2758 \family typewriter
3041 \family typewriter
2759 \series bold
3042 \series bold
2760 -gthread,\SpecialChar ~
3043 -gthread,\InsetSpace ~
2761 -qthread,\SpecialChar ~
3044 -qthread,\InsetSpace ~
2762 -wthread,\SpecialChar ~
3045 -q4thread,\InsetSpace ~
3046 -wthread,\InsetSpace ~
2763 -pylab:
3047 -pylab:
2764 \family default
3048 \family default
2765 \series default
3049 \series default
@@ -2769,22 +3053,23 b' one'
2769 \emph default
3053 \emph default
2770 of these can be given, and it can only be given as the first option passed
3054 of these can be given, and it can only be given as the first option passed
2771 to IPython (it will have no effect in any other position).
3055 to IPython (it will have no effect in any other position).
2772 They provide threading support for the GTK Qt and WXPython toolkits, and
3056 They provide threading support for the GTK, Qt (versions 3 and 4) and WXPython
2773 for the matplotlib library.
3057 toolkits, and for the matplotlib library.
2774 \layout List
3058 \end_layout
2775 \labelwidthstring 00.00.0000
2776
3059
2777 \SpecialChar ~
3060 \begin_layout List
2778 With any of the first three options, IPython starts running a separate
2779 thread for the graphical toolkit's operation, so that you can open and
2780 control graphical elements from within an IPython command line, without
2781 blocking.
2782 All three provide essentially the same functionality, respectively for
2783 GTK, QT and WXWidgets (via their Python interfaces).
2784 \layout List
2785 \labelwidthstring 00.00.0000
3061 \labelwidthstring 00.00.0000
3062 \InsetSpace ~
3063 With any of the first four options, IPython starts running a separate thread
3064 for the graphical toolkit's operation, so that you can open and control
3065 graphical elements from within an IPython command line, without blocking.
3066 All four provide essentially the same functionality, respectively for GTK,
3067 Qt3, Qt4 and WXWidgets (via their Python interfaces).
3068 \end_layout
2786
3069
2787 \SpecialChar ~
3070 \begin_layout List
3071 \labelwidthstring 00.00.0000
3072 \InsetSpace ~
2788 Note that with
3073 Note that with
2789 \family typewriter
3074 \family typewriter
2790 -wthread
3075 -wthread
@@ -2796,10 +3081,11 b' one'
2796 wxversion
3081 wxversion
2797 \family default
3082 \family default
2798 Python module installed, which is part of recent wxPython distributions.
3083 Python module installed, which is part of recent wxPython distributions.
2799 \layout List
3084 \end_layout
2800 \labelwidthstring 00.00.0000
2801
3085
2802 \SpecialChar ~
3086 \begin_layout List
3087 \labelwidthstring 00.00.0000
3088 \InsetSpace ~
2803 If
3089 If
2804 \family typewriter
3090 \family typewriter
2805 -pylab
3091 -pylab
@@ -2828,9 +3114,10 b' show()'
2828 \family default
3114 \family default
2829 at the end.
3115 at the end.
2830
3116
2831 \layout List
3117 \end_layout
2832 \labelwidthstring 00.00.0000
2833
3118
3119 \begin_layout List
3120 \labelwidthstring 00.00.0000
2834
3121
2835 \family typewriter
3122 \family typewriter
2836 \series bold
3123 \series bold
@@ -2839,14 +3126,14 b' show()'
2839 \series default
3126 \series default
2840 The
3127 The
2841 \family typewriter
3128 \family typewriter
2842 -g/q/wthread
3129 -g/q/q4/wthread
2843 \family default
3130 \family default
2844 options, and
3131 options, and
2845 \family typewriter
3132 \family typewriter
2846 -pylab
3133 -pylab
2847 \family default
3134 \family default
2848 (if matplotlib is configured to use GTK, Qt or WX), will normally block
3135 (if matplotlib is configured to use GTK, Qt3, Qt4 or WX), will normally
2849 Tk graphical interfaces.
3136 block Tk graphical interfaces.
2850 This means that when either GTK, Qt or WX threading is active, any attempt
3137 This means that when either GTK, Qt or WX threading is active, any attempt
2851 to open a Tk GUI will result in a dead window, and possibly cause the Python
3138 to open a Tk GUI will result in a dead window, and possibly cause the Python
2852 interpreter to crash.
3139 interpreter to crash.
@@ -2876,10 +3163,11 b' second'
2876 -pylab
3163 -pylab
2877 \family default
3164 \family default
2878 ).
3165 ).
2879 \layout List
3166 \end_layout
2880 \labelwidthstring 00.00.0000
2881
3167
2882 \SpecialChar ~
3168 \begin_layout List
3169 \labelwidthstring 00.00.0000
3170 \InsetSpace ~
2883 If
3171 If
2884 \family typewriter
3172 \family typewriter
2885 -tk
3173 -tk
@@ -2893,10 +3181,11 b' second'
2893 caused random crashes and lockups of the Python interpreter.
3181 caused random crashes and lockups of the Python interpreter.
2894 Under other operating systems (Mac OSX and Windows), you'll need to try
3182 Under other operating systems (Mac OSX and Windows), you'll need to try
2895 it to find out, since currently no user reports are available.
3183 it to find out, since currently no user reports are available.
2896 \layout List
3184 \end_layout
2897 \labelwidthstring 00.00.0000
2898
3185
2899 \SpecialChar ~
3186 \begin_layout List
3187 \labelwidthstring 00.00.0000
3188 \InsetSpace ~
2900 There is unfortunately no way for IPython to determine at run time whether
3189 There is unfortunately no way for IPython to determine at run time whether
2901
3190
2902 \family typewriter
3191 \family typewriter
@@ -2905,16 +3194,17 b' second'
2905 will work reliably or not, so you will need to do some experiments before
3194 will work reliably or not, so you will need to do some experiments before
2906 relying on it for regular work.
3195 relying on it for regular work.
2907
3196
2908 \layout Subsection
3197 \end_layout
2909
2910
3198
3199 \begin_layout Subsection
2911 \begin_inset LatexCommand \label{sec:cmd-line-opts}
3200 \begin_inset LatexCommand \label{sec:cmd-line-opts}
2912
3201
2913 \end_inset
3202 \end_inset
2914
3203
2915 Regular Options
3204 Regular Options
2916 \layout Standard
3205 \end_layout
2917
3206
3207 \begin_layout Standard
2918 After the above threading options have been given, regular options can follow
3208 After the above threading options have been given, regular options can follow
2919 in any order.
3209 in any order.
2920 All options can be abbreviated to their shortest non-ambiguous form and
3210 All options can be abbreviated to their shortest non-ambiguous form and
@@ -2925,14 +3215,16 b' After the above threading options have been given, regular options can follow'
2925 |
3215 |
2926 \family default
3216 \family default
2927 .
3217 .
2928 \layout Standard
3218 \end_layout
2929
3219
3220 \begin_layout Standard
2930 Most options can also be set from your ipythonrc configuration file.
3221 Most options can also be set from your ipythonrc configuration file.
2931 See the provided example for more details on what the options do.
3222 See the provided example for more details on what the options do.
2932 Options given at the command line override the values set in the ipythonrc
3223 Options given at the command line override the values set in the ipythonrc
2933 file.
3224 file.
2934 \layout Standard
3225 \end_layout
2935
3226
3227 \begin_layout Standard
2936 All options with a
3228 All options with a
2937 \family typewriter
3229 \family typewriter
2938 [no]
3230 [no]
@@ -2946,9 +3238,10 b' All options with a'
2946 -option
3238 -option
2947 \family default
3239 \family default
2948 ) to turn the feature off.
3240 ) to turn the feature off.
2949 \layout List
3241 \end_layout
2950 \labelwidthstring 00.00.0000
2951
3242
3243 \begin_layout List
3244 \labelwidthstring 00.00.0000
2952
3245
2953 \family typewriter
3246 \family typewriter
2954 \series bold
3247 \series bold
@@ -2956,9 +3249,10 b' All options with a'
2956 \family default
3249 \family default
2957 \series default
3250 \series default
2958 : print a help message and exit.
3251 : print a help message and exit.
2959 \layout List
3252 \end_layout
2960 \labelwidthstring 00.00.0000
2961
3253
3254 \begin_layout List
3255 \labelwidthstring 00.00.0000
2962
3256
2963 \family typewriter
3257 \family typewriter
2964 \series bold
3258 \series bold
@@ -2997,16 +3291,17 b' first'
2997 show()
3291 show()
2998 \family default
3292 \family default
2999 at the end.
3293 at the end.
3000 See Sec.\SpecialChar ~
3294 See Sec.\InsetSpace ~
3001
3295
3002 \begin_inset LatexCommand \ref{sec:matplotlib-support}
3296 \begin_inset LatexCommand \ref{sec:matplotlib-support}
3003
3297
3004 \end_inset
3298 \end_inset
3005
3299
3006 for more details.
3300 for more details.
3007 \layout List
3301 \end_layout
3008 \labelwidthstring 00.00.0000
3009
3302
3303 \begin_layout List
3304 \labelwidthstring 00.00.0000
3010
3305
3011 \family typewriter
3306 \family typewriter
3012 \series bold
3307 \series bold
@@ -3028,9 +3323,10 b' full'
3028 autocall, where all callable objects are automatically called (even if
3323 autocall, where all callable objects are automatically called (even if
3029 no arguments are present).
3324 no arguments are present).
3030 The default is `1'.
3325 The default is `1'.
3031 \layout List
3326 \end_layout
3032 \labelwidthstring 00.00.0000
3033
3327
3328 \begin_layout List
3329 \labelwidthstring 00.00.0000
3034
3330
3035 \family typewriter
3331 \family typewriter
3036 \series bold
3332 \series bold
@@ -3038,9 +3334,10 b' full'
3038 \family default
3334 \family default
3039 \series default
3335 \series default
3040 Turn automatic indentation on/off.
3336 Turn automatic indentation on/off.
3041 \layout List
3337 \end_layout
3042 \labelwidthstring 00.00.0000
3043
3338
3339 \begin_layout List
3340 \labelwidthstring 00.00.0000
3044
3341
3045 \family typewriter
3342 \family typewriter
3046 \series bold
3343 \series bold
@@ -3059,9 +3356,10 b' full'
3059 %magic
3356 %magic
3060 \family default
3357 \family default
3061 at the IPython prompt for more information.
3358 at the IPython prompt for more information.
3062 \layout List
3359 \end_layout
3063 \labelwidthstring 00.00.0000
3064
3360
3361 \begin_layout List
3362 \labelwidthstring 00.00.0000
3065
3363
3066 \family typewriter
3364 \family typewriter
3067 \series bold
3365 \series bold
@@ -3071,9 +3369,10 b' full'
3071 When a syntax error occurs after editing a file, automatically open the
3369 When a syntax error occurs after editing a file, automatically open the
3072 file to the trouble causing line for convenient fixing.
3370 file to the trouble causing line for convenient fixing.
3073
3371
3074 \layout List
3372 \end_layout
3075 \labelwidthstring 00.00.0000
3076
3373
3374 \begin_layout List
3375 \labelwidthstring 00.00.0000
3077
3376
3078 \family typewriter
3377 \family typewriter
3079 \series bold
3378 \series bold
@@ -3082,13 +3381,14 b' full'
3082 :
3381 :
3083 \family default
3382 \family default
3084 Print the initial information banner (default on).
3383 Print the initial information banner (default on).
3085 \layout List
3384 \end_layout
3086 \labelwidthstring 00.00.0000
3087
3385
3386 \begin_layout List
3387 \labelwidthstring 00.00.0000
3088
3388
3089 \family typewriter
3389 \family typewriter
3090 \series bold
3390 \series bold
3091 -c\SpecialChar ~
3391 -c\InsetSpace ~
3092 <command>:
3392 <command>:
3093 \family default
3393 \family default
3094 \series default
3394 \series default
@@ -3103,13 +3403,14 b' full'
3103 \family default
3403 \family default
3104 option in the normal Python interpreter.
3404 option in the normal Python interpreter.
3105
3405
3106 \layout List
3406 \end_layout
3107 \labelwidthstring 00.00.0000
3108
3407
3408 \begin_layout List
3409 \labelwidthstring 00.00.0000
3109
3410
3110 \family typewriter
3411 \family typewriter
3111 \series bold
3412 \series bold
3112 -cache_size|cs\SpecialChar ~
3413 -cache_size|cs\InsetSpace ~
3113 <n>
3414 <n>
3114 \series default
3415 \series default
3115 :
3416 :
@@ -3120,9 +3421,10 b' full'
3120 value accepted is 20 (if you provide a value less than 20, it is reset
3421 value accepted is 20 (if you provide a value less than 20, it is reset
3121 to 0 and a warning is issued) This limit is defined because otherwise you'll
3422 to 0 and a warning is issued) This limit is defined because otherwise you'll
3122 spend more time re-flushing a too small cache than working.
3423 spend more time re-flushing a too small cache than working.
3123 \layout List
3424 \end_layout
3124 \labelwidthstring 00.00.0000
3125
3425
3426 \begin_layout List
3427 \labelwidthstring 00.00.0000
3126
3428
3127 \family typewriter
3429 \family typewriter
3128 \series bold
3430 \series bold
@@ -3131,21 +3433,23 b' full'
3131 :
3433 :
3132 \family default
3434 \family default
3133 Gives IPython a similar feel to the classic Python prompt.
3435 Gives IPython a similar feel to the classic Python prompt.
3134 \layout List
3436 \end_layout
3135 \labelwidthstring 00.00.0000
3136
3437
3438 \begin_layout List
3439 \labelwidthstring 00.00.0000
3137
3440
3138 \family typewriter
3441 \family typewriter
3139 \series bold
3442 \series bold
3140 -colors\SpecialChar ~
3443 -colors\InsetSpace ~
3141 <scheme>:
3444 <scheme>:
3142 \family default
3445 \family default
3143 \series default
3446 \series default
3144 Color scheme for prompts and exception reporting.
3447 Color scheme for prompts and exception reporting.
3145 Currently implemented: NoColor, Linux and LightBG.
3448 Currently implemented: NoColor, Linux and LightBG.
3146 \layout List
3449 \end_layout
3147 \labelwidthstring 00.00.0000
3148
3450
3451 \begin_layout List
3452 \labelwidthstring 00.00.0000
3149
3453
3150 \family typewriter
3454 \family typewriter
3151 \series bold
3455 \series bold
@@ -3161,19 +3465,21 b' full'
3161 works for you.
3465 works for you.
3162 As a reference, the 'less' pager supplied with Mandrake 8.2 works ok, but
3466 As a reference, the 'less' pager supplied with Mandrake 8.2 works ok, but
3163 that in RedHat 7.2 doesn't.
3467 that in RedHat 7.2 doesn't.
3164 \layout List
3468 \end_layout
3165 \labelwidthstring 00.00.0000
3166
3469
3167 \SpecialChar ~
3470 \begin_layout List
3471 \labelwidthstring 00.00.0000
3472 \InsetSpace ~
3168 Test it and turn it on permanently if it works with your system.
3473 Test it and turn it on permanently if it works with your system.
3169 The magic function
3474 The magic function
3170 \family typewriter
3475 \family typewriter
3171 %color_info
3476 %color_info
3172 \family default
3477 \family default
3173 allows you to toggle this interactively for testing.
3478 allows you to toggle this interactively for testing.
3174 \layout List
3479 \end_layout
3175 \labelwidthstring 00.00.0000
3176
3480
3481 \begin_layout List
3482 \labelwidthstring 00.00.0000
3177
3483
3178 \family typewriter
3484 \family typewriter
3179 \series bold
3485 \series bold
@@ -3183,9 +3489,10 b' full'
3183 : Show information about the loading process.
3489 : Show information about the loading process.
3184 Very useful to pin down problems with your configuration files or to get
3490 Very useful to pin down problems with your configuration files or to get
3185 details about session restores.
3491 details about session restores.
3186 \layout List
3492 \end_layout
3187 \labelwidthstring 00.00.0000
3188
3493
3494 \begin_layout List
3495 \labelwidthstring 00.00.0000
3189
3496
3190 \family typewriter
3497 \family typewriter
3191 \series bold
3498 \series bold
@@ -3212,10 +3519,11 b' deep_reload()'
3212 reload()
3519 reload()
3213 \family default
3520 \family default
3214 function does not.
3521 function does not.
3215 \layout List
3522 \end_layout
3216 \labelwidthstring 00.00.0000
3217
3523
3218 \SpecialChar ~
3524 \begin_layout List
3525 \labelwidthstring 00.00.0000
3526 \InsetSpace ~
3219 When deep_reload is off, IPython will use the normal
3527 When deep_reload is off, IPython will use the normal
3220 \family typewriter
3528 \family typewriter
3221 reload()
3529 reload()
@@ -3234,13 +3542,14 b' reload()'
3234 dreload()
3542 dreload()
3235 \family default
3543 \family default
3236 ].
3544 ].
3237 \layout List
3545 \end_layout
3238 \labelwidthstring 00.00.0000
3239
3546
3547 \begin_layout List
3548 \labelwidthstring 00.00.0000
3240
3549
3241 \family typewriter
3550 \family typewriter
3242 \series bold
3551 \series bold
3243 -editor\SpecialChar ~
3552 -editor\InsetSpace ~
3244 <name>
3553 <name>
3245 \family default
3554 \family default
3246 \series default
3555 \series default
@@ -3262,13 +3571,14 b' EDITOR'
3262 EDITOR
3571 EDITOR
3263 \family default
3572 \family default
3264 is something like Emacs).
3573 is something like Emacs).
3265 \layout List
3574 \end_layout
3266 \labelwidthstring 00.00.0000
3267
3575
3576 \begin_layout List
3577 \labelwidthstring 00.00.0000
3268
3578
3269 \family typewriter
3579 \family typewriter
3270 \series bold
3580 \series bold
3271 -ipythondir\SpecialChar ~
3581 -ipythondir\InsetSpace ~
3272 <name>
3582 <name>
3273 \series default
3583 \series default
3274 :
3584 :
@@ -3283,9 +3593,10 b' IPYTHONDIR'
3283 IPYTHONDIR
3593 IPYTHONDIR
3284 \family default
3594 \family default
3285 .
3595 .
3286 \layout List
3596 \end_layout
3287 \labelwidthstring 00.00.0000
3288
3597
3598 \begin_layout List
3599 \labelwidthstring 00.00.0000
3289
3600
3290 \family typewriter
3601 \family typewriter
3291 \series bold
3602 \series bold
@@ -3305,25 +3616,27 b' ipython_log.py'
3305 -logplay
3616 -logplay
3306 \family default
3617 \family default
3307 (see below).
3618 (see below).
3308 \layout List
3619 \end_layout
3309 \labelwidthstring 00.00.0000
3310
3620
3621 \begin_layout List
3622 \labelwidthstring 00.00.0000
3311
3623
3312 \family typewriter
3624 \family typewriter
3313 \series bold
3625 \series bold
3314 -logfile|lf\SpecialChar ~
3626 -logfile|lf\InsetSpace ~
3315 <name>
3627 <name>
3316 \series default
3628 \series default
3317 :
3629 :
3318 \family default
3630 \family default
3319 specify the name of your logfile.
3631 specify the name of your logfile.
3320 \layout List
3632 \end_layout
3321 \labelwidthstring 00.00.0000
3322
3633
3634 \begin_layout List
3635 \labelwidthstring 00.00.0000
3323
3636
3324 \family typewriter
3637 \family typewriter
3325 \series bold
3638 \series bold
3326 -logplay|lp\SpecialChar ~
3639 -logplay|lp\InsetSpace ~
3327 <name>
3640 <name>
3328 \series default
3641 \series default
3329 :
3642 :
@@ -3337,19 +3650,21 b' specify the name of your logfile.'
3337 \family default
3650 \family default
3338 , IPython will try to reconstruct the previous working environment in full,
3651 , IPython will try to reconstruct the previous working environment in full,
3339 not just execute the commands in the logfile.
3652 not just execute the commands in the logfile.
3340 \layout List
3653 \end_layout
3341 \labelwidthstring 00.00.0000
3342
3654
3343 \SpecialChar ~
3655 \begin_layout List
3656 \labelwidthstring 00.00.0000
3657 \InsetSpace ~
3344 When a session is restored, logging is automatically turned on again with
3658 When a session is restored, logging is automatically turned on again with
3345 the name of the logfile it was invoked with (it is read from the log header).
3659 the name of the logfile it was invoked with (it is read from the log header).
3346 So once you've turned logging on for a session, you can quit IPython and
3660 So once you've turned logging on for a session, you can quit IPython and
3347 reload it as many times as you want and it will continue to log its history
3661 reload it as many times as you want and it will continue to log its history
3348 and restore from the beginning every time.
3662 and restore from the beginning every time.
3349 \layout List
3663 \end_layout
3350 \labelwidthstring 00.00.0000
3351
3664
3352 \SpecialChar ~
3665 \begin_layout List
3666 \labelwidthstring 00.00.0000
3667 \InsetSpace ~
3353 Caveats: there are limitations in this option.
3668 Caveats: there are limitations in this option.
3354 The history variables
3669 The history variables
3355 \family typewriter
3670 \family typewriter
@@ -3368,9 +3683,10 b' _dh'
3368 retrieving a 'snapshot' of the memory state of IPython.
3683 retrieving a 'snapshot' of the memory state of IPython.
3369 But our first attempts failed because of inherent limitations of Python's
3684 But our first attempts failed because of inherent limitations of Python's
3370 Pickle module, so this may have to wait.
3685 Pickle module, so this may have to wait.
3371 \layout List
3686 \end_layout
3372 \labelwidthstring 00.00.0000
3373
3687
3688 \begin_layout List
3689 \labelwidthstring 00.00.0000
3374
3690
3375 \family typewriter
3691 \family typewriter
3376 \series bold
3692 \series bold
@@ -3380,9 +3696,10 b' _dh'
3380 \family default
3696 \family default
3381 Print messages which IPython collects about its startup process (default
3697 Print messages which IPython collects about its startup process (default
3382 on).
3698 on).
3383 \layout List
3699 \end_layout
3384 \labelwidthstring 00.00.0000
3385
3700
3701 \begin_layout List
3702 \labelwidthstring 00.00.0000
3386
3703
3387 \family typewriter
3704 \family typewriter
3388 \series bold
3705 \series bold
@@ -3393,9 +3710,10 b' _dh'
3393 If you are used to debugging using pdb, this puts you automatically inside
3710 If you are used to debugging using pdb, this puts you automatically inside
3394 of it after any call (either in IPython or in code called by it) which
3711 of it after any call (either in IPython or in code called by it) which
3395 triggers an exception which goes uncaught.
3712 triggers an exception which goes uncaught.
3396 \layout List
3713 \end_layout
3397 \labelwidthstring 00.00.0000
3398
3714
3715 \begin_layout List
3716 \labelwidthstring 00.00.0000
3399
3717
3400 \family typewriter
3718 \family typewriter
3401 \series bold
3719 \series bold
@@ -3408,9 +3726,10 b' _dh'
3408 pprint tends to give a nicer display of nested data structures.
3726 pprint tends to give a nicer display of nested data structures.
3409 If you like it, you can turn it on permanently in your config file (default
3727 If you like it, you can turn it on permanently in your config file (default
3410 off).
3728 off).
3411 \layout List
3729 \end_layout
3412 \labelwidthstring 00.00.0000
3413
3730
3731 \begin_layout List
3732 \labelwidthstring 00.00.0000
3414
3733
3415 \family typewriter
3734 \family typewriter
3416 \series bold
3735 \series bold
@@ -3436,12 +3755,13 b' IPYTHONDIR/ipythonrc'
3436 file and then have other 'profiles' which include this one and load extra
3755 file and then have other 'profiles' which include this one and load extra
3437 things for particular tasks.
3756 things for particular tasks.
3438 For example:
3757 For example:
3439 \layout List
3758 \end_layout
3440 \labelwidthstring 00.00.0000
3441
3759
3760 \begin_layout List
3761 \labelwidthstring 00.00.0000
3442
3762
3443 \family typewriter
3763 \family typewriter
3444 \SpecialChar ~
3764 \InsetSpace ~
3445
3765
3446 \family default
3766 \family default
3447 1.
3767 1.
@@ -3450,12 +3770,13 b' IPYTHONDIR/ipythonrc'
3450 $HOME/.ipython/ipythonrc
3770 $HOME/.ipython/ipythonrc
3451 \family default
3771 \family default
3452 : load basic things you always want.
3772 : load basic things you always want.
3453 \layout List
3773 \end_layout
3454 \labelwidthstring 00.00.0000
3455
3774
3775 \begin_layout List
3776 \labelwidthstring 00.00.0000
3456
3777
3457 \family typewriter
3778 \family typewriter
3458 \SpecialChar ~
3779 \InsetSpace ~
3459
3780
3460 \family default
3781 \family default
3461 2.
3782 2.
@@ -3465,12 +3786,13 b' IPYTHONDIR/ipythonrc'
3465 \family default
3786 \family default
3466 : load (1) and basic math-related modules.
3787 : load (1) and basic math-related modules.
3467
3788
3468 \layout List
3789 \end_layout
3469 \labelwidthstring 00.00.0000
3470
3790
3791 \begin_layout List
3792 \labelwidthstring 00.00.0000
3471
3793
3472 \family typewriter
3794 \family typewriter
3473 \SpecialChar ~
3795 \InsetSpace ~
3474
3796
3475 \family default
3797 \family default
3476 3.
3798 3.
@@ -3479,19 +3801,21 b' IPYTHONDIR/ipythonrc'
3479 $HOME/.ipython/ipythonrc-numeric
3801 $HOME/.ipython/ipythonrc-numeric
3480 \family default
3802 \family default
3481 : load (1) and Numeric and plotting modules.
3803 : load (1) and Numeric and plotting modules.
3482 \layout List
3804 \end_layout
3483 \labelwidthstring 00.00.0000
3484
3805
3485 \SpecialChar ~
3806 \begin_layout List
3807 \labelwidthstring 00.00.0000
3808 \InsetSpace ~
3486 Since it is possible to create an endless loop by having circular file
3809 Since it is possible to create an endless loop by having circular file
3487 inclusions, IPython will stop if it reaches 15 recursive inclusions.
3810 inclusions, IPython will stop if it reaches 15 recursive inclusions.
3488 \layout List
3811 \end_layout
3489 \labelwidthstring 00.00.0000
3490
3812
3813 \begin_layout List
3814 \labelwidthstring 00.00.0000
3491
3815
3492 \family typewriter
3816 \family typewriter
3493 \series bold
3817 \series bold
3494 -prompt_in1|pi1\SpecialChar ~
3818 -prompt_in1|pi1\InsetSpace ~
3495 <string>:
3819 <string>:
3496 \family default
3820 \family default
3497 \series default
3821 \series default
@@ -3503,26 +3827,27 b' IPYTHONDIR/ipythonrc'
3503 Don't forget to quote strings with spaces embedded in them.
3827 Don't forget to quote strings with spaces embedded in them.
3504 Default: '
3828 Default: '
3505 \family typewriter
3829 \family typewriter
3506 In\SpecialChar ~
3830 In\InsetSpace ~
3507 [
3831 [
3508 \backslash
3832 \backslash
3509 #]:
3833 #]:
3510 \family default
3834 \family default
3511 '.
3835 '.
3512 Sec.\SpecialChar ~
3836 Sec.\InsetSpace ~
3513
3837
3514 \begin_inset LatexCommand \ref{sec:prompts}
3838 \begin_inset LatexCommand \ref{sec:prompts}
3515
3839
3516 \end_inset
3840 \end_inset
3517
3841
3518 discusses in detail all the available escapes to customize your prompts.
3842 discusses in detail all the available escapes to customize your prompts.
3519 \layout List
3843 \end_layout
3520 \labelwidthstring 00.00.0000
3521
3844
3845 \begin_layout List
3846 \labelwidthstring 00.00.0000
3522
3847
3523 \family typewriter
3848 \family typewriter
3524 \series bold
3849 \series bold
3525 -prompt_in2|pi2\SpecialChar ~
3850 -prompt_in2|pi2\InsetSpace ~
3526 <string>:
3851 <string>:
3527 \family default
3852 \family default
3528 \series default
3853 \series default
@@ -3543,28 +3868,29 b' D'
3543 prompt aligned with your input prompt).
3868 prompt aligned with your input prompt).
3544 Default: '
3869 Default: '
3545 \family typewriter
3870 \family typewriter
3546 \SpecialChar ~
3871 \InsetSpace ~
3547 \SpecialChar ~
3872 \InsetSpace ~
3548 \SpecialChar ~
3873 \InsetSpace ~
3549 .
3874 .
3550 \backslash
3875 \backslash
3551 D.:
3876 D.:
3552 \family default
3877 \family default
3553 ' (note three spaces at the start for alignment with '
3878 ' (note three spaces at the start for alignment with '
3554 \family typewriter
3879 \family typewriter
3555 In\SpecialChar ~
3880 In\InsetSpace ~
3556 [
3881 [
3557 \backslash
3882 \backslash
3558 #]
3883 #]
3559 \family default
3884 \family default
3560 ').
3885 ').
3561 \layout List
3886 \end_layout
3562 \labelwidthstring 00.00.0000
3563
3887
3888 \begin_layout List
3889 \labelwidthstring 00.00.0000
3564
3890
3565 \family typewriter
3891 \family typewriter
3566 \series bold
3892 \series bold
3567 -prompt_out|po\SpecialChar ~
3893 -prompt_out|po\InsetSpace ~
3568 <string>:
3894 <string>:
3569 \family default
3895 \family default
3570 \series default
3896 \series default
@@ -3580,9 +3906,10 b' Out['
3580 #]:
3906 #]:
3581 \family default
3907 \family default
3582 '
3908 '
3583 \layout List
3909 \end_layout
3584 \labelwidthstring 00.00.0000
3585
3910
3911 \begin_layout List
3912 \labelwidthstring 00.00.0000
3586
3913
3587 \family typewriter
3914 \family typewriter
3588 \series bold
3915 \series bold
@@ -3590,13 +3917,14 b' Out['
3590 \family default
3917 \family default
3591 \series default
3918 \series default
3592 : start in bare bones mode (no config file loaded).
3919 : start in bare bones mode (no config file loaded).
3593 \layout List
3920 \end_layout
3594 \labelwidthstring 00.00.0000
3595
3921
3922 \begin_layout List
3923 \labelwidthstring 00.00.0000
3596
3924
3597 \family typewriter
3925 \family typewriter
3598 \series bold
3926 \series bold
3599 -rcfile\SpecialChar ~
3927 -rcfile\InsetSpace ~
3600 <name>
3928 <name>
3601 \series default
3929 \series default
3602 :
3930 :
@@ -3607,15 +3935,17 b' Out['
3607 IPYTHONDIR/ipythonrc
3935 IPYTHONDIR/ipythonrc
3608 \family default
3936 \family default
3609 .
3937 .
3610 \layout List
3938 \end_layout
3611 \labelwidthstring 00.00.0000
3612
3939
3613 \SpecialChar ~
3940 \begin_layout List
3941 \labelwidthstring 00.00.0000
3942 \InsetSpace ~
3614 If the loading of your config file fails, IPython starts with a bare bones
3943 If the loading of your config file fails, IPython starts with a bare bones
3615 configuration (no modules loaded at all).
3944 configuration (no modules loaded at all).
3616 \layout List
3945 \end_layout
3617 \labelwidthstring 00.00.0000
3618
3946
3947 \begin_layout List
3948 \labelwidthstring 00.00.0000
3619
3949
3620 \family typewriter
3950 \family typewriter
3621 \series bold
3951 \series bold
@@ -3626,33 +3956,35 b' Out['
3626 command history, among other things.
3956 command history, among other things.
3627 It is enabled by default, but may cause problems for users of X/Emacs in
3957 It is enabled by default, but may cause problems for users of X/Emacs in
3628 Python comint or shell buffers.
3958 Python comint or shell buffers.
3629 \layout List
3959 \end_layout
3630 \labelwidthstring 00.00.0000
3631
3960
3632 \SpecialChar ~
3961 \begin_layout List
3962 \labelwidthstring 00.00.0000
3963 \InsetSpace ~
3633 Note that X/Emacs 'eterm' buffers (opened with
3964 Note that X/Emacs 'eterm' buffers (opened with
3634 \family typewriter
3965 \family typewriter
3635 M-x\SpecialChar ~
3966 M-x\InsetSpace ~
3636 term
3967 term
3637 \family default
3968 \family default
3638 ) support IPython's readline and syntax coloring fine, only 'emacs' (
3969 ) support IPython's readline and syntax coloring fine, only 'emacs' (
3639 \family typewriter
3970 \family typewriter
3640 M-x\SpecialChar ~
3971 M-x\InsetSpace ~
3641 shell
3972 shell
3642 \family default
3973 \family default
3643 and
3974 and
3644 \family typewriter
3975 \family typewriter
3645 C-c\SpecialChar ~
3976 C-c\InsetSpace ~
3646 !
3977 !
3647 \family default
3978 \family default
3648 ) buffers do not.
3979 ) buffers do not.
3649 \layout List
3980 \end_layout
3650 \labelwidthstring 00.00.0000
3651
3981
3982 \begin_layout List
3983 \labelwidthstring 00.00.0000
3652
3984
3653 \family typewriter
3985 \family typewriter
3654 \series bold
3986 \series bold
3655 -screen_length|sl\SpecialChar ~
3987 -screen_length|sl\InsetSpace ~
3656 <n>
3988 <n>
3657 \series default
3989 \series default
3658 :
3990 :
@@ -3661,10 +3993,11 b' C-c\\SpecialChar ~'
3661 This is used to control printing of very long strings.
3993 This is used to control printing of very long strings.
3662 Strings longer than this number of lines will be sent through a pager instead
3994 Strings longer than this number of lines will be sent through a pager instead
3663 of directly printed.
3995 of directly printed.
3664 \layout List
3996 \end_layout
3665 \labelwidthstring 00.00.0000
3666
3997
3667 \SpecialChar ~
3998 \begin_layout List
3999 \labelwidthstring 00.00.0000
4000 \InsetSpace ~
3668 The default value for this is 0, which means IPython will auto-detect your
4001 The default value for this is 0, which means IPython will auto-detect your
3669 screen size every time it needs to print certain potentially long strings
4002 screen size every time it needs to print certain potentially long strings
3670 (this doesn't change the behavior of the 'print' keyword, it's only triggered
4003 (this doesn't change the behavior of the 'print' keyword, it's only triggered
@@ -3672,13 +4005,14 b' C-c\\SpecialChar ~'
3672 If for some reason this isn't working well (it needs curses support), specify
4005 If for some reason this isn't working well (it needs curses support), specify
3673 it yourself.
4006 it yourself.
3674 Otherwise don't change the default.
4007 Otherwise don't change the default.
3675 \layout List
4008 \end_layout
3676 \labelwidthstring 00.00.0000
3677
4009
4010 \begin_layout List
4011 \labelwidthstring 00.00.0000
3678
4012
3679 \family typewriter
4013 \family typewriter
3680 \series bold
4014 \series bold
3681 -separate_in|si\SpecialChar ~
4015 -separate_in|si\InsetSpace ~
3682 <string>
4016 <string>
3683 \series default
4017 \series default
3684 :
4018 :
@@ -3691,39 +4025,43 b' C-c\\SpecialChar ~'
3691 n
4025 n
3692 \family default
4026 \family default
3693 '
4027 '
3694 \layout List
4028 \end_layout
3695 \labelwidthstring 00.00.0000
3696
4029
4030 \begin_layout List
4031 \labelwidthstring 00.00.0000
3697
4032
3698 \family typewriter
4033 \family typewriter
3699 \series bold
4034 \series bold
3700 -separate_out|so\SpecialChar ~
4035 -separate_out|so\InsetSpace ~
3701 <string>
4036 <string>
3702 \family default
4037 \family default
3703 \series default
4038 \series default
3704 : separator before output prompts.
4039 : separator before output prompts.
3705 Default: nothing.
4040 Default: nothing.
3706 \layout List
4041 \end_layout
3707 \labelwidthstring 00.00.0000
3708
4042
4043 \begin_layout List
4044 \labelwidthstring 00.00.0000
3709
4045
3710 \family typewriter
4046 \family typewriter
3711 \series bold
4047 \series bold
3712 -separate_out2|so2\SpecialChar ~
4048 -separate_out2|so2\InsetSpace ~
3713 <string>
4049 <string>
3714 \series default
4050 \series default
3715 :
4051 :
3716 \family default
4052 \family default
3717 separator after output prompts.
4053 separator after output prompts.
3718 Default: nothing.
4054 Default: nothing.
3719 \layout List
4055 \end_layout
3720 \labelwidthstring 00.00.0000
3721
4056
3722 \SpecialChar ~
4057 \begin_layout List
3723 For these three options, use the value 0 to specify no separator.
3724 \layout List
3725 \labelwidthstring 00.00.0000
4058 \labelwidthstring 00.00.0000
4059 \InsetSpace ~
4060 For these three options, use the value 0 to specify no separator.
4061 \end_layout
3726
4062
4063 \begin_layout List
4064 \labelwidthstring 00.00.0000
3727
4065
3728 \family typewriter
4066 \family typewriter
3729 \series bold
4067 \series bold
@@ -3737,9 +4075,10 b' shorthand for'
3737 \family default
4075 \family default
3738 .
4076 .
3739 Simply removes all input/output separators.
4077 Simply removes all input/output separators.
3740 \layout List
4078 \end_layout
3741 \labelwidthstring 00.00.0000
3742
4079
4080 \begin_layout List
4081 \labelwidthstring 00.00.0000
3743
4082
3744 \family typewriter
4083 \family typewriter
3745 \series bold
4084 \series bold
@@ -3759,9 +4098,10 b' IPYTHONDIR'
3759 \family default
4098 \family default
3760 extension) all files which it overwrites so that you can merge back any
4099 extension) all files which it overwrites so that you can merge back any
3761 customizations you might have in your personal files.
4100 customizations you might have in your personal files.
3762 \layout List
4101 \end_layout
3763 \labelwidthstring 00.00.0000
3764
4102
4103 \begin_layout List
4104 \labelwidthstring 00.00.0000
3765
4105
3766 \family typewriter
4106 \family typewriter
3767 \series bold
4107 \series bold
@@ -3770,13 +4110,14 b' IPYTHONDIR'
3770 :
4110 :
3771 \family default
4111 \family default
3772 print version information and exit.
4112 print version information and exit.
3773 \layout List
4113 \end_layout
3774 \labelwidthstring 00.00.0000
3775
4114
4115 \begin_layout List
4116 \labelwidthstring 00.00.0000
3776
4117
3777 \family typewriter
4118 \family typewriter
3778 \series bold
4119 \series bold
3779 -wxversion\SpecialChar ~
4120 -wxversion\InsetSpace ~
3780 <string>:
4121 <string>:
3781 \family default
4122 \family default
3782 \series default
4123 \series default
@@ -3786,38 +4127,43 b' IPYTHONDIR'
3786 \family default
4127 \family default
3787 ).
4128 ).
3788 Requires the wxversion module, part of recent wxPython distributions
4129 Requires the wxversion module, part of recent wxPython distributions
3789 \layout List
4130 \end_layout
3790 \labelwidthstring 00.00.0000
3791
4131
4132 \begin_layout List
4133 \labelwidthstring 00.00.0000
3792
4134
3793 \family typewriter
4135 \family typewriter
3794 \series bold
4136 \series bold
3795 -xmode\SpecialChar ~
4137 -xmode\InsetSpace ~
3796 <modename>
4138 <modename>
3797 \series default
4139 \series default
3798 :
4140 :
3799 \family default
4141 \family default
3800 Mode for exception reporting.
4142 Mode for exception reporting.
3801 \layout List
4143 \end_layout
3802 \labelwidthstring 00.00.0000
3803
4144
3804 \SpecialChar ~
4145 \begin_layout List
3805 Valid modes: Plain, Context and Verbose.
3806 \layout List
3807 \labelwidthstring 00.00.0000
4146 \labelwidthstring 00.00.0000
4147 \InsetSpace ~
4148 Valid modes: Plain, Context and Verbose.
4149 \end_layout
3808
4150
3809 \SpecialChar ~
4151 \begin_layout List
3810 Plain: similar to python's normal traceback printing.
3811 \layout List
3812 \labelwidthstring 00.00.0000
4152 \labelwidthstring 00.00.0000
4153 \InsetSpace ~
4154 Plain: similar to python's normal traceback printing.
4155 \end_layout
3813
4156
3814 \SpecialChar ~
4157 \begin_layout List
4158 \labelwidthstring 00.00.0000
4159 \InsetSpace ~
3815 Context: prints 5 lines of context source code around each line in the
4160 Context: prints 5 lines of context source code around each line in the
3816 traceback.
4161 traceback.
3817 \layout List
4162 \end_layout
3818 \labelwidthstring 00.00.0000
3819
4163
3820 \SpecialChar ~
4164 \begin_layout List
4165 \labelwidthstring 00.00.0000
4166 \InsetSpace ~
3821 Verbose: similar to Context, but additionally prints the variables currently
4167 Verbose: similar to Context, but additionally prints the variables currently
3822 visible where the exception happened (shortening their strings if too long).
4168 visible where the exception happened (shortening their strings if too long).
3823 This can potentially be very slow, if you happen to have a huge data structure
4169 This can potentially be very slow, if you happen to have a huge data structure
@@ -3825,11 +4171,13 b' IPYTHONDIR'
3825 Your computer may appear to freeze for a while with cpu usage at 100%.
4171 Your computer may appear to freeze for a while with cpu usage at 100%.
3826 If this occurs, you can cancel the traceback with Ctrl-C (maybe hitting
4172 If this occurs, you can cancel the traceback with Ctrl-C (maybe hitting
3827 it more than once).
4173 it more than once).
3828 \layout Section
4174 \end_layout
3829
4175
4176 \begin_layout Section
3830 Interactive use
4177 Interactive use
3831 \layout Standard
4178 \end_layout
3832
4179
4180 \begin_layout Standard
3833
4181
3834 \series bold
4182 \series bold
3835 Warning
4183 Warning
@@ -3844,8 +4192,9 b' __IP'
3844 __IP
4192 __IP
3845 \family default
4193 \family default
3846 to anything, bizarre behavior will quickly occur.
4194 to anything, bizarre behavior will quickly occur.
3847 \layout Standard
4195 \end_layout
3848
4196
4197 \begin_layout Standard
3849 Other than the above warning, IPython is meant to work as a drop-in replacement
4198 Other than the above warning, IPython is meant to work as a drop-in replacement
3850 for the standard interactive interpreter.
4199 for the standard interactive interpreter.
3851 As such, any code which is valid python should execute normally under IPython
4200 As such, any code which is valid python should execute normally under IPython
@@ -3853,11 +4202,13 b' Other than the above warning, IPython is meant to work as a drop-in replacement'
3853 It does, however, offer many features which are not available at a standard
4202 It does, however, offer many features which are not available at a standard
3854 python prompt.
4203 python prompt.
3855 What follows is a list of these.
4204 What follows is a list of these.
3856 \layout Subsection
4205 \end_layout
3857
4206
4207 \begin_layout Subsection
3858 Caution for Windows users
4208 Caution for Windows users
3859 \layout Standard
4209 \end_layout
3860
4210
4211 \begin_layout Standard
3861 Windows, unfortunately, uses the `
4212 Windows, unfortunately, uses the `
3862 \family typewriter
4213 \family typewriter
3863
4214
@@ -3881,8 +4232,9 b' Windows, unfortunately, uses the `'
3881
4232
3882 \family default
4233 \family default
3883 ' in them will cause strange errors.
4234 ' in them will cause strange errors.
3884 \layout Standard
4235 \end_layout
3885
4236
4237 \begin_layout Standard
3886 A partial solution is to use instead the `
4238 A partial solution is to use instead the `
3887 \family typewriter
4239 \family typewriter
3888 /
4240 /
@@ -3907,34 +4259,37 b' most'
3907 opt/foo/bar.txt
4259 opt/foo/bar.txt
3908 \backslash
4260 \backslash
3909 tmp
4261 tmp
3910 \layout Standard
4262 \end_layout
3911
4263
4264 \begin_layout Standard
3912 There is no sensible thing IPython can do to truly work around this flaw
4265 There is no sensible thing IPython can do to truly work around this flaw
3913 in Windows
4266 in Windows
3914 \begin_inset Foot
4267 \begin_inset Foot
3915 collapsed true
4268 status collapsed
3916
3917 \layout Standard
3918
4269
4270 \begin_layout Standard
3919 If anyone comes up with a
4271 If anyone comes up with a
3920 \emph on
4272 \emph on
3921 clean
4273 clean
3922 \emph default
4274 \emph default
3923 solution which works consistently and does not negatively impact other
4275 solution which works consistently and does not negatively impact other
3924 platforms at all, I'll gladly accept a patch.
4276 platforms at all, I'll gladly accept a patch.
4277 \end_layout
4278
3925 \end_inset
4279 \end_inset
3926
4280
3927 .
4281 .
3928 \layout Subsection
4282 \end_layout
3929
3930
4283
4284 \begin_layout Subsection
3931 \begin_inset LatexCommand \label{sec:magic}
4285 \begin_inset LatexCommand \label{sec:magic}
3932
4286
3933 \end_inset
4287 \end_inset
3934
4288
3935 Magic command system
4289 Magic command system
3936 \layout Standard
4290 \end_layout
3937
4291
4292 \begin_layout Standard
3938 IPython will treat any line whose first character is a
4293 IPython will treat any line whose first character is a
3939 \family typewriter
4294 \family typewriter
3940 %
4295 %
@@ -3947,8 +4302,9 b' IPython will treat any line whose first character is a'
3947 %
4302 %
3948 \family default
4303 \family default
3949 character, but parameters are given without parentheses or quotes.
4304 character, but parameters are given without parentheses or quotes.
3950 \layout Standard
4305 \end_layout
3951
4306
4307 \begin_layout Standard
3952 Example: typing
4308 Example: typing
3953 \family typewriter
4309 \family typewriter
3954 '%cd mydir'
4310 '%cd mydir'
@@ -3958,8 +4314,9 b' Example: typing'
3958 'mydir'
4314 'mydir'
3959 \family default
4315 \family default
3960 , if it exists.
4316 , if it exists.
3961 \layout Standard
4317 \end_layout
3962
4318
4319 \begin_layout Standard
3963 If you have 'automagic' enabled (in your
4320 If you have 'automagic' enabled (in your
3964 \family typewriter
4321 \family typewriter
3965 ipythonrc
4322 ipythonrc
@@ -3997,57 +4354,75 b' mydir'
3997 %
4354 %
3998 \family default
4355 \family default
3999 character at the beginning of the line.
4356 character at the beginning of the line.
4000 \layout Standard
4357 \end_layout
4001
4358
4359 \begin_layout Standard
4002 An example (with automagic on) should clarify all this:
4360 An example (with automagic on) should clarify all this:
4003 \layout LyX-Code
4361 \end_layout
4004
4362
4363 \begin_layout LyX-Code
4005 In [1]: cd ipython # %cd is called by automagic
4364 In [1]: cd ipython # %cd is called by automagic
4006 \layout LyX-Code
4365 \end_layout
4007
4366
4367 \begin_layout LyX-Code
4008 /home/fperez/ipython
4368 /home/fperez/ipython
4009 \layout LyX-Code
4369 \end_layout
4010
4370
4371 \begin_layout LyX-Code
4011 In [2]: cd=1 # now cd is just a variable
4372 In [2]: cd=1 # now cd is just a variable
4012 \layout LyX-Code
4373 \end_layout
4013
4374
4375 \begin_layout LyX-Code
4014 In [3]: cd ..
4376 In [3]: cd ..
4015 # and doesn't work as a function anymore
4377 # and doesn't work as a function anymore
4016 \layout LyX-Code
4378 \end_layout
4017
4379
4380 \begin_layout LyX-Code
4018 ------------------------------------------------------------
4381 ------------------------------------------------------------
4019 \layout LyX-Code
4382 \end_layout
4020
4383
4384 \begin_layout LyX-Code
4021 File "<console>", line 1
4385 File "<console>", line 1
4022 \layout LyX-Code
4386 \end_layout
4023
4387
4388 \begin_layout LyX-Code
4024 cd ..
4389 cd ..
4025 \layout LyX-Code
4390 \end_layout
4026
4391
4392 \begin_layout LyX-Code
4027 ^
4393 ^
4028 \layout LyX-Code
4394 \end_layout
4029
4395
4396 \begin_layout LyX-Code
4030 SyntaxError: invalid syntax
4397 SyntaxError: invalid syntax
4031 \layout LyX-Code
4398 \end_layout
4032
4399
4033 \layout LyX-Code
4400 \begin_layout LyX-Code
4034
4401
4402 \end_layout
4403
4404 \begin_layout LyX-Code
4035 In [4]: %cd ..
4405 In [4]: %cd ..
4036 # but %cd always works
4406 # but %cd always works
4037 \layout LyX-Code
4407 \end_layout
4038
4408
4409 \begin_layout LyX-Code
4039 /home/fperez
4410 /home/fperez
4040 \layout LyX-Code
4411 \end_layout
4041
4412
4413 \begin_layout LyX-Code
4042 In [5]: del cd # if you remove the cd variable
4414 In [5]: del cd # if you remove the cd variable
4043 \layout LyX-Code
4415 \end_layout
4044
4416
4417 \begin_layout LyX-Code
4045 In [6]: cd ipython # automagic can work again
4418 In [6]: cd ipython # automagic can work again
4046 \layout LyX-Code
4419 \end_layout
4047
4420
4421 \begin_layout LyX-Code
4048 /home/fperez/ipython
4422 /home/fperez/ipython
4049 \layout Standard
4423 \end_layout
4050
4424
4425 \begin_layout Standard
4051 You can define your own magic functions to extend the system.
4426 You can define your own magic functions to extend the system.
4052 The following is a snippet of code which shows how to do it.
4427 The following is a snippet of code which shows how to do it.
4053 It is provided as file
4428 It is provided as file
@@ -4055,34 +4430,40 b' You can define your own magic functions to extend the system.'
4055 example-magic.py
4430 example-magic.py
4056 \family default
4431 \family default
4057 in the examples directory:
4432 in the examples directory:
4058 \layout Standard
4433 \end_layout
4059
4060
4434
4435 \begin_layout Standard
4061 \begin_inset ERT
4436 \begin_inset ERT
4062 status Open
4437 status open
4438
4439 \begin_layout Standard
4063
4440
4064 \layout Standard
4065
4441
4066 \backslash
4442 \backslash
4067 codelist{examples/example-magic.py}
4443 codelist{examples/example-magic.py}
4444 \end_layout
4445
4068 \end_inset
4446 \end_inset
4069
4447
4070
4448
4071 \layout Standard
4449 \end_layout
4072
4450
4451 \begin_layout Standard
4073 You can also define your own aliased names for magic functions.
4452 You can also define your own aliased names for magic functions.
4074 In your
4453 In your
4075 \family typewriter
4454 \family typewriter
4076 ipythonrc
4455 ipythonrc
4077 \family default
4456 \family default
4078 file, placing a line like:
4457 file, placing a line like:
4079 \layout Standard
4458 \end_layout
4080
4459
4460 \begin_layout Standard
4081
4461
4082 \family typewriter
4462 \family typewriter
4083 execute __IP.magic_cl = __IP.magic_clear
4463 execute __IP.magic_cl = __IP.magic_clear
4084 \layout Standard
4464 \end_layout
4085
4465
4466 \begin_layout Standard
4086 will define
4467 will define
4087 \family typewriter
4468 \family typewriter
4088 %cl
4469 %cl
@@ -4092,8 +4473,9 b' will define'
4092 %clear
4473 %clear
4093 \family default
4474 \family default
4094 .
4475 .
4095 \layout Standard
4476 \end_layout
4096
4477
4478 \begin_layout Standard
4097 Type
4479 Type
4098 \family typewriter
4480 \family typewriter
4099 %magic
4481 %magic
@@ -4116,17 +4498,20 b' Type'
4116 \family default
4498 \family default
4117 system) to get information about any particular magic function you are
4499 system) to get information about any particular magic function you are
4118 interested in.
4500 interested in.
4119 \layout Subsubsection
4501 \end_layout
4120
4502
4503 \begin_layout Subsubsection
4121 Magic commands
4504 Magic commands
4122 \layout Standard
4505 \end_layout
4123
4506
4507 \begin_layout Standard
4124 The rest of this section is automatically generated for each release from
4508 The rest of this section is automatically generated for each release from
4125 the docstrings in the IPython code.
4509 the docstrings in the IPython code.
4126 Therefore the formatting is somewhat minimal, but this method has the advantage
4510 Therefore the formatting is somewhat minimal, but this method has the advantage
4127 of having information always in sync with the code.
4511 of having information always in sync with the code.
4128 \layout Standard
4512 \end_layout
4129
4513
4514 \begin_layout Standard
4130 A list of all the magic commands available in IPython's
4515 A list of all the magic commands available in IPython's
4131 \emph on
4516 \emph on
4132 default
4517 default
@@ -4138,20 +4523,22 b' default'
4138 \family default
4523 \family default
4139 at the prompt, but that will also give you information about magic commands
4524 at the prompt, but that will also give you information about magic commands
4140 you may have added as part of your personal customizations.
4525 you may have added as part of your personal customizations.
4141 \layout Standard
4526 \end_layout
4142
4143
4527
4528 \begin_layout Standard
4144 \begin_inset Include \input{magic.tex}
4529 \begin_inset Include \input{magic.tex}
4145 preview false
4530 preview false
4146
4531
4147 \end_inset
4532 \end_inset
4148
4533
4149
4534
4150 \layout Subsection
4535 \end_layout
4151
4536
4537 \begin_layout Subsection
4152 Access to the standard Python help
4538 Access to the standard Python help
4153 \layout Standard
4539 \end_layout
4154
4540
4541 \begin_layout Standard
4155 As of Python 2.1, a help system is available with access to object docstrings
4542 As of Python 2.1, a help system is available with access to object docstrings
4156 and the Python manuals.
4543 and the Python manuals.
4157 Simply type
4544 Simply type
@@ -4179,16 +4566,17 b" help('keyword')"
4179 PYTHONDOCS
4566 PYTHONDOCS
4180 \family default
4567 \family default
4181 for this feature to work correctly.
4568 for this feature to work correctly.
4182 \layout Subsection
4569 \end_layout
4183
4184
4570
4571 \begin_layout Subsection
4185 \begin_inset LatexCommand \label{sec:dyn-object-info}
4572 \begin_inset LatexCommand \label{sec:dyn-object-info}
4186
4573
4187 \end_inset
4574 \end_inset
4188
4575
4189 Dynamic object information
4576 Dynamic object information
4190 \layout Standard
4577 \end_layout
4191
4578
4579 \begin_layout Standard
4192 Typing
4580 Typing
4193 \family typewriter
4581 \family typewriter
4194 ?word
4582 ?word
@@ -4202,8 +4590,9 b' word?'
4202 get snipped in the center for brevity.
4590 get snipped in the center for brevity.
4203 This system gives access variable types and values, full source code for
4591 This system gives access variable types and values, full source code for
4204 any object (if available), function prototypes and other useful information.
4592 any object (if available), function prototypes and other useful information.
4205 \layout Standard
4593 \end_layout
4206
4594
4595 \begin_layout Standard
4207 Typing
4596 Typing
4208 \family typewriter
4597 \family typewriter
4209 ??word
4598 ??word
@@ -4223,8 +4612,9 b' less'
4223 less
4612 less
4224 \family default
4613 \family default
4225 command, IPython uses a very basic internal pager.
4614 command, IPython uses a very basic internal pager.
4226 \layout Standard
4615 \end_layout
4227
4616
4617 \begin_layout Standard
4228 The following magic functions are particularly useful for gathering information
4618 The following magic functions are particularly useful for gathering information
4229 about your working environment.
4619 about your working environment.
4230 You can get more details by typing
4620 You can get more details by typing
@@ -4240,57 +4630,62 b' The following magic functions are particularly useful for gathering information'
4240 %
4630 %
4241 \family default
4631 \family default
4242 ), this is just a summary:
4632 ), this is just a summary:
4243 \layout List
4633 \end_layout
4244 \labelwidthstring 00.00.0000
4245
4634
4635 \begin_layout List
4636 \labelwidthstring 00.00.0000
4246
4637
4247 \family typewriter
4638 \family typewriter
4248 \series bold
4639 \series bold
4249 %pdoc\SpecialChar ~
4640 %pdoc\InsetSpace ~
4250 <object>
4641 <object>
4251 \family default
4642 \family default
4252 \series default
4643 \series default
4253 : Print (or run through a pager if too long) the docstring for an object.
4644 : Print (or run through a pager if too long) the docstring for an object.
4254 If the given object is a class, it will print both the class and the constructo
4645 If the given object is a class, it will print both the class and the constructo
4255 r docstrings.
4646 r docstrings.
4256 \layout List
4647 \end_layout
4257 \labelwidthstring 00.00.0000
4258
4648
4649 \begin_layout List
4650 \labelwidthstring 00.00.0000
4259
4651
4260 \family typewriter
4652 \family typewriter
4261 \series bold
4653 \series bold
4262 %pdef\SpecialChar ~
4654 %pdef\InsetSpace ~
4263 <object>
4655 <object>
4264 \family default
4656 \family default
4265 \series default
4657 \series default
4266 : Print the definition header for any callable object.
4658 : Print the definition header for any callable object.
4267 If the object is a class, print the constructor information.
4659 If the object is a class, print the constructor information.
4268 \layout List
4660 \end_layout
4269 \labelwidthstring 00.00.0000
4270
4661
4662 \begin_layout List
4663 \labelwidthstring 00.00.0000
4271
4664
4272 \family typewriter
4665 \family typewriter
4273 \series bold
4666 \series bold
4274 %psource\SpecialChar ~
4667 %psource\InsetSpace ~
4275 <object>
4668 <object>
4276 \family default
4669 \family default
4277 \series default
4670 \series default
4278 : Print (or run through a pager if too long) the source code for an object.
4671 : Print (or run through a pager if too long) the source code for an object.
4279 \layout List
4672 \end_layout
4280 \labelwidthstring 00.00.0000
4281
4673
4674 \begin_layout List
4675 \labelwidthstring 00.00.0000
4282
4676
4283 \family typewriter
4677 \family typewriter
4284 \series bold
4678 \series bold
4285 %pfile\SpecialChar ~
4679 %pfile\InsetSpace ~
4286 <object>
4680 <object>
4287 \family default
4681 \family default
4288 \series default
4682 \series default
4289 : Show the entire source file where an object was defined via a pager, opening
4683 : Show the entire source file where an object was defined via a pager, opening
4290 it at the line where the object definition begins.
4684 it at the line where the object definition begins.
4291 \layout List
4685 \end_layout
4292 \labelwidthstring 00.00.0000
4293
4686
4687 \begin_layout List
4688 \labelwidthstring 00.00.0000
4294
4689
4295 \family typewriter
4690 \family typewriter
4296 \series bold
4691 \series bold
@@ -4308,8 +4703,9 b' ely (not things you loaded or defined in your configuration files).'
4308 %whos
4703 %whos
4309 \family default
4704 \family default
4310 prints a table with some basic details about each identifier.
4705 prints a table with some basic details about each identifier.
4311 \layout Standard
4706 \end_layout
4312
4707
4708 \begin_layout Standard
4313 Note that the dynamic object information functions (
4709 Note that the dynamic object information functions (
4314 \family typewriter
4710 \family typewriter
4315 ?/??, %pdoc, %pfile, %pdef, %psource
4711 ?/??, %pdoc, %pfile, %pdef, %psource
@@ -4329,39 +4725,45 b' import os'
4329 os.path.abspath??
4725 os.path.abspath??
4330 \family default
4726 \family default
4331 .
4727 .
4332 \layout Subsection
4728 \end_layout
4333
4334
4729
4730 \begin_layout Subsection
4335 \begin_inset LatexCommand \label{sec:readline}
4731 \begin_inset LatexCommand \label{sec:readline}
4336
4732
4337 \end_inset
4733 \end_inset
4338
4734
4339 Readline-based features
4735 Readline-based features
4340 \layout Standard
4736 \end_layout
4341
4737
4738 \begin_layout Standard
4342 These features require the GNU readline library, so they won't work if your
4739 These features require the GNU readline library, so they won't work if your
4343 Python installation lacks readline support.
4740 Python installation lacks readline support.
4344 We will first describe the default behavior IPython uses, and then how
4741 We will first describe the default behavior IPython uses, and then how
4345 to change it to suit your preferences.
4742 to change it to suit your preferences.
4346 \layout Subsubsection
4743 \end_layout
4347
4744
4745 \begin_layout Subsubsection
4348 Command line completion
4746 Command line completion
4349 \layout Standard
4747 \end_layout
4350
4748
4749 \begin_layout Standard
4351 At any time, hitting TAB will complete any available python commands or
4750 At any time, hitting TAB will complete any available python commands or
4352 variable names, and show you a list of the possible completions if there's
4751 variable names, and show you a list of the possible completions if there's
4353 no unambiguous one.
4752 no unambiguous one.
4354 It will also complete filenames in the current directory if no python names
4753 It will also complete filenames in the current directory if no python names
4355 match what you've typed so far.
4754 match what you've typed so far.
4356 \layout Subsubsection
4755 \end_layout
4357
4756
4757 \begin_layout Subsubsection
4358 Search command history
4758 Search command history
4359 \layout Standard
4759 \end_layout
4360
4760
4761 \begin_layout Standard
4361 IPython provides two ways for searching through previous input and thus
4762 IPython provides two ways for searching through previous input and thus
4362 reduce the need for repetitive typing:
4763 reduce the need for repetitive typing:
4363 \layout Enumerate
4764 \end_layout
4364
4765
4766 \begin_layout Enumerate
4365 Start typing, and then use
4767 Start typing, and then use
4366 \family typewriter
4768 \family typewriter
4367 Ctrl-p
4769 Ctrl-p
@@ -4377,8 +4779,9 b' Ctrl-n'
4377 Ctrl-p/Ctrl-n
4779 Ctrl-p/Ctrl-n
4378 \family default
4780 \family default
4379 at a blank prompt, they just behave like normal arrow keys.
4781 at a blank prompt, they just behave like normal arrow keys.
4380 \layout Enumerate
4782 \end_layout
4381
4783
4784 \begin_layout Enumerate
4382 Hit
4785 Hit
4383 \family typewriter
4786 \family typewriter
4384 Ctrl-r
4787 Ctrl-r
@@ -4386,11 +4789,13 b' Ctrl-r'
4386 : opens a search prompt.
4789 : opens a search prompt.
4387 Begin typing and the system searches your history for lines that contain
4790 Begin typing and the system searches your history for lines that contain
4388 what you've typed so far, completing as much as it can.
4791 what you've typed so far, completing as much as it can.
4389 \layout Subsubsection
4792 \end_layout
4390
4793
4794 \begin_layout Subsubsection
4391 Persistent command history across sessions
4795 Persistent command history across sessions
4392 \layout Standard
4796 \end_layout
4393
4797
4798 \begin_layout Standard
4394 IPython will save your input history when it leaves and reload it next time
4799 IPython will save your input history when it leaves and reload it next time
4395 you restart it.
4800 you restart it.
4396 By default, the history file is named
4801 By default, the history file is named
@@ -4405,16 +4810,19 b' $IPYTHONDIR/history'
4405 This allows you to keep separate histories related to various tasks: commands
4810 This allows you to keep separate histories related to various tasks: commands
4406 related to numerical work will not be clobbered by a system shell history,
4811 related to numerical work will not be clobbered by a system shell history,
4407 for example.
4812 for example.
4408 \layout Subsubsection
4813 \end_layout
4409
4814
4815 \begin_layout Subsubsection
4410 Autoindent
4816 Autoindent
4411 \layout Standard
4817 \end_layout
4412
4818
4819 \begin_layout Standard
4413 IPython can recognize lines ending in ':' and indent the next line, while
4820 IPython can recognize lines ending in ':' and indent the next line, while
4414 also un-indenting automatically after 'raise' or 'return'.
4821 also un-indenting automatically after 'raise' or 'return'.
4415
4822
4416 \layout Standard
4823 \end_layout
4417
4824
4825 \begin_layout Standard
4418 This feature uses the readline library, so it will honor your
4826 This feature uses the readline library, so it will honor your
4419 \family typewriter
4827 \family typewriter
4420 ~/.inputrc
4828 ~/.inputrc
@@ -4437,18 +4845,19 b' M-i'
4437 M-u
4845 M-u
4438 \family default
4846 \family default
4439 unindents):
4847 unindents):
4440 \layout Standard
4848 \end_layout
4441
4849
4850 \begin_layout Standard
4442
4851
4443 \family typewriter
4852 \family typewriter
4444 $if Python
4853 $if Python
4445 \newline
4854 \newline
4446 "
4855 "
4447 \backslash
4856 \backslash
4448 M-i": "\SpecialChar ~
4857 M-i": "\InsetSpace ~
4449 \SpecialChar ~
4858 \InsetSpace ~
4450 \SpecialChar ~
4859 \InsetSpace ~
4451 \SpecialChar ~
4860 \InsetSpace ~
4452 "
4861 "
4453 \newline
4862 \newline
4454 "
4863 "
@@ -4464,15 +4873,17 b' d'
4464 d"
4873 d"
4465 \newline
4874 \newline
4466 $endif
4875 $endif
4467 \layout Standard
4876 \end_layout
4468
4877
4878 \begin_layout Standard
4469 Note that there are 4 spaces between the quote marks after
4879 Note that there are 4 spaces between the quote marks after
4470 \family typewriter
4880 \family typewriter
4471 "M-i"
4881 "M-i"
4472 \family default
4882 \family default
4473 above.
4883 above.
4474 \layout Standard
4884 \end_layout
4475
4885
4886 \begin_layout Standard
4476
4887
4477 \series bold
4888 \series bold
4478 Warning:
4889 Warning:
@@ -4493,11 +4904,13 b' ipythonrc'
4493 autoindent 0
4904 autoindent 0
4494 \family default
4905 \family default
4495 ).
4906 ).
4496 \layout Subsubsection
4907 \end_layout
4497
4908
4909 \begin_layout Subsubsection
4498 Customizing readline behavior
4910 Customizing readline behavior
4499 \layout Standard
4911 \end_layout
4500
4912
4913 \begin_layout Standard
4501 All these features are based on the GNU readline library, which has an extremely
4914 All these features are based on the GNU readline library, which has an extremely
4502 customizable interface.
4915 customizable interface.
4503 Normally, readline is configured via a file which defines the behavior
4916 Normally, readline is configured via a file which defines the behavior
@@ -4515,9 +4928,10 b' ipythonrc'
4515 not
4928 not
4516 \emph default
4929 \emph default
4517 be specified at the command line):
4930 be specified at the command line):
4518 \layout List
4931 \end_layout
4519 \labelwidthstring 00.00.0000
4520
4932
4933 \begin_layout List
4934 \labelwidthstring 00.00.0000
4521
4935
4522 \family typewriter
4936 \family typewriter
4523 \series bold
4937 \series bold
@@ -4533,9 +4947,10 b' readline.parse_and_bind()'
4533 The syntax for valid commands of this kind can be found by reading the
4947 The syntax for valid commands of this kind can be found by reading the
4534 documentation for the GNU readline library, as these commands are of the
4948 documentation for the GNU readline library, as these commands are of the
4535 kind which readline accepts in its configuration file.
4949 kind which readline accepts in its configuration file.
4536 \layout List
4950 \end_layout
4537 \labelwidthstring 00.00.0000
4538
4951
4952 \begin_layout List
4953 \labelwidthstring 00.00.0000
4539
4954
4540 \family typewriter
4955 \family typewriter
4541 \series bold
4956 \series bold
@@ -4546,9 +4961,10 b' readline_remove_delims:'
4546 used by readline, so that completions may be performed on strings which
4961 used by readline, so that completions may be performed on strings which
4547 contain them.
4962 contain them.
4548 Do not change the default value unless you know what you're doing.
4963 Do not change the default value unless you know what you're doing.
4549 \layout List
4964 \end_layout
4550 \labelwidthstring 00.00.0000
4551
4965
4966 \begin_layout List
4967 \labelwidthstring 00.00.0000
4552
4968
4553 \family typewriter
4969 \family typewriter
4554 \series bold
4970 \series bold
@@ -4593,25 +5009,29 b' name._<tab>'
4593 _
5009 _
4594 \family default
5010 \family default
4595 '.
5011 '.
4596 \layout List
5012 \end_layout
4597 \labelwidthstring 00.00.0000
4598
5013
4599 \SpecialChar ~
5014 \begin_layout List
5015 \labelwidthstring 00.00.0000
5016 \InsetSpace ~
4600 This option is off by default so that new users see all attributes of any
5017 This option is off by default so that new users see all attributes of any
4601 objects they are dealing with.
5018 objects they are dealing with.
4602 \layout Standard
5019 \end_layout
4603
5020
5021 \begin_layout Standard
4604 You will find the default values along with a corresponding detailed explanation
5022 You will find the default values along with a corresponding detailed explanation
4605 in your
5023 in your
4606 \family typewriter
5024 \family typewriter
4607 ipythonrc
5025 ipythonrc
4608 \family default
5026 \family default
4609 file.
5027 file.
4610 \layout Subsection
5028 \end_layout
4611
5029
5030 \begin_layout Subsection
4612 Session logging and restoring
5031 Session logging and restoring
4613 \layout Standard
5032 \end_layout
4614
5033
5034 \begin_layout Standard
4615 You can log all input from a session either by starting IPython with the
5035 You can log all input from a session either by starting IPython with the
4616 command line switches
5036 command line switches
4617 \family typewriter
5037 \family typewriter
@@ -4633,8 +5053,9 b' You can log all input from a session either by starting IPython with the'
4633 \family default
5053 \family default
4634 .
5054 .
4635
5055
4636 \layout Standard
5056 \end_layout
4637
5057
5058 \begin_layout Standard
4638 Log files can later be reloaded with the
5059 Log files can later be reloaded with the
4639 \family typewriter
5060 \family typewriter
4640 -logplay
5061 -logplay
@@ -4642,27 +5063,31 b' Log files can later be reloaded with the'
4642 option and IPython will attempt to 'replay' the log by executing all the
5063 option and IPython will attempt to 'replay' the log by executing all the
4643 lines in it, thus restoring the state of a previous session.
5064 lines in it, thus restoring the state of a previous session.
4644 This feature is not quite perfect, but can still be useful in many cases.
5065 This feature is not quite perfect, but can still be useful in many cases.
4645 \layout Standard
5066 \end_layout
4646
5067
5068 \begin_layout Standard
4647 The log files can also be used as a way to have a permanent record of any
5069 The log files can also be used as a way to have a permanent record of any
4648 code you wrote while experimenting.
5070 code you wrote while experimenting.
4649 Log files are regular text files which you can later open in your favorite
5071 Log files are regular text files which you can later open in your favorite
4650 text editor to extract code or to 'clean them up' before using them to
5072 text editor to extract code or to 'clean them up' before using them to
4651 replay a session.
5073 replay a session.
4652 \layout Standard
5074 \end_layout
4653
5075
5076 \begin_layout Standard
4654 The
5077 The
4655 \family typewriter
5078 \family typewriter
4656 %logstart
5079 %logstart
4657 \family default
5080 \family default
4658 function for activating logging in mid-session is used as follows:
5081 function for activating logging in mid-session is used as follows:
4659 \layout Standard
5082 \end_layout
4660
5083
5084 \begin_layout Standard
4661
5085
4662 \family typewriter
5086 \family typewriter
4663 %logstart [log_name [log_mode]]
5087 %logstart [log_name [log_mode]]
4664 \layout Standard
5088 \end_layout
4665
5089
5090 \begin_layout Standard
4666 If no name is given, it defaults to a file named
5091 If no name is given, it defaults to a file named
4667 \family typewriter
5092 \family typewriter
4668 'log'
5093 'log'
@@ -4672,8 +5097,9 b' If no name is given, it defaults to a file named'
4672 'rotate'
5097 'rotate'
4673 \family default
5098 \family default
4674 mode (see below).
5099 mode (see below).
4675 \layout Standard
5100 \end_layout
4676
5101
5102 \begin_layout Standard
4677 '
5103 '
4678 \family typewriter
5104 \family typewriter
4679 %logstart name
5105 %logstart name
@@ -4688,17 +5114,19 b' If no name is given, it defaults to a file named'
4688 \family default
5114 \family default
4689 mode.
5115 mode.
4690 It saves your history up to that point and then continues logging.
5116 It saves your history up to that point and then continues logging.
4691 \layout Standard
5117 \end_layout
4692
5118
5119 \begin_layout Standard
4693
5120
4694 \family typewriter
5121 \family typewriter
4695 %logstart
5122 %logstart
4696 \family default
5123 \family default
4697 takes a second optional parameter: logging mode.
5124 takes a second optional parameter: logging mode.
4698 This can be one of (note that the modes are given unquoted):
5125 This can be one of (note that the modes are given unquoted):
4699 \layout List
5126 \end_layout
4700 \labelwidthstring 00.00.0000
4701
5127
5128 \begin_layout List
5129 \labelwidthstring 00.00.0000
4702
5130
4703 \family typewriter
5131 \family typewriter
4704 over
5132 over
@@ -4708,9 +5136,10 b' over'
4708 log_name
5136 log_name
4709 \family default
5137 \family default
4710 .
5138 .
4711 \layout List
5139 \end_layout
4712 \labelwidthstring 00.00.0000
4713
5140
5141 \begin_layout List
5142 \labelwidthstring 00.00.0000
4714
5143
4715 \family typewriter
5144 \family typewriter
4716 backup
5145 backup
@@ -4724,17 +5153,19 b' log_name~'
4724 log_name
5153 log_name
4725 \family default
5154 \family default
4726 .
5155 .
4727 \layout List
5156 \end_layout
4728 \labelwidthstring 00.00.0000
4729
5157
5158 \begin_layout List
5159 \labelwidthstring 00.00.0000
4730
5160
4731 \family typewriter
5161 \family typewriter
4732 append
5162 append
4733 \family default
5163 \family default
4734 : well, that says it.
5164 : well, that says it.
4735 \layout List
5165 \end_layout
4736 \labelwidthstring 00.00.0000
4737
5166
5167 \begin_layout List
5168 \labelwidthstring 00.00.0000
4738
5169
4739 \family typewriter
5170 \family typewriter
4740 rotate
5171 rotate
@@ -4752,8 +5183,9 b' log_name'
4752 log_name.2~
5183 log_name.2~
4753 \family default
5184 \family default
4754 , etc.
5185 , etc.
4755 \layout Standard
5186 \end_layout
4756
5187
5188 \begin_layout Standard
4757 The
5189 The
4758 \family typewriter
5190 \family typewriter
4759 %logoff
5191 %logoff
@@ -4770,16 +5202,17 b' The'
4770 .
5202 .
4771 They will fail (with an explanation) if you try to use them before logging
5203 They will fail (with an explanation) if you try to use them before logging
4772 has been started.
5204 has been started.
4773 \layout Subsection
5205 \end_layout
4774
4775
5206
5207 \begin_layout Subsection
4776 \begin_inset LatexCommand \label{sub:System-shell-access}
5208 \begin_inset LatexCommand \label{sub:System-shell-access}
4777
5209
4778 \end_inset
5210 \end_inset
4779
5211
4780 System shell access
5212 System shell access
4781 \layout Standard
5213 \end_layout
4782
5214
5215 \begin_layout Standard
4783 Any input line beginning with a
5216 Any input line beginning with a
4784 \family typewriter
5217 \family typewriter
4785 !
5218 !
@@ -4798,11 +5231,13 b' Any input line beginning with a'
4798 'ls'
5231 'ls'
4799 \family default
5232 \family default
4800 in the current directory.
5233 in the current directory.
4801 \layout Subsubsection
5234 \end_layout
4802
5235
5236 \begin_layout Subsubsection
4803 Manual capture of command output
5237 Manual capture of command output
4804 \layout Standard
5238 \end_layout
4805
5239
5240 \begin_layout Standard
4806 If the input line begins with
5241 If the input line begins with
4807 \emph on
5242 \emph on
4808 two
5243 two
@@ -4824,8 +5259,9 b' two'
4824 %sx
5259 %sx
4825 \family default
5260 \family default
4826 magic command.
5261 magic command.
4827 \layout Standard
5262 \end_layout
4828
5263
5264 \begin_layout Standard
4829 Finally, the
5265 Finally, the
4830 \family typewriter
5266 \family typewriter
4831 %sc
5267 %sc
@@ -4836,9 +5272,10 b' Finally, the'
4836 \family default
5272 \family default
4837 , but allowing more fine-grained control of the capture details, and storing
5273 , but allowing more fine-grained control of the capture details, and storing
4838 the result directly into a named variable.
5274 the result directly into a named variable.
4839 \layout Standard
5275 \end_layout
4840
5276
4841 See Sec.\SpecialChar ~
5277 \begin_layout Standard
5278 See Sec.\InsetSpace ~
4842
5279
4843 \begin_inset LatexCommand \ref{sec:magic}
5280 \begin_inset LatexCommand \ref{sec:magic}
4844
5281
@@ -4861,8 +5298,9 b' sc?'
4861 sx?
5298 sx?
4862 \family default
5299 \family default
4863 ) for further details.
5300 ) for further details.
4864 \layout Standard
5301 \end_layout
4865
5302
5303 \begin_layout Standard
4866 IPython also allows you to expand the value of python variables when making
5304 IPython also allows you to expand the value of python variables when making
4867 system calls.
5305 system calls.
4868 Any python variable or expression which you prepend with
5306 Any python variable or expression which you prepend with
@@ -4871,39 +5309,45 b' $'
4871 \family default
5309 \family default
4872 will get expanded before the system call is made.
5310 will get expanded before the system call is made.
4873
5311
4874 \layout Standard
5312 \end_layout
4875
5313
5314 \begin_layout Standard
4876
5315
4877 \family typewriter
5316 \family typewriter
4878 In [1]: pyvar='Hello world'
5317 In [1]: pyvar='Hello world'
4879 \newline
5318 \newline
4880 In [2]: !echo "A python variable: $pyvar"
5319 In [2]: !echo "A python variable: $pyvar"
4881 \newline
5320 \newline
4882 A python variable: Hello world
5321 A python
4883 \layout Standard
5322 variable: Hello world
5323 \end_layout
4884
5324
5325 \begin_layout Standard
4885 If you want the shell to actually see a literal
5326 If you want the shell to actually see a literal
4886 \family typewriter
5327 \family typewriter
4887 $
5328 $
4888 \family default
5329 \family default
4889 , you need to type it twice:
5330 , you need to type it twice:
4890 \layout Standard
5331 \end_layout
4891
5332
5333 \begin_layout Standard
4892
5334
4893 \family typewriter
5335 \family typewriter
4894 In [3]: !echo "A system variable: $$HOME"
5336 In [3]: !echo "A system variable: $$HOME"
4895 \newline
5337 \newline
4896 A system variable: /home/fperez
5338 A system variable: /home/fperez
4897 \layout Standard
5339 \end_layout
4898
5340
5341 \begin_layout Standard
4899 You can pass arbitrary expressions, though you'll need to delimit them with
5342 You can pass arbitrary expressions, though you'll need to delimit them with
4900
5343
4901 \family typewriter
5344 \family typewriter
4902 {}
5345 {}
4903 \family default
5346 \family default
4904 if there is ambiguity as to the extent of the expression:
5347 if there is ambiguity as to the extent of the expression:
4905 \layout Standard
5348 \end_layout
4906
5349
5350 \begin_layout Standard
4907
5351
4908 \family typewriter
5352 \family typewriter
4909 In [5]: x=10
5353 In [5]: x=10
@@ -4917,21 +5361,26 b' In [13]: !echo $x+y'
4917 In [7]: !echo ${x+y}
5361 In [7]: !echo ${x+y}
4918 \newline
5362 \newline
4919 30
5363 30
4920 \layout Standard
4921
5364
5365 \end_layout
5366
5367 \begin_layout Standard
4922 Even object attributes can be expanded:
5368 Even object attributes can be expanded:
4923 \layout Standard
5369 \end_layout
4924
5370
5371 \begin_layout Standard
4925
5372
4926 \family typewriter
5373 \family typewriter
4927 In [12]: !echo $sys.argv
5374 In [12]: !echo $sys.argv
4928 \newline
5375 \newline
4929 [/home/fperez/usr/bin/ipython]
5376 [/home/fperez/usr/bin/ipython]
4930 \layout Subsection
5377 \end_layout
4931
5378
5379 \begin_layout Subsection
4932 System command aliases
5380 System command aliases
4933 \layout Standard
5381 \end_layout
4934
5382
5383 \begin_layout Standard
4935 The
5384 The
4936 \family typewriter
5385 \family typewriter
4937 %alias
5386 %alias
@@ -4948,8 +5397,9 b' ipythonrc'
4948 system shell commands.
5397 system shell commands.
4949 These aliases can have parameters.
5398 These aliases can have parameters.
4950
5399
4951 \layout Standard
5400 \end_layout
4952
5401
5402 \begin_layout Standard
4953 '
5403 '
4954 \family typewriter
5404 \family typewriter
4955 %alias alias_name cmd
5405 %alias alias_name cmd
@@ -4963,8 +5413,9 b' alias_name'
4963 cmd
5413 cmd
4964 \family default
5414 \family default
4965 '
5415 '
4966 \layout Standard
5416 \end_layout
4967
5417
5418 \begin_layout Standard
4968 Then, typing '
5419 Then, typing '
4969 \family typewriter
5420 \family typewriter
4970 %alias_name params
5421 %alias_name params
@@ -4975,8 +5426,9 b' cmd params'
4975 \family default
5426 \family default
4976 ' (from your underlying operating system).
5427 ' (from your underlying operating system).
4977
5428
4978 \layout Standard
5429 \end_layout
4979
5430
5431 \begin_layout Standard
4980 You can also define aliases with parameters using
5432 You can also define aliases with parameters using
4981 \family typewriter
5433 \family typewriter
4982 %s
5434 %s
@@ -4997,15 +5449,17 b' echo first %s second %s'
4997 will be replaced by a positional parameter to the call to
5449 will be replaced by a positional parameter to the call to
4998 \family typewriter
5450 \family typewriter
4999 %parts:
5451 %parts:
5000 \layout Standard
5452 \end_layout
5001
5453
5454 \begin_layout Standard
5002
5455
5003 \family typewriter
5456 \family typewriter
5004 In [1]: alias parts echo first %s second %s
5457 In [1]: alias parts echo first %s second %s
5005 \newline
5458 \newline
5006 In [2]: %parts A B
5459 In [2]: %parts A B
5007 \newline
5460 \newline
5008 first A second B
5461 first A second
5462 B
5009 \newline
5463 \newline
5010 In [3]: %parts A
5464 In [3]: %parts A
5011 \newline
5465 \newline
@@ -5013,15 +5467,17 b' Incorrect number of arguments: 2 expected.'
5013
5467
5014 \newline
5468 \newline
5015 parts is an alias to: 'echo first %s second %s'
5469 parts is an alias to: 'echo first %s second %s'
5016 \layout Standard
5470 \end_layout
5017
5471
5472 \begin_layout Standard
5018 If called with no parameters,
5473 If called with no parameters,
5019 \family typewriter
5474 \family typewriter
5020 %alias
5475 %alias
5021 \family default
5476 \family default
5022 prints the table of currently defined aliases.
5477 prints the table of currently defined aliases.
5023 \layout Standard
5478 \end_layout
5024
5479
5480 \begin_layout Standard
5025 The
5481 The
5026 \family typewriter
5482 \family typewriter
5027 %rehash/rehashx
5483 %rehash/rehashx
@@ -5031,34 +5487,37 b' The'
5031 $PATH
5487 $PATH
5032 \family default
5488 \family default
5033 as ipython aliases.
5489 as ipython aliases.
5034 See their respective docstrings (or sec.\SpecialChar ~
5490 See their respective docstrings (or sec.\InsetSpace ~
5035
5491
5036 \begin_inset LatexCommand \ref{sec:magic}
5492 \begin_inset LatexCommand \ref{sec:magic}
5037
5493
5038 \end_inset
5494 \end_inset
5039
5495
5040 for further details).
5496 for further details).
5041 \layout Subsection
5497 \end_layout
5042
5043
5498
5499 \begin_layout Subsection
5044 \begin_inset LatexCommand \label{sec:dreload}
5500 \begin_inset LatexCommand \label{sec:dreload}
5045
5501
5046 \end_inset
5502 \end_inset
5047
5503
5048 Recursive reload
5504 Recursive reload
5049 \layout Standard
5505 \end_layout
5050
5506
5507 \begin_layout Standard
5051 The
5508 The
5052 \family typewriter
5509 \family typewriter
5053 dreload
5510 dreload
5054 \family default
5511 \family default
5055 function does a recursive reload of a module: changes made to the module
5512 function does a recursive reload of a module: changes made to the module
5056 since you imported will actually be available without having to exit.
5513 since you imported will actually be available without having to exit.
5057 \layout Subsection
5514 \end_layout
5058
5515
5516 \begin_layout Subsection
5059 Verbose and colored exception traceback printouts
5517 Verbose and colored exception traceback printouts
5060 \layout Standard
5518 \end_layout
5061
5519
5520 \begin_layout Standard
5062 IPython provides the option to see very detailed exception tracebacks, which
5521 IPython provides the option to see very detailed exception tracebacks, which
5063 can be especially useful when debugging large programs.
5522 can be especially useful when debugging large programs.
5064 You can run any Python file with the
5523 You can run any Python file with the
@@ -5068,8 +5527,9 b' IPython provides the option to see very detailed exception tracebacks, which'
5068 function to benefit from these detailed tracebacks.
5527 function to benefit from these detailed tracebacks.
5069 Furthermore, both normal and verbose tracebacks can be colored (if your
5528 Furthermore, both normal and verbose tracebacks can be colored (if your
5070 terminal supports it) which makes them much easier to parse visually.
5529 terminal supports it) which makes them much easier to parse visually.
5071 \layout Standard
5530 \end_layout
5072
5531
5532 \begin_layout Standard
5073 See the magic
5533 See the magic
5074 \family typewriter
5534 \family typewriter
5075 xmode
5535 xmode
@@ -5083,28 +5543,31 b' colors'
5083 %magic
5543 %magic
5084 \family default
5544 \family default
5085 ).
5545 ).
5086 \layout Standard
5546 \end_layout
5087
5547
5548 \begin_layout Standard
5088 These features are basically a terminal version of Ka-Ping Yee's
5549 These features are basically a terminal version of Ka-Ping Yee's
5089 \family typewriter
5550 \family typewriter
5090 cgitb
5551 cgitb
5091 \family default
5552 \family default
5092 module, now part of the standard Python library.
5553 module, now part of the standard Python library.
5093 \layout Subsection
5554 \end_layout
5094
5095
5555
5556 \begin_layout Subsection
5096 \begin_inset LatexCommand \label{sec:cache_input}
5557 \begin_inset LatexCommand \label{sec:cache_input}
5097
5558
5098 \end_inset
5559 \end_inset
5099
5560
5100 Input caching system
5561 Input caching system
5101 \layout Standard
5562 \end_layout
5102
5563
5564 \begin_layout Standard
5103 IPython offers numbered prompts (In/Out) with input and output caching.
5565 IPython offers numbered prompts (In/Out) with input and output caching.
5104 All input is saved and can be retrieved as variables (besides the usual
5566 All input is saved and can be retrieved as variables (besides the usual
5105 arrow key recall).
5567 arrow key recall).
5106 \layout Standard
5568 \end_layout
5107
5569
5570 \begin_layout Standard
5108 The following GLOBAL variables always exist (so don't overwrite them!):
5571 The following GLOBAL variables always exist (so don't overwrite them!):
5109
5572
5110 \family typewriter
5573 \family typewriter
@@ -5148,8 +5611,9 b' In'
5148 'In=_ih'
5611 'In=_ih'
5149 \family default
5612 \family default
5150 .
5613 .
5151 \layout Standard
5614 \end_layout
5152
5615
5616 \begin_layout Standard
5153 Additionally, global variables named
5617 Additionally, global variables named
5154 \family typewriter
5618 \family typewriter
5155 _i<n>
5619 _i<n>
@@ -5163,8 +5627,9 b' _i<n>'
5163
5627
5164 \family typewriter
5628 \family typewriter
5165 _i<n> == _ih[<n>] == In[<n>].
5629 _i<n> == _ih[<n>] == In[<n>].
5166 \layout Standard
5630 \end_layout
5167
5631
5632 \begin_layout Standard
5168 For example, what you typed at prompt 14 is available as
5633 For example, what you typed at prompt 14 is available as
5169 \family typewriter
5634 \family typewriter
5170 _i14,
5635 _i14,
@@ -5178,8 +5643,9 b' _ih[14]'
5178 In[14]
5643 In[14]
5179 \family default
5644 \family default
5180 .
5645 .
5181 \layout Standard
5646 \end_layout
5182
5647
5648 \begin_layout Standard
5183 This allows you to easily cut and paste multi line interactive prompts by
5649 This allows you to easily cut and paste multi line interactive prompts by
5184 printing them out: they print like a clean string, without prompt characters.
5650 printing them out: they print like a clean string, without prompt characters.
5185 You can also manipulate them like regular variables (they are strings),
5651 You can also manipulate them like regular variables (they are strings),
@@ -5192,8 +5658,9 b' This allows you to easily cut and paste multi line interactive prompts by'
5192 exec In[9:14]+In[18]
5658 exec In[9:14]+In[18]
5193 \family default
5659 \family default
5194 ' will re-execute lines 9 through 13 and line 18).
5660 ' will re-execute lines 9 through 13 and line 18).
5195 \layout Standard
5661 \end_layout
5196
5662
5663 \begin_layout Standard
5197 You can also re-execute multiple lines of input easily by using the magic
5664 You can also re-execute multiple lines of input easily by using the magic
5198
5665
5199 \family typewriter
5666 \family typewriter
@@ -5218,8 +5685,9 b' exec'
5218 \end_inset
5685 \end_inset
5219
5686
5220 for more details on the macro system.
5687 for more details on the macro system.
5221 \layout Standard
5688 \end_layout
5222
5689
5690 \begin_layout Standard
5223 A history function
5691 A history function
5224 \family typewriter
5692 \family typewriter
5225 %hist
5693 %hist
@@ -5230,16 +5698,17 b' A history function'
5230 _i
5698 _i
5231 \family default
5699 \family default
5232 variables.
5700 variables.
5233 \layout Subsection
5701 \end_layout
5234
5235
5702
5703 \begin_layout Subsection
5236 \begin_inset LatexCommand \label{sec:cache_output}
5704 \begin_inset LatexCommand \label{sec:cache_output}
5237
5705
5238 \end_inset
5706 \end_inset
5239
5707
5240 Output caching system
5708 Output caching system
5241 \layout Standard
5709 \end_layout
5242
5710
5711 \begin_layout Standard
5243 For output that is returned from actions, a system similar to the input
5712 For output that is returned from actions, a system similar to the input
5244 cache exists but using
5713 cache exists but using
5245 \family typewriter
5714 \family typewriter
@@ -5260,13 +5729,15 b' _'
5260 %
5729 %
5261 \family default
5730 \family default
5262 variables.
5731 variables.
5263 \layout Standard
5732 \end_layout
5264
5733
5734 \begin_layout Standard
5265 The following GLOBAL variables always exist (so don't overwrite them!):
5735 The following GLOBAL variables always exist (so don't overwrite them!):
5266
5736
5267 \layout List
5737 \end_layout
5268 \labelwidthstring 00.00.0000
5269
5738
5739 \begin_layout List
5740 \labelwidthstring 00.00.0000
5270
5741
5271 \family typewriter
5742 \family typewriter
5272 \series bold
5743 \series bold
@@ -5278,9 +5749,10 b' _'
5278 single
5749 single
5279 \emph default
5750 \emph default
5280 underscore) : stores previous output, like Python's default interpreter.
5751 underscore) : stores previous output, like Python's default interpreter.
5281 \layout List
5752 \end_layout
5282 \labelwidthstring 00.00.0000
5283
5753
5754 \begin_layout List
5755 \labelwidthstring 00.00.0000
5284
5756
5285 \family typewriter
5757 \family typewriter
5286 \series bold
5758 \series bold
@@ -5288,9 +5760,10 b' __'
5288 \family default
5760 \family default
5289 \series default
5761 \series default
5290 (two underscores): next previous.
5762 (two underscores): next previous.
5291 \layout List
5763 \end_layout
5292 \labelwidthstring 00.00.0000
5293
5764
5765 \begin_layout List
5766 \labelwidthstring 00.00.0000
5294
5767
5295 \family typewriter
5768 \family typewriter
5296 \series bold
5769 \series bold
@@ -5298,8 +5771,9 b' ___'
5298 \family default
5771 \family default
5299 \series default
5772 \series default
5300 (three underscores): next-next previous.
5773 (three underscores): next-next previous.
5301 \layout Standard
5774 \end_layout
5302
5775
5776 \begin_layout Standard
5303 Additionally, global variables named
5777 Additionally, global variables named
5304 \family typewriter
5778 \family typewriter
5305 _<n>
5779 _<n>
@@ -5322,8 +5796,9 b' _<n>'
5322 _21
5796 _21
5323 \family default
5797 \family default
5324 ).
5798 ).
5325 \layout Standard
5799 \end_layout
5326
5800
5801 \begin_layout Standard
5327 These global variables are all stored in a global dictionary (not a list,
5802 These global variables are all stored in a global dictionary (not a list,
5328 since it only has entries for lines which returned a result) available
5803 since it only has entries for lines which returned a result) available
5329 under the names
5804 under the names
@@ -5365,8 +5840,9 b' Out'
5365 'Out=_oh
5840 'Out=_oh
5366 \family default
5841 \family default
5367 ' at the prompt.
5842 ' at the prompt.
5368 \layout Standard
5843 \end_layout
5369
5844
5845 \begin_layout Standard
5370 This system obviously can potentially put heavy memory demands on your system,
5846 This system obviously can potentially put heavy memory demands on your system,
5371 since it prevents Python's garbage collector from removing any previously
5847 since it prevents Python's garbage collector from removing any previously
5372 computed results.
5848 computed results.
@@ -5386,11 +5862,13 b' cache_size'
5386 '>>>'
5862 '>>>'
5387 \family default
5863 \family default
5388 of normal Python.
5864 of normal Python.
5389 \layout Subsection
5865 \end_layout
5390
5866
5867 \begin_layout Subsection
5391 Directory history
5868 Directory history
5392 \layout Standard
5869 \end_layout
5393
5870
5871 \begin_layout Standard
5394 Your history of visited directories is kept in the global list
5872 Your history of visited directories is kept in the global list
5395 \family typewriter
5873 \family typewriter
5396 _dh
5874 _dh
@@ -5405,78 +5883,95 b' _dh'
5405 %dhist
5883 %dhist
5406 \family default
5884 \family default
5407 command allows you to view this history.
5885 command allows you to view this history.
5408 \layout Subsection
5886 \end_layout
5409
5887
5888 \begin_layout Subsection
5410 Automatic parentheses and quotes
5889 Automatic parentheses and quotes
5411 \layout Standard
5890 \end_layout
5412
5891
5892 \begin_layout Standard
5413 These features were adapted from Nathan Gray's LazyPython.
5893 These features were adapted from Nathan Gray's LazyPython.
5414 They are meant to allow less typing for common situations.
5894 They are meant to allow less typing for common situations.
5415 \layout Subsubsection
5895 \end_layout
5416
5896
5897 \begin_layout Subsubsection
5417 Automatic parentheses
5898 Automatic parentheses
5418 \layout Standard
5899 \end_layout
5419
5900
5901 \begin_layout Standard
5420 Callable objects (i.e.
5902 Callable objects (i.e.
5421 functions, methods, etc) can be invoked like this (notice the commas between
5903 functions, methods, etc) can be invoked like this (notice the commas between
5422 the arguments):
5904 the arguments):
5423 \layout Standard
5905 \end_layout
5424
5906
5907 \begin_layout Standard
5425
5908
5426 \family typewriter
5909 \family typewriter
5427 >>> callable_ob arg1, arg2, arg3
5910 >>> callable_ob arg1, arg2, arg3
5428 \layout Standard
5911 \end_layout
5429
5912
5913 \begin_layout Standard
5430 and the input will be translated to this:
5914 and the input will be translated to this:
5431 \layout Standard
5915 \end_layout
5432
5916
5917 \begin_layout Standard
5433
5918
5434 \family typewriter
5919 \family typewriter
5435 --> callable_ob(arg1, arg2, arg3)
5920 --> callable_ob(arg1, arg2, arg3)
5436 \layout Standard
5921 \end_layout
5437
5922
5923 \begin_layout Standard
5438 You can force automatic parentheses by using '/' as the first character
5924 You can force automatic parentheses by using '/' as the first character
5439 of a line.
5925 of a line.
5440 For example:
5926 For example:
5441 \layout Standard
5927 \end_layout
5442
5928
5929 \begin_layout Standard
5443
5930
5444 \family typewriter
5931 \family typewriter
5445 >>> /globals # becomes 'globals()'
5932 >>> /globals # becomes 'globals()'
5446 \layout Standard
5933 \end_layout
5447
5934
5935 \begin_layout Standard
5448 Note that the '/' MUST be the first character on the line! This won't work:
5936 Note that the '/' MUST be the first character on the line! This won't work:
5449
5937
5450 \layout Standard
5938 \end_layout
5451
5939
5940 \begin_layout Standard
5452
5941
5453 \family typewriter
5942 \family typewriter
5454 >>> print /globals # syntax error
5943 >>> print /globals # syntax error
5455 \layout Standard
5944 \end_layout
5456
5945
5946 \begin_layout Standard
5457 In most cases the automatic algorithm should work, so you should rarely
5947 In most cases the automatic algorithm should work, so you should rarely
5458 need to explicitly invoke /.
5948 need to explicitly invoke /.
5459 One notable exception is if you are trying to call a function with a list
5949 One notable exception is if you are trying to call a function with a list
5460 of tuples as arguments (the parenthesis will confuse IPython):
5950 of tuples as arguments (the parenthesis will confuse IPython):
5461 \layout Standard
5951 \end_layout
5462
5952
5953 \begin_layout Standard
5463
5954
5464 \family typewriter
5955 \family typewriter
5465 In [1]: zip (1,2,3),(4,5,6) # won't work
5956 In [1]: zip (1,2,3),(4,5,6) # won't work
5466 \layout Standard
5957 \end_layout
5467
5958
5959 \begin_layout Standard
5468 but this will work:
5960 but this will work:
5469 \layout Standard
5961 \end_layout
5470
5962
5963 \begin_layout Standard
5471
5964
5472 \family typewriter
5965 \family typewriter
5473 In [2]: /zip (1,2,3),(4,5,6)
5966 In [2]: /zip (1,2,3),(4,5,6)
5474 \newline
5967 \newline
5475 ------> zip ((1,2,3),(4,5,6))
5968 ------> zip ((1,2,3),(4,5,6))
5476 \newline
5969 \newline
5477 Out[2]= [(1, 4), (2, 5), (3, 6)]
5970 Out[2]= [(1, 4),
5478 \layout Standard
5971 (2, 5), (3, 6)]
5972 \end_layout
5479
5973
5974 \begin_layout Standard
5480 IPython tells you that it has altered your command line by displaying the
5975 IPython tells you that it has altered your command line by displaying the
5481 new command line preceded by
5976 new command line preceded by
5482 \family typewriter
5977 \family typewriter
@@ -5484,18 +5979,21 b' IPython tells you that it has altered your command line by displaying the'
5484 \family default
5979 \family default
5485 .
5980 .
5486 e.g.:
5981 e.g.:
5487 \layout Standard
5982 \end_layout
5488
5983
5984 \begin_layout Standard
5489
5985
5490 \family typewriter
5986 \family typewriter
5491 In [18]: callable list
5987 In [18]: callable list
5492 \newline
5988 \newline
5493 -------> callable (list)
5989 -------> callable (list)
5494 \layout Subsubsection
5990 \end_layout
5495
5991
5992 \begin_layout Subsubsection
5496 Automatic quoting
5993 Automatic quoting
5497 \layout Standard
5994 \end_layout
5498
5995
5996 \begin_layout Standard
5499 You can force automatic quoting of a function's arguments by using
5997 You can force automatic quoting of a function's arguments by using
5500 \family typewriter
5998 \family typewriter
5501 `,'
5999 `,'
@@ -5506,13 +6004,15 b" You can force automatic quoting of a function's arguments by using"
5506 \family default
6004 \family default
5507 as the first character of a line.
6005 as the first character of a line.
5508 For example:
6006 For example:
5509 \layout Standard
6007 \end_layout
5510
6008
6009 \begin_layout Standard
5511
6010
5512 \family typewriter
6011 \family typewriter
5513 >>> ,my_function /home/me # becomes my_function("/home/me")
6012 >>> ,my_function /home/me # becomes my_function("/home/me")
5514 \layout Standard
6013 \end_layout
5515
6014
6015 \begin_layout Standard
5516 If you use
6016 If you use
5517 \family typewriter
6017 \family typewriter
5518 `;'
6018 `;'
@@ -5522,18 +6022,21 b' If you use'
5522 `,'
6022 `,'
5523 \family default
6023 \family default
5524 splits on whitespace):
6024 splits on whitespace):
5525 \layout Standard
6025 \end_layout
5526
6026
6027 \begin_layout Standard
5527
6028
5528 \family typewriter
6029 \family typewriter
5529 >>> ,my_function a b c # becomes my_function("a","b","c")
6030 >>> ,my_function a b c # becomes my_function("a","b","c")
5530 \layout Standard
6031 \end_layout
5531
6032
6033 \begin_layout Standard
5532
6034
5533 \family typewriter
6035 \family typewriter
5534 >>> ;my_function a b c # becomes my_function("a b c")
6036 >>> ;my_function a b c # becomes my_function("a b c")
5535 \layout Standard
6037 \end_layout
5536
6038
6039 \begin_layout Standard
5537 Note that the `
6040 Note that the `
5538 \family typewriter
6041 \family typewriter
5539 ,
6042 ,
@@ -5543,21 +6046,23 b' Note that the `'
5543 ;
6046 ;
5544 \family default
6047 \family default
5545 ' MUST be the first character on the line! This won't work:
6048 ' MUST be the first character on the line! This won't work:
5546 \layout Standard
6049 \end_layout
5547
6050
6051 \begin_layout Standard
5548
6052
5549 \family typewriter
6053 \family typewriter
5550 >>> x = ,my_function /home/me # syntax error
6054 >>> x = ,my_function /home/me # syntax error
5551 \layout Section
6055 \end_layout
5552
5553
6056
6057 \begin_layout Section
5554 \begin_inset LatexCommand \label{sec:customization}
6058 \begin_inset LatexCommand \label{sec:customization}
5555
6059
5556 \end_inset
6060 \end_inset
5557
6061
5558 Customization
6062 Customization
5559 \layout Standard
6063 \end_layout
5560
6064
6065 \begin_layout Standard
5561 As we've already mentioned, IPython reads a configuration file which can
6066 As we've already mentioned, IPython reads a configuration file which can
5562 be specified at the command line (
6067 be specified at the command line (
5563 \family typewriter
6068 \family typewriter
@@ -5576,8 +6081,9 b' IPYTHONDIR'
5576 , which allows you to have local configuration files for specific projects.
6081 , which allows you to have local configuration files for specific projects.
5577 In this section we will call these types of configuration files simply
6082 In this section we will call these types of configuration files simply
5578 rcfiles (short for resource configuration file).
6083 rcfiles (short for resource configuration file).
5579 \layout Standard
6084 \end_layout
5580
6085
6086 \begin_layout Standard
5581 The syntax of an rcfile is one of key-value pairs separated by whitespace,
6087 The syntax of an rcfile is one of key-value pairs separated by whitespace,
5582 one per line.
6088 one per line.
5583 Lines beginning with a
6089 Lines beginning with a
@@ -5592,8 +6098,9 b' not'
5592 Note that these are not python files, and this is deliberate, because it
6098 Note that these are not python files, and this is deliberate, because it
5593 allows us to do some things which would be quite tricky to implement if
6099 allows us to do some things which would be quite tricky to implement if
5594 they were normal python files.
6100 they were normal python files.
5595 \layout Standard
6101 \end_layout
5596
6102
6103 \begin_layout Standard
5597 First, an rcfile can contain permanent default values for almost all command
6104 First, an rcfile can contain permanent default values for almost all command
5598 line options (except things like
6105 line options (except things like
5599 \family typewriter
6106 \family typewriter
@@ -5604,7 +6111,7 b' First, an rcfile can contain permanent default values for almost all command'
5604 -Version
6111 -Version
5605 \family default
6112 \family default
5606 ).
6113 ).
5607 Sec\SpecialChar ~
6114 Sec\InsetSpace ~
5608
6115
5609 \begin_inset LatexCommand \ref{sec:cmd-line-opts}
6116 \begin_inset LatexCommand \ref{sec:cmd-line-opts}
5610
6117
@@ -5613,24 +6120,27 b' First, an rcfile can contain permanent default values for almost all command'
5613 contains a description of all command-line options.
6120 contains a description of all command-line options.
5614 However, values you explicitly specify at the command line override the
6121 However, values you explicitly specify at the command line override the
5615 values defined in the rcfile.
6122 values defined in the rcfile.
5616 \layout Standard
6123 \end_layout
5617
6124
6125 \begin_layout Standard
5618 Besides command line option values, the rcfile can specify values for certain
6126 Besides command line option values, the rcfile can specify values for certain
5619 extra special options which are not available at the command line.
6127 extra special options which are not available at the command line.
5620 These options are briefly described below.
6128 These options are briefly described below.
5621
6129
5622 \layout Standard
6130 \end_layout
5623
6131
6132 \begin_layout Standard
5624 Each of these options may appear as many times as you need it in the file.
6133 Each of these options may appear as many times as you need it in the file.
5625 \layout List
6134 \end_layout
5626 \labelwidthstring 00.00.0000
5627
6135
6136 \begin_layout List
6137 \labelwidthstring 00.00.0000
5628
6138
5629 \family typewriter
6139 \family typewriter
5630 \series bold
6140 \series bold
5631 include\SpecialChar ~
6141 include\InsetSpace ~
5632 <file1>\SpecialChar ~
6142 <file1>\InsetSpace ~
5633 <file2>\SpecialChar ~
6143 <file2>\InsetSpace ~
5634 ...
6144 ...
5635 \family default
6145 \family default
5636 \series default
6146 \series default
@@ -5664,15 +6174,16 b' ipythonrc-<name>'
5664 \family default
6174 \family default
5665 .
6175 .
5666
6176
5667 \layout List
6177 \end_layout
5668 \labelwidthstring 00.00.0000
5669
6178
6179 \begin_layout List
6180 \labelwidthstring 00.00.0000
5670
6181
5671 \family typewriter
6182 \family typewriter
5672 \series bold
6183 \series bold
5673 import_mod\SpecialChar ~
6184 import_mod\InsetSpace ~
5674 <mod1>\SpecialChar ~
6185 <mod1>\InsetSpace ~
5675 <mod2>\SpecialChar ~
6186 <mod2>\InsetSpace ~
5676 ...
6187 ...
5677 \family default
6188 \family default
5678 \series default
6189 \series default
@@ -5685,16 +6196,17 b' import'
5685 <mod1>,<mod2>,...
6196 <mod1>,<mod2>,...
5686 \family default
6197 \family default
5687 '
6198 '
5688 \layout List
6199 \end_layout
5689 \labelwidthstring 00.00.0000
5690
6200
6201 \begin_layout List
6202 \labelwidthstring 00.00.0000
5691
6203
5692 \family typewriter
6204 \family typewriter
5693 \series bold
6205 \series bold
5694 import_some\SpecialChar ~
6206 import_some\InsetSpace ~
5695 <mod>\SpecialChar ~
6207 <mod>\InsetSpace ~
5696 <f1>\SpecialChar ~
6208 <f1>\InsetSpace ~
5697 <f2>\SpecialChar ~
6209 <f2>\InsetSpace ~
5698 ...
6210 ...
5699 \family default
6211 \family default
5700 \series default
6212 \series default
@@ -5707,15 +6219,16 b' from <mod> import'
5707 <f1>,<f2>,...
6219 <f1>,<f2>,...
5708 \family default
6220 \family default
5709 '
6221 '
5710 \layout List
6222 \end_layout
5711 \labelwidthstring 00.00.0000
5712
6223
6224 \begin_layout List
6225 \labelwidthstring 00.00.0000
5713
6226
5714 \family typewriter
6227 \family typewriter
5715 \series bold
6228 \series bold
5716 import_all\SpecialChar ~
6229 import_all\InsetSpace ~
5717 <mod1>\SpecialChar ~
6230 <mod1>\InsetSpace ~
5718 <mod2>\SpecialChar ~
6231 <mod2>\InsetSpace ~
5719 ...
6232 ...
5720 \family default
6233 \family default
5721 \series default
6234 \series default
@@ -5724,25 +6237,27 b' import_all\\SpecialChar ~'
5724 from <mod> import *
6237 from <mod> import *
5725 \family default
6238 \family default
5726 '
6239 '
5727 \layout List
6240 \end_layout
5728 \labelwidthstring 00.00.0000
5729
6241
6242 \begin_layout List
6243 \labelwidthstring 00.00.0000
5730
6244
5731 \family typewriter
6245 \family typewriter
5732 \series bold
6246 \series bold
5733 execute\SpecialChar ~
6247 execute\InsetSpace ~
5734 <python\SpecialChar ~
6248 <python\InsetSpace ~
5735 code>
6249 code>
5736 \family default
6250 \family default
5737 \series default
6251 \series default
5738 : give any single-line python code to be executed.
6252 : give any single-line python code to be executed.
5739 \layout List
6253 \end_layout
5740 \labelwidthstring 00.00.0000
5741
6254
6255 \begin_layout List
6256 \labelwidthstring 00.00.0000
5742
6257
5743 \family typewriter
6258 \family typewriter
5744 \series bold
6259 \series bold
5745 execfile\SpecialChar ~
6260 execfile\InsetSpace ~
5746 <filename>
6261 <filename>
5747 \family default
6262 \family default
5748 \series default
6263 \series default
@@ -5755,19 +6270,20 b' execfile(filename)'
5755 So if you need any amount of extra fancy customization that won't fit in
6270 So if you need any amount of extra fancy customization that won't fit in
5756 any of the above 'canned' options, you can just put it in a separate python
6271 any of the above 'canned' options, you can just put it in a separate python
5757 file and execute it.
6272 file and execute it.
5758 \layout List
6273 \end_layout
5759 \labelwidthstring 00.00.0000
5760
6274
6275 \begin_layout List
6276 \labelwidthstring 00.00.0000
5761
6277
5762 \family typewriter
6278 \family typewriter
5763 \series bold
6279 \series bold
5764 alias\SpecialChar ~
6280 alias\InsetSpace ~
5765 <alias_def>
6281 <alias_def>
5766 \family default
6282 \family default
5767 \series default
6283 \series default
5768 : this is equivalent to calling '
6284 : this is equivalent to calling '
5769 \family typewriter
6285 \family typewriter
5770 %alias\SpecialChar ~
6286 %alias\InsetSpace ~
5771 <alias_def>
6287 <alias_def>
5772 \family default
6288 \family default
5773 ' at the IPython command line.
6289 ' at the IPython command line.
@@ -5781,9 +6297,9 b' alias\\SpecialChar ~'
5781 to be able to do things with files while testing code.
6297 to be able to do things with files while testing code.
5782 This gives you the flexibility to have within IPython any aliases you may
6298 This gives you the flexibility to have within IPython any aliases you may
5783 be used to under your normal system shell.
6299 be used to under your normal system shell.
5784 \layout Subsection
6300 \end_layout
5785
5786
6301
6302 \begin_layout Subsection
5787 \begin_inset LatexCommand \label{sec:ipytonrc-sample}
6303 \begin_inset LatexCommand \label{sec:ipytonrc-sample}
5788
6304
5789 \end_inset
6305 \end_inset
@@ -5793,8 +6309,9 b' Sample'
5793 ipythonrc
6309 ipythonrc
5794 \family default
6310 \family default
5795 file
6311 file
5796 \layout Standard
6312 \end_layout
5797
6313
6314 \begin_layout Standard
5798 The default rcfile, called
6315 The default rcfile, called
5799 \family typewriter
6316 \family typewriter
5800 ipythonrc
6317 ipythonrc
@@ -5805,29 +6322,33 b' IPYTHONDIR'
5805 \family default
6322 \family default
5806 directory contains lots of comments on all of these options.
6323 directory contains lots of comments on all of these options.
5807 We reproduce it here for reference:
6324 We reproduce it here for reference:
5808 \layout Standard
6325 \end_layout
5809
5810
6326
6327 \begin_layout Standard
5811 \begin_inset ERT
6328 \begin_inset ERT
5812 status Open
6329 status open
6330
6331 \begin_layout Standard
5813
6332
5814 \layout Standard
5815
6333
5816 \backslash
6334 \backslash
5817 codelist{../IPython/UserConfig/ipythonrc}
6335 codelist{../IPython/UserConfig/ipythonrc}
5818 \end_inset
6336 \end_layout
5819
6337
6338 \end_inset
5820
6339
5821 \layout Subsection
5822
6340
6341 \end_layout
5823
6342
6343 \begin_layout Subsection
5824 \begin_inset LatexCommand \label{sec:prompts}
6344 \begin_inset LatexCommand \label{sec:prompts}
5825
6345
5826 \end_inset
6346 \end_inset
5827
6347
5828 Fine-tuning your prompt
6348 Fine-tuning your prompt
5829 \layout Standard
6349 \end_layout
5830
6350
6351 \begin_layout Standard
5831 IPython's prompts can be customized using a syntax similar to that of the
6352 IPython's prompts can be customized using a syntax similar to that of the
5832
6353
5833 \family typewriter
6354 \family typewriter
@@ -5840,29 +6361,34 b' bash'
5840 \family default
6361 \family default
5841 's escapes are supported, as well as a few additional ones.
6362 's escapes are supported, as well as a few additional ones.
5842 We list them below:
6363 We list them below:
5843 \layout Description
6364 \end_layout
5844
6365
6366 \begin_layout Description
5845
6367
5846 \backslash
6368 \backslash
5847 # the prompt/history count number
6369 # the prompt/history count number
5848 \layout Description
6370 \end_layout
5849
6371
6372 \begin_layout Description
5850
6373
5851 \backslash
6374 \backslash
5852 D the prompt/history count, with the actual digits replaced by dots.
6375 D the prompt/history count, with the actual digits replaced by dots.
5853 Used mainly in continuation prompts (prompt_in2)
6376 Used mainly in continuation prompts (prompt_in2)
5854 \layout Description
6377 \end_layout
5855
6378
6379 \begin_layout Description
5856
6380
5857 \backslash
6381 \backslash
5858 w the current working directory
6382 w the current working directory
5859 \layout Description
6383 \end_layout
5860
6384
6385 \begin_layout Description
5861
6386
5862 \backslash
6387 \backslash
5863 W the basename of current working directory
6388 W the basename of current working directory
5864 \layout Description
6389 \end_layout
5865
6390
6391 \begin_layout Description
5866
6392
5867 \backslash
6393 \backslash
5868 X
6394 X
@@ -5886,8 +6412,9 b' $HOME'
5886 \end_inset
6412 \end_inset
5887
6413
5888 path elements
6414 path elements
5889 \layout Description
6415 \end_layout
5890
6416
6417 \begin_layout Description
5891
6418
5892 \backslash
6419 \backslash
5893 Y
6420 Y
@@ -5917,43 +6444,51 b' n'
5917 tcsh
6444 tcsh
5918 \family default
6445 \family default
5919 )
6446 )
5920 \layout Description
6447 \end_layout
5921
6448
6449 \begin_layout Description
5922
6450
5923 \backslash
6451 \backslash
5924 u the username of the current user
6452 u the username of the current user
5925 \layout Description
6453 \end_layout
5926
6454
6455 \begin_layout Description
5927
6456
5928 \backslash
6457 \backslash
5929 $ if the effective UID is 0, a #, otherwise a $
6458 $ if the effective UID is 0, a #, otherwise a $
5930 \layout Description
6459 \end_layout
5931
6460
6461 \begin_layout Description
5932
6462
5933 \backslash
6463 \backslash
5934 h the hostname up to the first `.'
6464 h the hostname up to the first `.'
5935 \layout Description
6465 \end_layout
5936
6466
6467 \begin_layout Description
5937
6468
5938 \backslash
6469 \backslash
5939 H the hostname
6470 H the hostname
5940 \layout Description
6471 \end_layout
5941
6472
6473 \begin_layout Description
5942
6474
5943 \backslash
6475 \backslash
5944 n a newline
6476 n a newline
5945 \layout Description
6477 \end_layout
5946
6478
6479 \begin_layout Description
5947
6480
5948 \backslash
6481 \backslash
5949 r a carriage return
6482 r a carriage return
5950 \layout Description
6483 \end_layout
5951
6484
6485 \begin_layout Description
5952
6486
5953 \backslash
6487 \backslash
5954 v IPython version string
6488 v IPython version string
5955 \layout Standard
6489 \end_layout
5956
6490
6491 \begin_layout Standard
5957 In addition to these, ANSI color escapes can be insterted into the prompts,
6492 In addition to these, ANSI color escapes can be insterted into the prompts,
5958 as
6493 as
5959 \family typewriter
6494 \family typewriter
@@ -5968,8 +6503,9 b' ColorName'
5968 The list of valid color names is: Black, Blue, Brown, Cyan, DarkGray, Green,
6503 The list of valid color names is: Black, Blue, Brown, Cyan, DarkGray, Green,
5969 LightBlue, LightCyan, LightGray, LightGreen, LightPurple, LightRed, NoColor,
6504 LightBlue, LightCyan, LightGray, LightGreen, LightPurple, LightRed, NoColor,
5970 Normal, Purple, Red, White, Yellow.
6505 Normal, Purple, Red, White, Yellow.
5971 \layout Standard
6506 \end_layout
5972
6507
6508 \begin_layout Standard
5973 Finally, IPython supports the evaluation of arbitrary expressions in your
6509 Finally, IPython supports the evaluation of arbitrary expressions in your
5974 prompt string.
6510 prompt string.
5975 The prompt strings are evaluated through the syntax of PEP 215, but basically
6511 The prompt strings are evaluated through the syntax of PEP 215, but basically
@@ -6016,24 +6552,27 b' commands'
6016 ipythonrc
6552 ipythonrc
6017 \family default
6553 \family default
6018 file).
6554 file).
6019 \layout Subsubsection
6555 \end_layout
6020
6556
6557 \begin_layout Subsubsection
6021 Prompt examples
6558 Prompt examples
6022 \layout Standard
6559 \end_layout
6023
6560
6561 \begin_layout Standard
6024 The following options in an ipythonrc file will give you IPython's default
6562 The following options in an ipythonrc file will give you IPython's default
6025 prompts:
6563 prompts:
6026 \layout Standard
6564 \end_layout
6027
6565
6566 \begin_layout Standard
6028
6567
6029 \family typewriter
6568 \family typewriter
6030 prompt_in1 'In [
6569 prompt_in1 'In [
6031 \backslash
6570 \backslash
6032 #]:'
6571 #]:'
6033 \newline
6572 \newline
6034 prompt_in2 '\SpecialChar ~
6573 prompt_in2 '\InsetSpace ~
6035 \SpecialChar ~
6574 \InsetSpace ~
6036 \SpecialChar ~
6575 \InsetSpace ~
6037 .
6576 .
6038 \backslash
6577 \backslash
6039 D.:'
6578 D.:'
@@ -6041,62 +6580,73 b" D.:'"
6041 prompt_out 'Out[
6580 prompt_out 'Out[
6042 \backslash
6581 \backslash
6043 #]:'
6582 #]:'
6044 \layout Standard
6583 \end_layout
6045
6584
6585 \begin_layout Standard
6046 which look like this:
6586 which look like this:
6047 \layout Standard
6587 \end_layout
6048
6588
6589 \begin_layout Standard
6049
6590
6050 \family typewriter
6591 \family typewriter
6051 In [1]: 1+2
6592 In [1]: 1+2
6052 \newline
6593 \newline
6053 Out[1]: 3
6594 Out[1]: 3
6054 \layout Standard
6595 \end_layout
6055
6596
6597 \begin_layout Standard
6056
6598
6057 \family typewriter
6599 \family typewriter
6058 In [2]: for i in (1,2,3):
6600 In [2]: for i in (1,2,3):
6059 \newline
6601 \newline
6060
6602
6061 \begin_inset ERT
6603 \begin_inset ERT
6062 status Collapsed
6604 status collapsed
6605
6606 \begin_layout Standard
6063
6607
6064 \layout Standard
6065
6608
6066 \backslash
6609 \backslash
6067 hspace*{0mm}
6610 hspace*{0mm}
6611 \end_layout
6612
6068 \end_inset
6613 \end_inset
6069
6614
6070 \SpecialChar ~
6615 \InsetSpace ~
6071 \SpecialChar ~
6616 \InsetSpace ~
6072 \SpecialChar ~
6617 \InsetSpace ~
6073 ...: \SpecialChar ~
6618 ...: \InsetSpace ~
6074 \SpecialChar ~
6619 \InsetSpace ~
6075 \SpecialChar ~
6620 \InsetSpace ~
6076 \SpecialChar ~
6621 \InsetSpace ~
6077 print i,
6622 print i,
6078 \newline
6623 \newline
6079
6624
6080 \begin_inset ERT
6625 \begin_inset ERT
6081 status Collapsed
6626 status collapsed
6627
6628 \begin_layout Standard
6082
6629
6083 \layout Standard
6084
6630
6085 \backslash
6631 \backslash
6086 hspace*{0mm}
6632 hspace*{0mm}
6633 \end_layout
6634
6087 \end_inset
6635 \end_inset
6088
6636
6089 \SpecialChar ~
6637 \InsetSpace ~
6090 \SpecialChar ~
6638 \InsetSpace ~
6091 \SpecialChar ~
6639 \InsetSpace ~
6092 ...:
6640 ...:
6093 \newline
6641 \newline
6094 1 2 3
6642 1 2 3
6095 \layout Standard
6643 \end_layout
6096
6644
6645 \begin_layout Standard
6097 These will give you a very colorful prompt with path information:
6646 These will give you a very colorful prompt with path information:
6098 \layout Standard
6647 \end_layout
6099
6648
6649 \begin_layout Standard
6100
6650
6101 \family typewriter
6651 \family typewriter
6102 #prompt_in1 '
6652 #prompt_in1 '
@@ -6124,11 +6674,13 b" D>'"
6124 prompt_out '<
6674 prompt_out '<
6125 \backslash
6675 \backslash
6126 #>'
6676 #>'
6127 \layout Standard
6677 \end_layout
6128
6678
6679 \begin_layout Standard
6129 which look like this:
6680 which look like this:
6130 \layout Standard
6681 \end_layout
6131
6682
6683 \begin_layout Standard
6132
6684
6133 \family typewriter
6685 \family typewriter
6134 \color red
6686 \color red
@@ -6146,30 +6698,33 b' fperez'
6146 \newline
6698 \newline
6147
6699
6148 \begin_inset ERT
6700 \begin_inset ERT
6149 status Collapsed
6701 status collapsed
6702
6703 \begin_layout Standard
6150
6704
6151 \layout Standard
6152
6705
6153 \backslash
6706 \backslash
6154 hspace*{0mm}
6707 hspace*{0mm}
6155 \end_inset
6708 \end_layout
6156
6709
6157 \SpecialChar ~
6710 \end_inset
6158 \SpecialChar ~
6711
6159 \SpecialChar ~
6712 \InsetSpace ~
6160 \SpecialChar ~
6713 \InsetSpace ~
6161 \SpecialChar ~
6714 \InsetSpace ~
6162 \SpecialChar ~
6715 \InsetSpace ~
6163 \SpecialChar ~
6716 \InsetSpace ~
6164 \SpecialChar ~
6717 \InsetSpace ~
6165 \SpecialChar ~
6718 \InsetSpace ~
6166 \SpecialChar ~
6719 \InsetSpace ~
6167 \SpecialChar ~
6720 \InsetSpace ~
6168 \SpecialChar ~
6721 \InsetSpace ~
6169 \SpecialChar ~
6722 \InsetSpace ~
6170 \SpecialChar ~
6723 \InsetSpace ~
6171 \SpecialChar ~
6724 \InsetSpace ~
6172 \SpecialChar ~
6725 \InsetSpace ~
6726 \InsetSpace ~
6727 \InsetSpace ~
6173
6728
6174 \color red
6729 \color red
6175 <1>
6730 <1>
@@ -6192,64 +6747,70 b' fperez'
6192 \newline
6747 \newline
6193
6748
6194 \begin_inset ERT
6749 \begin_inset ERT
6195 status Collapsed
6750 status collapsed
6751
6752 \begin_layout Standard
6196
6753
6197 \layout Standard
6198
6754
6199 \backslash
6755 \backslash
6200 hspace*{0mm}
6756 hspace*{0mm}
6201 \end_inset
6757 \end_layout
6202
6758
6203 \SpecialChar ~
6759 \end_inset
6204 \SpecialChar ~
6760
6205 \SpecialChar ~
6761 \InsetSpace ~
6206 \SpecialChar ~
6762 \InsetSpace ~
6207 \SpecialChar ~
6763 \InsetSpace ~
6208 \SpecialChar ~
6764 \InsetSpace ~
6209 \SpecialChar ~
6765 \InsetSpace ~
6210 \SpecialChar ~
6766 \InsetSpace ~
6211 \SpecialChar ~
6767 \InsetSpace ~
6212 \SpecialChar ~
6768 \InsetSpace ~
6213 \SpecialChar ~
6769 \InsetSpace ~
6214 \SpecialChar ~
6770 \InsetSpace ~
6215 \SpecialChar ~
6771 \InsetSpace ~
6216 \SpecialChar ~
6772 \InsetSpace ~
6217 \SpecialChar ~
6773 \InsetSpace ~
6774 \InsetSpace ~
6775 \InsetSpace ~
6218
6776
6219 \color green
6777 \color green
6220 ...>
6778 ...>
6221 \color default
6779 \color default
6222 \SpecialChar ~
6780 \InsetSpace ~
6223 \SpecialChar ~
6781 \InsetSpace ~
6224 \SpecialChar ~
6782 \InsetSpace ~
6225 \SpecialChar ~
6783 \InsetSpace ~
6226 print i,
6784 print i,
6227 \newline
6785 \newline
6228
6786
6229 \begin_inset ERT
6787 \begin_inset ERT
6230 status Collapsed
6788 status collapsed
6789
6790 \begin_layout Standard
6231
6791
6232 \layout Standard
6233
6792
6234 \backslash
6793 \backslash
6235 hspace*{0mm}
6794 hspace*{0mm}
6236 \end_inset
6795 \end_layout
6237
6796
6238 \SpecialChar ~
6797 \end_inset
6239 \SpecialChar ~
6798
6240 \SpecialChar ~
6799 \InsetSpace ~
6241 \SpecialChar ~
6800 \InsetSpace ~
6242 \SpecialChar ~
6801 \InsetSpace ~
6243 \SpecialChar ~
6802 \InsetSpace ~
6244 \SpecialChar ~
6803 \InsetSpace ~
6245 \SpecialChar ~
6804 \InsetSpace ~
6246 \SpecialChar ~
6805 \InsetSpace ~
6247 \SpecialChar ~
6806 \InsetSpace ~
6248 \SpecialChar ~
6807 \InsetSpace ~
6249 \SpecialChar ~
6808 \InsetSpace ~
6250 \SpecialChar ~
6809 \InsetSpace ~
6251 \SpecialChar ~
6810 \InsetSpace ~
6252 \SpecialChar ~
6811 \InsetSpace ~
6812 \InsetSpace ~
6813 \InsetSpace ~
6253
6814
6254 \color green
6815 \color green
6255 ...>
6816 ...>
@@ -6257,19 +6818,21 b' hspace*{0mm}'
6257
6818
6258 \newline
6819 \newline
6259 1 2 3
6820 1 2 3
6260 \layout Standard
6821 \end_layout
6261
6822
6823 \begin_layout Standard
6262 The following shows the usage of dynamic expression evaluation:
6824 The following shows the usage of dynamic expression evaluation:
6263 \layout Subsection
6825 \end_layout
6264
6265
6826
6827 \begin_layout Subsection
6266 \begin_inset LatexCommand \label{sec:profiles}
6828 \begin_inset LatexCommand \label{sec:profiles}
6267
6829
6268 \end_inset
6830 \end_inset
6269
6831
6270 IPython profiles
6832 IPython profiles
6271 \layout Standard
6833 \end_layout
6272
6834
6835 \begin_layout Standard
6273 As we already mentioned, IPython supports the
6836 As we already mentioned, IPython supports the
6274 \family typewriter
6837 \family typewriter
6275 -profile
6838 -profile
@@ -6304,8 +6867,9 b' ipythonrc-<name>'
6304 ipythonrc
6867 ipythonrc
6305 \family default
6868 \family default
6306 .
6869 .
6307 \layout Standard
6870 \end_layout
6308
6871
6872 \begin_layout Standard
6309 This system allows you to maintain multiple configurations which load modules,
6873 This system allows you to maintain multiple configurations which load modules,
6310 set options, define functions, etc.
6874 set options, define functions, etc.
6311 suitable for different tasks and activate them in a very simple manner.
6875 suitable for different tasks and activate them in a very simple manner.
@@ -6318,8 +6882,9 b' This system allows you to maintain multiple configurations which load modules,'
6318 ipythonrc
6882 ipythonrc
6319 \family default
6883 \family default
6320 file as a starting point, and then add further customizations.
6884 file as a starting point, and then add further customizations.
6321 \layout Standard
6885 \end_layout
6322
6886
6887 \begin_layout Standard
6323 In sections
6888 In sections
6324 \begin_inset LatexCommand \ref{sec:syntax-extensions}
6889 \begin_inset LatexCommand \ref{sec:syntax-extensions}
6325
6890
@@ -6343,35 +6908,39 b' ipythonrc-'
6343 is a profile.
6908 is a profile.
6344 You can use those as examples for further customizations to suit your own
6909 You can use those as examples for further customizations to suit your own
6345 needs.
6910 needs.
6346 \layout Section
6911 \end_layout
6347
6348
6912
6913 \begin_layout Section
6349 \begin_inset OptArg
6914 \begin_inset OptArg
6350 collapsed false
6915 status open
6351
6352 \layout Standard
6353
6916
6917 \begin_layout Standard
6354 IPython as default...
6918 IPython as default...
6919 \end_layout
6920
6355 \end_inset
6921 \end_inset
6356
6922
6357 IPython as your default Python environment
6923 IPython as your default Python environment
6358 \layout Standard
6924 \end_layout
6359
6925
6926 \begin_layout Standard
6360 Python honors the environment variable
6927 Python honors the environment variable
6361 \family typewriter
6928 \family typewriter
6362 PYTHONSTARTUP
6929 PYTHONSTARTUP
6363 \family default
6930 \family default
6364 and will execute at startup the file referenced by this variable.
6931 and will execute at startup the file referenced by this variable.
6365 If you put at the end of this file the following two lines of code:
6932 If you put at the end of this file the following two lines of code:
6366 \layout Standard
6933 \end_layout
6367
6934
6935 \begin_layout Standard
6368
6936
6369 \family typewriter
6937 \family typewriter
6370 import IPython
6938 import IPython
6371 \newline
6939 \newline
6372 IPython.Shell.IPShell().mainloop(sys_exit=1)
6940 IPython.Shell.IPShell().mainloop(sys_exit=1)
6373 \layout Standard
6941 \end_layout
6374
6942
6943 \begin_layout Standard
6375 then IPython will be your working environment anytime you start Python.
6944 then IPython will be your working environment anytime you start Python.
6376 The
6945 The
6377 \family typewriter
6946 \family typewriter
@@ -6387,30 +6956,33 b' sys.exit()'
6387 \family default
6956 \family default
6388 ' prompt
6957 ' prompt
6389 \begin_inset Foot
6958 \begin_inset Foot
6390 collapsed true
6959 status collapsed
6391
6392 \layout Standard
6393
6960
6961 \begin_layout Standard
6394 Based on an idea by Holger Krekel.
6962 Based on an idea by Holger Krekel.
6963 \end_layout
6964
6395 \end_inset
6965 \end_inset
6396
6966
6397 .
6967 .
6398 \layout Standard
6968 \end_layout
6399
6969
6970 \begin_layout Standard
6400 This is probably useful to developers who manage multiple Python versions
6971 This is probably useful to developers who manage multiple Python versions
6401 and don't want to have correspondingly multiple IPython versions.
6972 and don't want to have correspondingly multiple IPython versions.
6402 Note that in this mode, there is no way to pass IPython any command-line
6973 Note that in this mode, there is no way to pass IPython any command-line
6403 options, as those are trapped first by Python itself.
6974 options, as those are trapped first by Python itself.
6404 \layout Section
6975 \end_layout
6405
6406
6976
6977 \begin_layout Section
6407 \begin_inset LatexCommand \label{sec:embed}
6978 \begin_inset LatexCommand \label{sec:embed}
6408
6979
6409 \end_inset
6980 \end_inset
6410
6981
6411 Embedding IPython
6982 Embedding IPython
6412 \layout Standard
6983 \end_layout
6413
6984
6985 \begin_layout Standard
6414 It is possible to start an IPython instance
6986 It is possible to start an IPython instance
6415 \emph on
6987 \emph on
6416 inside
6988 inside
@@ -6425,23 +6997,24 b' not'
6425 \emph default
6997 \emph default
6426 propagate back to the running code, so it is safe to modify your values
6998 propagate back to the running code, so it is safe to modify your values
6427 because you won't break your code in bizarre ways by doing so.
6999 because you won't break your code in bizarre ways by doing so.
6428 \layout Standard
7000 \end_layout
6429
7001
7002 \begin_layout Standard
6430 This feature allows you to easily have a fully functional python environment
7003 This feature allows you to easily have a fully functional python environment
6431 for doing object introspection anywhere in your code with a simple function
7004 for doing object introspection anywhere in your code with a simple function
6432 call.
7005 call.
6433 In some cases a simple print statement is enough, but if you need to do
7006 In some cases a simple print statement is enough, but if you need to do
6434 more detailed analysis of a code fragment this feature can be very valuable.
7007 more detailed analysis of a code fragment this feature can be very valuable.
6435 \layout Standard
7008 \end_layout
6436
7009
7010 \begin_layout Standard
6437 It can also be useful in scientific computing situations where it is common
7011 It can also be useful in scientific computing situations where it is common
6438 to need to do some automatic, computationally intensive part and then stop
7012 to need to do some automatic, computationally intensive part and then stop
6439 to look at data, plots, etc
7013 to look at data, plots, etc
6440 \begin_inset Foot
7014 \begin_inset Foot
6441 collapsed true
7015 status collapsed
6442
6443 \layout Standard
6444
7016
7017 \begin_layout Standard
6445 This functionality was inspired by IDL's combination of the
7018 This functionality was inspired by IDL's combination of the
6446 \family typewriter
7019 \family typewriter
6447 stop
7020 stop
@@ -6453,31 +7026,38 b' stop'
6453 executive command, which I have found very useful in the past, and by a
7026 executive command, which I have found very useful in the past, and by a
6454 posting on comp.lang.python by cmkl <cmkleffner-AT-gmx.de> on Dec.
7027 posting on comp.lang.python by cmkl <cmkleffner-AT-gmx.de> on Dec.
6455 06/01 concerning similar uses of pyrepl.
7028 06/01 concerning similar uses of pyrepl.
7029 \end_layout
7030
6456 \end_inset
7031 \end_inset
6457
7032
6458 .
7033 .
6459 Opening an IPython instance will give you full access to your data and
7034 Opening an IPython instance will give you full access to your data and
6460 functions, and you can resume program execution once you are done with
7035 functions, and you can resume program execution once you are done with
6461 the interactive part (perhaps to stop again later, as many times as needed).
7036 the interactive part (perhaps to stop again later, as many times as needed).
6462 \layout Standard
7037 \end_layout
6463
7038
7039 \begin_layout Standard
6464 The following code snippet is the bare minimum you need to include in your
7040 The following code snippet is the bare minimum you need to include in your
6465 Python programs for this to work (detailed examples follow later):
7041 Python programs for this to work (detailed examples follow later):
6466 \layout LyX-Code
7042 \end_layout
6467
7043
7044 \begin_layout LyX-Code
6468 from IPython.Shell import IPShellEmbed
7045 from IPython.Shell import IPShellEmbed
6469 \layout LyX-Code
7046 \end_layout
6470
7047
7048 \begin_layout LyX-Code
6471 ipshell = IPShellEmbed()
7049 ipshell = IPShellEmbed()
6472 \layout LyX-Code
7050 \end_layout
6473
7051
7052 \begin_layout LyX-Code
6474 ipshell() # this call anywhere in your program will start IPython
7053 ipshell() # this call anywhere in your program will start IPython
6475 \layout Standard
7054 \end_layout
6476
7055
7056 \begin_layout Standard
6477 You can run embedded instances even in code which is itself being run at
7057 You can run embedded instances even in code which is itself being run at
6478 the IPython interactive prompt with '
7058 the IPython interactive prompt with '
6479 \family typewriter
7059 \family typewriter
6480 %run\SpecialChar ~
7060 %run\InsetSpace ~
6481 <filename>
7061 <filename>
6482 \family default
7062 \family default
6483 '.
7063 '.
@@ -6485,21 +7065,24 b' You can run embedded instances even in code which is itself being run at'
6485 or in your embedded one), it's a good idea in such cases to set the in/out
7065 or in your embedded one), it's a good idea in such cases to set the in/out
6486 prompts to something different for the embedded instances.
7066 prompts to something different for the embedded instances.
6487 The code examples below illustrate this.
7067 The code examples below illustrate this.
6488 \layout Standard
7068 \end_layout
6489
7069
7070 \begin_layout Standard
6490 You can also have multiple IPython instances in your program and open them
7071 You can also have multiple IPython instances in your program and open them
6491 separately, for example with different options for data presentation.
7072 separately, for example with different options for data presentation.
6492 If you close and open the same instance multiple times, its prompt counters
7073 If you close and open the same instance multiple times, its prompt counters
6493 simply continue from each execution to the next.
7074 simply continue from each execution to the next.
6494 \layout Standard
7075 \end_layout
6495
7076
7077 \begin_layout Standard
6496 Please look at the docstrings in the
7078 Please look at the docstrings in the
6497 \family typewriter
7079 \family typewriter
6498 Shell.py
7080 Shell.py
6499 \family default
7081 \family default
6500 module for more details on the use of this system.
7082 module for more details on the use of this system.
6501 \layout Standard
7083 \end_layout
6502
7084
7085 \begin_layout Standard
6503 The following sample file illustrating how to use the embedding functionality
7086 The following sample file illustrating how to use the embedding functionality
6504 is provided in the examples directory as
7087 is provided in the examples directory as
6505 \family typewriter
7088 \family typewriter
@@ -6507,39 +7090,46 b' example-embed.py'
6507 \family default
7090 \family default
6508 .
7091 .
6509 It should be fairly self-explanatory:
7092 It should be fairly self-explanatory:
6510 \layout Standard
7093 \end_layout
6511
6512
7094
7095 \begin_layout Standard
6513 \begin_inset ERT
7096 \begin_inset ERT
6514 status Open
7097 status open
7098
7099 \begin_layout Standard
6515
7100
6516 \layout Standard
6517
7101
6518 \backslash
7102 \backslash
6519 codelist{examples/example-embed.py}
7103 codelist{examples/example-embed.py}
7104 \end_layout
7105
6520 \end_inset
7106 \end_inset
6521
7107
6522
7108
6523 \layout Standard
7109 \end_layout
6524
7110
7111 \begin_layout Standard
6525 Once you understand how the system functions, you can use the following
7112 Once you understand how the system functions, you can use the following
6526 code fragments in your programs which are ready for cut and paste:
7113 code fragments in your programs which are ready for cut and paste:
6527 \layout Standard
7114 \end_layout
6528
6529
7115
7116 \begin_layout Standard
6530 \begin_inset ERT
7117 \begin_inset ERT
6531 status Open
7118 status open
7119
7120 \begin_layout Standard
6532
7121
6533 \layout Standard
6534
7122
6535 \backslash
7123 \backslash
6536 codelist{examples/example-embed-short.py}
7124 codelist{examples/example-embed-short.py}
6537 \end_inset
7125 \end_layout
6538
7126
7127 \end_inset
6539
7128
6540 \layout Section
6541
7129
7130 \end_layout
6542
7131
7132 \begin_layout Section
6543 \begin_inset LatexCommand \label{sec:using-pdb}
7133 \begin_inset LatexCommand \label{sec:using-pdb}
6544
7134
6545 \end_inset
7135 \end_inset
@@ -6549,13 +7139,15 b' Using the Python debugger ('
6549 pdb
7139 pdb
6550 \family default
7140 \family default
6551 )
7141 )
6552 \layout Subsection
7142 \end_layout
6553
7143
7144 \begin_layout Subsection
6554 Running entire programs via
7145 Running entire programs via
6555 \family typewriter
7146 \family typewriter
6556 pdb
7147 pdb
6557 \layout Standard
7148 \end_layout
6558
7149
7150 \begin_layout Standard
6559
7151
6560 \family typewriter
7152 \family typewriter
6561 pdb
7153 pdb
@@ -6584,7 +7176,7 b' pdb'
6584 \family typewriter
7176 \family typewriter
6585 `%run?'
7177 `%run?'
6586 \family default
7178 \family default
6587 or in Sec.\SpecialChar ~
7179 or in Sec.\InsetSpace ~
6588
7180
6589 \begin_inset LatexCommand \ref{sec:magic}
7181 \begin_inset LatexCommand \ref{sec:magic}
6590
7182
@@ -6595,8 +7187,9 b' pdb'
6595 pdb
7187 pdb
6596 \family default
7188 \family default
6597 will stop execution first.
7189 will stop execution first.
6598 \layout Standard
7190 \end_layout
6599
7191
7192 \begin_layout Standard
6600 For more information on the use of the
7193 For more information on the use of the
6601 \family typewriter
7194 \family typewriter
6602 pdb
7195 pdb
@@ -6619,29 +7212,33 b' help()'
6619 pdb
7212 pdb
6620 \family default
7213 \family default
6621 module as follows (in an IPython prompt):
7214 module as follows (in an IPython prompt):
6622 \layout Standard
7215 \end_layout
6623
7216
7217 \begin_layout Standard
6624
7218
6625 \family typewriter
7219 \family typewriter
6626 In [1]: import pdb
7220 In [1]: import pdb
6627 \newline
7221 \newline
6628 In [2]: pdb.help()
7222 In [2]: pdb.help()
6629 \layout Standard
7223 \end_layout
6630
7224
7225 \begin_layout Standard
6631 This will load the
7226 This will load the
6632 \family typewriter
7227 \family typewriter
6633 pdb.doc
7228 pdb.doc
6634 \family default
7229 \family default
6635 document in a file viewer for you automatically.
7230 document in a file viewer for you automatically.
6636 \layout Subsection
7231 \end_layout
6637
7232
7233 \begin_layout Subsection
6638 Automatic invocation of
7234 Automatic invocation of
6639 \family typewriter
7235 \family typewriter
6640 pdb
7236 pdb
6641 \family default
7237 \family default
6642 on exceptions
7238 on exceptions
6643 \layout Standard
7239 \end_layout
6644
7240
7241 \begin_layout Standard
6645 IPython, if started with the
7242 IPython, if started with the
6646 \family typewriter
7243 \family typewriter
6647 -pdb
7244 -pdb
@@ -6652,12 +7249,13 b' pdb'
6652 \family default
7249 \family default
6653 debugger every time your code triggers an uncaught exception
7250 debugger every time your code triggers an uncaught exception
6654 \begin_inset Foot
7251 \begin_inset Foot
6655 collapsed true
7252 status collapsed
6656
6657 \layout Standard
6658
7253
7254 \begin_layout Standard
6659 Many thanks to Christopher Hart for the request which prompted adding this
7255 Many thanks to Christopher Hart for the request which prompted adding this
6660 feature to IPython.
7256 feature to IPython.
7257 \end_layout
7258
6661 \end_inset
7259 \end_inset
6662
7260
6663 .
7261 .
@@ -6675,8 +7273,9 b' pdb'
6675 your program is at this point `dead', all the data is still available and
7273 your program is at this point `dead', all the data is still available and
6676 you can walk up and down the stack frame and understand the origin of the
7274 you can walk up and down the stack frame and understand the origin of the
6677 problem.
7275 problem.
6678 \layout Standard
7276 \end_layout
6679
7277
7278 \begin_layout Standard
6680 Furthermore, you can use these debugging facilities both with the embedded
7279 Furthermore, you can use these debugging facilities both with the embedded
6681 IPython mode and without IPython at all.
7280 IPython mode and without IPython at all.
6682 For an embedded shell (see sec.
7281 For an embedded shell (see sec.
@@ -6695,20 +7294,24 b' pdb'
6695 \family default
7294 \family default
6696 will be called if an uncaught exception is triggered by your code.
7295 will be called if an uncaught exception is triggered by your code.
6697
7296
6698 \layout Standard
7297 \end_layout
6699
7298
7299 \begin_layout Standard
6700 For stand-alone use of the feature in your programs which do not use IPython
7300 For stand-alone use of the feature in your programs which do not use IPython
6701 at all, put the following lines toward the top of your `main' routine:
7301 at all, put the following lines toward the top of your `main' routine:
6702 \layout Standard
7302 \end_layout
7303
7304 \begin_layout Standard
6703 \align left
7305 \align left
6704
7306
6705 \family typewriter
7307 \family typewriter
6706 import sys,IPython.ultraTB
7308 import sys,IPython.ultraTB
6707 \newline
7309 \newline
6708 sys.excepthook = IPython.ultraTB.FormattedTB(mode=`Verbose', color_scheme=`Linux',
7310 sys.excepthook = IPython.ultraTB.FormattedTB(mode=`Verbos
6709 call_pdb=1)
7311 e', color_scheme=`Linux', call_pdb=1)
6710 \layout Standard
7312 \end_layout
6711
7313
7314 \begin_layout Standard
6712 The
7315 The
6713 \family typewriter
7316 \family typewriter
6714 mode
7317 mode
@@ -6748,32 +7351,35 b' color_scheme'
6748 -xmode
7351 -xmode
6749 \family default
7352 \family default
6750 .
7353 .
6751 \layout Standard
7354 \end_layout
6752
7355
7356 \begin_layout Standard
6753 This will give any of your programs detailed, colored tracebacks with automatic
7357 This will give any of your programs detailed, colored tracebacks with automatic
6754 invocation of
7358 invocation of
6755 \family typewriter
7359 \family typewriter
6756 pdb
7360 pdb
6757 \family default
7361 \family default
6758 .
7362 .
6759 \layout Section
7363 \end_layout
6760
6761
7364
7365 \begin_layout Section
6762 \begin_inset LatexCommand \label{sec:syntax-extensions}
7366 \begin_inset LatexCommand \label{sec:syntax-extensions}
6763
7367
6764 \end_inset
7368 \end_inset
6765
7369
6766 Extensions for syntax processing
7370 Extensions for syntax processing
6767 \layout Standard
7371 \end_layout
6768
7372
7373 \begin_layout Standard
6769 This isn't for the faint of heart, because the potential for breaking things
7374 This isn't for the faint of heart, because the potential for breaking things
6770 is quite high.
7375 is quite high.
6771 But it can be a very powerful and useful feature.
7376 But it can be a very powerful and useful feature.
6772 In a nutshell, you can redefine the way IPython processes the user input
7377 In a nutshell, you can redefine the way IPython processes the user input
6773 line to accept new, special extensions to the syntax without needing to
7378 line to accept new, special extensions to the syntax without needing to
6774 change any of IPython's own code.
7379 change any of IPython's own code.
6775 \layout Standard
7380 \end_layout
6776
7381
7382 \begin_layout Standard
6777 In the
7383 In the
6778 \family typewriter
7384 \family typewriter
6779 IPython/Extensions
7385 IPython/Extensions
@@ -6782,8 +7388,9 b' IPython/Extensions'
6782 now.
7388 now.
6783 These can be used `as is' (and both provide very useful functionality),
7389 These can be used `as is' (and both provide very useful functionality),
6784 or you can use them as a starting point for writing your own extensions.
7390 or you can use them as a starting point for writing your own extensions.
6785 \layout Subsection
7391 \end_layout
6786
7392
7393 \begin_layout Subsection
6787 Pasting of code starting with
7394 Pasting of code starting with
6788 \family typewriter
7395 \family typewriter
6789 `>>>
7396 `>>>
@@ -6794,8 +7401,9 b' Pasting of code starting with'
6794
7401
6795 \family default
7402 \family default
6796 '
7403 '
6797 \layout Standard
7404 \end_layout
6798
7405
7406 \begin_layout Standard
6799 In the python tutorial it is common to find code examples which have been
7407 In the python tutorial it is common to find code examples which have been
6800 taken from real python sessions.
7408 taken from real python sessions.
6801 The problem with those is that all the lines begin with either
7409 The problem with those is that all the lines begin with either
@@ -6810,8 +7418,9 b' In the python tutorial it is common to find code examples which have been'
6810 ', which makes it impossible to paste them all at once.
7418 ', which makes it impossible to paste them all at once.
6811 One must instead do a line by line manual copying, carefully removing the
7419 One must instead do a line by line manual copying, carefully removing the
6812 leading extraneous characters.
7420 leading extraneous characters.
6813 \layout Standard
7421 \end_layout
6814
7422
7423 \begin_layout Standard
6815 This extension identifies those starting characters and removes them from
7424 This extension identifies those starting characters and removes them from
6816 the input automatically, so that one can paste multi-line examples directly
7425 the input automatically, so that one can paste multi-line examples directly
6817 into IPython, saving a lot of time.
7426 into IPython, saving a lot of time.
@@ -6824,8 +7433,9 b' InterpreterPasteInput.py'
6824 IPython/Extensions
7433 IPython/Extensions
6825 \family default
7434 \family default
6826 directory for details on how this is done.
7435 directory for details on how this is done.
6827 \layout Standard
7436 \end_layout
6828
7437
7438 \begin_layout Standard
6829 IPython comes with a special profile enabling this feature, called
7439 IPython comes with a special profile enabling this feature, called
6830 \family typewriter
7440 \family typewriter
6831 tutorial
7441 tutorial
@@ -6836,8 +7446,8 b' tutorial'
6836 \emph default
7446 \emph default
6837 Simply start IPython via
7447 Simply start IPython via
6838 \family typewriter
7448 \family typewriter
6839 `ipython\SpecialChar ~
7449 `ipython\InsetSpace ~
6840 -p\SpecialChar ~
7450 -p\InsetSpace ~
6841 tutorial'
7451 tutorial'
6842 \family default
7452 \family default
6843 and the feature will be available.
7453 and the feature will be available.
@@ -6847,185 +7457,213 b" tutorial'"
6847
7457
6848 \family typewriter
7458 \family typewriter
6849 In [1]: import IPython.Extensions.InterpreterPasteInput
7459 In [1]: import IPython.Extensions.InterpreterPasteInput
6850 \layout Standard
7460 \end_layout
6851
7461
7462 \begin_layout Standard
6852 The following is a 'screenshot' of how things work when this extension is
7463 The following is a 'screenshot' of how things work when this extension is
6853 on, copying an example from the standard tutorial:
7464 on, copying an example from the standard tutorial:
6854 \layout Standard
7465 \end_layout
6855
7466
7467 \begin_layout Standard
6856
7468
6857 \family typewriter
7469 \family typewriter
6858 IPython profile: tutorial
7470 IPython profile: tutorial
6859 \newline
7471 \newline
6860 \SpecialChar ~
7472 \InsetSpace ~
6861
7473
6862 \newline
7474 \newline
6863 *** Pasting of code with ">>>" or "..." has been enabled.
7475 *** Pasting of code with ">>>" or "..." has been enabled.
6864 \newline
7476 \newline
6865 \SpecialChar ~
7477 \InsetSpace ~
6866
7478
6867 \newline
7479 \newline
6868 In [1]: >>> def fib2(n): # return Fibonacci series up to n
7480 In
7481 [1]: >>> def fib2(n): # return Fibonacci series up to n
6869 \newline
7482 \newline
6870
7483
6871 \begin_inset ERT
7484 \begin_inset ERT
6872 status Collapsed
7485 status collapsed
7486
7487 \begin_layout Standard
6873
7488
6874 \layout Standard
6875
7489
6876 \backslash
7490 \backslash
6877 hspace*{0mm}
7491 hspace*{0mm}
7492 \end_layout
7493
6878 \end_inset
7494 \end_inset
6879
7495
6880 \SpecialChar ~
7496 \InsetSpace ~
6881 \SpecialChar ~
7497 \InsetSpace ~
6882 ...: ...\SpecialChar ~
7498 ...: ...\InsetSpace ~
6883 \SpecialChar ~
7499 \InsetSpace ~
6884 \SpecialChar ~
7500 \InsetSpace ~
6885 \SpecialChar ~
7501 \InsetSpace ~
6886 """Return a list containing the Fibonacci series up to n."""
7502 """Return a list containing the Fibonacci series up to n."""
6887 \newline
7503 \newline
6888
7504
6889 \begin_inset ERT
7505 \begin_inset ERT
6890 status Collapsed
7506 status collapsed
7507
7508 \begin_layout Standard
6891
7509
6892 \layout Standard
6893
7510
6894 \backslash
7511 \backslash
6895 hspace*{0mm}
7512 hspace*{0mm}
7513 \end_layout
7514
6896 \end_inset
7515 \end_inset
6897
7516
6898 \SpecialChar ~
7517 \InsetSpace ~
6899 \SpecialChar ~
7518 \InsetSpace ~
6900 ...: ...\SpecialChar ~
7519 ...: ...\InsetSpace ~
6901 \SpecialChar ~
7520 \InsetSpace ~
6902 \SpecialChar ~
7521 \InsetSpace ~
6903 \SpecialChar ~
7522 \InsetSpace ~
6904 result = []
7523 result = []
6905 \newline
7524 \newline
6906
7525
6907 \begin_inset ERT
7526 \begin_inset ERT
6908 status Collapsed
7527 status collapsed
7528
7529 \begin_layout Standard
6909
7530
6910 \layout Standard
6911
7531
6912 \backslash
7532 \backslash
6913 hspace*{0mm}
7533 hspace*{0mm}
7534 \end_layout
7535
6914 \end_inset
7536 \end_inset
6915
7537
6916 \SpecialChar ~
7538 \InsetSpace ~
6917 \SpecialChar ~
7539 \InsetSpace ~
6918 ...: ...\SpecialChar ~
7540 ...: ...\InsetSpace ~
6919 \SpecialChar ~
7541 \InsetSpace ~
6920 \SpecialChar ~
7542 \InsetSpace ~
6921 \SpecialChar ~
7543 \InsetSpace ~
6922 a, b = 0, 1
7544 a, b = 0, 1
6923 \newline
7545 \newline
6924
7546
6925 \begin_inset ERT
7547 \begin_inset ERT
6926 status Collapsed
7548 status collapsed
7549
7550 \begin_layout Standard
6927
7551
6928 \layout Standard
6929
7552
6930 \backslash
7553 \backslash
6931 hspace*{0mm}
7554 hspace*{0mm}
7555 \end_layout
7556
6932 \end_inset
7557 \end_inset
6933
7558
6934 \SpecialChar ~
7559 \InsetSpace ~
6935 \SpecialChar ~
7560 \InsetSpace ~
6936 ...: ...\SpecialChar ~
7561 ...: ...\InsetSpace ~
6937 \SpecialChar ~
7562 \InsetSpace ~
6938 \SpecialChar ~
7563 \InsetSpace ~
6939 \SpecialChar ~
7564 \InsetSpace ~
6940 while b < n:
7565 while b < n:
6941 \newline
7566 \newline
6942
7567
6943 \begin_inset ERT
7568 \begin_inset ERT
6944 status Collapsed
7569 status collapsed
7570
7571 \begin_layout Standard
6945
7572
6946 \layout Standard
6947
7573
6948 \backslash
7574 \backslash
6949 hspace*{0mm}
7575 hspace*{0mm}
6950 \end_inset
7576 \end_layout
6951
7577
6952 \SpecialChar ~
7578 \end_inset
6953 \SpecialChar ~
7579
6954 ...: ...\SpecialChar ~
7580 \InsetSpace ~
6955 \SpecialChar ~
7581 \InsetSpace ~
6956 \SpecialChar ~
7582 ...: ...\InsetSpace ~
6957 \SpecialChar ~
7583 \InsetSpace ~
6958 \SpecialChar ~
7584 \InsetSpace ~
6959 \SpecialChar ~
7585 \InsetSpace ~
6960 \SpecialChar ~
7586 \InsetSpace ~
6961 \SpecialChar ~
7587 \InsetSpace ~
6962 result.append(b)\SpecialChar ~
7588 \InsetSpace ~
6963 \SpecialChar ~
7589 \InsetSpace ~
6964 \SpecialChar ~
7590 result.append(b)\InsetSpace ~
7591 \InsetSpace ~
7592 \InsetSpace ~
6965 # see below
7593 # see below
6966 \newline
7594 \newline
6967
7595
6968 \begin_inset ERT
7596 \begin_inset ERT
6969 status Collapsed
7597 status collapsed
7598
7599 \begin_layout Standard
6970
7600
6971 \layout Standard
6972
7601
6973 \backslash
7602 \backslash
6974 hspace*{0mm}
7603 hspace*{0mm}
7604 \end_layout
7605
6975 \end_inset
7606 \end_inset
6976
7607
6977 \SpecialChar ~
7608 \InsetSpace ~
6978 \SpecialChar ~
7609 \InsetSpace ~
6979 ...: ...\SpecialChar ~
7610 ...: ...\InsetSpace ~
6980 \SpecialChar ~
7611 \InsetSpace ~
6981 \SpecialChar ~
7612 \InsetSpace ~
6982 \SpecialChar ~
7613 \InsetSpace ~
6983 \SpecialChar ~
7614 \InsetSpace ~
6984 \SpecialChar ~
7615 \InsetSpace ~
6985 \SpecialChar ~
7616 \InsetSpace ~
6986 \SpecialChar ~
7617 \InsetSpace ~
6987 a, b = b, a+b
7618 a, b = b, a+b
6988 \newline
7619 \newline
6989
7620
6990 \begin_inset ERT
7621 \begin_inset ERT
6991 status Collapsed
7622 status collapsed
7623
7624 \begin_layout Standard
6992
7625
6993 \layout Standard
6994
7626
6995 \backslash
7627 \backslash
6996 hspace*{0mm}
7628 hspace*{0mm}
7629 \end_layout
7630
6997 \end_inset
7631 \end_inset
6998
7632
6999 \SpecialChar ~
7633 \InsetSpace ~
7000 \SpecialChar ~
7634 \InsetSpace ~
7001 ...: ...\SpecialChar ~
7635 ...: ...\InsetSpace ~
7002 \SpecialChar ~
7636 \InsetSpace ~
7003 \SpecialChar ~
7637 \InsetSpace ~
7004 \SpecialChar ~
7638 \InsetSpace ~
7005 return result
7639 return result
7006 \newline
7640 \newline
7007
7641
7008 \begin_inset ERT
7642 \begin_inset ERT
7009 status Collapsed
7643 status collapsed
7644
7645 \begin_layout Standard
7010
7646
7011 \layout Standard
7012
7647
7013 \backslash
7648 \backslash
7014 hspace*{0mm}
7649 hspace*{0mm}
7650 \end_layout
7651
7015 \end_inset
7652 \end_inset
7016
7653
7017 \SpecialChar ~
7654 \InsetSpace ~
7018 \SpecialChar ~
7655 \InsetSpace ~
7019 ...:
7656 ...:
7020 \newline
7657 \newline
7021 \SpecialChar ~
7658 \InsetSpace ~
7022
7659
7023 \newline
7660 \newline
7024 In [2]: fib2(10)
7661 In [2]: fib2(10)
7025 \newline
7662 \newline
7026 Out[2]: [1, 1, 2, 3, 5, 8]
7663 Out[2]: [1, 1, 2, 3, 5, 8]
7027 \layout Standard
7664 \end_layout
7028
7665
7666 \begin_layout Standard
7029 Note that as currently written, this extension does
7667 Note that as currently written, this extension does
7030 \emph on
7668 \emph on
7031 not
7669 not
@@ -7036,11 +7674,13 b" recognize IPython's prompts for pasting."
7036 One could however extract all the relevant information from the IPython
7674 One could however extract all the relevant information from the IPython
7037 instance and build an appropriate regular expression.
7675 instance and build an appropriate regular expression.
7038 This is left as an exercise for the reader.
7676 This is left as an exercise for the reader.
7039 \layout Subsection
7677 \end_layout
7040
7678
7679 \begin_layout Subsection
7041 Input of physical quantities with units
7680 Input of physical quantities with units
7042 \layout Standard
7681 \end_layout
7043
7682
7683 \begin_layout Standard
7044 The module
7684 The module
7045 \family typewriter
7685 \family typewriter
7046 PhysicalQInput
7686 PhysicalQInput
@@ -7060,8 +7700,9 b' Physics.PhysicalQuantities'
7060 \end_inset
7700 \end_inset
7061
7701
7062 ).
7702 ).
7063 \layout Standard
7703 \end_layout
7064
7704
7705 \begin_layout Standard
7065 The
7706 The
7066 \family typewriter
7707 \family typewriter
7067 Physics.PhysicalQuantities
7708 Physics.PhysicalQuantities
@@ -7075,14 +7716,15 b' PhysicalQuantity'
7075 \family typewriter
7716 \family typewriter
7076 v
7717 v
7077 \family default
7718 \family default
7078 as a velocity of 3\SpecialChar ~
7719 as a velocity of 3\InsetSpace ~
7079 m/s, normally you would write:
7720 m/s, normally you would write:
7080 \family typewriter
7721 \family typewriter
7081
7722
7082 \newline
7723 \newline
7083 In [1]: v = PhysicalQuantity(3,'m/s')
7724 In [1]: v = PhysicalQuantity(3,'m/s')
7084 \layout Standard
7725 \end_layout
7085
7726
7727 \begin_layout Standard
7086 Using the
7728 Using the
7087 \family typewriter
7729 \family typewriter
7088 PhysicalQ_Input
7730 PhysicalQ_Input
@@ -7097,8 +7739,9 b' In [1]: v = 3 m/s'
7097 \newline
7739 \newline
7098 which is much more convenient for interactive use (even though it is blatantly
7740 which is much more convenient for interactive use (even though it is blatantly
7099 invalid Python syntax).
7741 invalid Python syntax).
7100 \layout Standard
7742 \end_layout
7101
7743
7744 \begin_layout Standard
7102 The
7745 The
7103 \family typewriter
7746 \family typewriter
7104 physics
7747 physics
@@ -7108,25 +7751,29 b' physics'
7108 'ipython -p physics'
7751 'ipython -p physics'
7109 \family default
7752 \family default
7110 ) uses these extensions, which you can also activate with:
7753 ) uses these extensions, which you can also activate with:
7111 \layout Standard
7754 \end_layout
7112
7755
7756 \begin_layout Standard
7113
7757
7114 \family typewriter
7758 \family typewriter
7115 from math import * # math MUST be imported BEFORE PhysicalQInteractive
7759 from math import * # math MUST be imported BEFORE PhysicalQInteractive
7116 \newline
7760 \newline
7117 from IPython.Extensions.PhysicalQInteractive import *
7761 from
7762 IPython.Extensions.PhysicalQInteractive import *
7118 \newline
7763 \newline
7119 import IPython.Extensions.PhysicalQInput
7764 import IPython.Extensions.PhysicalQ
7120 \layout Section
7765 Input
7121
7766 \end_layout
7122
7767
7768 \begin_layout Section
7123 \begin_inset LatexCommand \label{sec:IPython-as-shell}
7769 \begin_inset LatexCommand \label{sec:IPython-as-shell}
7124
7770
7125 \end_inset
7771 \end_inset
7126
7772
7127 IPython as a system shell
7773 IPython as a system shell
7128 \layout Standard
7774 \end_layout
7129
7775
7776 \begin_layout Standard
7130 IPython ships with a special profile called
7777 IPython ships with a special profile called
7131 \family typewriter
7778 \family typewriter
7132 pysh
7779 pysh
@@ -7142,8 +7789,9 b' InterpreterExec'
7142 \family default
7789 \family default
7143 , along with some additional facilities and a prompt customized for filesystem
7790 , along with some additional facilities and a prompt customized for filesystem
7144 navigation.
7791 navigation.
7145 \layout Standard
7792 \end_layout
7146
7793
7794 \begin_layout Standard
7147 Note that this does
7795 Note that this does
7148 \emph on
7796 \emph on
7149 not
7797 not
@@ -7152,16 +7800,19 b' not'
7152 In particular, it has no job control, so if you type Ctrl-Z (under Unix),
7800 In particular, it has no job control, so if you type Ctrl-Z (under Unix),
7153 you'll suspend pysh itself, not the process you just started.
7801 you'll suspend pysh itself, not the process you just started.
7154
7802
7155 \layout Standard
7803 \end_layout
7156
7804
7805 \begin_layout Standard
7157 What the shell profile allows you to do is to use the convenient and powerful
7806 What the shell profile allows you to do is to use the convenient and powerful
7158 syntax of Python to do quick scripting at the command line.
7807 syntax of Python to do quick scripting at the command line.
7159 Below we describe some of its features.
7808 Below we describe some of its features.
7160 \layout Subsection
7809 \end_layout
7161
7810
7811 \begin_layout Subsection
7162 Aliases
7812 Aliases
7163 \layout Standard
7813 \end_layout
7164
7814
7815 \begin_layout Standard
7165 All of your
7816 All of your
7166 \family typewriter
7817 \family typewriter
7167 $PATH
7818 $PATH
@@ -7190,11 +7841,13 b' for details on the mechanism used to load'
7190 $PATH
7841 $PATH
7191 \family default
7842 \family default
7192 .
7843 .
7193 \layout Subsection
7844 \end_layout
7194
7845
7846 \begin_layout Subsection
7195 Special syntax
7847 Special syntax
7196 \layout Standard
7848 \end_layout
7197
7849
7850 \begin_layout Standard
7198 Any lines which begin with
7851 Any lines which begin with
7199 \family typewriter
7852 \family typewriter
7200 `~'
7853 `~'
@@ -7215,15 +7868,17 b' Any lines which begin with'
7215 \family default
7868 \family default
7216 is valid in single or multi-line input, all others are only valid in single-lin
7869 is valid in single or multi-line input, all others are only valid in single-lin
7217 e input:
7870 e input:
7218 \layout Description
7871 \end_layout
7219
7872
7873 \begin_layout Description
7220
7874
7221 \family typewriter
7875 \family typewriter
7222 !cmd
7876 !cmd
7223 \family default
7877 \family default
7224 pass `cmd' directly to the shell
7878 pass `cmd' directly to the shell
7225 \layout Description
7879 \end_layout
7226
7880
7881 \begin_layout Description
7227
7882
7228 \family typewriter
7883 \family typewriter
7229 !!cmd
7884 !!cmd
@@ -7231,15 +7886,17 b' e input:'
7231 execute `cmd' and return output as a list (split on `
7886 execute `cmd' and return output as a list (split on `
7232 \backslash
7887 \backslash
7233 n')
7888 n')
7234 \layout Description
7889 \end_layout
7235
7890
7891 \begin_layout Description
7236
7892
7237 \family typewriter
7893 \family typewriter
7238 $var=cmd
7894 $var=cmd
7239 \family default
7895 \family default
7240 capture output of cmd into var, as a string
7896 capture output of cmd into var, as a string
7241 \layout Description
7897 \end_layout
7242
7898
7899 \begin_layout Description
7243
7900
7244 \family typewriter
7901 \family typewriter
7245 $$var=cmd
7902 $$var=cmd
@@ -7247,8 +7904,9 b' $$var=cmd'
7247 capture output of cmd into var, as a list (split on `
7904 capture output of cmd into var, as a list (split on `
7248 \backslash
7905 \backslash
7249 n')
7906 n')
7250 \layout Standard
7907 \end_layout
7251
7908
7909 \begin_layout Standard
7252 The
7910 The
7253 \family typewriter
7911 \family typewriter
7254 $
7912 $
@@ -7275,71 +7933,82 b' $'
7275 \family default
7933 \family default
7276 .
7934 .
7277 Full details of the allowed syntax can be found in Python's PEP 215.
7935 Full details of the allowed syntax can be found in Python's PEP 215.
7278 \layout Standard
7936 \end_layout
7279
7937
7938 \begin_layout Standard
7280 A few brief examples will illustrate these (note that the indentation below
7939 A few brief examples will illustrate these (note that the indentation below
7281 may be incorrectly displayed):
7940 may be incorrectly displayed):
7282 \layout Standard
7941 \end_layout
7283
7942
7943 \begin_layout Standard
7284
7944
7285 \family typewriter
7945 \family typewriter
7286 fperez[~/test]|3> !ls *s.py
7946 fperez[~/test]|3> !ls *s.py
7287 \newline
7947 \newline
7288 scopes.py strings.py
7948 scopes.py strings.py
7289 \layout Standard
7949 \end_layout
7290
7950
7951 \begin_layout Standard
7291 ls is an internal alias, so there's no need to use
7952 ls is an internal alias, so there's no need to use
7292 \family typewriter
7953 \family typewriter
7293 !
7954 !
7294 \family default
7955 \family default
7295 :
7956 :
7296 \layout Standard
7957 \end_layout
7297
7958
7959 \begin_layout Standard
7298
7960
7299 \family typewriter
7961 \family typewriter
7300 fperez[~/test]|4> ls *s.py
7962 fperez[~/test]|4> ls *s.py
7301 \newline
7963 \newline
7302 scopes.py* strings.py
7964 scopes.py* strings.py
7303 \layout Standard
7965 \end_layout
7304
7966
7967 \begin_layout Standard
7305 !!ls will return the output into a Python variable:
7968 !!ls will return the output into a Python variable:
7306 \layout Standard
7969 \end_layout
7307
7970
7971 \begin_layout Standard
7308
7972
7309 \family typewriter
7973 \family typewriter
7310 fperez[~/test]|5> !!ls *s.py
7974 fperez[~/test]|5> !!ls *s.py
7311 \newline
7975 \newline
7312
7976
7313 \begin_inset ERT
7977 \begin_inset ERT
7314 status Collapsed
7978 status collapsed
7979
7980 \begin_layout Standard
7315
7981
7316 \layout Standard
7317
7982
7318 \backslash
7983 \backslash
7319 hspace*{0mm}
7984 hspace*{0mm}
7320 \end_inset
7985 \end_layout
7321
7986
7322 \SpecialChar ~
7987 \end_inset
7323 \SpecialChar ~
7988
7324 \SpecialChar ~
7989 \InsetSpace ~
7325 \SpecialChar ~
7990 \InsetSpace ~
7326 \SpecialChar ~
7991 \InsetSpace ~
7327 \SpecialChar ~
7992 \InsetSpace ~
7328 \SpecialChar ~
7993 \InsetSpace ~
7329 \SpecialChar ~
7994 \InsetSpace ~
7330 \SpecialChar ~
7995 \InsetSpace ~
7331 \SpecialChar ~
7996 \InsetSpace ~
7332 \SpecialChar ~
7997 \InsetSpace ~
7333 \SpecialChar ~
7998 \InsetSpace ~
7334 \SpecialChar ~
7999 \InsetSpace ~
7335 \SpecialChar ~
8000 \InsetSpace ~
8001 \InsetSpace ~
8002 \InsetSpace ~
7336 <5> ['scopes.py', 'strings.py']
8003 <5> ['scopes.py', 'strings.py']
7337 \newline
8004 \newline
7338 fperez[~/test]|6> print _5
8005 fperez[~/test]|6> print _5
7339 \newline
8006 \newline
7340 ['scopes.py', 'strings.py']
8007 ['scopes.py', 'strings.py
7341 \layout Standard
8008 ']
8009 \end_layout
7342
8010
8011 \begin_layout Standard
7343
8012
7344 \family typewriter
8013 \family typewriter
7345 $
8014 $
@@ -7349,8 +8018,9 b' $'
7349 $$
8018 $$
7350 \family default
8019 \family default
7351 allow direct capture to named variables:
8020 allow direct capture to named variables:
7352 \layout Standard
8021 \end_layout
7353
8022
8023 \begin_layout Standard
7354
8024
7355 \family typewriter
8025 \family typewriter
7356 fperez[~/test]|7> $astr = ls *s.py
8026 fperez[~/test]|7> $astr = ls *s.py
@@ -7359,33 +8029,37 b' fperez[~/test]|8> astr'
7359 \newline
8029 \newline
7360
8030
7361 \begin_inset ERT
8031 \begin_inset ERT
7362 status Collapsed
8032 status collapsed
8033
8034 \begin_layout Standard
7363
8035
7364 \layout Standard
7365
8036
7366 \backslash
8037 \backslash
7367 hspace*{0mm}
8038 hspace*{0mm}
7368 \end_inset
8039 \end_layout
7369
8040
7370 \SpecialChar ~
8041 \end_inset
7371 \SpecialChar ~
8042
7372 \SpecialChar ~
8043 \InsetSpace ~
7373 \SpecialChar ~
8044 \InsetSpace ~
7374 \SpecialChar ~
8045 \InsetSpace ~
7375 \SpecialChar ~
8046 \InsetSpace ~
7376 \SpecialChar ~
8047 \InsetSpace ~
7377 \SpecialChar ~
8048 \InsetSpace ~
7378 \SpecialChar ~
8049 \InsetSpace ~
7379 \SpecialChar ~
8050 \InsetSpace ~
7380 \SpecialChar ~
8051 \InsetSpace ~
7381 \SpecialChar ~
8052 \InsetSpace ~
7382 \SpecialChar ~
8053 \InsetSpace ~
7383 \SpecialChar ~
8054 \InsetSpace ~
8055 \InsetSpace ~
8056 \InsetSpace ~
7384 <8> 'scopes.py
8057 <8> 'scopes.py
7385 \backslash
8058 \backslash
7386 nstrings.py'
8059 nstrings.py'
7387 \layout Standard
8060 \end_layout
7388
8061
8062 \begin_layout Standard
7389
8063
7390 \family typewriter
8064 \family typewriter
7391 fperez[~/test]|9> $$alist = ls *s.py
8065 fperez[~/test]|9> $$alist = ls *s.py
@@ -7394,134 +8068,149 b' fperez[~/test]|10> alist'
7394 \newline
8068 \newline
7395
8069
7396 \begin_inset ERT
8070 \begin_inset ERT
7397 status Collapsed
8071 status collapsed
8072
8073 \begin_layout Standard
7398
8074
7399 \layout Standard
7400
8075
7401 \backslash
8076 \backslash
7402 hspace*{0mm}
8077 hspace*{0mm}
7403 \end_inset
8078 \end_layout
7404
8079
7405 \SpecialChar ~
8080 \end_inset
7406 \SpecialChar ~
8081
7407 \SpecialChar ~
8082 \InsetSpace ~
7408 \SpecialChar ~
8083 \InsetSpace ~
7409 \SpecialChar ~
8084 \InsetSpace ~
7410 \SpecialChar ~
8085 \InsetSpace ~
7411 \SpecialChar ~
8086 \InsetSpace ~
7412 \SpecialChar ~
8087 \InsetSpace ~
7413 \SpecialChar ~
8088 \InsetSpace ~
7414 \SpecialChar ~
8089 \InsetSpace ~
7415 \SpecialChar ~
8090 \InsetSpace ~
7416 \SpecialChar ~
8091 \InsetSpace ~
7417 \SpecialChar ~
8092 \InsetSpace ~
7418 \SpecialChar ~
8093 \InsetSpace ~
8094 \InsetSpace ~
8095 \InsetSpace ~
7419 <10> ['scopes.py', 'strings.py']
8096 <10> ['scopes.py', 'strings.py']
7420 \layout Standard
8097 \end_layout
7421
8098
8099 \begin_layout Standard
7422 alist is now a normal python list you can loop over.
8100 alist is now a normal python list you can loop over.
7423 Using
8101 Using
7424 \family typewriter
8102 \family typewriter
7425 $
8103 $
7426 \family default
8104 \family default
7427 will expand back the python values when alias calls are made:
8105 will expand back the python values when alias calls are made:
7428 \layout Standard
8106 \end_layout
7429
8107
8108 \begin_layout Standard
7430
8109
7431 \family typewriter
8110 \family typewriter
7432 fperez[~/test]|11> for f in alist:
8111 fperez[~/test]|11> for f in alist:
7433 \newline
8112 \newline
7434
8113
7435 \begin_inset ERT
8114 \begin_inset ERT
7436 status Collapsed
8115 status collapsed
8116
8117 \begin_layout Standard
7437
8118
7438 \layout Standard
7439
8119
7440 \backslash
8120 \backslash
7441 hspace*{0mm}
8121 hspace*{0mm}
7442 \end_inset
8122 \end_layout
7443
8123
7444 \SpecialChar ~
8124 \end_inset
7445 \SpecialChar ~
8125
7446 \SpecialChar ~
8126 \InsetSpace ~
7447 \SpecialChar ~
8127 \InsetSpace ~
7448 \SpecialChar ~
8128 \InsetSpace ~
7449 \SpecialChar ~
8129 \InsetSpace ~
7450 \SpecialChar ~
8130 \InsetSpace ~
7451 \SpecialChar ~
8131 \InsetSpace ~
7452 \SpecialChar ~
8132 \InsetSpace ~
7453 \SpecialChar ~
8133 \InsetSpace ~
7454 \SpecialChar ~
8134 \InsetSpace ~
7455 \SpecialChar ~
8135 \InsetSpace ~
7456 \SpecialChar ~
8136 \InsetSpace ~
7457 \SpecialChar ~
8137 \InsetSpace ~
7458 |..> \SpecialChar ~
8138 \InsetSpace ~
7459 \SpecialChar ~
8139 \InsetSpace ~
7460 \SpecialChar ~
8140 |..> \InsetSpace ~
7461 \SpecialChar ~
8141 \InsetSpace ~
8142 \InsetSpace ~
8143 \InsetSpace ~
7462 print 'file',f,
8144 print 'file',f,
7463 \newline
8145 \newline
7464
8146
7465 \begin_inset ERT
8147 \begin_inset ERT
7466 status Collapsed
8148 status collapsed
8149
8150 \begin_layout Standard
7467
8151
7468 \layout Standard
7469
8152
7470 \backslash
8153 \backslash
7471 hspace*{0mm}
8154 hspace*{0mm}
7472 \end_inset
8155 \end_layout
7473
8156
7474 \SpecialChar ~
8157 \end_inset
7475 \SpecialChar ~
8158
7476 \SpecialChar ~
8159 \InsetSpace ~
7477 \SpecialChar ~
8160 \InsetSpace ~
7478 \SpecialChar ~
8161 \InsetSpace ~
7479 \SpecialChar ~
8162 \InsetSpace ~
7480 \SpecialChar ~
8163 \InsetSpace ~
7481 \SpecialChar ~
8164 \InsetSpace ~
7482 \SpecialChar ~
8165 \InsetSpace ~
7483 \SpecialChar ~
8166 \InsetSpace ~
7484 \SpecialChar ~
8167 \InsetSpace ~
7485 \SpecialChar ~
8168 \InsetSpace ~
7486 \SpecialChar ~
8169 \InsetSpace ~
7487 \SpecialChar ~
8170 \InsetSpace ~
7488 |..> \SpecialChar ~
8171 \InsetSpace ~
7489 \SpecialChar ~
8172 \InsetSpace ~
7490 \SpecialChar ~
8173 |..> \InsetSpace ~
7491 \SpecialChar ~
8174 \InsetSpace ~
8175 \InsetSpace ~
8176 \InsetSpace ~
7492 wc -l $f
8177 wc -l $f
7493 \newline
8178 \newline
7494
8179
7495 \begin_inset ERT
8180 \begin_inset ERT
7496 status Collapsed
8181 status collapsed
8182
8183 \begin_layout Standard
7497
8184
7498 \layout Standard
7499
8185
7500 \backslash
8186 \backslash
7501 hspace*{0mm}
8187 hspace*{0mm}
7502 \end_inset
8188 \end_layout
7503
8189
7504 \SpecialChar ~
8190 \end_inset
7505 \SpecialChar ~
8191
7506 \SpecialChar ~
8192 \InsetSpace ~
7507 \SpecialChar ~
8193 \InsetSpace ~
7508 \SpecialChar ~
8194 \InsetSpace ~
7509 \SpecialChar ~
8195 \InsetSpace ~
7510 \SpecialChar ~
8196 \InsetSpace ~
7511 \SpecialChar ~
8197 \InsetSpace ~
7512 \SpecialChar ~
8198 \InsetSpace ~
7513 \SpecialChar ~
8199 \InsetSpace ~
7514 \SpecialChar ~
8200 \InsetSpace ~
7515 \SpecialChar ~
8201 \InsetSpace ~
7516 \SpecialChar ~
8202 \InsetSpace ~
7517 \SpecialChar ~
8203 \InsetSpace ~
8204 \InsetSpace ~
8205 \InsetSpace ~
7518 |..>
8206 |..>
7519 \newline
8207 \newline
7520 file scopes.py 13 scopes.py
8208 file scopes.py 13 scopes.py
7521 \newline
8209 \newline
7522 file strings.py 4 strings.py
8210 file strings.py 4 strings.py
7523 \layout Standard
8211 \end_layout
7524
8212
8213 \begin_layout Standard
7525 Note that you may need to protect your variables with braces if you want
8214 Note that you may need to protect your variables with braces if you want
7526 to append strings to their names.
8215 to append strings to their names.
7527 To copy all files in alist to
8216 To copy all files in alist to
@@ -7529,43 +8218,48 b' Note that you may need to protect your variables with braces if you want'
7529 .bak
8218 .bak
7530 \family default
8219 \family default
7531 extensions, you must use:
8220 extensions, you must use:
7532 \layout Standard
8221 \end_layout
7533
8222
8223 \begin_layout Standard
7534
8224
7535 \family typewriter
8225 \family typewriter
7536 fperez[~/test]|12> for f in alist:
8226 fperez[~/test]|12> for f in alist:
7537 \newline
8227 \newline
7538
8228
7539 \begin_inset ERT
8229 \begin_inset ERT
7540 status Collapsed
8230 status collapsed
8231
8232 \begin_layout Standard
7541
8233
7542 \layout Standard
7543
8234
7544 \backslash
8235 \backslash
7545 hspace*{0mm}
8236 hspace*{0mm}
7546 \end_inset
8237 \end_layout
7547
8238
7548 \SpecialChar ~
8239 \end_inset
7549 \SpecialChar ~
8240
7550 \SpecialChar ~
8241 \InsetSpace ~
7551 \SpecialChar ~
8242 \InsetSpace ~
7552 \SpecialChar ~
8243 \InsetSpace ~
7553 \SpecialChar ~
8244 \InsetSpace ~
7554 \SpecialChar ~
8245 \InsetSpace ~
7555 \SpecialChar ~
8246 \InsetSpace ~
7556 \SpecialChar ~
8247 \InsetSpace ~
7557 \SpecialChar ~
8248 \InsetSpace ~
7558 \SpecialChar ~
8249 \InsetSpace ~
7559 \SpecialChar ~
8250 \InsetSpace ~
7560 \SpecialChar ~
8251 \InsetSpace ~
7561 \SpecialChar ~
8252 \InsetSpace ~
7562 |..> \SpecialChar ~
8253 \InsetSpace ~
7563 \SpecialChar ~
8254 \InsetSpace ~
7564 \SpecialChar ~
8255 |..> \InsetSpace ~
7565 \SpecialChar ~
8256 \InsetSpace ~
8257 \InsetSpace ~
8258 \InsetSpace ~
7566 cp $f ${f}.bak
8259 cp $f ${f}.bak
7567 \layout Standard
8260 \end_layout
7568
8261
8262 \begin_layout Standard
7569 If you try using
8263 If you try using
7570 \family typewriter
8264 \family typewriter
7571 $f.bak
8265 $f.bak
@@ -7581,15 +8275,17 b' $f.bak'
7581 $
8275 $
7582 \family default
8276 \family default
7583 expansion mechanism allows you to expand full Python expressions:
8277 expansion mechanism allows you to expand full Python expressions:
7584 \layout Standard
8278 \end_layout
7585
8279
8280 \begin_layout Standard
7586
8281
7587 \family typewriter
8282 \family typewriter
7588 fperez[~/test]|13> echo "sys.platform is: $sys.platform"
8283 fperez[~/test]|13> echo "sys.platform is: $sys.platform"
7589 \newline
8284 \newline
7590 sys.platform is: linux2
8285 sys.platform is: linux2
7591 \layout Standard
8286 \end_layout
7592
8287
8288 \begin_layout Standard
7593 IPython's input history handling is still active, which allows you to rerun
8289 IPython's input history handling is still active, which allows you to rerun
7594 a single block of multi-line input by simply using exec:
8290 a single block of multi-line input by simply using exec:
7595 \newline
8291 \newline
@@ -7599,19 +8295,23 b' fperez[~/test]|14> $$alist = ls *.eps'
7599 \newline
8295 \newline
7600 fperez[~/test]|15> exec _i11
8296 fperez[~/test]|15> exec _i11
7601 \newline
8297 \newline
7602 file image2.eps 921 image2.eps
8298 file image2.eps
8299 921 image2.eps
7603 \newline
8300 \newline
7604 file image.eps 921 image.eps
8301 file image.eps 921 image.eps
7605 \layout Standard
8302 \end_layout
7606
8303
8304 \begin_layout Standard
7607 While these are new special-case syntaxes, they are designed to allow very
8305 While these are new special-case syntaxes, they are designed to allow very
7608 efficient use of the shell with minimal typing.
8306 efficient use of the shell with minimal typing.
7609 At an interactive shell prompt, conciseness of expression wins over readability.
8307 At an interactive shell prompt, conciseness of expression wins over readability.
7610 \layout Subsection
8308 \end_layout
7611
8309
8310 \begin_layout Subsection
7612 Useful functions and modules
8311 Useful functions and modules
7613 \layout Standard
8312 \end_layout
7614
8313
8314 \begin_layout Standard
7615 The os, sys and shutil modules from the Python standard library are automaticall
8315 The os, sys and shutil modules from the Python standard library are automaticall
7616 y loaded.
8316 y loaded.
7617 Some additional functions, useful for shell usage, are listed below.
8317 Some additional functions, useful for shell usage, are listed below.
@@ -7620,15 +8320,17 b' y loaded.'
7620 ?
8320 ?
7621 \family default
8321 \family default
7622 '.
8322 '.
7623 \layout Description
8323 \end_layout
7624
8324
8325 \begin_layout Description
7625
8326
7626 \family typewriter
8327 \family typewriter
7627 shell
8328 shell
7628 \family default
8329 \family default
7629 - execute a command in the underlying system shell
8330 - execute a command in the underlying system shell
7630 \layout Description
8331 \end_layout
7631
8332
8333 \begin_layout Description
7632
8334
7633 \family typewriter
8335 \family typewriter
7634 system
8336 system
@@ -7638,15 +8340,17 b' system'
7638 shell()
8340 shell()
7639 \family default
8341 \family default
7640 , but return the exit status of the command
8342 , but return the exit status of the command
7641 \layout Description
8343 \end_layout
7642
8344
8345 \begin_layout Description
7643
8346
7644 \family typewriter
8347 \family typewriter
7645 sout
8348 sout
7646 \family default
8349 \family default
7647 - capture the output of a command as a string
8350 - capture the output of a command as a string
7648 \layout Description
8351 \end_layout
7649
8352
8353 \begin_layout Description
7650
8354
7651 \family typewriter
8355 \family typewriter
7652 lout
8356 lout
@@ -7654,15 +8358,17 b' lout'
7654 - capture the output of a command as a list (split on `
8358 - capture the output of a command as a list (split on `
7655 \backslash
8359 \backslash
7656 n')
8360 n')
7657 \layout Description
8361 \end_layout
7658
8362
8363 \begin_layout Description
7659
8364
7660 \family typewriter
8365 \family typewriter
7661 getoutputerror
8366 getoutputerror
7662 \family default
8367 \family default
7663 - capture (output,error) of a shell commandss
8368 - capture (output,error) of a shell commandss
7664 \layout Standard
8369 \end_layout
7665
8370
8371 \begin_layout Standard
7666
8372
7667 \family typewriter
8373 \family typewriter
7668 sout
8374 sout
@@ -7690,16 +8396,19 b' $'
7690 $$
8396 $$
7691 \family default
8397 \family default
7692 are invalid).
8398 are invalid).
7693 \layout Subsection
8399 \end_layout
7694
8400
8401 \begin_layout Subsection
7695 Directory management
8402 Directory management
7696 \layout Standard
8403 \end_layout
7697
8404
8405 \begin_layout Standard
7698 Since each command passed by pysh to the underlying system is executed in
8406 Since each command passed by pysh to the underlying system is executed in
7699 a subshell which exits immediately, you can NOT use !cd to navigate the
8407 a subshell which exits immediately, you can NOT use !cd to navigate the
7700 filesystem.
8408 filesystem.
7701 \layout Standard
8409 \end_layout
7702
8410
8411 \begin_layout Standard
7703 Pysh provides its own builtin
8412 Pysh provides its own builtin
7704 \family typewriter
8413 \family typewriter
7705 `%cd
8414 `%cd
@@ -7719,8 +8428,9 b' Pysh provides its own builtin'
7719 `cd?
8428 `cd?
7720 \family default
8429 \family default
7721 ' for more details.
8430 ' for more details.
7722 \layout Standard
8431 \end_layout
7723
8432
8433 \begin_layout Standard
7724
8434
7725 \family typewriter
8435 \family typewriter
7726 %pushd
8436 %pushd
@@ -7734,11 +8444,13 b' Pysh provides its own builtin'
7734 %dirs
8444 %dirs
7735 \family default
8445 \family default
7736 are provided for directory stack handling.
8446 are provided for directory stack handling.
7737 \layout Subsection
8447 \end_layout
7738
8448
8449 \begin_layout Subsection
7739 Prompt customization
8450 Prompt customization
7740 \layout Standard
8451 \end_layout
7741
8452
8453 \begin_layout Standard
7742 The supplied
8454 The supplied
7743 \family typewriter
8455 \family typewriter
7744 ipythonrc-pysh
8456 ipythonrc-pysh
@@ -7746,30 +8458,35 b' ipythonrc-pysh'
7746 profile comes with an example of a very colored and detailed prompt, mainly
8458 profile comes with an example of a very colored and detailed prompt, mainly
7747 to serve as an illustration.
8459 to serve as an illustration.
7748 The valid escape sequences, besides color names, are:
8460 The valid escape sequences, besides color names, are:
7749 \layout Description
8461 \end_layout
7750
8462
8463 \begin_layout Description
7751
8464
7752 \backslash
8465 \backslash
7753 # - Prompt number.
8466 # - Prompt number.
7754 \layout Description
8467 \end_layout
7755
8468
8469 \begin_layout Description
7756
8470
7757 \backslash
8471 \backslash
7758 D - Dots, as many as there are digits in
8472 D - Dots, as many as there are digits in
7759 \backslash
8473 \backslash
7760 # (so they align).
8474 # (so they align).
7761 \layout Description
8475 \end_layout
7762
8476
8477 \begin_layout Description
7763
8478
7764 \backslash
8479 \backslash
7765 w - Current working directory (cwd).
8480 w - Current working directory (cwd).
7766 \layout Description
8481 \end_layout
7767
8482
8483 \begin_layout Description
7768
8484
7769 \backslash
8485 \backslash
7770 W - Basename of current working directory.
8486 W - Basename of current working directory.
7771 \layout Description
8487 \end_layout
7772
8488
8489 \begin_layout Description
7773
8490
7774 \backslash
8491 \backslash
7775 X
8492 X
@@ -7782,8 +8499,9 b' N'
7782 \emph default
8499 \emph default
7783 =0..5.
8500 =0..5.
7784 N terms of the cwd, with $HOME written as ~.
8501 N terms of the cwd, with $HOME written as ~.
7785 \layout Description
8502 \end_layout
7786
8503
8504 \begin_layout Description
7787
8505
7788 \backslash
8506 \backslash
7789 Y
8507 Y
@@ -7804,52 +8522,61 b' N'
7804 N
8522 N
7805 \emph default
8523 \emph default
7806 +1 it's also shown.
8524 +1 it's also shown.
7807 \layout Description
8525 \end_layout
7808
8526
8527 \begin_layout Description
7809
8528
7810 \backslash
8529 \backslash
7811 u - Username.
8530 u - Username.
7812 \layout Description
8531 \end_layout
7813
8532
8533 \begin_layout Description
7814
8534
7815 \backslash
8535 \backslash
7816 H - Full hostname.
8536 H - Full hostname.
7817 \layout Description
8537 \end_layout
7818
8538
8539 \begin_layout Description
7819
8540
7820 \backslash
8541 \backslash
7821 h - Hostname up to first '.'
8542 h - Hostname up to first '.'
7822 \layout Description
8543 \end_layout
7823
8544
8545 \begin_layout Description
7824
8546
7825 \backslash
8547 \backslash
7826 $ - Root symbol ($ or #).
8548 $ - Root symbol ($ or #).
7827
8549
7828 \layout Description
8550 \end_layout
7829
8551
8552 \begin_layout Description
7830
8553
7831 \backslash
8554 \backslash
7832 t - Current time, in H:M:S format.
8555 t - Current time, in H:M:S format.
7833 \layout Description
8556 \end_layout
7834
8557
8558 \begin_layout Description
7835
8559
7836 \backslash
8560 \backslash
7837 v - IPython release version.
8561 v - IPython release version.
7838
8562
7839 \layout Description
8563 \end_layout
7840
8564
8565 \begin_layout Description
7841
8566
7842 \backslash
8567 \backslash
7843 n - Newline.
8568 n - Newline.
7844
8569
7845 \layout Description
8570 \end_layout
7846
8571
8572 \begin_layout Description
7847
8573
7848 \backslash
8574 \backslash
7849 r - Carriage return.
8575 r - Carriage return.
7850
8576
7851 \layout Description
8577 \end_layout
7852
8578
8579 \begin_layout Description
7853
8580
7854 \backslash
8581 \backslash
7855
8582
@@ -7857,107 +8584,126 b' r - Carriage return.'
7857 - An explicitly escaped '
8584 - An explicitly escaped '
7858 \backslash
8585 \backslash
7859 '.
8586 '.
7860 \layout Standard
8587 \end_layout
7861
8588
8589 \begin_layout Standard
7862 You can configure your prompt colors using any ANSI color escape.
8590 You can configure your prompt colors using any ANSI color escape.
7863 Each color escape sets the color for any subsequent text, until another
8591 Each color escape sets the color for any subsequent text, until another
7864 escape comes in and changes things.
8592 escape comes in and changes things.
7865 The valid color escapes are:
8593 The valid color escapes are:
7866 \layout Description
8594 \end_layout
7867
8595
8596 \begin_layout Description
7868
8597
7869 \backslash
8598 \backslash
7870 C_Black
8599 C_Black
7871 \layout Description
8600 \end_layout
7872
8601
8602 \begin_layout Description
7873
8603
7874 \backslash
8604 \backslash
7875 C_Blue
8605 C_Blue
7876 \layout Description
8606 \end_layout
7877
8607
8608 \begin_layout Description
7878
8609
7879 \backslash
8610 \backslash
7880 C_Brown
8611 C_Brown
7881 \layout Description
8612 \end_layout
7882
8613
8614 \begin_layout Description
7883
8615
7884 \backslash
8616 \backslash
7885 C_Cyan
8617 C_Cyan
7886 \layout Description
8618 \end_layout
7887
8619
8620 \begin_layout Description
7888
8621
7889 \backslash
8622 \backslash
7890 C_DarkGray
8623 C_DarkGray
7891 \layout Description
8624 \end_layout
7892
8625
8626 \begin_layout Description
7893
8627
7894 \backslash
8628 \backslash
7895 C_Green
8629 C_Green
7896 \layout Description
8630 \end_layout
7897
8631
8632 \begin_layout Description
7898
8633
7899 \backslash
8634 \backslash
7900 C_LightBlue
8635 C_LightBlue
7901 \layout Description
8636 \end_layout
7902
8637
8638 \begin_layout Description
7903
8639
7904 \backslash
8640 \backslash
7905 C_LightCyan
8641 C_LightCyan
7906 \layout Description
8642 \end_layout
7907
8643
8644 \begin_layout Description
7908
8645
7909 \backslash
8646 \backslash
7910 C_LightGray
8647 C_LightGray
7911 \layout Description
8648 \end_layout
7912
8649
8650 \begin_layout Description
7913
8651
7914 \backslash
8652 \backslash
7915 C_LightGreen
8653 C_LightGreen
7916 \layout Description
8654 \end_layout
7917
8655
8656 \begin_layout Description
7918
8657
7919 \backslash
8658 \backslash
7920 C_LightPurple
8659 C_LightPurple
7921 \layout Description
8660 \end_layout
7922
8661
8662 \begin_layout Description
7923
8663
7924 \backslash
8664 \backslash
7925 C_LightRed
8665 C_LightRed
7926 \layout Description
8666 \end_layout
7927
8667
8668 \begin_layout Description
7928
8669
7929 \backslash
8670 \backslash
7930 C_Purple
8671 C_Purple
7931 \layout Description
8672 \end_layout
7932
8673
8674 \begin_layout Description
7933
8675
7934 \backslash
8676 \backslash
7935 C_Red
8677 C_Red
7936 \layout Description
8678 \end_layout
7937
8679
8680 \begin_layout Description
7938
8681
7939 \backslash
8682 \backslash
7940 C_White
8683 C_White
7941 \layout Description
8684 \end_layout
7942
8685
8686 \begin_layout Description
7943
8687
7944 \backslash
8688 \backslash
7945 C_Yellow
8689 C_Yellow
7946 \layout Description
8690 \end_layout
7947
8691
8692 \begin_layout Description
7948
8693
7949 \backslash
8694 \backslash
7950 C_Normal Stop coloring, defaults to your terminal settings.
8695 C_Normal Stop coloring, defaults to your terminal settings.
7951 \layout Section
8696 \end_layout
7952
7953
8697
8698 \begin_layout Section
7954 \begin_inset LatexCommand \label{sec:Threading-support}
8699 \begin_inset LatexCommand \label{sec:Threading-support}
7955
8700
7956 \end_inset
8701 \end_inset
7957
8702
7958 Threading support
8703 Threading support
7959 \layout Standard
8704 \end_layout
7960
8705
8706 \begin_layout Standard
7961
8707
7962 \series bold
8708 \series bold
7963 WARNING:
8709 WARNING:
@@ -7969,8 +8715,9 b' The threading support is still somewhat experimental, and it has only seen'
7969 Since I only have access to Linux machines, I will have to rely on user's
8715 Since I only have access to Linux machines, I will have to rely on user's
7970 experiences and assistance for this area of IPython to improve under other
8716 experiences and assistance for this area of IPython to improve under other
7971 platforms.
8717 platforms.
7972 \layout Standard
8718 \end_layout
7973
8719
8720 \begin_layout Standard
7974 IPython, via the
8721 IPython, via the
7975 \family typewriter
8722 \family typewriter
7976 -gthread
8723 -gthread
@@ -7983,7 +8730,7 b' IPython, via the'
7983 \family typewriter
8730 \family typewriter
7984 -wthread
8731 -wthread
7985 \family default
8732 \family default
7986 options (described in Sec.\SpecialChar ~
8733 options (described in Sec.\InsetSpace ~
7987
8734
7988 \begin_inset LatexCommand \ref{sec:threading-opts}
8735 \begin_inset LatexCommand \ref{sec:threading-opts}
7989
8736
@@ -7995,8 +8742,9 b' IPython, via the'
7995 under a normal Python interpreter, starting a pyGTK, Qt or WXPython application
8742 under a normal Python interpreter, starting a pyGTK, Qt or WXPython application
7996 will immediately freeze the shell.
8743 will immediately freeze the shell.
7997
8744
7998 \layout Standard
8745 \end_layout
7999
8746
8747 \begin_layout Standard
8000 IPython, with one of these options (you can only use one at a time), separates
8748 IPython, with one of these options (you can only use one at a time), separates
8001 the graphical loop and IPython's code execution run into different threads.
8749 the graphical loop and IPython's code execution run into different threads.
8002 This allows you to test interactively (with
8750 This allows you to test interactively (with
@@ -8004,8 +8752,9 b' IPython, with one of these options (you can only use one at a time), separates'
8004 %run
8752 %run
8005 \family default
8753 \family default
8006 , for example) your GUI code without blocking.
8754 , for example) your GUI code without blocking.
8007 \layout Standard
8755 \end_layout
8008
8756
8757 \begin_layout Standard
8009 A nice mini-tutorial on using IPython along with the Qt Designer application
8758 A nice mini-tutorial on using IPython along with the Qt Designer application
8010 is available at the SciPy wiki:
8759 is available at the SciPy wiki:
8011 \begin_inset LatexCommand \htmlurl{http://www.scipy.org/Cookbook/Matplotlib/Qt_with_IPython_and_Designer}
8760 \begin_inset LatexCommand \htmlurl{http://www.scipy.org/Cookbook/Matplotlib/Qt_with_IPython_and_Designer}
@@ -8013,12 +8762,14 b' A nice mini-tutorial on using IPython along with the Qt Designer application'
8013 \end_inset
8762 \end_inset
8014
8763
8015 .
8764 .
8016 \layout Subsection
8765 \end_layout
8017
8766
8767 \begin_layout Subsection
8018 Tk issues
8768 Tk issues
8019 \layout Standard
8769 \end_layout
8020
8770
8021 As indicated in Sec.\SpecialChar ~
8771 \begin_layout Standard
8772 As indicated in Sec.\InsetSpace ~
8022
8773
8023 \begin_inset LatexCommand \ref{sec:threading-opts}
8774 \begin_inset LatexCommand \ref{sec:threading-opts}
8024
8775
@@ -8034,11 +8785,13 b' As indicated in Sec.\\SpecialChar ~'
8034 dependent.
8785 dependent.
8035 Please experiment with simple test cases before committing to using this
8786 Please experiment with simple test cases before committing to using this
8036 combination of Tk and GTK/Qt/WX threading in a production environment.
8787 combination of Tk and GTK/Qt/WX threading in a production environment.
8037 \layout Subsection
8788 \end_layout
8038
8789
8790 \begin_layout Subsection
8039 Signals and Threads
8791 Signals and Threads
8040 \layout Standard
8792 \end_layout
8041
8793
8794 \begin_layout Standard
8042 When any of the thread systems (GTK, Qt or WX) are active, either directly
8795 When any of the thread systems (GTK, Qt or WX) are active, either directly
8043 or via
8796 or via
8044 \family typewriter
8797 \family typewriter
@@ -8058,8 +8811,9 b' SIGINT'
8058 ) across threads, so any long-running process started from IPython will
8811 ) across threads, so any long-running process started from IPython will
8059 run to completion, or will have to be killed via an external (OS-based)
8812 run to completion, or will have to be killed via an external (OS-based)
8060 mechanism.
8813 mechanism.
8061 \layout Standard
8814 \end_layout
8062
8815
8816 \begin_layout Standard
8063 To the best of my knowledge, this limitation is imposed by the Python interprete
8817 To the best of my knowledge, this limitation is imposed by the Python interprete
8064 r itself, and it comes from the difficulty of writing portable signal/threaded
8818 r itself, and it comes from the difficulty of writing portable signal/threaded
8065 code.
8819 code.
@@ -8075,16 +8829,18 b' runcode()'
8075 \family default
8829 \family default
8076 method.
8830 method.
8077
8831
8078 \layout Subsection
8832 \end_layout
8079
8833
8834 \begin_layout Subsection
8080 I/O pitfalls
8835 I/O pitfalls
8081 \layout Standard
8836 \end_layout
8082
8837
8838 \begin_layout Standard
8083 Be mindful that the Python interpreter switches between threads every
8839 Be mindful that the Python interpreter switches between threads every
8084 \begin_inset Formula $N$
8840 \begin_inset Formula $N$
8085 \end_inset
8841 \end_inset
8086
8842
8087 bytecodes, where the default value as of Python\SpecialChar ~
8843 bytecodes, where the default value as of Python\InsetSpace ~
8088 2.3 is
8844 2.3 is
8089 \begin_inset Formula $N=100.$
8845 \begin_inset Formula $N=100.$
8090 \end_inset
8846 \end_inset
@@ -8116,8 +8872,8 b" n'"
8116 \family typewriter
8872 \family typewriter
8117
8873
8118 \newline
8874 \newline
8119 \SpecialChar ~
8875 \InsetSpace ~
8120 \SpecialChar ~
8876 \InsetSpace ~
8121 print >> filehandle,
8877 print >> filehandle,
8122 \begin_inset Quotes eld
8878 \begin_inset Quotes eld
8123 \end_inset
8879 \end_inset
@@ -8136,8 +8892,9 b' actually consists of several bytecodes, so it is possible that the newline'
8136 be flushed until the buffer fills, and your other thread may see apparently
8892 be flushed until the buffer fills, and your other thread may see apparently
8137 truncated files.
8893 truncated files.
8138
8894
8139 \layout Standard
8895 \end_layout
8140
8896
8897 \begin_layout Standard
8141 For this reason, if you are using IPython's thread support and have (for
8898 For this reason, if you are using IPython's thread support and have (for
8142 example) a GUI application which will read data generated by files written
8899 example) a GUI application which will read data generated by files written
8143 to from the IPython thread, the safest approach is to open all of your
8900 to from the IPython thread, the safest approach is to open all of your
@@ -8149,27 +8906,29 b' file/open'
8149 \newline
8906 \newline
8150
8907
8151 \family typewriter
8908 \family typewriter
8152 \SpecialChar ~
8909 \InsetSpace ~
8153 \SpecialChar ~
8910 \InsetSpace ~
8154 filehandle = open(filename,mode,0)
8911 filehandle = open(filename,mode,0)
8155 \layout Standard
8912 \end_layout
8156
8913
8914 \begin_layout Standard
8157 This is obviously a brute force way of avoiding race conditions with the
8915 This is obviously a brute force way of avoiding race conditions with the
8158 file buffering.
8916 file buffering.
8159 If you want to do it cleanly, and you have a resource which is being shared
8917 If you want to do it cleanly, and you have a resource which is being shared
8160 by the interactive IPython loop and your GUI thread, you should really
8918 by the interactive IPython loop and your GUI thread, you should really
8161 handle it with thread locking and syncrhonization properties.
8919 handle it with thread locking and syncrhonization properties.
8162 The Python documentation discusses these.
8920 The Python documentation discusses these.
8163 \layout Section
8921 \end_layout
8164
8165
8922
8923 \begin_layout Section
8166 \begin_inset LatexCommand \label{sec:interactive-demos}
8924 \begin_inset LatexCommand \label{sec:interactive-demos}
8167
8925
8168 \end_inset
8926 \end_inset
8169
8927
8170 Interactive demos with IPython
8928 Interactive demos with IPython
8171 \layout Standard
8929 \end_layout
8172
8930
8931 \begin_layout Standard
8173 IPython ships with a basic system for running scripts interactively in sections,
8932 IPython ships with a basic system for running scripts interactively in sections,
8174 useful when presenting code to audiences.
8933 useful when presenting code to audiences.
8175 A few tags embedded in comments (so that the script remains valid Python
8934 A few tags embedded in comments (so that the script remains valid Python
@@ -8178,28 +8937,33 b' IPython ships with a basic system for running scripts interactively in sections,'
8178 executing it, and returning to the interactive prompt after each block.
8937 executing it, and returning to the interactive prompt after each block.
8179 The interactive namespace is updated after each block is run with the contents
8938 The interactive namespace is updated after each block is run with the contents
8180 of the demo's namespace.
8939 of the demo's namespace.
8181 \layout Standard
8940 \end_layout
8182
8941
8942 \begin_layout Standard
8183 This allows you to show a piece of code, run it and then execute interactively
8943 This allows you to show a piece of code, run it and then execute interactively
8184 commands based on the variables just created.
8944 commands based on the variables just created.
8185 Once you want to continue, you simply execute the next block of the demo.
8945 Once you want to continue, you simply execute the next block of the demo.
8186 The following listing shows the markup necessary for dividing a script
8946 The following listing shows the markup necessary for dividing a script
8187 into sections for execution as a demo.
8947 into sections for execution as a demo.
8188 \layout Standard
8948 \end_layout
8189
8190
8949
8950 \begin_layout Standard
8191 \begin_inset ERT
8951 \begin_inset ERT
8192 status Open
8952 status open
8953
8954 \begin_layout Standard
8193
8955
8194 \layout Standard
8195
8956
8196 \backslash
8957 \backslash
8197 codelist{examples/example-demo.py}
8958 codelist{examples/example-demo.py}
8959 \end_layout
8960
8198 \end_inset
8961 \end_inset
8199
8962
8200
8963
8201 \layout Standard
8964 \end_layout
8202
8965
8966 \begin_layout Standard
8203 In order to run a file as a demo, you must first make a
8967 In order to run a file as a demo, you must first make a
8204 \family typewriter
8968 \family typewriter
8205 Demo
8969 Demo
@@ -8210,14 +8974,17 b' Demo'
8210 myscript.py
8974 myscript.py
8211 \family default
8975 \family default
8212 , the following code will make a demo:
8976 , the following code will make a demo:
8213 \layout LyX-Code
8977 \end_layout
8214
8978
8979 \begin_layout LyX-Code
8215 from IPython.demo import Demo
8980 from IPython.demo import Demo
8216 \layout LyX-Code
8981 \end_layout
8217
8982
8983 \begin_layout LyX-Code
8218 mydemo = Demo('myscript.py')
8984 mydemo = Demo('myscript.py')
8219 \layout Standard
8985 \end_layout
8220
8986
8987 \begin_layout Standard
8221 This creates the
8988 This creates the
8222 \family typewriter
8989 \family typewriter
8223 mydemo
8990 mydemo
@@ -8226,11 +8993,13 b' mydemo'
8226 with no arguments.
8993 with no arguments.
8227 If you have autocall active in IPython (the default), all you need to do
8994 If you have autocall active in IPython (the default), all you need to do
8228 is type
8995 is type
8229 \layout LyX-Code
8996 \end_layout
8230
8997
8998 \begin_layout LyX-Code
8231 mydemo
8999 mydemo
8232 \layout Standard
9000 \end_layout
8233
9001
9002 \begin_layout Standard
8234 and IPython will call it, executing each block.
9003 and IPython will call it, executing each block.
8235 Demo objects can be restarted, you can move forward or back skipping blocks,
9004 Demo objects can be restarted, you can move forward or back skipping blocks,
8236 re-execute the last block, etc.
9005 re-execute the last block, etc.
@@ -8245,14 +9014,17 b' demo'
8245 \family default
9014 \family default
8246 module itself contains a comprehensive docstring, which you can access
9015 module itself contains a comprehensive docstring, which you can access
8247 via
9016 via
8248 \layout LyX-Code
9017 \end_layout
8249
9018
9019 \begin_layout LyX-Code
8250 from IPython import demo
9020 from IPython import demo
8251 \layout LyX-Code
9021 \end_layout
8252
9022
9023 \begin_layout LyX-Code
8253 demo?
9024 demo?
8254 \layout Standard
9025 \end_layout
8255
9026
9027 \begin_layout Standard
8256
9028
8257 \series bold
9029 \series bold
8258 Limitations:
9030 Limitations:
@@ -8269,16 +9041,16 b' not'
8269 If you want to be able to open an IPython instance at an arbitrary point
9041 If you want to be able to open an IPython instance at an arbitrary point
8270 in a program, you can use IPython's embedding facilities, described in
9042 in a program, you can use IPython's embedding facilities, described in
8271 detail in Sec\SpecialChar \@.
9043 detail in Sec\SpecialChar \@.
8272 \SpecialChar ~
9044 \InsetSpace ~
8273
9045
8274 \begin_inset LatexCommand \ref{sec:embed}
9046 \begin_inset LatexCommand \ref{sec:embed}
8275
9047
8276 \end_inset
9048 \end_inset
8277
9049
8278 .
9050 .
8279 \layout Section
9051 \end_layout
8280
8281
9052
9053 \begin_layout Section
8282 \begin_inset LatexCommand \label{sec:matplotlib-support}
9054 \begin_inset LatexCommand \label{sec:matplotlib-support}
8283
9055
8284 \end_inset
9056 \end_inset
@@ -8288,8 +9060,9 b' Plotting with'
8288 matplotlib
9060 matplotlib
8289 \family default
9061 \family default
8290
9062
8291 \layout Standard
9063 \end_layout
8292
9064
9065 \begin_layout Standard
8293 The matplotlib library (
9066 The matplotlib library (
8294 \begin_inset LatexCommand \htmlurl[http://matplotlib.sourceforge.net]{http://matplotlib.sourceforge.net}
9067 \begin_inset LatexCommand \htmlurl[http://matplotlib.sourceforge.net]{http://matplotlib.sourceforge.net}
8295
9068
@@ -8300,13 +9073,14 b' The matplotlib library ('
8300 including Tk, GTK and WXPython.
9073 including Tk, GTK and WXPython.
8301 It also provides a number of commands useful for scientific computing,
9074 It also provides a number of commands useful for scientific computing,
8302 all with a syntax compatible with that of the popular Matlab program.
9075 all with a syntax compatible with that of the popular Matlab program.
8303 \layout Standard
9076 \end_layout
8304
9077
9078 \begin_layout Standard
8305 IPython accepts the special option
9079 IPython accepts the special option
8306 \family typewriter
9080 \family typewriter
8307 -pylab
9081 -pylab
8308 \family default
9082 \family default
8309 (Sec.\SpecialChar ~
9083 (Sec.\InsetSpace ~
8310
9084
8311 \begin_inset LatexCommand \ref{sec:cmd-line-opts}
9085 \begin_inset LatexCommand \ref{sec:cmd-line-opts}
8312
9086
@@ -8334,8 +9108,9 b' lly select the proper threading model to prevent blocking.'
8334 show()
9108 show()
8335 \family default
9109 \family default
8336 command does not block the interactive shell.
9110 command does not block the interactive shell.
8337 \layout Standard
9111 \end_layout
8338
9112
9113 \begin_layout Standard
8339 The
9114 The
8340 \family typewriter
9115 \family typewriter
8341 -pylab
9116 -pylab
@@ -8344,7 +9119,7 b' The'
8344 mode.
9119 mode.
8345 However, you can still issue other options afterwards.
9120 However, you can still issue other options afterwards.
8346 This allows you to have a matplotlib-based environment customized with
9121 This allows you to have a matplotlib-based environment customized with
8347 additional modules using the standard IPython profile mechanism (Sec.\SpecialChar ~
9122 additional modules using the standard IPython profile mechanism (Sec.\InsetSpace ~
8348
9123
8349 \begin_inset LatexCommand \ref{sec:profiles}
9124 \begin_inset LatexCommand \ref{sec:profiles}
8350
9125
@@ -8359,9 +9134,9 b' ipython -pylab -p myprofile'
8359 ipythonrc-myprofile
9134 ipythonrc-myprofile
8360 \family default
9135 \family default
8361 after configuring matplotlib.
9136 after configuring matplotlib.
8362 \layout Section
9137 \end_layout
8363
8364
9138
9139 \begin_layout Section
8365 \begin_inset LatexCommand \label{sec:Gnuplot}
9140 \begin_inset LatexCommand \label{sec:Gnuplot}
8366
9141
8367 \end_inset
9142 \end_inset
@@ -8369,8 +9144,9 b' ipythonrc-myprofile'
8369 Plotting with
9144 Plotting with
8370 \family typewriter
9145 \family typewriter
8371 Gnuplot
9146 Gnuplot
8372 \layout Standard
9147 \end_layout
8373
9148
9149 \begin_layout Standard
8374 Through the magic extension system described in sec.
9150 Through the magic extension system described in sec.
8375
9151
8376 \begin_inset LatexCommand \ref{sec:magic}
9152 \begin_inset LatexCommand \ref{sec:magic}
@@ -8387,8 +9163,9 b' Through the magic extension system described in sec.'
8387 Gnuplot is a very complete 2D and 3D plotting package available for many
9163 Gnuplot is a very complete 2D and 3D plotting package available for many
8388 operating systems and commonly included in modern Linux distributions.
9164 operating systems and commonly included in modern Linux distributions.
8389
9165
8390 \layout Standard
9166 \end_layout
8391
9167
9168 \begin_layout Standard
8392 Besides having Gnuplot installed, this functionality requires the
9169 Besides having Gnuplot installed, this functionality requires the
8393 \family typewriter
9170 \family typewriter
8394 Gnuplot.py
9171 Gnuplot.py
@@ -8400,11 +9177,13 b' Gnuplot.py'
8400 \end_inset
9177 \end_inset
8401
9178
8402 .
9179 .
8403 \layout Subsection
9180 \end_layout
8404
9181
9182 \begin_layout Subsection
8405 Proper Gnuplot configuration
9183 Proper Gnuplot configuration
8406 \layout Standard
9184 \end_layout
8407
9185
9186 \begin_layout Standard
8408 As of version 4.0, Gnuplot has excellent mouse and interactive keyboard support.
9187 As of version 4.0, Gnuplot has excellent mouse and interactive keyboard support.
8409 However, as of
9188 However, as of
8410 \family typewriter
9189 \family typewriter
@@ -8436,8 +9215,9 b' prefer_inline_data'
8436 \family default
9215 \family default
8437 , but this is the default so unless you've changed it manually you should
9216 , but this is the default so unless you've changed it manually you should
8438 be fine).
9217 be fine).
8439 \layout Standard
9218 \end_layout
8440
9219
9220 \begin_layout Standard
8441 'Out of the box', Gnuplot is configured with a rather poor set of size,
9221 'Out of the box', Gnuplot is configured with a rather poor set of size,
8442 color and linewidth choices which make the graphs fairly hard to read on
9222 color and linewidth choices which make the graphs fairly hard to read on
8443 modern high-resolution displays (although they work fine on old 640x480
9223 modern high-resolution displays (although they work fine on old 640x480
@@ -8452,26 +9232,31 b' prefer_inline_data'
8452 `xrdb .Xdefaults`
9232 `xrdb .Xdefaults`
8453 \family default
9233 \family default
8454 :
9234 :
8455 \layout Standard
9235 \end_layout
8456
9236
9237 \begin_layout Standard
8457
9238
8458 \family typewriter
9239 \family typewriter
8459 !******************************************************************
9240 !******************************************************************
8460 \newline
9241 \newline
8461 ! gnuplot options
9242 ! gnuplot
9243 options
8462 \newline
9244 \newline
8463 ! modify this for a convenient window size
9245 ! modify this for a convenient window size
8464 \newline
9246 \newline
8465 gnuplot*geometry: 780x580
9247 gnuplot*geometry: 780x580
8466 \layout Standard
9248 \end_layout
8467
9249
9250 \begin_layout Standard
8468
9251
8469 \family typewriter
9252 \family typewriter
8470 ! on-screen font (not for PostScript)
9253 ! on-screen font (not for PostScript)
8471 \newline
9254 \newline
8472 gnuplot*font: -misc-fixed-bold-r-normal--15-120-100-100-c-90-iso8859-1
9255 gnuplot*font: -misc-fixed-bold-r-normal--15
8473 \layout Standard
9256 -120-100-100-c-90-iso8859-1
9257 \end_layout
8474
9258
9259 \begin_layout Standard
8475
9260
8476 \family typewriter
9261 \family typewriter
8477 ! color options
9262 ! color options
@@ -8480,41 +9265,48 b' gnuplot*background: black'
8480 \newline
9265 \newline
8481 gnuplot*textColor: white
9266 gnuplot*textColor: white
8482 \newline
9267 \newline
8483 gnuplot*borderColor: white
9268 gnuplot*borderCo
9269 lor: white
8484 \newline
9270 \newline
8485 gnuplot*axisColor: white
9271 gnuplot*axisColor: white
8486 \newline
9272 \newline
8487 gnuplot*line1Color: red
9273 gnuplot*line1Color: red
8488 \newline
9274 \newline
8489 gnuplot*line2Color: green
9275 gnuplot*line2Color:
9276 green
8490 \newline
9277 \newline
8491 gnuplot*line3Color: blue
9278 gnuplot*line3Color: blue
8492 \newline
9279 \newline
8493 gnuplot*line4Color: magenta
9280 gnuplot*line4Color: magenta
8494 \newline
9281 \newline
8495 gnuplot*line5Color: cyan
9282 gnuplot*line5Color:
9283 cyan
8496 \newline
9284 \newline
8497 gnuplot*line6Color: sienna
9285 gnuplot*line6Color: sienna
8498 \newline
9286 \newline
8499 gnuplot*line7Color: orange
9287 gnuplot*line7Color: orange
8500 \newline
9288 \newline
8501 gnuplot*line8Color: coral
9289 gnuplot*line8Color:
8502 \layout Standard
9290 coral
9291 \end_layout
8503
9292
9293 \begin_layout Standard
8504
9294
8505 \family typewriter
9295 \family typewriter
8506 ! multiplicative factor for point styles
9296 ! multiplicative factor for point styles
8507 \newline
9297 \newline
8508 gnuplot*pointsize: 2
9298 gnuplot*pointsize: 2
8509 \layout Standard
9299 \end_layout
8510
9300
9301 \begin_layout Standard
8511
9302
8512 \family typewriter
9303 \family typewriter
8513 ! line width options (in pixels)
9304 ! line width options (in pixels)
8514 \newline
9305 \newline
8515 gnuplot*borderWidth: 2
9306 gnuplot*borderWidth: 2
8516 \newline
9307 \newline
8517 gnuplot*axisWidth: 2
9308 gnuplot*axisWidth:
9309 2
8518 \newline
9310 \newline
8519 gnuplot*line1Width: 2
9311 gnuplot*line1Width: 2
8520 \newline
9312 \newline
@@ -8522,7 +9314,8 b' gnuplot*line2Width: 2'
8522 \newline
9314 \newline
8523 gnuplot*line3Width: 2
9315 gnuplot*line3Width: 2
8524 \newline
9316 \newline
8525 gnuplot*line4Width: 2
9317 gnuplot*line4Wi
9318 dth: 2
8526 \newline
9319 \newline
8527 gnuplot*line5Width: 2
9320 gnuplot*line5Width: 2
8528 \newline
9321 \newline
@@ -8530,16 +9323,19 b' gnuplot*line6Width: 2'
8530 \newline
9323 \newline
8531 gnuplot*line7Width: 2
9324 gnuplot*line7Width: 2
8532 \newline
9325 \newline
8533 gnuplot*line8Width: 2
9326 gnuplot*lin
8534 \layout Subsection
9327 e8Width: 2
9328 \end_layout
8535
9329
9330 \begin_layout Subsection
8536 The
9331 The
8537 \family typewriter
9332 \family typewriter
8538 IPython.GnuplotRuntime
9333 IPython.GnuplotRuntime
8539 \family default
9334 \family default
8540 module
9335 module
8541 \layout Standard
9336 \end_layout
8542
9337
9338 \begin_layout Standard
8543 IPython includes a module called
9339 IPython includes a module called
8544 \family typewriter
9340 \family typewriter
8545 Gnuplot2.py
9341 Gnuplot2.py
@@ -8564,8 +9360,9 b' hardcopy'
8564 \family default
9360 \family default
8565 fixes a bug in the original which under some circumstances blocks the creation
9361 fixes a bug in the original which under some circumstances blocks the creation
8566 of PostScript output.
9362 of PostScript output.
8567 \layout Standard
9363 \end_layout
8568
9364
9365 \begin_layout Standard
8569 For scripting use,
9366 For scripting use,
8570 \family typewriter
9367 \family typewriter
8571 GnuplotRuntime.py
9368 GnuplotRuntime.py
@@ -8577,8 +9374,9 b' Gnuplot2.py'
8577 and creates a series of global aliases.
9374 and creates a series of global aliases.
8578 These make it easy to control Gnuplot plotting jobs through the Python
9375 These make it easy to control Gnuplot plotting jobs through the Python
8579 language.
9376 language.
8580 \layout Standard
9377 \end_layout
8581
9378
9379 \begin_layout Standard
8582 Below is some example code which illustrates how to configure Gnuplot inside
9380 Below is some example code which illustrates how to configure Gnuplot inside
8583 your own programs but have it available for further interactive use through
9381 your own programs but have it available for further interactive use through
8584 an embedded IPython instance.
9382 an embedded IPython instance.
@@ -8588,28 +9386,33 b' Below is some example code which illustrates how to configure Gnuplot inside'
8588 example-gnuplot.py
9386 example-gnuplot.py
8589 \family default
9387 \family default
8590 in the examples directory:
9388 in the examples directory:
8591 \layout Standard
9389 \end_layout
8592
8593
9390
9391 \begin_layout Standard
8594 \begin_inset ERT
9392 \begin_inset ERT
8595 status Open
9393 status open
9394
9395 \begin_layout Standard
8596
9396
8597 \layout Standard
8598
9397
8599 \backslash
9398 \backslash
8600 codelist{examples/example-gnuplot.py}
9399 codelist{examples/example-gnuplot.py}
9400 \end_layout
9401
8601 \end_inset
9402 \end_inset
8602
9403
8603
9404
8604 \layout Subsection
9405 \end_layout
8605
9406
9407 \begin_layout Subsection
8606 The
9408 The
8607 \family typewriter
9409 \family typewriter
8608 numeric
9410 numeric
8609 \family default
9411 \family default
8610 profile: a scientific computing environment
9412 profile: a scientific computing environment
8611 \layout Standard
9413 \end_layout
8612
9414
9415 \begin_layout Standard
8613 The
9416 The
8614 \family typewriter
9417 \family typewriter
8615 numeric
9418 numeric
@@ -8646,8 +9449,9 b' gp'
8646 gphelp()
9449 gphelp()
8647 \family default
9450 \family default
8648 for further details.
9451 for further details.
8649 \layout Standard
9452 \end_layout
8650
9453
9454 \begin_layout Standard
8651 This should turn IPython into a convenient environment for numerical computing,
9455 This should turn IPython into a convenient environment for numerical computing,
8652 with all the functions in the NumPy library and the Gnuplot facilities
9456 with all the functions in the NumPy library and the Gnuplot facilities
8653 for plotting.
9457 for plotting.
@@ -8658,8 +9462,9 b' This should turn IPython into a convenient environment for numerical computing,'
8658 \end_inset
9462 \end_inset
8659
9463
8660 .
9464 .
8661 \layout Standard
9465 \end_layout
8662
9466
9467 \begin_layout Standard
8663 If you are in the middle of a working session with numerical objects and
9468 If you are in the middle of a working session with numerical objects and
8664 need to plot them but you didn't start the
9469 need to plot them but you didn't start the
8665 \family typewriter
9470 \family typewriter
@@ -8676,19 +9481,23 b' from IPython.GnuplotInteractive import *'
8676 at the IPython prompt.
9481 at the IPython prompt.
8677 This will allow you to keep your objects intact and start using Gnuplot
9482 This will allow you to keep your objects intact and start using Gnuplot
8678 to view them.
9483 to view them.
8679 \layout Section
9484 \end_layout
8680
9485
9486 \begin_layout Section
8681 Reporting bugs
9487 Reporting bugs
8682 \layout Subsection*
9488 \end_layout
8683
9489
9490 \begin_layout Subsection*
8684 Automatic crash reports
9491 Automatic crash reports
8685 \layout Standard
9492 \end_layout
8686
9493
9494 \begin_layout Standard
8687 Ideally, IPython itself shouldn't crash.
9495 Ideally, IPython itself shouldn't crash.
8688 It will catch exceptions produced by you, but bugs in its internals will
9496 It will catch exceptions produced by you, but bugs in its internals will
8689 still crash it.
9497 still crash it.
8690 \layout Standard
9498 \end_layout
8691
9499
9500 \begin_layout Standard
8692 In such a situation, IPython will leave a file named
9501 In such a situation, IPython will leave a file named
8693 \family typewriter
9502 \family typewriter
8694 IPython_crash_report.txt
9503 IPython_crash_report.txt
@@ -8707,11 +9516,13 b' IPython_crash_report.txt'
8707 a lot
9516 a lot
8708 \emph default
9517 \emph default
8709 in understanding the cause of the problem and fixing it sooner.
9518 in understanding the cause of the problem and fixing it sooner.
8710 \layout Subsection*
9519 \end_layout
8711
9520
9521 \begin_layout Subsection*
8712 The bug tracker
9522 The bug tracker
8713 \layout Standard
9523 \end_layout
8714
9524
9525 \begin_layout Standard
8715 IPython also has an online bug-tracker, located at
9526 IPython also has an online bug-tracker, located at
8716 \begin_inset LatexCommand \htmlurl{http://projects.scipy.org/ipython/ipython/report/1}
9527 \begin_inset LatexCommand \htmlurl{http://projects.scipy.org/ipython/ipython/report/1}
8717
9528
@@ -8722,29 +9533,37 b' IPython also has an online bug-tracker, located at'
8722 a bug report here.
9533 a bug report here.
8723 This will ensure that the issue is properly followed to conclusion.
9534 This will ensure that the issue is properly followed to conclusion.
8724 To report new bugs you will have to register first.
9535 To report new bugs you will have to register first.
8725 \layout Standard
9536 \end_layout
8726
9537
9538 \begin_layout Standard
8727 You can also use this bug tracker to file feature requests.
9539 You can also use this bug tracker to file feature requests.
8728 \layout Section
9540 \end_layout
8729
9541
9542 \begin_layout Section
8730 Brief history
9543 Brief history
8731 \layout Subsection
9544 \end_layout
8732
9545
9546 \begin_layout Subsection
8733 Origins
9547 Origins
8734 \layout Standard
9548 \end_layout
8735
9549
9550 \begin_layout Standard
8736 The current IPython system grew out of the following three projects:
9551 The current IPython system grew out of the following three projects:
8737 \layout List
9552 \end_layout
8738 \labelwidthstring 00.00.0000
8739
9553
9554 \begin_layout List
9555 \labelwidthstring 00.00.0000
8740 ipython by Fernando P
9556 ipython by Fernando P
8741 \begin_inset ERT
9557 \begin_inset ERT
8742 status Collapsed
9558 status collapsed
9559
9560 \begin_layout Standard
8743
9561
8744 \layout Standard
8745
9562
8746 \backslash
9563 \backslash
8747 '{e}
9564 '{e}
9565 \end_layout
9566
8748 \end_inset
9567 \end_inset
8749
9568
8750 rez.
9569 rez.
@@ -8754,17 +9573,19 b' rez.'
8754 $PYTHONSTARTUP
9573 $PYTHONSTARTUP
8755 \family default
9574 \family default
8756 ) to the standard Python interactive interpreter.
9575 ) to the standard Python interactive interpreter.
8757 \layout List
9576 \end_layout
8758 \labelwidthstring 00.00.0000
8759
9577
9578 \begin_layout List
9579 \labelwidthstring 00.00.0000
8760 IPP by Janko Hauser.
9580 IPP by Janko Hauser.
8761 Very well organized, great usability.
9581 Very well organized, great usability.
8762 Had an old help system.
9582 Had an old help system.
8763 IPP was used as the `container' code into which I added the functionality
9583 IPP was used as the `container' code into which I added the functionality
8764 from ipython and LazyPython.
9584 from ipython and LazyPython.
8765 \layout List
9585 \end_layout
8766 \labelwidthstring 00.00.0000
8767
9586
9587 \begin_layout List
9588 \labelwidthstring 00.00.0000
8768 LazyPython by Nathan Gray.
9589 LazyPython by Nathan Gray.
8769 Simple but
9590 Simple but
8770 \emph on
9591 \emph on
@@ -8773,8 +9594,9 b' very'
8773 powerful.
9594 powerful.
8774 The quick syntax (auto parens, auto quotes) and verbose/colored tracebacks
9595 The quick syntax (auto parens, auto quotes) and verbose/colored tracebacks
8775 were all taken from here.
9596 were all taken from here.
8776 \layout Standard
9597 \end_layout
8777
9598
9599 \begin_layout Standard
8778 When I found out (see sec.
9600 When I found out (see sec.
8779
9601
8780 \begin_inset LatexCommand \ref{figgins}
9602 \begin_inset LatexCommand \ref{figgins}
@@ -8788,17 +9610,20 b' When I found out (see sec.'
8788 and help facilities.
9610 and help facilities.
8789 I think it worked reasonably well, though it was a lot more work than I
9611 I think it worked reasonably well, though it was a lot more work than I
8790 had initially planned.
9612 had initially planned.
8791 \layout Subsection
9613 \end_layout
8792
9614
9615 \begin_layout Subsection
8793 Current status
9616 Current status
8794 \layout Standard
9617 \end_layout
8795
9618
9619 \begin_layout Standard
8796 The above listed features work, and quite well for the most part.
9620 The above listed features work, and quite well for the most part.
8797 But until a major internal restructuring is done (see below), only bug
9621 But until a major internal restructuring is done (see below), only bug
8798 fixing will be done, no other features will be added (unless very minor
9622 fixing will be done, no other features will be added (unless very minor
8799 and well localized in the cleaner parts of the code).
9623 and well localized in the cleaner parts of the code).
8800 \layout Standard
9624 \end_layout
8801
9625
9626 \begin_layout Standard
8802 IPython consists of some 18000 lines of pure python code, of which roughly
9627 IPython consists of some 18000 lines of pure python code, of which roughly
8803 two thirds is reasonably clean.
9628 two thirds is reasonably clean.
8804 The rest is, messy code which needs a massive restructuring before any
9629 The rest is, messy code which needs a massive restructuring before any
@@ -8806,11 +9631,13 b' IPython consists of some 18000 lines of pure python code, of which roughly'
8806 Even the messy code is fairly well documented though, and most of the problems
9631 Even the messy code is fairly well documented though, and most of the problems
8807 in the (non-existent) class design are well pointed to by a PyChecker run.
9632 in the (non-existent) class design are well pointed to by a PyChecker run.
8808 So the rewriting work isn't that bad, it will just be time-consuming.
9633 So the rewriting work isn't that bad, it will just be time-consuming.
8809 \layout Subsection
9634 \end_layout
8810
9635
9636 \begin_layout Subsection
8811 Future
9637 Future
8812 \layout Standard
9638 \end_layout
8813
9639
9640 \begin_layout Standard
8814 See the separate
9641 See the separate
8815 \family typewriter
9642 \family typewriter
8816 new_design
9643 new_design
@@ -8821,11 +9648,13 b' new_design'
8821 ve interpreter.
9648 ve interpreter.
8822 But that will never happen with the current state of the code, so all contribut
9649 But that will never happen with the current state of the code, so all contribut
8823 ions are welcome.
9650 ions are welcome.
8824 \layout Section
9651 \end_layout
8825
9652
9653 \begin_layout Section
8826 License
9654 License
8827 \layout Standard
9655 \end_layout
8828
9656
9657 \begin_layout Standard
8829 IPython is released under the terms of the BSD license, whose general form
9658 IPython is released under the terms of the BSD license, whose general form
8830 can be found at:
9659 can be found at:
8831 \begin_inset LatexCommand \htmlurl{http://www.opensource.org/licenses/bsd-license.php}
9660 \begin_inset LatexCommand \htmlurl{http://www.opensource.org/licenses/bsd-license.php}
@@ -8834,49 +9663,57 b' IPython is released under the terms of the BSD license, whose general form'
8834
9663
8835 .
9664 .
8836 The full text of the IPython license is reproduced below:
9665 The full text of the IPython license is reproduced below:
8837 \layout Quote
9666 \end_layout
8838
9667
9668 \begin_layout Quote
8839
9669
8840 \family typewriter
9670 \family typewriter
8841 \size small
9671 \size small
8842 IPython is released under a BSD-type license.
9672 IPython is released under a BSD-type license.
8843 \layout Quote
9673 \end_layout
8844
9674
9675 \begin_layout Quote
8845
9676
8846 \family typewriter
9677 \family typewriter
8847 \size small
9678 \size small
8848 Copyright (c) 2001, 2002, 2003, 2004 Fernando Perez <fperez@colorado.edu>.
9679 Copyright (c) 2001, 2002, 2003, 2004 Fernando Perez <fperez@colorado.edu>.
8849 \layout Quote
9680 \end_layout
8850
9681
9682 \begin_layout Quote
8851
9683
8852 \family typewriter
9684 \family typewriter
8853 \size small
9685 \size small
8854 Copyright (c) 2001 Janko Hauser <jhauser@zscout.de> and
9686 Copyright (c) 2001 Janko Hauser <jhauser@zscout.de> and
8855 \newline
9687 \newline
8856 Nathaniel Gray <n8gray@caltech.edu>.
9688 Nathaniel Gray <n8gray@ca
8857 \layout Quote
9689 ltech.edu>.
9690 \end_layout
8858
9691
9692 \begin_layout Quote
8859
9693
8860 \family typewriter
9694 \family typewriter
8861 \size small
9695 \size small
8862 All rights reserved.
9696 All rights reserved.
8863 \layout Quote
9697 \end_layout
8864
9698
9699 \begin_layout Quote
8865
9700
8866 \family typewriter
9701 \family typewriter
8867 \size small
9702 \size small
8868 Redistribution and use in source and binary forms, with or without modification,
9703 Redistribution and use in source and binary forms, with or without modification,
8869 are permitted provided that the following conditions are met:
9704 are permitted provided that the following conditions are met:
8870 \layout Quote
9705 \end_layout
8871
9706
9707 \begin_layout Quote
8872
9708
8873 \family typewriter
9709 \family typewriter
8874 \size small
9710 \size small
8875 a.
9711 a.
8876 Redistributions of source code must retain the above copyright notice,
9712 Redistributions of source code must retain the above copyright notice,
8877 this list of conditions and the following disclaimer.
9713 this list of conditions and the following disclaimer.
8878 \layout Quote
9714 \end_layout
8879
9715
9716 \begin_layout Quote
8880
9717
8881 \family typewriter
9718 \family typewriter
8882 \size small
9719 \size small
@@ -8884,8 +9721,9 b' b.'
8884 Redistributions in binary form must reproduce the above copyright notice,
9721 Redistributions in binary form must reproduce the above copyright notice,
8885 this list of conditions and the following disclaimer in the documentation
9722 this list of conditions and the following disclaimer in the documentation
8886 and/or other materials provided with the distribution.
9723 and/or other materials provided with the distribution.
8887 \layout Quote
9724 \end_layout
8888
9725
9726 \begin_layout Quote
8889
9727
8890 \family typewriter
9728 \family typewriter
8891 \size small
9729 \size small
@@ -8893,8 +9731,9 b' c.'
8893 Neither the name of the copyright holders nor the names of any contributors
9731 Neither the name of the copyright holders nor the names of any contributors
8894 to this software may be used to endorse or promote products derived from
9732 to this software may be used to endorse or promote products derived from
8895 this software without specific prior written permission.
9733 this software without specific prior written permission.
8896 \layout Quote
9734 \end_layout
8897
9735
9736 \begin_layout Quote
8898
9737
8899 \family typewriter
9738 \family typewriter
8900 \size small
9739 \size small
@@ -8910,12 +9749,14 b' THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS'
8910 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
9749 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
8911 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
9750 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
8912
9751
8913 \layout Standard
9752 \end_layout
8914
9753
9754 \begin_layout Standard
8915 Individual authors are the holders of the copyright for their code and are
9755 Individual authors are the holders of the copyright for their code and are
8916 listed in each file.
9756 listed in each file.
8917 \layout Standard
9757 \end_layout
8918
9758
9759 \begin_layout Standard
8919 Some files (
9760 Some files (
8920 \family typewriter
9761 \family typewriter
8921 DPyGetOpt.py
9762 DPyGetOpt.py
@@ -8923,8 +9764,9 b' DPyGetOpt.py'
8923 , for example) may be licensed under different conditions.
9764 , for example) may be licensed under different conditions.
8924 Ultimately each file indicates clearly the conditions under which its author/au
9765 Ultimately each file indicates clearly the conditions under which its author/au
8925 thors have decided to publish the code.
9766 thors have decided to publish the code.
8926 \layout Standard
9767 \end_layout
8927
9768
9769 \begin_layout Standard
8928 Versions of IPython up to and including 0.6.3 were released under the GNU
9770 Versions of IPython up to and including 0.6.3 were released under the GNU
8929 Lesser General Public License (LGPL), available at
9771 Lesser General Public License (LGPL), available at
8930 \begin_inset LatexCommand \htmlurl{http://www.gnu.org/copyleft/lesser.html}
9772 \begin_inset LatexCommand \htmlurl{http://www.gnu.org/copyleft/lesser.html}
@@ -8932,24 +9774,28 b' Versions of IPython up to and including 0.6.3 were released under the GNU'
8932 \end_inset
9774 \end_inset
8933
9775
8934 .
9776 .
8935 \layout Section
9777 \end_layout
8936
8937
9778
9779 \begin_layout Section
8938 \begin_inset LatexCommand \label{sec:credits}
9780 \begin_inset LatexCommand \label{sec:credits}
8939
9781
8940 \end_inset
9782 \end_inset
8941
9783
8942 Credits
9784 Credits
8943 \layout Standard
9785 \end_layout
8944
9786
9787 \begin_layout Standard
8945 IPython is mainly developed by Fernando P
9788 IPython is mainly developed by Fernando P
8946 \begin_inset ERT
9789 \begin_inset ERT
8947 status Collapsed
9790 status collapsed
9791
9792 \begin_layout Standard
8948
9793
8949 \layout Standard
8950
9794
8951 \backslash
9795 \backslash
8952 '{e}
9796 '{e}
9797 \end_layout
9798
8953 \end_inset
9799 \end_inset
8954
9800
8955 rez
9801 rez
@@ -8968,13 +9814,15 b' rez'
8968 .
9814 .
8969 For all IPython-related requests, please contact Fernando.
9815 For all IPython-related requests, please contact Fernando.
8970
9816
8971 \layout Standard
9817 \end_layout
8972
9818
9819 \begin_layout Standard
8973 As of early 2006, the following developers have joined the core team:
9820 As of early 2006, the following developers have joined the core team:
8974 \layout List
9821 \end_layout
8975 \labelwidthstring 00.00.0000
8976
9822
8977 Robert\SpecialChar ~
9823 \begin_layout List
9824 \labelwidthstring 00.00.0000
9825 Robert\InsetSpace ~
8978 Kern
9826 Kern
8979 \family typewriter
9827 \family typewriter
8980 <rkern-AT-enthought.com>
9828 <rkern-AT-enthought.com>
@@ -8988,61 +9836,69 b' ve notebooks (XML documents) and graphical interface.'
8988 and Toni Alatalo
9836 and Toni Alatalo
8989 \family typewriter
9837 \family typewriter
8990 <antont-AT-an.org>
9838 <antont-AT-an.org>
8991 \layout List
9839 \end_layout
8992 \labelwidthstring 00.00.0000
8993
9840
8994 Brian\SpecialChar ~
9841 \begin_layout List
9842 \labelwidthstring 00.00.0000
9843 Brian\InsetSpace ~
8995 Granger
9844 Granger
8996 \family typewriter
9845 \family typewriter
8997 <bgranger-AT-scu.edu>
9846 <bgranger-AT-scu.edu>
8998 \family default
9847 \family default
8999 : extending IPython to allow support for interactive parallel computing.
9848 : extending IPython to allow support for interactive parallel computing.
9000 \layout List
9849 \end_layout
9001 \labelwidthstring 00.00.0000
9002
9850
9003 Ville\SpecialChar ~
9851 \begin_layout List
9852 \labelwidthstring 00.00.0000
9853 Ville\InsetSpace ~
9004 Vainio
9854 Vainio
9005 \family typewriter
9855 \family typewriter
9006 <vivainio-AT-gmail.com>
9856 <vivainio-AT-gmail.com>
9007 \family default
9857 \family default
9008 : Ville is the new maintainer for the main trunk of IPython after version
9858 : Ville is the new maintainer for the main trunk of IPython after version
9009 0.7.1.
9859 0.7.1.
9010 \layout Standard
9860 \end_layout
9011
9861
9862 \begin_layout Standard
9012 User or development help should be requested via the IPython mailing lists:
9863 User or development help should be requested via the IPython mailing lists:
9013 \layout Description
9864 \end_layout
9014
9865
9015 User\SpecialChar ~
9866 \begin_layout Description
9867 User\InsetSpace ~
9016 list:
9868 list:
9017 \begin_inset LatexCommand \htmlurl{http://scipy.net/mailman/listinfo/ipython-user}
9869 \begin_inset LatexCommand \htmlurl{http://scipy.net/mailman/listinfo/ipython-user}
9018
9870
9019 \end_inset
9871 \end_inset
9020
9872
9021
9873
9022 \layout Description
9874 \end_layout
9023
9875
9024 Developer's\SpecialChar ~
9876 \begin_layout Description
9877 Developer's\InsetSpace ~
9025 list:
9878 list:
9026 \begin_inset LatexCommand \htmlurl{http://scipy.net/mailman/listinfo/ipython-dev}
9879 \begin_inset LatexCommand \htmlurl{http://scipy.net/mailman/listinfo/ipython-dev}
9027
9880
9028 \end_inset
9881 \end_inset
9029
9882
9030
9883
9031 \layout Standard
9884 \end_layout
9032
9885
9886 \begin_layout Standard
9033 The IPython project is also very grateful to
9887 The IPython project is also very grateful to
9034 \begin_inset Foot
9888 \begin_inset Foot
9035 collapsed true
9889 status collapsed
9036
9037 \layout Standard
9038
9890
9891 \begin_layout Standard
9039 I've mangled email addresses to reduce spam, since the IPython manuals can
9892 I've mangled email addresses to reduce spam, since the IPython manuals can
9040 be accessed online.
9893 be accessed online.
9894 \end_layout
9895
9041 \end_inset
9896 \end_inset
9042
9897
9043 :
9898 :
9044 \layout Standard
9899 \end_layout
9045
9900
9901 \begin_layout Standard
9046 Bill Bumgarner
9902 Bill Bumgarner
9047 \family typewriter
9903 \family typewriter
9048 <bbum-AT-friday.com>
9904 <bbum-AT-friday.com>
@@ -9050,16 +9906,18 b' Bill Bumgarner'
9050 : for providing the DPyGetOpt module which gives very powerful and convenient
9906 : for providing the DPyGetOpt module which gives very powerful and convenient
9051 handling of command-line options (light years ahead of what Python 2.1.1's
9907 handling of command-line options (light years ahead of what Python 2.1.1's
9052 getopt module does).
9908 getopt module does).
9053 \layout Standard
9909 \end_layout
9054
9910
9911 \begin_layout Standard
9055 Ka-Ping Yee
9912 Ka-Ping Yee
9056 \family typewriter
9913 \family typewriter
9057 <ping-AT-lfw.org>
9914 <ping-AT-lfw.org>
9058 \family default
9915 \family default
9059 : for providing the Itpl module for convenient and powerful string interpolation
9916 : for providing the Itpl module for convenient and powerful string interpolation
9060 with a much nicer syntax than formatting through the '%' operator.
9917 with a much nicer syntax than formatting through the '%' operator.
9061 \layout Standard
9918 \end_layout
9062
9919
9920 \begin_layout Standard
9063 Arnd Baecker
9921 Arnd Baecker
9064 \family typewriter
9922 \family typewriter
9065 <baecker-AT-physik.tu-dresden.de>
9923 <baecker-AT-physik.tu-dresden.de>
@@ -9068,13 +9926,15 b' Arnd Baecker'
9068 testing and documentation checking.
9926 testing and documentation checking.
9069 Many of IPython's newer features are a result of discussions with him (bugs
9927 Many of IPython's newer features are a result of discussions with him (bugs
9070 are still my fault, not his).
9928 are still my fault, not his).
9071 \layout Standard
9929 \end_layout
9072
9930
9073 Obviously Guido van\SpecialChar ~
9931 \begin_layout Standard
9932 Obviously Guido van\InsetSpace ~
9074 Rossum and the whole Python development team, that goes
9933 Rossum and the whole Python development team, that goes
9075 without saying.
9934 without saying.
9076 \layout Standard
9935 \end_layout
9077
9936
9937 \begin_layout Standard
9078 IPython's website is generously hosted at
9938 IPython's website is generously hosted at
9079 \begin_inset LatexCommand \htmlurl{http://ipython.scipy.org}
9939 \begin_inset LatexCommand \htmlurl{http://ipython.scipy.org}
9080
9940
@@ -9087,9 +9947,9 b" IPython's website is generously hosted at"
9087
9947
9088 ).
9948 ).
9089 I am very grateful to them and all of the SciPy team for their contribution.
9949 I am very grateful to them and all of the SciPy team for their contribution.
9090 \layout Standard
9950 \end_layout
9091
9092
9951
9952 \begin_layout Standard
9093 \begin_inset LatexCommand \label{figgins}
9953 \begin_inset LatexCommand \label{figgins}
9094
9954
9095 \end_inset
9955 \end_inset
@@ -9107,16 +9967,18 b' Fernando would also like to thank Stephen Figgins'
9107 \end_inset
9967 \end_inset
9108
9968
9109 .
9969 .
9110 \layout Standard
9970 \end_layout
9111
9971
9972 \begin_layout Standard
9112 And last but not least, all the kind IPython users who have emailed new
9973 And last but not least, all the kind IPython users who have emailed new
9113 code, bug reports, fixes, comments and ideas.
9974 code, bug reports, fixes, comments and ideas.
9114 A brief list follows, please let me know if I have ommitted your name by
9975 A brief list follows, please let me know if I have ommitted your name by
9115 accident:
9976 accident:
9116 \layout List
9977 \end_layout
9117 \labelwidthstring 00.00.0000
9118
9978
9119 Jack\SpecialChar ~
9979 \begin_layout List
9980 \labelwidthstring 00.00.0000
9981 Jack\InsetSpace ~
9120 Moffit
9982 Moffit
9121 \family typewriter
9983 \family typewriter
9122 <jack-AT-xiph.org>
9984 <jack-AT-xiph.org>
@@ -9127,11 +9989,13 b' Moffit'
9127 I've always been a fan of Ogg & friends, now I have one more reason to
9989 I've always been a fan of Ogg & friends, now I have one more reason to
9128 like these folks.
9990 like these folks.
9129 \newline
9991 \newline
9130 Jack is also contributing with Debian packaging and many other things.
9992 Jack is also contributing with Debian packaging and many
9131 \layout List
9993 other things.
9132 \labelwidthstring 00.00.0000
9994 \end_layout
9133
9995
9134 Alexander\SpecialChar ~
9996 \begin_layout List
9997 \labelwidthstring 00.00.0000
9998 Alexander\InsetSpace ~
9135 Schmolck
9999 Schmolck
9136 \family typewriter
10000 \family typewriter
9137 <a.schmolck-AT-gmx.net>
10001 <a.schmolck-AT-gmx.net>
@@ -9139,19 +10003,21 b' Schmolck'
9139 Emacs work, bug reports, bug fixes, ideas, lots more.
10003 Emacs work, bug reports, bug fixes, ideas, lots more.
9140 The ipython.el mode for (X)Emacs is Alex's code, providing full support
10004 The ipython.el mode for (X)Emacs is Alex's code, providing full support
9141 for IPython under (X)Emacs.
10005 for IPython under (X)Emacs.
9142 \layout List
10006 \end_layout
9143 \labelwidthstring 00.00.0000
9144
10007
9145 Andrea\SpecialChar ~
10008 \begin_layout List
10009 \labelwidthstring 00.00.0000
10010 Andrea\InsetSpace ~
9146 Riciputi
10011 Riciputi
9147 \family typewriter
10012 \family typewriter
9148 <andrea.riciputi-AT-libero.it>
10013 <andrea.riciputi-AT-libero.it>
9149 \family default
10014 \family default
9150 Mac OSX information, Fink package management.
10015 Mac OSX information, Fink package management.
9151 \layout List
10016 \end_layout
9152 \labelwidthstring 00.00.0000
9153
10017
9154 Gary\SpecialChar ~
10018 \begin_layout List
10019 \labelwidthstring 00.00.0000
10020 Gary\InsetSpace ~
9155 Bishop
10021 Bishop
9156 \family typewriter
10022 \family typewriter
9157 <gb-AT-cs.unc.edu>
10023 <gb-AT-cs.unc.edu>
@@ -9159,305 +10025,339 b' Bishop'
9159 Bug reports, and patches to work around the exception handling idiosyncracies
10025 Bug reports, and patches to work around the exception handling idiosyncracies
9160 of WxPython.
10026 of WxPython.
9161 Readline and color support for Windows.
10027 Readline and color support for Windows.
9162 \layout List
10028 \end_layout
9163 \labelwidthstring 00.00.0000
9164
10029
9165 Jeffrey\SpecialChar ~
10030 \begin_layout List
10031 \labelwidthstring 00.00.0000
10032 Jeffrey\InsetSpace ~
9166 Collins
10033 Collins
9167 \family typewriter
10034 \family typewriter
9168 <Jeff.Collins-AT-vexcel.com>
10035 <Jeff.Collins-AT-vexcel.com>
9169 \family default
10036 \family default
9170 Bug reports.
10037 Bug reports.
9171 Much improved readline support, including fixes for Python 2.3.
10038 Much improved readline support, including fixes for Python 2.3.
9172 \layout List
10039 \end_layout
9173 \labelwidthstring 00.00.0000
9174
10040
9175 Dryice\SpecialChar ~
10041 \begin_layout List
10042 \labelwidthstring 00.00.0000
10043 Dryice\InsetSpace ~
9176 Liu
10044 Liu
9177 \family typewriter
10045 \family typewriter
9178 <dryice-AT-liu.com.cn>
10046 <dryice-AT-liu.com.cn>
9179 \family default
10047 \family default
9180 FreeBSD port.
10048 FreeBSD port.
9181 \layout List
10049 \end_layout
9182 \labelwidthstring 00.00.0000
9183
10050
9184 Mike\SpecialChar ~
10051 \begin_layout List
10052 \labelwidthstring 00.00.0000
10053 Mike\InsetSpace ~
9185 Heeter
10054 Heeter
9186 \family typewriter
10055 \family typewriter
9187 <korora-AT-SDF.LONESTAR.ORG>
10056 <korora-AT-SDF.LONESTAR.ORG>
9188 \layout List
10057 \end_layout
9189 \labelwidthstring 00.00.0000
9190
10058
9191 Christopher\SpecialChar ~
10059 \begin_layout List
10060 \labelwidthstring 00.00.0000
10061 Christopher\InsetSpace ~
9192 Hart
10062 Hart
9193 \family typewriter
10063 \family typewriter
9194 <hart-AT-caltech.edu>
10064 <hart-AT-caltech.edu>
9195 \family default
10065 \family default
9196 PDB integration.
10066 PDB integration.
9197 \layout List
10067 \end_layout
9198 \labelwidthstring 00.00.0000
9199
10068
9200 Milan\SpecialChar ~
10069 \begin_layout List
10070 \labelwidthstring 00.00.0000
10071 Milan\InsetSpace ~
9201 Zamazal
10072 Zamazal
9202 \family typewriter
10073 \family typewriter
9203 <pdm-AT-zamazal.org>
10074 <pdm-AT-zamazal.org>
9204 \family default
10075 \family default
9205 Emacs info.
10076 Emacs info.
9206 \layout List
10077 \end_layout
9207 \labelwidthstring 00.00.0000
9208
10078
9209 Philip\SpecialChar ~
10079 \begin_layout List
10080 \labelwidthstring 00.00.0000
10081 Philip\InsetSpace ~
9210 Hisley
10082 Hisley
9211 \family typewriter
10083 \family typewriter
9212 <compsys-AT-starpower.net>
10084 <compsys-AT-starpower.net>
9213 \layout List
10085 \end_layout
9214 \labelwidthstring 00.00.0000
9215
10086
9216 Holger\SpecialChar ~
10087 \begin_layout List
10088 \labelwidthstring 00.00.0000
10089 Holger\InsetSpace ~
9217 Krekel
10090 Krekel
9218 \family typewriter
10091 \family typewriter
9219 <pyth-AT-devel.trillke.net>
10092 <pyth-AT-devel.trillke.net>
9220 \family default
10093 \family default
9221 Tab completion, lots more.
10094 Tab completion, lots more.
9222 \layout List
10095 \end_layout
9223 \labelwidthstring 00.00.0000
9224
10096
9225 Robin\SpecialChar ~
10097 \begin_layout List
10098 \labelwidthstring 00.00.0000
10099 Robin\InsetSpace ~
9226 Siebler
10100 Siebler
9227 \family typewriter
10101 \family typewriter
9228 <robinsiebler-AT-starband.net>
10102 <robinsiebler-AT-starband.net>
9229 \layout List
10103 \end_layout
9230 \labelwidthstring 00.00.0000
9231
10104
9232 Ralf\SpecialChar ~
10105 \begin_layout List
10106 \labelwidthstring 00.00.0000
10107 Ralf\InsetSpace ~
9233 Ahlbrink
10108 Ahlbrink
9234 \family typewriter
10109 \family typewriter
9235 <ralf_ahlbrink-AT-web.de>
10110 <ralf_ahlbrink-AT-web.de>
9236 \layout List
10111 \end_layout
9237 \labelwidthstring 00.00.0000
9238
10112
9239 Thorsten\SpecialChar ~
10113 \begin_layout List
10114 \labelwidthstring 00.00.0000
10115 Thorsten\InsetSpace ~
9240 Kampe
10116 Kampe
9241 \family typewriter
10117 \family typewriter
9242 <thorsten-AT-thorstenkampe.de>
10118 <thorsten-AT-thorstenkampe.de>
9243 \layout List
10119 \end_layout
9244 \labelwidthstring 00.00.0000
9245
10120
9246 Fredrik\SpecialChar ~
10121 \begin_layout List
10122 \labelwidthstring 00.00.0000
10123 Fredrik\InsetSpace ~
9247 Kant
10124 Kant
9248 \family typewriter
10125 \family typewriter
9249 <fredrik.kant-AT-front.com>
10126 <fredrik.kant-AT-front.com>
9250 \family default
10127 \family default
9251 Windows setup.
10128 Windows setup.
9252 \layout List
10129 \end_layout
9253 \labelwidthstring 00.00.0000
9254
10130
9255 Syver\SpecialChar ~
10131 \begin_layout List
10132 \labelwidthstring 00.00.0000
10133 Syver\InsetSpace ~
9256 Enstad
10134 Enstad
9257 \family typewriter
10135 \family typewriter
9258 <syver-en-AT-online.no>
10136 <syver-en-AT-online.no>
9259 \family default
10137 \family default
9260 Windows setup.
10138 Windows setup.
9261 \layout List
10139 \end_layout
9262 \labelwidthstring 00.00.0000
9263
10140
10141 \begin_layout List
10142 \labelwidthstring 00.00.0000
9264 Richard
10143 Richard
9265 \family typewriter
10144 \family typewriter
9266 <rxe-AT-renre-europe.com>
10145 <rxe-AT-renre-europe.com>
9267 \family default
10146 \family default
9268 Global embedding.
10147 Global embedding.
9269 \layout List
10148 \end_layout
9270 \labelwidthstring 00.00.0000
9271
10149
9272 Hayden\SpecialChar ~
10150 \begin_layout List
10151 \labelwidthstring 00.00.0000
10152 Hayden\InsetSpace ~
9273 Callow
10153 Callow
9274 \family typewriter
10154 \family typewriter
9275 <h.callow-AT-elec.canterbury.ac.nz>
10155 <h.callow-AT-elec.canterbury.ac.nz>
9276 \family default
10156 \family default
9277 Gnuplot.py 1.6 compatibility.
10157 Gnuplot.py 1.6 compatibility.
9278 \layout List
10158 \end_layout
9279 \labelwidthstring 00.00.0000
9280
10159
9281 Leonardo\SpecialChar ~
10160 \begin_layout List
10161 \labelwidthstring 00.00.0000
10162 Leonardo\InsetSpace ~
9282 Santagada
10163 Santagada
9283 \family typewriter
10164 \family typewriter
9284 <retype-AT-terra.com.br>
10165 <retype-AT-terra.com.br>
9285 \family default
10166 \family default
9286 Fixes for Windows installation.
10167 Fixes for Windows installation.
9287 \layout List
10168 \end_layout
9288 \labelwidthstring 00.00.0000
9289
10169
9290 Christopher\SpecialChar ~
10170 \begin_layout List
10171 \labelwidthstring 00.00.0000
10172 Christopher\InsetSpace ~
9291 Armstrong
10173 Armstrong
9292 \family typewriter
10174 \family typewriter
9293 <radix-AT-twistedmatrix.com>
10175 <radix-AT-twistedmatrix.com>
9294 \family default
10176 \family default
9295 Bugfixes.
10177 Bugfixes.
9296 \layout List
10178 \end_layout
9297 \labelwidthstring 00.00.0000
9298
10179
9299 Francois\SpecialChar ~
10180 \begin_layout List
10181 \labelwidthstring 00.00.0000
10182 Francois\InsetSpace ~
9300 Pinard
10183 Pinard
9301 \family typewriter
10184 \family typewriter
9302 <pinard-AT-iro.umontreal.ca>
10185 <pinard-AT-iro.umontreal.ca>
9303 \family default
10186 \family default
9304 Code and documentation fixes.
10187 Code and documentation fixes.
9305 \layout List
10188 \end_layout
9306 \labelwidthstring 00.00.0000
9307
10189
9308 Cory\SpecialChar ~
10190 \begin_layout List
10191 \labelwidthstring 00.00.0000
10192 Cory\InsetSpace ~
9309 Dodt
10193 Dodt
9310 \family typewriter
10194 \family typewriter
9311 <cdodt-AT-fcoe.k12.ca.us>
10195 <cdodt-AT-fcoe.k12.ca.us>
9312 \family default
10196 \family default
9313 Bug reports and Windows ideas.
10197 Bug reports and Windows ideas.
9314 Patches for Windows installer.
10198 Patches for Windows installer.
9315 \layout List
10199 \end_layout
9316 \labelwidthstring 00.00.0000
9317
10200
9318 Olivier\SpecialChar ~
10201 \begin_layout List
10202 \labelwidthstring 00.00.0000
10203 Olivier\InsetSpace ~
9319 Aubert
10204 Aubert
9320 \family typewriter
10205 \family typewriter
9321 <oaubert-AT-bat710.univ-lyon1.fr>
10206 <oaubert-AT-bat710.univ-lyon1.fr>
9322 \family default
10207 \family default
9323 New magics.
10208 New magics.
9324 \layout List
10209 \end_layout
9325 \labelwidthstring 00.00.0000
9326
10210
9327 King\SpecialChar ~
10211 \begin_layout List
9328 C.\SpecialChar ~
10212 \labelwidthstring 00.00.0000
10213 King\InsetSpace ~
10214 C.\InsetSpace ~
9329 Shu
10215 Shu
9330 \family typewriter
10216 \family typewriter
9331 <kingshu-AT-myrealbox.com>
10217 <kingshu-AT-myrealbox.com>
9332 \family default
10218 \family default
9333 Autoindent patch.
10219 Autoindent patch.
9334 \layout List
10220 \end_layout
9335 \labelwidthstring 00.00.0000
9336
10221
9337 Chris\SpecialChar ~
10222 \begin_layout List
10223 \labelwidthstring 00.00.0000
10224 Chris\InsetSpace ~
9338 Drexler
10225 Drexler
9339 \family typewriter
10226 \family typewriter
9340 <chris-AT-ac-drexler.de>
10227 <chris-AT-ac-drexler.de>
9341 \family default
10228 \family default
9342 Readline packages for Win32/CygWin.
10229 Readline packages for Win32/CygWin.
9343 \layout List
10230 \end_layout
9344 \labelwidthstring 00.00.0000
9345
10231
9346 Gustavo\SpecialChar ~
10232 \begin_layout List
9347 Cordova\SpecialChar ~
10233 \labelwidthstring 00.00.0000
10234 Gustavo\InsetSpace ~
10235 Cordova\InsetSpace ~
9348 Avila
10236 Avila
9349 \family typewriter
10237 \family typewriter
9350 <gcordova-AT-sismex.com>
10238 <gcordova-AT-sismex.com>
9351 \family default
10239 \family default
9352 EvalDict code for nice, lightweight string interpolation.
10240 EvalDict code for nice, lightweight string interpolation.
9353 \layout List
10241 \end_layout
9354 \labelwidthstring 00.00.0000
9355
10242
9356 Kasper\SpecialChar ~
10243 \begin_layout List
10244 \labelwidthstring 00.00.0000
10245 Kasper\InsetSpace ~
9357 Souren
10246 Souren
9358 \family typewriter
10247 \family typewriter
9359 <Kasper.Souren-AT-ircam.fr>
10248 <Kasper.Souren-AT-ircam.fr>
9360 \family default
10249 \family default
9361 Bug reports, ideas.
10250 Bug reports, ideas.
9362 \layout List
10251 \end_layout
9363 \labelwidthstring 00.00.0000
9364
10252
9365 Gever\SpecialChar ~
10253 \begin_layout List
10254 \labelwidthstring 00.00.0000
10255 Gever\InsetSpace ~
9366 Tulley
10256 Tulley
9367 \family typewriter
10257 \family typewriter
9368 <gever-AT-helium.com>
10258 <gever-AT-helium.com>
9369 \family default
10259 \family default
9370 Code contributions.
10260 Code contributions.
9371 \layout List
10261 \end_layout
9372 \labelwidthstring 00.00.0000
9373
10262
9374 Ralf\SpecialChar ~
10263 \begin_layout List
10264 \labelwidthstring 00.00.0000
10265 Ralf\InsetSpace ~
9375 Schmitt
10266 Schmitt
9376 \family typewriter
10267 \family typewriter
9377 <ralf-AT-brainbot.com>
10268 <ralf-AT-brainbot.com>
9378 \family default
10269 \family default
9379 Bug reports & fixes.
10270 Bug reports & fixes.
9380 \layout List
10271 \end_layout
9381 \labelwidthstring 00.00.0000
9382
10272
9383 Oliver\SpecialChar ~
10273 \begin_layout List
10274 \labelwidthstring 00.00.0000
10275 Oliver\InsetSpace ~
9384 Sander
10276 Sander
9385 \family typewriter
10277 \family typewriter
9386 <osander-AT-gmx.de>
10278 <osander-AT-gmx.de>
9387 \family default
10279 \family default
9388 Bug reports.
10280 Bug reports.
9389 \layout List
10281 \end_layout
9390 \labelwidthstring 00.00.0000
9391
10282
9392 Rod\SpecialChar ~
10283 \begin_layout List
10284 \labelwidthstring 00.00.0000
10285 Rod\InsetSpace ~
9393 Holland
10286 Holland
9394 \family typewriter
10287 \family typewriter
9395 <rhh-AT-structurelabs.com>
10288 <rhh-AT-structurelabs.com>
9396 \family default
10289 \family default
9397 Bug reports and fixes to logging module.
10290 Bug reports and fixes to logging module.
9398 \layout List
10291 \end_layout
9399 \labelwidthstring 00.00.0000
9400
10292
9401 Daniel\SpecialChar ~
10293 \begin_layout List
9402 'Dang'\SpecialChar ~
10294 \labelwidthstring 00.00.0000
10295 Daniel\InsetSpace ~
10296 'Dang'\InsetSpace ~
9403 Griffith
10297 Griffith
9404 \family typewriter
10298 \family typewriter
9405 <pythondev-dang-AT-lazytwinacres.net>
10299 <pythondev-dang-AT-lazytwinacres.net>
9406 \family default
10300 \family default
9407 Fixes, enhancement suggestions for system shell use.
10301 Fixes, enhancement suggestions for system shell use.
9408 \layout List
10302 \end_layout
9409 \labelwidthstring 00.00.0000
9410
10303
9411 Viktor\SpecialChar ~
10304 \begin_layout List
10305 \labelwidthstring 00.00.0000
10306 Viktor\InsetSpace ~
9412 Ransmayr
10307 Ransmayr
9413 \family typewriter
10308 \family typewriter
9414 <viktor.ransmayr-AT-t-online.de>
10309 <viktor.ransmayr-AT-t-online.de>
9415 \family default
10310 \family default
9416 Tests and reports on Windows installation issues.
10311 Tests and reports on Windows installation issues.
9417 Contributed a true Windows binary installer.
10312 Contributed a true Windows binary installer.
9418 \layout List
10313 \end_layout
9419 \labelwidthstring 00.00.0000
9420
10314
9421 Mike\SpecialChar ~
10315 \begin_layout List
10316 \labelwidthstring 00.00.0000
10317 Mike\InsetSpace ~
9422 Salib
10318 Salib
9423 \family typewriter
10319 \family typewriter
9424 <msalib-AT-mit.edu>
10320 <msalib-AT-mit.edu>
9425 \family default
10321 \family default
9426 Help fixing a subtle bug related to traceback printing.
10322 Help fixing a subtle bug related to traceback printing.
9427 \layout List
10323 \end_layout
9428 \labelwidthstring 00.00.0000
9429
10324
9430 W.J.\SpecialChar ~
10325 \begin_layout List
9431 van\SpecialChar ~
10326 \labelwidthstring 00.00.0000
9432 der\SpecialChar ~
10327 W.J.\InsetSpace ~
10328 van\InsetSpace ~
10329 der\InsetSpace ~
9433 Laan
10330 Laan
9434 \family typewriter
10331 \family typewriter
9435 <gnufnork-AT-hetdigitalegat.nl>
10332 <gnufnork-AT-hetdigitalegat.nl>
9436 \family default
10333 \family default
9437 Bash-like prompt specials.
10334 Bash-like prompt specials.
9438 \layout List
10335 \end_layout
9439 \labelwidthstring 00.00.0000
9440
10336
9441 Antoon\SpecialChar ~
10337 \begin_layout List
10338 \labelwidthstring 00.00.0000
10339 Antoon\InsetSpace ~
9442 Pardon
10340 Pardon
9443 \family typewriter
10341 \family typewriter
9444 <Antoon.Pardon-AT-rece.vub.ac.be>
10342 <Antoon.Pardon-AT-rece.vub.ac.be>
9445 \family default
10343 \family default
9446 Critical fix for the multithreaded IPython.
10344 Critical fix for the multithreaded IPython.
9447 \layout List
10345 \end_layout
9448 \labelwidthstring 00.00.0000
9449
10346
9450 John\SpecialChar ~
10347 \begin_layout List
10348 \labelwidthstring 00.00.0000
10349 John\InsetSpace ~
9451 Hunter
10350 Hunter
9452 \family typewriter
10351 \family typewriter
9453 <jdhunter-AT-nitace.bsd.uchicago.edu>
10352 <jdhunter-AT-nitace.bsd.uchicago.edu>
9454 \family default
10353 \family default
9455 Matplotlib author, helped with all the development of support for matplotlib
10354 Matplotlib author, helped with all the development of support for matplotlib
9456 in IPyhton, including making necessary changes to matplotlib itself.
10355 in IPyhton, including making necessary changes to matplotlib itself.
9457 \layout List
10356 \end_layout
9458 \labelwidthstring 00.00.0000
9459
10357
9460 Matthew\SpecialChar ~
10358 \begin_layout List
10359 \labelwidthstring 00.00.0000
10360 Matthew\InsetSpace ~
9461 Arnison
10361 Arnison
9462 \family typewriter
10362 \family typewriter
9463 <maffew-AT-cat.org.au>
10363 <maffew-AT-cat.org.au>
@@ -9467,57 +10367,63 b' Arnison'
9467 %run -d
10367 %run -d
9468 \family default
10368 \family default
9469 ' idea.
10369 ' idea.
9470 \layout List
10370 \end_layout
9471 \labelwidthstring 00.00.0000
9472
10371
9473 Prabhu\SpecialChar ~
10372 \begin_layout List
10373 \labelwidthstring 00.00.0000
10374 Prabhu\InsetSpace ~
9474 Ramachandran
10375 Ramachandran
9475 \family typewriter
10376 \family typewriter
9476 <prabhu_r-AT-users.sourceforge.net>
10377 <prabhu_r-AT-users.sourceforge.net>
9477 \family default
10378 \family default
9478 Help with (X)Emacs support, threading patches, ideas...
10379 Help with (X)Emacs support, threading patches, ideas...
9479 \layout List
10380 \end_layout
9480 \labelwidthstring 00.00.0000
9481
10381
9482 Norbert\SpecialChar ~
10382 \begin_layout List
10383 \labelwidthstring 00.00.0000
10384 Norbert\InsetSpace ~
9483 Tretkowski
10385 Tretkowski
9484 \family typewriter
10386 \family typewriter
9485 <tretkowski-AT-inittab.de>
10387 <tretkowski-AT-inittab.de>
9486 \family default
10388 \family default
9487 help with Debian packaging and distribution.
10389 help with Debian packaging and distribution.
9488 \layout List
10390 \end_layout
9489 \labelwidthstring 00.00.0000
9490
10391
9491 George\SpecialChar ~
10392 \begin_layout List
10393 \labelwidthstring 00.00.0000
10394 George\InsetSpace ~
9492 Sakkis <
10395 Sakkis <
9493 \family typewriter
10396 \family typewriter
9494 gsakkis-AT-eden.rutgers.edu>
10397 gsakkis-AT-eden.rutgers.edu>
9495 \family default
10398 \family default
9496 New matcher for tab-completing named arguments of user-defined functions.
10399 New matcher for tab-completing named arguments of user-defined functions.
9497 \layout List
10400 \end_layout
9498 \labelwidthstring 00.00.0000
9499
10401
9500 J�rgen\SpecialChar ~
10402 \begin_layout List
10403 \labelwidthstring 00.00.0000
10404 J�rgen\InsetSpace ~
9501 Stenarson
10405 Stenarson
9502 \family typewriter
10406 \family typewriter
9503 <jorgen.stenarson-AT-bostream.nu>
10407 <jorgen.stenarson-AT-bostream.nu>
9504 \family default
10408 \family default
9505 Wildcard support implementation for searching namespaces.
10409 Wildcard support implementation for searching namespaces.
9506 \layout List
10410 \end_layout
9507 \labelwidthstring 00.00.0000
9508
10411
9509 Vivian\SpecialChar ~
10412 \begin_layout List
9510 De\SpecialChar ~
10413 \labelwidthstring 00.00.0000
10414 Vivian\InsetSpace ~
10415 De\InsetSpace ~
9511 Smedt
10416 Smedt
9512 \family typewriter
10417 \family typewriter
9513 <vivian-AT-vdesmedt.com>
10418 <vivian-AT-vdesmedt.com>
9514 \family default
10419 \family default
9515 Debugger enhancements, so that when pdb is activated from within IPython,
10420 Debugger enhancements, so that when pdb is activated from within IPython,
9516 coloring, tab completion and other features continue to work seamlessly.
10421 coloring, tab completion and other features continue to work seamlessly.
9517 \layout List
10422 \end_layout
9518 \labelwidthstring 00.00.0000
9519
10423
9520 Scott\SpecialChar ~
10424 \begin_layout List
10425 \labelwidthstring 00.00.0000
10426 Scott\InsetSpace ~
9521 Tsai
10427 Tsai
9522 \family typewriter
10428 \family typewriter
9523 <scottt958-AT-yahoo.com.tw>
10429 <scottt958-AT-yahoo.com.tw>
@@ -9528,22 +10434,27 b' Tsai'
9528 \end_inset
10434 \end_inset
9529
10435
9530 ).
10436 ).
9531 \layout List
10437 \end_layout
9532 \labelwidthstring 00.00.0000
9533
10438
9534 Alexander\SpecialChar ~
10439 \begin_layout List
10440 \labelwidthstring 00.00.0000
10441 Alexander\InsetSpace ~
9535 Belchenko
10442 Belchenko
9536 \family typewriter
10443 \family typewriter
9537 <bialix-AT-ukr.net>
10444 <bialix-AT-ukr.net>
9538 \family default
10445 \family default
9539 Improvements for win32 paging system.
10446 Improvements for win32 paging system.
9540 \layout List
10447 \end_layout
9541 \labelwidthstring 00.00.0000
9542
10448
9543 Will\SpecialChar ~
10449 \begin_layout List
10450 \labelwidthstring 00.00.0000
10451 Will\InsetSpace ~
9544 Maier
10452 Maier
9545 \family typewriter
10453 \family typewriter
9546 <willmaier-AT-ml1.net>
10454 <willmaier-AT-ml1.net>
9547 \family default
10455 \family default
9548 Official OpenBSD port.
10456 Official OpenBSD port.
9549 \the_end
10457 \end_layout
10458
10459 \end_body
10460 \end_document
@@ -88,6 +88,11 b' def run(wait=0):'
88 # make shortcuts for IPython, html and pdf docs.
88 # make shortcuts for IPython, html and pdf docs.
89 print 'Making entries for IPython in Start Menu...',
89 print 'Making entries for IPython in Start Menu...',
90
90
91 # Create .bat file in \\Scripts
92 fic = open(sys.prefix + '\\Scripts\\ipython.bat','w')
93 fic.write('"' + sys.prefix + '\\python.exe' + '" -i ' + '"' + sys.prefix + '\\Scripts\ipython" %*')
94 fic.close()
95
91 # Create shortcuts in Programs\IPython:
96 # Create shortcuts in Programs\IPython:
92 if not os.path.isdir(ip_prog_dir):
97 if not os.path.isdir(ip_prog_dir):
93 os.mkdir(ip_prog_dir)
98 os.mkdir(ip_prog_dir)
General Comments 0
You need to be logged in to leave comments. Login now