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