##// END OF EJS Templates
- applied Nicolas Pernetty's patch to improve support for (X)Emacs under Win32....
fperez -
Show More

The requested changes are too big and content was truncated. Show full diff

@@ -1,164 +1,170 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>
8 8 #
9 9 # Distributed under the terms of the BSD License. The full license is in
10 10 # the file COPYING, distributed as part of this software.
11 11 #*****************************************************************************
12 12
13 13 from IPython import Release
14 14 __author__ = '%s <%s>' % Release.authors['Fernando']
15 15 __license__ = Release.license
16 16
17 17 __all__ = ['TermColors','InputTermColors','ColorScheme','ColorSchemeTable']
18 18
19 19 import os
20 20
21 21 from IPython.ipstruct import Struct
22 22
23 23 def make_color_table(in_class):
24 24 """Build a set of color attributes in a class.
25 25
26 26 Helper function for building the *TermColors classes."""
27 27
28 28 color_templates = (
29 29 ("Black" , "0;30"),
30 30 ("Red" , "0;31"),
31 31 ("Green" , "0;32"),
32 32 ("Brown" , "0;33"),
33 33 ("Blue" , "0;34"),
34 34 ("Purple" , "0;35"),
35 35 ("Cyan" , "0;36"),
36 36 ("LightGray" , "0;37"),
37 37 ("DarkGray" , "1;30"),
38 38 ("LightRed" , "1;31"),
39 39 ("LightGreen" , "1;32"),
40 40 ("Yellow" , "1;33"),
41 41 ("LightBlue" , "1;34"),
42 42 ("LightPurple" , "1;35"),
43 43 ("LightCyan" , "1;36"),
44 44 ("White" , "1;37"), )
45 45
46 46 for name,value in color_templates:
47 47 setattr(in_class,name,in_class._base % value)
48 48
49 49 class TermColors:
50 50 """Color escape sequences.
51 51
52 52 This class defines the escape sequences for all the standard (ANSI?)
53 53 colors in terminals. Also defines a NoColor escape which is just the null
54 54 string, suitable for defining 'dummy' color schemes in terminals which get
55 55 confused by color escapes.
56 56
57 57 This class should be used as a mixin for building color schemes."""
58 58
59 59 NoColor = '' # for color schemes in color-less terminals.
60 60 Normal = '\033[0m' # Reset normal coloring
61 61 _base = '\033[%sm' # Template for all other colors
62 62
63 63 # Build the actual color table as a set of class attributes:
64 64 make_color_table(TermColors)
65 65
66 66 class InputTermColors:
67 67 """Color escape sequences for input prompts.
68 68
69 69 This class is similar to TermColors, but the escapes are wrapped in \001
70 70 and \002 so that readline can properly know the length of each line and
71 71 can wrap lines accordingly. Use this class for any colored text which
72 72 needs to be used in input prompts, such as in calls to raw_input().
73 73
74 74 This class defines the escape sequences for all the standard (ANSI?)
75 75 colors in terminals. Also defines a NoColor escape which is just the null
76 76 string, suitable for defining 'dummy' color schemes in terminals which get
77 77 confused by color escapes.
78 78
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
85 91 # Build the actual color table as a set of class attributes:
86 92 make_color_table(InputTermColors)
87 93
88 94 class ColorScheme:
89 95 """Generic color scheme class. Just a name and a Struct."""
90 96 def __init__(self,__scheme_name_,colordict=None,**colormap):
91 97 self.name = __scheme_name_
92 98 if colordict is None:
93 99 self.colors = Struct(**colormap)
94 100 else:
95 101 self.colors = Struct(colordict)
96 102
97 103 def copy(self,name=None):
98 104 """Return a full copy of the object, optionally renaming it."""
99 105 if name is None:
100 106 name = self.name
101 107 return ColorScheme(name,self.colors.__dict__)
102 108
103 109 class ColorSchemeTable(dict):
104 110 """General class to handle tables of color schemes.
105 111
106 112 It's basically a dict of color schemes with a couple of shorthand
107 113 attributes and some convenient methods.
108 114
109 115 active_scheme_name -> obvious
110 116 active_colors -> actual color table of the active scheme"""
111 117
112 118 def __init__(self,scheme_list=None,default_scheme=''):
113 119 """Create a table of color schemes.
114 120
115 121 The table can be created empty and manually filled or it can be
116 122 created with a list of valid color schemes AND the specification for
117 123 the default active scheme.
118 124 """
119 125
120 126 # create object attributes to be set later
121 127 self.active_scheme_name = ''
122 128 self.active_colors = None
123 129
124 130 if scheme_list:
125 131 if default_scheme == '':
126 132 raise ValueError,'you must specify the default color scheme'
127 133 for scheme in scheme_list:
128 134 self.add_scheme(scheme)
129 135 self.set_active_scheme(default_scheme)
130 136
131 137 def copy(self):
132 138 """Return full copy of object"""
133 139 return ColorSchemeTable(self.values(),self.active_scheme_name)
134 140
135 141 def add_scheme(self,new_scheme):
136 142 """Add a new color scheme to the table."""
137 143 if not isinstance(new_scheme,ColorScheme):
138 144 raise ValueError,'ColorSchemeTable only accepts ColorScheme instances'
139 145 self[new_scheme.name] = new_scheme
140 146
141 147 def set_active_scheme(self,scheme,case_sensitive=0):
142 148 """Set the currently active scheme.
143 149
144 150 Names are by default compared in a case-insensitive way, but this can
145 151 be changed by setting the parameter case_sensitive to true."""
146 152
147 153 scheme_names = self.keys()
148 154 if case_sensitive:
149 155 valid_schemes = scheme_names
150 156 scheme_test = scheme
151 157 else:
152 158 valid_schemes = [s.lower() for s in scheme_names]
153 159 scheme_test = scheme.lower()
154 160 try:
155 161 scheme_idx = valid_schemes.index(scheme_test)
156 162 except ValueError:
157 163 raise ValueError,'Unrecognized color scheme: ' + scheme + \
158 164 '\nValid schemes: '+str(scheme_names).replace("'', ",'')
159 165 else:
160 166 active = scheme_names[scheme_idx]
161 167 self.active_scheme_name = active
162 168 self.active_colors = self[active].colors
163 169 # Now allow using '' as an index for the current active scheme
164 170 self[''] = self[active]
@@ -1,1751 +1,1752 b''
1 1 # -*- coding: utf-8 -*-
2 2 """
3 3 General purpose utilities.
4 4
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>
12 12 #
13 13 # Distributed under the terms of the BSD License. The full license is in
14 14 # the file COPYING, distributed as part of this software.
15 15 #*****************************************************************************
16 16
17 17 from IPython import Release
18 18 __author__ = '%s <%s>' % Release.authors['Fernando']
19 19 __license__ = Release.license
20 20
21 21 #****************************************************************************
22 22 # required modules from the Python standard library
23 23 import __main__
24 24 import commands
25 25 import os
26 26 import re
27 27 import shlex
28 28 import shutil
29 29 import sys
30 30 import tempfile
31 31 import time
32 32 import types
33 33 import warnings
34 34
35 35 # Other IPython utilities
36 36 from IPython.Itpl import Itpl,itpl,printpl
37 37 from IPython import DPyGetOpt
38 38 from path import path
39 39 if os.name == "nt":
40 40 from IPython.winconsole import get_console_size
41 41
42 42 #****************************************************************************
43 43 # Exceptions
44 44 class Error(Exception):
45 45 """Base class for exceptions in this module."""
46 46 pass
47 47
48 48 #----------------------------------------------------------------------------
49 49 class IOStream:
50 50 def __init__(self,stream,fallback):
51 51 if not hasattr(stream,'write') or not hasattr(stream,'flush'):
52 52 stream = fallback
53 53 self.stream = stream
54 54 self._swrite = stream.write
55 55 self.flush = stream.flush
56 56
57 57 def write(self,data):
58 58 try:
59 59 self._swrite(data)
60 60 except:
61 61 try:
62 62 # print handles some unicode issues which may trip a plain
63 63 # write() call. Attempt to emulate write() by using a
64 64 # trailing comma
65 65 print >> self.stream, data,
66 66 except:
67 67 # if we get here, something is seriously broken.
68 68 print >> sys.stderr, \
69 69 'ERROR - failed to write data to stream:', self.stream
70 70
71 71 class IOTerm:
72 72 """ Term holds the file or file-like objects for handling I/O operations.
73 73
74 74 These are normally just sys.stdin, sys.stdout and sys.stderr but for
75 75 Windows they can can replaced to allow editing the strings before they are
76 76 displayed."""
77 77
78 78 # In the future, having IPython channel all its I/O operations through
79 79 # this class will make it easier to embed it into other environments which
80 80 # are not a normal terminal (such as a GUI-based shell)
81 81 def __init__(self,cin=None,cout=None,cerr=None):
82 82 self.cin = IOStream(cin,sys.stdin)
83 83 self.cout = IOStream(cout,sys.stdout)
84 84 self.cerr = IOStream(cerr,sys.stderr)
85 85
86 86 # Global variable to be used for all I/O
87 87 Term = IOTerm()
88 88
89 89 import IPython.rlineimpl as readline
90 90 # Remake Term to use the readline i/o facilities
91 91 if sys.platform == 'win32' and readline.have_readline:
92 92
93 93 Term = IOTerm(cout=readline._outputfile,cerr=readline._outputfile)
94 94
95 95
96 96 #****************************************************************************
97 97 # Generic warning/error printer, used by everything else
98 98 def warn(msg,level=2,exit_val=1):
99 99 """Standard warning printer. Gives formatting consistency.
100 100
101 101 Output is sent to Term.cerr (sys.stderr by default).
102 102
103 103 Options:
104 104
105 105 -level(2): allows finer control:
106 106 0 -> Do nothing, dummy function.
107 107 1 -> Print message.
108 108 2 -> Print 'WARNING:' + message. (Default level).
109 109 3 -> Print 'ERROR:' + message.
110 110 4 -> Print 'FATAL ERROR:' + message and trigger a sys.exit(exit_val).
111 111
112 112 -exit_val (1): exit value returned by sys.exit() for a level 4
113 113 warning. Ignored for all other levels."""
114 114
115 115 if level>0:
116 116 header = ['','','WARNING: ','ERROR: ','FATAL ERROR: ']
117 117 print >> Term.cerr, '%s%s' % (header[level],msg)
118 118 if level == 4:
119 119 print >> Term.cerr,'Exiting.\n'
120 120 sys.exit(exit_val)
121 121
122 122 def info(msg):
123 123 """Equivalent to warn(msg,level=1)."""
124 124
125 125 warn(msg,level=1)
126 126
127 127 def error(msg):
128 128 """Equivalent to warn(msg,level=3)."""
129 129
130 130 warn(msg,level=3)
131 131
132 132 def fatal(msg,exit_val=1):
133 133 """Equivalent to warn(msg,exit_val=exit_val,level=4)."""
134 134
135 135 warn(msg,exit_val=exit_val,level=4)
136 136
137 137 #---------------------------------------------------------------------------
138 138 # Debugging routines
139 139 #
140 140 def debugx(expr,pre_msg=''):
141 141 """Print the value of an expression from the caller's frame.
142 142
143 143 Takes an expression, evaluates it in the caller's frame and prints both
144 144 the given expression and the resulting value (as well as a debug mark
145 145 indicating the name of the calling function. The input must be of a form
146 146 suitable for eval().
147 147
148 148 An optional message can be passed, which will be prepended to the printed
149 149 expr->value pair."""
150 150
151 151 cf = sys._getframe(1)
152 152 print '[DBG:%s] %s%s -> %r' % (cf.f_code.co_name,pre_msg,expr,
153 153 eval(expr,cf.f_globals,cf.f_locals))
154 154
155 155 # deactivate it by uncommenting the following line, which makes it a no-op
156 156 #def debugx(expr,pre_msg=''): pass
157 157
158 158 #----------------------------------------------------------------------------
159 159 StringTypes = types.StringTypes
160 160
161 161 # Basic timing functionality
162 162
163 163 # If possible (Unix), use the resource module instead of time.clock()
164 164 try:
165 165 import resource
166 166 def clocku():
167 167 """clocku() -> floating point number
168 168
169 169 Return the *USER* CPU time in seconds since the start of the process.
170 170 This is done via a call to resource.getrusage, so it avoids the
171 171 wraparound problems in time.clock()."""
172 172
173 173 return resource.getrusage(resource.RUSAGE_SELF)[0]
174 174
175 175 def clocks():
176 176 """clocks() -> floating point number
177 177
178 178 Return the *SYSTEM* CPU time in seconds since the start of the process.
179 179 This is done via a call to resource.getrusage, so it avoids the
180 180 wraparound problems in time.clock()."""
181 181
182 182 return resource.getrusage(resource.RUSAGE_SELF)[1]
183 183
184 184 def clock():
185 185 """clock() -> floating point number
186 186
187 187 Return the *TOTAL USER+SYSTEM* CPU time in seconds since the start of
188 188 the process. This is done via a call to resource.getrusage, so it
189 189 avoids the wraparound problems in time.clock()."""
190 190
191 191 u,s = resource.getrusage(resource.RUSAGE_SELF)[:2]
192 192 return u+s
193 193
194 194 def clock2():
195 195 """clock2() -> (t_user,t_system)
196 196
197 197 Similar to clock(), but return a tuple of user/system times."""
198 198 return resource.getrusage(resource.RUSAGE_SELF)[:2]
199 199
200 200 except ImportError:
201 201 # There is no distinction of user/system time under windows, so we just use
202 202 # time.clock() for everything...
203 203 clocku = clocks = clock = time.clock
204 204 def clock2():
205 205 """Under windows, system CPU time can't be measured.
206 206
207 207 This just returns clock() and zero."""
208 208 return time.clock(),0.0
209 209
210 210 def timings_out(reps,func,*args,**kw):
211 211 """timings_out(reps,func,*args,**kw) -> (t_total,t_per_call,output)
212 212
213 213 Execute a function reps times, return a tuple with the elapsed total
214 214 CPU time in seconds, the time per call and the function's output.
215 215
216 216 Under Unix, the return value is the sum of user+system time consumed by
217 217 the process, computed via the resource module. This prevents problems
218 218 related to the wraparound effect which the time.clock() function has.
219 219
220 220 Under Windows the return value is in wall clock seconds. See the
221 221 documentation for the time module for more details."""
222 222
223 223 reps = int(reps)
224 224 assert reps >=1, 'reps must be >= 1'
225 225 if reps==1:
226 226 start = clock()
227 227 out = func(*args,**kw)
228 228 tot_time = clock()-start
229 229 else:
230 230 rng = xrange(reps-1) # the last time is executed separately to store output
231 231 start = clock()
232 232 for dummy in rng: func(*args,**kw)
233 233 out = func(*args,**kw) # one last time
234 234 tot_time = clock()-start
235 235 av_time = tot_time / reps
236 236 return tot_time,av_time,out
237 237
238 238 def timings(reps,func,*args,**kw):
239 239 """timings(reps,func,*args,**kw) -> (t_total,t_per_call)
240 240
241 241 Execute a function reps times, return a tuple with the elapsed total CPU
242 242 time in seconds and the time per call. These are just the first two values
243 243 in timings_out()."""
244 244
245 245 return timings_out(reps,func,*args,**kw)[0:2]
246 246
247 247 def timing(func,*args,**kw):
248 248 """timing(func,*args,**kw) -> t_total
249 249
250 250 Execute a function once, return the elapsed total CPU time in
251 251 seconds. This is just the first value in timings_out()."""
252 252
253 253 return timings_out(1,func,*args,**kw)[0]
254 254
255 255 #****************************************************************************
256 256 # file and system
257 257
258 258 def arg_split(s,posix=False):
259 259 """Split a command line's arguments in a shell-like manner.
260 260
261 261 This is a modified version of the standard library's shlex.split()
262 262 function, but with a default of posix=False for splitting, so that quotes
263 263 in inputs are respected."""
264 264
265 265 lex = shlex.shlex(s, posix=posix)
266 266 lex.whitespace_split = True
267 267 return list(lex)
268 268
269 269 def system(cmd,verbose=0,debug=0,header=''):
270 270 """Execute a system command, return its exit status.
271 271
272 272 Options:
273 273
274 274 - verbose (0): print the command to be executed.
275 275
276 276 - debug (0): only print, do not actually execute.
277 277
278 278 - header (''): Header to print on screen prior to the executed command (it
279 279 is only prepended to the command, no newlines are added).
280 280
281 281 Note: a stateful version of this function is available through the
282 282 SystemExec class."""
283 283
284 284 stat = 0
285 285 if verbose or debug: print header+cmd
286 286 sys.stdout.flush()
287 287 if not debug: stat = os.system(cmd)
288 288 return stat
289 289
290 290 # This function is used by ipython in a lot of places to make system calls.
291 291 # We need it to be slightly different under win32, due to the vagaries of
292 292 # 'network shares'. A win32 override is below.
293 293
294 294 def shell(cmd,verbose=0,debug=0,header=''):
295 295 """Execute a command in the system shell, always return None.
296 296
297 297 Options:
298 298
299 299 - verbose (0): print the command to be executed.
300 300
301 301 - debug (0): only print, do not actually execute.
302 302
303 303 - header (''): Header to print on screen prior to the executed command (it
304 304 is only prepended to the command, no newlines are added).
305 305
306 306 Note: this is similar to genutils.system(), but it returns None so it can
307 307 be conveniently used in interactive loops without getting the return value
308 308 (typically 0) printed many times."""
309 309
310 310 stat = 0
311 311 if verbose or debug: print header+cmd
312 312 # flush stdout so we don't mangle python's buffering
313 313 sys.stdout.flush()
314 314 if not debug:
315 315 os.system(cmd)
316 316
317 317 # override shell() for win32 to deal with network shares
318 318 if os.name in ('nt','dos'):
319 319
320 320 shell_ori = shell
321 321
322 322 def shell(cmd,verbose=0,debug=0,header=''):
323 323 if os.getcwd().startswith(r"\\"):
324 324 path = os.getcwd()
325 325 # change to c drive (cannot be on UNC-share when issuing os.system,
326 326 # as cmd.exe cannot handle UNC addresses)
327 327 os.chdir("c:")
328 328 # issue pushd to the UNC-share and then run the command
329 329 try:
330 330 shell_ori('"pushd %s&&"'%path+cmd,verbose,debug,header)
331 331 finally:
332 332 os.chdir(path)
333 333 else:
334 334 shell_ori(cmd,verbose,debug,header)
335 335
336 336 shell.__doc__ = shell_ori.__doc__
337 337
338 338 def getoutput(cmd,verbose=0,debug=0,header='',split=0):
339 339 """Dummy substitute for perl's backquotes.
340 340
341 341 Executes a command and returns the output.
342 342
343 343 Accepts the same arguments as system(), plus:
344 344
345 345 - split(0): if true, the output is returned as a list split on newlines.
346 346
347 347 Note: a stateful version of this function is available through the
348 348 SystemExec class.
349 349
350 350 This is pretty much deprecated and rarely used,
351 351 genutils.getoutputerror may be what you need.
352 352
353 353 """
354 354
355 355 if verbose or debug: print header+cmd
356 356 if not debug:
357 357 output = os.popen(cmd).read()
358 358 # stipping last \n is here for backwards compat.
359 359 if output.endswith('\n'):
360 360 output = output[:-1]
361 361 if split:
362 362 return output.split('\n')
363 363 else:
364 364 return output
365 365
366 366 def getoutputerror(cmd,verbose=0,debug=0,header='',split=0):
367 367 """Return (standard output,standard error) of executing cmd in a shell.
368 368
369 369 Accepts the same arguments as system(), plus:
370 370
371 371 - split(0): if true, each of stdout/err is returned as a list split on
372 372 newlines.
373 373
374 374 Note: a stateful version of this function is available through the
375 375 SystemExec class."""
376 376
377 377 if verbose or debug: print header+cmd
378 378 if not cmd:
379 379 if split:
380 380 return [],[]
381 381 else:
382 382 return '',''
383 383 if not debug:
384 384 pin,pout,perr = os.popen3(cmd)
385 385 tout = pout.read().rstrip()
386 386 terr = perr.read().rstrip()
387 387 pin.close()
388 388 pout.close()
389 389 perr.close()
390 390 if split:
391 391 return tout.split('\n'),terr.split('\n')
392 392 else:
393 393 return tout,terr
394 394
395 395 # for compatibility with older naming conventions
396 396 xsys = system
397 397 bq = getoutput
398 398
399 399 class SystemExec:
400 400 """Access the system and getoutput functions through a stateful interface.
401 401
402 402 Note: here we refer to the system and getoutput functions from this
403 403 library, not the ones from the standard python library.
404 404
405 405 This class offers the system and getoutput functions as methods, but the
406 406 verbose, debug and header parameters can be set for the instance (at
407 407 creation time or later) so that they don't need to be specified on each
408 408 call.
409 409
410 410 For efficiency reasons, there's no way to override the parameters on a
411 411 per-call basis other than by setting instance attributes. If you need
412 412 local overrides, it's best to directly call system() or getoutput().
413 413
414 414 The following names are provided as alternate options:
415 415 - xsys: alias to system
416 416 - bq: alias to getoutput
417 417
418 418 An instance can then be created as:
419 419 >>> sysexec = SystemExec(verbose=1,debug=0,header='Calling: ')
420 420
421 421 And used as:
422 422 >>> sysexec.xsys('pwd')
423 423 >>> dirlist = sysexec.bq('ls -l')
424 424 """
425 425
426 426 def __init__(self,verbose=0,debug=0,header='',split=0):
427 427 """Specify the instance's values for verbose, debug and header."""
428 428 setattr_list(self,'verbose debug header split')
429 429
430 430 def system(self,cmd):
431 431 """Stateful interface to system(), with the same keyword parameters."""
432 432
433 433 system(cmd,self.verbose,self.debug,self.header)
434 434
435 435 def shell(self,cmd):
436 436 """Stateful interface to shell(), with the same keyword parameters."""
437 437
438 438 shell(cmd,self.verbose,self.debug,self.header)
439 439
440 440 xsys = system # alias
441 441
442 442 def getoutput(self,cmd):
443 443 """Stateful interface to getoutput()."""
444 444
445 445 return getoutput(cmd,self.verbose,self.debug,self.header,self.split)
446 446
447 447 def getoutputerror(self,cmd):
448 448 """Stateful interface to getoutputerror()."""
449 449
450 450 return getoutputerror(cmd,self.verbose,self.debug,self.header,self.split)
451 451
452 452 bq = getoutput # alias
453 453
454 454 #-----------------------------------------------------------------------------
455 455 def mutex_opts(dict,ex_op):
456 456 """Check for presence of mutually exclusive keys in a dict.
457 457
458 458 Call: mutex_opts(dict,[[op1a,op1b],[op2a,op2b]...]"""
459 459 for op1,op2 in ex_op:
460 460 if op1 in dict and op2 in dict:
461 461 raise ValueError,'\n*** ERROR in Arguments *** '\
462 462 'Options '+op1+' and '+op2+' are mutually exclusive.'
463 463
464 464 #-----------------------------------------------------------------------------
465 465 def get_py_filename(name):
466 466 """Return a valid python filename in the current directory.
467 467
468 468 If the given name is not a file, it adds '.py' and searches again.
469 469 Raises IOError with an informative message if the file isn't found."""
470 470
471 471 name = os.path.expanduser(name)
472 472 if not os.path.isfile(name) and not name.endswith('.py'):
473 473 name += '.py'
474 474 if os.path.isfile(name):
475 475 return name
476 476 else:
477 477 raise IOError,'File `%s` not found.' % name
478 478
479 479 #-----------------------------------------------------------------------------
480 480 def filefind(fname,alt_dirs = None):
481 481 """Return the given filename either in the current directory, if it
482 482 exists, or in a specified list of directories.
483 483
484 484 ~ expansion is done on all file and directory names.
485 485
486 486 Upon an unsuccessful search, raise an IOError exception."""
487 487
488 488 if alt_dirs is None:
489 489 try:
490 490 alt_dirs = get_home_dir()
491 491 except HomeDirError:
492 492 alt_dirs = os.getcwd()
493 493 search = [fname] + list_strings(alt_dirs)
494 494 search = map(os.path.expanduser,search)
495 495 #print 'search list for',fname,'list:',search # dbg
496 496 fname = search[0]
497 497 if os.path.isfile(fname):
498 498 return fname
499 499 for direc in search[1:]:
500 500 testname = os.path.join(direc,fname)
501 501 #print 'testname',testname # dbg
502 502 if os.path.isfile(testname):
503 503 return testname
504 504 raise IOError,'File' + `fname` + \
505 505 ' not found in current or supplied directories:' + `alt_dirs`
506 506
507 507 #----------------------------------------------------------------------------
508 508 def file_read(filename):
509 509 """Read a file and close it. Returns the file source."""
510 510 fobj = open(filename,'r');
511 511 source = fobj.read();
512 512 fobj.close()
513 513 return source
514 514
515 515 def file_readlines(filename):
516 516 """Read a file and close it. Returns the file source using readlines()."""
517 517 fobj = open(filename,'r');
518 518 lines = fobj.readlines();
519 519 fobj.close()
520 520 return lines
521 521
522 522 #----------------------------------------------------------------------------
523 523 def target_outdated(target,deps):
524 524 """Determine whether a target is out of date.
525 525
526 526 target_outdated(target,deps) -> 1/0
527 527
528 528 deps: list of filenames which MUST exist.
529 529 target: single filename which may or may not exist.
530 530
531 531 If target doesn't exist or is older than any file listed in deps, return
532 532 true, otherwise return false.
533 533 """
534 534 try:
535 535 target_time = os.path.getmtime(target)
536 536 except os.error:
537 537 return 1
538 538 for dep in deps:
539 539 dep_time = os.path.getmtime(dep)
540 540 if dep_time > target_time:
541 541 #print "For target",target,"Dep failed:",dep # dbg
542 542 #print "times (dep,tar):",dep_time,target_time # dbg
543 543 return 1
544 544 return 0
545 545
546 546 #-----------------------------------------------------------------------------
547 547 def target_update(target,deps,cmd):
548 548 """Update a target with a given command given a list of dependencies.
549 549
550 550 target_update(target,deps,cmd) -> runs cmd if target is outdated.
551 551
552 552 This is just a wrapper around target_outdated() which calls the given
553 553 command if target is outdated."""
554 554
555 555 if target_outdated(target,deps):
556 556 xsys(cmd)
557 557
558 558 #----------------------------------------------------------------------------
559 559 def unquote_ends(istr):
560 560 """Remove a single pair of quotes from the endpoints of a string."""
561 561
562 562 if not istr:
563 563 return istr
564 564 if (istr[0]=="'" and istr[-1]=="'") or \
565 565 (istr[0]=='"' and istr[-1]=='"'):
566 566 return istr[1:-1]
567 567 else:
568 568 return istr
569 569
570 570 #----------------------------------------------------------------------------
571 571 def process_cmdline(argv,names=[],defaults={},usage=''):
572 572 """ Process command-line options and arguments.
573 573
574 574 Arguments:
575 575
576 576 - argv: list of arguments, typically sys.argv.
577 577
578 578 - names: list of option names. See DPyGetOpt docs for details on options
579 579 syntax.
580 580
581 581 - defaults: dict of default values.
582 582
583 583 - usage: optional usage notice to print if a wrong argument is passed.
584 584
585 585 Return a dict of options and a list of free arguments."""
586 586
587 587 getopt = DPyGetOpt.DPyGetOpt()
588 588 getopt.setIgnoreCase(0)
589 589 getopt.parseConfiguration(names)
590 590
591 591 try:
592 592 getopt.processArguments(argv)
593 593 except:
594 594 print usage
595 595 warn(`sys.exc_value`,level=4)
596 596
597 597 defaults.update(getopt.optionValues)
598 598 args = getopt.freeValues
599 599
600 600 return defaults,args
601 601
602 602 #----------------------------------------------------------------------------
603 603 def optstr2types(ostr):
604 604 """Convert a string of option names to a dict of type mappings.
605 605
606 606 optstr2types(str) -> {None:'string_opts',int:'int_opts',float:'float_opts'}
607 607
608 608 This is used to get the types of all the options in a string formatted
609 609 with the conventions of DPyGetOpt. The 'type' None is used for options
610 610 which are strings (they need no further conversion). This function's main
611 611 use is to get a typemap for use with read_dict().
612 612 """
613 613
614 614 typeconv = {None:'',int:'',float:''}
615 615 typemap = {'s':None,'i':int,'f':float}
616 616 opt_re = re.compile(r'([\w]*)([^:=]*:?=?)([sif]?)')
617 617
618 618 for w in ostr.split():
619 619 oname,alias,otype = opt_re.match(w).groups()
620 620 if otype == '' or alias == '!': # simple switches are integers too
621 621 otype = 'i'
622 622 typeconv[typemap[otype]] += oname + ' '
623 623 return typeconv
624 624
625 625 #----------------------------------------------------------------------------
626 626 def read_dict(filename,type_conv=None,**opt):
627 627
628 628 """Read a dictionary of key=value pairs from an input file, optionally
629 629 performing conversions on the resulting values.
630 630
631 631 read_dict(filename,type_conv,**opt) -> dict
632 632
633 633 Only one value per line is accepted, the format should be
634 634 # optional comments are ignored
635 635 key value\n
636 636
637 637 Args:
638 638
639 639 - type_conv: A dictionary specifying which keys need to be converted to
640 640 which types. By default all keys are read as strings. This dictionary
641 641 should have as its keys valid conversion functions for strings
642 642 (int,long,float,complex, or your own). The value for each key
643 643 (converter) should be a whitespace separated string containing the names
644 644 of all the entries in the file to be converted using that function. For
645 645 keys to be left alone, use None as the conversion function (only needed
646 646 with purge=1, see below).
647 647
648 648 - opt: dictionary with extra options as below (default in parens)
649 649
650 650 purge(0): if set to 1, all keys *not* listed in type_conv are purged out
651 651 of the dictionary to be returned. If purge is going to be used, the
652 652 set of keys to be left as strings also has to be explicitly specified
653 653 using the (non-existent) conversion function None.
654 654
655 655 fs(None): field separator. This is the key/value separator to be used
656 656 when parsing the file. The None default means any whitespace [behavior
657 657 of string.split()].
658 658
659 659 strip(0): if 1, strip string values of leading/trailinig whitespace.
660 660
661 661 warn(1): warning level if requested keys are not found in file.
662 662 - 0: silently ignore.
663 663 - 1: inform but proceed.
664 664 - 2: raise KeyError exception.
665 665
666 666 no_empty(0): if 1, remove keys with whitespace strings as a value.
667 667
668 668 unique([]): list of keys (or space separated string) which can't be
669 669 repeated. If one such key is found in the file, each new instance
670 670 overwrites the previous one. For keys not listed here, the behavior is
671 671 to make a list of all appearances.
672 672
673 673 Example:
674 674 If the input file test.ini has:
675 675 i 3
676 676 x 4.5
677 677 y 5.5
678 678 s hi ho
679 679 Then:
680 680
681 681 >>> type_conv={int:'i',float:'x',None:'s'}
682 682 >>> read_dict('test.ini')
683 683 {'i': '3', 's': 'hi ho', 'x': '4.5', 'y': '5.5'}
684 684 >>> read_dict('test.ini',type_conv)
685 685 {'i': 3, 's': 'hi ho', 'x': 4.5, 'y': '5.5'}
686 686 >>> read_dict('test.ini',type_conv,purge=1)
687 687 {'i': 3, 's': 'hi ho', 'x': 4.5}
688 688 """
689 689
690 690 # starting config
691 691 opt.setdefault('purge',0)
692 692 opt.setdefault('fs',None) # field sep defaults to any whitespace
693 693 opt.setdefault('strip',0)
694 694 opt.setdefault('warn',1)
695 695 opt.setdefault('no_empty',0)
696 696 opt.setdefault('unique','')
697 697 if type(opt['unique']) in StringTypes:
698 698 unique_keys = qw(opt['unique'])
699 699 elif type(opt['unique']) in (types.TupleType,types.ListType):
700 700 unique_keys = opt['unique']
701 701 else:
702 702 raise ValueError, 'Unique keys must be given as a string, List or Tuple'
703 703
704 704 dict = {}
705 705 # first read in table of values as strings
706 706 file = open(filename,'r')
707 707 for line in file.readlines():
708 708 line = line.strip()
709 709 if len(line) and line[0]=='#': continue
710 710 if len(line)>0:
711 711 lsplit = line.split(opt['fs'],1)
712 712 try:
713 713 key,val = lsplit
714 714 except ValueError:
715 715 key,val = lsplit[0],''
716 716 key = key.strip()
717 717 if opt['strip']: val = val.strip()
718 718 if val == "''" or val == '""': val = ''
719 719 if opt['no_empty'] and (val=='' or val.isspace()):
720 720 continue
721 721 # if a key is found more than once in the file, build a list
722 722 # unless it's in the 'unique' list. In that case, last found in file
723 723 # takes precedence. User beware.
724 724 try:
725 725 if dict[key] and key in unique_keys:
726 726 dict[key] = val
727 727 elif type(dict[key]) is types.ListType:
728 728 dict[key].append(val)
729 729 else:
730 730 dict[key] = [dict[key],val]
731 731 except KeyError:
732 732 dict[key] = val
733 733 # purge if requested
734 734 if opt['purge']:
735 735 accepted_keys = qwflat(type_conv.values())
736 736 for key in dict.keys():
737 737 if key in accepted_keys: continue
738 738 del(dict[key])
739 739 # now convert if requested
740 740 if type_conv==None: return dict
741 741 conversions = type_conv.keys()
742 742 try: conversions.remove(None)
743 743 except: pass
744 744 for convert in conversions:
745 745 for val in qw(type_conv[convert]):
746 746 try:
747 747 dict[val] = convert(dict[val])
748 748 except KeyError,e:
749 749 if opt['warn'] == 0:
750 750 pass
751 751 elif opt['warn'] == 1:
752 752 print >>sys.stderr, 'Warning: key',val,\
753 753 'not found in file',filename
754 754 elif opt['warn'] == 2:
755 755 raise KeyError,e
756 756 else:
757 757 raise ValueError,'Warning level must be 0,1 or 2'
758 758
759 759 return dict
760 760
761 761 #----------------------------------------------------------------------------
762 762 def flag_calls(func):
763 763 """Wrap a function to detect and flag when it gets called.
764 764
765 765 This is a decorator which takes a function and wraps it in a function with
766 766 a 'called' attribute. wrapper.called is initialized to False.
767 767
768 768 The wrapper.called attribute is set to False right before each call to the
769 769 wrapped function, so if the call fails it remains False. After the call
770 770 completes, wrapper.called is set to True and the output is returned.
771 771
772 772 Testing for truth in wrapper.called allows you to determine if a call to
773 773 func() was attempted and succeeded."""
774 774
775 775 def wrapper(*args,**kw):
776 776 wrapper.called = False
777 777 out = func(*args,**kw)
778 778 wrapper.called = True
779 779 return out
780 780
781 781 wrapper.called = False
782 782 wrapper.__doc__ = func.__doc__
783 783 return wrapper
784 784
785 785 #----------------------------------------------------------------------------
786 786 class HomeDirError(Error):
787 787 pass
788 788
789 789 def get_home_dir():
790 790 """Return the closest possible equivalent to a 'home' directory.
791 791
792 792 We first try $HOME. Absent that, on NT it's $HOMEDRIVE\$HOMEPATH.
793 793
794 794 Currently only Posix and NT are implemented, a HomeDirError exception is
795 795 raised for all other OSes. """
796 796
797 797 isdir = os.path.isdir
798 798 env = os.environ
799 799 try:
800 800 homedir = env['HOME']
801 801 if not isdir(homedir):
802 802 # in case a user stuck some string which does NOT resolve to a
803 803 # valid path, it's as good as if we hadn't foud it
804 804 raise KeyError
805 805 return homedir
806 806 except KeyError:
807 807 if os.name == 'posix':
808 808 raise HomeDirError,'undefined $HOME, IPython can not proceed.'
809 809 elif os.name == 'nt':
810 810 # For some strange reason, win9x returns 'nt' for os.name.
811 811 try:
812 812 homedir = os.path.join(env['HOMEDRIVE'],env['HOMEPATH'])
813 813 if not isdir(homedir):
814 814 homedir = os.path.join(env['USERPROFILE'])
815 815 if not isdir(homedir):
816 816 raise HomeDirError
817 817 return homedir
818 818 except:
819 819 try:
820 820 # Use the registry to get the 'My Documents' folder.
821 821 import _winreg as wreg
822 822 key = wreg.OpenKey(wreg.HKEY_CURRENT_USER,
823 823 "Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders")
824 824 homedir = wreg.QueryValueEx(key,'Personal')[0]
825 825 key.Close()
826 826 if not isdir(homedir):
827 827 e = ('Invalid "Personal" folder registry key '
828 828 'typically "My Documents".\n'
829 829 'Value: %s\n'
830 830 'This is not a valid directory on your system.' %
831 831 homedir)
832 832 raise HomeDirError(e)
833 833 return homedir
834 834 except HomeDirError:
835 835 raise
836 836 except:
837 837 return 'C:\\'
838 838 elif os.name == 'dos':
839 839 # Desperate, may do absurd things in classic MacOS. May work under DOS.
840 840 return 'C:\\'
841 841 else:
842 842 raise HomeDirError,'support for your operating system not implemented.'
843 843
844 844 #****************************************************************************
845 845 # strings and text
846 846
847 847 class LSString(str):
848 848 """String derivative with a special access attributes.
849 849
850 850 These are normal strings, but with the special attributes:
851 851
852 852 .l (or .list) : value as list (split on newlines).
853 853 .n (or .nlstr): original value (the string itself).
854 854 .s (or .spstr): value as whitespace-separated string.
855 855
856 856 Any values which require transformations are computed only once and
857 857 cached.
858 858
859 859 Such strings are very useful to efficiently interact with the shell, which
860 860 typically only understands whitespace-separated options for commands."""
861 861
862 862 def get_list(self):
863 863 try:
864 864 return self.__list
865 865 except AttributeError:
866 866 self.__list = self.split('\n')
867 867 return self.__list
868 868
869 869 l = list = property(get_list)
870 870
871 871 def get_spstr(self):
872 872 try:
873 873 return self.__spstr
874 874 except AttributeError:
875 875 self.__spstr = self.replace('\n',' ')
876 876 return self.__spstr
877 877
878 878 s = spstr = property(get_spstr)
879 879
880 880 def get_nlstr(self):
881 881 return self
882 882
883 883 n = nlstr = property(get_nlstr)
884 884
885 885 def get_paths(self):
886 886 try:
887 887 return self.__paths
888 888 except AttributeError:
889 889 self.__paths = [path(p) for p in self.split('\n') if os.path.exists(p)]
890 890 return self.__paths
891 891
892 892 p = paths = property(get_paths)
893 893
894 894
895 895 #----------------------------------------------------------------------------
896 896 class SList(list):
897 897 """List derivative with a special access attributes.
898 898
899 899 These are normal lists, but with the special attributes:
900 900
901 901 .l (or .list) : value as list (the list itself).
902 902 .n (or .nlstr): value as a string, joined on newlines.
903 903 .s (or .spstr): value as a string, joined on spaces.
904 904
905 905 Any values which require transformations are computed only once and
906 906 cached."""
907 907
908 908 def get_list(self):
909 909 return self
910 910
911 911 l = list = property(get_list)
912 912
913 913 def get_spstr(self):
914 914 try:
915 915 return self.__spstr
916 916 except AttributeError:
917 917 self.__spstr = ' '.join(self)
918 918 return self.__spstr
919 919
920 920 s = spstr = property(get_spstr)
921 921
922 922 def get_nlstr(self):
923 923 try:
924 924 return self.__nlstr
925 925 except AttributeError:
926 926 self.__nlstr = '\n'.join(self)
927 927 return self.__nlstr
928 928
929 929 n = nlstr = property(get_nlstr)
930 930
931 931 def get_paths(self):
932 932 try:
933 933 return self.__paths
934 934 except AttributeError:
935 935 self.__paths = [path(p) for p in self if os.path.exists(p)]
936 936 return self.__paths
937 937
938 938 p = paths = property(get_paths)
939 939
940 940 #----------------------------------------------------------------------------
941 941 def esc_quotes(strng):
942 942 """Return the input string with single and double quotes escaped out"""
943 943
944 944 return strng.replace('"','\\"').replace("'","\\'")
945 945
946 946 #----------------------------------------------------------------------------
947 947 def make_quoted_expr(s):
948 948 """Return string s in appropriate quotes, using raw string if possible.
949 949
950 950 Effectively this turns string: cd \ao\ao\
951 951 to: r"cd \ao\ao\_"[:-1]
952 952
953 953 Note the use of raw string and padding at the end to allow trailing backslash.
954 954
955 955 """
956 956
957 957 tail = ''
958 958 tailpadding = ''
959 959 raw = ''
960 960 if "\\" in s:
961 961 raw = 'r'
962 962 if s.endswith('\\'):
963 963 tail = '[:-1]'
964 964 tailpadding = '_'
965 965 if '"' not in s:
966 966 quote = '"'
967 967 elif "'" not in s:
968 968 quote = "'"
969 969 elif '"""' not in s and not s.endswith('"'):
970 970 quote = '"""'
971 971 elif "'''" not in s and not s.endswith("'"):
972 972 quote = "'''"
973 973 else:
974 974 # give up, backslash-escaped string will do
975 975 return '"%s"' % esc_quotes(s)
976 976 res = itpl("$raw$quote$s$tailpadding$quote$tail")
977 977 return res
978 978
979 979
980 980 #----------------------------------------------------------------------------
981 981 def raw_input_multi(header='', ps1='==> ', ps2='..> ',terminate_str = '.'):
982 982 """Take multiple lines of input.
983 983
984 984 A list with each line of input as a separate element is returned when a
985 985 termination string is entered (defaults to a single '.'). Input can also
986 986 terminate via EOF (^D in Unix, ^Z-RET in Windows).
987 987
988 988 Lines of input which end in \\ are joined into single entries (and a
989 989 secondary continuation prompt is issued as long as the user terminates
990 990 lines with \\). This allows entering very long strings which are still
991 991 meant to be treated as single entities.
992 992 """
993 993
994 994 try:
995 995 if header:
996 996 header += '\n'
997 997 lines = [raw_input(header + ps1)]
998 998 except EOFError:
999 999 return []
1000 1000 terminate = [terminate_str]
1001 1001 try:
1002 1002 while lines[-1:] != terminate:
1003 1003 new_line = raw_input(ps1)
1004 1004 while new_line.endswith('\\'):
1005 1005 new_line = new_line[:-1] + raw_input(ps2)
1006 1006 lines.append(new_line)
1007 1007
1008 1008 return lines[:-1] # don't return the termination command
1009 1009 except EOFError:
1010 1010 print
1011 1011 return lines
1012 1012
1013 1013 #----------------------------------------------------------------------------
1014 1014 def raw_input_ext(prompt='', ps2='... '):
1015 1015 """Similar to raw_input(), but accepts extended lines if input ends with \\."""
1016 1016
1017 1017 line = raw_input(prompt)
1018 1018 while line.endswith('\\'):
1019 1019 line = line[:-1] + raw_input(ps2)
1020 1020 return line
1021 1021
1022 1022 #----------------------------------------------------------------------------
1023 1023 def ask_yes_no(prompt,default=None):
1024 1024 """Asks a question and returns an integer 1/0 (y/n) answer.
1025 1025
1026 1026 If default is given (one of 'y','n'), it is used if the user input is
1027 1027 empty. Otherwise the question is repeated until an answer is given.
1028 1028
1029 1029 An EOF is treated as the default answer. If there is no default, an
1030 1030 exception is raised to prevent infinite loops.
1031 1031
1032 1032 Valid answers are: y/yes/n/no (match is not case sensitive)."""
1033 1033
1034 1034 answers = {'y':True,'n':False,'yes':True,'no':False}
1035 1035 ans = None
1036 1036 while ans not in answers.keys():
1037 1037 try:
1038 1038 ans = raw_input(prompt+' ').lower()
1039 1039 if not ans: # response was an empty string
1040 1040 ans = default
1041 1041 except KeyboardInterrupt:
1042 1042 pass
1043 1043 except EOFError:
1044 1044 if default in answers.keys():
1045 1045 ans = default
1046 1046 print
1047 1047 else:
1048 1048 raise
1049 1049
1050 1050 return answers[ans]
1051 1051
1052 1052 #----------------------------------------------------------------------------
1053 1053 def marquee(txt='',width=78,mark='*'):
1054 1054 """Return the input string centered in a 'marquee'."""
1055 1055 if not txt:
1056 1056 return (mark*width)[:width]
1057 1057 nmark = (width-len(txt)-2)/len(mark)/2
1058 1058 if nmark < 0: nmark =0
1059 1059 marks = mark*nmark
1060 1060 return '%s %s %s' % (marks,txt,marks)
1061 1061
1062 1062 #----------------------------------------------------------------------------
1063 1063 class EvalDict:
1064 1064 """
1065 1065 Emulate a dict which evaluates its contents in the caller's frame.
1066 1066
1067 1067 Usage:
1068 1068 >>>number = 19
1069 1069 >>>text = "python"
1070 1070 >>>print "%(text.capitalize())s %(number/9.0).1f rules!" % EvalDict()
1071 1071 """
1072 1072
1073 1073 # This version is due to sismex01@hebmex.com on c.l.py, and is basically a
1074 1074 # modified (shorter) version of:
1075 1075 # http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/66018 by
1076 1076 # Skip Montanaro (skip@pobox.com).
1077 1077
1078 1078 def __getitem__(self, name):
1079 1079 frame = sys._getframe(1)
1080 1080 return eval(name, frame.f_globals, frame.f_locals)
1081 1081
1082 1082 EvalString = EvalDict # for backwards compatibility
1083 1083 #----------------------------------------------------------------------------
1084 1084 def qw(words,flat=0,sep=None,maxsplit=-1):
1085 1085 """Similar to Perl's qw() operator, but with some more options.
1086 1086
1087 1087 qw(words,flat=0,sep=' ',maxsplit=-1) -> words.split(sep,maxsplit)
1088 1088
1089 1089 words can also be a list itself, and with flat=1, the output will be
1090 1090 recursively flattened. Examples:
1091 1091
1092 1092 >>> qw('1 2')
1093 1093 ['1', '2']
1094 1094 >>> qw(['a b','1 2',['m n','p q']])
1095 1095 [['a', 'b'], ['1', '2'], [['m', 'n'], ['p', 'q']]]
1096 1096 >>> qw(['a b','1 2',['m n','p q']],flat=1)
1097 1097 ['a', 'b', '1', '2', 'm', 'n', 'p', 'q'] """
1098 1098
1099 1099 if type(words) in StringTypes:
1100 1100 return [word.strip() for word in words.split(sep,maxsplit)
1101 1101 if word and not word.isspace() ]
1102 1102 if flat:
1103 1103 return flatten(map(qw,words,[1]*len(words)))
1104 1104 return map(qw,words)
1105 1105
1106 1106 #----------------------------------------------------------------------------
1107 1107 def qwflat(words,sep=None,maxsplit=-1):
1108 1108 """Calls qw(words) in flat mode. It's just a convenient shorthand."""
1109 1109 return qw(words,1,sep,maxsplit)
1110 1110
1111 1111 #----------------------------------------------------------------------------
1112 1112 def qw_lol(indata):
1113 1113 """qw_lol('a b') -> [['a','b']],
1114 1114 otherwise it's just a call to qw().
1115 1115
1116 1116 We need this to make sure the modules_some keys *always* end up as a
1117 1117 list of lists."""
1118 1118
1119 1119 if type(indata) in StringTypes:
1120 1120 return [qw(indata)]
1121 1121 else:
1122 1122 return qw(indata)
1123 1123
1124 1124 #-----------------------------------------------------------------------------
1125 1125 def list_strings(arg):
1126 1126 """Always return a list of strings, given a string or list of strings
1127 1127 as input."""
1128 1128
1129 1129 if type(arg) in StringTypes: return [arg]
1130 1130 else: return arg
1131 1131
1132 1132 #----------------------------------------------------------------------------
1133 1133 def grep(pat,list,case=1):
1134 1134 """Simple minded grep-like function.
1135 1135 grep(pat,list) returns occurrences of pat in list, None on failure.
1136 1136
1137 1137 It only does simple string matching, with no support for regexps. Use the
1138 1138 option case=0 for case-insensitive matching."""
1139 1139
1140 1140 # This is pretty crude. At least it should implement copying only references
1141 1141 # to the original data in case it's big. Now it copies the data for output.
1142 1142 out=[]
1143 1143 if case:
1144 1144 for term in list:
1145 1145 if term.find(pat)>-1: out.append(term)
1146 1146 else:
1147 1147 lpat=pat.lower()
1148 1148 for term in list:
1149 1149 if term.lower().find(lpat)>-1: out.append(term)
1150 1150
1151 1151 if len(out): return out
1152 1152 else: return None
1153 1153
1154 1154 #----------------------------------------------------------------------------
1155 1155 def dgrep(pat,*opts):
1156 1156 """Return grep() on dir()+dir(__builtins__).
1157 1157
1158 1158 A very common use of grep() when working interactively."""
1159 1159
1160 1160 return grep(pat,dir(__main__)+dir(__main__.__builtins__),*opts)
1161 1161
1162 1162 #----------------------------------------------------------------------------
1163 1163 def idgrep(pat):
1164 1164 """Case-insensitive dgrep()"""
1165 1165
1166 1166 return dgrep(pat,0)
1167 1167
1168 1168 #----------------------------------------------------------------------------
1169 1169 def igrep(pat,list):
1170 1170 """Synonym for case-insensitive grep."""
1171 1171
1172 1172 return grep(pat,list,case=0)
1173 1173
1174 1174 #----------------------------------------------------------------------------
1175 1175 def indent(str,nspaces=4,ntabs=0):
1176 1176 """Indent a string a given number of spaces or tabstops.
1177 1177
1178 1178 indent(str,nspaces=4,ntabs=0) -> indent str by ntabs+nspaces.
1179 1179 """
1180 1180 if str is None:
1181 1181 return
1182 1182 ind = '\t'*ntabs+' '*nspaces
1183 1183 outstr = '%s%s' % (ind,str.replace(os.linesep,os.linesep+ind))
1184 1184 if outstr.endswith(os.linesep+ind):
1185 1185 return outstr[:-len(ind)]
1186 1186 else:
1187 1187 return outstr
1188 1188
1189 1189 #-----------------------------------------------------------------------------
1190 1190 def native_line_ends(filename,backup=1):
1191 1191 """Convert (in-place) a file to line-ends native to the current OS.
1192 1192
1193 1193 If the optional backup argument is given as false, no backup of the
1194 1194 original file is left. """
1195 1195
1196 1196 backup_suffixes = {'posix':'~','dos':'.bak','nt':'.bak','mac':'.bak'}
1197 1197
1198 1198 bak_filename = filename + backup_suffixes[os.name]
1199 1199
1200 1200 original = open(filename).read()
1201 1201 shutil.copy2(filename,bak_filename)
1202 1202 try:
1203 1203 new = open(filename,'wb')
1204 1204 new.write(os.linesep.join(original.splitlines()))
1205 1205 new.write(os.linesep) # ALWAYS put an eol at the end of the file
1206 1206 new.close()
1207 1207 except:
1208 1208 os.rename(bak_filename,filename)
1209 1209 if not backup:
1210 1210 try:
1211 1211 os.remove(bak_filename)
1212 1212 except:
1213 1213 pass
1214 1214
1215 1215 #----------------------------------------------------------------------------
1216 1216 def get_pager_cmd(pager_cmd = None):
1217 1217 """Return a pager command.
1218 1218
1219 1219 Makes some attempts at finding an OS-correct one."""
1220 1220
1221 1221 if os.name == 'posix':
1222 1222 default_pager_cmd = 'less -r' # -r for color control sequences
1223 1223 elif os.name in ['nt','dos']:
1224 1224 default_pager_cmd = 'type'
1225 1225
1226 1226 if pager_cmd is None:
1227 1227 try:
1228 1228 pager_cmd = os.environ['PAGER']
1229 1229 except:
1230 1230 pager_cmd = default_pager_cmd
1231 1231 return pager_cmd
1232 1232
1233 1233 #-----------------------------------------------------------------------------
1234 1234 def get_pager_start(pager,start):
1235 1235 """Return the string for paging files with an offset.
1236 1236
1237 1237 This is the '+N' argument which less and more (under Unix) accept.
1238 1238 """
1239 1239
1240 1240 if pager in ['less','more']:
1241 1241 if start:
1242 1242 start_string = '+' + str(start)
1243 1243 else:
1244 1244 start_string = ''
1245 1245 else:
1246 1246 start_string = ''
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
1254 1255
1255 1256 @return: True if need print more lines, False if quit
1256 1257 """
1257 1258 Term.cout.write('---Return to continue, q to quit--- ')
1258 1259 ans = msvcrt.getch()
1259 1260 if ans in ("q", "Q"):
1260 1261 result = False
1261 1262 else:
1262 1263 result = True
1263 1264 Term.cout.write("\b"*37 + " "*37 + "\b"*37)
1264 1265 return result
1265 1266 else:
1266 1267 def page_more():
1267 1268 ans = raw_input('---Return to continue, q to quit--- ')
1268 1269 if ans.lower().startswith('q'):
1269 1270 return False
1270 1271 else:
1271 1272 return True
1272 1273
1273 1274 esc_re = re.compile(r"(\x1b[^m]+m)")
1274 1275
1275 1276 def page_dumb(strng,start=0,screen_lines=25):
1276 1277 """Very dumb 'pager' in Python, for when nothing else works.
1277 1278
1278 1279 Only moves forward, same interface as page(), except for pager_cmd and
1279 1280 mode."""
1280 1281
1281 1282 out_ln = strng.splitlines()[start:]
1282 1283 screens = chop(out_ln,screen_lines-1)
1283 1284 if len(screens) == 1:
1284 1285 print >>Term.cout, os.linesep.join(screens[0])
1285 1286 else:
1286 1287 last_escape = ""
1287 1288 for scr in screens[0:-1]:
1288 1289 hunk = os.linesep.join(scr)
1289 1290 print >>Term.cout, last_escape + hunk
1290 1291 if not page_more():
1291 1292 return
1292 1293 esc_list = esc_re.findall(hunk)
1293 1294 if len(esc_list) > 0:
1294 1295 last_escape = esc_list[-1]
1295 1296 print >>Term.cout, last_escape + os.linesep.join(screens[-1])
1296 1297
1297 1298 #----------------------------------------------------------------------------
1298 1299 def page(strng,start=0,screen_lines=0,pager_cmd = None):
1299 1300 """Print a string, piping through a pager after a certain length.
1300 1301
1301 1302 The screen_lines parameter specifies the number of *usable* lines of your
1302 1303 terminal screen (total lines minus lines you need to reserve to show other
1303 1304 information).
1304 1305
1305 1306 If you set screen_lines to a number <=0, page() will try to auto-determine
1306 1307 your screen size and will only use up to (screen_size+screen_lines) for
1307 1308 printing, paging after that. That is, if you want auto-detection but need
1308 1309 to reserve the bottom 3 lines of the screen, use screen_lines = -3, and for
1309 1310 auto-detection without any lines reserved simply use screen_lines = 0.
1310 1311
1311 1312 If a string won't fit in the allowed lines, it is sent through the
1312 1313 specified pager command. If none given, look for PAGER in the environment,
1313 1314 and ultimately default to less.
1314 1315
1315 1316 If no system pager works, the string is sent through a 'dumb pager'
1316 1317 written in python, very simplistic.
1317 1318 """
1318 1319
1319 1320 # Ugly kludge, but calling curses.initscr() flat out crashes in emacs
1320 1321 TERM = os.environ.get('TERM','dumb')
1321 1322 if TERM in ['dumb','emacs'] and os.name != 'nt':
1322 1323 print strng
1323 1324 return
1324 1325 # chop off the topmost part of the string we don't want to see
1325 1326 str_lines = strng.split(os.linesep)[start:]
1326 1327 str_toprint = os.linesep.join(str_lines)
1327 1328 num_newlines = len(str_lines)
1328 1329 len_str = len(str_toprint)
1329 1330
1330 1331 # Dumb heuristics to guesstimate number of on-screen lines the string
1331 1332 # takes. Very basic, but good enough for docstrings in reasonable
1332 1333 # terminals. If someone later feels like refining it, it's not hard.
1333 1334 numlines = max(num_newlines,int(len_str/80)+1)
1334 1335
1335 1336 if os.name == "nt":
1336 1337 screen_lines_def = get_console_size(defaulty=25)[1]
1337 1338 else:
1338 1339 screen_lines_def = 25 # default value if we can't auto-determine
1339 1340
1340 1341 # auto-determine screen size
1341 1342 if screen_lines <= 0:
1342 1343 if TERM=='xterm':
1343 1344 try:
1344 1345 import curses
1345 1346 if hasattr(curses,'initscr'):
1346 1347 use_curses = 1
1347 1348 else:
1348 1349 use_curses = 0
1349 1350 except ImportError:
1350 1351 use_curses = 0
1351 1352 else:
1352 1353 # curses causes problems on many terminals other than xterm.
1353 1354 use_curses = 0
1354 1355 if use_curses:
1355 1356 scr = curses.initscr()
1356 1357 screen_lines_real,screen_cols = scr.getmaxyx()
1357 1358 curses.endwin()
1358 1359 screen_lines += screen_lines_real
1359 1360 #print '***Screen size:',screen_lines_real,'lines x',\
1360 1361 #screen_cols,'columns.' # dbg
1361 1362 else:
1362 1363 screen_lines += screen_lines_def
1363 1364
1364 1365 #print 'numlines',numlines,'screenlines',screen_lines # dbg
1365 1366 if numlines <= screen_lines :
1366 1367 #print '*** normal print' # dbg
1367 1368 print >>Term.cout, str_toprint
1368 1369 else:
1369 1370 # Try to open pager and default to internal one if that fails.
1370 1371 # All failure modes are tagged as 'retval=1', to match the return
1371 1372 # value of a failed system command. If any intermediate attempt
1372 1373 # sets retval to 1, at the end we resort to our own page_dumb() pager.
1373 1374 pager_cmd = get_pager_cmd(pager_cmd)
1374 1375 pager_cmd += ' ' + get_pager_start(pager_cmd,start)
1375 1376 if os.name == 'nt':
1376 1377 if pager_cmd.startswith('type'):
1377 1378 # The default WinXP 'type' command is failing on complex strings.
1378 1379 retval = 1
1379 1380 else:
1380 1381 tmpname = tempfile.mktemp('.txt')
1381 1382 tmpfile = file(tmpname,'wt')
1382 1383 tmpfile.write(strng)
1383 1384 tmpfile.close()
1384 1385 cmd = "%s < %s" % (pager_cmd,tmpname)
1385 1386 if os.system(cmd):
1386 1387 retval = 1
1387 1388 else:
1388 1389 retval = None
1389 1390 os.remove(tmpname)
1390 1391 else:
1391 1392 try:
1392 1393 retval = None
1393 1394 # if I use popen4, things hang. No idea why.
1394 1395 #pager,shell_out = os.popen4(pager_cmd)
1395 1396 pager = os.popen(pager_cmd,'w')
1396 1397 pager.write(strng)
1397 1398 pager.close()
1398 1399 retval = pager.close() # success returns None
1399 1400 except IOError,msg: # broken pipe when user quits
1400 1401 if msg.args == (32,'Broken pipe'):
1401 1402 retval = None
1402 1403 else:
1403 1404 retval = 1
1404 1405 except OSError:
1405 1406 # Other strange problems, sometimes seen in Win2k/cygwin
1406 1407 retval = 1
1407 1408 if retval is not None:
1408 1409 page_dumb(strng,screen_lines=screen_lines)
1409 1410
1410 1411 #----------------------------------------------------------------------------
1411 1412 def page_file(fname,start = 0, pager_cmd = None):
1412 1413 """Page a file, using an optional pager command and starting line.
1413 1414 """
1414 1415
1415 1416 pager_cmd = get_pager_cmd(pager_cmd)
1416 1417 pager_cmd += ' ' + get_pager_start(pager_cmd,start)
1417 1418
1418 1419 try:
1419 1420 if os.environ['TERM'] in ['emacs','dumb']:
1420 1421 raise EnvironmentError
1421 1422 xsys(pager_cmd + ' ' + fname)
1422 1423 except:
1423 1424 try:
1424 1425 if start > 0:
1425 1426 start -= 1
1426 1427 page(open(fname).read(),start)
1427 1428 except:
1428 1429 print 'Unable to show file',`fname`
1429 1430
1430 1431 #----------------------------------------------------------------------------
1431 1432 def snip_print(str,width = 75,print_full = 0,header = ''):
1432 1433 """Print a string snipping the midsection to fit in width.
1433 1434
1434 1435 print_full: mode control:
1435 1436 - 0: only snip long strings
1436 1437 - 1: send to page() directly.
1437 1438 - 2: snip long strings and ask for full length viewing with page()
1438 1439 Return 1 if snipping was necessary, 0 otherwise."""
1439 1440
1440 1441 if print_full == 1:
1441 1442 page(header+str)
1442 1443 return 0
1443 1444
1444 1445 print header,
1445 1446 if len(str) < width:
1446 1447 print str
1447 1448 snip = 0
1448 1449 else:
1449 1450 whalf = int((width -5)/2)
1450 1451 print str[:whalf] + ' <...> ' + str[-whalf:]
1451 1452 snip = 1
1452 1453 if snip and print_full == 2:
1453 1454 if raw_input(header+' Snipped. View (y/n)? [N]').lower() == 'y':
1454 1455 page(str)
1455 1456 return snip
1456 1457
1457 1458 #****************************************************************************
1458 1459 # lists, dicts and structures
1459 1460
1460 1461 def belong(candidates,checklist):
1461 1462 """Check whether a list of items appear in a given list of options.
1462 1463
1463 1464 Returns a list of 1 and 0, one for each candidate given."""
1464 1465
1465 1466 return [x in checklist for x in candidates]
1466 1467
1467 1468 #----------------------------------------------------------------------------
1468 1469 def uniq_stable(elems):
1469 1470 """uniq_stable(elems) -> list
1470 1471
1471 1472 Return from an iterable, a list of all the unique elements in the input,
1472 1473 but maintaining the order in which they first appear.
1473 1474
1474 1475 A naive solution to this problem which just makes a dictionary with the
1475 1476 elements as keys fails to respect the stability condition, since
1476 1477 dictionaries are unsorted by nature.
1477 1478
1478 1479 Note: All elements in the input must be valid dictionary keys for this
1479 1480 routine to work, as it internally uses a dictionary for efficiency
1480 1481 reasons."""
1481 1482
1482 1483 unique = []
1483 1484 unique_dict = {}
1484 1485 for nn in elems:
1485 1486 if nn not in unique_dict:
1486 1487 unique.append(nn)
1487 1488 unique_dict[nn] = None
1488 1489 return unique
1489 1490
1490 1491 #----------------------------------------------------------------------------
1491 1492 class NLprinter:
1492 1493 """Print an arbitrarily nested list, indicating index numbers.
1493 1494
1494 1495 An instance of this class called nlprint is available and callable as a
1495 1496 function.
1496 1497
1497 1498 nlprint(list,indent=' ',sep=': ') -> prints indenting each level by 'indent'
1498 1499 and using 'sep' to separate the index from the value. """
1499 1500
1500 1501 def __init__(self):
1501 1502 self.depth = 0
1502 1503
1503 1504 def __call__(self,lst,pos='',**kw):
1504 1505 """Prints the nested list numbering levels."""
1505 1506 kw.setdefault('indent',' ')
1506 1507 kw.setdefault('sep',': ')
1507 1508 kw.setdefault('start',0)
1508 1509 kw.setdefault('stop',len(lst))
1509 1510 # we need to remove start and stop from kw so they don't propagate
1510 1511 # into a recursive call for a nested list.
1511 1512 start = kw['start']; del kw['start']
1512 1513 stop = kw['stop']; del kw['stop']
1513 1514 if self.depth == 0 and 'header' in kw.keys():
1514 1515 print kw['header']
1515 1516
1516 1517 for idx in range(start,stop):
1517 1518 elem = lst[idx]
1518 1519 if type(elem)==type([]):
1519 1520 self.depth += 1
1520 1521 self.__call__(elem,itpl('$pos$idx,'),**kw)
1521 1522 self.depth -= 1
1522 1523 else:
1523 1524 printpl(kw['indent']*self.depth+'$pos$idx$kw["sep"]$elem')
1524 1525
1525 1526 nlprint = NLprinter()
1526 1527 #----------------------------------------------------------------------------
1527 1528 def all_belong(candidates,checklist):
1528 1529 """Check whether a list of items ALL appear in a given list of options.
1529 1530
1530 1531 Returns a single 1 or 0 value."""
1531 1532
1532 1533 return 1-(0 in [x in checklist for x in candidates])
1533 1534
1534 1535 #----------------------------------------------------------------------------
1535 1536 def sort_compare(lst1,lst2,inplace = 1):
1536 1537 """Sort and compare two lists.
1537 1538
1538 1539 By default it does it in place, thus modifying the lists. Use inplace = 0
1539 1540 to avoid that (at the cost of temporary copy creation)."""
1540 1541 if not inplace:
1541 1542 lst1 = lst1[:]
1542 1543 lst2 = lst2[:]
1543 1544 lst1.sort(); lst2.sort()
1544 1545 return lst1 == lst2
1545 1546
1546 1547 #----------------------------------------------------------------------------
1547 1548 def mkdict(**kwargs):
1548 1549 """Return a dict from a keyword list.
1549 1550
1550 1551 It's just syntactic sugar for making ditcionary creation more convenient:
1551 1552 # the standard way
1552 1553 >>>data = { 'red' : 1, 'green' : 2, 'blue' : 3 }
1553 1554 # a cleaner way
1554 1555 >>>data = dict(red=1, green=2, blue=3)
1555 1556
1556 1557 If you need more than this, look at the Struct() class."""
1557 1558
1558 1559 return kwargs
1559 1560
1560 1561 #----------------------------------------------------------------------------
1561 1562 def list2dict(lst):
1562 1563 """Takes a list of (key,value) pairs and turns it into a dict."""
1563 1564
1564 1565 dic = {}
1565 1566 for k,v in lst: dic[k] = v
1566 1567 return dic
1567 1568
1568 1569 #----------------------------------------------------------------------------
1569 1570 def list2dict2(lst,default=''):
1570 1571 """Takes a list and turns it into a dict.
1571 1572 Much slower than list2dict, but more versatile. This version can take
1572 1573 lists with sublists of arbitrary length (including sclars)."""
1573 1574
1574 1575 dic = {}
1575 1576 for elem in lst:
1576 1577 if type(elem) in (types.ListType,types.TupleType):
1577 1578 size = len(elem)
1578 1579 if size == 0:
1579 1580 pass
1580 1581 elif size == 1:
1581 1582 dic[elem] = default
1582 1583 else:
1583 1584 k,v = elem[0], elem[1:]
1584 1585 if len(v) == 1: v = v[0]
1585 1586 dic[k] = v
1586 1587 else:
1587 1588 dic[elem] = default
1588 1589 return dic
1589 1590
1590 1591 #----------------------------------------------------------------------------
1591 1592 def flatten(seq):
1592 1593 """Flatten a list of lists (NOT recursive, only works for 2d lists)."""
1593 1594
1594 1595 return [x for subseq in seq for x in subseq]
1595 1596
1596 1597 #----------------------------------------------------------------------------
1597 1598 def get_slice(seq,start=0,stop=None,step=1):
1598 1599 """Get a slice of a sequence with variable step. Specify start,stop,step."""
1599 1600 if stop == None:
1600 1601 stop = len(seq)
1601 1602 item = lambda i: seq[i]
1602 1603 return map(item,xrange(start,stop,step))
1603 1604
1604 1605 #----------------------------------------------------------------------------
1605 1606 def chop(seq,size):
1606 1607 """Chop a sequence into chunks of the given size."""
1607 1608 chunk = lambda i: seq[i:i+size]
1608 1609 return map(chunk,xrange(0,len(seq),size))
1609 1610
1610 1611 #----------------------------------------------------------------------------
1611 1612 # with is a keyword as of python 2.5, so this function is renamed to withobj
1612 1613 # from its old 'with' name.
1613 1614 def with_obj(object, **args):
1614 1615 """Set multiple attributes for an object, similar to Pascal's with.
1615 1616
1616 1617 Example:
1617 1618 with_obj(jim,
1618 1619 born = 1960,
1619 1620 haircolour = 'Brown',
1620 1621 eyecolour = 'Green')
1621 1622
1622 1623 Credit: Greg Ewing, in
1623 1624 http://mail.python.org/pipermail/python-list/2001-May/040703.html.
1624 1625
1625 1626 NOTE: up until IPython 0.7.2, this was called simply 'with', but 'with'
1626 1627 has become a keyword for Python 2.5, so we had to rename it."""
1627 1628
1628 1629 object.__dict__.update(args)
1629 1630
1630 1631 #----------------------------------------------------------------------------
1631 1632 def setattr_list(obj,alist,nspace = None):
1632 1633 """Set a list of attributes for an object taken from a namespace.
1633 1634
1634 1635 setattr_list(obj,alist,nspace) -> sets in obj all the attributes listed in
1635 1636 alist with their values taken from nspace, which must be a dict (something
1636 1637 like locals() will often do) If nspace isn't given, locals() of the
1637 1638 *caller* is used, so in most cases you can omit it.
1638 1639
1639 1640 Note that alist can be given as a string, which will be automatically
1640 1641 split into a list on whitespace. If given as a list, it must be a list of
1641 1642 *strings* (the variable names themselves), not of variables."""
1642 1643
1643 1644 # this grabs the local variables from the *previous* call frame -- that is
1644 1645 # the locals from the function that called setattr_list().
1645 1646 # - snipped from weave.inline()
1646 1647 if nspace is None:
1647 1648 call_frame = sys._getframe().f_back
1648 1649 nspace = call_frame.f_locals
1649 1650
1650 1651 if type(alist) in StringTypes:
1651 1652 alist = alist.split()
1652 1653 for attr in alist:
1653 1654 val = eval(attr,nspace)
1654 1655 setattr(obj,attr,val)
1655 1656
1656 1657 #----------------------------------------------------------------------------
1657 1658 def getattr_list(obj,alist,*args):
1658 1659 """getattr_list(obj,alist[, default]) -> attribute list.
1659 1660
1660 1661 Get a list of named attributes for an object. When a default argument is
1661 1662 given, it is returned when the attribute doesn't exist; without it, an
1662 1663 exception is raised in that case.
1663 1664
1664 1665 Note that alist can be given as a string, which will be automatically
1665 1666 split into a list on whitespace. If given as a list, it must be a list of
1666 1667 *strings* (the variable names themselves), not of variables."""
1667 1668
1668 1669 if type(alist) in StringTypes:
1669 1670 alist = alist.split()
1670 1671 if args:
1671 1672 if len(args)==1:
1672 1673 default = args[0]
1673 1674 return map(lambda attr: getattr(obj,attr,default),alist)
1674 1675 else:
1675 1676 raise ValueError,'getattr_list() takes only one optional argument'
1676 1677 else:
1677 1678 return map(lambda attr: getattr(obj,attr),alist)
1678 1679
1679 1680 #----------------------------------------------------------------------------
1680 1681 def map_method(method,object_list,*argseq,**kw):
1681 1682 """map_method(method,object_list,*args,**kw) -> list
1682 1683
1683 1684 Return a list of the results of applying the methods to the items of the
1684 1685 argument sequence(s). If more than one sequence is given, the method is
1685 1686 called with an argument list consisting of the corresponding item of each
1686 1687 sequence. All sequences must be of the same length.
1687 1688
1688 1689 Keyword arguments are passed verbatim to all objects called.
1689 1690
1690 1691 This is Python code, so it's not nearly as fast as the builtin map()."""
1691 1692
1692 1693 out_list = []
1693 1694 idx = 0
1694 1695 for object in object_list:
1695 1696 try:
1696 1697 handler = getattr(object, method)
1697 1698 except AttributeError:
1698 1699 out_list.append(None)
1699 1700 else:
1700 1701 if argseq:
1701 1702 args = map(lambda lst:lst[idx],argseq)
1702 1703 #print 'ob',object,'hand',handler,'ar',args # dbg
1703 1704 out_list.append(handler(args,**kw))
1704 1705 else:
1705 1706 out_list.append(handler(**kw))
1706 1707 idx += 1
1707 1708 return out_list
1708 1709
1709 1710 #----------------------------------------------------------------------------
1710 1711 def import_fail_info(mod_name,fns=None):
1711 1712 """Inform load failure for a module."""
1712 1713
1713 1714 if fns == None:
1714 1715 warn("Loading of %s failed.\n" % (mod_name,))
1715 1716 else:
1716 1717 warn("Loading of %s from %s failed.\n" % (fns,mod_name))
1717 1718
1718 1719 #----------------------------------------------------------------------------
1719 1720 # Proposed popitem() extension, written as a method
1720 1721
1721 1722
1722 1723 class NotGiven: pass
1723 1724
1724 1725 def popkey(dct,key,default=NotGiven):
1725 1726 """Return dct[key] and delete dct[key].
1726 1727
1727 1728 If default is given, return it if dct[key] doesn't exist, otherwise raise
1728 1729 KeyError. """
1729 1730
1730 1731 try:
1731 1732 val = dct[key]
1732 1733 except KeyError:
1733 1734 if default is NotGiven:
1734 1735 raise
1735 1736 else:
1736 1737 return default
1737 1738 else:
1738 1739 del dct[key]
1739 1740 return val
1740 1741
1741 1742 def wrap_deprecated(func, suggest = '<nothing>'):
1742 1743 def newFunc(*args, **kwargs):
1743 1744 warnings.warn("Call to deprecated function %s, use %s instead" %
1744 1745 ( func.__name__, suggest),
1745 1746 category=DeprecationWarning,
1746 1747 stacklevel = 2)
1747 1748 return func(*args, **kwargs)
1748 1749 return newFunc
1749 1750
1750 1751 #*************************** end of file <genutils.py> **********************
1751 1752
@@ -1,642 +1,642 b''
1 1 # -*- coding: utf-8 -*-
2 2 #*****************************************************************************
3 3 # Copyright (C) 2001-2004 Fernando Perez. <fperez@colorado.edu>
4 4 #
5 5 # Distributed under the terms of the BSD License. The full license is in
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']
13 13 __license__ = Release.license
14 14 __version__ = Release.version
15 15
16 16 __doc__ = """
17 17 IPython -- An enhanced Interactive Python
18 18 =========================================
19 19
20 20 A Python shell with automatic history (input and output), dynamic object
21 21 introspection, easier configuration, command completion, access to the system
22 22 shell and more.
23 23
24 24 IPython can also be embedded in running programs. See EMBEDDING below.
25 25
26 26
27 27 USAGE
28 28 ipython [options] files
29 29
30 30 If invoked with no options, it executes all the files listed in
31 31 sequence and drops you into the interpreter while still acknowledging
32 32 any options you may have set in your ipythonrc file. This behavior is
33 33 different from standard Python, which when called as python -i will
34 34 only execute one file and will ignore your configuration setup.
35 35
36 36 Please note that some of the configuration options are not available at
37 37 the command line, simply because they are not practical here. Look into
38 38 your ipythonrc configuration file for details on those. This file
39 39 typically installed in the $HOME/.ipython directory.
40 40
41 41 For Windows users, $HOME resolves to C:\\Documents and
42 42 Settings\\YourUserName in most instances, and _ipython is used instead
43 43 of .ipython, since some Win32 programs have problems with dotted names
44 44 in directories.
45 45
46 46 In the rest of this text, we will refer to this directory as
47 47 IPYTHONDIR.
48 48
49 49
50 50 SPECIAL THREADING OPTIONS
51 51 The following special options are ONLY valid at the beginning of the
52 52 command line, and not later. This is because they control the initial-
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
72 72 requires that you have the 'wxversion' Python module installed,
73 73 which is part of recent wxPython distributions.
74 74
75 75 If -pylab is given, IPython loads special support for the mat-
76 76 plotlib library (http://matplotlib.sourceforge.net), allowing
77 77 interactive usage of any of its backends as defined in the
78 78 user's .matplotlibrc file. It automatically activates GTK, QT
79 79 or WX threading for IPyhton if the choice of matplotlib backend
80 80 requires it. It also modifies the %run command to correctly
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
95 95 you will have to test on your platform and Python configuration
96 96 to determine whether it works for you. Debian users have
97 97 reported success, apparently due to the fact that Debian builds
98 98 all of Tcl, Tk, Tkinter and Python with pthreads support. Under
99 99 other Linux environments (such as Fedora Core 2/3), this option
100 100 has caused random crashes and lockups of the Python interpreter.
101 101 Under other operating systems (Mac OSX and Windows), you'll need
102 102 to try it to find out, since currently no user reports are
103 103 available.
104 104
105 105 There is unfortunately no way for IPython to determine at run-
106 106 time whether -tk will work reliably or not, so you will need to
107 107 do some experiments before relying on it for regular work.
108 108
109 109 A WARNING ABOUT SIGNALS AND THREADS
110 110
111 111 When any of the thread systems (GTK, QT or WX) are active, either
112 112 directly or via -pylab with a threaded backend, it is impossible to
113 113 interrupt long-running Python code via Ctrl-C. IPython can not pass
114 114 the KeyboardInterrupt exception (or the underlying SIGINT) across
115 115 threads, so any long-running process started from IPython will run to
116 116 completion, or will have to be killed via an external (OS-based)
117 117 mechanism.
118 118
119 119 To the best of my knowledge, this limitation is imposed by the Python
120 120 interpreter itself, and it comes from the difficulty of writing
121 121 portable signal/threaded code. If any user is an expert on this topic
122 122 and can suggest a better solution, I would love to hear about it. In
123 123 the IPython sources, look at the Shell.py module, and in particular at
124 124 the runcode() method.
125 125
126 126 REGULAR OPTIONS
127 127 After the above threading options have been given, regular options can
128 128 follow in any order. All options can be abbreviated to their shortest
129 129 non-ambiguous form and are case-sensitive. One or two dashes can be
130 130 used. Some options have an alternate short form, indicated after a |.
131 131
132 132 Most options can also be set from your ipythonrc configuration file.
133 133 See the provided examples for assistance. Options given on the comman-
134 134 dline override the values set in the ipythonrc file.
135 135
136 136 All options with a [no] prepended can be specified in negated form
137 137 (using -nooption instead of -option) to turn the feature off.
138 138
139 139 -h, --help
140 140 Show summary of options.
141 141
142 142 -pylab This can only be given as the first option passed to IPython (it
143 143 will have no effect in any other position). It adds special sup-
144 144 port for the matplotlib library (http://matplotlib.source-
145 145 forge.net), allowing interactive usage of any of its backends as
146 146 defined in the user's .matplotlibrc file. It automatically
147 147 activates GTK or WX threading for IPyhton if the choice of mat-
148 148 plotlib backend requires it. It also modifies the @run command
149 149 to correctly execute (without blocking) any matplotlib-based
150 150 script which calls show() at the end.
151 151
152 152 -autocall <val>
153 153 Make IPython automatically call any callable object even if you
154 154 didn't type explicit parentheses. For example, 'str 43' becomes
155 155 'str(43)' automatically. The value can be '0' to disable the
156 156 feature, '1' for 'smart' autocall, where it is not applied if
157 157 there are no more arguments on the line, and '2' for 'full'
158 158 autocall, where all callable objects are automatically called
159 159 (even if no arguments are present). The default is '1'.
160 160
161 161 -[no]autoindent
162 162 Turn automatic indentation on/off.
163 163
164 164 -[no]automagic
165 165 Make magic commands automatic (without needing their first char-
166 166 acter to be %). Type %magic at the IPython prompt for more
167 167 information.
168 168
169 169 -[no]autoedit_syntax
170 170 When a syntax error occurs after editing a file, automatically
171 171 open the file to the trouble causing line for convenient fixing.
172 172
173 173 -[no]banner
174 174 Print the intial information banner (default on).
175 175
176 176 -c <command>
177 177 Execute the given command string, and set sys.argv to ['c'].
178 178 This is similar to the -c option in the normal Python inter-
179 179 preter.
180 180
181 181 -cache_size|cs <n>
182 182 Size of the output cache (maximum number of entries to hold in
183 183 memory). The default is 1000, you can change it permanently in
184 184 your config file. Setting it to 0 completely disables the
185 185 caching system, and the minimum value accepted is 20 (if you
186 186 provide a value less than 20, it is reset to 0 and a warning is
187 187 issued). This limit is defined because otherwise you'll spend
188 188 more time re-flushing a too small cache than working.
189 189
190 190 -classic|cl
191 191 Gives IPython a similar feel to the classic Python prompt.
192 192
193 193 -colors <scheme>
194 194 Color scheme for prompts and exception reporting. Currently
195 195 implemented: NoColor, Linux, and LightBG.
196 196
197 197 -[no]color_info
198 198 IPython can display information about objects via a set of func-
199 199 tions, and optionally can use colors for this, syntax highlight-
200 200 ing source code and various other elements. However, because
201 201 this information is passed through a pager (like 'less') and
202 202 many pagers get confused with color codes, this option is off by
203 203 default. You can test it and turn it on permanently in your
204 204 ipythonrc file if it works for you. As a reference, the 'less'
205 205 pager supplied with Mandrake 8.2 works ok, but that in RedHat
206 206 7.2 doesn't.
207 207
208 208 Test it and turn it on permanently if it works with your system.
209 209 The magic function @color_info allows you to toggle this inter-
210 210 actively for testing.
211 211
212 212 -[no]confirm_exit
213 213 Set to confirm when you try to exit IPython with an EOF (Con-
214 214 trol-D in Unix, Control-Z/Enter in Windows). Note that using the
215 215 magic functions @Exit or @Quit you can force a direct exit,
216 216 bypassing any confirmation.
217 217
218 218 -[no]debug
219 219 Show information about the loading process. Very useful to pin
220 220 down problems with your configuration files or to get details
221 221 about session restores.
222 222
223 223 -[no]deep_reload
224 224 IPython can use the deep_reload module which reloads changes in
225 225 modules recursively (it replaces the reload() function, so you
226 226 don't need to change anything to use it). deep_reload() forces a
227 227 full reload of modules whose code may have changed, which the
228 228 default reload() function does not.
229 229
230 230 When deep_reload is off, IPython will use the normal reload(),
231 231 but deep_reload will still be available as dreload(). This fea-
232 232 ture is off by default [which means that you have both normal
233 233 reload() and dreload()].
234 234
235 235 -editor <name>
236 236 Which editor to use with the @edit command. By default, IPython
237 237 will honor your EDITOR environment variable (if not set, vi is
238 238 the Unix default and notepad the Windows one). Since this editor
239 239 is invoked on the fly by IPython and is meant for editing small
240 240 code snippets, you may want to use a small, lightweight editor
241 241 here (in case your default EDITOR is something like Emacs).
242 242
243 243 -ipythondir <name>
244 244 The name of your IPython configuration directory IPYTHONDIR.
245 245 This can also be specified through the environment variable
246 246 IPYTHONDIR.
247 247
248 248 -log|l Generate a log file of all input. The file is named
249 249 ipython_log.py in your current directory (which prevents logs
250 250 from multiple IPython sessions from trampling each other). You
251 251 can use this to later restore a session by loading your logfile
252 252 as a file to be executed with option -logplay (see below).
253 253
254 254 -logfile|lf
255 255 Specify the name of your logfile.
256 256
257 257 -logplay|lp
258 258 Replay a previous log. For restoring a session as close as pos-
259 259 sible to the state you left it in, use this option (don't just
260 260 run the logfile). With -logplay, IPython will try to reconstruct
261 261 the previous working environment in full, not just execute the
262 262 commands in the logfile.
263 263 When a session is restored, logging is automatically turned on
264 264 again with the name of the logfile it was invoked with (it is
265 265 read from the log header). So once you've turned logging on for
266 266 a session, you can quit IPython and reload it as many times as
267 267 you want and it will continue to log its history and restore
268 268 from the beginning every time.
269 269
270 270 Caveats: there are limitations in this option. The history vari-
271 271 ables _i*,_* and _dh don't get restored properly. In the future
272 272 we will try to implement full session saving by writing and
273 273 retrieving a failed because of inherent limitations of Python's
274 274 Pickle module, so this may have to wait.
275 275
276 276 -[no]messages
277 277 Print messages which IPython collects about its startup process
278 278 (default on).
279 279
280 280 -[no]pdb
281 281 Automatically call the pdb debugger after every uncaught excep-
282 282 tion. If you are used to debugging using pdb, this puts you
283 283 automatically inside of it after any call (either in IPython or
284 284 in code called by it) which triggers an exception which goes
285 285 uncaught.
286 286
287 287 -[no]pprint
288 288 IPython can optionally use the pprint (pretty printer) module
289 289 for displaying results. pprint tends to give a nicer display of
290 290 nested data structures. If you like it, you can turn it on per-
291 291 manently in your config file (default off).
292 292
293 293 -profile|p <name>
294 294 Assume that your config file is ipythonrc-<name> (looks in cur-
295 295 rent dir first, then in IPYTHONDIR). This is a quick way to keep
296 296 and load multiple config files for different tasks, especially
297 297 if you use the include option of config files. You can keep a
298 298 basic IPYTHONDIR/ipythonrc file and then have other 'profiles'
299 299 which include this one and load extra things for particular
300 300 tasks. For example:
301 301
302 302 1) $HOME/.ipython/ipythonrc : load basic things you always want.
303 303 2) $HOME/.ipython/ipythonrc-math : load (1) and basic math-
304 304 related modules.
305 305 3) $HOME/.ipython/ipythonrc-numeric : load (1) and Numeric and
306 306 plotting modules.
307 307
308 308 Since it is possible to create an endless loop by having circu-
309 309 lar file inclusions, IPython will stop if it reaches 15 recur-
310 310 sive inclusions.
311 311
312 312 -prompt_in1|pi1 <string>
313 313 Specify the string used for input prompts. Note that if you are
314 314 using numbered prompts, the number is represented with a '\#' in
315 315 the string. Don't forget to quote strings with spaces embedded
316 316 in them. Default: 'In [\#]: '.
317 317
318 318 Most bash-like escapes can be used to customize IPython's
319 319 prompts, as well as a few additional ones which are IPython-spe-
320 320 cific. All valid prompt escapes are described in detail in the
321 321 Customization section of the IPython HTML/PDF manual.
322 322
323 323 -prompt_in2|pi2 <string>
324 324 Similar to the previous option, but used for the continuation
325 325 prompts. The special sequence '\D' is similar to '\#', but with
326 326 all digits replaced dots (so you can have your continuation
327 327 prompt aligned with your input prompt). Default: ' .\D.: '
328 328 (note three spaces at the start for alignment with 'In [\#]').
329 329
330 330 -prompt_out|po <string>
331 331 String used for output prompts, also uses numbers like
332 332 prompt_in1. Default: 'Out[\#]:'.
333 333
334 334 -quick Start in bare bones mode (no config file loaded).
335 335
336 336 -rcfile <name>
337 337 Name of your IPython resource configuration file. normally
338 338 IPython loads ipythonrc (from current directory) or
339 339 IPYTHONDIR/ipythonrc. If the loading of your config file fails,
340 340 IPython starts with a bare bones configuration (no modules
341 341 loaded at all).
342 342
343 343 -[no]readline
344 344 Use the readline library, which is needed to support name com-
345 345 pletion and command history, among other things. It is enabled
346 346 by default, but may cause problems for users of X/Emacs in
347 347 Python comint or shell buffers.
348 348
349 349 Note that emacs 'eterm' buffers (opened with M-x term) support
350 350 IPython's readline and syntax coloring fine, only 'emacs' (M-x
351 351 shell and C-c !) buffers do not.
352 352
353 353 -screen_length|sl <n>
354 354 Number of lines of your screen. This is used to control print-
355 355 ing of very long strings. Strings longer than this number of
356 356 lines will be sent through a pager instead of directly printed.
357 357
358 358 The default value for this is 0, which means IPython will auto-
359 359 detect your screen size every time it needs to print certain
360 360 potentially long strings (this doesn't change the behavior of
361 361 the 'print' keyword, it's only triggered internally). If for
362 362 some reason this isn't working well (it needs curses support),
363 363 specify it yourself. Otherwise don't change the default.
364 364
365 365 -separate_in|si <string>
366 366 Separator before input prompts. Default '0.
367 367
368 368 -separate_out|so <string>
369 369 Separator before output prompts. Default: 0 (nothing).
370 370
371 371 -separate_out2|so2 <string>
372 372 Separator after output prompts. Default: 0 (nothing).
373 373
374 374 -nosep Shorthand for '-separate_in 0 -separate_out 0 -separate_out2 0'.
375 375 Simply removes all input/output separators.
376 376
377 377 -upgrade
378 378 Allows you to upgrade your IPYTHONDIR configuration when you
379 379 install a new version of IPython. Since new versions may
380 380 include new command lines options or example files, this copies
381 381 updated ipythonrc-type files. However, it backs up (with a .old
382 382 extension) all files which it overwrites so that you can merge
383 383 back any custimizations you might have in your personal files.
384 384
385 385 -Version
386 386 Print version information and exit.
387 387
388 388 -wxversion <string>
389 389 Select a specific version of wxPython (used in conjunction with
390 390 -wthread). Requires the wxversion module, part of recent
391 391 wxPython distributions.
392 392
393 393 -xmode <modename>
394 394 Mode for exception reporting. The valid modes are Plain, Con-
395 395 text, and Verbose.
396 396
397 397 - Plain: similar to python's normal traceback printing.
398 398
399 399 - Context: prints 5 lines of context source code around each
400 400 line in the traceback.
401 401
402 402 - Verbose: similar to Context, but additionally prints the vari-
403 403 ables currently visible where the exception happened (shortening
404 404 their strings if too long). This can potentially be very slow,
405 405 if you happen to have a huge data structure whose string repre-
406 406 sentation is complex to compute. Your computer may appear to
407 407 freeze for a while with cpu usage at 100%. If this occurs, you
408 408 can cancel the traceback with Ctrl-C (maybe hitting it more than
409 409 once).
410 410
411 411
412 412 EMBEDDING
413 413 It is possible to start an IPython instance inside your own Python pro-
414 414 grams. In the documentation example files there are some illustrations
415 415 on how to do this.
416 416
417 417 This feature allows you to evalutate dynamically the state of your
418 418 code, operate with your variables, analyze them, etc. Note however
419 419 that any changes you make to values while in the shell do NOT propagate
420 420 back to the running code, so it is safe to modify your values because
421 421 you won't break your code in bizarre ways by doing so.
422 422 """
423 423
424 424 cmd_line_usage = __doc__
425 425
426 426 #---------------------------------------------------------------------------
427 427 interactive_usage = """
428 428 IPython -- An enhanced Interactive Python
429 429 =========================================
430 430
431 431 IPython offers a combination of convenient shell features, special commands
432 432 and a history mechanism for both input (command history) and output (results
433 433 caching, similar to Mathematica). It is intended to be a fully compatible
434 434 replacement for the standard Python interpreter, while offering vastly
435 435 improved functionality and flexibility.
436 436
437 437 At your system command line, type 'ipython -help' to see the command line
438 438 options available. This document only describes interactive features.
439 439
440 440 Warning: IPython relies on the existence of a global variable called __IP which
441 441 controls the shell itself. If you redefine __IP to anything, bizarre behavior
442 442 will quickly occur.
443 443
444 444 MAIN FEATURES
445 445
446 446 * Access to the standard Python help. As of Python 2.1, a help system is
447 447 available with access to object docstrings and the Python manuals. Simply
448 448 type 'help' (no quotes) to access it.
449 449
450 450 * Magic commands: type %magic for information on the magic subsystem.
451 451
452 452 * System command aliases, via the %alias command or the ipythonrc config file.
453 453
454 454 * Dynamic object information:
455 455
456 456 Typing ?word or word? prints detailed information about an object. If
457 457 certain strings in the object are too long (docstrings, code, etc.) they get
458 458 snipped in the center for brevity.
459 459
460 460 Typing ??word or word?? gives access to the full information without
461 461 snipping long strings. Long strings are sent to the screen through the less
462 462 pager if longer than the screen, printed otherwise.
463 463
464 464 The ?/?? system gives access to the full source code for any object (if
465 465 available), shows function prototypes and other useful information.
466 466
467 467 If you just want to see an object's docstring, type '%pdoc object' (without
468 468 quotes, and without % if you have automagic on).
469 469
470 470 Both %pdoc and ?/?? give you access to documentation even on things which are
471 471 not explicitely defined. Try for example typing {}.get? or after import os,
472 472 type os.path.abspath??. The magic functions %pdef, %source and %file operate
473 473 similarly.
474 474
475 475 * Completion in the local namespace, by typing TAB at the prompt.
476 476
477 477 At any time, hitting tab will complete any available python commands or
478 478 variable names, and show you a list of the possible completions if there's
479 479 no unambiguous one. It will also complete filenames in the current directory.
480 480
481 481 This feature requires the readline and rlcomplete modules, so it won't work
482 482 if your Python lacks readline support (such as under Windows).
483 483
484 484 * Search previous command history in two ways (also requires readline):
485 485
486 486 - Start typing, and then use Ctrl-p (previous,up) and Ctrl-n (next,down) to
487 487 search through only the history items that match what you've typed so
488 488 far. If you use Ctrl-p/Ctrl-n at a blank prompt, they just behave like
489 489 normal arrow keys.
490 490
491 491 - Hit Ctrl-r: opens a search prompt. Begin typing and the system searches
492 492 your history for lines that match what you've typed so far, completing as
493 493 much as it can.
494 494
495 495 * Persistent command history across sessions (readline required).
496 496
497 497 * Logging of input with the ability to save and restore a working session.
498 498
499 499 * System escape with !. Typing !ls will run 'ls' in the current directory.
500 500
501 501 * The reload command does a 'deep' reload of a module: changes made to the
502 502 module since you imported will actually be available without having to exit.
503 503
504 504 * Verbose and colored exception traceback printouts. See the magic xmode and
505 505 xcolor functions for details (just type %magic).
506 506
507 507 * Input caching system:
508 508
509 509 IPython offers numbered prompts (In/Out) with input and output caching. All
510 510 input is saved and can be retrieved as variables (besides the usual arrow
511 511 key recall).
512 512
513 513 The following GLOBAL variables always exist (so don't overwrite them!):
514 514 _i: stores previous input.
515 515 _ii: next previous.
516 516 _iii: next-next previous.
517 517 _ih : a list of all input _ih[n] is the input from line n.
518 518
519 519 Additionally, global variables named _i<n> are dynamically created (<n>
520 520 being the prompt counter), such that _i<n> == _ih[<n>]
521 521
522 522 For example, what you typed at prompt 14 is available as _i14 and _ih[14].
523 523
524 524 You can create macros which contain multiple input lines from this history,
525 525 for later re-execution, with the %macro function.
526 526
527 527 The history function %hist allows you to see any part of your input history
528 528 by printing a range of the _i variables. Note that inputs which contain
529 529 magic functions (%) appear in the history with a prepended comment. This is
530 530 because they aren't really valid Python code, so you can't exec them.
531 531
532 532 * Output caching system:
533 533
534 534 For output that is returned from actions, a system similar to the input
535 535 cache exists but using _ instead of _i. Only actions that produce a result
536 536 (NOT assignments, for example) are cached. If you are familiar with
537 537 Mathematica, IPython's _ variables behave exactly like Mathematica's %
538 538 variables.
539 539
540 540 The following GLOBAL variables always exist (so don't overwrite them!):
541 541 _ (one underscore): previous output.
542 542 __ (two underscores): next previous.
543 543 ___ (three underscores): next-next previous.
544 544
545 545 Global variables named _<n> are dynamically created (<n> being the prompt
546 546 counter), such that the result of output <n> is always available as _<n>.
547 547
548 548 Finally, a global dictionary named _oh exists with entries for all lines
549 549 which generated output.
550 550
551 551 * Directory history:
552 552
553 553 Your history of visited directories is kept in the global list _dh, and the
554 554 magic %cd command can be used to go to any entry in that list.
555 555
556 556 * Auto-parentheses and auto-quotes (adapted from Nathan Gray's LazyPython)
557 557
558 558 1. Auto-parentheses
559 559 Callable objects (i.e. functions, methods, etc) can be invoked like
560 560 this (notice the commas between the arguments):
561 561 >>> callable_ob arg1, arg2, arg3
562 562 and the input will be translated to this:
563 563 --> callable_ob(arg1, arg2, arg3)
564 564 You can force auto-parentheses by using '/' as the first character
565 565 of a line. For example:
566 566 >>> /globals # becomes 'globals()'
567 567 Note that the '/' MUST be the first character on the line! This
568 568 won't work:
569 569 >>> print /globals # syntax error
570 570
571 571 In most cases the automatic algorithm should work, so you should
572 572 rarely need to explicitly invoke /. One notable exception is if you
573 573 are trying to call a function with a list of tuples as arguments (the
574 574 parenthesis will confuse IPython):
575 575 In [1]: zip (1,2,3),(4,5,6) # won't work
576 576 but this will work:
577 577 In [2]: /zip (1,2,3),(4,5,6)
578 578 ------> zip ((1,2,3),(4,5,6))
579 579 Out[2]= [(1, 4), (2, 5), (3, 6)]
580 580
581 581 IPython tells you that it has altered your command line by
582 582 displaying the new command line preceded by -->. e.g.:
583 583 In [18]: callable list
584 584 -------> callable (list)
585 585
586 586 2. Auto-Quoting
587 587 You can force auto-quoting of a function's arguments by using ',' as
588 588 the first character of a line. For example:
589 589 >>> ,my_function /home/me # becomes my_function("/home/me")
590 590
591 591 If you use ';' instead, the whole argument is quoted as a single
592 592 string (while ',' splits on whitespace):
593 593 >>> ,my_function a b c # becomes my_function("a","b","c")
594 594 >>> ;my_function a b c # becomes my_function("a b c")
595 595
596 596 Note that the ',' MUST be the first character on the line! This
597 597 won't work:
598 598 >>> x = ,my_function /home/me # syntax error
599 599 """
600 600
601 601 quick_reference = r"""
602 602 IPython -- An enhanced Interactive Python - Quick Reference Card
603 603 ================================================================
604 604
605 605 obj?, obj??, ?obj,??obj : Get help, or more help for object
606 606 ?os.p* : List names in os starting with p
607 607
608 608 Example magic:
609 609
610 610 %alias d ls -F : 'd' is now an alias for 'ls -F'
611 611 alias d ls -F : Works if 'alias' not a python name
612 612 alist = %alias : Get list of aliases to 'alist'
613 613
614 614 System commands:
615 615
616 616 !cp a.txt b/ : System command escape, calls os.system()
617 617 cp a.txt b/ : after %rehashx, most system commands work without !
618 618 cp ${f}.txt $bar : Variable expansion in magics and system commands
619 619 files = !ls /usr : Capture sytem command output
620 620 files.s, files.l, files.n: "a b c", ['a','b','c'], 'a\nb\nc'
621 621 cd /usr/share : Obvious, also 'cd d:\home\_ipython' works
622 622
623 623 History:
624 624
625 625 _i, _ii, _iii : Previous, next previous, next next previous input
626 626 _i4, _ih[2:5] : Input history line 4, lines 2-4
627 627 exec _i81 : Execute input history line #81 again
628 628 _, __, ___ : previous, next previous, next next previous output
629 629 _dh : Directory history
630 630 _oh : Output history
631 631 %hist : Command history
632 632
633 633 Autocall:
634 634
635 635 f 1,2 : f(1,2)
636 636 /f 1,2 : f(1,2) (forced autoparen)
637 637 ,f 1 2 : f("1","2")
638 638 ;f 1 2 : f("1 2")
639 639
640 640 """
641 641
642 642
@@ -1,6327 +1,6332 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
4 9 to quiet a deprecation warning that fires with Wx 2.8. Thanks to
5 10 a report by Nik Tautenhahn.
6 11
7 12 2007-03-16 Walter Doerwald <walter@livinglogic.de>
8 13
9 14 * setup.py: Add the igrid help files to the list of data files
10 15 to be installed alongside igrid.
11 16 * IPython/Extensions/igrid.py: (Patch by Nik Tautenhahn)
12 17 Show the input object of the igrid browser as the window tile.
13 18 Show the object the cursor is on in the statusbar.
14 19
15 20 2007-03-15 Ville Vainio <vivainio@gmail.com>
16 21
17 22 * Extensions/ipy_stock_completers.py: Fixed exception
18 23 on mismatching quotes in %run completer. Patch by
19 24 J�rgen Stenarson. Closes #127.
20 25
21 26 2007-03-14 Ville Vainio <vivainio@gmail.com>
22 27
23 28 * Extensions/ext_rehashdir.py: Do not do auto_alias
24 29 in %rehashdir, it clobbers %store'd aliases.
25 30
26 31 * UserConfig/ipy_profile_sh.py: envpersist.py extension
27 32 (beefed up %env) imported for sh profile.
28 33
29 34 2007-03-10 Walter Doerwald <walter@livinglogic.de>
30 35
31 36 * IPython/Extensions/ipipe.py: Prefer ibrowse over igrid
32 37 as the default browser.
33 38 * IPython/Extensions/igrid.py: Make a few igrid attributes private.
34 39 As igrid displays all attributes it ever encounters, fetch() (which has
35 40 been renamed to _fetch()) doesn't have to recalculate the display attributes
36 41 every time a new item is fetched. This should speed up scrolling.
37 42
38 43 2007-03-10 Fernando Perez <Fernando.Perez@colorado.edu>
39 44
40 45 * IPython/iplib.py (InteractiveShell.__init__): fix for Alex
41 46 Schmolck's recently reported tab-completion bug (my previous one
42 47 had a problem). Patch by Dan Milstein <danmil-AT-comcast.net>.
43 48
44 49 2007-03-09 Walter Doerwald <walter@livinglogic.de>
45 50
46 51 * IPython/Extensions/igrid.py: Patch by Nik Tautenhahn:
47 52 Close help window if exiting igrid.
48 53
49 54 2007-03-02 J�rgen Stenarson <jorgen.stenarson@bostream.nu>
50 55
51 56 * IPython/Extensions/ipy_defaults.py: Check if readline is available
52 57 before calling functions from readline.
53 58
54 59 2007-03-02 Walter Doerwald <walter@livinglogic.de>
55 60
56 61 * IPython/Extensions/igrid.py: Add Nik Tautenhahns igrid extension.
57 62 igrid is a wxPython-based display object for ipipe. If your system has
58 63 wx installed igrid will be the default display. Without wx ipipe falls
59 64 back to ibrowse (which needs curses). If no curses is installed ipipe
60 65 falls back to idump.
61 66
62 67 2007-03-01 Fernando Perez <Fernando.Perez@colorado.edu>
63 68
64 69 * IPython/iplib.py (split_user_inputBROKEN): temporarily disable
65 70 my changes from yesterday, they introduced bugs. Will reactivate
66 71 once I get a correct solution, which will be much easier thanks to
67 72 Dan Milstein's new prefilter test suite.
68 73
69 74 2007-02-28 Fernando Perez <Fernando.Perez@colorado.edu>
70 75
71 76 * IPython/iplib.py (split_user_input): fix input splitting so we
72 77 don't attempt attribute accesses on things that can't possibly be
73 78 valid Python attributes. After a bug report by Alex Schmolck.
74 79 (InteractiveShell.__init__): brown-paper bag fix; regexp broke
75 80 %magic with explicit % prefix.
76 81
77 82 2007-02-27 Fernando Perez <Fernando.Perez@colorado.edu>
78 83
79 84 * IPython/Shell.py (IPShellGTK.mainloop): update threads calls to
80 85 avoid a DeprecationWarning from GTK.
81 86
82 87 2007-02-22 Fernando Perez <Fernando.Perez@colorado.edu>
83 88
84 89 * IPython/genutils.py (clock): I modified clock() to return total
85 90 time, user+system. This is a more commonly needed metric. I also
86 91 introduced the new clocku/clocks to get only user/system time if
87 92 one wants those instead.
88 93
89 94 ***WARNING: API CHANGE*** clock() used to return only user time,
90 95 so if you want exactly the same results as before, use clocku
91 96 instead.
92 97
93 98 2007-02-22 Ville Vainio <vivainio@gmail.com>
94 99
95 100 * IPython/Extensions/ipy_p4.py: Extension for improved
96 101 p4 (perforce version control system) experience.
97 102 Adds %p4 magic with p4 command completion and
98 103 automatic -G argument (marshall output as python dict)
99 104
100 105 2007-02-19 Fernando Perez <Fernando.Perez@colorado.edu>
101 106
102 107 * IPython/demo.py (Demo.re_stop): make dashes optional in demo
103 108 stop marks.
104 109 (ClearingMixin): a simple mixin to easily make a Demo class clear
105 110 the screen in between blocks and have empty marquees. The
106 111 ClearDemo and ClearIPDemo classes that use it are included.
107 112
108 113 2007-02-18 Fernando Perez <Fernando.Perez@colorado.edu>
109 114
110 115 * IPython/irunner.py (pexpect_monkeypatch): patch pexpect to
111 116 protect against exceptions at Python shutdown time. Patch
112 117 sumbmitted to upstream.
113 118
114 119 2007-02-14 Walter Doerwald <walter@livinglogic.de>
115 120
116 121 * IPython/Extensions/ibrowse.py: If entering the first object level
117 122 (i.e. the object for which the browser has been started) fails,
118 123 now the error is raised directly (aborting the browser) instead of
119 124 running into an empty levels list later.
120 125
121 126 2007-02-03 Walter Doerwald <walter@livinglogic.de>
122 127
123 128 * IPython/Extensions/ipipe.py: Add an xrepr implementation
124 129 for the noitem object.
125 130
126 131 2007-01-31 Fernando Perez <Fernando.Perez@colorado.edu>
127 132
128 133 * IPython/completer.py (Completer.attr_matches): Fix small
129 134 tab-completion bug with Enthought Traits objects with units.
130 135 Thanks to a bug report by Tom Denniston
131 136 <tom.denniston-AT-alum.dartmouth.org>.
132 137
133 138 2007-01-27 Fernando Perez <Fernando.Perez@colorado.edu>
134 139
135 140 * IPython/Extensions/ipy_stock_completers.py (runlistpy): fix a
136 141 bug where only .ipy or .py would be completed. Once the first
137 142 argument to %run has been given, all completions are valid because
138 143 they are the arguments to the script, which may well be non-python
139 144 filenames.
140 145
141 146 * IPython/irunner.py (InteractiveRunner.run_source): major updates
142 147 to irunner to allow it to correctly support real doctesting of
143 148 out-of-process ipython code.
144 149
145 150 * IPython/Magic.py (magic_cd): Make the setting of the terminal
146 151 title an option (-noterm_title) because it completely breaks
147 152 doctesting.
148 153
149 154 * IPython/demo.py: fix IPythonDemo class that was not actually working.
150 155
151 156 2007-01-24 Fernando Perez <Fernando.Perez@colorado.edu>
152 157
153 158 * IPython/irunner.py (main): fix small bug where extensions were
154 159 not being correctly recognized.
155 160
156 161 2007-01-23 Walter Doerwald <walter@livinglogic.de>
157 162
158 163 * IPython/Extensions/ipipe.py (xiter): Make sure that iterating
159 164 a string containing a single line yields the string itself as the
160 165 only item.
161 166
162 167 * IPython/Extensions/ibrowse.py (ibrowse): Avoid entering an
163 168 object if it's the same as the one on the last level (This avoids
164 169 infinite recursion for one line strings).
165 170
166 171 2007-01-17 Fernando Perez <Fernando.Perez@colorado.edu>
167 172
168 173 * IPython/ultraTB.py (AutoFormattedTB.__call__): properly flush
169 174 all output streams before printing tracebacks. This ensures that
170 175 user output doesn't end up interleaved with traceback output.
171 176
172 177 2007-01-10 Ville Vainio <vivainio@gmail.com>
173 178
174 179 * Extensions/envpersist.py: Turbocharged %env that remembers
175 180 env vars across sessions; e.g. "%env PATH+=;/opt/scripts" or
176 181 "%env VISUAL=jed".
177 182
178 183 2007-01-05 Fernando Perez <Fernando.Perez@colorado.edu>
179 184
180 185 * IPython/iplib.py (showtraceback): ensure that we correctly call
181 186 custom handlers in all cases (some with pdb were slipping through,
182 187 but I'm not exactly sure why).
183 188
184 189 * IPython/Debugger.py (Tracer.__init__): added new class to
185 190 support set_trace-like usage of IPython's enhanced debugger.
186 191
187 192 2006-12-24 Ville Vainio <vivainio@gmail.com>
188 193
189 194 * ipmaker.py: more informative message when ipy_user_conf
190 195 import fails (suggest running %upgrade).
191 196
192 197 * tools/run_ipy_in_profiler.py: Utility to see where
193 198 the time during IPython startup is spent.
194 199
195 200 2006-12-20 Ville Vainio <vivainio@gmail.com>
196 201
197 202 * 0.7.3 is out - merge all from 0.7.3 branch to trunk
198 203
199 204 * ipapi.py: Add new ipapi method, expand_alias.
200 205
201 206 * Release.py: Bump up version to 0.7.4.svn
202 207
203 208 2006-12-17 Ville Vainio <vivainio@gmail.com>
204 209
205 210 * Extensions/jobctrl.py: Fixed &cmd arg arg...
206 211 to work properly on posix too
207 212
208 213 * Release.py: Update revnum (version is still just 0.7.3).
209 214
210 215 2006-12-15 Ville Vainio <vivainio@gmail.com>
211 216
212 217 * scripts/ipython_win_post_install: create ipython.py in
213 218 prefix + "/scripts".
214 219
215 220 * Release.py: Update version to 0.7.3.
216 221
217 222 2006-12-14 Ville Vainio <vivainio@gmail.com>
218 223
219 224 * scripts/ipython_win_post_install: Overwrite old shortcuts
220 225 if they already exist
221 226
222 227 * Release.py: release 0.7.3rc2
223 228
224 229 2006-12-13 Ville Vainio <vivainio@gmail.com>
225 230
226 231 * Branch and update Release.py for 0.7.3rc1
227 232
228 233 2006-12-13 Fernando Perez <Fernando.Perez@colorado.edu>
229 234
230 235 * IPython/Shell.py (IPShellWX): update for current WX naming
231 236 conventions, to avoid a deprecation warning with current WX
232 237 versions. Thanks to a report by Danny Shevitz.
233 238
234 239 2006-12-12 Ville Vainio <vivainio@gmail.com>
235 240
236 241 * ipmaker.py: apply david cournapeau's patch to make
237 242 import_some work properly even when ipythonrc does
238 243 import_some on empty list (it was an old bug!).
239 244
240 245 * UserConfig/ipy_user_conf.py, UserConfig/ipythonrc:
241 246 Add deprecation note to ipythonrc and a url to wiki
242 247 in ipy_user_conf.py
243 248
244 249
245 250 * Magic.py (%run): %run myscript.ipy now runs myscript.ipy
246 251 as if it was typed on IPython command prompt, i.e.
247 252 as IPython script.
248 253
249 254 * example-magic.py, magic_grepl.py: remove outdated examples
250 255
251 256 2006-12-11 Fernando Perez <Fernando.Perez@colorado.edu>
252 257
253 258 * IPython/iplib.py (debugger): prevent a nasty traceback if %debug
254 259 is called before any exception has occurred.
255 260
256 261 2006-12-08 Ville Vainio <vivainio@gmail.com>
257 262
258 263 * Extensions/ipy_stock_completers.py: fix cd completer
259 264 to translate /'s to \'s again.
260 265
261 266 * completer.py: prevent traceback on file completions w/
262 267 backslash.
263 268
264 269 * Release.py: Update release number to 0.7.3b3 for release
265 270
266 271 2006-12-07 Ville Vainio <vivainio@gmail.com>
267 272
268 273 * Extensions/ipy_signals.py: Ignore ctrl+C in IPython process
269 274 while executing external code. Provides more shell-like behaviour
270 275 and overall better response to ctrl + C / ctrl + break.
271 276
272 277 * tools/make_tarball.py: new script to create tarball straight from svn
273 278 (setup.py sdist doesn't work on win32).
274 279
275 280 * Extensions/ipy_stock_completers.py: fix cd completer to give up
276 281 on dirnames with spaces and use the default completer instead.
277 282
278 283 * Revision.py: Change version to 0.7.3b2 for release.
279 284
280 285 2006-12-05 Ville Vainio <vivainio@gmail.com>
281 286
282 287 * Magic.py, iplib.py, completer.py: Apply R. Bernstein's
283 288 pydb patch 4 (rm debug printing, py 2.5 checking)
284 289
285 290 2006-11-30 Walter Doerwald <walter@livinglogic.de>
286 291 * IPython/Extensions/ibrowse.py: Add two new commands to ibrowse:
287 292 "refresh" (mapped to "r") refreshes the screen by restarting the iterator.
288 293 "refreshfind" (mapped to "R") does the same but tries to go back to the same
289 294 object the cursor was on before the refresh. The command "markrange" is
290 295 mapped to "%" now.
291 296 * IPython/Extensions/ibrowse.py: Make igrpentry and ipwdentry comparable.
292 297
293 298 2006-11-29 Fernando Perez <Fernando.Perez@colorado.edu>
294 299
295 300 * IPython/Magic.py (magic_debug): new %debug magic to activate the
296 301 interactive debugger on the last traceback, without having to call
297 302 %pdb and rerun your code. Made minor changes in various modules,
298 303 should automatically recognize pydb if available.
299 304
300 305 2006-11-28 Ville Vainio <vivainio@gmail.com>
301 306
302 307 * completer.py: If the text start with !, show file completions
303 308 properly. This helps when trying to complete command name
304 309 for shell escapes.
305 310
306 311 2006-11-27 Ville Vainio <vivainio@gmail.com>
307 312
308 313 * ipy_stock_completers.py: bzr completer submitted by Stefan van
309 314 der Walt. Clean up svn and hg completers by using a common
310 315 vcs_completer.
311 316
312 317 2006-11-26 Ville Vainio <vivainio@gmail.com>
313 318
314 319 * Remove ipconfig and %config; you should use _ip.options structure
315 320 directly instead!
316 321
317 322 * genutils.py: add wrap_deprecated function for deprecating callables
318 323
319 324 * iplib.py: deprecate ipmagic, ipsystem, ipalias. Use _ip.magic and
320 325 _ip.system instead. ipalias is redundant.
321 326
322 327 * Magic.py: %rehashdir no longer aliases 'cmdname' to 'cmdname.exe' on
323 328 win32, but just 'cmdname'. Other extensions (non-'exe') are still made
324 329 explicit.
325 330
326 331 * ipy_stock_completers.py: 'hg' (mercurial VCS) now has a custom
327 332 completer. Try it by entering 'hg ' and pressing tab.
328 333
329 334 * macro.py: Give Macro a useful __repr__ method
330 335
331 336 * Magic.py: %whos abbreviates the typename of Macro for brevity.
332 337
333 338 2006-11-24 Walter Doerwald <walter@livinglogic.de>
334 339 * IPython/Extensions/astyle.py: Do a relative import of ipipe, so that
335 340 we don't get a duplicate ipipe module, where registration of the xrepr
336 341 implementation for Text is useless.
337 342
338 343 * IPython/Extensions/ipipe.py: Fix __xrepr__() implementation for ils.
339 344
340 345 * IPython/Extensions/ibrowse.py: Fix keymapping for the enter command.
341 346
342 347 2006-11-24 Ville Vainio <vivainio@gmail.com>
343 348
344 349 * Magic.py, manual_base.lyx: Kirill Smelkov patch:
345 350 try to use "cProfile" instead of the slower pure python
346 351 "profile"
347 352
348 353 2006-11-23 Ville Vainio <vivainio@gmail.com>
349 354
350 355 * manual_base.lyx: Kirill Smelkov patch: Fix wrong
351 356 Qt+IPython+Designer link in documentation.
352 357
353 358 * Extensions/ipy_pydb.py: R. Bernstein's patch for passing
354 359 correct Pdb object to %pydb.
355 360
356 361
357 362 2006-11-22 Walter Doerwald <walter@livinglogic.de>
358 363 * IPython/Extensions/astyle.py: Text needs it's own implemenation of the
359 364 generic xrepr(), otherwise the list implementation would kick in.
360 365
361 366 2006-11-21 Ville Vainio <vivainio@gmail.com>
362 367
363 368 * upgrade_dir.py: Now actually overwrites a nonmodified user file
364 369 with one from UserConfig.
365 370
366 371 * ipy_profile_sh.py: Add dummy "depth" to var_expand lambda,
367 372 it was missing which broke the sh profile.
368 373
369 374 * completer.py: file completer now uses explicit '/' instead
370 375 of os.path.join, expansion of 'foo' was broken on win32
371 376 if there was one directory with name 'foobar'.
372 377
373 378 * A bunch of patches from Kirill Smelkov:
374 379
375 380 * [patch 9/9] doc: point bug-tracker URL to IPythons trac-tickets.
376 381
377 382 * [patch 7/9] Implement %page -r (page in raw mode) -
378 383
379 384 * [patch 5/9] ScientificPython webpage has moved
380 385
381 386 * [patch 4/9] The manual mentions %ds, should be %dhist
382 387
383 388 * [patch 3/9] Kill old bits from %prun doc.
384 389
385 390 * [patch 1/9] Fix typos here and there.
386 391
387 392 2006-11-08 Ville Vainio <vivainio@gmail.com>
388 393
389 394 * completer.py (attr_matches): catch all exceptions raised
390 395 by eval of expr with dots.
391 396
392 397 2006-11-07 Fernando Perez <Fernando.Perez@colorado.edu>
393 398
394 399 * IPython/iplib.py (runsource): Prepend an 'if 1:' to the user
395 400 input if it starts with whitespace. This allows you to paste
396 401 indented input from any editor without manually having to type in
397 402 the 'if 1:', which is convenient when working interactively.
398 403 Slightly modifed version of a patch by Bo Peng
399 404 <bpeng-AT-rice.edu>.
400 405
401 406 2006-11-03 Fernando Perez <Fernando.Perez@colorado.edu>
402 407
403 408 * IPython/irunner.py (main): modified irunner so it automatically
404 409 recognizes the right runner to use based on the extension (.py for
405 410 python, .ipy for ipython and .sage for sage).
406 411
407 412 * IPython/iplib.py (InteractiveShell.ipconfig): new builtin, also
408 413 visible in ipapi as ip.config(), to programatically control the
409 414 internal rc object. There's an accompanying %config magic for
410 415 interactive use, which has been enhanced to match the
411 416 funtionality in ipconfig.
412 417
413 418 * IPython/Magic.py (magic_system_verbose): Change %system_verbose
414 419 so it's not just a toggle, it now takes an argument. Add support
415 420 for a customizable header when making system calls, as the new
416 421 system_header variable in the ipythonrc file.
417 422
418 423 2006-11-03 Walter Doerwald <walter@livinglogic.de>
419 424
420 425 * IPython/Extensions/ipipe.py: xrepr(), xiter() and xattrs() are now
421 426 generic functions (using Philip J. Eby's simplegeneric package).
422 427 This makes it possible to customize the display of third-party classes
423 428 without having to monkeypatch them. xiter() no longer supports a mode
424 429 argument and the XMode class has been removed. The same functionality can
425 430 be implemented via IterAttributeDescriptor and IterMethodDescriptor.
426 431 One consequence of the switch to generic functions is that xrepr() and
427 432 xattrs() implementation must define the default value for the mode
428 433 argument themselves and xattrs() implementations must return real
429 434 descriptors.
430 435
431 436 * IPython/external: This new subpackage will contain all third-party
432 437 packages that are bundled with IPython. (The first one is simplegeneric).
433 438
434 439 * IPython/Extensions/ipipe.py (ifile/ils): Readd output of the parent
435 440 directory which as been dropped in r1703.
436 441
437 442 * IPython/Extensions/ipipe.py (iless): Fixed.
438 443
439 444 * IPython/Extensions/ibrowse: Fixed sorting under Python 2.3.
440 445
441 446 2006-11-03 Fernando Perez <Fernando.Perez@colorado.edu>
442 447
443 448 * IPython/iplib.py (InteractiveShell.var_expand): fix stack
444 449 handling in variable expansion so that shells and magics recognize
445 450 function local scopes correctly. Bug reported by Brian.
446 451
447 452 * scripts/ipython: remove the very first entry in sys.path which
448 453 Python auto-inserts for scripts, so that sys.path under IPython is
449 454 as similar as possible to that under plain Python.
450 455
451 456 * IPython/completer.py (IPCompleter.file_matches): Fix
452 457 tab-completion so that quotes are not closed unless the completion
453 458 is unambiguous. After a request by Stefan. Minor cleanups in
454 459 ipy_stock_completers.
455 460
456 461 2006-11-02 Ville Vainio <vivainio@gmail.com>
457 462
458 463 * ipy_stock_completers.py: Add %run and %cd completers.
459 464
460 465 * completer.py: Try running custom completer for both
461 466 "foo" and "%foo" if the command is just "foo". Ignore case
462 467 when filtering possible completions.
463 468
464 469 * UserConfig/ipy_user_conf.py: install stock completers as default
465 470
466 471 * iplib.py (history_saving_wrapper), debugger(), ipy_pydb.py:
467 472 simplified readline history save / restore through a wrapper
468 473 function
469 474
470 475
471 476 2006-10-31 Ville Vainio <vivainio@gmail.com>
472 477
473 478 * strdispatch.py, completer.py, ipy_stock_completers.py:
474 479 Allow str_key ("command") in completer hooks. Implement
475 480 trivial completer for 'import' (stdlib modules only). Rename
476 481 ipy_linux_package_managers.py to ipy_stock_completers.py.
477 482 SVN completer.
478 483
479 484 * Extensions/ledit.py: %magic line editor for easily and
480 485 incrementally manipulating lists of strings. The magic command
481 486 name is %led.
482 487
483 488 2006-10-30 Ville Vainio <vivainio@gmail.com>
484 489
485 490 * Debugger.py, iplib.py (debugger()): Add last set of Rocky
486 491 Bernsteins's patches for pydb integration.
487 492 http://bashdb.sourceforge.net/pydb/
488 493
489 494 * strdispatch.py, iplib.py, completer.py, IPython/__init__.py,
490 495 Extensions/ipy_linux_package_managers.py, hooks.py: Implement
491 496 custom completer hook to allow the users to implement their own
492 497 completers. See ipy_linux_package_managers.py for example. The
493 498 hook name is 'complete_command'.
494 499
495 500 2006-10-28 Fernando Perez <Fernando.Perez@colorado.edu>
496 501
497 502 * IPython/UserConfig/ipythonrc-scipy: minor cleanups to remove old
498 503 Numeric leftovers.
499 504
500 505 * ipython.el (py-execute-region): apply Stefan's patch to fix
501 506 garbled results if the python shell hasn't been previously started.
502 507
503 508 * IPython/genutils.py (arg_split): moved to genutils, since it's a
504 509 pretty generic function and useful for other things.
505 510
506 511 * IPython/OInspect.py (getsource): Add customizable source
507 512 extractor. After a request/patch form W. Stein (SAGE).
508 513
509 514 * IPython/irunner.py (InteractiveRunner.run_source): reset tty
510 515 window size to a more reasonable value from what pexpect does,
511 516 since their choice causes wrapping bugs with long input lines.
512 517
513 518 2006-10-28 Ville Vainio <vivainio@gmail.com>
514 519
515 520 * Magic.py (%run): Save and restore the readline history from
516 521 file around %run commands to prevent side effects from
517 522 %runned programs that might use readline (e.g. pydb).
518 523
519 524 * extensions/ipy_pydb.py: Adds %pydb magic when imported, for
520 525 invoking the pydb enhanced debugger.
521 526
522 527 2006-10-23 Walter Doerwald <walter@livinglogic.de>
523 528
524 529 * IPython/Extensions/ipipe.py (ifile): Remove all methods that
525 530 call the base class method and propagate the return value to
526 531 ifile. This is now done by path itself.
527 532
528 533 2006-10-15 Fernando Perez <Fernando.Perez@colorado.edu>
529 534
530 535 * IPython/ipapi.py (IPApi.__init__): Added new entry to public
531 536 api: set_crash_handler(), to expose the ability to change the
532 537 internal crash handler.
533 538
534 539 * IPython/CrashHandler.py (CrashHandler.__init__): abstract out
535 540 the various parameters of the crash handler so that apps using
536 541 IPython as their engine can customize crash handling. Ipmlemented
537 542 at the request of SAGE.
538 543
539 544 2006-10-14 Ville Vainio <vivainio@gmail.com>
540 545
541 546 * Magic.py, ipython.el: applied first "safe" part of Rocky
542 547 Bernstein's patch set for pydb integration.
543 548
544 549 * Magic.py (%unalias, %alias): %store'd aliases can now be
545 550 removed with '%unalias'. %alias w/o args now shows most
546 551 interesting (stored / manually defined) aliases last
547 552 where they catch the eye w/o scrolling.
548 553
549 554 * Magic.py (%rehashx), ext_rehashdir.py: files with
550 555 'py' extension are always considered executable, even
551 556 when not in PATHEXT environment variable.
552 557
553 558 2006-10-12 Ville Vainio <vivainio@gmail.com>
554 559
555 560 * jobctrl.py: Add new "jobctrl" extension for spawning background
556 561 processes with "&find /". 'import jobctrl' to try it out. Requires
557 562 'subprocess' module, standard in python 2.4+.
558 563
559 564 * iplib.py (expand_aliases, handle_alias): Aliases expand transitively,
560 565 so if foo -> bar and bar -> baz, then foo -> baz.
561 566
562 567 2006-10-09 Fernando Perez <Fernando.Perez@colorado.edu>
563 568
564 569 * IPython/Magic.py (Magic.parse_options): add a new posix option
565 570 to allow parsing of input args in magics that doesn't strip quotes
566 571 (if posix=False). This also closes %timeit bug reported by
567 572 Stefan.
568 573
569 574 2006-10-03 Ville Vainio <vivainio@gmail.com>
570 575
571 576 * iplib.py (raw_input, interact): Return ValueError catching for
572 577 raw_input. Fixes infinite loop for sys.stdin.close() or
573 578 sys.stdout.close().
574 579
575 580 2006-09-27 Fernando Perez <Fernando.Perez@colorado.edu>
576 581
577 582 * IPython/irunner.py (InteractiveRunner.run_source): small fixes
578 583 to help in handling doctests. irunner is now pretty useful for
579 584 running standalone scripts and simulate a full interactive session
580 585 in a format that can be then pasted as a doctest.
581 586
582 587 * IPython/iplib.py (InteractiveShell.__init__): Install exit/quit
583 588 on top of the default (useless) ones. This also fixes the nasty
584 589 way in which 2.5's Quitter() exits (reverted [1785]).
585 590
586 591 * IPython/Debugger.py (Pdb.__init__): Fix ipdb to work with python
587 592 2.5.
588 593
589 594 * IPython/ultraTB.py (TBTools.set_colors): Make sure that ipdb
590 595 color scheme is updated as well when color scheme is changed
591 596 interactively.
592 597
593 598 2006-09-27 Ville Vainio <vivainio@gmail.com>
594 599
595 600 * iplib.py (raw_input): python 2.5 closes stdin on quit -> avoid
596 601 infinite loop and just exit. It's a hack, but will do for a while.
597 602
598 603 2006-08-25 Walter Doerwald <walter@livinglogic.de>
599 604
600 605 * IPython/Extensions/ipipe.py (ils): Add arguments dirs and files to
601 606 the constructor, this makes it possible to get a list of only directories
602 607 or only files.
603 608
604 609 2006-08-12 Ville Vainio <vivainio@gmail.com>
605 610
606 611 * Fakemodule.py, OInspect.py: Reverted 2006-08-11 mods,
607 612 they broke unittest
608 613
609 614 2006-08-11 Ville Vainio <vivainio@gmail.com>
610 615
611 616 * Fakemodule.py, OInspect.py: remove 2006-08-09 monkepatch
612 617 by resolving issue properly, i.e. by inheriting FakeModule
613 618 from types.ModuleType. Pickling ipython interactive data
614 619 should still work as usual (testing appreciated).
615 620
616 621 2006-08-09 Fernando Perez <Fernando.Perez@colorado.edu>
617 622
618 623 * IPython/OInspect.py: monkeypatch inspect from the stdlib if
619 624 running under python 2.3 with code from 2.4 to fix a bug with
620 625 help(). Reported by the Debian maintainers, Norbert Tretkowski
621 626 <norbert-AT-tretkowski.de> and Alexandre Fayolle
622 627 <afayolle-AT-debian.org>.
623 628
624 629 2006-08-04 Walter Doerwald <walter@livinglogic.de>
625 630
626 631 * IPython/Extensions/ibrowse.py: Fixed the help message in the footer
627 632 (which was displaying "quit" twice).
628 633
629 634 2006-07-28 Walter Doerwald <walter@livinglogic.de>
630 635
631 636 * IPython/Extensions/ipipe.py: Fix isort.__iter__() (was still using
632 637 the mode argument).
633 638
634 639 2006-07-27 Walter Doerwald <walter@livinglogic.de>
635 640
636 641 * IPython/Extensions/ipipe.py: Fix getglobals() if we're
637 642 not running under IPython.
638 643
639 644 * IPython/Extensions/ipipe.py: Rename XAttr to AttributeDetail
640 645 and make it iterable (iterating over the attribute itself). Add two new
641 646 magic strings for __xattrs__(): If the string starts with "-", the attribute
642 647 will not be displayed in ibrowse's detail view (but it can still be
643 648 iterated over). This makes it possible to add attributes that are large
644 649 lists or generator methods to the detail view. Replace magic attribute names
645 650 and _attrname() and _getattr() with "descriptors": For each type of magic
646 651 attribute name there's a subclass of Descriptor: None -> SelfDescriptor();
647 652 "foo" -> AttributeDescriptor("foo"); "foo()" -> MethodDescriptor("foo");
648 653 "-foo" -> IterAttributeDescriptor("foo"); "-foo()" -> IterMethodDescriptor("foo");
649 654 foo() -> FunctionDescriptor(foo). Magic strings returned from __xattrs__()
650 655 are still supported.
651 656
652 657 * IPython/Extensions/ibrowse.py: If fetching the next row from the input
653 658 fails in ibrowse.fetch(), the exception object is added as the last item
654 659 and item fetching is canceled. This prevents ibrowse from aborting if e.g.
655 660 a generator throws an exception midway through execution.
656 661
657 662 * IPython/Extensions/ipipe.py: Turn ifile's properties mimetype and
658 663 encoding into methods.
659 664
660 665 2006-07-26 Ville Vainio <vivainio@gmail.com>
661 666
662 667 * iplib.py: history now stores multiline input as single
663 668 history entries. Patch by Jorgen Cederlof.
664 669
665 670 2006-07-18 Walter Doerwald <walter@livinglogic.de>
666 671
667 672 * IPython/Extensions/ibrowse.py: Make cursor visible over
668 673 non existing attributes.
669 674
670 675 2006-07-14 Walter Doerwald <walter@livinglogic.de>
671 676
672 677 * IPython/Extensions/ipipe.py (ix): Use os.popen4() so that the
673 678 error output of the running command doesn't mess up the screen.
674 679
675 680 2006-07-13 Walter Doerwald <walter@livinglogic.de>
676 681
677 682 * IPython/Extensions/ipipe.py (isort): Make isort usable without
678 683 argument. This sorts the items themselves.
679 684
680 685 2006-07-12 Walter Doerwald <walter@livinglogic.de>
681 686
682 687 * IPython/Extensions/ipipe.py (eval, ifilter, isort, ieval):
683 688 Compile expression strings into code objects. This should speed
684 689 up ifilter and friends somewhat.
685 690
686 691 2006-07-08 Ville Vainio <vivainio@gmail.com>
687 692
688 693 * Magic.py: %cpaste now strips > from the beginning of lines
689 694 to ease pasting quoted code from emails. Contributed by
690 695 Stefan van der Walt.
691 696
692 697 2006-06-29 Ville Vainio <vivainio@gmail.com>
693 698
694 699 * ipmaker.py, Shell.py: qt4agg matplotlib backend support for pylab
695 700 mode, patch contributed by Darren Dale. NEEDS TESTING!
696 701
697 702 2006-06-28 Walter Doerwald <walter@livinglogic.de>
698 703
699 704 * IPython/Extensions/ibrowse.py: Give the ibrowse cursor row
700 705 a blue background. Fix fetching new display rows when the browser
701 706 scrolls more than a screenful (e.g. by using the goto command).
702 707
703 708 2006-06-27 Ville Vainio <vivainio@gmail.com>
704 709
705 710 * Magic.py (_inspect, _ofind) Apply David Huard's
706 711 patch for displaying the correct docstring for 'property'
707 712 attributes.
708 713
709 714 2006-06-23 Walter Doerwald <walter@livinglogic.de>
710 715
711 716 * IPython/Extensions/ibrowse.py: Put the documentation of the keyboard
712 717 commands into the methods implementing them.
713 718
714 719 2006-06-22 Fernando Perez <Fernando.Perez@colorado.edu>
715 720
716 721 * ipython.el (ipython-indentation-hook): cleanup patch, submitted
717 722 by Kov Chai <tchaikov-AT-gmail.com>. He notes that the original
718 723 autoindent support was authored by Jin Liu.
719 724
720 725 2006-06-22 Walter Doerwald <walter@livinglogic.de>
721 726
722 727 * IPython/Extensions/ibrowse.py: Replace the plain dictionaries used
723 728 for keymaps with a custom class that simplifies handling.
724 729
725 730 2006-06-19 Walter Doerwald <walter@livinglogic.de>
726 731
727 732 * IPython/Extensions/ibrowse.py: ibrowse now properly handles terminal
728 733 resizing. This requires Python 2.5 to work.
729 734
730 735 2006-06-16 Walter Doerwald <walter@livinglogic.de>
731 736
732 737 * IPython/Extensions/ibrowse.py: Add two new commands to
733 738 ibrowse: "hideattr" (mapped to "h") hides the attribute under
734 739 the cursor. "unhiderattrs" (mapped to "H") reveals all hidden
735 740 attributes again. Remapped the help command to "?". Display
736 741 keycodes in the range 0x01-0x1F as CTRL-xx. Add CTRL-a and CTRL-e
737 742 as keys for the "home" and "end" commands. Add three new commands
738 743 to the input mode for "find" and friends: "delend" (CTRL-K)
739 744 deletes to the end of line. "incsearchup" searches upwards in the
740 745 command history for an input that starts with the text before the cursor.
741 746 "incsearchdown" does the same downwards. Removed a bogus mapping of
742 747 the x key to "delete".
743 748
744 749 2006-06-15 Ville Vainio <vivainio@gmail.com>
745 750
746 751 * iplib.py, hooks.py: Added new generate_prompt hook that can be
747 752 used to create prompts dynamically, instead of the "old" way of
748 753 assigning "magic" strings to prompt_in1 and prompt_in2. The old
749 754 way still works (it's invoked by the default hook), of course.
750 755
751 756 * Prompts.py: added generate_output_prompt hook for altering output
752 757 prompt
753 758
754 759 * Release.py: Changed version string to 0.7.3.svn.
755 760
756 761 2006-06-15 Walter Doerwald <walter@livinglogic.de>
757 762
758 763 * IPython/Extensions/ibrowse.py: Change _BrowserLevel.moveto() so that
759 764 the call to fetch() always tries to fetch enough data for at least one
760 765 full screen. This makes it possible to simply call moveto(0,0,True) in
761 766 the constructor. Fix typos and removed the obsolete goto attribute.
762 767
763 768 2006-06-12 Ville Vainio <vivainio@gmail.com>
764 769
765 770 * ipy_profile_sh.py: applied Krisha Mohan Gundu's patch for
766 771 allowing $variable interpolation within multiline statements,
767 772 though so far only with "sh" profile for a testing period.
768 773 The patch also enables splitting long commands with \ but it
769 774 doesn't work properly yet.
770 775
771 776 2006-06-12 Walter Doerwald <walter@livinglogic.de>
772 777
773 778 * IPython/Extensions/ibrowse.py (_dodisplay): Display the length of the
774 779 input history and the position of the cursor in the input history for
775 780 the find, findbackwards and goto command.
776 781
777 782 2006-06-10 Walter Doerwald <walter@livinglogic.de>
778 783
779 784 * IPython/Extensions/ibrowse.py: Add a class _CommandInput that
780 785 implements the basic functionality of browser commands that require
781 786 input. Reimplement the goto, find and findbackwards commands as
782 787 subclasses of _CommandInput. Add an input history and keymaps to those
783 788 commands. Add "\r" as a keyboard shortcut for the enterdefault and
784 789 execute commands.
785 790
786 791 2006-06-07 Ville Vainio <vivainio@gmail.com>
787 792
788 793 * iplib.py: ipython mybatch.ipy exits ipython immediately after
789 794 running the batch files instead of leaving the session open.
790 795
791 796 2006-06-07 Fernando Perez <Fernando.Perez@colorado.edu>
792 797
793 798 * IPython/iplib.py (InteractiveShell.__init__): update BSD fix, as
794 799 the original fix was incomplete. Patch submitted by W. Maier.
795 800
796 801 2006-06-07 Ville Vainio <vivainio@gmail.com>
797 802
798 803 * iplib.py,Magic.py, ipmaker.py (magic_rehashx):
799 804 Confirmation prompts can be supressed by 'quiet' option.
800 805 _ip.options.quiet = 1 means "assume yes for all yes/no queries".
801 806
802 807 2006-06-06 *** Released version 0.7.2
803 808
804 809 2006-06-06 Fernando Perez <Fernando.Perez@colorado.edu>
805 810
806 811 * IPython/Release.py (version): Made 0.7.2 final for release.
807 812 Repo tagged and release cut.
808 813
809 814 2006-06-05 Ville Vainio <vivainio@gmail.com>
810 815
811 816 * Magic.py (magic_rehashx): Honor no_alias list earlier in
812 817 %rehashx, to avoid clobbering builtins in ipy_profile_sh.py
813 818
814 819 * upgrade_dir.py: try import 'path' module a bit harder
815 820 (for %upgrade)
816 821
817 822 2006-06-03 Fernando Perez <Fernando.Perez@colorado.edu>
818 823
819 824 * IPython/genutils.py (ask_yes_no): treat EOF as a default answer
820 825 instead of looping 20 times.
821 826
822 827 * IPython/ipmaker.py (make_IPython): honor -ipythondir flag
823 828 correctly at initialization time. Bug reported by Krishna Mohan
824 829 Gundu <gkmohan-AT-gmail.com> on the user list.
825 830
826 831 * IPython/Release.py (version): Mark 0.7.2 version to start
827 832 testing for release on 06/06.
828 833
829 834 2006-05-31 Fernando Perez <Fernando.Perez@colorado.edu>
830 835
831 836 * scripts/irunner: thin script interface so users don't have to
832 837 find the module and call it as an executable, since modules rarely
833 838 live in people's PATH.
834 839
835 840 * IPython/irunner.py (InteractiveRunner.__init__): added
836 841 delaybeforesend attribute to control delays with newer versions of
837 842 pexpect. Thanks to detailed help from pexpect's author, Noah
838 843 Spurrier <noah-AT-noah.org>. Noted how to use the SAGE runner
839 844 correctly (it works in NoColor mode).
840 845
841 846 * IPython/iplib.py (handle_normal): fix nasty crash reported on
842 847 SAGE list, from improper log() calls.
843 848
844 849 2006-05-31 Ville Vainio <vivainio@gmail.com>
845 850
846 851 * upgrade_dir.py, Magic.py (magic_upgrade): call upgrade_dir
847 852 with args in parens to work correctly with dirs that have spaces.
848 853
849 854 2006-05-30 Fernando Perez <Fernando.Perez@colorado.edu>
850 855
851 856 * IPython/Logger.py (Logger.logstart): add option to log raw input
852 857 instead of the processed one. A -r flag was added to the
853 858 %logstart magic used for controlling logging.
854 859
855 860 2006-05-29 Fernando Perez <Fernando.Perez@colorado.edu>
856 861
857 862 * IPython/iplib.py (InteractiveShell.__init__): add check for the
858 863 *BSDs to omit --color from all 'ls' aliases, since *BSD ls doesn't
859 864 recognize the option. After a bug report by Will Maier. This
860 865 closes #64 (will do it after confirmation from W. Maier).
861 866
862 867 * IPython/irunner.py: New module to run scripts as if manually
863 868 typed into an interactive environment, based on pexpect. After a
864 869 submission by Ken Schutte <kschutte-AT-csail.mit.edu> on the
865 870 ipython-user list. Simple unittests in the tests/ directory.
866 871
867 872 * tools/release: add Will Maier, OpenBSD port maintainer, to
868 873 recepients list. We are now officially part of the OpenBSD ports:
869 874 http://www.openbsd.org/ports.html ! Many thanks to Will for the
870 875 work.
871 876
872 877 2006-05-26 Fernando Perez <Fernando.Perez@colorado.edu>
873 878
874 879 * IPython/ipmaker.py (make_IPython): modify sys.argv fix (below)
875 880 so that it doesn't break tkinter apps.
876 881
877 882 * IPython/iplib.py (_prefilter): fix bug where aliases would
878 883 shadow variables when autocall was fully off. Reported by SAGE
879 884 author William Stein.
880 885
881 886 * IPython/OInspect.py (Inspector.__init__): add a flag to control
882 887 at what detail level strings are computed when foo? is requested.
883 888 This allows users to ask for example that the string form of an
884 889 object is only computed when foo?? is called, or even never, by
885 890 setting the object_info_string_level >= 2 in the configuration
886 891 file. This new option has been added and documented. After a
887 892 request by SAGE to be able to control the printing of very large
888 893 objects more easily.
889 894
890 895 2006-05-25 Fernando Perez <Fernando.Perez@colorado.edu>
891 896
892 897 * IPython/ipmaker.py (make_IPython): remove the ipython call path
893 898 from sys.argv, to be 100% consistent with how Python itself works
894 899 (as seen for example with python -i file.py). After a bug report
895 900 by Jeffrey Collins.
896 901
897 902 * IPython/Shell.py (MatplotlibShellBase._matplotlib_config): Fix
898 903 nasty bug which was preventing custom namespaces with -pylab,
899 904 reported by M. Foord. Minor cleanup, remove old matplotlib.matlab
900 905 compatibility (long gone from mpl).
901 906
902 907 * IPython/ipapi.py (make_session): name change: create->make. We
903 908 use make in other places (ipmaker,...), it's shorter and easier to
904 909 type and say, etc. I'm trying to clean things before 0.7.2 so
905 910 that I can keep things stable wrt to ipapi in the chainsaw branch.
906 911
907 912 * ipython.el: fix the py-pdbtrack-input-prompt variable so that
908 913 python-mode recognizes our debugger mode. Add support for
909 914 autoindent inside (X)emacs. After a patch sent in by Jin Liu
910 915 <m.liu.jin-AT-gmail.com> originally written by
911 916 doxgen-AT-newsmth.net (with minor modifications for xemacs
912 917 compatibility)
913 918
914 919 * IPython/Debugger.py (Pdb.format_stack_entry): fix formatting of
915 920 tracebacks when walking the stack so that the stack tracking system
916 921 in emacs' python-mode can identify the frames correctly.
917 922
918 923 * IPython/ipmaker.py (make_IPython): make the internal (and
919 924 default config) autoedit_syntax value false by default. Too many
920 925 users have complained to me (both on and off-list) about problems
921 926 with this option being on by default, so I'm making it default to
922 927 off. It can still be enabled by anyone via the usual mechanisms.
923 928
924 929 * IPython/completer.py (Completer.attr_matches): add support for
925 930 PyCrust-style _getAttributeNames magic method. Patch contributed
926 931 by <mscott-AT-goldenspud.com>. Closes #50.
927 932
928 933 * IPython/iplib.py (InteractiveShell.__init__): remove the
929 934 deletion of exit/quit from __builtin__, which can break
930 935 third-party tools like the Zope debugging console. The
931 936 %exit/%quit magics remain. In general, it's probably a good idea
932 937 not to delete anything from __builtin__, since we never know what
933 938 that will break. In any case, python now (for 2.5) will support
934 939 'real' exit/quit, so this issue is moot. Closes #55.
935 940
936 941 * IPython/genutils.py (with_obj): rename the 'with' function to
937 942 'withobj' to avoid incompatibilities with Python 2.5, where 'with'
938 943 becomes a language keyword. Closes #53.
939 944
940 945 * IPython/FakeModule.py (FakeModule.__init__): add a proper
941 946 __file__ attribute to this so it fools more things into thinking
942 947 it is a real module. Closes #59.
943 948
944 949 * IPython/Magic.py (magic_edit): add -n option to open the editor
945 950 at a specific line number. After a patch by Stefan van der Walt.
946 951
947 952 2006-05-23 Fernando Perez <Fernando.Perez@colorado.edu>
948 953
949 954 * IPython/iplib.py (edit_syntax_error): fix crash when for some
950 955 reason the file could not be opened. After automatic crash
951 956 reports sent by James Graham <jgraham-AT-ast.cam.ac.uk> and
952 957 Charles Dolan <charlespatrickdolan-AT-yahoo.com>.
953 958 (_should_recompile): Don't fire editor if using %bg, since there
954 959 is no file in the first place. From the same report as above.
955 960 (raw_input): protect against faulty third-party prefilters. After
956 961 an automatic crash report sent by Dirk Laurie <dirk-AT-sun.ac.za>
957 962 while running under SAGE.
958 963
959 964 2006-05-23 Ville Vainio <vivainio@gmail.com>
960 965
961 966 * ipapi.py: Stripped down ip.to_user_ns() to work only as
962 967 ip.to_user_ns("x1 y1"), which exposes vars x1 and y1. ipapi.get()
963 968 now returns None (again), unless dummy is specifically allowed by
964 969 ipapi.get(allow_dummy=True).
965 970
966 971 2006-05-18 Fernando Perez <Fernando.Perez@colorado.edu>
967 972
968 973 * IPython: remove all 2.2-compatibility objects and hacks from
969 974 everywhere, since we only support 2.3 at this point. Docs
970 975 updated.
971 976
972 977 * IPython/ipapi.py (IPApi.__init__): Cleanup of all getters.
973 978 Anything requiring extra validation can be turned into a Python
974 979 property in the future. I used a property for the db one b/c
975 980 there was a nasty circularity problem with the initialization
976 981 order, which right now I don't have time to clean up.
977 982
978 983 * IPython/Shell.py (MTInteractiveShell.runcode): Fix, I think,
979 984 another locking bug reported by Jorgen. I'm not 100% sure though,
980 985 so more testing is needed...
981 986
982 987 2006-05-17 Fernando Perez <Fernando.Perez@colorado.edu>
983 988
984 989 * IPython/ipapi.py (IPApi.to_user_ns): New function to inject
985 990 local variables from any routine in user code (typically executed
986 991 with %run) directly into the interactive namespace. Very useful
987 992 when doing complex debugging.
988 993 (IPythonNotRunning): Changed the default None object to a dummy
989 994 whose attributes can be queried as well as called without
990 995 exploding, to ease writing code which works transparently both in
991 996 and out of ipython and uses some of this API.
992 997
993 998 2006-05-16 Fernando Perez <Fernando.Perez@colorado.edu>
994 999
995 1000 * IPython/hooks.py (result_display): Fix the fact that our display
996 1001 hook was using str() instead of repr(), as the default python
997 1002 console does. This had gone unnoticed b/c it only happened if
998 1003 %Pprint was off, but the inconsistency was there.
999 1004
1000 1005 2006-05-15 Ville Vainio <vivainio@gmail.com>
1001 1006
1002 1007 * Oinspect.py: Only show docstring for nonexisting/binary files
1003 1008 when doing object??, closing ticket #62
1004 1009
1005 1010 2006-05-13 Fernando Perez <Fernando.Perez@colorado.edu>
1006 1011
1007 1012 * IPython/Shell.py (MTInteractiveShell.runsource): Fix threading
1008 1013 bug, closes http://www.scipy.net/roundup/ipython/issue55. A lock
1009 1014 was being released in a routine which hadn't checked if it had
1010 1015 been the one to acquire it.
1011 1016
1012 1017 2006-05-07 Fernando Perez <Fernando.Perez@colorado.edu>
1013 1018
1014 1019 * IPython/Release.py (version): put out 0.7.2.rc1 for testing.
1015 1020
1016 1021 2006-04-11 Ville Vainio <vivainio@gmail.com>
1017 1022
1018 1023 * iplib.py, ipmaker.py: .ipy extension now means "ipython batch file"
1019 1024 in command line. E.g. "ipython test.ipy" runs test.ipy with ipython
1020 1025 prefilters, allowing stuff like magics and aliases in the file.
1021 1026
1022 1027 * Prompts.py, Extensions/clearcmd.py, ipy_system_conf.py: %clear magic
1023 1028 added. Supported now are "%clear in" and "%clear out" (clear input and
1024 1029 output history, respectively). Also fixed CachedOutput.flush to
1025 1030 properly flush the output cache.
1026 1031
1027 1032 * Extensions/pspersistence.py: Fix %store to avoid "%store obj.attr"
1028 1033 half-success (and fail explicitly).
1029 1034
1030 1035 2006-03-28 Ville Vainio <vivainio@gmail.com>
1031 1036
1032 1037 * iplib.py: Fix quoting of aliases so that only argless ones
1033 1038 are quoted
1034 1039
1035 1040 2006-03-28 Ville Vainio <vivainio@gmail.com>
1036 1041
1037 1042 * iplib.py: Quote aliases with spaces in the name.
1038 1043 "c:\program files\blah\bin" is now legal alias target.
1039 1044
1040 1045 * ext_rehashdir.py: Space no longer allowed as arg
1041 1046 separator, since space is legal in path names.
1042 1047
1043 1048 2006-03-16 Ville Vainio <vivainio@gmail.com>
1044 1049
1045 1050 * upgrade_dir.py: Take path.py from Extensions, correcting
1046 1051 %upgrade magic
1047 1052
1048 1053 * ipmaker.py: Suggest using %upgrade if ipy_user_conf.py isn't found.
1049 1054
1050 1055 * hooks.py: Only enclose editor binary in quotes if legal and
1051 1056 necessary (space in the name, and is an existing file). Fixes a bug
1052 1057 reported by Zachary Pincus.
1053 1058
1054 1059 2006-03-13 Fernando Perez <Fernando.Perez@colorado.edu>
1055 1060
1056 1061 * Manual: thanks to a tip on proper color handling for Emacs, by
1057 1062 Eric J Haywiser <ejh1-AT-MIT.EDU>.
1058 1063
1059 1064 * ipython.el: close http://www.scipy.net/roundup/ipython/issue57
1060 1065 by applying the provided patch. Thanks to Liu Jin
1061 1066 <m.liu.jin-AT-gmail.com> for the contribution. No problems under
1062 1067 XEmacs/Linux, I'm trusting the submitter that it actually helps
1063 1068 under win32/GNU Emacs. Will revisit if any problems are reported.
1064 1069
1065 1070 2006-03-12 Fernando Perez <Fernando.Perez@colorado.edu>
1066 1071
1067 1072 * IPython/Gnuplot2.py (_FileClass): update for current Gnuplot.py
1068 1073 from SVN, thanks to a patch by Ryan Woodard <rywo@bas.ac.uk>.
1069 1074
1070 1075 2006-03-12 Ville Vainio <vivainio@gmail.com>
1071 1076
1072 1077 * Magic.py (magic_timeit): Added %timeit magic, contributed by
1073 1078 Torsten Marek.
1074 1079
1075 1080 2006-03-12 Fernando Perez <Fernando.Perez@colorado.edu>
1076 1081
1077 1082 * IPython/Magic.py (magic_macro): fix so that the n1-n2 syntax for
1078 1083 line ranges works again.
1079 1084
1080 1085 2006-03-11 Fernando Perez <Fernando.Perez@colorado.edu>
1081 1086
1082 1087 * IPython/iplib.py (showtraceback): add back sys.last_traceback
1083 1088 and friends, after a discussion with Zach Pincus on ipython-user.
1084 1089 I'm not 100% sure, but after thinking about it quite a bit, it may
1085 1090 be OK. Testing with the multithreaded shells didn't reveal any
1086 1091 problems, but let's keep an eye out.
1087 1092
1088 1093 In the process, I fixed a few things which were calling
1089 1094 self.InteractiveTB() directly (like safe_execfile), which is a
1090 1095 mistake: ALL exception reporting should be done by calling
1091 1096 self.showtraceback(), which handles state and tab-completion and
1092 1097 more.
1093 1098
1094 1099 2006-03-01 Ville Vainio <vivainio@gmail.com>
1095 1100
1096 1101 * Extensions/ipipe.py: Added Walter Doerwald's "ipipe" module.
1097 1102 To use, do "from ipipe import *".
1098 1103
1099 1104 2006-02-24 Ville Vainio <vivainio@gmail.com>
1100 1105
1101 1106 * Magic.py, upgrade_dir.py: %upgrade magic added. Does things more
1102 1107 "cleanly" and safely than the older upgrade mechanism.
1103 1108
1104 1109 2006-02-21 Ville Vainio <vivainio@gmail.com>
1105 1110
1106 1111 * Magic.py: %save works again.
1107 1112
1108 1113 2006-02-15 Ville Vainio <vivainio@gmail.com>
1109 1114
1110 1115 * Magic.py: %Pprint works again
1111 1116
1112 1117 * Extensions/ipy_sane_defaults.py: Provide everything provided
1113 1118 in default ipythonrc, to make it possible to have a completely empty
1114 1119 ipythonrc (and thus completely rc-file free configuration)
1115 1120
1116 1121 2006-02-11 Fernando Perez <Fernando.Perez@colorado.edu>
1117 1122
1118 1123 * IPython/hooks.py (editor): quote the call to the editor command,
1119 1124 to allow commands with spaces in them. Problem noted by watching
1120 1125 Ian Oswald's video about textpad under win32 at
1121 1126 http://showmedo.com/videoListPage?listKey=PythonIPythonSeries
1122 1127
1123 1128 * IPython/UserConfig/ipythonrc: Replace @ signs with % when
1124 1129 describing magics (we haven't used @ for a loong time).
1125 1130
1126 1131 * IPython/ultraTB.py (VerboseTB.text.text_repr): Added patch
1127 1132 contributed by marienz to close
1128 1133 http://www.scipy.net/roundup/ipython/issue53.
1129 1134
1130 1135 2006-02-10 Ville Vainio <vivainio@gmail.com>
1131 1136
1132 1137 * genutils.py: getoutput now works in win32 too
1133 1138
1134 1139 * completer.py: alias and magic completion only invoked
1135 1140 at the first "item" in the line, to avoid "cd %store"
1136 1141 nonsense.
1137 1142
1138 1143 2006-02-09 Ville Vainio <vivainio@gmail.com>
1139 1144
1140 1145 * test/*: Added a unit testing framework (finally).
1141 1146 '%run runtests.py' to run test_*.
1142 1147
1143 1148 * ipapi.py: Exposed runlines and set_custom_exc
1144 1149
1145 1150 2006-02-07 Ville Vainio <vivainio@gmail.com>
1146 1151
1147 1152 * iplib.py: don't split "f 1 2" to "f(1,2)" in autocall,
1148 1153 instead use "f(1 2)" as before.
1149 1154
1150 1155 2006-02-05 Fernando Perez <Fernando.Perez@colorado.edu>
1151 1156
1152 1157 * IPython/demo.py (IPythonDemo): Add new classes to the demo
1153 1158 facilities, for demos processed by the IPython input filter
1154 1159 (IPythonDemo), and for running a script one-line-at-a-time as a
1155 1160 demo, both for pure Python (LineDemo) and for IPython-processed
1156 1161 input (IPythonLineDemo). After a request by Dave Kohel, from the
1157 1162 SAGE team.
1158 1163 (Demo.edit): added an edit() method to the demo objects, to edit
1159 1164 the in-memory copy of the last executed block.
1160 1165
1161 1166 * IPython/Magic.py (magic_edit): add '-r' option for 'raw'
1162 1167 processing to %edit, %macro and %save. These commands can now be
1163 1168 invoked on the unprocessed input as it was typed by the user
1164 1169 (without any prefilters applied). After requests by the SAGE team
1165 1170 at SAGE days 2006: http://modular.ucsd.edu/sage/days1/schedule.html.
1166 1171
1167 1172 2006-02-01 Ville Vainio <vivainio@gmail.com>
1168 1173
1169 1174 * setup.py, eggsetup.py: easy_install ipython==dev works
1170 1175 correctly now (on Linux)
1171 1176
1172 1177 * ipy_user_conf,ipmaker: user config changes, removed spurious
1173 1178 warnings
1174 1179
1175 1180 * iplib: if rc.banner is string, use it as is.
1176 1181
1177 1182 * Magic: %pycat accepts a string argument and pages it's contents.
1178 1183
1179 1184
1180 1185 2006-01-30 Ville Vainio <vivainio@gmail.com>
1181 1186
1182 1187 * pickleshare,pspersistence,ipapi,Magic: persistence overhaul.
1183 1188 Now %store and bookmarks work through PickleShare, meaning that
1184 1189 concurrent access is possible and all ipython sessions see the
1185 1190 same database situation all the time, instead of snapshot of
1186 1191 the situation when the session was started. Hence, %bookmark
1187 1192 results are immediately accessible from othes sessions. The database
1188 1193 is also available for use by user extensions. See:
1189 1194 http://www.python.org/pypi/pickleshare
1190 1195
1191 1196 * hooks.py: Two new hooks, 'shutdown_hook' and 'late_startup_hook'.
1192 1197
1193 1198 * aliases can now be %store'd
1194 1199
1195 1200 * path.py moved to Extensions so that pickleshare does not need
1196 1201 IPython-specific import. Extensions added to pythonpath right
1197 1202 at __init__.
1198 1203
1199 1204 * iplib.py: ipalias deprecated/redundant; aliases are converted and
1200 1205 called with _ip.system and the pre-transformed command string.
1201 1206
1202 1207 2006-01-29 Fernando Perez <Fernando.Perez@colorado.edu>
1203 1208
1204 1209 * IPython/iplib.py (interact): Fix that we were not catching
1205 1210 KeyboardInterrupt exceptions properly. I'm not quite sure why the
1206 1211 logic here had to change, but it's fixed now.
1207 1212
1208 1213 2006-01-29 Ville Vainio <vivainio@gmail.com>
1209 1214
1210 1215 * iplib.py: Try to import pyreadline on Windows.
1211 1216
1212 1217 2006-01-27 Ville Vainio <vivainio@gmail.com>
1213 1218
1214 1219 * iplib.py: Expose ipapi as _ip in builtin namespace.
1215 1220 Makes ipmagic (-> _ip.magic), ipsystem (-> _ip.system)
1216 1221 and ip_set_hook (-> _ip.set_hook) redundant. % and !
1217 1222 syntax now produce _ip.* variant of the commands.
1218 1223
1219 1224 * "_ip.options().autoedit_syntax = 2" automatically throws
1220 1225 user to editor for syntax error correction without prompting.
1221 1226
1222 1227 2006-01-27 Ville Vainio <vivainio@gmail.com>
1223 1228
1224 1229 * ipmaker.py: Give "realistic" sys.argv for scripts (without
1225 1230 'ipython' at argv[0]) executed through command line.
1226 1231 NOTE: this DEPRECATES calling ipython with multiple scripts
1227 1232 ("ipython a.py b.py c.py")
1228 1233
1229 1234 * iplib.py, hooks.py: Added configurable input prefilter,
1230 1235 named 'input_prefilter'. See ext_rescapture.py for example
1231 1236 usage.
1232 1237
1233 1238 * ext_rescapture.py, Magic.py: Better system command output capture
1234 1239 through 'var = !ls' (deprecates user-visible %sc). Same notation
1235 1240 applies for magics, 'var = %alias' assigns alias list to var.
1236 1241
1237 1242 * ipapi.py: added meta() for accessing extension-usable data store.
1238 1243
1239 1244 * iplib.py: added InteractiveShell.getapi(). New magics should be
1240 1245 written doing self.getapi() instead of using the shell directly.
1241 1246
1242 1247 * Magic.py: %store now allows doing %store foo > ~/myfoo.txt and
1243 1248 %store foo >> ~/myfoo.txt to store variables to files (in clean
1244 1249 textual form, not a restorable pickle).
1245 1250
1246 1251 * ipmaker.py: now import ipy_profile_PROFILENAME automatically
1247 1252
1248 1253 * usage.py, Magic.py: added %quickref
1249 1254
1250 1255 * iplib.py: ESC_PAREN fixes: /f 1 2 -> f(1,2), not f(1 2).
1251 1256
1252 1257 * GetoptErrors when invoking magics etc. with wrong args
1253 1258 are now more helpful:
1254 1259 GetoptError: option -l not recognized (allowed: "qb" )
1255 1260
1256 1261 2006-01-25 Fernando Perez <Fernando.Perez@colorado.edu>
1257 1262
1258 1263 * IPython/demo.py (Demo.show): Flush stdout after each block, so
1259 1264 computationally intensive blocks don't appear to stall the demo.
1260 1265
1261 1266 2006-01-24 Ville Vainio <vivainio@gmail.com>
1262 1267
1263 1268 * iplib.py, hooks.py: 'result_display' hook can return a non-None
1264 1269 value to manipulate resulting history entry.
1265 1270
1266 1271 * ipapi.py: Moved TryNext here from hooks.py. Moved functions
1267 1272 to instance methods of IPApi class, to make extending an embedded
1268 1273 IPython feasible. See ext_rehashdir.py for example usage.
1269 1274
1270 1275 * Merged 1071-1076 from branches/0.7.1
1271 1276
1272 1277
1273 1278 2006-01-23 Fernando Perez <Fernando.Perez@colorado.edu>
1274 1279
1275 1280 * tools/release (daystamp): Fix build tools to use the new
1276 1281 eggsetup.py script to build lightweight eggs.
1277 1282
1278 1283 * Applied changesets 1062 and 1064 before 0.7.1 release.
1279 1284
1280 1285 * IPython/Magic.py (magic_history): Add '-r' option to %hist, to
1281 1286 see the raw input history (without conversions like %ls ->
1282 1287 ipmagic("ls")). After a request from W. Stein, SAGE
1283 1288 (http://modular.ucsd.edu/sage) developer. This information is
1284 1289 stored in the input_hist_raw attribute of the IPython instance, so
1285 1290 developers can access it if needed (it's an InputList instance).
1286 1291
1287 1292 * Versionstring = 0.7.2.svn
1288 1293
1289 1294 * eggsetup.py: A separate script for constructing eggs, creates
1290 1295 proper launch scripts even on Windows (an .exe file in
1291 1296 \python24\scripts).
1292 1297
1293 1298 * ipapi.py: launch_new_instance, launch entry point needed for the
1294 1299 egg.
1295 1300
1296 1301 2006-01-23 Ville Vainio <vivainio@gmail.com>
1297 1302
1298 1303 * Added %cpaste magic for pasting python code
1299 1304
1300 1305 2006-01-22 Ville Vainio <vivainio@gmail.com>
1301 1306
1302 1307 * Merge from branches/0.7.1 into trunk, revs 1052-1057
1303 1308
1304 1309 * Versionstring = 0.7.2.svn
1305 1310
1306 1311 * eggsetup.py: A separate script for constructing eggs, creates
1307 1312 proper launch scripts even on Windows (an .exe file in
1308 1313 \python24\scripts).
1309 1314
1310 1315 * ipapi.py: launch_new_instance, launch entry point needed for the
1311 1316 egg.
1312 1317
1313 1318 2006-01-22 Fernando Perez <Fernando.Perez@colorado.edu>
1314 1319
1315 1320 * IPython/OInspect.py (Inspector.pinfo): fix bug where foo?? or
1316 1321 %pfile foo would print the file for foo even if it was a binary.
1317 1322 Now, extensions '.so' and '.dll' are skipped.
1318 1323
1319 1324 * IPython/Shell.py (MTInteractiveShell.__init__): Fix threading
1320 1325 bug, where macros would fail in all threaded modes. I'm not 100%
1321 1326 sure, so I'm going to put out an rc instead of making a release
1322 1327 today, and wait for feedback for at least a few days.
1323 1328
1324 1329 * IPython/iplib.py (handle_normal): fix (finally? somehow I doubt
1325 1330 it...) the handling of pasting external code with autoindent on.
1326 1331 To get out of a multiline input, the rule will appear for most
1327 1332 users unchanged: two blank lines or change the indent level
1328 1333 proposed by IPython. But there is a twist now: you can
1329 1334 add/subtract only *one or two spaces*. If you add/subtract three
1330 1335 or more (unless you completely delete the line), IPython will
1331 1336 accept that line, and you'll need to enter a second one of pure
1332 1337 whitespace. I know it sounds complicated, but I can't find a
1333 1338 different solution that covers all the cases, with the right
1334 1339 heuristics. Hopefully in actual use, nobody will really notice
1335 1340 all these strange rules and things will 'just work'.
1336 1341
1337 1342 2006-01-21 Fernando Perez <Fernando.Perez@colorado.edu>
1338 1343
1339 1344 * IPython/iplib.py (interact): catch exceptions which can be
1340 1345 triggered asynchronously by signal handlers. Thanks to an
1341 1346 automatic crash report, submitted by Colin Kingsley
1342 1347 <tercel-AT-gentoo.org>.
1343 1348
1344 1349 2006-01-20 Ville Vainio <vivainio@gmail.com>
1345 1350
1346 1351 * Ipython/Extensions/ext_rehashdir.py: Created a usable example
1347 1352 (%rehashdir, very useful, try it out) of how to extend ipython
1348 1353 with new magics. Also added Extensions dir to pythonpath to make
1349 1354 importing extensions easy.
1350 1355
1351 1356 * %store now complains when trying to store interactively declared
1352 1357 classes / instances of those classes.
1353 1358
1354 1359 * Extensions/ipy_system_conf.py, UserConfig/ipy_user_conf.py,
1355 1360 ipmaker.py: Config rehaul. Now ipy_..._conf.py are always imported
1356 1361 if they exist, and ipy_user_conf.py with some defaults is created for
1357 1362 the user.
1358 1363
1359 1364 * Startup rehashing done by the config file, not InterpreterExec.
1360 1365 This means system commands are available even without selecting the
1361 1366 pysh profile. It's the sensible default after all.
1362 1367
1363 1368 2006-01-20 Fernando Perez <Fernando.Perez@colorado.edu>
1364 1369
1365 1370 * IPython/iplib.py (raw_input): I _think_ I got the pasting of
1366 1371 multiline code with autoindent on working. But I am really not
1367 1372 sure, so this needs more testing. Will commit a debug-enabled
1368 1373 version for now, while I test it some more, so that Ville and
1369 1374 others may also catch any problems. Also made
1370 1375 self.indent_current_str() a method, to ensure that there's no
1371 1376 chance of the indent space count and the corresponding string
1372 1377 falling out of sync. All code needing the string should just call
1373 1378 the method.
1374 1379
1375 1380 2006-01-18 Fernando Perez <Fernando.Perez@colorado.edu>
1376 1381
1377 1382 * IPython/Magic.py (magic_edit): fix check for when users don't
1378 1383 save their output files, the try/except was in the wrong section.
1379 1384
1380 1385 2006-01-17 Fernando Perez <Fernando.Perez@colorado.edu>
1381 1386
1382 1387 * IPython/Magic.py (magic_run): fix __file__ global missing from
1383 1388 script's namespace when executed via %run. After a report by
1384 1389 Vivian.
1385 1390
1386 1391 * IPython/Debugger.py (Pdb.__init__): Fix breakage with '%run -d'
1387 1392 when using python 2.4. The parent constructor changed in 2.4, and
1388 1393 we need to track it directly (we can't call it, as it messes up
1389 1394 readline and tab-completion inside our pdb would stop working).
1390 1395 After a bug report by R. Bernstein <rocky-AT-panix.com>.
1391 1396
1392 1397 2006-01-16 Ville Vainio <vivainio@gmail.com>
1393 1398
1394 1399 * Ipython/magic.py: Reverted back to old %edit functionality
1395 1400 that returns file contents on exit.
1396 1401
1397 1402 * IPython/path.py: Added Jason Orendorff's "path" module to
1398 1403 IPython tree, http://www.jorendorff.com/articles/python/path/.
1399 1404 You can get path objects conveniently through %sc, and !!, e.g.:
1400 1405 sc files=ls
1401 1406 for p in files.paths: # or files.p
1402 1407 print p,p.mtime
1403 1408
1404 1409 * Ipython/iplib.py:"," and ";" autoquoting-upon-autocall
1405 1410 now work again without considering the exclusion regexp -
1406 1411 hence, things like ',foo my/path' turn to 'foo("my/path")'
1407 1412 instead of syntax error.
1408 1413
1409 1414
1410 1415 2006-01-14 Ville Vainio <vivainio@gmail.com>
1411 1416
1412 1417 * IPython/ipapi.py (ashook, asmagic, options): Added convenience
1413 1418 ipapi decorators for python 2.4 users, options() provides access to rc
1414 1419 data.
1415 1420
1416 1421 * IPython/Magic.py (magic_cd): %cd now accepts backslashes
1417 1422 as path separators (even on Linux ;-). Space character after
1418 1423 backslash (as yielded by tab completer) is still space;
1419 1424 "%cd long\ name" works as expected.
1420 1425
1421 1426 * IPython/ipapi.py,hooks.py,iplib.py: Hooks now implemented
1422 1427 as "chain of command", with priority. API stays the same,
1423 1428 TryNext exception raised by a hook function signals that
1424 1429 current hook failed and next hook should try handling it, as
1425 1430 suggested by Walter Dörwald <walter@livinglogic.de>. Walter also
1426 1431 requested configurable display hook, which is now implemented.
1427 1432
1428 1433 2006-01-13 Ville Vainio <vivainio@gmail.com>
1429 1434
1430 1435 * IPython/platutils*.py: platform specific utility functions,
1431 1436 so far only set_term_title is implemented (change terminal
1432 1437 label in windowing systems). %cd now changes the title to
1433 1438 current dir.
1434 1439
1435 1440 * IPython/Release.py: Added myself to "authors" list,
1436 1441 had to create new files.
1437 1442
1438 1443 * IPython/iplib.py (handle_shell_escape): fixed logical flaw in
1439 1444 shell escape; not a known bug but had potential to be one in the
1440 1445 future.
1441 1446
1442 1447 * IPython/ipapi.py (added),OInspect.py,iplib.py: "Public"
1443 1448 extension API for IPython! See the module for usage example. Fix
1444 1449 OInspect for docstring-less magic functions.
1445 1450
1446 1451
1447 1452 2006-01-13 Fernando Perez <Fernando.Perez@colorado.edu>
1448 1453
1449 1454 * IPython/iplib.py (raw_input): temporarily deactivate all
1450 1455 attempts at allowing pasting of code with autoindent on. It
1451 1456 introduced bugs (reported by Prabhu) and I can't seem to find a
1452 1457 robust combination which works in all cases. Will have to revisit
1453 1458 later.
1454 1459
1455 1460 * IPython/genutils.py: remove isspace() function. We've dropped
1456 1461 2.2 compatibility, so it's OK to use the string method.
1457 1462
1458 1463 2006-01-12 Fernando Perez <Fernando.Perez@colorado.edu>
1459 1464
1460 1465 * IPython/iplib.py (InteractiveShell.__init__): fix regexp
1461 1466 matching what NOT to autocall on, to include all python binary
1462 1467 operators (including things like 'and', 'or', 'is' and 'in').
1463 1468 Prompted by a bug report on 'foo & bar', but I realized we had
1464 1469 many more potential bug cases with other operators. The regexp is
1465 1470 self.re_exclude_auto, it's fairly commented.
1466 1471
1467 1472 2006-01-12 Ville Vainio <vivainio@gmail.com>
1468 1473
1469 1474 * IPython/iplib.py (make_quoted_expr,handle_shell_escape):
1470 1475 Prettified and hardened string/backslash quoting with ipsystem(),
1471 1476 ipalias() and ipmagic(). Now even \ characters are passed to
1472 1477 %magics, !shell escapes and aliases exactly as they are in the
1473 1478 ipython command line. Should improve backslash experience,
1474 1479 particularly in Windows (path delimiter for some commands that
1475 1480 won't understand '/'), but Unix benefits as well (regexps). %cd
1476 1481 magic still doesn't support backslash path delimiters, though. Also
1477 1482 deleted all pretense of supporting multiline command strings in
1478 1483 !system or %magic commands. Thanks to Jerry McRae for suggestions.
1479 1484
1480 1485 * doc/build_doc_instructions.txt added. Documentation on how to
1481 1486 use doc/update_manual.py, added yesterday. Both files contributed
1482 1487 by Jörgen Stenarson <jorgen.stenarson-AT-bostream.nu>. This slates
1483 1488 doc/*.sh for deprecation at a later date.
1484 1489
1485 1490 * /ipython.py Added ipython.py to root directory for
1486 1491 zero-installation (tar xzvf ipython.tgz; cd ipython; python
1487 1492 ipython.py) and development convenience (no need to keep doing
1488 1493 "setup.py install" between changes).
1489 1494
1490 1495 * Made ! and !! shell escapes work (again) in multiline expressions:
1491 1496 if 1:
1492 1497 !ls
1493 1498 !!ls
1494 1499
1495 1500 2006-01-12 Fernando Perez <Fernando.Perez@colorado.edu>
1496 1501
1497 1502 * IPython/ipstruct.py (Struct): Rename IPython.Struct to
1498 1503 IPython.ipstruct, to avoid local shadowing of the stdlib 'struct'
1499 1504 module in case-insensitive installation. Was causing crashes
1500 1505 under win32. Closes http://www.scipy.net/roundup/ipython/issue49.
1501 1506
1502 1507 * IPython/Magic.py (magic_pycat): Fix pycat, patch by Marien Zwart
1503 1508 <marienz-AT-gentoo.org>, closes
1504 1509 http://www.scipy.net/roundup/ipython/issue51.
1505 1510
1506 1511 2006-01-11 Fernando Perez <Fernando.Perez@colorado.edu>
1507 1512
1508 1513 * IPython/Shell.py (IPShellGTK.on_timer): Finally fix the
1509 1514 problem of excessive CPU usage under *nix and keyboard lag under
1510 1515 win32.
1511 1516
1512 1517 2006-01-10 *** Released version 0.7.0
1513 1518
1514 1519 2006-01-10 Fernando Perez <Fernando.Perez@colorado.edu>
1515 1520
1516 1521 * IPython/Release.py (revision): tag version number to 0.7.0,
1517 1522 ready for release.
1518 1523
1519 1524 * IPython/Magic.py (magic_edit): Add print statement to %edit so
1520 1525 it informs the user of the name of the temp. file used. This can
1521 1526 help if you decide later to reuse that same file, so you know
1522 1527 where to copy the info from.
1523 1528
1524 1529 2006-01-09 Fernando Perez <Fernando.Perez@colorado.edu>
1525 1530
1526 1531 * setup_bdist_egg.py: little script to build an egg. Added
1527 1532 support in the release tools as well.
1528 1533
1529 1534 2006-01-08 Fernando Perez <Fernando.Perez@colorado.edu>
1530 1535
1531 1536 * IPython/Shell.py (IPShellWX.__init__): add support for WXPython
1532 1537 version selection (new -wxversion command line and ipythonrc
1533 1538 parameter). Patch contributed by Arnd Baecker
1534 1539 <arnd.baecker-AT-web.de>.
1535 1540
1536 1541 * IPython/iplib.py (embed_mainloop): fix tab-completion in
1537 1542 embedded instances, for variables defined at the interactive
1538 1543 prompt of the embedded ipython. Reported by Arnd.
1539 1544
1540 1545 * IPython/Magic.py (magic_autocall): Fix %autocall magic. Now
1541 1546 it can be used as a (stateful) toggle, or with a direct parameter.
1542 1547
1543 1548 * IPython/ultraTB.py (_fixed_getinnerframes): remove debug assert which
1544 1549 could be triggered in certain cases and cause the traceback
1545 1550 printer not to work.
1546 1551
1547 1552 2006-01-07 Fernando Perez <Fernando.Perez@colorado.edu>
1548 1553
1549 1554 * IPython/iplib.py (_should_recompile): Small fix, closes
1550 1555 http://www.scipy.net/roundup/ipython/issue48. Patch by Scott.
1551 1556
1552 1557 2006-01-04 Fernando Perez <Fernando.Perez@colorado.edu>
1553 1558
1554 1559 * IPython/Shell.py (IPShellGTK.mainloop): fix bug in the GTK
1555 1560 backend for matplotlib (100% cpu utiliziation). Thanks to Charlie
1556 1561 Moad for help with tracking it down.
1557 1562
1558 1563 * IPython/iplib.py (handle_auto): fix autocall handling for
1559 1564 objects which support BOTH __getitem__ and __call__ (so that f [x]
1560 1565 is left alone, instead of becoming f([x]) automatically).
1561 1566
1562 1567 * IPython/Magic.py (magic_cd): fix crash when cd -b was used.
1563 1568 Ville's patch.
1564 1569
1565 1570 2006-01-03 Fernando Perez <Fernando.Perez@colorado.edu>
1566 1571
1567 1572 * IPython/iplib.py (handle_auto): changed autocall semantics to
1568 1573 include 'smart' mode, where the autocall transformation is NOT
1569 1574 applied if there are no arguments on the line. This allows you to
1570 1575 just type 'foo' if foo is a callable to see its internal form,
1571 1576 instead of having it called with no arguments (typically a
1572 1577 mistake). The old 'full' autocall still exists: for that, you
1573 1578 need to set the 'autocall' parameter to 2 in your ipythonrc file.
1574 1579
1575 1580 * IPython/completer.py (Completer.attr_matches): add
1576 1581 tab-completion support for Enthoughts' traits. After a report by
1577 1582 Arnd and a patch by Prabhu.
1578 1583
1579 1584 2006-01-02 Fernando Perez <Fernando.Perez@colorado.edu>
1580 1585
1581 1586 * IPython/ultraTB.py (_fixed_getinnerframes): added Alex
1582 1587 Schmolck's patch to fix inspect.getinnerframes().
1583 1588
1584 1589 * IPython/iplib.py (InteractiveShell.__init__): significant fixes
1585 1590 for embedded instances, regarding handling of namespaces and items
1586 1591 added to the __builtin__ one. Multiple embedded instances and
1587 1592 recursive embeddings should work better now (though I'm not sure
1588 1593 I've got all the corner cases fixed, that code is a bit of a brain
1589 1594 twister).
1590 1595
1591 1596 * IPython/Magic.py (magic_edit): added support to edit in-memory
1592 1597 macros (automatically creates the necessary temp files). %edit
1593 1598 also doesn't return the file contents anymore, it's just noise.
1594 1599
1595 1600 * IPython/completer.py (Completer.attr_matches): revert change to
1596 1601 complete only on attributes listed in __all__. I realized it
1597 1602 cripples the tab-completion system as a tool for exploring the
1598 1603 internals of unknown libraries (it renders any non-__all__
1599 1604 attribute off-limits). I got bit by this when trying to see
1600 1605 something inside the dis module.
1601 1606
1602 1607 2005-12-31 Fernando Perez <Fernando.Perez@colorado.edu>
1603 1608
1604 1609 * IPython/iplib.py (InteractiveShell.__init__): add .meta
1605 1610 namespace for users and extension writers to hold data in. This
1606 1611 follows the discussion in
1607 1612 http://projects.scipy.org/ipython/ipython/wiki/RefactoringIPython.
1608 1613
1609 1614 * IPython/completer.py (IPCompleter.complete): small patch to help
1610 1615 tab-completion under Emacs, after a suggestion by John Barnard
1611 1616 <barnarj-AT-ccf.org>.
1612 1617
1613 1618 * IPython/Magic.py (Magic.extract_input_slices): added support for
1614 1619 the slice notation in magics to use N-M to represent numbers N...M
1615 1620 (closed endpoints). This is used by %macro and %save.
1616 1621
1617 1622 * IPython/completer.py (Completer.attr_matches): for modules which
1618 1623 define __all__, complete only on those. After a patch by Jeffrey
1619 1624 Collins <jcollins_boulder-AT-earthlink.net>. Also, clean up and
1620 1625 speed up this routine.
1621 1626
1622 1627 * IPython/Logger.py (Logger.log): fix a history handling bug. I
1623 1628 don't know if this is the end of it, but the behavior now is
1624 1629 certainly much more correct. Note that coupled with macros,
1625 1630 slightly surprising (at first) behavior may occur: a macro will in
1626 1631 general expand to multiple lines of input, so upon exiting, the
1627 1632 in/out counters will both be bumped by the corresponding amount
1628 1633 (as if the macro's contents had been typed interactively). Typing
1629 1634 %hist will reveal the intermediate (silently processed) lines.
1630 1635
1631 1636 * IPython/Magic.py (magic_run): fix a subtle bug which could cause
1632 1637 pickle to fail (%run was overwriting __main__ and not restoring
1633 1638 it, but pickle relies on __main__ to operate).
1634 1639
1635 1640 * IPython/iplib.py (InteractiveShell): fix pdb calling: I'm now
1636 1641 using properties, but forgot to make the main InteractiveShell
1637 1642 class a new-style class. Properties fail silently, and
1638 1643 mysteriously, with old-style class (getters work, but
1639 1644 setters don't do anything).
1640 1645
1641 1646 2005-12-30 Fernando Perez <Fernando.Perez@colorado.edu>
1642 1647
1643 1648 * IPython/Magic.py (magic_history): fix history reporting bug (I
1644 1649 know some nasties are still there, I just can't seem to find a
1645 1650 reproducible test case to track them down; the input history is
1646 1651 falling out of sync...)
1647 1652
1648 1653 * IPython/iplib.py (handle_shell_escape): fix bug where both
1649 1654 aliases and system accesses where broken for indented code (such
1650 1655 as loops).
1651 1656
1652 1657 * IPython/genutils.py (shell): fix small but critical bug for
1653 1658 win32 system access.
1654 1659
1655 1660 2005-12-29 Fernando Perez <Fernando.Perez@colorado.edu>
1656 1661
1657 1662 * IPython/iplib.py (showtraceback): remove use of the
1658 1663 sys.last_{type/value/traceback} structures, which are non
1659 1664 thread-safe.
1660 1665 (_prefilter): change control flow to ensure that we NEVER
1661 1666 introspect objects when autocall is off. This will guarantee that
1662 1667 having an input line of the form 'x.y', where access to attribute
1663 1668 'y' has side effects, doesn't trigger the side effect TWICE. It
1664 1669 is important to note that, with autocall on, these side effects
1665 1670 can still happen.
1666 1671 (ipsystem): new builtin, to complete the ip{magic/alias/system}
1667 1672 trio. IPython offers these three kinds of special calls which are
1668 1673 not python code, and it's a good thing to have their call method
1669 1674 be accessible as pure python functions (not just special syntax at
1670 1675 the command line). It gives us a better internal implementation
1671 1676 structure, as well as exposing these for user scripting more
1672 1677 cleanly.
1673 1678
1674 1679 * IPython/macro.py (Macro.__init__): moved macros to a standalone
1675 1680 file. Now that they'll be more likely to be used with the
1676 1681 persistance system (%store), I want to make sure their module path
1677 1682 doesn't change in the future, so that we don't break things for
1678 1683 users' persisted data.
1679 1684
1680 1685 * IPython/iplib.py (autoindent_update): move indentation
1681 1686 management into the _text_ processing loop, not the keyboard
1682 1687 interactive one. This is necessary to correctly process non-typed
1683 1688 multiline input (such as macros).
1684 1689
1685 1690 * IPython/Magic.py (Magic.format_latex): patch by Stefan van der
1686 1691 Walt <stefan-AT-sun.ac.za> to fix latex formatting of docstrings,
1687 1692 which was producing problems in the resulting manual.
1688 1693 (magic_whos): improve reporting of instances (show their class,
1689 1694 instead of simply printing 'instance' which isn't terribly
1690 1695 informative).
1691 1696
1692 1697 * IPython/genutils.py (shell): commit Jorgen Stenarson's patch
1693 1698 (minor mods) to support network shares under win32.
1694 1699
1695 1700 * IPython/winconsole.py (get_console_size): add new winconsole
1696 1701 module and fixes to page_dumb() to improve its behavior under
1697 1702 win32. Contributed by Alexander Belchenko <bialix-AT-ukr.net>.
1698 1703
1699 1704 * IPython/Magic.py (Macro): simplified Macro class to just
1700 1705 subclass list. We've had only 2.2 compatibility for a very long
1701 1706 time, yet I was still avoiding subclassing the builtin types. No
1702 1707 more (I'm also starting to use properties, though I won't shift to
1703 1708 2.3-specific features quite yet).
1704 1709 (magic_store): added Ville's patch for lightweight variable
1705 1710 persistence, after a request on the user list by Matt Wilkie
1706 1711 <maphew-AT-gmail.com>. The new %store magic's docstring has full
1707 1712 details.
1708 1713
1709 1714 * IPython/iplib.py (InteractiveShell.post_config_initialization):
1710 1715 changed the default logfile name from 'ipython.log' to
1711 1716 'ipython_log.py'. These logs are real python files, and now that
1712 1717 we have much better multiline support, people are more likely to
1713 1718 want to use them as such. Might as well name them correctly.
1714 1719
1715 1720 * IPython/Magic.py: substantial cleanup. While we can't stop
1716 1721 using magics as mixins, due to the existing customizations 'out
1717 1722 there' which rely on the mixin naming conventions, at least I
1718 1723 cleaned out all cross-class name usage. So once we are OK with
1719 1724 breaking compatibility, the two systems can be separated.
1720 1725
1721 1726 * IPython/Logger.py: major cleanup. This one is NOT a mixin
1722 1727 anymore, and the class is a fair bit less hideous as well. New
1723 1728 features were also introduced: timestamping of input, and logging
1724 1729 of output results. These are user-visible with the -t and -o
1725 1730 options to %logstart. Closes
1726 1731 http://www.scipy.net/roundup/ipython/issue11 and a request by
1727 1732 William Stein (SAGE developer - http://modular.ucsd.edu/sage).
1728 1733
1729 1734 2005-12-28 Fernando Perez <Fernando.Perez@colorado.edu>
1730 1735
1731 1736 * IPython/iplib.py (handle_shell_escape): add Ville's patch to
1732 1737 better handle backslashes in paths. See the thread 'More Windows
1733 1738 questions part 2 - \/ characters revisited' on the iypthon user
1734 1739 list:
1735 1740 http://scipy.net/pipermail/ipython-user/2005-June/000907.html
1736 1741
1737 1742 (InteractiveShell.__init__): fix tab-completion bug in threaded shells.
1738 1743
1739 1744 (InteractiveShell.__init__): change threaded shells to not use the
1740 1745 ipython crash handler. This was causing more problems than not,
1741 1746 as exceptions in the main thread (GUI code, typically) would
1742 1747 always show up as a 'crash', when they really weren't.
1743 1748
1744 1749 The colors and exception mode commands (%colors/%xmode) have been
1745 1750 synchronized to also take this into account, so users can get
1746 1751 verbose exceptions for their threaded code as well. I also added
1747 1752 support for activating pdb inside this exception handler as well,
1748 1753 so now GUI authors can use IPython's enhanced pdb at runtime.
1749 1754
1750 1755 * IPython/ipmaker.py (make_IPython): make the autoedit_syntax flag
1751 1756 true by default, and add it to the shipped ipythonrc file. Since
1752 1757 this asks the user before proceeding, I think it's OK to make it
1753 1758 true by default.
1754 1759
1755 1760 * IPython/Magic.py (magic_exit): make new exit/quit magics instead
1756 1761 of the previous special-casing of input in the eval loop. I think
1757 1762 this is cleaner, as they really are commands and shouldn't have
1758 1763 a special role in the middle of the core code.
1759 1764
1760 1765 2005-12-27 Fernando Perez <Fernando.Perez@colorado.edu>
1761 1766
1762 1767 * IPython/iplib.py (edit_syntax_error): added support for
1763 1768 automatically reopening the editor if the file had a syntax error
1764 1769 in it. Thanks to scottt who provided the patch at:
1765 1770 http://www.scipy.net/roundup/ipython/issue36 (slightly modified
1766 1771 version committed).
1767 1772
1768 1773 * IPython/iplib.py (handle_normal): add suport for multi-line
1769 1774 input with emtpy lines. This fixes
1770 1775 http://www.scipy.net/roundup/ipython/issue43 and a similar
1771 1776 discussion on the user list.
1772 1777
1773 1778 WARNING: a behavior change is necessarily introduced to support
1774 1779 blank lines: now a single blank line with whitespace does NOT
1775 1780 break the input loop, which means that when autoindent is on, by
1776 1781 default hitting return on the next (indented) line does NOT exit.
1777 1782
1778 1783 Instead, to exit a multiline input you can either have:
1779 1784
1780 1785 - TWO whitespace lines (just hit return again), or
1781 1786 - a single whitespace line of a different length than provided
1782 1787 by the autoindent (add or remove a space).
1783 1788
1784 1789 * IPython/completer.py (MagicCompleter.__init__): new 'completer'
1785 1790 module to better organize all readline-related functionality.
1786 1791 I've deleted FlexCompleter and put all completion clases here.
1787 1792
1788 1793 * IPython/iplib.py (raw_input): improve indentation management.
1789 1794 It is now possible to paste indented code with autoindent on, and
1790 1795 the code is interpreted correctly (though it still looks bad on
1791 1796 screen, due to the line-oriented nature of ipython).
1792 1797 (MagicCompleter.complete): change behavior so that a TAB key on an
1793 1798 otherwise empty line actually inserts a tab, instead of completing
1794 1799 on the entire global namespace. This makes it easier to use the
1795 1800 TAB key for indentation. After a request by Hans Meine
1796 1801 <hans_meine-AT-gmx.net>
1797 1802 (_prefilter): add support so that typing plain 'exit' or 'quit'
1798 1803 does a sensible thing. Originally I tried to deviate as little as
1799 1804 possible from the default python behavior, but even that one may
1800 1805 change in this direction (thread on python-dev to that effect).
1801 1806 Regardless, ipython should do the right thing even if CPython's
1802 1807 '>>>' prompt doesn't.
1803 1808 (InteractiveShell): removed subclassing code.InteractiveConsole
1804 1809 class. By now we'd overridden just about all of its methods: I've
1805 1810 copied the remaining two over, and now ipython is a standalone
1806 1811 class. This will provide a clearer picture for the chainsaw
1807 1812 branch refactoring.
1808 1813
1809 1814 2005-12-26 Fernando Perez <Fernando.Perez@colorado.edu>
1810 1815
1811 1816 * IPython/ultraTB.py (VerboseTB.text): harden reporting against
1812 1817 failures for objects which break when dir() is called on them.
1813 1818
1814 1819 * IPython/FlexCompleter.py (Completer.__init__): Added support for
1815 1820 distinct local and global namespaces in the completer API. This
1816 1821 change allows us to properly handle completion with distinct
1817 1822 scopes, including in embedded instances (this had never really
1818 1823 worked correctly).
1819 1824
1820 1825 Note: this introduces a change in the constructor for
1821 1826 MagicCompleter, as a new global_namespace parameter is now the
1822 1827 second argument (the others were bumped one position).
1823 1828
1824 1829 2005-12-25 Fernando Perez <Fernando.Perez@colorado.edu>
1825 1830
1826 1831 * IPython/iplib.py (embed_mainloop): fix tab-completion in
1827 1832 embedded instances (which can be done now thanks to Vivian's
1828 1833 frame-handling fixes for pdb).
1829 1834 (InteractiveShell.__init__): Fix namespace handling problem in
1830 1835 embedded instances. We were overwriting __main__ unconditionally,
1831 1836 and this should only be done for 'full' (non-embedded) IPython;
1832 1837 embedded instances must respect the caller's __main__. Thanks to
1833 1838 a bug report by Yaroslav Bulatov <yaroslavvb-AT-gmail.com>
1834 1839
1835 1840 2005-12-24 Fernando Perez <Fernando.Perez@colorado.edu>
1836 1841
1837 1842 * setup.py: added download_url to setup(). This registers the
1838 1843 download address at PyPI, which is not only useful to humans
1839 1844 browsing the site, but is also picked up by setuptools (the Eggs
1840 1845 machinery). Thanks to Ville and R. Kern for the info/discussion
1841 1846 on this.
1842 1847
1843 1848 2005-12-23 Fernando Perez <Fernando.Perez@colorado.edu>
1844 1849
1845 1850 * IPython/Debugger.py (Pdb.__init__): Major pdb mode enhancements.
1846 1851 This brings a lot of nice functionality to the pdb mode, which now
1847 1852 has tab-completion, syntax highlighting, and better stack handling
1848 1853 than before. Many thanks to Vivian De Smedt
1849 1854 <vivian-AT-vdesmedt.com> for the original patches.
1850 1855
1851 1856 2005-12-08 Fernando Perez <Fernando.Perez@colorado.edu>
1852 1857
1853 1858 * IPython/Shell.py (IPShellGTK.mainloop): fix mainloop() calling
1854 1859 sequence to consistently accept the banner argument. The
1855 1860 inconsistency was tripping SAGE, thanks to Gary Zablackis
1856 1861 <gzabl-AT-yahoo.com> for the report.
1857 1862
1858 1863 2005-11-15 Fernando Perez <Fernando.Perez@colorado.edu>
1859 1864
1860 1865 * IPython/iplib.py (InteractiveShell.post_config_initialization):
1861 1866 Fix bug where a naked 'alias' call in the ipythonrc file would
1862 1867 cause a crash. Bug reported by Jorgen Stenarson.
1863 1868
1864 1869 2005-11-15 Fernando Perez <Fernando.Perez@colorado.edu>
1865 1870
1866 1871 * IPython/ipmaker.py (make_IPython): cleanups which should improve
1867 1872 startup time.
1868 1873
1869 1874 * IPython/iplib.py (runcode): my globals 'fix' for embedded
1870 1875 instances had introduced a bug with globals in normal code. Now
1871 1876 it's working in all cases.
1872 1877
1873 1878 * IPython/Magic.py (magic_psearch): Finish wildcard cleanup and
1874 1879 API changes. A new ipytonrc option, 'wildcards_case_sensitive'
1875 1880 has been introduced to set the default case sensitivity of the
1876 1881 searches. Users can still select either mode at runtime on a
1877 1882 per-search basis.
1878 1883
1879 1884 2005-11-13 Fernando Perez <Fernando.Perez@colorado.edu>
1880 1885
1881 1886 * IPython/wildcard.py (NameSpace.__init__): fix resolution of
1882 1887 attributes in wildcard searches for subclasses. Modified version
1883 1888 of a patch by Jorgen.
1884 1889
1885 1890 2005-11-12 Fernando Perez <Fernando.Perez@colorado.edu>
1886 1891
1887 1892 * IPython/iplib.py (embed_mainloop): Fix handling of globals for
1888 1893 embedded instances. I added a user_global_ns attribute to the
1889 1894 InteractiveShell class to handle this.
1890 1895
1891 1896 2005-10-31 Fernando Perez <Fernando.Perez@colorado.edu>
1892 1897
1893 1898 * IPython/Shell.py (IPShellGTK.mainloop): Change timeout_add to
1894 1899 idle_add, which fixes horrible keyboard lag problems under gtk 2.6
1895 1900 (reported under win32, but may happen also in other platforms).
1896 1901 Bug report and fix courtesy of Sean Moore <smm-AT-logic.bm>
1897 1902
1898 1903 2005-10-15 Fernando Perez <Fernando.Perez@colorado.edu>
1899 1904
1900 1905 * IPython/Magic.py (magic_psearch): new support for wildcard
1901 1906 patterns. Now, typing ?a*b will list all names which begin with a
1902 1907 and end in b, for example. The %psearch magic has full
1903 1908 docstrings. Many thanks to Jörgen Stenarson
1904 1909 <jorgen.stenarson-AT-bostream.nu>, author of the patches
1905 1910 implementing this functionality.
1906 1911
1907 1912 2005-09-27 Fernando Perez <Fernando.Perez@colorado.edu>
1908 1913
1909 1914 * Manual: fixed long-standing annoyance of double-dashes (as in
1910 1915 --prefix=~, for example) being stripped in the HTML version. This
1911 1916 is a latex2html bug, but a workaround was provided. Many thanks
1912 1917 to George K. Thiruvathukal <gthiruv-AT-luc.edu> for the detailed
1913 1918 help, and Michael Tobis <mtobis-AT-gmail.com> for getting the ball
1914 1919 rolling. This seemingly small issue had tripped a number of users
1915 1920 when first installing, so I'm glad to see it gone.
1916 1921
1917 1922 2005-09-27 Fernando Perez <Fernando.Perez@colorado.edu>
1918 1923
1919 1924 * IPython/Extensions/numeric_formats.py: fix missing import,
1920 1925 reported by Stephen Walton.
1921 1926
1922 1927 2005-09-24 Fernando Perez <Fernando.Perez@colorado.edu>
1923 1928
1924 1929 * IPython/demo.py: finish demo module, fully documented now.
1925 1930
1926 1931 * IPython/genutils.py (file_read): simple little utility to read a
1927 1932 file and ensure it's closed afterwards.
1928 1933
1929 1934 2005-09-23 Fernando Perez <Fernando.Perez@colorado.edu>
1930 1935
1931 1936 * IPython/demo.py (Demo.__init__): added support for individually
1932 1937 tagging blocks for automatic execution.
1933 1938
1934 1939 * IPython/Magic.py (magic_pycat): new %pycat magic for showing
1935 1940 syntax-highlighted python sources, requested by John.
1936 1941
1937 1942 2005-09-22 Fernando Perez <Fernando.Perez@colorado.edu>
1938 1943
1939 1944 * IPython/demo.py (Demo.again): fix bug where again() blocks after
1940 1945 finishing.
1941 1946
1942 1947 * IPython/genutils.py (shlex_split): moved from Magic to here,
1943 1948 where all 2.2 compatibility stuff lives. I needed it for demo.py.
1944 1949
1945 1950 * IPython/demo.py (Demo.__init__): added support for silent
1946 1951 blocks, improved marks as regexps, docstrings written.
1947 1952 (Demo.__init__): better docstring, added support for sys.argv.
1948 1953
1949 1954 * IPython/genutils.py (marquee): little utility used by the demo
1950 1955 code, handy in general.
1951 1956
1952 1957 * IPython/demo.py (Demo.__init__): new class for interactive
1953 1958 demos. Not documented yet, I just wrote it in a hurry for
1954 1959 scipy'05. Will docstring later.
1955 1960
1956 1961 2005-09-20 Fernando Perez <Fernando.Perez@colorado.edu>
1957 1962
1958 1963 * IPython/Shell.py (sigint_handler): Drastic simplification which
1959 1964 also seems to make Ctrl-C work correctly across threads! This is
1960 1965 so simple, that I can't beleive I'd missed it before. Needs more
1961 1966 testing, though.
1962 1967 (KBINT): Never mind, revert changes. I'm sure I'd tried something
1963 1968 like this before...
1964 1969
1965 1970 * IPython/genutils.py (get_home_dir): add protection against
1966 1971 non-dirs in win32 registry.
1967 1972
1968 1973 * IPython/iplib.py (InteractiveShell.alias_table_validate): fix
1969 1974 bug where dict was mutated while iterating (pysh crash).
1970 1975
1971 1976 2005-09-06 Fernando Perez <Fernando.Perez@colorado.edu>
1972 1977
1973 1978 * IPython/iplib.py (handle_auto): Fix inconsistency arising from
1974 1979 spurious newlines added by this routine. After a report by
1975 1980 F. Mantegazza.
1976 1981
1977 1982 2005-09-05 Fernando Perez <Fernando.Perez@colorado.edu>
1978 1983
1979 1984 * IPython/Shell.py (hijack_gtk): remove pygtk.require("2.0")
1980 1985 calls. These were a leftover from the GTK 1.x days, and can cause
1981 1986 problems in certain cases (after a report by John Hunter).
1982 1987
1983 1988 * IPython/iplib.py (InteractiveShell.__init__): Trap exception if
1984 1989 os.getcwd() fails at init time. Thanks to patch from David Remahl
1985 1990 <chmod007-AT-mac.com>.
1986 1991 (InteractiveShell.__init__): prevent certain special magics from
1987 1992 being shadowed by aliases. Closes
1988 1993 http://www.scipy.net/roundup/ipython/issue41.
1989 1994
1990 1995 2005-08-31 Fernando Perez <Fernando.Perez@colorado.edu>
1991 1996
1992 1997 * IPython/iplib.py (InteractiveShell.complete): Added new
1993 1998 top-level completion method to expose the completion mechanism
1994 1999 beyond readline-based environments.
1995 2000
1996 2001 2005-08-19 Fernando Perez <Fernando.Perez@colorado.edu>
1997 2002
1998 2003 * tools/ipsvnc (svnversion): fix svnversion capture.
1999 2004
2000 2005 * IPython/iplib.py (InteractiveShell.__init__): Add has_readline
2001 2006 attribute to self, which was missing. Before, it was set by a
2002 2007 routine which in certain cases wasn't being called, so the
2003 2008 instance could end up missing the attribute. This caused a crash.
2004 2009 Closes http://www.scipy.net/roundup/ipython/issue40.
2005 2010
2006 2011 2005-08-16 Fernando Perez <fperez@colorado.edu>
2007 2012
2008 2013 * IPython/ultraTB.py (VerboseTB.text): don't crash if object
2009 2014 contains non-string attribute. Closes
2010 2015 http://www.scipy.net/roundup/ipython/issue38.
2011 2016
2012 2017 2005-08-14 Fernando Perez <fperez@colorado.edu>
2013 2018
2014 2019 * tools/ipsvnc: Minor improvements, to add changeset info.
2015 2020
2016 2021 2005-08-12 Fernando Perez <fperez@colorado.edu>
2017 2022
2018 2023 * IPython/iplib.py (runsource): remove self.code_to_run_src
2019 2024 attribute. I realized this is nothing more than
2020 2025 '\n'.join(self.buffer), and having the same data in two different
2021 2026 places is just asking for synchronization bugs. This may impact
2022 2027 people who have custom exception handlers, so I need to warn
2023 2028 ipython-dev about it (F. Mantegazza may use them).
2024 2029
2025 2030 2005-07-29 Fernando Perez <Fernando.Perez@colorado.edu>
2026 2031
2027 2032 * IPython/genutils.py: fix 2.2 compatibility (generators)
2028 2033
2029 2034 2005-07-18 Fernando Perez <fperez@colorado.edu>
2030 2035
2031 2036 * IPython/genutils.py (get_home_dir): fix to help users with
2032 2037 invalid $HOME under win32.
2033 2038
2034 2039 2005-07-17 Fernando Perez <fperez@colorado.edu>
2035 2040
2036 2041 * IPython/Prompts.py (str_safe): Make unicode-safe. Also remove
2037 2042 some old hacks and clean up a bit other routines; code should be
2038 2043 simpler and a bit faster.
2039 2044
2040 2045 * IPython/iplib.py (interact): removed some last-resort attempts
2041 2046 to survive broken stdout/stderr. That code was only making it
2042 2047 harder to abstract out the i/o (necessary for gui integration),
2043 2048 and the crashes it could prevent were extremely rare in practice
2044 2049 (besides being fully user-induced in a pretty violent manner).
2045 2050
2046 2051 * IPython/genutils.py (IOStream.__init__): Simplify the i/o stuff.
2047 2052 Nothing major yet, but the code is simpler to read; this should
2048 2053 make it easier to do more serious modifications in the future.
2049 2054
2050 2055 * IPython/Extensions/InterpreterExec.py: Fix auto-quoting in pysh,
2051 2056 which broke in .15 (thanks to a report by Ville).
2052 2057
2053 2058 * IPython/Itpl.py (Itpl.__init__): add unicode support (it may not
2054 2059 be quite correct, I know next to nothing about unicode). This
2055 2060 will allow unicode strings to be used in prompts, amongst other
2056 2061 cases. It also will prevent ipython from crashing when unicode
2057 2062 shows up unexpectedly in many places. If ascii encoding fails, we
2058 2063 assume utf_8. Currently the encoding is not a user-visible
2059 2064 setting, though it could be made so if there is demand for it.
2060 2065
2061 2066 * IPython/ipmaker.py (make_IPython): remove old 2.1-specific hack.
2062 2067
2063 2068 * IPython/Struct.py (Struct.merge): switch keys() to iterator.
2064 2069
2065 2070 * IPython/background_jobs.py: moved 2.2 compatibility to genutils.
2066 2071
2067 2072 * IPython/genutils.py: Add 2.2 compatibility here, so all other
2068 2073 code can work transparently for 2.2/2.3.
2069 2074
2070 2075 2005-07-16 Fernando Perez <fperez@colorado.edu>
2071 2076
2072 2077 * IPython/ultraTB.py (ExceptionColors): Make a global variable
2073 2078 out of the color scheme table used for coloring exception
2074 2079 tracebacks. This allows user code to add new schemes at runtime.
2075 2080 This is a minimally modified version of the patch at
2076 2081 http://www.scipy.net/roundup/ipython/issue35, many thanks to pabw
2077 2082 for the contribution.
2078 2083
2079 2084 * IPython/FlexCompleter.py (Completer.attr_matches): Add a
2080 2085 slightly modified version of the patch in
2081 2086 http://www.scipy.net/roundup/ipython/issue34, which also allows me
2082 2087 to remove the previous try/except solution (which was costlier).
2083 2088 Thanks to Gaetan Lehmann <gaetan.lehmann-AT-jouy.inra.fr> for the fix.
2084 2089
2085 2090 2005-06-08 Fernando Perez <fperez@colorado.edu>
2086 2091
2087 2092 * IPython/iplib.py (write/write_err): Add methods to abstract all
2088 2093 I/O a bit more.
2089 2094
2090 2095 * IPython/Shell.py (IPShellGTK.mainloop): Fix GTK deprecation
2091 2096 warning, reported by Aric Hagberg, fix by JD Hunter.
2092 2097
2093 2098 2005-06-02 *** Released version 0.6.15
2094 2099
2095 2100 2005-06-01 Fernando Perez <fperez@colorado.edu>
2096 2101
2097 2102 * IPython/iplib.py (MagicCompleter.file_matches): Fix
2098 2103 tab-completion of filenames within open-quoted strings. Note that
2099 2104 this requires that in ~/.ipython/ipythonrc, users change the
2100 2105 readline delimiters configuration to read:
2101 2106
2102 2107 readline_remove_delims -/~
2103 2108
2104 2109
2105 2110 2005-05-31 *** Released version 0.6.14
2106 2111
2107 2112 2005-05-29 Fernando Perez <fperez@colorado.edu>
2108 2113
2109 2114 * IPython/ultraTB.py (VerboseTB.text): Fix crash for tracebacks
2110 2115 with files not on the filesystem. Reported by Eliyahu Sandler
2111 2116 <eli@gondolin.net>
2112 2117
2113 2118 2005-05-22 Fernando Perez <fperez@colorado.edu>
2114 2119
2115 2120 * IPython/iplib.py: Fix a few crashes in the --upgrade option.
2116 2121 After an initial report by LUK ShunTim <shuntim.luk@polyu.edu.hk>.
2117 2122
2118 2123 2005-05-19 Fernando Perez <fperez@colorado.edu>
2119 2124
2120 2125 * IPython/iplib.py (safe_execfile): close a file which could be
2121 2126 left open (causing problems in win32, which locks open files).
2122 2127 Thanks to a bug report by D Brown <dbrown2@yahoo.com>.
2123 2128
2124 2129 2005-05-18 Fernando Perez <fperez@colorado.edu>
2125 2130
2126 2131 * IPython/Shell.py (MatplotlibShellBase.mplot_exec): pass all
2127 2132 keyword arguments correctly to safe_execfile().
2128 2133
2129 2134 2005-05-13 Fernando Perez <fperez@colorado.edu>
2130 2135
2131 2136 * ipython.1: Added info about Qt to manpage, and threads warning
2132 2137 to usage page (invoked with --help).
2133 2138
2134 2139 * IPython/iplib.py (MagicCompleter.python_func_kw_matches): Added
2135 2140 new matcher (it goes at the end of the priority list) to do
2136 2141 tab-completion on named function arguments. Submitted by George
2137 2142 Sakkis <gsakkis-AT-eden.rutgers.edu>. See the thread at
2138 2143 http://www.scipy.net/pipermail/ipython-dev/2005-April/000436.html
2139 2144 for more details.
2140 2145
2141 2146 * IPython/Magic.py (magic_run): Added new -e flag to ignore
2142 2147 SystemExit exceptions in the script being run. Thanks to a report
2143 2148 by danny shevitz <danny_shevitz-AT-yahoo.com>, about this
2144 2149 producing very annoying behavior when running unit tests.
2145 2150
2146 2151 2005-05-12 Fernando Perez <fperez@colorado.edu>
2147 2152
2148 2153 * IPython/iplib.py (handle_auto): fixed auto-quoting and parens,
2149 2154 which I'd broken (again) due to a changed regexp. In the process,
2150 2155 added ';' as an escape to auto-quote the whole line without
2151 2156 splitting its arguments. Thanks to a report by Jerry McRae
2152 2157 <qrs0xyc02-AT-sneakemail.com>.
2153 2158
2154 2159 * IPython/ultraTB.py (VerboseTB.text): protect against rare but
2155 2160 possible crashes caused by a TokenError. Reported by Ed Schofield
2156 2161 <schofield-AT-ftw.at>.
2157 2162
2158 2163 2005-05-06 Fernando Perez <fperez@colorado.edu>
2159 2164
2160 2165 * IPython/Shell.py (hijack_wx): Fix to work with WX v.2.6.
2161 2166
2162 2167 2005-04-29 Fernando Perez <fperez@colorado.edu>
2163 2168
2164 2169 * IPython/Shell.py (IPShellQt): Thanks to Denis Rivière
2165 2170 <nudz-AT-free.fr>, Yann Cointepas <yann-AT-sapetnioc.org> and Benjamin
2166 2171 Thyreau <Benji2-AT-decideur.info>, we now have a -qthread option
2167 2172 which provides support for Qt interactive usage (similar to the
2168 2173 existing one for WX and GTK). This had been often requested.
2169 2174
2170 2175 2005-04-14 *** Released version 0.6.13
2171 2176
2172 2177 2005-04-08 Fernando Perez <fperez@colorado.edu>
2173 2178
2174 2179 * IPython/Magic.py (Magic._ofind): remove docstring evaluation
2175 2180 from _ofind, which gets called on almost every input line. Now,
2176 2181 we only try to get docstrings if they are actually going to be
2177 2182 used (the overhead of fetching unnecessary docstrings can be
2178 2183 noticeable for certain objects, such as Pyro proxies).
2179 2184
2180 2185 * IPython/iplib.py (MagicCompleter.python_matches): Change the API
2181 2186 for completers. For some reason I had been passing them the state
2182 2187 variable, which completers never actually need, and was in
2183 2188 conflict with the rlcompleter API. Custom completers ONLY need to
2184 2189 take the text parameter.
2185 2190
2186 2191 * IPython/Extensions/InterpreterExec.py: Fix regexp so that magics
2187 2192 work correctly in pysh. I've also moved all the logic which used
2188 2193 to be in pysh.py here, which will prevent problems with future
2189 2194 upgrades. However, this time I must warn users to update their
2190 2195 pysh profile to include the line
2191 2196
2192 2197 import_all IPython.Extensions.InterpreterExec
2193 2198
2194 2199 because otherwise things won't work for them. They MUST also
2195 2200 delete pysh.py and the line
2196 2201
2197 2202 execfile pysh.py
2198 2203
2199 2204 from their ipythonrc-pysh.
2200 2205
2201 2206 * IPython/FlexCompleter.py (Completer.attr_matches): Make more
2202 2207 robust in the face of objects whose dir() returns non-strings
2203 2208 (which it shouldn't, but some broken libs like ITK do). Thanks to
2204 2209 a patch by John Hunter (implemented differently, though). Also
2205 2210 minor improvements by using .extend instead of + on lists.
2206 2211
2207 2212 * pysh.py:
2208 2213
2209 2214 2005-04-06 Fernando Perez <fperez@colorado.edu>
2210 2215
2211 2216 * IPython/ipmaker.py (make_IPython): Make multi_line_specials on
2212 2217 by default, so that all users benefit from it. Those who don't
2213 2218 want it can still turn it off.
2214 2219
2215 2220 * IPython/UserConfig/ipythonrc: Add multi_line_specials to the
2216 2221 config file, I'd forgotten about this, so users were getting it
2217 2222 off by default.
2218 2223
2219 2224 * IPython/iplib.py (ipmagic): big overhaul of the magic system for
2220 2225 consistency. Now magics can be called in multiline statements,
2221 2226 and python variables can be expanded in magic calls via $var.
2222 2227 This makes the magic system behave just like aliases or !system
2223 2228 calls.
2224 2229
2225 2230 2005-03-28 Fernando Perez <fperez@colorado.edu>
2226 2231
2227 2232 * IPython/iplib.py (handle_auto): cleanup to use %s instead of
2228 2233 expensive string additions for building command. Add support for
2229 2234 trailing ';' when autocall is used.
2230 2235
2231 2236 2005-03-26 Fernando Perez <fperez@colorado.edu>
2232 2237
2233 2238 * ipython.el: Fix http://www.scipy.net/roundup/ipython/issue31.
2234 2239 Bugfix by A. Schmolck, the ipython.el maintainer. Also make
2235 2240 ipython.el robust against prompts with any number of spaces
2236 2241 (including 0) after the ':' character.
2237 2242
2238 2243 * IPython/Prompts.py (Prompt2.set_p_str): Fix spurious space in
2239 2244 continuation prompt, which misled users to think the line was
2240 2245 already indented. Closes debian Bug#300847, reported to me by
2241 2246 Norbert Tretkowski <tretkowski-AT-inittab.de>.
2242 2247
2243 2248 2005-03-23 Fernando Perez <fperez@colorado.edu>
2244 2249
2245 2250 * IPython/Prompts.py (Prompt1.__str__): Make sure that prompts are
2246 2251 properly aligned if they have embedded newlines.
2247 2252
2248 2253 * IPython/iplib.py (runlines): Add a public method to expose
2249 2254 IPython's code execution machinery, so that users can run strings
2250 2255 as if they had been typed at the prompt interactively.
2251 2256 (InteractiveShell.__init__): Added getoutput() to the __IPYTHON__
2252 2257 methods which can call the system shell, but with python variable
2253 2258 expansion. The three such methods are: __IPYTHON__.system,
2254 2259 .getoutput and .getoutputerror. These need to be documented in a
2255 2260 'public API' section (to be written) of the manual.
2256 2261
2257 2262 2005-03-20 Fernando Perez <fperez@colorado.edu>
2258 2263
2259 2264 * IPython/iplib.py (InteractiveShell.set_custom_exc): new system
2260 2265 for custom exception handling. This is quite powerful, and it
2261 2266 allows for user-installable exception handlers which can trap
2262 2267 custom exceptions at runtime and treat them separately from
2263 2268 IPython's default mechanisms. At the request of Frédéric
2264 2269 Mantegazza <mantegazza-AT-ill.fr>.
2265 2270 (InteractiveShell.set_custom_completer): public API function to
2266 2271 add new completers at runtime.
2267 2272
2268 2273 2005-03-19 Fernando Perez <fperez@colorado.edu>
2269 2274
2270 2275 * IPython/OInspect.py (getdoc): Add a call to obj.getdoc(), to
2271 2276 allow objects which provide their docstrings via non-standard
2272 2277 mechanisms (like Pyro proxies) to still be inspected by ipython's
2273 2278 ? system.
2274 2279
2275 2280 * IPython/iplib.py (InteractiveShell.__init__): back off the _o/_e
2276 2281 automatic capture system. I tried quite hard to make it work
2277 2282 reliably, and simply failed. I tried many combinations with the
2278 2283 subprocess module, but eventually nothing worked in all needed
2279 2284 cases (not blocking stdin for the child, duplicating stdout
2280 2285 without blocking, etc). The new %sc/%sx still do capture to these
2281 2286 magical list/string objects which make shell use much more
2282 2287 conveninent, so not all is lost.
2283 2288
2284 2289 XXX - FIX MANUAL for the change above!
2285 2290
2286 2291 (runsource): I copied code.py's runsource() into ipython to modify
2287 2292 it a bit. Now the code object and source to be executed are
2288 2293 stored in ipython. This makes this info accessible to third-party
2289 2294 tools, like custom exception handlers. After a request by Frédéric
2290 2295 Mantegazza <mantegazza-AT-ill.fr>.
2291 2296
2292 2297 * IPython/UserConfig/ipythonrc: Add up/down arrow keys to
2293 2298 history-search via readline (like C-p/C-n). I'd wanted this for a
2294 2299 long time, but only recently found out how to do it. For users
2295 2300 who already have their ipythonrc files made and want this, just
2296 2301 add:
2297 2302
2298 2303 readline_parse_and_bind "\e[A": history-search-backward
2299 2304 readline_parse_and_bind "\e[B": history-search-forward
2300 2305
2301 2306 2005-03-18 Fernando Perez <fperez@colorado.edu>
2302 2307
2303 2308 * IPython/Magic.py (magic_sc): %sc and %sx now use the fancy
2304 2309 LSString and SList classes which allow transparent conversions
2305 2310 between list mode and whitespace-separated string.
2306 2311 (magic_r): Fix recursion problem in %r.
2307 2312
2308 2313 * IPython/genutils.py (LSString): New class to be used for
2309 2314 automatic storage of the results of all alias/system calls in _o
2310 2315 and _e (stdout/err). These provide a .l/.list attribute which
2311 2316 does automatic splitting on newlines. This means that for most
2312 2317 uses, you'll never need to do capturing of output with %sc/%sx
2313 2318 anymore, since ipython keeps this always done for you. Note that
2314 2319 only the LAST results are stored, the _o/e variables are
2315 2320 overwritten on each call. If you need to save their contents
2316 2321 further, simply bind them to any other name.
2317 2322
2318 2323 2005-03-17 Fernando Perez <fperez@colorado.edu>
2319 2324
2320 2325 * IPython/Prompts.py (BasePrompt.cwd_filt): a few more fixes for
2321 2326 prompt namespace handling.
2322 2327
2323 2328 2005-03-16 Fernando Perez <fperez@colorado.edu>
2324 2329
2325 2330 * IPython/Prompts.py (CachedOutput.__init__): Fix default and
2326 2331 classic prompts to be '>>> ' (final space was missing, and it
2327 2332 trips the emacs python mode).
2328 2333 (BasePrompt.__str__): Added safe support for dynamic prompt
2329 2334 strings. Now you can set your prompt string to be '$x', and the
2330 2335 value of x will be printed from your interactive namespace. The
2331 2336 interpolation syntax includes the full Itpl support, so
2332 2337 ${foo()+x+bar()} is a valid prompt string now, and the function
2333 2338 calls will be made at runtime.
2334 2339
2335 2340 2005-03-15 Fernando Perez <fperez@colorado.edu>
2336 2341
2337 2342 * IPython/Magic.py (magic_history): renamed %hist to %history, to
2338 2343 avoid name clashes in pylab. %hist still works, it just forwards
2339 2344 the call to %history.
2340 2345
2341 2346 2005-03-02 *** Released version 0.6.12
2342 2347
2343 2348 2005-03-02 Fernando Perez <fperez@colorado.edu>
2344 2349
2345 2350 * IPython/iplib.py (handle_magic): log magic calls properly as
2346 2351 ipmagic() function calls.
2347 2352
2348 2353 * IPython/Magic.py (magic_time): Improved %time to support
2349 2354 statements and provide wall-clock as well as CPU time.
2350 2355
2351 2356 2005-02-27 Fernando Perez <fperez@colorado.edu>
2352 2357
2353 2358 * IPython/hooks.py: New hooks module, to expose user-modifiable
2354 2359 IPython functionality in a clean manner. For now only the editor
2355 2360 hook is actually written, and other thigns which I intend to turn
2356 2361 into proper hooks aren't yet there. The display and prefilter
2357 2362 stuff, for example, should be hooks. But at least now the
2358 2363 framework is in place, and the rest can be moved here with more
2359 2364 time later. IPython had had a .hooks variable for a long time for
2360 2365 this purpose, but I'd never actually used it for anything.
2361 2366
2362 2367 2005-02-26 Fernando Perez <fperez@colorado.edu>
2363 2368
2364 2369 * IPython/ipmaker.py (make_IPython): make the default ipython
2365 2370 directory be called _ipython under win32, to follow more the
2366 2371 naming peculiarities of that platform (where buggy software like
2367 2372 Visual Sourcesafe breaks with .named directories). Reported by
2368 2373 Ville Vainio.
2369 2374
2370 2375 2005-02-23 Fernando Perez <fperez@colorado.edu>
2371 2376
2372 2377 * IPython/iplib.py (InteractiveShell.__init__): removed a few
2373 2378 auto_aliases for win32 which were causing problems. Users can
2374 2379 define the ones they personally like.
2375 2380
2376 2381 2005-02-21 Fernando Perez <fperez@colorado.edu>
2377 2382
2378 2383 * IPython/Magic.py (magic_time): new magic to time execution of
2379 2384 expressions. After a request by Charles Moad <cmoad-AT-indiana.edu>.
2380 2385
2381 2386 2005-02-19 Fernando Perez <fperez@colorado.edu>
2382 2387
2383 2388 * IPython/ConfigLoader.py (ConfigLoader.load): Allow empty strings
2384 2389 into keys (for prompts, for example).
2385 2390
2386 2391 * IPython/Prompts.py (BasePrompt.set_p_str): Fix to allow empty
2387 2392 prompts in case users want them. This introduces a small behavior
2388 2393 change: ipython does not automatically add a space to all prompts
2389 2394 anymore. To get the old prompts with a space, users should add it
2390 2395 manually to their ipythonrc file, so for example prompt_in1 should
2391 2396 now read 'In [\#]: ' instead of 'In [\#]:'.
2392 2397 (BasePrompt.__init__): New option prompts_pad_left (only in rc
2393 2398 file) to control left-padding of secondary prompts.
2394 2399
2395 2400 * IPython/Magic.py (Magic.profile_missing_notice): Don't crash if
2396 2401 the profiler can't be imported. Fix for Debian, which removed
2397 2402 profile.py because of License issues. I applied a slightly
2398 2403 modified version of the original Debian patch at
2399 2404 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=294500.
2400 2405
2401 2406 2005-02-17 Fernando Perez <fperez@colorado.edu>
2402 2407
2403 2408 * IPython/genutils.py (native_line_ends): Fix bug which would
2404 2409 cause improper line-ends under win32 b/c I was not opening files
2405 2410 in binary mode. Bug report and fix thanks to Ville.
2406 2411
2407 2412 * IPython/iplib.py (handle_auto): Fix bug which I introduced when
2408 2413 trying to catch spurious foo[1] autocalls. My fix actually broke
2409 2414 ',/' autoquote/call with explicit escape (bad regexp).
2410 2415
2411 2416 2005-02-15 *** Released version 0.6.11
2412 2417
2413 2418 2005-02-14 Fernando Perez <fperez@colorado.edu>
2414 2419
2415 2420 * IPython/background_jobs.py: New background job management
2416 2421 subsystem. This is implemented via a new set of classes, and
2417 2422 IPython now provides a builtin 'jobs' object for background job
2418 2423 execution. A convenience %bg magic serves as a lightweight
2419 2424 frontend for starting the more common type of calls. This was
2420 2425 inspired by discussions with B. Granger and the BackgroundCommand
2421 2426 class described in the book Python Scripting for Computational
2422 2427 Science, by H. P. Langtangen: http://folk.uio.no/hpl/scripting
2423 2428 (although ultimately no code from this text was used, as IPython's
2424 2429 system is a separate implementation).
2425 2430
2426 2431 * IPython/iplib.py (MagicCompleter.python_matches): add new option
2427 2432 to control the completion of single/double underscore names
2428 2433 separately. As documented in the example ipytonrc file, the
2429 2434 readline_omit__names variable can now be set to 2, to omit even
2430 2435 single underscore names. Thanks to a patch by Brian Wong
2431 2436 <BrianWong-AT-AirgoNetworks.Com>.
2432 2437 (InteractiveShell.__init__): Fix bug which would cause foo[1] to
2433 2438 be autocalled as foo([1]) if foo were callable. A problem for
2434 2439 things which are both callable and implement __getitem__.
2435 2440 (init_readline): Fix autoindentation for win32. Thanks to a patch
2436 2441 by Vivian De Smedt <vivian-AT-vdesmedt.com>.
2437 2442
2438 2443 2005-02-12 Fernando Perez <fperez@colorado.edu>
2439 2444
2440 2445 * IPython/ipmaker.py (make_IPython): Disabled the stout traps
2441 2446 which I had written long ago to sort out user error messages which
2442 2447 may occur during startup. This seemed like a good idea initially,
2443 2448 but it has proven a disaster in retrospect. I don't want to
2444 2449 change much code for now, so my fix is to set the internal 'debug'
2445 2450 flag to true everywhere, whose only job was precisely to control
2446 2451 this subsystem. This closes issue 28 (as well as avoiding all
2447 2452 sorts of strange hangups which occur from time to time).
2448 2453
2449 2454 2005-02-07 Fernando Perez <fperez@colorado.edu>
2450 2455
2451 2456 * IPython/Magic.py (magic_edit): Fix 'ed -p' not working when the
2452 2457 previous call produced a syntax error.
2453 2458
2454 2459 * IPython/OInspect.py (Inspector.pinfo): Fix crash when inspecting
2455 2460 classes without constructor.
2456 2461
2457 2462 2005-02-06 Fernando Perez <fperez@colorado.edu>
2458 2463
2459 2464 * IPython/iplib.py (MagicCompleter.complete): Extend the list of
2460 2465 completions with the results of each matcher, so we return results
2461 2466 to the user from all namespaces. This breaks with ipython
2462 2467 tradition, but I think it's a nicer behavior. Now you get all
2463 2468 possible completions listed, from all possible namespaces (python,
2464 2469 filesystem, magics...) After a request by John Hunter
2465 2470 <jdhunter-AT-nitace.bsd.uchicago.edu>.
2466 2471
2467 2472 2005-02-05 Fernando Perez <fperez@colorado.edu>
2468 2473
2469 2474 * IPython/Magic.py (magic_prun): Fix bug where prun would fail if
2470 2475 the call had quote characters in it (the quotes were stripped).
2471 2476
2472 2477 2005-01-31 Fernando Perez <fperez@colorado.edu>
2473 2478
2474 2479 * IPython/iplib.py (InteractiveShell.__init__): reduce reliance on
2475 2480 Itpl.itpl() to make the code more robust against psyco
2476 2481 optimizations.
2477 2482
2478 2483 * IPython/Itpl.py (Itpl.__str__): Use a _getframe() call instead
2479 2484 of causing an exception. Quicker, cleaner.
2480 2485
2481 2486 2005-01-28 Fernando Perez <fperez@colorado.edu>
2482 2487
2483 2488 * scripts/ipython_win_post_install.py (install): hardcode
2484 2489 sys.prefix+'python.exe' as the executable path. It turns out that
2485 2490 during the post-installation run, sys.executable resolves to the
2486 2491 name of the binary installer! I should report this as a distutils
2487 2492 bug, I think. I updated the .10 release with this tiny fix, to
2488 2493 avoid annoying the lists further.
2489 2494
2490 2495 2005-01-27 *** Released version 0.6.10
2491 2496
2492 2497 2005-01-27 Fernando Perez <fperez@colorado.edu>
2493 2498
2494 2499 * IPython/numutils.py (norm): Added 'inf' as optional name for
2495 2500 L-infinity norm, included references to mathworld.com for vector
2496 2501 norm definitions.
2497 2502 (amin/amax): added amin/amax for array min/max. Similar to what
2498 2503 pylab ships with after the recent reorganization of names.
2499 2504 (spike/spike_odd): removed deprecated spike/spike_odd functions.
2500 2505
2501 2506 * ipython.el: committed Alex's recent fixes and improvements.
2502 2507 Tested with python-mode from CVS, and it looks excellent. Since
2503 2508 python-mode hasn't released anything in a while, I'm temporarily
2504 2509 putting a copy of today's CVS (v 4.70) of python-mode in:
2505 2510 http://ipython.scipy.org/tmp/python-mode.el
2506 2511
2507 2512 * scripts/ipython_win_post_install.py (install): Win32 fix to use
2508 2513 sys.executable for the executable name, instead of assuming it's
2509 2514 called 'python.exe' (the post-installer would have produced broken
2510 2515 setups on systems with a differently named python binary).
2511 2516
2512 2517 * IPython/PyColorize.py (Parser.__call__): change explicit '\n'
2513 2518 references to os.linesep, to make the code more
2514 2519 platform-independent. This is also part of the win32 coloring
2515 2520 fixes.
2516 2521
2517 2522 * IPython/genutils.py (page_dumb): Remove attempts to chop long
2518 2523 lines, which actually cause coloring bugs because the length of
2519 2524 the line is very difficult to correctly compute with embedded
2520 2525 escapes. This was the source of all the coloring problems under
2521 2526 Win32. I think that _finally_, Win32 users have a properly
2522 2527 working ipython in all respects. This would never have happened
2523 2528 if not for Gary Bishop and Viktor Ransmayr's great help and work.
2524 2529
2525 2530 2005-01-26 *** Released version 0.6.9
2526 2531
2527 2532 2005-01-25 Fernando Perez <fperez@colorado.edu>
2528 2533
2529 2534 * setup.py: finally, we have a true Windows installer, thanks to
2530 2535 the excellent work of Viktor Ransmayr
2531 2536 <viktor.ransmayr-AT-t-online.de>. The docs have been updated for
2532 2537 Windows users. The setup routine is quite a bit cleaner thanks to
2533 2538 this, and the post-install script uses the proper functions to
2534 2539 allow a clean de-installation using the standard Windows Control
2535 2540 Panel.
2536 2541
2537 2542 * IPython/genutils.py (get_home_dir): changed to use the $HOME
2538 2543 environment variable under all OSes (including win32) if
2539 2544 available. This will give consistency to win32 users who have set
2540 2545 this variable for any reason. If os.environ['HOME'] fails, the
2541 2546 previous policy of using HOMEDRIVE\HOMEPATH kicks in.
2542 2547
2543 2548 2005-01-24 Fernando Perez <fperez@colorado.edu>
2544 2549
2545 2550 * IPython/numutils.py (empty_like): add empty_like(), similar to
2546 2551 zeros_like() but taking advantage of the new empty() Numeric routine.
2547 2552
2548 2553 2005-01-23 *** Released version 0.6.8
2549 2554
2550 2555 2005-01-22 Fernando Perez <fperez@colorado.edu>
2551 2556
2552 2557 * IPython/Shell.py (MatplotlibShellBase.mplot_exec): I removed the
2553 2558 automatic show() calls. After discussing things with JDH, it
2554 2559 turns out there are too many corner cases where this can go wrong.
2555 2560 It's best not to try to be 'too smart', and simply have ipython
2556 2561 reproduce as much as possible the default behavior of a normal
2557 2562 python shell.
2558 2563
2559 2564 * IPython/iplib.py (InteractiveShell.__init__): Modified the
2560 2565 line-splitting regexp and _prefilter() to avoid calling getattr()
2561 2566 on assignments. This closes
2562 2567 http://www.scipy.net/roundup/ipython/issue24. Note that Python's
2563 2568 readline uses getattr(), so a simple <TAB> keypress is still
2564 2569 enough to trigger getattr() calls on an object.
2565 2570
2566 2571 2005-01-21 Fernando Perez <fperez@colorado.edu>
2567 2572
2568 2573 * IPython/Shell.py (MatplotlibShellBase.magic_run): Fix the %run
2569 2574 docstring under pylab so it doesn't mask the original.
2570 2575
2571 2576 2005-01-21 *** Released version 0.6.7
2572 2577
2573 2578 2005-01-21 Fernando Perez <fperez@colorado.edu>
2574 2579
2575 2580 * IPython/Shell.py (MTInteractiveShell.runcode): Trap a crash with
2576 2581 signal handling for win32 users in multithreaded mode.
2577 2582
2578 2583 2005-01-17 Fernando Perez <fperez@colorado.edu>
2579 2584
2580 2585 * IPython/OInspect.py (Inspector.pinfo): Fix crash when inspecting
2581 2586 instances with no __init__. After a crash report by Norbert Nemec
2582 2587 <Norbert-AT-nemec-online.de>.
2583 2588
2584 2589 2005-01-14 Fernando Perez <fperez@colorado.edu>
2585 2590
2586 2591 * IPython/ultraTB.py (VerboseTB.text): Fix bug in reporting of
2587 2592 names for verbose exceptions, when multiple dotted names and the
2588 2593 'parent' object were present on the same line.
2589 2594
2590 2595 2005-01-11 Fernando Perez <fperez@colorado.edu>
2591 2596
2592 2597 * IPython/genutils.py (flag_calls): new utility to trap and flag
2593 2598 calls in functions. I need it to clean up matplotlib support.
2594 2599 Also removed some deprecated code in genutils.
2595 2600
2596 2601 * IPython/Shell.py (MatplotlibShellBase.mplot_exec): small fix so
2597 2602 that matplotlib scripts called with %run, which don't call show()
2598 2603 themselves, still have their plotting windows open.
2599 2604
2600 2605 2005-01-05 Fernando Perez <fperez@colorado.edu>
2601 2606
2602 2607 * IPython/Shell.py (IPShellGTK.__init__): Patch by Andrew Straw
2603 2608 <astraw-AT-caltech.edu>, to fix gtk deprecation warnings.
2604 2609
2605 2610 2004-12-19 Fernando Perez <fperez@colorado.edu>
2606 2611
2607 2612 * IPython/Shell.py (MTInteractiveShell.runcode): Get rid of
2608 2613 parent_runcode, which was an eyesore. The same result can be
2609 2614 obtained with Python's regular superclass mechanisms.
2610 2615
2611 2616 2004-12-17 Fernando Perez <fperez@colorado.edu>
2612 2617
2613 2618 * IPython/Magic.py (Magic.magic_sc): Fix quote stripping problem
2614 2619 reported by Prabhu.
2615 2620 (Magic.magic_sx): direct all errors to Term.cerr (defaults to
2616 2621 sys.stderr) instead of explicitly calling sys.stderr. This helps
2617 2622 maintain our I/O abstractions clean, for future GUI embeddings.
2618 2623
2619 2624 * IPython/genutils.py (info): added new utility for sys.stderr
2620 2625 unified info message handling (thin wrapper around warn()).
2621 2626
2622 2627 * IPython/ultraTB.py (VerboseTB.text): Fix misreported global
2623 2628 composite (dotted) names on verbose exceptions.
2624 2629 (VerboseTB.nullrepr): harden against another kind of errors which
2625 2630 Python's inspect module can trigger, and which were crashing
2626 2631 IPython. Thanks to a report by Marco Lombardi
2627 2632 <mlombard-AT-ma010192.hq.eso.org>.
2628 2633
2629 2634 2004-12-13 *** Released version 0.6.6
2630 2635
2631 2636 2004-12-12 Fernando Perez <fperez@colorado.edu>
2632 2637
2633 2638 * IPython/Shell.py (IPShellGTK.mainloop): catch RuntimeErrors
2634 2639 generated by pygtk upon initialization if it was built without
2635 2640 threads (for matplotlib users). After a crash reported by
2636 2641 Leguijt, Jaap J SIEP-EPT-RES <Jaap.Leguijt-AT-shell.com>.
2637 2642
2638 2643 * IPython/ipmaker.py (make_IPython): fix small bug in the
2639 2644 import_some parameter for multiple imports.
2640 2645
2641 2646 * IPython/iplib.py (ipmagic): simplified the interface of
2642 2647 ipmagic() to take a single string argument, just as it would be
2643 2648 typed at the IPython cmd line.
2644 2649 (ipalias): Added new ipalias() with an interface identical to
2645 2650 ipmagic(). This completes exposing a pure python interface to the
2646 2651 alias and magic system, which can be used in loops or more complex
2647 2652 code where IPython's automatic line mangling is not active.
2648 2653
2649 2654 * IPython/genutils.py (timing): changed interface of timing to
2650 2655 simply run code once, which is the most common case. timings()
2651 2656 remains unchanged, for the cases where you want multiple runs.
2652 2657
2653 2658 * IPython/Shell.py (MatplotlibShellBase._matplotlib_config): Fix a
2654 2659 bug where Python2.2 crashes with exec'ing code which does not end
2655 2660 in a single newline. Python 2.3 is OK, so I hadn't noticed this
2656 2661 before.
2657 2662
2658 2663 2004-12-10 Fernando Perez <fperez@colorado.edu>
2659 2664
2660 2665 * IPython/Magic.py (Magic.magic_prun): changed name of option from
2661 2666 -t to -T, to accomodate the new -t flag in %run (the %run and
2662 2667 %prun options are kind of intermixed, and it's not easy to change
2663 2668 this with the limitations of python's getopt).
2664 2669
2665 2670 * IPython/Magic.py (Magic.magic_run): Added new -t option to time
2666 2671 the execution of scripts. It's not as fine-tuned as timeit.py,
2667 2672 but it works from inside ipython (and under 2.2, which lacks
2668 2673 timeit.py). Optionally a number of runs > 1 can be given for
2669 2674 timing very short-running code.
2670 2675
2671 2676 * IPython/genutils.py (uniq_stable): new routine which returns a
2672 2677 list of unique elements in any iterable, but in stable order of
2673 2678 appearance. I needed this for the ultraTB fixes, and it's a handy
2674 2679 utility.
2675 2680
2676 2681 * IPython/ultraTB.py (VerboseTB.text): Fix proper reporting of
2677 2682 dotted names in Verbose exceptions. This had been broken since
2678 2683 the very start, now x.y will properly be printed in a Verbose
2679 2684 traceback, instead of x being shown and y appearing always as an
2680 2685 'undefined global'. Getting this to work was a bit tricky,
2681 2686 because by default python tokenizers are stateless. Saved by
2682 2687 python's ability to easily add a bit of state to an arbitrary
2683 2688 function (without needing to build a full-blown callable object).
2684 2689
2685 2690 Also big cleanup of this code, which had horrendous runtime
2686 2691 lookups of zillions of attributes for colorization. Moved all
2687 2692 this code into a few templates, which make it cleaner and quicker.
2688 2693
2689 2694 Printout quality was also improved for Verbose exceptions: one
2690 2695 variable per line, and memory addresses are printed (this can be
2691 2696 quite handy in nasty debugging situations, which is what Verbose
2692 2697 is for).
2693 2698
2694 2699 * IPython/ipmaker.py (make_IPython): Do NOT execute files named in
2695 2700 the command line as scripts to be loaded by embedded instances.
2696 2701 Doing so has the potential for an infinite recursion if there are
2697 2702 exceptions thrown in the process. This fixes a strange crash
2698 2703 reported by Philippe MULLER <muller-AT-irit.fr>.
2699 2704
2700 2705 2004-12-09 Fernando Perez <fperez@colorado.edu>
2701 2706
2702 2707 * IPython/Shell.py (MatplotlibShellBase.use): Change pylab support
2703 2708 to reflect new names in matplotlib, which now expose the
2704 2709 matlab-compatible interface via a pylab module instead of the
2705 2710 'matlab' name. The new code is backwards compatible, so users of
2706 2711 all matplotlib versions are OK. Patch by J. Hunter.
2707 2712
2708 2713 * IPython/OInspect.py (Inspector.pinfo): Add to object? printing
2709 2714 of __init__ docstrings for instances (class docstrings are already
2710 2715 automatically printed). Instances with customized docstrings
2711 2716 (indep. of the class) are also recognized and all 3 separate
2712 2717 docstrings are printed (instance, class, constructor). After some
2713 2718 comments/suggestions by J. Hunter.
2714 2719
2715 2720 2004-12-05 Fernando Perez <fperez@colorado.edu>
2716 2721
2717 2722 * IPython/iplib.py (MagicCompleter.complete): Remove annoying
2718 2723 warnings when tab-completion fails and triggers an exception.
2719 2724
2720 2725 2004-12-03 Fernando Perez <fperez@colorado.edu>
2721 2726
2722 2727 * IPython/Magic.py (magic_prun): Fix bug where an exception would
2723 2728 be triggered when using 'run -p'. An incorrect option flag was
2724 2729 being set ('d' instead of 'D').
2725 2730 (manpage): fix missing escaped \- sign.
2726 2731
2727 2732 2004-11-30 *** Released version 0.6.5
2728 2733
2729 2734 2004-11-30 Fernando Perez <fperez@colorado.edu>
2730 2735
2731 2736 * IPython/Magic.py (Magic.magic_run): Fix bug in breakpoint
2732 2737 setting with -d option.
2733 2738
2734 2739 * setup.py (docfiles): Fix problem where the doc glob I was using
2735 2740 was COMPLETELY BROKEN. It was giving the right files by pure
2736 2741 accident, but failed once I tried to include ipython.el. Note:
2737 2742 glob() does NOT allow you to do exclusion on multiple endings!
2738 2743
2739 2744 2004-11-29 Fernando Perez <fperez@colorado.edu>
2740 2745
2741 2746 * IPython/usage.py (__doc__): cleaned up usage docstring, by using
2742 2747 the manpage as the source. Better formatting & consistency.
2743 2748
2744 2749 * IPython/Magic.py (magic_run): Added new -d option, to run
2745 2750 scripts under the control of the python pdb debugger. Note that
2746 2751 this required changing the %prun option -d to -D, to avoid a clash
2747 2752 (since %run must pass options to %prun, and getopt is too dumb to
2748 2753 handle options with string values with embedded spaces). Thanks
2749 2754 to a suggestion by Matthew Arnison <maffew-AT-cat.org.au>.
2750 2755 (magic_who_ls): added type matching to %who and %whos, so that one
2751 2756 can filter their output to only include variables of certain
2752 2757 types. Another suggestion by Matthew.
2753 2758 (magic_whos): Added memory summaries in kb and Mb for arrays.
2754 2759 (magic_who): Improve formatting (break lines every 9 vars).
2755 2760
2756 2761 2004-11-28 Fernando Perez <fperez@colorado.edu>
2757 2762
2758 2763 * IPython/Logger.py (Logger.log): Fix bug in syncing the input
2759 2764 cache when empty lines were present.
2760 2765
2761 2766 2004-11-24 Fernando Perez <fperez@colorado.edu>
2762 2767
2763 2768 * IPython/usage.py (__doc__): document the re-activated threading
2764 2769 options for WX and GTK.
2765 2770
2766 2771 2004-11-23 Fernando Perez <fperez@colorado.edu>
2767 2772
2768 2773 * IPython/Shell.py (start): Added Prabhu's big patch to reactivate
2769 2774 the -wthread and -gthread options, along with a new -tk one to try
2770 2775 and coordinate Tk threading with wx/gtk. The tk support is very
2771 2776 platform dependent, since it seems to require Tcl and Tk to be
2772 2777 built with threads (Fedora1/2 appears NOT to have it, but in
2773 2778 Prabhu's Debian boxes it works OK). But even with some Tk
2774 2779 limitations, this is a great improvement.
2775 2780
2776 2781 * IPython/Prompts.py (prompt_specials_color): Added \t for time
2777 2782 info in user prompts. Patch by Prabhu.
2778 2783
2779 2784 2004-11-18 Fernando Perez <fperez@colorado.edu>
2780 2785
2781 2786 * IPython/genutils.py (ask_yes_no): Add check for a max of 20
2782 2787 EOFErrors and bail, to avoid infinite loops if a non-terminating
2783 2788 file is fed into ipython. Patch submitted in issue 19 by user,
2784 2789 many thanks.
2785 2790
2786 2791 * IPython/iplib.py (InteractiveShell.handle_auto): do NOT trigger
2787 2792 autoquote/parens in continuation prompts, which can cause lots of
2788 2793 problems. Closes roundup issue 20.
2789 2794
2790 2795 2004-11-17 Fernando Perez <fperez@colorado.edu>
2791 2796
2792 2797 * debian/control (Build-Depends-Indep): Fix dpatch dependency,
2793 2798 reported as debian bug #280505. I'm not sure my local changelog
2794 2799 entry has the proper debian format (Jack?).
2795 2800
2796 2801 2004-11-08 *** Released version 0.6.4
2797 2802
2798 2803 2004-11-08 Fernando Perez <fperez@colorado.edu>
2799 2804
2800 2805 * IPython/iplib.py (init_readline): Fix exit message for Windows
2801 2806 when readline is active. Thanks to a report by Eric Jones
2802 2807 <eric-AT-enthought.com>.
2803 2808
2804 2809 2004-11-07 Fernando Perez <fperez@colorado.edu>
2805 2810
2806 2811 * IPython/genutils.py (page): Add a trap for OSError exceptions,
2807 2812 sometimes seen by win2k/cygwin users.
2808 2813
2809 2814 2004-11-06 Fernando Perez <fperez@colorado.edu>
2810 2815
2811 2816 * IPython/iplib.py (interact): Change the handling of %Exit from
2812 2817 trying to propagate a SystemExit to an internal ipython flag.
2813 2818 This is less elegant than using Python's exception mechanism, but
2814 2819 I can't get that to work reliably with threads, so under -pylab
2815 2820 %Exit was hanging IPython. Cross-thread exception handling is
2816 2821 really a bitch. Thaks to a bug report by Stephen Walton
2817 2822 <stephen.walton-AT-csun.edu>.
2818 2823
2819 2824 2004-11-04 Fernando Perez <fperez@colorado.edu>
2820 2825
2821 2826 * IPython/iplib.py (raw_input_original): store a pointer to the
2822 2827 true raw_input to harden against code which can modify it
2823 2828 (wx.py.PyShell does this and would otherwise crash ipython).
2824 2829 Thanks to a bug report by Jim Flowers <james.flowers-AT-lgx.com>.
2825 2830
2826 2831 * IPython/Shell.py (MTInteractiveShell.runsource): Cleaner fix for
2827 2832 Ctrl-C problem, which does not mess up the input line.
2828 2833
2829 2834 2004-11-03 Fernando Perez <fperez@colorado.edu>
2830 2835
2831 2836 * IPython/Release.py: Changed licensing to BSD, in all files.
2832 2837 (name): lowercase name for tarball/RPM release.
2833 2838
2834 2839 * IPython/OInspect.py (getdoc): wrap inspect.getdoc() safely for
2835 2840 use throughout ipython.
2836 2841
2837 2842 * IPython/Magic.py (Magic._ofind): Switch to using the new
2838 2843 OInspect.getdoc() function.
2839 2844
2840 2845 * IPython/Shell.py (sigint_handler): Hack to ignore the execution
2841 2846 of the line currently being canceled via Ctrl-C. It's extremely
2842 2847 ugly, but I don't know how to do it better (the problem is one of
2843 2848 handling cross-thread exceptions).
2844 2849
2845 2850 2004-10-28 Fernando Perez <fperez@colorado.edu>
2846 2851
2847 2852 * IPython/Shell.py (signal_handler): add signal handlers to trap
2848 2853 SIGINT and SIGSEGV in threaded code properly. Thanks to a bug
2849 2854 report by Francesc Alted.
2850 2855
2851 2856 2004-10-21 Fernando Perez <fperez@colorado.edu>
2852 2857
2853 2858 * IPython/Extensions/InterpreterExec.py (prefilter_shell): Fix @
2854 2859 to % for pysh syntax extensions.
2855 2860
2856 2861 2004-10-09 Fernando Perez <fperez@colorado.edu>
2857 2862
2858 2863 * IPython/Magic.py (Magic.magic_whos): modify output of Numeric
2859 2864 arrays to print a more useful summary, without calling str(arr).
2860 2865 This avoids the problem of extremely lengthy computations which
2861 2866 occur if arr is large, and appear to the user as a system lockup
2862 2867 with 100% cpu activity. After a suggestion by Kristian Sandberg
2863 2868 <Kristian.Sandberg@colorado.edu>.
2864 2869 (Magic.__init__): fix bug in global magic escapes not being
2865 2870 correctly set.
2866 2871
2867 2872 2004-10-08 Fernando Perez <fperez@colorado.edu>
2868 2873
2869 2874 * IPython/Magic.py (__license__): change to absolute imports of
2870 2875 ipython's own internal packages, to start adapting to the absolute
2871 2876 import requirement of PEP-328.
2872 2877
2873 2878 * IPython/genutils.py (__author__): Fix coding to utf-8 on all
2874 2879 files, and standardize author/license marks through the Release
2875 2880 module instead of having per/file stuff (except for files with
2876 2881 particular licenses, like the MIT/PSF-licensed codes).
2877 2882
2878 2883 * IPython/Debugger.py: remove dead code for python 2.1
2879 2884
2880 2885 2004-10-04 Fernando Perez <fperez@colorado.edu>
2881 2886
2882 2887 * IPython/iplib.py (ipmagic): New function for accessing magics
2883 2888 via a normal python function call.
2884 2889
2885 2890 * IPython/Magic.py (Magic.magic_magic): Change the magic escape
2886 2891 from '@' to '%', to accomodate the new @decorator syntax of python
2887 2892 2.4.
2888 2893
2889 2894 2004-09-29 Fernando Perez <fperez@colorado.edu>
2890 2895
2891 2896 * IPython/Shell.py (MatplotlibShellBase.use): Added a wrapper to
2892 2897 matplotlib.use to prevent running scripts which try to switch
2893 2898 interactive backends from within ipython. This will just crash
2894 2899 the python interpreter, so we can't allow it (but a detailed error
2895 2900 is given to the user).
2896 2901
2897 2902 2004-09-28 Fernando Perez <fperez@colorado.edu>
2898 2903
2899 2904 * IPython/Shell.py (MatplotlibShellBase.mplot_exec):
2900 2905 matplotlib-related fixes so that using @run with non-matplotlib
2901 2906 scripts doesn't pop up spurious plot windows. This requires
2902 2907 matplotlib >= 0.63, where I had to make some changes as well.
2903 2908
2904 2909 * IPython/ipmaker.py (make_IPython): update version requirement to
2905 2910 python 2.2.
2906 2911
2907 2912 * IPython/iplib.py (InteractiveShell.mainloop): Add an optional
2908 2913 banner arg for embedded customization.
2909 2914
2910 2915 * IPython/Magic.py (Magic.__init__): big cleanup to remove all
2911 2916 explicit uses of __IP as the IPython's instance name. Now things
2912 2917 are properly handled via the shell.name value. The actual code
2913 2918 is a bit ugly b/c I'm doing it via a global in Magic.py, but this
2914 2919 is much better than before. I'll clean things completely when the
2915 2920 magic stuff gets a real overhaul.
2916 2921
2917 2922 * ipython.1: small fixes, sent in by Jack Moffit. He also sent in
2918 2923 minor changes to debian dir.
2919 2924
2920 2925 * IPython/iplib.py (InteractiveShell.__init__): Fix adding a
2921 2926 pointer to the shell itself in the interactive namespace even when
2922 2927 a user-supplied dict is provided. This is needed for embedding
2923 2928 purposes (found by tests with Michel Sanner).
2924 2929
2925 2930 2004-09-27 Fernando Perez <fperez@colorado.edu>
2926 2931
2927 2932 * IPython/UserConfig/ipythonrc: remove []{} from
2928 2933 readline_remove_delims, so that things like [modname.<TAB> do
2929 2934 proper completion. This disables [].TAB, but that's a less common
2930 2935 case than module names in list comprehensions, for example.
2931 2936 Thanks to a report by Andrea Riciputi.
2932 2937
2933 2938 2004-09-09 Fernando Perez <fperez@colorado.edu>
2934 2939
2935 2940 * IPython/Shell.py (IPShellGTK.mainloop): reorder to avoid
2936 2941 blocking problems in win32 and osx. Fix by John.
2937 2942
2938 2943 2004-09-08 Fernando Perez <fperez@colorado.edu>
2939 2944
2940 2945 * IPython/Shell.py (IPShellWX.OnInit): Fix output redirection bug
2941 2946 for Win32 and OSX. Fix by John Hunter.
2942 2947
2943 2948 2004-08-30 *** Released version 0.6.3
2944 2949
2945 2950 2004-08-30 Fernando Perez <fperez@colorado.edu>
2946 2951
2947 2952 * setup.py (isfile): Add manpages to list of dependent files to be
2948 2953 updated.
2949 2954
2950 2955 2004-08-27 Fernando Perez <fperez@colorado.edu>
2951 2956
2952 2957 * IPython/Shell.py (start): I've disabled -wthread and -gthread
2953 2958 for now. They don't really work with standalone WX/GTK code
2954 2959 (though matplotlib IS working fine with both of those backends).
2955 2960 This will neeed much more testing. I disabled most things with
2956 2961 comments, so turning it back on later should be pretty easy.
2957 2962
2958 2963 * IPython/iplib.py (InteractiveShell.__init__): Fix accidental
2959 2964 autocalling of expressions like r'foo', by modifying the line
2960 2965 split regexp. Closes
2961 2966 http://www.scipy.net/roundup/ipython/issue18, reported by Nicholas
2962 2967 Riley <ipythonbugs-AT-sabi.net>.
2963 2968 (InteractiveShell.mainloop): honor --nobanner with banner
2964 2969 extensions.
2965 2970
2966 2971 * IPython/Shell.py: Significant refactoring of all classes, so
2967 2972 that we can really support ALL matplotlib backends and threading
2968 2973 models (John spotted a bug with Tk which required this). Now we
2969 2974 should support single-threaded, WX-threads and GTK-threads, both
2970 2975 for generic code and for matplotlib.
2971 2976
2972 2977 * IPython/ipmaker.py (__call__): Changed -mpthread option to
2973 2978 -pylab, to simplify things for users. Will also remove the pylab
2974 2979 profile, since now all of matplotlib configuration is directly
2975 2980 handled here. This also reduces startup time.
2976 2981
2977 2982 * IPython/Shell.py (IPShellGTK.run): Fixed bug where mainloop() of
2978 2983 shell wasn't being correctly called. Also in IPShellWX.
2979 2984
2980 2985 * IPython/iplib.py (InteractiveShell.__init__): Added option to
2981 2986 fine-tune banner.
2982 2987
2983 2988 * IPython/numutils.py (spike): Deprecate these spike functions,
2984 2989 delete (long deprecated) gnuplot_exec handler.
2985 2990
2986 2991 2004-08-26 Fernando Perez <fperez@colorado.edu>
2987 2992
2988 2993 * ipython.1: Update for threading options, plus some others which
2989 2994 were missing.
2990 2995
2991 2996 * IPython/ipmaker.py (__call__): Added -wthread option for
2992 2997 wxpython thread handling. Make sure threading options are only
2993 2998 valid at the command line.
2994 2999
2995 3000 * scripts/ipython: moved shell selection into a factory function
2996 3001 in Shell.py, to keep the starter script to a minimum.
2997 3002
2998 3003 2004-08-25 Fernando Perez <fperez@colorado.edu>
2999 3004
3000 3005 * IPython/Shell.py (IPShellWX.wxexit): fixes to WX threading, by
3001 3006 John. Along with some recent changes he made to matplotlib, the
3002 3007 next versions of both systems should work very well together.
3003 3008
3004 3009 2004-08-24 Fernando Perez <fperez@colorado.edu>
3005 3010
3006 3011 * IPython/Magic.py (Magic.magic_prun): cleanup some dead code. I
3007 3012 tried to switch the profiling to using hotshot, but I'm getting
3008 3013 strange errors from prof.runctx() there. I may be misreading the
3009 3014 docs, but it looks weird. For now the profiling code will
3010 3015 continue to use the standard profiler.
3011 3016
3012 3017 2004-08-23 Fernando Perez <fperez@colorado.edu>
3013 3018
3014 3019 * IPython/Shell.py (IPShellWX.__init__): Improvements to the WX
3015 3020 threaded shell, by John Hunter. It's not quite ready yet, but
3016 3021 close.
3017 3022
3018 3023 2004-08-22 Fernando Perez <fperez@colorado.edu>
3019 3024
3020 3025 * IPython/iplib.py (InteractiveShell.interact): tab cleanups, also
3021 3026 in Magic and ultraTB.
3022 3027
3023 3028 * ipython.1: document threading options in manpage.
3024 3029
3025 3030 * scripts/ipython: Changed name of -thread option to -gthread,
3026 3031 since this is GTK specific. I want to leave the door open for a
3027 3032 -wthread option for WX, which will most likely be necessary. This
3028 3033 change affects usage and ipmaker as well.
3029 3034
3030 3035 * IPython/Shell.py (matplotlib_shell): Add a factory function to
3031 3036 handle the matplotlib shell issues. Code by John Hunter
3032 3037 <jdhunter-AT-nitace.bsd.uchicago.edu>.
3033 3038 (IPShellMatplotlibWX.__init__): Rudimentary WX support. It's
3034 3039 broken (and disabled for end users) for now, but it puts the
3035 3040 infrastructure in place.
3036 3041
3037 3042 2004-08-21 Fernando Perez <fperez@colorado.edu>
3038 3043
3039 3044 * ipythonrc-pylab: Add matplotlib support.
3040 3045
3041 3046 * matplotlib_config.py: new files for matplotlib support, part of
3042 3047 the pylab profile.
3043 3048
3044 3049 * IPython/usage.py (__doc__): documented the threading options.
3045 3050
3046 3051 2004-08-20 Fernando Perez <fperez@colorado.edu>
3047 3052
3048 3053 * ipython: Modified the main calling routine to handle the -thread
3049 3054 and -mpthread options. This needs to be done as a top-level hack,
3050 3055 because it determines which class to instantiate for IPython
3051 3056 itself.
3052 3057
3053 3058 * IPython/Shell.py (MTInteractiveShell.__init__): New set of
3054 3059 classes to support multithreaded GTK operation without blocking,
3055 3060 and matplotlib with all backends. This is a lot of still very
3056 3061 experimental code, and threads are tricky. So it may still have a
3057 3062 few rough edges... This code owes a lot to
3058 3063 http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/65109, by
3059 3064 Brian # McErlean and John Finlay, to Antoon Pardon for fixes, and
3060 3065 to John Hunter for all the matplotlib work.
3061 3066
3062 3067 * IPython/ipmaker.py (__call__): Added -thread and -mpthread
3063 3068 options for gtk thread and matplotlib support.
3064 3069
3065 3070 2004-08-16 Fernando Perez <fperez@colorado.edu>
3066 3071
3067 3072 * IPython/iplib.py (InteractiveShell.__init__): don't trigger
3068 3073 autocall for things like p*q,p/q,p+q,p-q, when p is callable. Bug
3069 3074 reported by Stephen Walton <stephen.walton-AT-csun.edu>.
3070 3075
3071 3076 2004-08-11 Fernando Perez <fperez@colorado.edu>
3072 3077
3073 3078 * setup.py (isfile): Fix build so documentation gets updated for
3074 3079 rpms (it was only done for .tgz builds).
3075 3080
3076 3081 2004-08-10 Fernando Perez <fperez@colorado.edu>
3077 3082
3078 3083 * genutils.py (Term): Fix misspell of stdin stream (sin->cin).
3079 3084
3080 3085 * iplib.py : Silence syntax error exceptions in tab-completion.
3081 3086
3082 3087 2004-08-05 Fernando Perez <fperez@colorado.edu>
3083 3088
3084 3089 * IPython/Prompts.py (Prompt2.set_colors): Fix incorrectly set
3085 3090 'color off' mark for continuation prompts. This was causing long
3086 3091 continuation lines to mis-wrap.
3087 3092
3088 3093 2004-08-01 Fernando Perez <fperez@colorado.edu>
3089 3094
3090 3095 * IPython/ipmaker.py (make_IPython): Allow the shell class used
3091 3096 for building ipython to be a parameter. All this is necessary
3092 3097 right now to have a multithreaded version, but this insane
3093 3098 non-design will be cleaned up soon. For now, it's a hack that
3094 3099 works.
3095 3100
3096 3101 * IPython/Shell.py (IPShell.__init__): Stop using mutable default
3097 3102 args in various places. No bugs so far, but it's a dangerous
3098 3103 practice.
3099 3104
3100 3105 2004-07-31 Fernando Perez <fperez@colorado.edu>
3101 3106
3102 3107 * IPython/iplib.py (complete): ignore SyntaxError exceptions to
3103 3108 fix completion of files with dots in their names under most
3104 3109 profiles (pysh was OK because the completion order is different).
3105 3110
3106 3111 2004-07-27 Fernando Perez <fperez@colorado.edu>
3107 3112
3108 3113 * IPython/iplib.py (InteractiveShell.__init__): build dict of
3109 3114 keywords manually, b/c the one in keyword.py was removed in python
3110 3115 2.4. Patch by Anakim Border <aborder-AT-users.sourceforge.net>.
3111 3116 This is NOT a bug under python 2.3 and earlier.
3112 3117
3113 3118 2004-07-26 Fernando Perez <fperez@colorado.edu>
3114 3119
3115 3120 * IPython/ultraTB.py (VerboseTB.text): Add another
3116 3121 linecache.checkcache() call to try to prevent inspect.py from
3117 3122 crashing under python 2.3. I think this fixes
3118 3123 http://www.scipy.net/roundup/ipython/issue17.
3119 3124
3120 3125 2004-07-26 *** Released version 0.6.2
3121 3126
3122 3127 2004-07-26 Fernando Perez <fperez@colorado.edu>
3123 3128
3124 3129 * IPython/Magic.py (Magic.magic_cd): Fix bug where 'cd -N' would
3125 3130 fail for any number.
3126 3131 (Magic.magic_bookmark): Fix bug where 'bookmark -l' would fail for
3127 3132 empty bookmarks.
3128 3133
3129 3134 2004-07-26 *** Released version 0.6.1
3130 3135
3131 3136 2004-07-26 Fernando Perez <fperez@colorado.edu>
3132 3137
3133 3138 * ipython_win_post_install.py (run): Added pysh shortcut for Windows.
3134 3139
3135 3140 * IPython/iplib.py (protect_filename): Applied Ville's patch for
3136 3141 escaping '()[]{}' in filenames.
3137 3142
3138 3143 * IPython/Magic.py (shlex_split): Fix handling of '*' and '?' for
3139 3144 Python 2.2 users who lack a proper shlex.split.
3140 3145
3141 3146 2004-07-19 Fernando Perez <fperez@colorado.edu>
3142 3147
3143 3148 * IPython/iplib.py (InteractiveShell.init_readline): Add support
3144 3149 for reading readline's init file. I follow the normal chain:
3145 3150 $INPUTRC is honored, otherwise ~/.inputrc is used. Thanks to a
3146 3151 report by Mike Heeter. This closes
3147 3152 http://www.scipy.net/roundup/ipython/issue16.
3148 3153
3149 3154 2004-07-18 Fernando Perez <fperez@colorado.edu>
3150 3155
3151 3156 * IPython/iplib.py (__init__): Add better handling of '\' under
3152 3157 Win32 for filenames. After a patch by Ville.
3153 3158
3154 3159 2004-07-17 Fernando Perez <fperez@colorado.edu>
3155 3160
3156 3161 * IPython/iplib.py (InteractiveShell._prefilter): fix bug where
3157 3162 autocalling would be triggered for 'foo is bar' if foo is
3158 3163 callable. I also cleaned up the autocall detection code to use a
3159 3164 regexp, which is faster. Bug reported by Alexander Schmolck.
3160 3165
3161 3166 * IPython/Magic.py (Magic.magic_pinfo): Fix bug where strings with
3162 3167 '?' in them would confuse the help system. Reported by Alex
3163 3168 Schmolck.
3164 3169
3165 3170 2004-07-16 Fernando Perez <fperez@colorado.edu>
3166 3171
3167 3172 * IPython/GnuplotInteractive.py (__all__): added plot2.
3168 3173
3169 3174 * IPython/Gnuplot2.py (Gnuplot.plot2): added new function for
3170 3175 plotting dictionaries, lists or tuples of 1d arrays.
3171 3176
3172 3177 * IPython/Magic.py (Magic.magic_hist): small clenaups and
3173 3178 optimizations.
3174 3179
3175 3180 * IPython/iplib.py:Remove old Changelog info for cleanup. This is
3176 3181 the information which was there from Janko's original IPP code:
3177 3182
3178 3183 03.05.99 20:53 porto.ifm.uni-kiel.de
3179 3184 --Started changelog.
3180 3185 --make clear do what it say it does
3181 3186 --added pretty output of lines from inputcache
3182 3187 --Made Logger a mixin class, simplifies handling of switches
3183 3188 --Added own completer class. .string<TAB> expands to last history
3184 3189 line which starts with string. The new expansion is also present
3185 3190 with Ctrl-r from the readline library. But this shows, who this
3186 3191 can be done for other cases.
3187 3192 --Added convention that all shell functions should accept a
3188 3193 parameter_string This opens the door for different behaviour for
3189 3194 each function. @cd is a good example of this.
3190 3195
3191 3196 04.05.99 12:12 porto.ifm.uni-kiel.de
3192 3197 --added logfile rotation
3193 3198 --added new mainloop method which freezes first the namespace
3194 3199
3195 3200 07.05.99 21:24 porto.ifm.uni-kiel.de
3196 3201 --added the docreader classes. Now there is a help system.
3197 3202 -This is only a first try. Currently it's not easy to put new
3198 3203 stuff in the indices. But this is the way to go. Info would be
3199 3204 better, but HTML is every where and not everybody has an info
3200 3205 system installed and it's not so easy to change html-docs to info.
3201 3206 --added global logfile option
3202 3207 --there is now a hook for object inspection method pinfo needs to
3203 3208 be provided for this. Can be reached by two '??'.
3204 3209
3205 3210 08.05.99 20:51 porto.ifm.uni-kiel.de
3206 3211 --added a README
3207 3212 --bug in rc file. Something has changed so functions in the rc
3208 3213 file need to reference the shell and not self. Not clear if it's a
3209 3214 bug or feature.
3210 3215 --changed rc file for new behavior
3211 3216
3212 3217 2004-07-15 Fernando Perez <fperez@colorado.edu>
3213 3218
3214 3219 * IPython/Logger.py (Logger.log): fixed recent bug where the input
3215 3220 cache was falling out of sync in bizarre manners when multi-line
3216 3221 input was present. Minor optimizations and cleanup.
3217 3222
3218 3223 (Logger): Remove old Changelog info for cleanup. This is the
3219 3224 information which was there from Janko's original code:
3220 3225
3221 3226 Changes to Logger: - made the default log filename a parameter
3222 3227
3223 3228 - put a check for lines beginning with !@? in log(). Needed
3224 3229 (even if the handlers properly log their lines) for mid-session
3225 3230 logging activation to work properly. Without this, lines logged
3226 3231 in mid session, which get read from the cache, would end up
3227 3232 'bare' (with !@? in the open) in the log. Now they are caught
3228 3233 and prepended with a #.
3229 3234
3230 3235 * IPython/iplib.py (InteractiveShell.init_readline): added check
3231 3236 in case MagicCompleter fails to be defined, so we don't crash.
3232 3237
3233 3238 2004-07-13 Fernando Perez <fperez@colorado.edu>
3234 3239
3235 3240 * IPython/Gnuplot2.py (Gnuplot.hardcopy): add automatic generation
3236 3241 of EPS if the requested filename ends in '.eps'.
3237 3242
3238 3243 2004-07-04 Fernando Perez <fperez@colorado.edu>
3239 3244
3240 3245 * IPython/iplib.py (InteractiveShell.handle_shell_escape): Fix
3241 3246 escaping of quotes when calling the shell.
3242 3247
3243 3248 2004-07-02 Fernando Perez <fperez@colorado.edu>
3244 3249
3245 3250 * IPython/Prompts.py (CachedOutput.update): Fix problem with
3246 3251 gettext not working because we were clobbering '_'. Fixes
3247 3252 http://www.scipy.net/roundup/ipython/issue6.
3248 3253
3249 3254 2004-07-01 Fernando Perez <fperez@colorado.edu>
3250 3255
3251 3256 * IPython/Magic.py (Magic.magic_cd): integrated bookmark handling
3252 3257 into @cd. Patch by Ville.
3253 3258
3254 3259 * IPython/iplib.py (InteractiveShell.post_config_initialization):
3255 3260 new function to store things after ipmaker runs. Patch by Ville.
3256 3261 Eventually this will go away once ipmaker is removed and the class
3257 3262 gets cleaned up, but for now it's ok. Key functionality here is
3258 3263 the addition of the persistent storage mechanism, a dict for
3259 3264 keeping data across sessions (for now just bookmarks, but more can
3260 3265 be implemented later).
3261 3266
3262 3267 * IPython/Magic.py (Magic.magic_bookmark): New bookmark system,
3263 3268 persistent across sections. Patch by Ville, I modified it
3264 3269 soemwhat to allow bookmarking arbitrary dirs other than CWD. Also
3265 3270 added a '-l' option to list all bookmarks.
3266 3271
3267 3272 * IPython/iplib.py (InteractiveShell.atexit_operations): new
3268 3273 center for cleanup. Registered with atexit.register(). I moved
3269 3274 here the old exit_cleanup(). After a patch by Ville.
3270 3275
3271 3276 * IPython/Magic.py (get_py_filename): added '~' to the accepted
3272 3277 characters in the hacked shlex_split for python 2.2.
3273 3278
3274 3279 * IPython/iplib.py (file_matches): more fixes to filenames with
3275 3280 whitespace in them. It's not perfect, but limitations in python's
3276 3281 readline make it impossible to go further.
3277 3282
3278 3283 2004-06-29 Fernando Perez <fperez@colorado.edu>
3279 3284
3280 3285 * IPython/iplib.py (file_matches): escape whitespace correctly in
3281 3286 filename completions. Bug reported by Ville.
3282 3287
3283 3288 2004-06-28 Fernando Perez <fperez@colorado.edu>
3284 3289
3285 3290 * IPython/ipmaker.py (__call__): Added per-profile histories. Now
3286 3291 the history file will be called 'history-PROFNAME' (or just
3287 3292 'history' if no profile is loaded). I was getting annoyed at
3288 3293 getting my Numerical work history clobbered by pysh sessions.
3289 3294
3290 3295 * IPython/iplib.py (InteractiveShell.__init__): Internal
3291 3296 getoutputerror() function so that we can honor the system_verbose
3292 3297 flag for _all_ system calls. I also added escaping of #
3293 3298 characters here to avoid confusing Itpl.
3294 3299
3295 3300 * IPython/Magic.py (shlex_split): removed call to shell in
3296 3301 parse_options and replaced it with shlex.split(). The annoying
3297 3302 part was that in Python 2.2, shlex.split() doesn't exist, so I had
3298 3303 to backport it from 2.3, with several frail hacks (the shlex
3299 3304 module is rather limited in 2.2). Thanks to a suggestion by Ville
3300 3305 Vainio <vivainio@kolumbus.fi>. For Python 2.3 there should be no
3301 3306 problem.
3302 3307
3303 3308 (Magic.magic_system_verbose): new toggle to print the actual
3304 3309 system calls made by ipython. Mainly for debugging purposes.
3305 3310
3306 3311 * IPython/GnuplotRuntime.py (gnu_out): fix bug for cygwin, which
3307 3312 doesn't support persistence. Reported (and fix suggested) by
3308 3313 Travis Caldwell <travis_caldwell2000@yahoo.com>.
3309 3314
3310 3315 2004-06-26 Fernando Perez <fperez@colorado.edu>
3311 3316
3312 3317 * IPython/Logger.py (Logger.log): fix to handle correctly empty
3313 3318 continue prompts.
3314 3319
3315 3320 * IPython/Extensions/InterpreterExec.py (pysh): moved the pysh()
3316 3321 function (basically a big docstring) and a few more things here to
3317 3322 speedup startup. pysh.py is now very lightweight. We want because
3318 3323 it gets execfile'd, while InterpreterExec gets imported, so
3319 3324 byte-compilation saves time.
3320 3325
3321 3326 2004-06-25 Fernando Perez <fperez@colorado.edu>
3322 3327
3323 3328 * IPython/Magic.py (Magic.magic_cd): Fixed to restore usage of 'cd
3324 3329 -NUM', which was recently broken.
3325 3330
3326 3331 * IPython/iplib.py (InteractiveShell.handle_shell_escape): allow !
3327 3332 in multi-line input (but not !!, which doesn't make sense there).
3328 3333
3329 3334 * IPython/UserConfig/ipythonrc: made autoindent on by default.
3330 3335 It's just too useful, and people can turn it off in the less
3331 3336 common cases where it's a problem.
3332 3337
3333 3338 2004-06-24 Fernando Perez <fperez@colorado.edu>
3334 3339
3335 3340 * IPython/iplib.py (InteractiveShell._prefilter): big change -
3336 3341 special syntaxes (like alias calling) is now allied in multi-line
3337 3342 input. This is still _very_ experimental, but it's necessary for
3338 3343 efficient shell usage combining python looping syntax with system
3339 3344 calls. For now it's restricted to aliases, I don't think it
3340 3345 really even makes sense to have this for magics.
3341 3346
3342 3347 2004-06-23 Fernando Perez <fperez@colorado.edu>
3343 3348
3344 3349 * IPython/Extensions/InterpreterExec.py (prefilter_shell): Added
3345 3350 $var=cmd <=> @sc var=cmd and $$var=cmd <=> @sc -l var=cmd.
3346 3351
3347 3352 * IPython/Magic.py (Magic.magic_rehashx): modified to handle
3348 3353 extensions under Windows (after code sent by Gary Bishop). The
3349 3354 extensions considered 'executable' are stored in IPython's rc
3350 3355 structure as win_exec_ext.
3351 3356
3352 3357 * IPython/genutils.py (shell): new function, like system() but
3353 3358 without return value. Very useful for interactive shell work.
3354 3359
3355 3360 * IPython/Magic.py (Magic.magic_unalias): New @unalias function to
3356 3361 delete aliases.
3357 3362
3358 3363 * IPython/iplib.py (InteractiveShell.alias_table_update): make
3359 3364 sure that the alias table doesn't contain python keywords.
3360 3365
3361 3366 2004-06-21 Fernando Perez <fperez@colorado.edu>
3362 3367
3363 3368 * IPython/Magic.py (Magic.magic_rehash): Fix crash when
3364 3369 non-existent items are found in $PATH. Reported by Thorsten.
3365 3370
3366 3371 2004-06-20 Fernando Perez <fperez@colorado.edu>
3367 3372
3368 3373 * IPython/iplib.py (complete): modified the completer so that the
3369 3374 order of priorities can be easily changed at runtime.
3370 3375
3371 3376 * IPython/Extensions/InterpreterExec.py (prefilter_shell):
3372 3377 Modified to auto-execute all lines beginning with '~', '/' or '.'.
3373 3378
3374 3379 * IPython/Magic.py (Magic.magic_sx): modified @sc and @sx to
3375 3380 expand Python variables prepended with $ in all system calls. The
3376 3381 same was done to InteractiveShell.handle_shell_escape. Now all
3377 3382 system access mechanisms (!, !!, @sc, @sx and aliases) allow the
3378 3383 expansion of python variables and expressions according to the
3379 3384 syntax of PEP-215 - http://www.python.org/peps/pep-0215.html.
3380 3385
3381 3386 Though PEP-215 has been rejected, a similar (but simpler) one
3382 3387 seems like it will go into Python 2.4, PEP-292 -
3383 3388 http://www.python.org/peps/pep-0292.html.
3384 3389
3385 3390 I'll keep the full syntax of PEP-215, since IPython has since the
3386 3391 start used Ka-Ping Yee's reference implementation discussed there
3387 3392 (Itpl), and I actually like the powerful semantics it offers.
3388 3393
3389 3394 In order to access normal shell variables, the $ has to be escaped
3390 3395 via an extra $. For example:
3391 3396
3392 3397 In [7]: PATH='a python variable'
3393 3398
3394 3399 In [8]: !echo $PATH
3395 3400 a python variable
3396 3401
3397 3402 In [9]: !echo $$PATH
3398 3403 /usr/local/lf9560/bin:/usr/local/intel/compiler70/ia32/bin:...
3399 3404
3400 3405 (Magic.parse_options): escape $ so the shell doesn't evaluate
3401 3406 things prematurely.
3402 3407
3403 3408 * IPython/iplib.py (InteractiveShell.call_alias): added the
3404 3409 ability for aliases to expand python variables via $.
3405 3410
3406 3411 * IPython/Magic.py (Magic.magic_rehash): based on the new alias
3407 3412 system, now there's a @rehash/@rehashx pair of magics. These work
3408 3413 like the csh rehash command, and can be invoked at any time. They
3409 3414 build a table of aliases to everything in the user's $PATH
3410 3415 (@rehash uses everything, @rehashx is slower but only adds
3411 3416 executable files). With this, the pysh.py-based shell profile can
3412 3417 now simply call rehash upon startup, and full access to all
3413 3418 programs in the user's path is obtained.
3414 3419
3415 3420 * IPython/iplib.py (InteractiveShell.call_alias): The new alias
3416 3421 functionality is now fully in place. I removed the old dynamic
3417 3422 code generation based approach, in favor of a much lighter one
3418 3423 based on a simple dict. The advantage is that this allows me to
3419 3424 now have thousands of aliases with negligible cost (unthinkable
3420 3425 with the old system).
3421 3426
3422 3427 2004-06-19 Fernando Perez <fperez@colorado.edu>
3423 3428
3424 3429 * IPython/iplib.py (__init__): extended MagicCompleter class to
3425 3430 also complete (last in priority) on user aliases.
3426 3431
3427 3432 * IPython/Itpl.py (Itpl.__str__): fixed order of globals/locals in
3428 3433 call to eval.
3429 3434 (ItplNS.__init__): Added a new class which functions like Itpl,
3430 3435 but allows configuring the namespace for the evaluation to occur
3431 3436 in.
3432 3437
3433 3438 2004-06-18 Fernando Perez <fperez@colorado.edu>
3434 3439
3435 3440 * IPython/iplib.py (InteractiveShell.runcode): modify to print a
3436 3441 better message when 'exit' or 'quit' are typed (a common newbie
3437 3442 confusion).
3438 3443
3439 3444 * IPython/Magic.py (Magic.magic_colors): Added the runtime color
3440 3445 check for Windows users.
3441 3446
3442 3447 * IPython/iplib.py (InteractiveShell.user_setup): removed
3443 3448 disabling of colors for Windows. I'll test at runtime and issue a
3444 3449 warning if Gary's readline isn't found, as to nudge users to
3445 3450 download it.
3446 3451
3447 3452 2004-06-16 Fernando Perez <fperez@colorado.edu>
3448 3453
3449 3454 * IPython/genutils.py (Stream.__init__): changed to print errors
3450 3455 to sys.stderr. I had a circular dependency here. Now it's
3451 3456 possible to run ipython as IDLE's shell (consider this pre-alpha,
3452 3457 since true stdout things end up in the starting terminal instead
3453 3458 of IDLE's out).
3454 3459
3455 3460 * IPython/Prompts.py (Prompt2.set_colors): prevent crashes for
3456 3461 users who haven't # updated their prompt_in2 definitions. Remove
3457 3462 eventually.
3458 3463 (multiple_replace): added credit to original ASPN recipe.
3459 3464
3460 3465 2004-06-15 Fernando Perez <fperez@colorado.edu>
3461 3466
3462 3467 * IPython/iplib.py (InteractiveShell.__init__): add 'cp' to the
3463 3468 list of auto-defined aliases.
3464 3469
3465 3470 2004-06-13 Fernando Perez <fperez@colorado.edu>
3466 3471
3467 3472 * setup.py (scriptfiles): Don't trigger win_post_install unless an
3468 3473 install was really requested (so setup.py can be used for other
3469 3474 things under Windows).
3470 3475
3471 3476 2004-06-10 Fernando Perez <fperez@colorado.edu>
3472 3477
3473 3478 * IPython/Logger.py (Logger.create_log): Manually remove any old
3474 3479 backup, since os.remove may fail under Windows. Fixes bug
3475 3480 reported by Thorsten.
3476 3481
3477 3482 2004-06-09 Fernando Perez <fperez@colorado.edu>
3478 3483
3479 3484 * examples/example-embed.py: fixed all references to %n (replaced
3480 3485 with \\# for ps1/out prompts and with \\D for ps2 prompts). Done
3481 3486 for all examples and the manual as well.
3482 3487
3483 3488 2004-06-08 Fernando Perez <fperez@colorado.edu>
3484 3489
3485 3490 * IPython/Prompts.py (Prompt2.set_p_str): fixed all prompt
3486 3491 alignment and color management. All 3 prompt subsystems now
3487 3492 inherit from BasePrompt.
3488 3493
3489 3494 * tools/release: updates for windows installer build and tag rpms
3490 3495 with python version (since paths are fixed).
3491 3496
3492 3497 * IPython/UserConfig/ipythonrc: modified to use \# instead of %n,
3493 3498 which will become eventually obsolete. Also fixed the default
3494 3499 prompt_in2 to use \D, so at least new users start with the correct
3495 3500 defaults.
3496 3501 WARNING: Users with existing ipythonrc files will need to apply
3497 3502 this fix manually!
3498 3503
3499 3504 * setup.py: make windows installer (.exe). This is finally the
3500 3505 integration of an old patch by Cory Dodt <dodt-AT-fcoe.k12.ca.us>,
3501 3506 which I hadn't included because it required Python 2.3 (or recent
3502 3507 distutils).
3503 3508
3504 3509 * IPython/usage.py (__doc__): update docs (and manpage) to reflect
3505 3510 usage of new '\D' escape.
3506 3511
3507 3512 * IPython/Prompts.py (ROOT_SYMBOL): Small fix for Windows (which
3508 3513 lacks os.getuid())
3509 3514 (CachedOutput.set_colors): Added the ability to turn coloring
3510 3515 on/off with @colors even for manually defined prompt colors. It
3511 3516 uses a nasty global, but it works safely and via the generic color
3512 3517 handling mechanism.
3513 3518 (Prompt2.__init__): Introduced new escape '\D' for continuation
3514 3519 prompts. It represents the counter ('\#') as dots.
3515 3520 *** NOTE *** THIS IS A BACKWARDS-INCOMPATIBLE CHANGE. Users will
3516 3521 need to update their ipythonrc files and replace '%n' with '\D' in
3517 3522 their prompt_in2 settings everywhere. Sorry, but there's
3518 3523 otherwise no clean way to get all prompts to properly align. The
3519 3524 ipythonrc shipped with IPython has been updated.
3520 3525
3521 3526 2004-06-07 Fernando Perez <fperez@colorado.edu>
3522 3527
3523 3528 * setup.py (isfile): Pass local_icons option to latex2html, so the
3524 3529 resulting HTML file is self-contained. Thanks to
3525 3530 dryice-AT-liu.com.cn for the tip.
3526 3531
3527 3532 * pysh.py: I created a new profile 'shell', which implements a
3528 3533 _rudimentary_ IPython-based shell. This is in NO WAY a realy
3529 3534 system shell, nor will it become one anytime soon. It's mainly
3530 3535 meant to illustrate the use of the new flexible bash-like prompts.
3531 3536 I guess it could be used by hardy souls for true shell management,
3532 3537 but it's no tcsh/bash... pysh.py is loaded by the 'shell'
3533 3538 profile. This uses the InterpreterExec extension provided by
3534 3539 W.J. van der Laan <gnufnork-AT-hetdigitalegat.nl>
3535 3540
3536 3541 * IPython/Prompts.py (PromptOut.__str__): now it will correctly
3537 3542 auto-align itself with the length of the previous input prompt
3538 3543 (taking into account the invisible color escapes).
3539 3544 (CachedOutput.__init__): Large restructuring of this class. Now
3540 3545 all three prompts (primary1, primary2, output) are proper objects,
3541 3546 managed by the 'parent' CachedOutput class. The code is still a
3542 3547 bit hackish (all prompts share state via a pointer to the cache),
3543 3548 but it's overall far cleaner than before.
3544 3549
3545 3550 * IPython/genutils.py (getoutputerror): modified to add verbose,
3546 3551 debug and header options. This makes the interface of all getout*
3547 3552 functions uniform.
3548 3553 (SystemExec.getoutputerror): added getoutputerror to SystemExec.
3549 3554
3550 3555 * IPython/Magic.py (Magic.default_option): added a function to
3551 3556 allow registering default options for any magic command. This
3552 3557 makes it easy to have profiles which customize the magics globally
3553 3558 for a certain use. The values set through this function are
3554 3559 picked up by the parse_options() method, which all magics should
3555 3560 use to parse their options.
3556 3561
3557 3562 * IPython/genutils.py (warn): modified the warnings framework to
3558 3563 use the Term I/O class. I'm trying to slowly unify all of
3559 3564 IPython's I/O operations to pass through Term.
3560 3565
3561 3566 * IPython/Prompts.py (Prompt2._str_other): Added functionality in
3562 3567 the secondary prompt to correctly match the length of the primary
3563 3568 one for any prompt. Now multi-line code will properly line up
3564 3569 even for path dependent prompts, such as the new ones available
3565 3570 via the prompt_specials.
3566 3571
3567 3572 2004-06-06 Fernando Perez <fperez@colorado.edu>
3568 3573
3569 3574 * IPython/Prompts.py (prompt_specials): Added the ability to have
3570 3575 bash-like special sequences in the prompts, which get
3571 3576 automatically expanded. Things like hostname, current working
3572 3577 directory and username are implemented already, but it's easy to
3573 3578 add more in the future. Thanks to a patch by W.J. van der Laan
3574 3579 <gnufnork-AT-hetdigitalegat.nl>
3575 3580 (prompt_specials): Added color support for prompt strings, so
3576 3581 users can define arbitrary color setups for their prompts.
3577 3582
3578 3583 2004-06-05 Fernando Perez <fperez@colorado.edu>
3579 3584
3580 3585 * IPython/genutils.py (Term.reopen_all): Added Windows-specific
3581 3586 code to load Gary Bishop's readline and configure it
3582 3587 automatically. Thanks to Gary for help on this.
3583 3588
3584 3589 2004-06-01 Fernando Perez <fperez@colorado.edu>
3585 3590
3586 3591 * IPython/Logger.py (Logger.create_log): fix bug for logging
3587 3592 with no filename (previous fix was incomplete).
3588 3593
3589 3594 2004-05-25 Fernando Perez <fperez@colorado.edu>
3590 3595
3591 3596 * IPython/Magic.py (Magic.parse_options): fix bug where naked
3592 3597 parens would get passed to the shell.
3593 3598
3594 3599 2004-05-20 Fernando Perez <fperez@colorado.edu>
3595 3600
3596 3601 * IPython/Magic.py (Magic.magic_prun): changed default profile
3597 3602 sort order to 'time' (the more common profiling need).
3598 3603
3599 3604 * IPython/OInspect.py (Inspector.pinfo): flush the inspect cache
3600 3605 so that source code shown is guaranteed in sync with the file on
3601 3606 disk (also changed in psource). Similar fix to the one for
3602 3607 ultraTB on 2004-05-06. Thanks to a bug report by Yann Le Du
3603 3608 <yann.ledu-AT-noos.fr>.
3604 3609
3605 3610 * IPython/Magic.py (Magic.parse_options): Fixed bug where commands
3606 3611 with a single option would not be correctly parsed. Closes
3607 3612 http://www.scipy.net/roundup/ipython/issue14. This bug had been
3608 3613 introduced in 0.6.0 (on 2004-05-06).
3609 3614
3610 3615 2004-05-13 *** Released version 0.6.0
3611 3616
3612 3617 2004-05-13 Fernando Perez <fperez@colorado.edu>
3613 3618
3614 3619 * debian/: Added debian/ directory to CVS, so that debian support
3615 3620 is publicly accessible. The debian package is maintained by Jack
3616 3621 Moffit <jack-AT-xiph.org>.
3617 3622
3618 3623 * Documentation: included the notes about an ipython-based system
3619 3624 shell (the hypothetical 'pysh') into the new_design.pdf document,
3620 3625 so that these ideas get distributed to users along with the
3621 3626 official documentation.
3622 3627
3623 3628 2004-05-10 Fernando Perez <fperez@colorado.edu>
3624 3629
3625 3630 * IPython/Logger.py (Logger.create_log): fix recently introduced
3626 3631 bug (misindented line) where logstart would fail when not given an
3627 3632 explicit filename.
3628 3633
3629 3634 2004-05-09 Fernando Perez <fperez@colorado.edu>
3630 3635
3631 3636 * IPython/Magic.py (Magic.parse_options): skip system call when
3632 3637 there are no options to look for. Faster, cleaner for the common
3633 3638 case.
3634 3639
3635 3640 * Documentation: many updates to the manual: describing Windows
3636 3641 support better, Gnuplot updates, credits, misc small stuff. Also
3637 3642 updated the new_design doc a bit.
3638 3643
3639 3644 2004-05-06 *** Released version 0.6.0.rc1
3640 3645
3641 3646 2004-05-06 Fernando Perez <fperez@colorado.edu>
3642 3647
3643 3648 * IPython/ultraTB.py (ListTB.text): modified a ton of string +=
3644 3649 operations to use the vastly more efficient list/''.join() method.
3645 3650 (FormattedTB.text): Fix
3646 3651 http://www.scipy.net/roundup/ipython/issue12 - exception source
3647 3652 extract not updated after reload. Thanks to Mike Salib
3648 3653 <msalib-AT-mit.edu> for pinning the source of the problem.
3649 3654 Fortunately, the solution works inside ipython and doesn't require
3650 3655 any changes to python proper.
3651 3656
3652 3657 * IPython/Magic.py (Magic.parse_options): Improved to process the
3653 3658 argument list as a true shell would (by actually using the
3654 3659 underlying system shell). This way, all @magics automatically get
3655 3660 shell expansion for variables. Thanks to a comment by Alex
3656 3661 Schmolck.
3657 3662
3658 3663 2004-04-04 Fernando Perez <fperez@colorado.edu>
3659 3664
3660 3665 * IPython/iplib.py (InteractiveShell.interact): Added a special
3661 3666 trap for a debugger quit exception, which is basically impossible
3662 3667 to handle by normal mechanisms, given what pdb does to the stack.
3663 3668 This fixes a crash reported by <fgibbons-AT-llama.med.harvard.edu>.
3664 3669
3665 3670 2004-04-03 Fernando Perez <fperez@colorado.edu>
3666 3671
3667 3672 * IPython/genutils.py (Term): Standardized the names of the Term
3668 3673 class streams to cin/cout/cerr, following C++ naming conventions
3669 3674 (I can't use in/out/err because 'in' is not a valid attribute
3670 3675 name).
3671 3676
3672 3677 * IPython/iplib.py (InteractiveShell.interact): don't increment
3673 3678 the prompt if there's no user input. By Daniel 'Dang' Griffith
3674 3679 <pythondev-dang-AT-lazytwinacres.net>, after a suggestion from
3675 3680 Francois Pinard.
3676 3681
3677 3682 2004-04-02 Fernando Perez <fperez@colorado.edu>
3678 3683
3679 3684 * IPython/genutils.py (Stream.__init__): Modified to survive at
3680 3685 least importing in contexts where stdin/out/err aren't true file
3681 3686 objects, such as PyCrust (they lack fileno() and mode). However,
3682 3687 the recovery facilities which rely on these things existing will
3683 3688 not work.
3684 3689
3685 3690 2004-04-01 Fernando Perez <fperez@colorado.edu>
3686 3691
3687 3692 * IPython/Magic.py (Magic.magic_sx): modified (as well as @sc) to
3688 3693 use the new getoutputerror() function, so it properly
3689 3694 distinguishes stdout/err.
3690 3695
3691 3696 * IPython/genutils.py (getoutputerror): added a function to
3692 3697 capture separately the standard output and error of a command.
3693 3698 After a comment from dang on the mailing lists. This code is
3694 3699 basically a modified version of commands.getstatusoutput(), from
3695 3700 the standard library.
3696 3701
3697 3702 * IPython/iplib.py (InteractiveShell.handle_shell_escape): added
3698 3703 '!!' as a special syntax (shorthand) to access @sx.
3699 3704
3700 3705 * IPython/Magic.py (Magic.magic_sx): new magic, to execute a shell
3701 3706 command and return its output as a list split on '\n'.
3702 3707
3703 3708 2004-03-31 Fernando Perez <fperez@colorado.edu>
3704 3709
3705 3710 * IPython/FakeModule.py (FakeModule.__init__): added __nonzero__
3706 3711 method to dictionaries used as FakeModule instances if they lack
3707 3712 it. At least pydoc in python2.3 breaks for runtime-defined
3708 3713 functions without this hack. At some point I need to _really_
3709 3714 understand what FakeModule is doing, because it's a gross hack.
3710 3715 But it solves Arnd's problem for now...
3711 3716
3712 3717 2004-02-27 Fernando Perez <fperez@colorado.edu>
3713 3718
3714 3719 * IPython/Logger.py (Logger.create_log): Fix bug where 'rotate'
3715 3720 mode would behave erratically. Also increased the number of
3716 3721 possible logs in rotate mod to 999. Thanks to Rod Holland
3717 3722 <rhh@StructureLABS.com> for the report and fixes.
3718 3723
3719 3724 2004-02-26 Fernando Perez <fperez@colorado.edu>
3720 3725
3721 3726 * IPython/genutils.py (page): Check that the curses module really
3722 3727 has the initscr attribute before trying to use it. For some
3723 3728 reason, the Solaris curses module is missing this. I think this
3724 3729 should be considered a Solaris python bug, but I'm not sure.
3725 3730
3726 3731 2004-01-17 Fernando Perez <fperez@colorado.edu>
3727 3732
3728 3733 * IPython/genutils.py (Stream.__init__): Changes to try to make
3729 3734 ipython robust against stdin/out/err being closed by the user.
3730 3735 This is 'user error' (and blocks a normal python session, at least
3731 3736 the stdout case). However, Ipython should be able to survive such
3732 3737 instances of abuse as gracefully as possible. To simplify the
3733 3738 coding and maintain compatibility with Gary Bishop's Term
3734 3739 contributions, I've made use of classmethods for this. I think
3735 3740 this introduces a dependency on python 2.2.
3736 3741
3737 3742 2004-01-13 Fernando Perez <fperez@colorado.edu>
3738 3743
3739 3744 * IPython/numutils.py (exp_safe): simplified the code a bit and
3740 3745 removed the need for importing the kinds module altogether.
3741 3746
3742 3747 2004-01-06 Fernando Perez <fperez@colorado.edu>
3743 3748
3744 3749 * IPython/Magic.py (Magic.magic_sc): Made the shell capture system
3745 3750 a magic function instead, after some community feedback. No
3746 3751 special syntax will exist for it, but its name is deliberately
3747 3752 very short.
3748 3753
3749 3754 2003-12-20 Fernando Perez <fperez@colorado.edu>
3750 3755
3751 3756 * IPython/iplib.py (InteractiveShell.handle_shell_assign): Added
3752 3757 new functionality, to automagically assign the result of a shell
3753 3758 command to a variable. I'll solicit some community feedback on
3754 3759 this before making it permanent.
3755 3760
3756 3761 * IPython/OInspect.py (Inspector.pinfo): Fix crash when info was
3757 3762 requested about callables for which inspect couldn't obtain a
3758 3763 proper argspec. Thanks to a crash report sent by Etienne
3759 3764 Posthumus <etienne-AT-apple01.cs.vu.nl>.
3760 3765
3761 3766 2003-12-09 Fernando Perez <fperez@colorado.edu>
3762 3767
3763 3768 * IPython/genutils.py (page): patch for the pager to work across
3764 3769 various versions of Windows. By Gary Bishop.
3765 3770
3766 3771 2003-12-04 Fernando Perez <fperez@colorado.edu>
3767 3772
3768 3773 * IPython/Gnuplot2.py (PlotItems): Fixes for working with
3769 3774 Gnuplot.py version 1.7, whose internal names changed quite a bit.
3770 3775 While I tested this and it looks ok, there may still be corner
3771 3776 cases I've missed.
3772 3777
3773 3778 2003-12-01 Fernando Perez <fperez@colorado.edu>
3774 3779
3775 3780 * IPython/iplib.py (InteractiveShell._prefilter): Fixed a bug
3776 3781 where a line like 'p,q=1,2' would fail because the automagic
3777 3782 system would be triggered for @p.
3778 3783
3779 3784 * IPython/DPyGetOpt.py (DPyGetOpt.processArguments): Tab-related
3780 3785 cleanups, code unmodified.
3781 3786
3782 3787 * IPython/genutils.py (Term): added a class for IPython to handle
3783 3788 output. In most cases it will just be a proxy for stdout/err, but
3784 3789 having this allows modifications to be made for some platforms,
3785 3790 such as handling color escapes under Windows. All of this code
3786 3791 was contributed by Gary Bishop, with minor modifications by me.
3787 3792 The actual changes affect many files.
3788 3793
3789 3794 2003-11-30 Fernando Perez <fperez@colorado.edu>
3790 3795
3791 3796 * IPython/iplib.py (file_matches): new completion code, courtesy
3792 3797 of Jeff Collins. This enables filename completion again under
3793 3798 python 2.3, which disabled it at the C level.
3794 3799
3795 3800 2003-11-11 Fernando Perez <fperez@colorado.edu>
3796 3801
3797 3802 * IPython/numutils.py (amap): Added amap() fn. Simple shorthand
3798 3803 for Numeric.array(map(...)), but often convenient.
3799 3804
3800 3805 2003-11-05 Fernando Perez <fperez@colorado.edu>
3801 3806
3802 3807 * IPython/numutils.py (frange): Changed a call from int() to
3803 3808 int(round()) to prevent a problem reported with arange() in the
3804 3809 numpy list.
3805 3810
3806 3811 2003-10-06 Fernando Perez <fperez@colorado.edu>
3807 3812
3808 3813 * IPython/DPyGetOpt.py (DPyGetOpt.processArguments): changed to
3809 3814 prevent crashes if sys lacks an argv attribute (it happens with
3810 3815 embedded interpreters which build a bare-bones sys module).
3811 3816 Thanks to a report/bugfix by Adam Hupp <hupp-AT-cs.wisc.edu>.
3812 3817
3813 3818 2003-09-24 Fernando Perez <fperez@colorado.edu>
3814 3819
3815 3820 * IPython/Magic.py (Magic._ofind): blanket except around getattr()
3816 3821 to protect against poorly written user objects where __getattr__
3817 3822 raises exceptions other than AttributeError. Thanks to a bug
3818 3823 report by Oliver Sander <osander-AT-gmx.de>.
3819 3824
3820 3825 * IPython/FakeModule.py (FakeModule.__repr__): this method was
3821 3826 missing. Thanks to bug report by Ralf Schmitt <ralf-AT-brainbot.com>.
3822 3827
3823 3828 2003-09-09 Fernando Perez <fperez@colorado.edu>
3824 3829
3825 3830 * IPython/iplib.py (InteractiveShell._prefilter): fix bug where
3826 3831 unpacking a list whith a callable as first element would
3827 3832 mistakenly trigger autocalling. Thanks to a bug report by Jeffery
3828 3833 Collins.
3829 3834
3830 3835 2003-08-25 *** Released version 0.5.0
3831 3836
3832 3837 2003-08-22 Fernando Perez <fperez@colorado.edu>
3833 3838
3834 3839 * IPython/ultraTB.py (VerboseTB.linereader): Improved handling of
3835 3840 improperly defined user exceptions. Thanks to feedback from Mark
3836 3841 Russell <mrussell-AT-verio.net>.
3837 3842
3838 3843 2003-08-20 Fernando Perez <fperez@colorado.edu>
3839 3844
3840 3845 * IPython/OInspect.py (Inspector.pinfo): changed String Form
3841 3846 printing so that it would print multi-line string forms starting
3842 3847 with a new line. This way the formatting is better respected for
3843 3848 objects which work hard to make nice string forms.
3844 3849
3845 3850 * IPython/iplib.py (InteractiveShell.handle_auto): Fix bug where
3846 3851 autocall would overtake data access for objects with both
3847 3852 __getitem__ and __call__.
3848 3853
3849 3854 2003-08-19 *** Released version 0.5.0-rc1
3850 3855
3851 3856 2003-08-19 Fernando Perez <fperez@colorado.edu>
3852 3857
3853 3858 * IPython/deep_reload.py (load_tail): single tiny change here
3854 3859 seems to fix the long-standing bug of dreload() failing to work
3855 3860 for dotted names. But this module is pretty tricky, so I may have
3856 3861 missed some subtlety. Needs more testing!.
3857 3862
3858 3863 * IPython/ultraTB.py (VerboseTB.linereader): harden against user
3859 3864 exceptions which have badly implemented __str__ methods.
3860 3865 (VerboseTB.text): harden against inspect.getinnerframes crashing,
3861 3866 which I've been getting reports about from Python 2.3 users. I
3862 3867 wish I had a simple test case to reproduce the problem, so I could
3863 3868 either write a cleaner workaround or file a bug report if
3864 3869 necessary.
3865 3870
3866 3871 * IPython/Magic.py (Magic.magic_edit): fixed bug where after
3867 3872 making a class 'foo', file 'foo.py' couldn't be edited. Thanks to
3868 3873 a bug report by Tjabo Kloppenburg.
3869 3874
3870 3875 * IPython/ultraTB.py (VerboseTB.debugger): hardened against pdb
3871 3876 crashes. Wrapped the pdb call in a blanket try/except, since pdb
3872 3877 seems rather unstable. Thanks to a bug report by Tjabo
3873 3878 Kloppenburg <tjabo.kloppenburg-AT-unix-ag.uni-siegen.de>.
3874 3879
3875 3880 * IPython/Release.py (version): release 0.5.0-rc1. I want to put
3876 3881 this out soon because of the critical fixes in the inner loop for
3877 3882 generators.
3878 3883
3879 3884 * IPython/Magic.py (Magic.getargspec): removed. This (and
3880 3885 _get_def) have been obsoleted by OInspect for a long time, I
3881 3886 hadn't noticed that they were dead code.
3882 3887 (Magic._ofind): restored _ofind functionality for a few literals
3883 3888 (those in ["''",'""','[]','{}','()']). But it won't work anymore
3884 3889 for things like "hello".capitalize?, since that would require a
3885 3890 potentially dangerous eval() again.
3886 3891
3887 3892 * IPython/iplib.py (InteractiveShell._prefilter): reorganized the
3888 3893 logic a bit more to clean up the escapes handling and minimize the
3889 3894 use of _ofind to only necessary cases. The interactive 'feel' of
3890 3895 IPython should have improved quite a bit with the changes in
3891 3896 _prefilter and _ofind (besides being far safer than before).
3892 3897
3893 3898 * IPython/Magic.py (Magic.magic_edit): Fixed old bug (but rather
3894 3899 obscure, never reported). Edit would fail to find the object to
3895 3900 edit under some circumstances.
3896 3901 (Magic._ofind): CRITICAL FIX. Finally removed the eval() calls
3897 3902 which were causing double-calling of generators. Those eval calls
3898 3903 were _very_ dangerous, since code with side effects could be
3899 3904 triggered. As they say, 'eval is evil'... These were the
3900 3905 nastiest evals in IPython. Besides, _ofind is now far simpler,
3901 3906 and it should also be quite a bit faster. Its use of inspect is
3902 3907 also safer, so perhaps some of the inspect-related crashes I've
3903 3908 seen lately with Python 2.3 might be taken care of. That will
3904 3909 need more testing.
3905 3910
3906 3911 2003-08-17 Fernando Perez <fperez@colorado.edu>
3907 3912
3908 3913 * IPython/iplib.py (InteractiveShell._prefilter): significant
3909 3914 simplifications to the logic for handling user escapes. Faster
3910 3915 and simpler code.
3911 3916
3912 3917 2003-08-14 Fernando Perez <fperez@colorado.edu>
3913 3918
3914 3919 * IPython/numutils.py (sum_flat): rewrote to be non-recursive.
3915 3920 Now it requires O(N) storage (N=size(a)) for non-contiguous input,
3916 3921 but it should be quite a bit faster. And the recursive version
3917 3922 generated O(log N) intermediate storage for all rank>1 arrays,
3918 3923 even if they were contiguous.
3919 3924 (l1norm): Added this function.
3920 3925 (norm): Added this function for arbitrary norms (including
3921 3926 l-infinity). l1 and l2 are still special cases for convenience
3922 3927 and speed.
3923 3928
3924 3929 2003-08-03 Fernando Perez <fperez@colorado.edu>
3925 3930
3926 3931 * IPython/Magic.py (Magic.magic_edit): Removed all remaining string
3927 3932 exceptions, which now raise PendingDeprecationWarnings in Python
3928 3933 2.3. There were some in Magic and some in Gnuplot2.
3929 3934
3930 3935 2003-06-30 Fernando Perez <fperez@colorado.edu>
3931 3936
3932 3937 * IPython/genutils.py (page): modified to call curses only for
3933 3938 terminals where TERM=='xterm'. After problems under many other
3934 3939 terminals were reported by Keith Beattie <KSBeattie-AT-lbl.gov>.
3935 3940
3936 3941 * IPython/iplib.py (complete): removed spurious 'print "IE"' which
3937 3942 would be triggered when readline was absent. This was just an old
3938 3943 debugging statement I'd forgotten to take out.
3939 3944
3940 3945 2003-06-20 Fernando Perez <fperez@colorado.edu>
3941 3946
3942 3947 * IPython/genutils.py (clock): modified to return only user time
3943 3948 (not counting system time), after a discussion on scipy. While
3944 3949 system time may be a useful quantity occasionally, it may much
3945 3950 more easily be skewed by occasional swapping or other similar
3946 3951 activity.
3947 3952
3948 3953 2003-06-05 Fernando Perez <fperez@colorado.edu>
3949 3954
3950 3955 * IPython/numutils.py (identity): new function, for building
3951 3956 arbitrary rank Kronecker deltas (mostly backwards compatible with
3952 3957 Numeric.identity)
3953 3958
3954 3959 2003-06-03 Fernando Perez <fperez@colorado.edu>
3955 3960
3956 3961 * IPython/iplib.py (InteractiveShell.handle_magic): protect
3957 3962 arguments passed to magics with spaces, to allow trailing '\' to
3958 3963 work normally (mainly for Windows users).
3959 3964
3960 3965 2003-05-29 Fernando Perez <fperez@colorado.edu>
3961 3966
3962 3967 * IPython/ipmaker.py (make_IPython): Load site._Helper() as help
3963 3968 instead of pydoc.help. This fixes a bizarre behavior where
3964 3969 printing '%s' % locals() would trigger the help system. Now
3965 3970 ipython behaves like normal python does.
3966 3971
3967 3972 Note that if one does 'from pydoc import help', the bizarre
3968 3973 behavior returns, but this will also happen in normal python, so
3969 3974 it's not an ipython bug anymore (it has to do with how pydoc.help
3970 3975 is implemented).
3971 3976
3972 3977 2003-05-22 Fernando Perez <fperez@colorado.edu>
3973 3978
3974 3979 * IPython/FlexCompleter.py (Completer.attr_matches): fixed to
3975 3980 return [] instead of None when nothing matches, also match to end
3976 3981 of line. Patch by Gary Bishop.
3977 3982
3978 3983 * IPython/ipmaker.py (make_IPython): Added same sys.excepthook
3979 3984 protection as before, for files passed on the command line. This
3980 3985 prevents the CrashHandler from kicking in if user files call into
3981 3986 sys.excepthook (such as PyQt and WxWindows have a nasty habit of
3982 3987 doing). After a report by Kasper Souren <Kasper.Souren-AT-ircam.fr>
3983 3988
3984 3989 2003-05-20 *** Released version 0.4.0
3985 3990
3986 3991 2003-05-20 Fernando Perez <fperez@colorado.edu>
3987 3992
3988 3993 * setup.py: added support for manpages. It's a bit hackish b/c of
3989 3994 a bug in the way the bdist_rpm distutils target handles gzipped
3990 3995 manpages, but it works. After a patch by Jack.
3991 3996
3992 3997 2003-05-19 Fernando Perez <fperez@colorado.edu>
3993 3998
3994 3999 * IPython/numutils.py: added a mockup of the kinds module, since
3995 4000 it was recently removed from Numeric. This way, numutils will
3996 4001 work for all users even if they are missing kinds.
3997 4002
3998 4003 * IPython/Magic.py (Magic._ofind): Harden against an inspect
3999 4004 failure, which can occur with SWIG-wrapped extensions. After a
4000 4005 crash report from Prabhu.
4001 4006
4002 4007 2003-05-16 Fernando Perez <fperez@colorado.edu>
4003 4008
4004 4009 * IPython/iplib.py (InteractiveShell.excepthook): New method to
4005 4010 protect ipython from user code which may call directly
4006 4011 sys.excepthook (this looks like an ipython crash to the user, even
4007 4012 when it isn't). After a patch by Gary Bishop <gb-AT-cs.unc.edu>.
4008 4013 This is especially important to help users of WxWindows, but may
4009 4014 also be useful in other cases.
4010 4015
4011 4016 * IPython/ultraTB.py (AutoFormattedTB.__call__): Changed to allow
4012 4017 an optional tb_offset to be specified, and to preserve exception
4013 4018 info if given. After a patch by Gary Bishop <gb-AT-cs.unc.edu>.
4014 4019
4015 4020 * ipython.1 (Default): Thanks to Jack's work, we now have manpages!
4016 4021
4017 4022 2003-05-15 Fernando Perez <fperez@colorado.edu>
4018 4023
4019 4024 * IPython/iplib.py (InteractiveShell.user_setup): Fix crash when
4020 4025 installing for a new user under Windows.
4021 4026
4022 4027 2003-05-12 Fernando Perez <fperez@colorado.edu>
4023 4028
4024 4029 * IPython/iplib.py (InteractiveShell.handle_emacs): New line
4025 4030 handler for Emacs comint-based lines. Currently it doesn't do
4026 4031 much (but importantly, it doesn't update the history cache). In
4027 4032 the future it may be expanded if Alex needs more functionality
4028 4033 there.
4029 4034
4030 4035 * IPython/CrashHandler.py (CrashHandler.__call__): Added platform
4031 4036 info to crash reports.
4032 4037
4033 4038 * IPython/iplib.py (InteractiveShell.mainloop): Added -c option,
4034 4039 just like Python's -c. Also fixed crash with invalid -color
4035 4040 option value at startup. Thanks to Will French
4036 4041 <wfrench-AT-bestweb.net> for the bug report.
4037 4042
4038 4043 2003-05-09 Fernando Perez <fperez@colorado.edu>
4039 4044
4040 4045 * IPython/genutils.py (EvalDict.__getitem__): Renamed EvalString
4041 4046 to EvalDict (it's a mapping, after all) and simplified its code
4042 4047 quite a bit, after a nice discussion on c.l.py where Gustavo
4043 4048 Córdova <gcordova-AT-sismex.com> suggested the new version.
4044 4049
4045 4050 2003-04-30 Fernando Perez <fperez@colorado.edu>
4046 4051
4047 4052 * IPython/genutils.py (timings_out): modified it to reduce its
4048 4053 overhead in the common reps==1 case.
4049 4054
4050 4055 2003-04-29 Fernando Perez <fperez@colorado.edu>
4051 4056
4052 4057 * IPython/genutils.py (timings_out): Modified to use the resource
4053 4058 module, which avoids the wraparound problems of time.clock().
4054 4059
4055 4060 2003-04-17 *** Released version 0.2.15pre4
4056 4061
4057 4062 2003-04-17 Fernando Perez <fperez@colorado.edu>
4058 4063
4059 4064 * setup.py (scriptfiles): Split windows-specific stuff over to a
4060 4065 separate file, in an attempt to have a Windows GUI installer.
4061 4066 That didn't work, but part of the groundwork is done.
4062 4067
4063 4068 * IPython/UserConfig/ipythonrc: Added M-i, M-o and M-I for
4064 4069 indent/unindent with 4 spaces. Particularly useful in combination
4065 4070 with the new auto-indent option.
4066 4071
4067 4072 2003-04-16 Fernando Perez <fperez@colorado.edu>
4068 4073
4069 4074 * IPython/Magic.py: various replacements of self.rc for
4070 4075 self.shell.rc. A lot more remains to be done to fully disentangle
4071 4076 this class from the main Shell class.
4072 4077
4073 4078 * IPython/GnuplotRuntime.py: added checks for mouse support so
4074 4079 that we don't try to enable it if the current gnuplot doesn't
4075 4080 really support it. Also added checks so that we don't try to
4076 4081 enable persist under Windows (where Gnuplot doesn't recognize the
4077 4082 option).
4078 4083
4079 4084 * IPython/iplib.py (InteractiveShell.interact): Added optional
4080 4085 auto-indenting code, after a patch by King C. Shu
4081 4086 <kingshu-AT-myrealbox.com>. It's off by default because it doesn't
4082 4087 get along well with pasting indented code. If I ever figure out
4083 4088 how to make that part go well, it will become on by default.
4084 4089
4085 4090 * IPython/Prompts.py (Prompt1.auto_rewrite): Fixed bug which would
4086 4091 crash ipython if there was an unmatched '%' in the user's prompt
4087 4092 string. Reported by Thorsten Kampe <thorsten-AT-thorstenkampe.de>.
4088 4093
4089 4094 * IPython/iplib.py (InteractiveShell.interact): removed the
4090 4095 ability to ask the user whether he wants to crash or not at the
4091 4096 'last line' exception handler. Calling functions at that point
4092 4097 changes the stack, and the error reports would have incorrect
4093 4098 tracebacks.
4094 4099
4095 4100 * IPython/Magic.py (Magic.magic_page): Added new @page magic, to
4096 4101 pass through a peger a pretty-printed form of any object. After a
4097 4102 contribution by Olivier Aubert <oaubert-AT-bat710.univ-lyon1.fr>
4098 4103
4099 4104 2003-04-14 Fernando Perez <fperez@colorado.edu>
4100 4105
4101 4106 * IPython/iplib.py (InteractiveShell.user_setup): Fixed bug where
4102 4107 all files in ~ would be modified at first install (instead of
4103 4108 ~/.ipython). This could be potentially disastrous, as the
4104 4109 modification (make line-endings native) could damage binary files.
4105 4110
4106 4111 2003-04-10 Fernando Perez <fperez@colorado.edu>
4107 4112
4108 4113 * IPython/iplib.py (InteractiveShell.handle_help): Modified to
4109 4114 handle only lines which are invalid python. This now means that
4110 4115 lines like 'x=1 #?' execute properly. Thanks to Jeffery Collins
4111 4116 for the bug report.
4112 4117
4113 4118 2003-04-01 Fernando Perez <fperez@colorado.edu>
4114 4119
4115 4120 * IPython/iplib.py (InteractiveShell.showtraceback): Fixed bug
4116 4121 where failing to set sys.last_traceback would crash pdb.pm().
4117 4122 Thanks to Jeffery D. Collins <Jeff.Collins-AT-vexcel.com> for the bug
4118 4123 report.
4119 4124
4120 4125 2003-03-25 Fernando Perez <fperez@colorado.edu>
4121 4126
4122 4127 * IPython/Magic.py (Magic.magic_prun): rstrip() output of profiler
4123 4128 before printing it (it had a lot of spurious blank lines at the
4124 4129 end).
4125 4130
4126 4131 * IPython/Gnuplot2.py (Gnuplot.hardcopy): fixed bug where lpr
4127 4132 output would be sent 21 times! Obviously people don't use this
4128 4133 too often, or I would have heard about it.
4129 4134
4130 4135 2003-03-24 Fernando Perez <fperez@colorado.edu>
4131 4136
4132 4137 * setup.py (scriptfiles): renamed the data_files parameter from
4133 4138 'base' to 'data' to fix rpm build issues. Thanks to Ralf Ahlbrink
4134 4139 for the patch.
4135 4140
4136 4141 2003-03-20 Fernando Perez <fperez@colorado.edu>
4137 4142
4138 4143 * IPython/genutils.py (error): added error() and fatal()
4139 4144 functions.
4140 4145
4141 4146 2003-03-18 *** Released version 0.2.15pre3
4142 4147
4143 4148 2003-03-18 Fernando Perez <fperez@colorado.edu>
4144 4149
4145 4150 * setupext/install_data_ext.py
4146 4151 (install_data_ext.initialize_options): Class contributed by Jack
4147 4152 Moffit for fixing the old distutils hack. He is sending this to
4148 4153 the distutils folks so in the future we may not need it as a
4149 4154 private fix.
4150 4155
4151 4156 * MANIFEST.in: Extensive reorganization, based on Jack Moffit's
4152 4157 changes for Debian packaging. See his patch for full details.
4153 4158 The old distutils hack of making the ipythonrc* files carry a
4154 4159 bogus .py extension is gone, at last. Examples were moved to a
4155 4160 separate subdir under doc/, and the separate executable scripts
4156 4161 now live in their own directory. Overall a great cleanup. The
4157 4162 manual was updated to use the new files, and setup.py has been
4158 4163 fixed for this setup.
4159 4164
4160 4165 * IPython/PyColorize.py (Parser.usage): made non-executable and
4161 4166 created a pycolor wrapper around it to be included as a script.
4162 4167
4163 4168 2003-03-12 *** Released version 0.2.15pre2
4164 4169
4165 4170 2003-03-12 Fernando Perez <fperez@colorado.edu>
4166 4171
4167 4172 * IPython/ColorANSI.py (make_color_table): Finally fixed the
4168 4173 long-standing problem with garbage characters in some terminals.
4169 4174 The issue was really that the \001 and \002 escapes must _only_ be
4170 4175 passed to input prompts (which call readline), but _never_ to
4171 4176 normal text to be printed on screen. I changed ColorANSI to have
4172 4177 two classes: TermColors and InputTermColors, each with the
4173 4178 appropriate escapes for input prompts or normal text. The code in
4174 4179 Prompts.py got slightly more complicated, but this very old and
4175 4180 annoying bug is finally fixed.
4176 4181
4177 4182 All the credit for nailing down the real origin of this problem
4178 4183 and the correct solution goes to Jack Moffit <jack-AT-xiph.org>.
4179 4184 *Many* thanks to him for spending quite a bit of effort on this.
4180 4185
4181 4186 2003-03-05 *** Released version 0.2.15pre1
4182 4187
4183 4188 2003-03-03 Fernando Perez <fperez@colorado.edu>
4184 4189
4185 4190 * IPython/FakeModule.py: Moved the former _FakeModule to a
4186 4191 separate file, because it's also needed by Magic (to fix a similar
4187 4192 pickle-related issue in @run).
4188 4193
4189 4194 2003-03-02 Fernando Perez <fperez@colorado.edu>
4190 4195
4191 4196 * IPython/Magic.py (Magic.magic_autocall): new magic to control
4192 4197 the autocall option at runtime.
4193 4198 (Magic.magic_dhist): changed self.user_ns to self.shell.user_ns
4194 4199 across Magic.py to start separating Magic from InteractiveShell.
4195 4200 (Magic._ofind): Fixed to return proper namespace for dotted
4196 4201 names. Before, a dotted name would always return 'not currently
4197 4202 defined', because it would find the 'parent'. s.x would be found,
4198 4203 but since 'x' isn't defined by itself, it would get confused.
4199 4204 (Magic.magic_run): Fixed pickling problems reported by Ralf
4200 4205 Ahlbrink <RAhlbrink-AT-RosenInspection.net>. The fix was similar to
4201 4206 that I'd used when Mike Heeter reported similar issues at the
4202 4207 top-level, but now for @run. It boils down to injecting the
4203 4208 namespace where code is being executed with something that looks
4204 4209 enough like a module to fool pickle.dump(). Since a pickle stores
4205 4210 a named reference to the importing module, we need this for
4206 4211 pickles to save something sensible.
4207 4212
4208 4213 * IPython/ipmaker.py (make_IPython): added an autocall option.
4209 4214
4210 4215 * IPython/iplib.py (InteractiveShell._prefilter): reordered all of
4211 4216 the auto-eval code. Now autocalling is an option, and the code is
4212 4217 also vastly safer. There is no more eval() involved at all.
4213 4218
4214 4219 2003-03-01 Fernando Perez <fperez@colorado.edu>
4215 4220
4216 4221 * IPython/Magic.py (Magic._ofind): Changed interface to return a
4217 4222 dict with named keys instead of a tuple.
4218 4223
4219 4224 * IPython: Started using CVS for IPython as of 0.2.15pre1.
4220 4225
4221 4226 * setup.py (make_shortcut): Fixed message about directories
4222 4227 created during Windows installation (the directories were ok, just
4223 4228 the printed message was misleading). Thanks to Chris Liechti
4224 4229 <cliechti-AT-gmx.net> for the heads up.
4225 4230
4226 4231 2003-02-21 Fernando Perez <fperez@colorado.edu>
4227 4232
4228 4233 * IPython/iplib.py (InteractiveShell._prefilter): Fixed catching
4229 4234 of ValueError exception when checking for auto-execution. This
4230 4235 one is raised by things like Numeric arrays arr.flat when the
4231 4236 array is non-contiguous.
4232 4237
4233 4238 2003-01-31 Fernando Perez <fperez@colorado.edu>
4234 4239
4235 4240 * IPython/genutils.py (SystemExec.bq): Fixed bug where bq would
4236 4241 not return any value at all (even though the command would get
4237 4242 executed).
4238 4243 (xsys): Flush stdout right after printing the command to ensure
4239 4244 proper ordering of commands and command output in the total
4240 4245 output.
4241 4246 (SystemExec/xsys/bq): Switched the names of xsys/bq and
4242 4247 system/getoutput as defaults. The old ones are kept for
4243 4248 compatibility reasons, so no code which uses this library needs
4244 4249 changing.
4245 4250
4246 4251 2003-01-27 *** Released version 0.2.14
4247 4252
4248 4253 2003-01-25 Fernando Perez <fperez@colorado.edu>
4249 4254
4250 4255 * IPython/Magic.py (Magic.magic_edit): Fixed problem where
4251 4256 functions defined in previous edit sessions could not be re-edited
4252 4257 (because the temp files were immediately removed). Now temp files
4253 4258 are removed only at IPython's exit.
4254 4259 (Magic.magic_run): Improved @run to perform shell-like expansions
4255 4260 on its arguments (~users and $VARS). With this, @run becomes more
4256 4261 like a normal command-line.
4257 4262
4258 4263 * IPython/Shell.py (IPShellEmbed.__call__): Fixed a bunch of small
4259 4264 bugs related to embedding and cleaned up that code. A fairly
4260 4265 important one was the impossibility to access the global namespace
4261 4266 through the embedded IPython (only local variables were visible).
4262 4267
4263 4268 2003-01-14 Fernando Perez <fperez@colorado.edu>
4264 4269
4265 4270 * IPython/iplib.py (InteractiveShell._prefilter): Fixed
4266 4271 auto-calling to be a bit more conservative. Now it doesn't get
4267 4272 triggered if any of '!=()<>' are in the rest of the input line, to
4268 4273 allow comparing callables. Thanks to Alex for the heads up.
4269 4274
4270 4275 2003-01-07 Fernando Perez <fperez@colorado.edu>
4271 4276
4272 4277 * IPython/genutils.py (page): fixed estimation of the number of
4273 4278 lines in a string to be paged to simply count newlines. This
4274 4279 prevents over-guessing due to embedded escape sequences. A better
4275 4280 long-term solution would involve stripping out the control chars
4276 4281 for the count, but it's potentially so expensive I just don't
4277 4282 think it's worth doing.
4278 4283
4279 4284 2002-12-19 *** Released version 0.2.14pre50
4280 4285
4281 4286 2002-12-19 Fernando Perez <fperez@colorado.edu>
4282 4287
4283 4288 * tools/release (version): Changed release scripts to inform
4284 4289 Andrea and build a NEWS file with a list of recent changes.
4285 4290
4286 4291 * IPython/ColorANSI.py (__all__): changed terminal detection
4287 4292 code. Seems to work better for xterms without breaking
4288 4293 konsole. Will need more testing to determine if WinXP and Mac OSX
4289 4294 also work ok.
4290 4295
4291 4296 2002-12-18 *** Released version 0.2.14pre49
4292 4297
4293 4298 2002-12-18 Fernando Perez <fperez@colorado.edu>
4294 4299
4295 4300 * Docs: added new info about Mac OSX, from Andrea.
4296 4301
4297 4302 * IPython/Gnuplot2.py (String): Added a String PlotItem class to
4298 4303 allow direct plotting of python strings whose format is the same
4299 4304 of gnuplot data files.
4300 4305
4301 4306 2002-12-16 Fernando Perez <fperez@colorado.edu>
4302 4307
4303 4308 * IPython/iplib.py (InteractiveShell.interact): fixed default (y)
4304 4309 value of exit question to be acknowledged.
4305 4310
4306 4311 2002-12-03 Fernando Perez <fperez@colorado.edu>
4307 4312
4308 4313 * IPython/ipmaker.py: removed generators, which had been added
4309 4314 by mistake in an earlier debugging run. This was causing trouble
4310 4315 to users of python 2.1.x. Thanks to Abel Daniel <abli-AT-freemail.hu>
4311 4316 for pointing this out.
4312 4317
4313 4318 2002-11-17 Fernando Perez <fperez@colorado.edu>
4314 4319
4315 4320 * Manual: updated the Gnuplot section.
4316 4321
4317 4322 * IPython/GnuplotRuntime.py: refactored a lot all this code, with
4318 4323 a much better split of what goes in Runtime and what goes in
4319 4324 Interactive.
4320 4325
4321 4326 * IPython/ipmaker.py: fixed bug where import_fail_info wasn't
4322 4327 being imported from iplib.
4323 4328
4324 4329 * IPython/GnuplotInteractive.py (magic_gpc): renamed @gp to @gpc
4325 4330 for command-passing. Now the global Gnuplot instance is called
4326 4331 'gp' instead of 'g', which was really a far too fragile and
4327 4332 common name.
4328 4333
4329 4334 * IPython/Gnuplot2.py (eps_fix_bbox): added this to fix broken
4330 4335 bounding boxes generated by Gnuplot for square plots.
4331 4336
4332 4337 * IPython/genutils.py (popkey): new function added. I should
4333 4338 suggest this on c.l.py as a dict method, it seems useful.
4334 4339
4335 4340 * IPython/Gnuplot2.py (Gnuplot.plot): Overhauled plot and replot
4336 4341 to transparently handle PostScript generation. MUCH better than
4337 4342 the previous plot_eps/replot_eps (which I removed now). The code
4338 4343 is also fairly clean and well documented now (including
4339 4344 docstrings).
4340 4345
4341 4346 2002-11-13 Fernando Perez <fperez@colorado.edu>
4342 4347
4343 4348 * IPython/Magic.py (Magic.magic_edit): fixed docstring
4344 4349 (inconsistent with options).
4345 4350
4346 4351 * IPython/Gnuplot2.py (Gnuplot.hardcopy): hardcopy had been
4347 4352 manually disabled, I don't know why. Fixed it.
4348 4353 (Gnuplot._plot_eps): added new plot_eps/replot_eps to get directly
4349 4354 eps output.
4350 4355
4351 4356 2002-11-12 Fernando Perez <fperez@colorado.edu>
4352 4357
4353 4358 * IPython/genutils.py (ask_yes_no): trap EOF and ^C so that they
4354 4359 don't propagate up to caller. Fixes crash reported by François
4355 4360 Pinard.
4356 4361
4357 4362 2002-11-09 Fernando Perez <fperez@colorado.edu>
4358 4363
4359 4364 * IPython/ipmaker.py (make_IPython): fixed problem with writing
4360 4365 history file for new users.
4361 4366 (make_IPython): fixed bug where initial install would leave the
4362 4367 user running in the .ipython dir.
4363 4368 (make_IPython): fixed bug where config dir .ipython would be
4364 4369 created regardless of the given -ipythondir option. Thanks to Cory
4365 4370 Dodt <cdodt-AT-fcoe.k12.ca.us> for the bug report.
4366 4371
4367 4372 * IPython/genutils.py (ask_yes_no): new function for asking yes/no
4368 4373 type confirmations. Will need to use it in all of IPython's code
4369 4374 consistently.
4370 4375
4371 4376 * IPython/CrashHandler.py (CrashHandler.__call__): changed the
4372 4377 context to print 31 lines instead of the default 5. This will make
4373 4378 the crash reports extremely detailed in case the problem is in
4374 4379 libraries I don't have access to.
4375 4380
4376 4381 * IPython/iplib.py (InteractiveShell.interact): changed the 'last
4377 4382 line of defense' code to still crash, but giving users fair
4378 4383 warning. I don't want internal errors to go unreported: if there's
4379 4384 an internal problem, IPython should crash and generate a full
4380 4385 report.
4381 4386
4382 4387 2002-11-08 Fernando Perez <fperez@colorado.edu>
4383 4388
4384 4389 * IPython/iplib.py (InteractiveShell.interact): added code to trap
4385 4390 otherwise uncaught exceptions which can appear if people set
4386 4391 sys.stdout to something badly broken. Thanks to a crash report
4387 4392 from henni-AT-mail.brainbot.com.
4388 4393
4389 4394 2002-11-04 Fernando Perez <fperez@colorado.edu>
4390 4395
4391 4396 * IPython/iplib.py (InteractiveShell.interact): added
4392 4397 __IPYTHON__active to the builtins. It's a flag which goes on when
4393 4398 the interaction starts and goes off again when it stops. This
4394 4399 allows embedding code to detect being inside IPython. Before this
4395 4400 was done via __IPYTHON__, but that only shows that an IPython
4396 4401 instance has been created.
4397 4402
4398 4403 * IPython/Magic.py (Magic.magic_env): I realized that in a
4399 4404 UserDict, instance.data holds the data as a normal dict. So I
4400 4405 modified @env to return os.environ.data instead of rebuilding a
4401 4406 dict by hand.
4402 4407
4403 4408 2002-11-02 Fernando Perez <fperez@colorado.edu>
4404 4409
4405 4410 * IPython/genutils.py (warn): changed so that level 1 prints no
4406 4411 header. Level 2 is now the default (with 'WARNING' header, as
4407 4412 before). I think I tracked all places where changes were needed in
4408 4413 IPython, but outside code using the old level numbering may have
4409 4414 broken.
4410 4415
4411 4416 * IPython/iplib.py (InteractiveShell.runcode): added this to
4412 4417 handle the tracebacks in SystemExit traps correctly. The previous
4413 4418 code (through interact) was printing more of the stack than
4414 4419 necessary, showing IPython internal code to the user.
4415 4420
4416 4421 * IPython/UserConfig/ipythonrc.py: Made confirm_exit 1 by
4417 4422 default. Now that the default at the confirmation prompt is yes,
4418 4423 it's not so intrusive. François' argument that ipython sessions
4419 4424 tend to be complex enough not to lose them from an accidental C-d,
4420 4425 is a valid one.
4421 4426
4422 4427 * IPython/iplib.py (InteractiveShell.interact): added a
4423 4428 showtraceback() call to the SystemExit trap, and modified the exit
4424 4429 confirmation to have yes as the default.
4425 4430
4426 4431 * IPython/UserConfig/ipythonrc.py: removed 'session' option from
4427 4432 this file. It's been gone from the code for a long time, this was
4428 4433 simply leftover junk.
4429 4434
4430 4435 2002-11-01 Fernando Perez <fperez@colorado.edu>
4431 4436
4432 4437 * IPython/UserConfig/ipythonrc.py: new confirm_exit option
4433 4438 added. If set, IPython now traps EOF and asks for
4434 4439 confirmation. After a request by François Pinard.
4435 4440
4436 4441 * IPython/Magic.py (Magic.magic_Exit): New @Exit and @Quit instead
4437 4442 of @abort, and with a new (better) mechanism for handling the
4438 4443 exceptions.
4439 4444
4440 4445 2002-10-27 Fernando Perez <fperez@colorado.edu>
4441 4446
4442 4447 * IPython/usage.py (__doc__): updated the --help information and
4443 4448 the ipythonrc file to indicate that -log generates
4444 4449 ./ipython.log. Also fixed the corresponding info in @logstart.
4445 4450 This and several other fixes in the manuals thanks to reports by
4446 4451 François Pinard <pinard-AT-iro.umontreal.ca>.
4447 4452
4448 4453 * IPython/Logger.py (Logger.switch_log): Fixed error message to
4449 4454 refer to @logstart (instead of @log, which doesn't exist).
4450 4455
4451 4456 * IPython/iplib.py (InteractiveShell._prefilter): fixed
4452 4457 AttributeError crash. Thanks to Christopher Armstrong
4453 4458 <radix-AT-twistedmatrix.com> for the report/fix. This bug had been
4454 4459 introduced recently (in 0.2.14pre37) with the fix to the eval
4455 4460 problem mentioned below.
4456 4461
4457 4462 2002-10-17 Fernando Perez <fperez@colorado.edu>
4458 4463
4459 4464 * IPython/ConfigLoader.py (ConfigLoader.load): Fixes for Windows
4460 4465 installation. Thanks to Leonardo Santagada <retype-AT-terra.com.br>.
4461 4466
4462 4467 * IPython/iplib.py (InteractiveShell._prefilter): Many changes to
4463 4468 this function to fix a problem reported by Alex Schmolck. He saw
4464 4469 it with list comprehensions and generators, which were getting
4465 4470 called twice. The real problem was an 'eval' call in testing for
4466 4471 automagic which was evaluating the input line silently.
4467 4472
4468 4473 This is a potentially very nasty bug, if the input has side
4469 4474 effects which must not be repeated. The code is much cleaner now,
4470 4475 without any blanket 'except' left and with a regexp test for
4471 4476 actual function names.
4472 4477
4473 4478 But an eval remains, which I'm not fully comfortable with. I just
4474 4479 don't know how to find out if an expression could be a callable in
4475 4480 the user's namespace without doing an eval on the string. However
4476 4481 that string is now much more strictly checked so that no code
4477 4482 slips by, so the eval should only happen for things that can
4478 4483 really be only function/method names.
4479 4484
4480 4485 2002-10-15 Fernando Perez <fperez@colorado.edu>
4481 4486
4482 4487 * Updated LyX to 1.2.1 so I can work on the docs again. Added Mac
4483 4488 OSX information to main manual, removed README_Mac_OSX file from
4484 4489 distribution. Also updated credits for recent additions.
4485 4490
4486 4491 2002-10-10 Fernando Perez <fperez@colorado.edu>
4487 4492
4488 4493 * README_Mac_OSX: Added a README for Mac OSX users for fixing
4489 4494 terminal-related issues. Many thanks to Andrea Riciputi
4490 4495 <andrea.riciputi-AT-libero.it> for writing it.
4491 4496
4492 4497 * IPython/UserConfig/ipythonrc.py: Fixes to various small issues,
4493 4498 thanks to Thorsten Kampe <thorsten-AT-thorstenkampe.de>.
4494 4499
4495 4500 * setup.py (make_shortcut): Fixes for Windows installation. Thanks
4496 4501 to Fredrik Kant <fredrik.kant-AT-front.com> and Syver Enstad
4497 4502 <syver-en-AT-online.no> who both submitted patches for this problem.
4498 4503
4499 4504 * IPython/iplib.py (InteractiveShell.embed_mainloop): Patch for
4500 4505 global embedding to make sure that things don't overwrite user
4501 4506 globals accidentally. Thanks to Richard <rxe-AT-renre-europe.com>
4502 4507
4503 4508 * IPython/Gnuplot2.py (gp): Patch for Gnuplot.py 1.6
4504 4509 compatibility. Thanks to Hayden Callow
4505 4510 <h.callow-AT-elec.canterbury.ac.nz>
4506 4511
4507 4512 2002-10-04 Fernando Perez <fperez@colorado.edu>
4508 4513
4509 4514 * IPython/Gnuplot2.py (PlotItem): Added 'index' option for
4510 4515 Gnuplot.File objects.
4511 4516
4512 4517 2002-07-23 Fernando Perez <fperez@colorado.edu>
4513 4518
4514 4519 * IPython/genutils.py (timing): Added timings() and timing() for
4515 4520 quick access to the most commonly needed data, the execution
4516 4521 times. Old timing() renamed to timings_out().
4517 4522
4518 4523 2002-07-18 Fernando Perez <fperez@colorado.edu>
4519 4524
4520 4525 * IPython/Shell.py (IPShellEmbed.restore_system_completer): fixed
4521 4526 bug with nested instances disrupting the parent's tab completion.
4522 4527
4523 4528 * IPython/iplib.py (all_completions): Added Alex Schmolck's
4524 4529 all_completions code to begin the emacs integration.
4525 4530
4526 4531 * IPython/Gnuplot2.py (zip_items): Added optional 'titles'
4527 4532 argument to allow titling individual arrays when plotting.
4528 4533
4529 4534 2002-07-15 Fernando Perez <fperez@colorado.edu>
4530 4535
4531 4536 * setup.py (make_shortcut): changed to retrieve the value of
4532 4537 'Program Files' directory from the registry (this value changes in
4533 4538 non-english versions of Windows). Thanks to Thomas Fanslau
4534 4539 <tfanslau-AT-gmx.de> for the report.
4535 4540
4536 4541 2002-07-10 Fernando Perez <fperez@colorado.edu>
4537 4542
4538 4543 * IPython/ultraTB.py (VerboseTB.debugger): enabled workaround for
4539 4544 a bug in pdb, which crashes if a line with only whitespace is
4540 4545 entered. Bug report submitted to sourceforge.
4541 4546
4542 4547 2002-07-09 Fernando Perez <fperez@colorado.edu>
4543 4548
4544 4549 * IPython/ultraTB.py (VerboseTB.nullrepr): fixed rare crash when
4545 4550 reporting exceptions (it's a bug in inspect.py, I just set a
4546 4551 workaround).
4547 4552
4548 4553 2002-07-08 Fernando Perez <fperez@colorado.edu>
4549 4554
4550 4555 * IPython/iplib.py (InteractiveShell.__init__): fixed reference to
4551 4556 __IPYTHON__ in __builtins__ to show up in user_ns.
4552 4557
4553 4558 2002-07-03 Fernando Perez <fperez@colorado.edu>
4554 4559
4555 4560 * IPython/GnuplotInteractive.py (magic_gp_set_default): changed
4556 4561 name from @gp_set_instance to @gp_set_default.
4557 4562
4558 4563 * IPython/ipmaker.py (make_IPython): default editor value set to
4559 4564 '0' (a string), to match the rc file. Otherwise will crash when
4560 4565 .strip() is called on it.
4561 4566
4562 4567
4563 4568 2002-06-28 Fernando Perez <fperez@colorado.edu>
4564 4569
4565 4570 * IPython/iplib.py (InteractiveShell.safe_execfile): fix importing
4566 4571 of files in current directory when a file is executed via
4567 4572 @run. Patch also by RA <ralf_ahlbrink-AT-web.de>.
4568 4573
4569 4574 * setup.py (manfiles): fix for rpm builds, submitted by RA
4570 4575 <ralf_ahlbrink-AT-web.de>. Now we have RPMs!
4571 4576
4572 4577 * IPython/ipmaker.py (make_IPython): fixed lookup of default
4573 4578 editor when set to '0'. Problem was, '0' evaluates to True (it's a
4574 4579 string!). A. Schmolck caught this one.
4575 4580
4576 4581 2002-06-27 Fernando Perez <fperez@colorado.edu>
4577 4582
4578 4583 * IPython/ipmaker.py (make_IPython): fixed bug when running user
4579 4584 defined files at the cmd line. __name__ wasn't being set to
4580 4585 __main__.
4581 4586
4582 4587 * IPython/Gnuplot2.py (zip_items): improved it so it can plot also
4583 4588 regular lists and tuples besides Numeric arrays.
4584 4589
4585 4590 * IPython/Prompts.py (CachedOutput.__call__): Added output
4586 4591 supression for input ending with ';'. Similar to Mathematica and
4587 4592 Matlab. The _* vars and Out[] list are still updated, just like
4588 4593 Mathematica behaves.
4589 4594
4590 4595 2002-06-25 Fernando Perez <fperez@colorado.edu>
4591 4596
4592 4597 * IPython/ConfigLoader.py (ConfigLoader.load): fixed checking of
4593 4598 .ini extensions for profiels under Windows.
4594 4599
4595 4600 * IPython/OInspect.py (Inspector.pinfo): improved alignment of
4596 4601 string form. Fix contributed by Alexander Schmolck
4597 4602 <a.schmolck-AT-gmx.net>
4598 4603
4599 4604 * IPython/GnuplotRuntime.py (gp_new): new function. Returns a
4600 4605 pre-configured Gnuplot instance.
4601 4606
4602 4607 2002-06-21 Fernando Perez <fperez@colorado.edu>
4603 4608
4604 4609 * IPython/numutils.py (exp_safe): new function, works around the
4605 4610 underflow problems in Numeric.
4606 4611 (log2): New fn. Safe log in base 2: returns exact integer answer
4607 4612 for exact integer powers of 2.
4608 4613
4609 4614 * IPython/Magic.py (get_py_filename): fixed it not expanding '~'
4610 4615 properly.
4611 4616
4612 4617 2002-06-20 Fernando Perez <fperez@colorado.edu>
4613 4618
4614 4619 * IPython/genutils.py (timing): new function like
4615 4620 Mathematica's. Similar to time_test, but returns more info.
4616 4621
4617 4622 2002-06-18 Fernando Perez <fperez@colorado.edu>
4618 4623
4619 4624 * IPython/Magic.py (Magic.magic_save): modified @save and @r
4620 4625 according to Mike Heeter's suggestions.
4621 4626
4622 4627 2002-06-16 Fernando Perez <fperez@colorado.edu>
4623 4628
4624 4629 * IPython/GnuplotRuntime.py: Massive overhaul to the Gnuplot
4625 4630 system. GnuplotMagic is gone as a user-directory option. New files
4626 4631 make it easier to use all the gnuplot stuff both from external
4627 4632 programs as well as from IPython. Had to rewrite part of
4628 4633 hardcopy() b/c of a strange bug: often the ps files simply don't
4629 4634 get created, and require a repeat of the command (often several
4630 4635 times).
4631 4636
4632 4637 * IPython/ultraTB.py (AutoFormattedTB.__call__): changed to
4633 4638 resolve output channel at call time, so that if sys.stderr has
4634 4639 been redirected by user this gets honored.
4635 4640
4636 4641 2002-06-13 Fernando Perez <fperez@colorado.edu>
4637 4642
4638 4643 * IPython/Shell.py (IPShell.__init__): Changed IPythonShell to
4639 4644 IPShell. Kept a copy with the old names to avoid breaking people's
4640 4645 embedded code.
4641 4646
4642 4647 * IPython/ipython: simplified it to the bare minimum after
4643 4648 Holger's suggestions. Added info about how to use it in
4644 4649 PYTHONSTARTUP.
4645 4650
4646 4651 * IPython/Shell.py (IPythonShell): changed the options passing
4647 4652 from a string with funky %s replacements to a straight list. Maybe
4648 4653 a bit more typing, but it follows sys.argv conventions, so there's
4649 4654 less special-casing to remember.
4650 4655
4651 4656 2002-06-12 Fernando Perez <fperez@colorado.edu>
4652 4657
4653 4658 * IPython/Magic.py (Magic.magic_r): new magic auto-repeat
4654 4659 command. Thanks to a suggestion by Mike Heeter.
4655 4660 (Magic.magic_pfile): added behavior to look at filenames if given
4656 4661 arg is not a defined object.
4657 4662 (Magic.magic_save): New @save function to save code snippets. Also
4658 4663 a Mike Heeter idea.
4659 4664
4660 4665 * IPython/UserConfig/GnuplotMagic.py (plot): Improvements to
4661 4666 plot() and replot(). Much more convenient now, especially for
4662 4667 interactive use.
4663 4668
4664 4669 * IPython/Magic.py (Magic.magic_run): Added .py automatically to
4665 4670 filenames.
4666 4671
4667 4672 2002-06-02 Fernando Perez <fperez@colorado.edu>
4668 4673
4669 4674 * IPython/Struct.py (Struct.__init__): modified to admit
4670 4675 initialization via another struct.
4671 4676
4672 4677 * IPython/genutils.py (SystemExec.__init__): New stateful
4673 4678 interface to xsys and bq. Useful for writing system scripts.
4674 4679
4675 4680 2002-05-30 Fernando Perez <fperez@colorado.edu>
4676 4681
4677 4682 * MANIFEST.in: Changed docfile selection to exclude all the lyx
4678 4683 documents. This will make the user download smaller (it's getting
4679 4684 too big).
4680 4685
4681 4686 2002-05-29 Fernando Perez <fperez@colorado.edu>
4682 4687
4683 4688 * IPython/iplib.py (_FakeModule.__init__): New class introduced to
4684 4689 fix problems with shelve and pickle. Seems to work, but I don't
4685 4690 know if corner cases break it. Thanks to Mike Heeter
4686 4691 <korora-AT-SDF.LONESTAR.ORG> for the bug reports and test cases.
4687 4692
4688 4693 2002-05-24 Fernando Perez <fperez@colorado.edu>
4689 4694
4690 4695 * IPython/Magic.py (Macro.__init__): fixed magics embedded in
4691 4696 macros having broken.
4692 4697
4693 4698 2002-05-21 Fernando Perez <fperez@colorado.edu>
4694 4699
4695 4700 * IPython/Magic.py (Magic.magic_logstart): fixed recently
4696 4701 introduced logging bug: all history before logging started was
4697 4702 being written one character per line! This came from the redesign
4698 4703 of the input history as a special list which slices to strings,
4699 4704 not to lists.
4700 4705
4701 4706 2002-05-20 Fernando Perez <fperez@colorado.edu>
4702 4707
4703 4708 * IPython/Prompts.py (CachedOutput.__init__): made the color table
4704 4709 be an attribute of all classes in this module. The design of these
4705 4710 classes needs some serious overhauling.
4706 4711
4707 4712 * IPython/DPyGetOpt.py (DPyGetOpt.setPosixCompliance): fixed bug
4708 4713 which was ignoring '_' in option names.
4709 4714
4710 4715 * IPython/ultraTB.py (FormattedTB.__init__): Changed
4711 4716 'Verbose_novars' to 'Context' and made it the new default. It's a
4712 4717 bit more readable and also safer than verbose.
4713 4718
4714 4719 * IPython/PyColorize.py (Parser.__call__): Fixed coloring of
4715 4720 triple-quoted strings.
4716 4721
4717 4722 * IPython/OInspect.py (__all__): new module exposing the object
4718 4723 introspection facilities. Now the corresponding magics are dummy
4719 4724 wrappers around this. Having this module will make it much easier
4720 4725 to put these functions into our modified pdb.
4721 4726 This new object inspector system uses the new colorizing module,
4722 4727 so source code and other things are nicely syntax highlighted.
4723 4728
4724 4729 2002-05-18 Fernando Perez <fperez@colorado.edu>
4725 4730
4726 4731 * IPython/ColorANSI.py: Split the coloring tools into a separate
4727 4732 module so I can use them in other code easier (they were part of
4728 4733 ultraTB).
4729 4734
4730 4735 2002-05-17 Fernando Perez <fperez@colorado.edu>
4731 4736
4732 4737 * IPython/UserConfig/GnuplotMagic.py (magic_gp_set_instance):
4733 4738 fixed it to set the global 'g' also to the called instance, as
4734 4739 long as 'g' was still a gnuplot instance (so it doesn't overwrite
4735 4740 user's 'g' variables).
4736 4741
4737 4742 * IPython/iplib.py (InteractiveShell.__init__): Added In/Out
4738 4743 global variables (aliases to _ih,_oh) so that users which expect
4739 4744 In[5] or Out[7] to work aren't unpleasantly surprised.
4740 4745 (InputList.__getslice__): new class to allow executing slices of
4741 4746 input history directly. Very simple class, complements the use of
4742 4747 macros.
4743 4748
4744 4749 2002-05-16 Fernando Perez <fperez@colorado.edu>
4745 4750
4746 4751 * setup.py (docdirbase): make doc directory be just doc/IPython
4747 4752 without version numbers, it will reduce clutter for users.
4748 4753
4749 4754 * IPython/Magic.py (Magic.magic_run): Add explicit local dict to
4750 4755 execfile call to prevent possible memory leak. See for details:
4751 4756 http://mail.python.org/pipermail/python-list/2002-February/088476.html
4752 4757
4753 4758 2002-05-15 Fernando Perez <fperez@colorado.edu>
4754 4759
4755 4760 * IPython/Magic.py (Magic.magic_psource): made the object
4756 4761 introspection names be more standard: pdoc, pdef, pfile and
4757 4762 psource. They all print/page their output, and it makes
4758 4763 remembering them easier. Kept old names for compatibility as
4759 4764 aliases.
4760 4765
4761 4766 2002-05-14 Fernando Perez <fperez@colorado.edu>
4762 4767
4763 4768 * IPython/UserConfig/GnuplotMagic.py: I think I finally understood
4764 4769 what the mouse problem was. The trick is to use gnuplot with temp
4765 4770 files and NOT with pipes (for data communication), because having
4766 4771 both pipes and the mouse on is bad news.
4767 4772
4768 4773 2002-05-13 Fernando Perez <fperez@colorado.edu>
4769 4774
4770 4775 * IPython/Magic.py (Magic._ofind): fixed namespace order search
4771 4776 bug. Information would be reported about builtins even when
4772 4777 user-defined functions overrode them.
4773 4778
4774 4779 2002-05-11 Fernando Perez <fperez@colorado.edu>
4775 4780
4776 4781 * IPython/__init__.py (__all__): removed FlexCompleter from
4777 4782 __all__ so that things don't fail in platforms without readline.
4778 4783
4779 4784 2002-05-10 Fernando Perez <fperez@colorado.edu>
4780 4785
4781 4786 * IPython/__init__.py (__all__): removed numutils from __all__ b/c
4782 4787 it requires Numeric, effectively making Numeric a dependency for
4783 4788 IPython.
4784 4789
4785 4790 * Released 0.2.13
4786 4791
4787 4792 * IPython/Magic.py (Magic.magic_prun): big overhaul to the
4788 4793 profiler interface. Now all the major options from the profiler
4789 4794 module are directly supported in IPython, both for single
4790 4795 expressions (@prun) and for full programs (@run -p).
4791 4796
4792 4797 2002-05-09 Fernando Perez <fperez@colorado.edu>
4793 4798
4794 4799 * IPython/Magic.py (Magic.magic_doc): fixed to show docstrings of
4795 4800 magic properly formatted for screen.
4796 4801
4797 4802 * setup.py (make_shortcut): Changed things to put pdf version in
4798 4803 doc/ instead of doc/manual (had to change lyxport a bit).
4799 4804
4800 4805 * IPython/Magic.py (Profile.string_stats): made profile runs go
4801 4806 through pager (they are long and a pager allows searching, saving,
4802 4807 etc.)
4803 4808
4804 4809 2002-05-08 Fernando Perez <fperez@colorado.edu>
4805 4810
4806 4811 * Released 0.2.12
4807 4812
4808 4813 2002-05-06 Fernando Perez <fperez@colorado.edu>
4809 4814
4810 4815 * IPython/Magic.py (Magic.magic_hist): small bug fixed (recently
4811 4816 introduced); 'hist n1 n2' was broken.
4812 4817 (Magic.magic_pdb): added optional on/off arguments to @pdb
4813 4818 (Magic.magic_run): added option -i to @run, which executes code in
4814 4819 the IPython namespace instead of a clean one. Also added @irun as
4815 4820 an alias to @run -i.
4816 4821
4817 4822 * IPython/UserConfig/GnuplotMagic.py (magic_gp_set_instance):
4818 4823 fixed (it didn't really do anything, the namespaces were wrong).
4819 4824
4820 4825 * IPython/Debugger.py (__init__): Added workaround for python 2.1
4821 4826
4822 4827 * IPython/__init__.py (__all__): Fixed package namespace, now
4823 4828 'import IPython' does give access to IPython.<all> as
4824 4829 expected. Also renamed __release__ to Release.
4825 4830
4826 4831 * IPython/Debugger.py (__license__): created new Pdb class which
4827 4832 functions like a drop-in for the normal pdb.Pdb but does NOT
4828 4833 import readline by default. This way it doesn't muck up IPython's
4829 4834 readline handling, and now tab-completion finally works in the
4830 4835 debugger -- sort of. It completes things globally visible, but the
4831 4836 completer doesn't track the stack as pdb walks it. That's a bit
4832 4837 tricky, and I'll have to implement it later.
4833 4838
4834 4839 2002-05-05 Fernando Perez <fperez@colorado.edu>
4835 4840
4836 4841 * IPython/Magic.py (Magic.magic_oinfo): fixed formatting bug for
4837 4842 magic docstrings when printed via ? (explicit \'s were being
4838 4843 printed).
4839 4844
4840 4845 * IPython/ipmaker.py (make_IPython): fixed namespace
4841 4846 identification bug. Now variables loaded via logs or command-line
4842 4847 files are recognized in the interactive namespace by @who.
4843 4848
4844 4849 * IPython/iplib.py (InteractiveShell.safe_execfile): Fixed bug in
4845 4850 log replay system stemming from the string form of Structs.
4846 4851
4847 4852 * IPython/Magic.py (Macro.__init__): improved macros to properly
4848 4853 handle magic commands in them.
4849 4854 (Magic.magic_logstart): usernames are now expanded so 'logstart
4850 4855 ~/mylog' now works.
4851 4856
4852 4857 * IPython/iplib.py (complete): fixed bug where paths starting with
4853 4858 '/' would be completed as magic names.
4854 4859
4855 4860 2002-05-04 Fernando Perez <fperez@colorado.edu>
4856 4861
4857 4862 * IPython/Magic.py (Magic.magic_run): added options -p and -f to
4858 4863 allow running full programs under the profiler's control.
4859 4864
4860 4865 * IPython/ultraTB.py (FormattedTB.__init__): Added Verbose_novars
4861 4866 mode to report exceptions verbosely but without formatting
4862 4867 variables. This addresses the issue of ipython 'freezing' (it's
4863 4868 not frozen, but caught in an expensive formatting loop) when huge
4864 4869 variables are in the context of an exception.
4865 4870 (VerboseTB.text): Added '--->' markers at line where exception was
4866 4871 triggered. Much clearer to read, especially in NoColor modes.
4867 4872
4868 4873 * IPython/Magic.py (Magic.magic_run): bugfix: -n option had been
4869 4874 implemented in reverse when changing to the new parse_options().
4870 4875
4871 4876 2002-05-03 Fernando Perez <fperez@colorado.edu>
4872 4877
4873 4878 * IPython/Magic.py (Magic.parse_options): new function so that
4874 4879 magics can parse options easier.
4875 4880 (Magic.magic_prun): new function similar to profile.run(),
4876 4881 suggested by Chris Hart.
4877 4882 (Magic.magic_cd): fixed behavior so that it only changes if
4878 4883 directory actually is in history.
4879 4884
4880 4885 * IPython/usage.py (__doc__): added information about potential
4881 4886 slowness of Verbose exception mode when there are huge data
4882 4887 structures to be formatted (thanks to Archie Paulson).
4883 4888
4884 4889 * IPython/ipmaker.py (make_IPython): Changed default logging
4885 4890 (when simply called with -log) to use curr_dir/ipython.log in
4886 4891 rotate mode. Fixed crash which was occuring with -log before
4887 4892 (thanks to Jim Boyle).
4888 4893
4889 4894 2002-05-01 Fernando Perez <fperez@colorado.edu>
4890 4895
4891 4896 * Released 0.2.11 for these fixes (mainly the ultraTB one which
4892 4897 was nasty -- though somewhat of a corner case).
4893 4898
4894 4899 * IPython/ultraTB.py (AutoFormattedTB.text): renamed __text to
4895 4900 text (was a bug).
4896 4901
4897 4902 2002-04-30 Fernando Perez <fperez@colorado.edu>
4898 4903
4899 4904 * IPython/UserConfig/GnuplotMagic.py (magic_gp): Minor fix to add
4900 4905 a print after ^D or ^C from the user so that the In[] prompt
4901 4906 doesn't over-run the gnuplot one.
4902 4907
4903 4908 2002-04-29 Fernando Perez <fperez@colorado.edu>
4904 4909
4905 4910 * Released 0.2.10
4906 4911
4907 4912 * IPython/__release__.py (version): get date dynamically.
4908 4913
4909 4914 * Misc. documentation updates thanks to Arnd's comments. Also ran
4910 4915 a full spellcheck on the manual (hadn't been done in a while).
4911 4916
4912 4917 2002-04-27 Fernando Perez <fperez@colorado.edu>
4913 4918
4914 4919 * IPython/Magic.py (Magic.magic_logstart): Fixed bug where
4915 4920 starting a log in mid-session would reset the input history list.
4916 4921
4917 4922 2002-04-26 Fernando Perez <fperez@colorado.edu>
4918 4923
4919 4924 * IPython/iplib.py (InteractiveShell.wait): Fixed bug where not
4920 4925 all files were being included in an update. Now anything in
4921 4926 UserConfig that matches [A-Za-z]*.py will go (this excludes
4922 4927 __init__.py)
4923 4928
4924 4929 2002-04-25 Fernando Perez <fperez@colorado.edu>
4925 4930
4926 4931 * IPython/iplib.py (InteractiveShell.__init__): Added __IPYTHON__
4927 4932 to __builtins__ so that any form of embedded or imported code can
4928 4933 test for being inside IPython.
4929 4934
4930 4935 * IPython/UserConfig/GnuplotMagic.py: (magic_gp_set_instance):
4931 4936 changed to GnuplotMagic because it's now an importable module,
4932 4937 this makes the name follow that of the standard Gnuplot module.
4933 4938 GnuplotMagic can now be loaded at any time in mid-session.
4934 4939
4935 4940 2002-04-24 Fernando Perez <fperez@colorado.edu>
4936 4941
4937 4942 * IPython/numutils.py: removed SIUnits. It doesn't properly set
4938 4943 the globals (IPython has its own namespace) and the
4939 4944 PhysicalQuantity stuff is much better anyway.
4940 4945
4941 4946 * IPython/UserConfig/example-gnuplot.py (g2): Added gnuplot
4942 4947 embedding example to standard user directory for
4943 4948 distribution. Also put it in the manual.
4944 4949
4945 4950 * IPython/numutils.py (gnuplot_exec): Changed to take a gnuplot
4946 4951 instance as first argument (so it doesn't rely on some obscure
4947 4952 hidden global).
4948 4953
4949 4954 * IPython/UserConfig/ipythonrc.py: put () back in accepted
4950 4955 delimiters. While it prevents ().TAB from working, it allows
4951 4956 completions in open (... expressions. This is by far a more common
4952 4957 case.
4953 4958
4954 4959 2002-04-23 Fernando Perez <fperez@colorado.edu>
4955 4960
4956 4961 * IPython/Extensions/InterpreterPasteInput.py: new
4957 4962 syntax-processing module for pasting lines with >>> or ... at the
4958 4963 start.
4959 4964
4960 4965 * IPython/Extensions/PhysicalQ_Interactive.py
4961 4966 (PhysicalQuantityInteractive.__int__): fixed to work with either
4962 4967 Numeric or math.
4963 4968
4964 4969 * IPython/UserConfig/ipythonrc-numeric.py: reorganized the
4965 4970 provided profiles. Now we have:
4966 4971 -math -> math module as * and cmath with its own namespace.
4967 4972 -numeric -> Numeric as *, plus gnuplot & grace
4968 4973 -physics -> same as before
4969 4974
4970 4975 * IPython/Magic.py (Magic.magic_magic): Fixed bug where
4971 4976 user-defined magics wouldn't be found by @magic if they were
4972 4977 defined as class methods. Also cleaned up the namespace search
4973 4978 logic and the string building (to use %s instead of many repeated
4974 4979 string adds).
4975 4980
4976 4981 * IPython/UserConfig/example-magic.py (magic_foo): updated example
4977 4982 of user-defined magics to operate with class methods (cleaner, in
4978 4983 line with the gnuplot code).
4979 4984
4980 4985 2002-04-22 Fernando Perez <fperez@colorado.edu>
4981 4986
4982 4987 * setup.py: updated dependency list so that manual is updated when
4983 4988 all included files change.
4984 4989
4985 4990 * IPython/ipmaker.py (make_IPython): Fixed bug which was ignoring
4986 4991 the delimiter removal option (the fix is ugly right now).
4987 4992
4988 4993 * IPython/UserConfig/ipythonrc-physics.py: simplified not to load
4989 4994 all of the math profile (quicker loading, no conflict between
4990 4995 g-9.8 and g-gnuplot).
4991 4996
4992 4997 * IPython/CrashHandler.py (CrashHandler.__call__): changed default
4993 4998 name of post-mortem files to IPython_crash_report.txt.
4994 4999
4995 5000 * Cleanup/update of the docs. Added all the new readline info and
4996 5001 formatted all lists as 'real lists'.
4997 5002
4998 5003 * IPython/ipmaker.py (make_IPython): removed now-obsolete
4999 5004 tab-completion options, since the full readline parse_and_bind is
5000 5005 now accessible.
5001 5006
5002 5007 * IPython/iplib.py (InteractiveShell.init_readline): Changed
5003 5008 handling of readline options. Now users can specify any string to
5004 5009 be passed to parse_and_bind(), as well as the delimiters to be
5005 5010 removed.
5006 5011 (InteractiveShell.__init__): Added __name__ to the global
5007 5012 namespace so that things like Itpl which rely on its existence
5008 5013 don't crash.
5009 5014 (InteractiveShell._prefilter): Defined the default with a _ so
5010 5015 that prefilter() is easier to override, while the default one
5011 5016 remains available.
5012 5017
5013 5018 2002-04-18 Fernando Perez <fperez@colorado.edu>
5014 5019
5015 5020 * Added information about pdb in the docs.
5016 5021
5017 5022 2002-04-17 Fernando Perez <fperez@colorado.edu>
5018 5023
5019 5024 * IPython/ipmaker.py (make_IPython): added rc_override option to
5020 5025 allow passing config options at creation time which may override
5021 5026 anything set in the config files or command line. This is
5022 5027 particularly useful for configuring embedded instances.
5023 5028
5024 5029 2002-04-15 Fernando Perez <fperez@colorado.edu>
5025 5030
5026 5031 * IPython/Logger.py (Logger.log): Fixed a nasty bug which could
5027 5032 crash embedded instances because of the input cache falling out of
5028 5033 sync with the output counter.
5029 5034
5030 5035 * IPython/Shell.py (IPythonShellEmbed.__init__): added a debug
5031 5036 mode which calls pdb after an uncaught exception in IPython itself.
5032 5037
5033 5038 2002-04-14 Fernando Perez <fperez@colorado.edu>
5034 5039
5035 5040 * IPython/iplib.py (InteractiveShell.showtraceback): pdb mucks up
5036 5041 readline, fix it back after each call.
5037 5042
5038 5043 * IPython/ultraTB.py (AutoFormattedTB.__text): made text a private
5039 5044 method to force all access via __call__(), which guarantees that
5040 5045 traceback references are properly deleted.
5041 5046
5042 5047 * IPython/Prompts.py (CachedOutput._display): minor fixes to
5043 5048 improve printing when pprint is in use.
5044 5049
5045 5050 2002-04-13 Fernando Perez <fperez@colorado.edu>
5046 5051
5047 5052 * IPython/Shell.py (IPythonShellEmbed.__call__): SystemExit
5048 5053 exceptions aren't caught anymore. If the user triggers one, he
5049 5054 should know why he's doing it and it should go all the way up,
5050 5055 just like any other exception. So now @abort will fully kill the
5051 5056 embedded interpreter and the embedding code (unless that happens
5052 5057 to catch SystemExit).
5053 5058
5054 5059 * IPython/ultraTB.py (VerboseTB.__init__): added a call_pdb flag
5055 5060 and a debugger() method to invoke the interactive pdb debugger
5056 5061 after printing exception information. Also added the corresponding
5057 5062 -pdb option and @pdb magic to control this feature, and updated
5058 5063 the docs. After a suggestion from Christopher Hart
5059 5064 (hart-AT-caltech.edu).
5060 5065
5061 5066 2002-04-12 Fernando Perez <fperez@colorado.edu>
5062 5067
5063 5068 * IPython/Shell.py (IPythonShellEmbed.__init__): modified to use
5064 5069 the exception handlers defined by the user (not the CrashHandler)
5065 5070 so that user exceptions don't trigger an ipython bug report.
5066 5071
5067 5072 * IPython/ultraTB.py (ColorTB.__init__): made the color scheme
5068 5073 configurable (it should have always been so).
5069 5074
5070 5075 2002-03-26 Fernando Perez <fperez@colorado.edu>
5071 5076
5072 5077 * IPython/Shell.py (IPythonShellEmbed.__call__): many changes here
5073 5078 and there to fix embedding namespace issues. This should all be
5074 5079 done in a more elegant way.
5075 5080
5076 5081 2002-03-25 Fernando Perez <fperez@colorado.edu>
5077 5082
5078 5083 * IPython/genutils.py (get_home_dir): Try to make it work under
5079 5084 win9x also.
5080 5085
5081 5086 2002-03-20 Fernando Perez <fperez@colorado.edu>
5082 5087
5083 5088 * IPython/Shell.py (IPythonShellEmbed.__init__): leave
5084 5089 sys.displayhook untouched upon __init__.
5085 5090
5086 5091 2002-03-19 Fernando Perez <fperez@colorado.edu>
5087 5092
5088 5093 * Released 0.2.9 (for embedding bug, basically).
5089 5094
5090 5095 * IPython/Shell.py (IPythonShellEmbed.__call__): Trap SystemExit
5091 5096 exceptions so that enclosing shell's state can be restored.
5092 5097
5093 5098 * Changed magic_gnuplot.py to magic-gnuplot.py to standardize
5094 5099 naming conventions in the .ipython/ dir.
5095 5100
5096 5101 * IPython/iplib.py (InteractiveShell.init_readline): removed '-'
5097 5102 from delimiters list so filenames with - in them get expanded.
5098 5103
5099 5104 * IPython/Shell.py (IPythonShellEmbed.__call__): fixed bug with
5100 5105 sys.displayhook not being properly restored after an embedded call.
5101 5106
5102 5107 2002-03-18 Fernando Perez <fperez@colorado.edu>
5103 5108
5104 5109 * Released 0.2.8
5105 5110
5106 5111 * IPython/iplib.py (InteractiveShell.user_setup): fixed bug where
5107 5112 some files weren't being included in a -upgrade.
5108 5113 (InteractiveShell.init_readline): Added 'set show-all-if-ambiguous
5109 5114 on' so that the first tab completes.
5110 5115 (InteractiveShell.handle_magic): fixed bug with spaces around
5111 5116 quotes breaking many magic commands.
5112 5117
5113 5118 * setup.py: added note about ignoring the syntax error messages at
5114 5119 installation.
5115 5120
5116 5121 * IPython/UserConfig/magic_gnuplot.py (magic_gp): finished
5117 5122 streamlining the gnuplot interface, now there's only one magic @gp.
5118 5123
5119 5124 2002-03-17 Fernando Perez <fperez@colorado.edu>
5120 5125
5121 5126 * IPython/UserConfig/magic_gnuplot.py: new name for the
5122 5127 example-magic_pm.py file. Much enhanced system, now with a shell
5123 5128 for communicating directly with gnuplot, one command at a time.
5124 5129
5125 5130 * IPython/Magic.py (Magic.magic_run): added option -n to prevent
5126 5131 setting __name__=='__main__'.
5127 5132
5128 5133 * IPython/UserConfig/example-magic_pm.py (magic_pm): Added
5129 5134 mini-shell for accessing gnuplot from inside ipython. Should
5130 5135 extend it later for grace access too. Inspired by Arnd's
5131 5136 suggestion.
5132 5137
5133 5138 * IPython/iplib.py (InteractiveShell.handle_magic): fixed bug when
5134 5139 calling magic functions with () in their arguments. Thanks to Arnd
5135 5140 Baecker for pointing this to me.
5136 5141
5137 5142 * IPython/numutils.py (sum_flat): fixed bug. Would recurse
5138 5143 infinitely for integer or complex arrays (only worked with floats).
5139 5144
5140 5145 2002-03-16 Fernando Perez <fperez@colorado.edu>
5141 5146
5142 5147 * setup.py: Merged setup and setup_windows into a single script
5143 5148 which properly handles things for windows users.
5144 5149
5145 5150 2002-03-15 Fernando Perez <fperez@colorado.edu>
5146 5151
5147 5152 * Big change to the manual: now the magics are all automatically
5148 5153 documented. This information is generated from their docstrings
5149 5154 and put in a latex file included by the manual lyx file. This way
5150 5155 we get always up to date information for the magics. The manual
5151 5156 now also has proper version information, also auto-synced.
5152 5157
5153 5158 For this to work, an undocumented --magic_docstrings option was added.
5154 5159
5155 5160 2002-03-13 Fernando Perez <fperez@colorado.edu>
5156 5161
5157 5162 * IPython/ultraTB.py (TermColors): fixed problem with dark colors
5158 5163 under CDE terminals. An explicit ;2 color reset is needed in the escapes.
5159 5164
5160 5165 2002-03-12 Fernando Perez <fperez@colorado.edu>
5161 5166
5162 5167 * IPython/ultraTB.py (TermColors): changed color escapes again to
5163 5168 fix the (old, reintroduced) line-wrapping bug. Basically, if
5164 5169 \001..\002 aren't given in the color escapes, lines get wrapped
5165 5170 weirdly. But giving those screws up old xterms and emacs terms. So
5166 5171 I added some logic for emacs terms to be ok, but I can't identify old
5167 5172 xterms separately ($TERM=='xterm' for many terminals, like konsole).
5168 5173
5169 5174 2002-03-10 Fernando Perez <fperez@colorado.edu>
5170 5175
5171 5176 * IPython/usage.py (__doc__): Various documentation cleanups and
5172 5177 updates, both in usage docstrings and in the manual.
5173 5178
5174 5179 * IPython/Prompts.py (CachedOutput.set_colors): cleanups for
5175 5180 handling of caching. Set minimum acceptabe value for having a
5176 5181 cache at 20 values.
5177 5182
5178 5183 * IPython/iplib.py (InteractiveShell.user_setup): moved the
5179 5184 install_first_time function to a method, renamed it and added an
5180 5185 'upgrade' mode. Now people can update their config directory with
5181 5186 a simple command line switch (-upgrade, also new).
5182 5187
5183 5188 * IPython/Magic.py (Magic.magic_pfile): Made @pfile an alias to
5184 5189 @file (convenient for automagic users under Python >= 2.2).
5185 5190 Removed @files (it seemed more like a plural than an abbrev. of
5186 5191 'file show').
5187 5192
5188 5193 * IPython/iplib.py (install_first_time): Fixed crash if there were
5189 5194 backup files ('~') in .ipython/ install directory.
5190 5195
5191 5196 * IPython/ipmaker.py (make_IPython): fixes for new prompt
5192 5197 system. Things look fine, but these changes are fairly
5193 5198 intrusive. Test them for a few days.
5194 5199
5195 5200 * IPython/Prompts.py (CachedOutput.__init__): Massive rewrite of
5196 5201 the prompts system. Now all in/out prompt strings are user
5197 5202 controllable. This is particularly useful for embedding, as one
5198 5203 can tag embedded instances with particular prompts.
5199 5204
5200 5205 Also removed global use of sys.ps1/2, which now allows nested
5201 5206 embeddings without any problems. Added command-line options for
5202 5207 the prompt strings.
5203 5208
5204 5209 2002-03-08 Fernando Perez <fperez@colorado.edu>
5205 5210
5206 5211 * IPython/UserConfig/example-embed-short.py (ipshell): added
5207 5212 example file with the bare minimum code for embedding.
5208 5213
5209 5214 * IPython/Shell.py (IPythonShellEmbed.set_dummy_mode): added
5210 5215 functionality for the embeddable shell to be activated/deactivated
5211 5216 either globally or at each call.
5212 5217
5213 5218 * IPython/Prompts.py (Prompt1.auto_rewrite): Fixes the problem of
5214 5219 rewriting the prompt with '--->' for auto-inputs with proper
5215 5220 coloring. Now the previous UGLY hack in handle_auto() is gone, and
5216 5221 this is handled by the prompts class itself, as it should.
5217 5222
5218 5223 2002-03-05 Fernando Perez <fperez@colorado.edu>
5219 5224
5220 5225 * IPython/Magic.py (Magic.magic_logstart): Changed @log to
5221 5226 @logstart to avoid name clashes with the math log function.
5222 5227
5223 5228 * Big updates to X/Emacs section of the manual.
5224 5229
5225 5230 * Removed ipython_emacs. Milan explained to me how to pass
5226 5231 arguments to ipython through Emacs. Some day I'm going to end up
5227 5232 learning some lisp...
5228 5233
5229 5234 2002-03-04 Fernando Perez <fperez@colorado.edu>
5230 5235
5231 5236 * IPython/ipython_emacs: Created script to be used as the
5232 5237 py-python-command Emacs variable so we can pass IPython
5233 5238 parameters. I can't figure out how to tell Emacs directly to pass
5234 5239 parameters to IPython, so a dummy shell script will do it.
5235 5240
5236 5241 Other enhancements made for things to work better under Emacs'
5237 5242 various types of terminals. Many thanks to Milan Zamazal
5238 5243 <pdm-AT-zamazal.org> for all the suggestions and pointers.
5239 5244
5240 5245 2002-03-01 Fernando Perez <fperez@colorado.edu>
5241 5246
5242 5247 * IPython/ipmaker.py (make_IPython): added a --readline! option so
5243 5248 that loading of readline is now optional. This gives better
5244 5249 control to emacs users.
5245 5250
5246 5251 * IPython/ultraTB.py (__date__): Modified color escape sequences
5247 5252 and now things work fine under xterm and in Emacs' term buffers
5248 5253 (though not shell ones). Well, in emacs you get colors, but all
5249 5254 seem to be 'light' colors (no difference between dark and light
5250 5255 ones). But the garbage chars are gone, and also in xterms. It
5251 5256 seems that now I'm using 'cleaner' ansi sequences.
5252 5257
5253 5258 2002-02-21 Fernando Perez <fperez@colorado.edu>
5254 5259
5255 5260 * Released 0.2.7 (mainly to publish the scoping fix).
5256 5261
5257 5262 * IPython/Logger.py (Logger.logstate): added. A corresponding
5258 5263 @logstate magic was created.
5259 5264
5260 5265 * IPython/Magic.py: fixed nested scoping problem under Python
5261 5266 2.1.x (automagic wasn't working).
5262 5267
5263 5268 2002-02-20 Fernando Perez <fperez@colorado.edu>
5264 5269
5265 5270 * Released 0.2.6.
5266 5271
5267 5272 * IPython/OutputTrap.py (OutputTrap.__init__): added a 'quiet'
5268 5273 option so that logs can come out without any headers at all.
5269 5274
5270 5275 * IPython/UserConfig/ipythonrc-scipy.py: created a profile for
5271 5276 SciPy.
5272 5277
5273 5278 * IPython/iplib.py (InteractiveShell.embed_mainloop): Changed so
5274 5279 that embedded IPython calls don't require vars() to be explicitly
5275 5280 passed. Now they are extracted from the caller's frame (code
5276 5281 snatched from Eric Jones' weave). Added better documentation to
5277 5282 the section on embedding and the example file.
5278 5283
5279 5284 * IPython/genutils.py (page): Changed so that under emacs, it just
5280 5285 prints the string. You can then page up and down in the emacs
5281 5286 buffer itself. This is how the builtin help() works.
5282 5287
5283 5288 * IPython/Prompts.py (CachedOutput.__call__): Fixed issue with
5284 5289 macro scoping: macros need to be executed in the user's namespace
5285 5290 to work as if they had been typed by the user.
5286 5291
5287 5292 * IPython/Magic.py (Magic.magic_macro): Changed macros so they
5288 5293 execute automatically (no need to type 'exec...'). They then
5289 5294 behave like 'true macros'. The printing system was also modified
5290 5295 for this to work.
5291 5296
5292 5297 2002-02-19 Fernando Perez <fperez@colorado.edu>
5293 5298
5294 5299 * IPython/genutils.py (page_file): new function for paging files
5295 5300 in an OS-independent way. Also necessary for file viewing to work
5296 5301 well inside Emacs buffers.
5297 5302 (page): Added checks for being in an emacs buffer.
5298 5303 (page): fixed bug for Windows ($TERM isn't set in Windows). Fixed
5299 5304 same bug in iplib.
5300 5305
5301 5306 2002-02-18 Fernando Perez <fperez@colorado.edu>
5302 5307
5303 5308 * IPython/iplib.py (InteractiveShell.init_readline): modified use
5304 5309 of readline so that IPython can work inside an Emacs buffer.
5305 5310
5306 5311 * IPython/ultraTB.py (AutoFormattedTB.__call__): some fixes to
5307 5312 method signatures (they weren't really bugs, but it looks cleaner
5308 5313 and keeps PyChecker happy).
5309 5314
5310 5315 * IPython/ipmaker.py (make_IPython): added hooks Struct to __IP
5311 5316 for implementing various user-defined hooks. Currently only
5312 5317 display is done.
5313 5318
5314 5319 * IPython/Prompts.py (CachedOutput._display): changed display
5315 5320 functions so that they can be dynamically changed by users easily.
5316 5321
5317 5322 * IPython/Extensions/numeric_formats.py (num_display): added an
5318 5323 extension for printing NumPy arrays in flexible manners. It
5319 5324 doesn't do anything yet, but all the structure is in
5320 5325 place. Ultimately the plan is to implement output format control
5321 5326 like in Octave.
5322 5327
5323 5328 * IPython/Magic.py (Magic.lsmagic): changed so that bound magic
5324 5329 methods are found at run-time by all the automatic machinery.
5325 5330
5326 5331 2002-02-17 Fernando Perez <fperez@colorado.edu>
5327 5332
5328 5333 * setup_Windows.py (make_shortcut): documented. Cleaned up the
5329 5334 whole file a little.
5330 5335
5331 5336 * ToDo: closed this document. Now there's a new_design.lyx
5332 5337 document for all new ideas. Added making a pdf of it for the
5333 5338 end-user distro.
5334 5339
5335 5340 * IPython/Logger.py (Logger.switch_log): Created this to replace
5336 5341 logon() and logoff(). It also fixes a nasty crash reported by
5337 5342 Philip Hisley <compsys-AT-starpower.net>. Many thanks to him.
5338 5343
5339 5344 * IPython/iplib.py (complete): got auto-completion to work with
5340 5345 automagic (I had wanted this for a long time).
5341 5346
5342 5347 * IPython/Magic.py (Magic.magic_files): Added @files as an alias
5343 5348 to @file, since file() is now a builtin and clashes with automagic
5344 5349 for @file.
5345 5350
5346 5351 * Made some new files: Prompts, CrashHandler, Magic, Logger. All
5347 5352 of this was previously in iplib, which had grown to more than 2000
5348 5353 lines, way too long. No new functionality, but it makes managing
5349 5354 the code a bit easier.
5350 5355
5351 5356 * IPython/iplib.py (IPythonCrashHandler.__call__): Added version
5352 5357 information to crash reports.
5353 5358
5354 5359 2002-02-12 Fernando Perez <fperez@colorado.edu>
5355 5360
5356 5361 * Released 0.2.5.
5357 5362
5358 5363 2002-02-11 Fernando Perez <fperez@colorado.edu>
5359 5364
5360 5365 * Wrote a relatively complete Windows installer. It puts
5361 5366 everything in place, creates Start Menu entries and fixes the
5362 5367 color issues. Nothing fancy, but it works.
5363 5368
5364 5369 2002-02-10 Fernando Perez <fperez@colorado.edu>
5365 5370
5366 5371 * IPython/iplib.py (InteractiveShell.safe_execfile): added an
5367 5372 os.path.expanduser() call so that we can type @run ~/myfile.py and
5368 5373 have thigs work as expected.
5369 5374
5370 5375 * IPython/genutils.py (page): fixed exception handling so things
5371 5376 work both in Unix and Windows correctly. Quitting a pager triggers
5372 5377 an IOError/broken pipe in Unix, and in windows not finding a pager
5373 5378 is also an IOError, so I had to actually look at the return value
5374 5379 of the exception, not just the exception itself. Should be ok now.
5375 5380
5376 5381 * IPython/ultraTB.py (ColorSchemeTable.set_active_scheme):
5377 5382 modified to allow case-insensitive color scheme changes.
5378 5383
5379 5384 2002-02-09 Fernando Perez <fperez@colorado.edu>
5380 5385
5381 5386 * IPython/genutils.py (native_line_ends): new function to leave
5382 5387 user config files with os-native line-endings.
5383 5388
5384 5389 * README and manual updates.
5385 5390
5386 5391 * IPython/genutils.py: fixed unicode bug: use types.StringTypes
5387 5392 instead of StringType to catch Unicode strings.
5388 5393
5389 5394 * IPython/genutils.py (filefind): fixed bug for paths with
5390 5395 embedded spaces (very common in Windows).
5391 5396
5392 5397 * IPython/ipmaker.py (make_IPython): added a '.ini' to the rc
5393 5398 files under Windows, so that they get automatically associated
5394 5399 with a text editor. Windows makes it a pain to handle
5395 5400 extension-less files.
5396 5401
5397 5402 * IPython/iplib.py (InteractiveShell.init_readline): Made the
5398 5403 warning about readline only occur for Posix. In Windows there's no
5399 5404 way to get readline, so why bother with the warning.
5400 5405
5401 5406 * IPython/Struct.py (Struct.__str__): fixed to use self.__dict__
5402 5407 for __str__ instead of dir(self), since dir() changed in 2.2.
5403 5408
5404 5409 * Ported to Windows! Tested on XP, I suspect it should work fine
5405 5410 on NT/2000, but I don't think it will work on 98 et al. That
5406 5411 series of Windows is such a piece of junk anyway that I won't try
5407 5412 porting it there. The XP port was straightforward, showed a few
5408 5413 bugs here and there (fixed all), in particular some string
5409 5414 handling stuff which required considering Unicode strings (which
5410 5415 Windows uses). This is good, but hasn't been too tested :) No
5411 5416 fancy installer yet, I'll put a note in the manual so people at
5412 5417 least make manually a shortcut.
5413 5418
5414 5419 * IPython/iplib.py (Magic.magic_colors): Unified the color options
5415 5420 into a single one, "colors". This now controls both prompt and
5416 5421 exception color schemes, and can be changed both at startup
5417 5422 (either via command-line switches or via ipythonrc files) and at
5418 5423 runtime, with @colors.
5419 5424 (Magic.magic_run): renamed @prun to @run and removed the old
5420 5425 @run. The two were too similar to warrant keeping both.
5421 5426
5422 5427 2002-02-03 Fernando Perez <fperez@colorado.edu>
5423 5428
5424 5429 * IPython/iplib.py (install_first_time): Added comment on how to
5425 5430 configure the color options for first-time users. Put a <return>
5426 5431 request at the end so that small-terminal users get a chance to
5427 5432 read the startup info.
5428 5433
5429 5434 2002-01-23 Fernando Perez <fperez@colorado.edu>
5430 5435
5431 5436 * IPython/iplib.py (CachedOutput.update): Changed output memory
5432 5437 variable names from _o,_oo,_ooo,_o<n> to simply _,__,___,_<n>. For
5433 5438 input history we still use _i. Did this b/c these variable are
5434 5439 very commonly used in interactive work, so the less we need to
5435 5440 type the better off we are.
5436 5441 (Magic.magic_prun): updated @prun to better handle the namespaces
5437 5442 the file will run in, including a fix for __name__ not being set
5438 5443 before.
5439 5444
5440 5445 2002-01-20 Fernando Perez <fperez@colorado.edu>
5441 5446
5442 5447 * IPython/ultraTB.py (VerboseTB.linereader): Fixed printing of
5443 5448 extra garbage for Python 2.2. Need to look more carefully into
5444 5449 this later.
5445 5450
5446 5451 2002-01-19 Fernando Perez <fperez@colorado.edu>
5447 5452
5448 5453 * IPython/iplib.py (InteractiveShell.showtraceback): fixed to
5449 5454 display SyntaxError exceptions properly formatted when they occur
5450 5455 (they can be triggered by imported code).
5451 5456
5452 5457 2002-01-18 Fernando Perez <fperez@colorado.edu>
5453 5458
5454 5459 * IPython/iplib.py (InteractiveShell.safe_execfile): now
5455 5460 SyntaxError exceptions are reported nicely formatted, instead of
5456 5461 spitting out only offset information as before.
5457 5462 (Magic.magic_prun): Added the @prun function for executing
5458 5463 programs with command line args inside IPython.
5459 5464
5460 5465 2002-01-16 Fernando Perez <fperez@colorado.edu>
5461 5466
5462 5467 * IPython/iplib.py (Magic.magic_hist): Changed @hist and @dhist
5463 5468 to *not* include the last item given in a range. This brings their
5464 5469 behavior in line with Python's slicing:
5465 5470 a[n1:n2] -> a[n1]...a[n2-1]
5466 5471 It may be a bit less convenient, but I prefer to stick to Python's
5467 5472 conventions *everywhere*, so users never have to wonder.
5468 5473 (Magic.magic_macro): Added @macro function to ease the creation of
5469 5474 macros.
5470 5475
5471 5476 2002-01-05 Fernando Perez <fperez@colorado.edu>
5472 5477
5473 5478 * Released 0.2.4.
5474 5479
5475 5480 * IPython/iplib.py (Magic.magic_pdef):
5476 5481 (InteractiveShell.safe_execfile): report magic lines and error
5477 5482 lines without line numbers so one can easily copy/paste them for
5478 5483 re-execution.
5479 5484
5480 5485 * Updated manual with recent changes.
5481 5486
5482 5487 * IPython/iplib.py (Magic.magic_oinfo): added constructor
5483 5488 docstring printing when class? is called. Very handy for knowing
5484 5489 how to create class instances (as long as __init__ is well
5485 5490 documented, of course :)
5486 5491 (Magic.magic_doc): print both class and constructor docstrings.
5487 5492 (Magic.magic_pdef): give constructor info if passed a class and
5488 5493 __call__ info for callable object instances.
5489 5494
5490 5495 2002-01-04 Fernando Perez <fperez@colorado.edu>
5491 5496
5492 5497 * Made deep_reload() off by default. It doesn't always work
5493 5498 exactly as intended, so it's probably safer to have it off. It's
5494 5499 still available as dreload() anyway, so nothing is lost.
5495 5500
5496 5501 2002-01-02 Fernando Perez <fperez@colorado.edu>
5497 5502
5498 5503 * Released 0.2.3 (contacted R.Singh at CU about biopython course,
5499 5504 so I wanted an updated release).
5500 5505
5501 5506 2001-12-27 Fernando Perez <fperez@colorado.edu>
5502 5507
5503 5508 * IPython/iplib.py (InteractiveShell.interact): Added the original
5504 5509 code from 'code.py' for this module in order to change the
5505 5510 handling of a KeyboardInterrupt. This was necessary b/c otherwise
5506 5511 the history cache would break when the user hit Ctrl-C, and
5507 5512 interact() offers no way to add any hooks to it.
5508 5513
5509 5514 2001-12-23 Fernando Perez <fperez@colorado.edu>
5510 5515
5511 5516 * setup.py: added check for 'MANIFEST' before trying to remove
5512 5517 it. Thanks to Sean Reifschneider.
5513 5518
5514 5519 2001-12-22 Fernando Perez <fperez@colorado.edu>
5515 5520
5516 5521 * Released 0.2.2.
5517 5522
5518 5523 * Finished (reasonably) writing the manual. Later will add the
5519 5524 python-standard navigation stylesheets, but for the time being
5520 5525 it's fairly complete. Distribution will include html and pdf
5521 5526 versions.
5522 5527
5523 5528 * Bugfix: '.' wasn't being added to sys.path. Thanks to Prabhu
5524 5529 (MayaVi author).
5525 5530
5526 5531 2001-12-21 Fernando Perez <fperez@colorado.edu>
5527 5532
5528 5533 * Released 0.2.1. Barring any nasty bugs, this is it as far as a
5529 5534 good public release, I think (with the manual and the distutils
5530 5535 installer). The manual can use some work, but that can go
5531 5536 slowly. Otherwise I think it's quite nice for end users. Next
5532 5537 summer, rewrite the guts of it...
5533 5538
5534 5539 * Changed format of ipythonrc files to use whitespace as the
5535 5540 separator instead of an explicit '='. Cleaner.
5536 5541
5537 5542 2001-12-20 Fernando Perez <fperez@colorado.edu>
5538 5543
5539 5544 * Started a manual in LyX. For now it's just a quick merge of the
5540 5545 various internal docstrings and READMEs. Later it may grow into a
5541 5546 nice, full-blown manual.
5542 5547
5543 5548 * Set up a distutils based installer. Installation should now be
5544 5549 trivially simple for end-users.
5545 5550
5546 5551 2001-12-11 Fernando Perez <fperez@colorado.edu>
5547 5552
5548 5553 * Released 0.2.0. First public release, announced it at
5549 5554 comp.lang.python. From now on, just bugfixes...
5550 5555
5551 5556 * Went through all the files, set copyright/license notices and
5552 5557 cleaned up things. Ready for release.
5553 5558
5554 5559 2001-12-10 Fernando Perez <fperez@colorado.edu>
5555 5560
5556 5561 * Changed the first-time installer not to use tarfiles. It's more
5557 5562 robust now and less unix-dependent. Also makes it easier for
5558 5563 people to later upgrade versions.
5559 5564
5560 5565 * Changed @exit to @abort to reflect the fact that it's pretty
5561 5566 brutal (a sys.exit()). The difference between @abort and Ctrl-D
5562 5567 becomes significant only when IPyhton is embedded: in that case,
5563 5568 C-D closes IPython only, but @abort kills the enclosing program
5564 5569 too (unless it had called IPython inside a try catching
5565 5570 SystemExit).
5566 5571
5567 5572 * Created Shell module which exposes the actuall IPython Shell
5568 5573 classes, currently the normal and the embeddable one. This at
5569 5574 least offers a stable interface we won't need to change when
5570 5575 (later) the internals are rewritten. That rewrite will be confined
5571 5576 to iplib and ipmaker, but the Shell interface should remain as is.
5572 5577
5573 5578 * Added embed module which offers an embeddable IPShell object,
5574 5579 useful to fire up IPython *inside* a running program. Great for
5575 5580 debugging or dynamical data analysis.
5576 5581
5577 5582 2001-12-08 Fernando Perez <fperez@colorado.edu>
5578 5583
5579 5584 * Fixed small bug preventing seeing info from methods of defined
5580 5585 objects (incorrect namespace in _ofind()).
5581 5586
5582 5587 * Documentation cleanup. Moved the main usage docstrings to a
5583 5588 separate file, usage.py (cleaner to maintain, and hopefully in the
5584 5589 future some perlpod-like way of producing interactive, man and
5585 5590 html docs out of it will be found).
5586 5591
5587 5592 * Added @profile to see your profile at any time.
5588 5593
5589 5594 * Added @p as an alias for 'print'. It's especially convenient if
5590 5595 using automagic ('p x' prints x).
5591 5596
5592 5597 * Small cleanups and fixes after a pychecker run.
5593 5598
5594 5599 * Changed the @cd command to handle @cd - and @cd -<n> for
5595 5600 visiting any directory in _dh.
5596 5601
5597 5602 * Introduced _dh, a history of visited directories. @dhist prints
5598 5603 it out with numbers.
5599 5604
5600 5605 2001-12-07 Fernando Perez <fperez@colorado.edu>
5601 5606
5602 5607 * Released 0.1.22
5603 5608
5604 5609 * Made initialization a bit more robust against invalid color
5605 5610 options in user input (exit, not traceback-crash).
5606 5611
5607 5612 * Changed the bug crash reporter to write the report only in the
5608 5613 user's .ipython directory. That way IPython won't litter people's
5609 5614 hard disks with crash files all over the place. Also print on
5610 5615 screen the necessary mail command.
5611 5616
5612 5617 * With the new ultraTB, implemented LightBG color scheme for light
5613 5618 background terminals. A lot of people like white backgrounds, so I
5614 5619 guess we should at least give them something readable.
5615 5620
5616 5621 2001-12-06 Fernando Perez <fperez@colorado.edu>
5617 5622
5618 5623 * Modified the structure of ultraTB. Now there's a proper class
5619 5624 for tables of color schemes which allow adding schemes easily and
5620 5625 switching the active scheme without creating a new instance every
5621 5626 time (which was ridiculous). The syntax for creating new schemes
5622 5627 is also cleaner. I think ultraTB is finally done, with a clean
5623 5628 class structure. Names are also much cleaner (now there's proper
5624 5629 color tables, no need for every variable to also have 'color' in
5625 5630 its name).
5626 5631
5627 5632 * Broke down genutils into separate files. Now genutils only
5628 5633 contains utility functions, and classes have been moved to their
5629 5634 own files (they had enough independent functionality to warrant
5630 5635 it): ConfigLoader, OutputTrap, Struct.
5631 5636
5632 5637 2001-12-05 Fernando Perez <fperez@colorado.edu>
5633 5638
5634 5639 * IPython turns 21! Released version 0.1.21, as a candidate for
5635 5640 public consumption. If all goes well, release in a few days.
5636 5641
5637 5642 * Fixed path bug (files in Extensions/ directory wouldn't be found
5638 5643 unless IPython/ was explicitly in sys.path).
5639 5644
5640 5645 * Extended the FlexCompleter class as MagicCompleter to allow
5641 5646 completion of @-starting lines.
5642 5647
5643 5648 * Created __release__.py file as a central repository for release
5644 5649 info that other files can read from.
5645 5650
5646 5651 * Fixed small bug in logging: when logging was turned on in
5647 5652 mid-session, old lines with special meanings (!@?) were being
5648 5653 logged without the prepended comment, which is necessary since
5649 5654 they are not truly valid python syntax. This should make session
5650 5655 restores produce less errors.
5651 5656
5652 5657 * The namespace cleanup forced me to make a FlexCompleter class
5653 5658 which is nothing but a ripoff of rlcompleter, but with selectable
5654 5659 namespace (rlcompleter only works in __main__.__dict__). I'll try
5655 5660 to submit a note to the authors to see if this change can be
5656 5661 incorporated in future rlcompleter releases (Dec.6: done)
5657 5662
5658 5663 * More fixes to namespace handling. It was a mess! Now all
5659 5664 explicit references to __main__.__dict__ are gone (except when
5660 5665 really needed) and everything is handled through the namespace
5661 5666 dicts in the IPython instance. We seem to be getting somewhere
5662 5667 with this, finally...
5663 5668
5664 5669 * Small documentation updates.
5665 5670
5666 5671 * Created the Extensions directory under IPython (with an
5667 5672 __init__.py). Put the PhysicalQ stuff there. This directory should
5668 5673 be used for all special-purpose extensions.
5669 5674
5670 5675 * File renaming:
5671 5676 ipythonlib --> ipmaker
5672 5677 ipplib --> iplib
5673 5678 This makes a bit more sense in terms of what these files actually do.
5674 5679
5675 5680 * Moved all the classes and functions in ipythonlib to ipplib, so
5676 5681 now ipythonlib only has make_IPython(). This will ease up its
5677 5682 splitting in smaller functional chunks later.
5678 5683
5679 5684 * Cleaned up (done, I think) output of @whos. Better column
5680 5685 formatting, and now shows str(var) for as much as it can, which is
5681 5686 typically what one gets with a 'print var'.
5682 5687
5683 5688 2001-12-04 Fernando Perez <fperez@colorado.edu>
5684 5689
5685 5690 * Fixed namespace problems. Now builtin/IPyhton/user names get
5686 5691 properly reported in their namespace. Internal namespace handling
5687 5692 is finally getting decent (not perfect yet, but much better than
5688 5693 the ad-hoc mess we had).
5689 5694
5690 5695 * Removed -exit option. If people just want to run a python
5691 5696 script, that's what the normal interpreter is for. Less
5692 5697 unnecessary options, less chances for bugs.
5693 5698
5694 5699 * Added a crash handler which generates a complete post-mortem if
5695 5700 IPython crashes. This will help a lot in tracking bugs down the
5696 5701 road.
5697 5702
5698 5703 * Fixed nasty bug in auto-evaluation part of prefilter(). Names
5699 5704 which were boud to functions being reassigned would bypass the
5700 5705 logger, breaking the sync of _il with the prompt counter. This
5701 5706 would then crash IPython later when a new line was logged.
5702 5707
5703 5708 2001-12-02 Fernando Perez <fperez@colorado.edu>
5704 5709
5705 5710 * Made IPython a package. This means people don't have to clutter
5706 5711 their sys.path with yet another directory. Changed the INSTALL
5707 5712 file accordingly.
5708 5713
5709 5714 * Cleaned up the output of @who_ls, @who and @whos. @who_ls now
5710 5715 sorts its output (so @who shows it sorted) and @whos formats the
5711 5716 table according to the width of the first column. Nicer, easier to
5712 5717 read. Todo: write a generic table_format() which takes a list of
5713 5718 lists and prints it nicely formatted, with optional row/column
5714 5719 separators and proper padding and justification.
5715 5720
5716 5721 * Released 0.1.20
5717 5722
5718 5723 * Fixed bug in @log which would reverse the inputcache list (a
5719 5724 copy operation was missing).
5720 5725
5721 5726 * Code cleanup. @config was changed to use page(). Better, since
5722 5727 its output is always quite long.
5723 5728
5724 5729 * Itpl is back as a dependency. I was having too many problems
5725 5730 getting the parametric aliases to work reliably, and it's just
5726 5731 easier to code weird string operations with it than playing %()s
5727 5732 games. It's only ~6k, so I don't think it's too big a deal.
5728 5733
5729 5734 * Found (and fixed) a very nasty bug with history. !lines weren't
5730 5735 getting cached, and the out of sync caches would crash
5731 5736 IPython. Fixed it by reorganizing the prefilter/handlers/logger
5732 5737 division of labor a bit better. Bug fixed, cleaner structure.
5733 5738
5734 5739 2001-12-01 Fernando Perez <fperez@colorado.edu>
5735 5740
5736 5741 * Released 0.1.19
5737 5742
5738 5743 * Added option -n to @hist to prevent line number printing. Much
5739 5744 easier to copy/paste code this way.
5740 5745
5741 5746 * Created global _il to hold the input list. Allows easy
5742 5747 re-execution of blocks of code by slicing it (inspired by Janko's
5743 5748 comment on 'macros').
5744 5749
5745 5750 * Small fixes and doc updates.
5746 5751
5747 5752 * Rewrote @history function (was @h). Renamed it to @hist, @h is
5748 5753 much too fragile with automagic. Handles properly multi-line
5749 5754 statements and takes parameters.
5750 5755
5751 5756 2001-11-30 Fernando Perez <fperez@colorado.edu>
5752 5757
5753 5758 * Version 0.1.18 released.
5754 5759
5755 5760 * Fixed nasty namespace bug in initial module imports.
5756 5761
5757 5762 * Added copyright/license notes to all code files (except
5758 5763 DPyGetOpt). For the time being, LGPL. That could change.
5759 5764
5760 5765 * Rewrote a much nicer README, updated INSTALL, cleaned up
5761 5766 ipythonrc-* samples.
5762 5767
5763 5768 * Overall code/documentation cleanup. Basically ready for
5764 5769 release. Only remaining thing: licence decision (LGPL?).
5765 5770
5766 5771 * Converted load_config to a class, ConfigLoader. Now recursion
5767 5772 control is better organized. Doesn't include the same file twice.
5768 5773
5769 5774 2001-11-29 Fernando Perez <fperez@colorado.edu>
5770 5775
5771 5776 * Got input history working. Changed output history variables from
5772 5777 _p to _o so that _i is for input and _o for output. Just cleaner
5773 5778 convention.
5774 5779
5775 5780 * Implemented parametric aliases. This pretty much allows the
5776 5781 alias system to offer full-blown shell convenience, I think.
5777 5782
5778 5783 * Version 0.1.17 released, 0.1.18 opened.
5779 5784
5780 5785 * dot_ipython/ipythonrc (alias): added documentation.
5781 5786 (xcolor): Fixed small bug (xcolors -> xcolor)
5782 5787
5783 5788 * Changed the alias system. Now alias is a magic command to define
5784 5789 aliases just like the shell. Rationale: the builtin magics should
5785 5790 be there for things deeply connected to IPython's
5786 5791 architecture. And this is a much lighter system for what I think
5787 5792 is the really important feature: allowing users to define quickly
5788 5793 magics that will do shell things for them, so they can customize
5789 5794 IPython easily to match their work habits. If someone is really
5790 5795 desperate to have another name for a builtin alias, they can
5791 5796 always use __IP.magic_newname = __IP.magic_oldname. Hackish but
5792 5797 works.
5793 5798
5794 5799 2001-11-28 Fernando Perez <fperez@colorado.edu>
5795 5800
5796 5801 * Changed @file so that it opens the source file at the proper
5797 5802 line. Since it uses less, if your EDITOR environment is
5798 5803 configured, typing v will immediately open your editor of choice
5799 5804 right at the line where the object is defined. Not as quick as
5800 5805 having a direct @edit command, but for all intents and purposes it
5801 5806 works. And I don't have to worry about writing @edit to deal with
5802 5807 all the editors, less does that.
5803 5808
5804 5809 * Version 0.1.16 released, 0.1.17 opened.
5805 5810
5806 5811 * Fixed some nasty bugs in the page/page_dumb combo that could
5807 5812 crash IPython.
5808 5813
5809 5814 2001-11-27 Fernando Perez <fperez@colorado.edu>
5810 5815
5811 5816 * Version 0.1.15 released, 0.1.16 opened.
5812 5817
5813 5818 * Finally got ? and ?? to work for undefined things: now it's
5814 5819 possible to type {}.get? and get information about the get method
5815 5820 of dicts, or os.path? even if only os is defined (so technically
5816 5821 os.path isn't). Works at any level. For example, after import os,
5817 5822 os?, os.path?, os.path.abspath? all work. This is great, took some
5818 5823 work in _ofind.
5819 5824
5820 5825 * Fixed more bugs with logging. The sanest way to do it was to add
5821 5826 to @log a 'mode' parameter. Killed two in one shot (this mode
5822 5827 option was a request of Janko's). I think it's finally clean
5823 5828 (famous last words).
5824 5829
5825 5830 * Added a page_dumb() pager which does a decent job of paging on
5826 5831 screen, if better things (like less) aren't available. One less
5827 5832 unix dependency (someday maybe somebody will port this to
5828 5833 windows).
5829 5834
5830 5835 * Fixed problem in magic_log: would lock of logging out if log
5831 5836 creation failed (because it would still think it had succeeded).
5832 5837
5833 5838 * Improved the page() function using curses to auto-detect screen
5834 5839 size. Now it can make a much better decision on whether to print
5835 5840 or page a string. Option screen_length was modified: a value 0
5836 5841 means auto-detect, and that's the default now.
5837 5842
5838 5843 * Version 0.1.14 released, 0.1.15 opened. I think this is ready to
5839 5844 go out. I'll test it for a few days, then talk to Janko about
5840 5845 licences and announce it.
5841 5846
5842 5847 * Fixed the length of the auto-generated ---> prompt which appears
5843 5848 for auto-parens and auto-quotes. Getting this right isn't trivial,
5844 5849 with all the color escapes, different prompt types and optional
5845 5850 separators. But it seems to be working in all the combinations.
5846 5851
5847 5852 2001-11-26 Fernando Perez <fperez@colorado.edu>
5848 5853
5849 5854 * Wrote a regexp filter to get option types from the option names
5850 5855 string. This eliminates the need to manually keep two duplicate
5851 5856 lists.
5852 5857
5853 5858 * Removed the unneeded check_option_names. Now options are handled
5854 5859 in a much saner manner and it's easy to visually check that things
5855 5860 are ok.
5856 5861
5857 5862 * Updated version numbers on all files I modified to carry a
5858 5863 notice so Janko and Nathan have clear version markers.
5859 5864
5860 5865 * Updated docstring for ultraTB with my changes. I should send
5861 5866 this to Nathan.
5862 5867
5863 5868 * Lots of small fixes. Ran everything through pychecker again.
5864 5869
5865 5870 * Made loading of deep_reload an cmd line option. If it's not too
5866 5871 kosher, now people can just disable it. With -nodeep_reload it's
5867 5872 still available as dreload(), it just won't overwrite reload().
5868 5873
5869 5874 * Moved many options to the no| form (-opt and -noopt
5870 5875 accepted). Cleaner.
5871 5876
5872 5877 * Changed magic_log so that if called with no parameters, it uses
5873 5878 'rotate' mode. That way auto-generated logs aren't automatically
5874 5879 over-written. For normal logs, now a backup is made if it exists
5875 5880 (only 1 level of backups). A new 'backup' mode was added to the
5876 5881 Logger class to support this. This was a request by Janko.
5877 5882
5878 5883 * Added @logoff/@logon to stop/restart an active log.
5879 5884
5880 5885 * Fixed a lot of bugs in log saving/replay. It was pretty
5881 5886 broken. Now special lines (!@,/) appear properly in the command
5882 5887 history after a log replay.
5883 5888
5884 5889 * Tried and failed to implement full session saving via pickle. My
5885 5890 idea was to pickle __main__.__dict__, but modules can't be
5886 5891 pickled. This would be a better alternative to replaying logs, but
5887 5892 seems quite tricky to get to work. Changed -session to be called
5888 5893 -logplay, which more accurately reflects what it does. And if we
5889 5894 ever get real session saving working, -session is now available.
5890 5895
5891 5896 * Implemented color schemes for prompts also. As for tracebacks,
5892 5897 currently only NoColor and Linux are supported. But now the
5893 5898 infrastructure is in place, based on a generic ColorScheme
5894 5899 class. So writing and activating new schemes both for the prompts
5895 5900 and the tracebacks should be straightforward.
5896 5901
5897 5902 * Version 0.1.13 released, 0.1.14 opened.
5898 5903
5899 5904 * Changed handling of options for output cache. Now counter is
5900 5905 hardwired starting at 1 and one specifies the maximum number of
5901 5906 entries *in the outcache* (not the max prompt counter). This is
5902 5907 much better, since many statements won't increase the cache
5903 5908 count. It also eliminated some confusing options, now there's only
5904 5909 one: cache_size.
5905 5910
5906 5911 * Added 'alias' magic function and magic_alias option in the
5907 5912 ipythonrc file. Now the user can easily define whatever names he
5908 5913 wants for the magic functions without having to play weird
5909 5914 namespace games. This gives IPython a real shell-like feel.
5910 5915
5911 5916 * Fixed doc/?/?? for magics. Now all work, in all forms (explicit
5912 5917 @ or not).
5913 5918
5914 5919 This was one of the last remaining 'visible' bugs (that I know
5915 5920 of). I think if I can clean up the session loading so it works
5916 5921 100% I'll release a 0.2.0 version on c.p.l (talk to Janko first
5917 5922 about licensing).
5918 5923
5919 5924 2001-11-25 Fernando Perez <fperez@colorado.edu>
5920 5925
5921 5926 * Rewrote somewhat oinfo (?/??). Nicer, now uses page() and
5922 5927 there's a cleaner distinction between what ? and ?? show.
5923 5928
5924 5929 * Added screen_length option. Now the user can define his own
5925 5930 screen size for page() operations.
5926 5931
5927 5932 * Implemented magic shell-like functions with automatic code
5928 5933 generation. Now adding another function is just a matter of adding
5929 5934 an entry to a dict, and the function is dynamically generated at
5930 5935 run-time. Python has some really cool features!
5931 5936
5932 5937 * Renamed many options to cleanup conventions a little. Now all
5933 5938 are lowercase, and only underscores where needed. Also in the code
5934 5939 option name tables are clearer.
5935 5940
5936 5941 * Changed prompts a little. Now input is 'In [n]:' instead of
5937 5942 'In[n]:='. This allows it the numbers to be aligned with the
5938 5943 Out[n] numbers, and removes usage of ':=' which doesn't exist in
5939 5944 Python (it was a Mathematica thing). The '...' continuation prompt
5940 5945 was also changed a little to align better.
5941 5946
5942 5947 * Fixed bug when flushing output cache. Not all _p<n> variables
5943 5948 exist, so their deletion needs to be wrapped in a try:
5944 5949
5945 5950 * Figured out how to properly use inspect.formatargspec() (it
5946 5951 requires the args preceded by *). So I removed all the code from
5947 5952 _get_pdef in Magic, which was just replicating that.
5948 5953
5949 5954 * Added test to prefilter to allow redefining magic function names
5950 5955 as variables. This is ok, since the @ form is always available,
5951 5956 but whe should allow the user to define a variable called 'ls' if
5952 5957 he needs it.
5953 5958
5954 5959 * Moved the ToDo information from README into a separate ToDo.
5955 5960
5956 5961 * General code cleanup and small bugfixes. I think it's close to a
5957 5962 state where it can be released, obviously with a big 'beta'
5958 5963 warning on it.
5959 5964
5960 5965 * Got the magic function split to work. Now all magics are defined
5961 5966 in a separate class. It just organizes things a bit, and now
5962 5967 Xemacs behaves nicer (it was choking on InteractiveShell b/c it
5963 5968 was too long).
5964 5969
5965 5970 * Changed @clear to @reset to avoid potential confusions with
5966 5971 the shell command clear. Also renamed @cl to @clear, which does
5967 5972 exactly what people expect it to from their shell experience.
5968 5973
5969 5974 Added a check to the @reset command (since it's so
5970 5975 destructive, it's probably a good idea to ask for confirmation).
5971 5976 But now reset only works for full namespace resetting. Since the
5972 5977 del keyword is already there for deleting a few specific
5973 5978 variables, I don't see the point of having a redundant magic
5974 5979 function for the same task.
5975 5980
5976 5981 2001-11-24 Fernando Perez <fperez@colorado.edu>
5977 5982
5978 5983 * Updated the builtin docs (esp. the ? ones).
5979 5984
5980 5985 * Ran all the code through pychecker. Not terribly impressed with
5981 5986 it: lots of spurious warnings and didn't really find anything of
5982 5987 substance (just a few modules being imported and not used).
5983 5988
5984 5989 * Implemented the new ultraTB functionality into IPython. New
5985 5990 option: xcolors. This chooses color scheme. xmode now only selects
5986 5991 between Plain and Verbose. Better orthogonality.
5987 5992
5988 5993 * Large rewrite of ultraTB. Much cleaner now, with a separation of
5989 5994 mode and color scheme for the exception handlers. Now it's
5990 5995 possible to have the verbose traceback with no coloring.
5991 5996
5992 5997 2001-11-23 Fernando Perez <fperez@colorado.edu>
5993 5998
5994 5999 * Version 0.1.12 released, 0.1.13 opened.
5995 6000
5996 6001 * Removed option to set auto-quote and auto-paren escapes by
5997 6002 user. The chances of breaking valid syntax are just too high. If
5998 6003 someone *really* wants, they can always dig into the code.
5999 6004
6000 6005 * Made prompt separators configurable.
6001 6006
6002 6007 2001-11-22 Fernando Perez <fperez@colorado.edu>
6003 6008
6004 6009 * Small bugfixes in many places.
6005 6010
6006 6011 * Removed the MyCompleter class from ipplib. It seemed redundant
6007 6012 with the C-p,C-n history search functionality. Less code to
6008 6013 maintain.
6009 6014
6010 6015 * Moved all the original ipython.py code into ipythonlib.py. Right
6011 6016 now it's just one big dump into a function called make_IPython, so
6012 6017 no real modularity has been gained. But at least it makes the
6013 6018 wrapper script tiny, and since ipythonlib is a module, it gets
6014 6019 compiled and startup is much faster.
6015 6020
6016 6021 This is a reasobably 'deep' change, so we should test it for a
6017 6022 while without messing too much more with the code.
6018 6023
6019 6024 2001-11-21 Fernando Perez <fperez@colorado.edu>
6020 6025
6021 6026 * Version 0.1.11 released, 0.1.12 opened for further work.
6022 6027
6023 6028 * Removed dependency on Itpl. It was only needed in one place. It
6024 6029 would be nice if this became part of python, though. It makes life
6025 6030 *a lot* easier in some cases.
6026 6031
6027 6032 * Simplified the prefilter code a bit. Now all handlers are
6028 6033 expected to explicitly return a value (at least a blank string).
6029 6034
6030 6035 * Heavy edits in ipplib. Removed the help system altogether. Now
6031 6036 obj?/?? is used for inspecting objects, a magic @doc prints
6032 6037 docstrings, and full-blown Python help is accessed via the 'help'
6033 6038 keyword. This cleans up a lot of code (less to maintain) and does
6034 6039 the job. Since 'help' is now a standard Python component, might as
6035 6040 well use it and remove duplicate functionality.
6036 6041
6037 6042 Also removed the option to use ipplib as a standalone program. By
6038 6043 now it's too dependent on other parts of IPython to function alone.
6039 6044
6040 6045 * Fixed bug in genutils.pager. It would crash if the pager was
6041 6046 exited immediately after opening (broken pipe).
6042 6047
6043 6048 * Trimmed down the VerboseTB reporting a little. The header is
6044 6049 much shorter now and the repeated exception arguments at the end
6045 6050 have been removed. For interactive use the old header seemed a bit
6046 6051 excessive.
6047 6052
6048 6053 * Fixed small bug in output of @whos for variables with multi-word
6049 6054 types (only first word was displayed).
6050 6055
6051 6056 2001-11-17 Fernando Perez <fperez@colorado.edu>
6052 6057
6053 6058 * Version 0.1.10 released, 0.1.11 opened for further work.
6054 6059
6055 6060 * Modified dirs and friends. dirs now *returns* the stack (not
6056 6061 prints), so one can manipulate it as a variable. Convenient to
6057 6062 travel along many directories.
6058 6063
6059 6064 * Fixed bug in magic_pdef: would only work with functions with
6060 6065 arguments with default values.
6061 6066
6062 6067 2001-11-14 Fernando Perez <fperez@colorado.edu>
6063 6068
6064 6069 * Added the PhysicsInput stuff to dot_ipython so it ships as an
6065 6070 example with IPython. Various other minor fixes and cleanups.
6066 6071
6067 6072 * Version 0.1.9 released, 0.1.10 opened for further work.
6068 6073
6069 6074 * Added sys.path to the list of directories searched in the
6070 6075 execfile= option. It used to be the current directory and the
6071 6076 user's IPYTHONDIR only.
6072 6077
6073 6078 2001-11-13 Fernando Perez <fperez@colorado.edu>
6074 6079
6075 6080 * Reinstated the raw_input/prefilter separation that Janko had
6076 6081 initially. This gives a more convenient setup for extending the
6077 6082 pre-processor from the outside: raw_input always gets a string,
6078 6083 and prefilter has to process it. We can then redefine prefilter
6079 6084 from the outside and implement extensions for special
6080 6085 purposes.
6081 6086
6082 6087 Today I got one for inputting PhysicalQuantity objects
6083 6088 (from Scientific) without needing any function calls at
6084 6089 all. Extremely convenient, and it's all done as a user-level
6085 6090 extension (no IPython code was touched). Now instead of:
6086 6091 a = PhysicalQuantity(4.2,'m/s**2')
6087 6092 one can simply say
6088 6093 a = 4.2 m/s**2
6089 6094 or even
6090 6095 a = 4.2 m/s^2
6091 6096
6092 6097 I use this, but it's also a proof of concept: IPython really is
6093 6098 fully user-extensible, even at the level of the parsing of the
6094 6099 command line. It's not trivial, but it's perfectly doable.
6095 6100
6096 6101 * Added 'add_flip' method to inclusion conflict resolver. Fixes
6097 6102 the problem of modules being loaded in the inverse order in which
6098 6103 they were defined in
6099 6104
6100 6105 * Version 0.1.8 released, 0.1.9 opened for further work.
6101 6106
6102 6107 * Added magics pdef, source and file. They respectively show the
6103 6108 definition line ('prototype' in C), source code and full python
6104 6109 file for any callable object. The object inspector oinfo uses
6105 6110 these to show the same information.
6106 6111
6107 6112 * Version 0.1.7 released, 0.1.8 opened for further work.
6108 6113
6109 6114 * Separated all the magic functions into a class called Magic. The
6110 6115 InteractiveShell class was becoming too big for Xemacs to handle
6111 6116 (de-indenting a line would lock it up for 10 seconds while it
6112 6117 backtracked on the whole class!)
6113 6118
6114 6119 FIXME: didn't work. It can be done, but right now namespaces are
6115 6120 all messed up. Do it later (reverted it for now, so at least
6116 6121 everything works as before).
6117 6122
6118 6123 * Got the object introspection system (magic_oinfo) working! I
6119 6124 think this is pretty much ready for release to Janko, so he can
6120 6125 test it for a while and then announce it. Pretty much 100% of what
6121 6126 I wanted for the 'phase 1' release is ready. Happy, tired.
6122 6127
6123 6128 2001-11-12 Fernando Perez <fperez@colorado.edu>
6124 6129
6125 6130 * Version 0.1.6 released, 0.1.7 opened for further work.
6126 6131
6127 6132 * Fixed bug in printing: it used to test for truth before
6128 6133 printing, so 0 wouldn't print. Now checks for None.
6129 6134
6130 6135 * Fixed bug where auto-execs increase the prompt counter by 2 (b/c
6131 6136 they have to call len(str(sys.ps1)) ). But the fix is ugly, it
6132 6137 reaches by hand into the outputcache. Think of a better way to do
6133 6138 this later.
6134 6139
6135 6140 * Various small fixes thanks to Nathan's comments.
6136 6141
6137 6142 * Changed magic_pprint to magic_Pprint. This way it doesn't
6138 6143 collide with pprint() and the name is consistent with the command
6139 6144 line option.
6140 6145
6141 6146 * Changed prompt counter behavior to be fully like
6142 6147 Mathematica's. That is, even input that doesn't return a result
6143 6148 raises the prompt counter. The old behavior was kind of confusing
6144 6149 (getting the same prompt number several times if the operation
6145 6150 didn't return a result).
6146 6151
6147 6152 * Fixed Nathan's last name in a couple of places (Gray, not Graham).
6148 6153
6149 6154 * Fixed -Classic mode (wasn't working anymore).
6150 6155
6151 6156 * Added colored prompts using Nathan's new code. Colors are
6152 6157 currently hardwired, they can be user-configurable. For
6153 6158 developers, they can be chosen in file ipythonlib.py, at the
6154 6159 beginning of the CachedOutput class def.
6155 6160
6156 6161 2001-11-11 Fernando Perez <fperez@colorado.edu>
6157 6162
6158 6163 * Version 0.1.5 released, 0.1.6 opened for further work.
6159 6164
6160 6165 * Changed magic_env to *return* the environment as a dict (not to
6161 6166 print it). This way it prints, but it can also be processed.
6162 6167
6163 6168 * Added Verbose exception reporting to interactive
6164 6169 exceptions. Very nice, now even 1/0 at the prompt gives a verbose
6165 6170 traceback. Had to make some changes to the ultraTB file. This is
6166 6171 probably the last 'big' thing in my mental todo list. This ties
6167 6172 in with the next entry:
6168 6173
6169 6174 * Changed -Xi and -Xf to a single -xmode option. Now all the user
6170 6175 has to specify is Plain, Color or Verbose for all exception
6171 6176 handling.
6172 6177
6173 6178 * Removed ShellServices option. All this can really be done via
6174 6179 the magic system. It's easier to extend, cleaner and has automatic
6175 6180 namespace protection and documentation.
6176 6181
6177 6182 2001-11-09 Fernando Perez <fperez@colorado.edu>
6178 6183
6179 6184 * Fixed bug in output cache flushing (missing parameter to
6180 6185 __init__). Other small bugs fixed (found using pychecker).
6181 6186
6182 6187 * Version 0.1.4 opened for bugfixing.
6183 6188
6184 6189 2001-11-07 Fernando Perez <fperez@colorado.edu>
6185 6190
6186 6191 * Version 0.1.3 released, mainly because of the raw_input bug.
6187 6192
6188 6193 * Fixed NASTY bug in raw_input: input line wasn't properly parsed
6189 6194 and when testing for whether things were callable, a call could
6190 6195 actually be made to certain functions. They would get called again
6191 6196 once 'really' executed, with a resulting double call. A disaster
6192 6197 in many cases (list.reverse() would never work!).
6193 6198
6194 6199 * Removed prefilter() function, moved its code to raw_input (which
6195 6200 after all was just a near-empty caller for prefilter). This saves
6196 6201 a function call on every prompt, and simplifies the class a tiny bit.
6197 6202
6198 6203 * Fix _ip to __ip name in magic example file.
6199 6204
6200 6205 * Changed 'tar -x -f' to 'tar xvf' in auto-installer. This should
6201 6206 work with non-gnu versions of tar.
6202 6207
6203 6208 2001-11-06 Fernando Perez <fperez@colorado.edu>
6204 6209
6205 6210 * Version 0.1.2. Just to keep track of the recent changes.
6206 6211
6207 6212 * Fixed nasty bug in output prompt routine. It used to check 'if
6208 6213 arg != None...'. Problem is, this fails if arg implements a
6209 6214 special comparison (__cmp__) which disallows comparing to
6210 6215 None. Found it when trying to use the PhysicalQuantity module from
6211 6216 ScientificPython.
6212 6217
6213 6218 2001-11-05 Fernando Perez <fperez@colorado.edu>
6214 6219
6215 6220 * Also added dirs. Now the pushd/popd/dirs family functions
6216 6221 basically like the shell, with the added convenience of going home
6217 6222 when called with no args.
6218 6223
6219 6224 * pushd/popd slightly modified to mimic shell behavior more
6220 6225 closely.
6221 6226
6222 6227 * Added env,pushd,popd from ShellServices as magic functions. I
6223 6228 think the cleanest will be to port all desired functions from
6224 6229 ShellServices as magics and remove ShellServices altogether. This
6225 6230 will provide a single, clean way of adding functionality
6226 6231 (shell-type or otherwise) to IP.
6227 6232
6228 6233 2001-11-04 Fernando Perez <fperez@colorado.edu>
6229 6234
6230 6235 * Added .ipython/ directory to sys.path. This way users can keep
6231 6236 customizations there and access them via import.
6232 6237
6233 6238 2001-11-03 Fernando Perez <fperez@colorado.edu>
6234 6239
6235 6240 * Opened version 0.1.1 for new changes.
6236 6241
6237 6242 * Changed version number to 0.1.0: first 'public' release, sent to
6238 6243 Nathan and Janko.
6239 6244
6240 6245 * Lots of small fixes and tweaks.
6241 6246
6242 6247 * Minor changes to whos format. Now strings are shown, snipped if
6243 6248 too long.
6244 6249
6245 6250 * Changed ShellServices to work on __main__ so they show up in @who
6246 6251
6247 6252 * Help also works with ? at the end of a line:
6248 6253 ?sin and sin?
6249 6254 both produce the same effect. This is nice, as often I use the
6250 6255 tab-complete to find the name of a method, but I used to then have
6251 6256 to go to the beginning of the line to put a ? if I wanted more
6252 6257 info. Now I can just add the ? and hit return. Convenient.
6253 6258
6254 6259 2001-11-02 Fernando Perez <fperez@colorado.edu>
6255 6260
6256 6261 * Python version check (>=2.1) added.
6257 6262
6258 6263 * Added LazyPython documentation. At this point the docs are quite
6259 6264 a mess. A cleanup is in order.
6260 6265
6261 6266 * Auto-installer created. For some bizarre reason, the zipfiles
6262 6267 module isn't working on my system. So I made a tar version
6263 6268 (hopefully the command line options in various systems won't kill
6264 6269 me).
6265 6270
6266 6271 * Fixes to Struct in genutils. Now all dictionary-like methods are
6267 6272 protected (reasonably).
6268 6273
6269 6274 * Added pager function to genutils and changed ? to print usage
6270 6275 note through it (it was too long).
6271 6276
6272 6277 * Added the LazyPython functionality. Works great! I changed the
6273 6278 auto-quote escape to ';', it's on home row and next to '. But
6274 6279 both auto-quote and auto-paren (still /) escapes are command-line
6275 6280 parameters.
6276 6281
6277 6282
6278 6283 2001-11-01 Fernando Perez <fperez@colorado.edu>
6279 6284
6280 6285 * Version changed to 0.0.7. Fairly large change: configuration now
6281 6286 is all stored in a directory, by default .ipython. There, all
6282 6287 config files have normal looking names (not .names)
6283 6288
6284 6289 * Version 0.0.6 Released first to Lucas and Archie as a test
6285 6290 run. Since it's the first 'semi-public' release, change version to
6286 6291 > 0.0.6 for any changes now.
6287 6292
6288 6293 * Stuff I had put in the ipplib.py changelog:
6289 6294
6290 6295 Changes to InteractiveShell:
6291 6296
6292 6297 - Made the usage message a parameter.
6293 6298
6294 6299 - Require the name of the shell variable to be given. It's a bit
6295 6300 of a hack, but allows the name 'shell' not to be hardwired in the
6296 6301 magic (@) handler, which is problematic b/c it requires
6297 6302 polluting the global namespace with 'shell'. This in turn is
6298 6303 fragile: if a user redefines a variable called shell, things
6299 6304 break.
6300 6305
6301 6306 - magic @: all functions available through @ need to be defined
6302 6307 as magic_<name>, even though they can be called simply as
6303 6308 @<name>. This allows the special command @magic to gather
6304 6309 information automatically about all existing magic functions,
6305 6310 even if they are run-time user extensions, by parsing the shell
6306 6311 instance __dict__ looking for special magic_ names.
6307 6312
6308 6313 - mainloop: added *two* local namespace parameters. This allows
6309 6314 the class to differentiate between parameters which were there
6310 6315 before and after command line initialization was processed. This
6311 6316 way, later @who can show things loaded at startup by the
6312 6317 user. This trick was necessary to make session saving/reloading
6313 6318 really work: ideally after saving/exiting/reloading a session,
6314 6319 *everything* should look the same, including the output of @who. I
6315 6320 was only able to make this work with this double namespace
6316 6321 trick.
6317 6322
6318 6323 - added a header to the logfile which allows (almost) full
6319 6324 session restoring.
6320 6325
6321 6326 - prepend lines beginning with @ or !, with a and log
6322 6327 them. Why? !lines: may be useful to know what you did @lines:
6323 6328 they may affect session state. So when restoring a session, at
6324 6329 least inform the user of their presence. I couldn't quite get
6325 6330 them to properly re-execute, but at least the user is warned.
6326 6331
6327 6332 * Started ChangeLog.
@@ -1,406 +1,406 b''
1 1 .\" Hey, EMACS: -*- nroff -*-
2 2 .\" First parameter, NAME, should be all caps
3 3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 4 .\" other parameters are allowed: see man(7), man(1)
5 5 .TH IPYTHON 1 "November 30, 2004"
6 6 .\" Please adjust this date whenever revising the manpage.
7 7 .\"
8 8 .\" Some roff macros, for reference:
9 9 .\" .nh disable hyphenation
10 10 .\" .hy enable hyphenation
11 11 .\" .ad l left justify
12 12 .\" .ad b justify to both left and right margins
13 13 .\" .nf disable filling
14 14 .\" .fi enable filling
15 15 .\" .br insert line break
16 16 .\" .sp <n> insert n+1 empty lines
17 17 .\" for manpage-specific macros, see man(7) and groff_man(7)
18 18 .\" .SH section heading
19 19 .\" .SS secondary section heading
20 20 .\"
21 21 .\"
22 22 .\" To preview this page as plain text: nroff -man ipython.1
23 23 .\"
24 24 .SH NAME
25 25 ipython \- An Enhanced Interactive Python
26 26 .SH SYNOPSIS
27 27 .B ipython
28 28 .RI [ options ] " files" ...
29 29 .SH DESCRIPTION
30 30 An interactive Python shell with automatic history (input and output),
31 31 dynamic object introspection, easier configuration, command
32 32 completion, access to the system shell, integration with numerical and
33 33 scientific computing tools, and more.
34 34 .SH SPECIAL THREADING OPTIONS
35 35 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
54 54 request a specific version of wx to be used. This requires that you have the
55 55 'wxversion' Python module installed, which is part of recent wxPython
56 56 distributions.
57 57 .br
58 58 .sp 1
59 59 If \-pylab is given, IPython loads special support for the matplotlib library
60 60 (http://matplotlib.sourceforge.net), allowing interactive usage of any of its
61 61 backends as defined in the user's .matplotlibrc file. It automatically
62 62 activates GTK, QT or WX threading for IPyhton if the choice of matplotlib
63 63 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.
71 71 An extra option, \-tk, is available to address this issue. It can ONLY be
72 72 given as a SECOND option after any of the above (\-gthread, \-qthread,
73 73 \-wthread or \-pylab).
74 74 .br
75 75 .sp 1
76 76 If \-tk is given, IPython will try to coordinate Tk threading with GTK, QT or
77 77 WX. This is however potentially unreliable, and you will have to test on your
78 78 platform and Python configuration to determine whether it works for you.
79 79 Debian users have reported success, apparently due to the fact that Debian
80 80 builds all of Tcl, Tk, Tkinter and Python with pthreads support. Under other
81 81 Linux environments (such as Fedora Core 2), this option has caused random
82 82 crashes and lockups of the Python interpreter. Under other operating systems
83 83 (Mac OSX and Windows), you'll need to try it to find out, since currently no
84 84 user reports are available.
85 85 .br
86 86 .sp 1
87 87 There is unfortunately no way for IPython to determine at runtime whether \-tk
88 88 will work reliably or not, so you will need to do some experiments before
89 89 relying on it for regular work.
90 90 .
91 91 .SS A WARNING ABOUT SIGNALS AND THREADS
92 92 When any of the thread systems (GTK, QT or WX) are active, either directly or
93 93 via \-pylab with a threaded backend, it is impossible to interrupt
94 94 long-running Python code via Ctrl\-C. IPython can not pass the
95 95 KeyboardInterrupt exception (or the underlying SIGINT) across threads, so any
96 96 long-running process started from IPython will run to completion, or will have
97 97 to be killed via an external (OS-based) mechanism.
98 98 .br
99 99 .sp 1
100 100 To the best of my knowledge, this limitation is imposed by the Python
101 101 interpreter itself, and it comes from the difficulty of writing portable
102 102 signal/threaded code. If any user is an expert on this topic and can suggest
103 103 a better solution, I would love to hear about it. In the IPython sources,
104 104 look at the Shell.py module, and in particular at the runcode() method.
105 105 .
106 106 .SH REGULAR OPTIONS
107 107 After the above threading options have been given, regular options can follow
108 108 in any order. All options can be abbreviated to their shortest non-ambiguous
109 109 form and are case-sensitive. One or two dashes can be used. Some options
110 110 have an alternate short form, indicated after a |.
111 111 .br
112 112 .sp 1
113 113 Most options can also be set from your ipythonrc configuration file.
114 114 See the provided examples for assistance. Options given on the
115 115 commandline override the values set in the ipythonrc file.
116 116 .br
117 117 .sp 1
118 118 All options with a [no] prepended can be specified in negated form
119 119 (\-nooption instead of \-option) to turn the feature off.
120 120 .TP
121 121 .B \-h, \-\-help
122 122 Show summary of options.
123 123 .TP
124 124 .B \-autocall <val>
125 125 Make IPython automatically call any callable object even if you didn't type
126 126 explicit parentheses. For example, 'str 43' becomes
127 127 'str(43)' automatically. The value can be '0' to disable the
128 128 feature, '1' for 'smart' autocall, where it is not applied if
129 129 there are no more arguments on the line, and '2' for 'full'
130 130 autocall, where all callable objects are automatically called
131 131 (even if no arguments are present). The default is '1'.
132 132 .TP
133 133 .B \-[no]autoindent
134 134 Turn automatic indentation on/off.
135 135 .TP
136 136 .B \-[no]automagic
137 137 Make magic commands automatic (without needing their first character
138 138 to be %). Type %magic at the IPython prompt for more information.
139 139 .TP
140 140 .B \-[no]autoedit_syntax
141 141 When a syntax error occurs after editing a file, automatically open the file
142 142 to the trouble causing line for convenient fixing.
143 143 .TP
144 144 .B \-[no]banner
145 145 Print the intial information banner (default on).
146 146 .TP
147 147 .B \-c <command>
148 148 Execute the given command string, and set sys.argv to ['c']. This is similar
149 149 to the \-c option in the normal Python interpreter.
150 150 .TP
151 151 .B \-cache_size|cs <n>
152 152 Size of the output cache (maximum number of entries to hold in
153 153 memory). The default is 1000, you can change it permanently in your
154 154 config file. Setting it to 0 completely disables the caching system,
155 155 and the minimum value accepted is 20 (if you provide a value less than
156 156 20, it is reset to 0 and a warning is issued). This limit is defined
157 157 because otherwise you'll spend more time re-flushing a too small cache
158 158 than working.
159 159 .TP
160 160 .B \-classic|cl
161 161 Gives IPython a similar feel to the classic Python prompt.
162 162 .TP
163 163 .B \-colors <scheme>
164 164 Color scheme for prompts and exception reporting. Currently
165 165 implemented: NoColor, Linux, and LightBG.
166 166 .TP
167 167 .B \-[no]color_info
168 168 IPython can display information about objects via a set of functions,
169 169 and optionally can use colors for this, syntax highlighting source
170 170 code and various other elements. However, because this information is
171 171 passed through a pager (like 'less') and many pagers get confused with
172 172 color codes, this option is off by default. You can test it and turn
173 173 it on permanently in your ipythonrc file if it works for you. As a
174 174 reference, the 'less' pager supplied with Mandrake 8.2 works ok, but
175 175 that in RedHat 7.2 doesn't.
176 176 .br
177 177 .sp 1
178 178 Test it and turn it on permanently if it works with your system. The
179 179 magic function @color_info allows you to toggle this interactively for
180 180 testing.
181 181 .TP
182 182 .B \-[no]confirm_exit
183 183 Set to confirm when you try to exit IPython with an EOF (Control-D in
184 184 Unix, Control-Z/Enter in Windows). Note that using the magic functions
185 185 @Exit or @Quit you can force a direct exit, bypassing any
186 186 confirmation.
187 187 .TP
188 188 .B \-[no]debug
189 189 Show information about the loading process. Very useful to pin down
190 190 problems with your configuration files or to get details about session
191 191 restores.
192 192 .TP
193 193 .B \-[no]deep_reload
194 194 IPython can use the deep_reload module which reloads changes in
195 195 modules recursively (it replaces the reload() function, so you don't
196 196 need to change anything to use it). deep_reload() forces a full reload
197 197 of modules whose code may have changed, which the default reload()
198 198 function does not.
199 199 .br
200 200 .sp 1
201 201 When deep_reload is off, IPython will use the normal reload(), but
202 202 deep_reload will still be available as dreload(). This feature is off
203 203 by default [which means that you have both normal reload() and
204 204 dreload()].
205 205 .TP
206 206 .B \-editor <name>
207 207 Which editor to use with the @edit command. By default, IPython will
208 208 honor your EDITOR environment variable (if not set, vi is the Unix
209 209 default and notepad the Windows one). Since this editor is invoked on
210 210 the fly by IPython and is meant for editing small code snippets, you
211 211 may want to use a small, lightweight editor here (in case your default
212 212 EDITOR is something like Emacs).
213 213 .TP
214 214 .B \-ipythondir <name>
215 215 The name of your IPython configuration directory IPYTHONDIR. This can
216 216 also be specified through the environment variable IPYTHONDIR.
217 217 .TP
218 218 .B \-log|l
219 219 Generate a log file of all input. The file is named ipython_log.py in your
220 220 current directory (which prevents logs from multiple IPython sessions from
221 221 trampling each other). You can use this to later restore a session by loading
222 222 your logfile as a file to be executed with option -logplay (see below).
223 223 .TP
224 224 .B \-logfile|lf
225 225 Specify the name of your logfile.
226 226 .TP
227 227 .B \-logplay|lp
228 228 Replay a previous log. For restoring a session as close as possible to
229 229 the state you left it in, use this option (don't just run the
230 230 logfile). With \-logplay, IPython will try to reconstruct the previous
231 231 working environment in full, not just execute the commands in the
232 232 logfile.
233 233 .br
234 234 .sh 1
235 235 When a session is restored, logging is automatically turned on again
236 236 with the name of the logfile it was invoked with (it is read from the
237 237 log header). So once you've turned logging on for a session, you can
238 238 quit IPython and reload it as many times as you want and it will
239 239 continue to log its history and restore from the beginning every time.
240 240 .br
241 241 .sp 1
242 242 Caveats: there are limitations in this option. The history variables
243 243 _i*,_* and _dh don't get restored properly. In the future we will try
244 244 to implement full session saving by writing and retrieving a
245 245 'snapshot' of the memory state of IPython. But our first attempts
246 246 failed because of inherent limitations of Python's Pickle module, so
247 247 this may have to wait.
248 248 .TP
249 249 .B \-[no]messages
250 250 Print messages which IPython collects about its startup process
251 251 (default on).
252 252 .TP
253 253 .B \-[no]pdb
254 254 Automatically call the pdb debugger after every uncaught exception. If
255 255 you are used to debugging using pdb, this puts you automatically
256 256 inside of it after any call (either in IPython or in code called by
257 257 it) which triggers an exception which goes uncaught.
258 258 .TP
259 259 .B \-[no]pprint
260 260 IPython can optionally use the pprint (pretty printer) module for
261 261 displaying results. pprint tends to give a nicer display of nested
262 262 data structures. If you like it, you can turn it on permanently in
263 263 your config file (default off).
264 264 .TP
265 265 .B \-profile|p <name>
266 266 Assume that your config file is ipythonrc-<name> (looks in current dir
267 267 first, then in IPYTHONDIR). This is a quick way to keep and load
268 268 multiple config files for different tasks, especially if you use the
269 269 include option of config files. You can keep a basic
270 270 IPYTHONDIR/ipythonrc file and then have other 'profiles' which include
271 271 this one and load extra things for particular tasks. For example:
272 272 .br
273 273 .sp 1
274 274 1) $HOME/.ipython/ipythonrc : load basic things you always want.
275 275 .br
276 276 2) $HOME/.ipython/ipythonrc-math : load (1) and basic math-related
277 277 modules.
278 278 .br
279 279 3) $HOME/.ipython/ipythonrc-numeric : load (1) and Numeric and
280 280 plotting modules.
281 281 .br
282 282 .sp 1
283 283 Since it is possible to create an endless loop by having circular file
284 284 inclusions, IPython will stop if it reaches 15 recursive inclusions.
285 285 .TP
286 286 .B \-prompt_in1|pi1 <string>
287 287 Specify the string used for input prompts. Note that if you are using
288 288 numbered prompts, the number is represented with a '\\#' in the
289 289 string. Don't forget to quote strings with spaces embedded in
290 290 them. Default: 'In [\\#]: '.
291 291 .br
292 292 .sp 1
293 293 Most bash-like escapes can be used to customize IPython's prompts, as well as
294 294 a few additional ones which are IPython-specific. All valid prompt escapes
295 295 are described in detail in the Customization section of the IPython HTML/PDF
296 296 manual.
297 297 .TP
298 298 .B \-prompt_in2|pi2 <string>
299 299 Similar to the previous option, but used for the continuation prompts. The
300 300 special sequence '\\D' is similar to '\\#', but with all digits replaced dots
301 301 (so you can have your continuation prompt aligned with your input
302 302 prompt). Default: ' .\\D.: ' (note three spaces at the start for alignment
303 303 with 'In [\\#]').
304 304 .TP
305 305 .B \-prompt_out|po <string>
306 306 String used for output prompts, also uses numbers like prompt_in1.
307 307 Default: 'Out[\\#]:'.
308 308 .TP
309 309 .B \-quick
310 310 Start in bare bones mode (no config file loaded).
311 311 .TP
312 312 .B \-rcfile <name>
313 313 Name of your IPython resource configuration file. normally IPython
314 314 loads ipythonrc (from current directory) or IPYTHONDIR/ipythonrc. If
315 315 the loading of your config file fails, IPython starts with a bare
316 316 bones configuration (no modules loaded at all).
317 317 .TP
318 318 .B \-[no]readline
319 319 Use the readline library, which is needed to support name completion
320 320 and command history, among other things. It is enabled by default, but
321 321 may cause problems for users of X/Emacs in Python comint or shell
322 322 buffers.
323 323 .br
324 324 .sp 1
325 325 Note that emacs 'eterm' buffers (opened with M-x term) support
326 326 IPython's readline and syntax coloring fine, only 'emacs' (M-x shell
327 327 and C-c !) buffers do not.
328 328 .TP
329 329 .B \-screen_length|sl <n>
330 330 Number of lines of your screen. This is used to control printing of
331 331 very long strings. Strings longer than this number of lines will be
332 332 sent through a pager instead of directly printed.
333 333 .br
334 334 .sp 1
335 335 The default value for this is 0, which means IPython will auto-detect
336 336 your screen size every time it needs to print certain potentially long
337 337 strings (this doesn't change the behavior of the 'print' keyword, it's
338 338 only triggered internally). If for some reason this isn't working well
339 339 (it needs curses support), specify it yourself. Otherwise don't change
340 340 the default.
341 341 .TP
342 342 .B \-separate_in|si <string>
343 343 Separator before input prompts. Default '\n'.
344 344 .TP
345 345 .B \-separate_out|so <string>
346 346 Separator before output prompts. Default: 0 (nothing).
347 347 .TP
348 348 .B \-separate_out2|so2 <string>
349 349 Separator after output prompts. Default: 0 (nothing).
350 350 .TP
351 351 .B \-nosep
352 352 Shorthand for '\-separate_in 0 \-separate_out 0 \-separate_out2 0'.
353 353 Simply removes all input/output separators.
354 354 .TP
355 355 .B \-upgrade
356 356 Allows you to upgrade your IPYTHONDIR configuration when you install a
357 357 new version of IPython. Since new versions may include new command
358 358 lines options or example files, this copies updated ipythonrc-type
359 359 files. However, it backs up (with a .old extension) all files which
360 360 it overwrites so that you can merge back any custimizations you might
361 361 have in your personal files.
362 362 .TP
363 363 .B \-Version
364 364 Print version information and exit.
365 365 .TP
366 366 .B -wxversion <string>
367 367 Select a specific version of wxPython (used in conjunction with
368 368 \-wthread). Requires the wxversion module, part of recent wxPython
369 369 distributions.
370 370 .TP
371 371 .B \-xmode <modename>
372 372 Mode for exception reporting. The valid modes are Plain, Context, and
373 373 Verbose.
374 374 .br
375 375 .sp 1
376 376 \- Plain: similar to python's normal traceback printing.
377 377 .br
378 378 .sp 1
379 379 \- Context: prints 5 lines of context source code around each line in the
380 380 traceback.
381 381 .br
382 382 .sp 1
383 383 \- Verbose: similar to Context, but additionally prints the variables
384 384 currently visible where the exception happened (shortening their strings if
385 385 too long). This can potentially be very slow, if you happen to have a huge
386 386 data structure whose string representation is complex to compute. Your
387 387 computer may appear to freeze for a while with cpu usage at 100%. If this
388 388 occurs, you can cancel the traceback with Ctrl-C (maybe hitting it more than
389 389 once).
390 390 .
391 391 .SH EMBEDDING
392 392 It is possible to start an IPython instance inside your own Python
393 393 programs. In the documentation example files there are some
394 394 illustrations on how to do this.
395 395 .br
396 396 .sp 1
397 397 This feature allows you to evalutate dynamically the state of your
398 398 code, operate with your variables, analyze them, etc. Note however
399 399 that any changes you make to values while in the shell do NOT
400 400 propagate back to the running code, so it is safe to modify your
401 401 values because you won't break your code in bizarre ways by doing so.
402 402 .SH AUTHOR
403 403 IPython was written by Fernando Perez <fperez@colorado.edu>, based on earlier
404 404 code by Janko Hauser <jh@comunit.de> and Nathaniel Gray
405 405 <n8gray@caltech.edu>. This manual page was written by Jack Moffitt
406 406 <jack@xiph.org>, for the Debian project (but may be used by others).
1 NO CONTENT: modified file
The requested commit or file is too big and content was truncated. Show full diff
1 NO CONTENT: modified file
The requested commit or file is too big and content was truncated. Show full diff
General Comments 0
You need to be logged in to leave comments. Login now