##// END OF EJS Templates
no_alias honored properly in %rehashx
vivainio -
Show More
@@ -1,2970 +1,2970 b''
1 1 # -*- coding: utf-8 -*-
2 2 """Magic functions for InteractiveShell.
3 3
4 $Id: Magic.py 1338 2006-05-31 14:24:23Z vivainio $"""
4 $Id: Magic.py 1351 2006-06-05 13:43:18Z vivainio $"""
5 5
6 6 #*****************************************************************************
7 7 # Copyright (C) 2001 Janko Hauser <jhauser@zscout.de> and
8 8 # Copyright (C) 2001-2006 Fernando Perez <fperez@colorado.edu>
9 9 #
10 10 # Distributed under the terms of the BSD License. The full license is in
11 11 # the file COPYING, distributed as part of this software.
12 12 #*****************************************************************************
13 13
14 14 #****************************************************************************
15 15 # Modules and globals
16 16
17 17 from IPython import Release
18 18 __author__ = '%s <%s>\n%s <%s>' % \
19 19 ( Release.authors['Janko'] + Release.authors['Fernando'] )
20 20 __license__ = Release.license
21 21
22 22 # Python standard modules
23 23 import __builtin__
24 24 import bdb
25 25 import inspect
26 26 import os
27 27 import pdb
28 28 import pydoc
29 29 import shlex
30 30 import sys
31 31 import re
32 32 import tempfile
33 33 import time
34 34 import cPickle as pickle
35 35 import textwrap
36 36 from cStringIO import StringIO
37 37 from getopt import getopt,GetoptError
38 38 from pprint import pprint, pformat
39 39
40 40 # profile isn't bundled by default in Debian for license reasons
41 41 try:
42 42 import profile,pstats
43 43 except ImportError:
44 44 profile = pstats = None
45 45
46 46 # Homebrewed
47 47 import IPython
48 48 from IPython import Debugger, OInspect, wildcard
49 49 from IPython.FakeModule import FakeModule
50 50 from IPython.Itpl import Itpl, itpl, printpl,itplns
51 51 from IPython.PyColorize import Parser
52 52 from IPython.ipstruct import Struct
53 53 from IPython.macro import Macro
54 54 from IPython.genutils import *
55 55 from IPython import platutils
56 56
57 57 #***************************************************************************
58 58 # Utility functions
59 59 def on_off(tag):
60 60 """Return an ON/OFF string for a 1/0 input. Simple utility function."""
61 61 return ['OFF','ON'][tag]
62 62
63 63 class Bunch: pass
64 64
65 65 #***************************************************************************
66 66 # Main class implementing Magic functionality
67 67 class Magic:
68 68 """Magic functions for InteractiveShell.
69 69
70 70 Shell functions which can be reached as %function_name. All magic
71 71 functions should accept a string, which they can parse for their own
72 72 needs. This can make some functions easier to type, eg `%cd ../`
73 73 vs. `%cd("../")`
74 74
75 75 ALL definitions MUST begin with the prefix magic_. The user won't need it
76 76 at the command line, but it is is needed in the definition. """
77 77
78 78 # class globals
79 79 auto_status = ['Automagic is OFF, % prefix IS needed for magic functions.',
80 80 'Automagic is ON, % prefix NOT needed for magic functions.']
81 81
82 82 #......................................................................
83 83 # some utility functions
84 84
85 85 def __init__(self,shell):
86 86
87 87 self.options_table = {}
88 88 if profile is None:
89 89 self.magic_prun = self.profile_missing_notice
90 90 self.shell = shell
91 91
92 92 # namespace for holding state we may need
93 93 self._magic_state = Bunch()
94 94
95 95 def profile_missing_notice(self, *args, **kwargs):
96 96 error("""\
97 97 The profile module could not be found. If you are a Debian user,
98 98 it has been removed from the standard Debian package because of its non-free
99 99 license. To use profiling, please install"python2.3-profiler" from non-free.""")
100 100
101 101 def default_option(self,fn,optstr):
102 102 """Make an entry in the options_table for fn, with value optstr"""
103 103
104 104 if fn not in self.lsmagic():
105 105 error("%s is not a magic function" % fn)
106 106 self.options_table[fn] = optstr
107 107
108 108 def lsmagic(self):
109 109 """Return a list of currently available magic functions.
110 110
111 111 Gives a list of the bare names after mangling (['ls','cd', ...], not
112 112 ['magic_ls','magic_cd',...]"""
113 113
114 114 # FIXME. This needs a cleanup, in the way the magics list is built.
115 115
116 116 # magics in class definition
117 117 class_magic = lambda fn: fn.startswith('magic_') and \
118 118 callable(Magic.__dict__[fn])
119 119 # in instance namespace (run-time user additions)
120 120 inst_magic = lambda fn: fn.startswith('magic_') and \
121 121 callable(self.__dict__[fn])
122 122 # and bound magics by user (so they can access self):
123 123 inst_bound_magic = lambda fn: fn.startswith('magic_') and \
124 124 callable(self.__class__.__dict__[fn])
125 125 magics = filter(class_magic,Magic.__dict__.keys()) + \
126 126 filter(inst_magic,self.__dict__.keys()) + \
127 127 filter(inst_bound_magic,self.__class__.__dict__.keys())
128 128 out = []
129 129 for fn in magics:
130 130 out.append(fn.replace('magic_','',1))
131 131 out.sort()
132 132 return out
133 133
134 134 def extract_input_slices(self,slices,raw=False):
135 135 """Return as a string a set of input history slices.
136 136
137 137 Inputs:
138 138
139 139 - slices: the set of slices is given as a list of strings (like
140 140 ['1','4:8','9'], since this function is for use by magic functions
141 141 which get their arguments as strings.
142 142
143 143 Optional inputs:
144 144
145 145 - raw(False): by default, the processed input is used. If this is
146 146 true, the raw input history is used instead.
147 147
148 148 Note that slices can be called with two notations:
149 149
150 150 N:M -> standard python form, means including items N...(M-1).
151 151
152 152 N-M -> include items N..M (closed endpoint)."""
153 153
154 154 if raw:
155 155 hist = self.shell.input_hist_raw
156 156 else:
157 157 hist = self.shell.input_hist
158 158
159 159 cmds = []
160 160 for chunk in slices:
161 161 if ':' in chunk:
162 162 ini,fin = map(int,chunk.split(':'))
163 163 elif '-' in chunk:
164 164 ini,fin = map(int,chunk.split('-'))
165 165 fin += 1
166 166 else:
167 167 ini = int(chunk)
168 168 fin = ini+1
169 169 cmds.append(hist[ini:fin])
170 170 return cmds
171 171
172 172 def _ofind(self,oname):
173 173 """Find an object in the available namespaces.
174 174
175 175 self._ofind(oname) -> dict with keys: found,obj,ospace,ismagic
176 176
177 177 Has special code to detect magic functions.
178 178 """
179 179
180 180 oname = oname.strip()
181 181
182 182 # Namespaces to search in:
183 183 user_ns = self.shell.user_ns
184 184 internal_ns = self.shell.internal_ns
185 185 builtin_ns = __builtin__.__dict__
186 186 alias_ns = self.shell.alias_table
187 187
188 188 # Put them in a list. The order is important so that we find things in
189 189 # the same order that Python finds them.
190 190 namespaces = [ ('Interactive',user_ns),
191 191 ('IPython internal',internal_ns),
192 192 ('Python builtin',builtin_ns),
193 193 ('Alias',alias_ns),
194 194 ]
195 195
196 196 # initialize results to 'null'
197 197 found = 0; obj = None; ospace = None; ds = None;
198 198 ismagic = 0; isalias = 0
199 199
200 200 # Look for the given name by splitting it in parts. If the head is
201 201 # found, then we look for all the remaining parts as members, and only
202 202 # declare success if we can find them all.
203 203 oname_parts = oname.split('.')
204 204 oname_head, oname_rest = oname_parts[0],oname_parts[1:]
205 205 for nsname,ns in namespaces:
206 206 try:
207 207 obj = ns[oname_head]
208 208 except KeyError:
209 209 continue
210 210 else:
211 211 for part in oname_rest:
212 212 try:
213 213 obj = getattr(obj,part)
214 214 except:
215 215 # Blanket except b/c some badly implemented objects
216 216 # allow __getattr__ to raise exceptions other than
217 217 # AttributeError, which then crashes IPython.
218 218 break
219 219 else:
220 220 # If we finish the for loop (no break), we got all members
221 221 found = 1
222 222 ospace = nsname
223 223 if ns == alias_ns:
224 224 isalias = 1
225 225 break # namespace loop
226 226
227 227 # Try to see if it's magic
228 228 if not found:
229 229 if oname.startswith(self.shell.ESC_MAGIC):
230 230 oname = oname[1:]
231 231 obj = getattr(self,'magic_'+oname,None)
232 232 if obj is not None:
233 233 found = 1
234 234 ospace = 'IPython internal'
235 235 ismagic = 1
236 236
237 237 # Last try: special-case some literals like '', [], {}, etc:
238 238 if not found and oname_head in ["''",'""','[]','{}','()']:
239 239 obj = eval(oname_head)
240 240 found = 1
241 241 ospace = 'Interactive'
242 242
243 243 return {'found':found, 'obj':obj, 'namespace':ospace,
244 244 'ismagic':ismagic, 'isalias':isalias}
245 245
246 246 def arg_err(self,func):
247 247 """Print docstring if incorrect arguments were passed"""
248 248 print 'Error in arguments:'
249 249 print OInspect.getdoc(func)
250 250
251 251 def format_latex(self,strng):
252 252 """Format a string for latex inclusion."""
253 253
254 254 # Characters that need to be escaped for latex:
255 255 escape_re = re.compile(r'(%|_|\$|#|&)',re.MULTILINE)
256 256 # Magic command names as headers:
257 257 cmd_name_re = re.compile(r'^(%s.*?):' % self.shell.ESC_MAGIC,
258 258 re.MULTILINE)
259 259 # Magic commands
260 260 cmd_re = re.compile(r'(?P<cmd>%s.+?\b)(?!\}\}:)' % self.shell.ESC_MAGIC,
261 261 re.MULTILINE)
262 262 # Paragraph continue
263 263 par_re = re.compile(r'\\$',re.MULTILINE)
264 264
265 265 # The "\n" symbol
266 266 newline_re = re.compile(r'\\n')
267 267
268 268 # Now build the string for output:
269 269 #strng = cmd_name_re.sub(r'\n\\texttt{\\textsl{\\large \1}}:',strng)
270 270 strng = cmd_name_re.sub(r'\n\\bigskip\n\\texttt{\\textbf{ \1}}:',
271 271 strng)
272 272 strng = cmd_re.sub(r'\\texttt{\g<cmd>}',strng)
273 273 strng = par_re.sub(r'\\\\',strng)
274 274 strng = escape_re.sub(r'\\\1',strng)
275 275 strng = newline_re.sub(r'\\textbackslash{}n',strng)
276 276 return strng
277 277
278 278 def format_screen(self,strng):
279 279 """Format a string for screen printing.
280 280
281 281 This removes some latex-type format codes."""
282 282 # Paragraph continue
283 283 par_re = re.compile(r'\\$',re.MULTILINE)
284 284 strng = par_re.sub('',strng)
285 285 return strng
286 286
287 287 def parse_options(self,arg_str,opt_str,*long_opts,**kw):
288 288 """Parse options passed to an argument string.
289 289
290 290 The interface is similar to that of getopt(), but it returns back a
291 291 Struct with the options as keys and the stripped argument string still
292 292 as a string.
293 293
294 294 arg_str is quoted as a true sys.argv vector by using shlex.split.
295 295 This allows us to easily expand variables, glob files, quote
296 296 arguments, etc.
297 297
298 298 Options:
299 299 -mode: default 'string'. If given as 'list', the argument string is
300 300 returned as a list (split on whitespace) instead of a string.
301 301
302 302 -list_all: put all option values in lists. Normally only options
303 303 appearing more than once are put in a list."""
304 304
305 305 # inject default options at the beginning of the input line
306 306 caller = sys._getframe(1).f_code.co_name.replace('magic_','')
307 307 arg_str = '%s %s' % (self.options_table.get(caller,''),arg_str)
308 308
309 309 mode = kw.get('mode','string')
310 310 if mode not in ['string','list']:
311 311 raise ValueError,'incorrect mode given: %s' % mode
312 312 # Get options
313 313 list_all = kw.get('list_all',0)
314 314
315 315 # Check if we have more than one argument to warrant extra processing:
316 316 odict = {} # Dictionary with options
317 317 args = arg_str.split()
318 318 if len(args) >= 1:
319 319 # If the list of inputs only has 0 or 1 thing in it, there's no
320 320 # need to look for options
321 321 argv = shlex.split(arg_str)
322 322 # Do regular option processing
323 323 try:
324 324 opts,args = getopt(argv,opt_str,*long_opts)
325 325 except GetoptError,e:
326 326 raise GetoptError('%s ( allowed: "%s" %s)' % (e.msg,opt_str,
327 327 " ".join(long_opts)))
328 328 for o,a in opts:
329 329 if o.startswith('--'):
330 330 o = o[2:]
331 331 else:
332 332 o = o[1:]
333 333 try:
334 334 odict[o].append(a)
335 335 except AttributeError:
336 336 odict[o] = [odict[o],a]
337 337 except KeyError:
338 338 if list_all:
339 339 odict[o] = [a]
340 340 else:
341 341 odict[o] = a
342 342
343 343 # Prepare opts,args for return
344 344 opts = Struct(odict)
345 345 if mode == 'string':
346 346 args = ' '.join(args)
347 347
348 348 return opts,args
349 349
350 350 #......................................................................
351 351 # And now the actual magic functions
352 352
353 353 # Functions for IPython shell work (vars,funcs, config, etc)
354 354 def magic_lsmagic(self, parameter_s = ''):
355 355 """List currently available magic functions."""
356 356 mesc = self.shell.ESC_MAGIC
357 357 print 'Available magic functions:\n'+mesc+\
358 358 (' '+mesc).join(self.lsmagic())
359 359 print '\n' + Magic.auto_status[self.shell.rc.automagic]
360 360 return None
361 361
362 362 def magic_magic(self, parameter_s = ''):
363 363 """Print information about the magic function system."""
364 364
365 365 mode = ''
366 366 try:
367 367 if parameter_s.split()[0] == '-latex':
368 368 mode = 'latex'
369 369 if parameter_s.split()[0] == '-brief':
370 370 mode = 'brief'
371 371 except:
372 372 pass
373 373
374 374 magic_docs = []
375 375 for fname in self.lsmagic():
376 376 mname = 'magic_' + fname
377 377 for space in (Magic,self,self.__class__):
378 378 try:
379 379 fn = space.__dict__[mname]
380 380 except KeyError:
381 381 pass
382 382 else:
383 383 break
384 384 if mode == 'brief':
385 385 # only first line
386 386 fndoc = fn.__doc__.split('\n',1)[0]
387 387 else:
388 388 fndoc = fn.__doc__
389 389
390 390 magic_docs.append('%s%s:\n\t%s\n' %(self.shell.ESC_MAGIC,
391 391 fname,fndoc))
392 392 magic_docs = ''.join(magic_docs)
393 393
394 394 if mode == 'latex':
395 395 print self.format_latex(magic_docs)
396 396 return
397 397 else:
398 398 magic_docs = self.format_screen(magic_docs)
399 399 if mode == 'brief':
400 400 return magic_docs
401 401
402 402 outmsg = """
403 403 IPython's 'magic' functions
404 404 ===========================
405 405
406 406 The magic function system provides a series of functions which allow you to
407 407 control the behavior of IPython itself, plus a lot of system-type
408 408 features. All these functions are prefixed with a % character, but parameters
409 409 are given without parentheses or quotes.
410 410
411 411 NOTE: If you have 'automagic' enabled (via the command line option or with the
412 412 %automagic function), you don't need to type in the % explicitly. By default,
413 413 IPython ships with automagic on, so you should only rarely need the % escape.
414 414
415 415 Example: typing '%cd mydir' (without the quotes) changes you working directory
416 416 to 'mydir', if it exists.
417 417
418 418 You can define your own magic functions to extend the system. See the supplied
419 419 ipythonrc and example-magic.py files for details (in your ipython
420 420 configuration directory, typically $HOME/.ipython/).
421 421
422 422 You can also define your own aliased names for magic functions. In your
423 423 ipythonrc file, placing a line like:
424 424
425 425 execute __IPYTHON__.magic_pf = __IPYTHON__.magic_profile
426 426
427 427 will define %pf as a new name for %profile.
428 428
429 429 You can also call magics in code using the ipmagic() function, which IPython
430 430 automatically adds to the builtin namespace. Type 'ipmagic?' for details.
431 431
432 432 For a list of the available magic functions, use %lsmagic. For a description
433 433 of any of them, type %magic_name?, e.g. '%cd?'.
434 434
435 435 Currently the magic system has the following functions:\n"""
436 436
437 437 mesc = self.shell.ESC_MAGIC
438 438 outmsg = ("%s\n%s\n\nSummary of magic functions (from %slsmagic):"
439 439 "\n\n%s%s\n\n%s" % (outmsg,
440 440 magic_docs,mesc,mesc,
441 441 (' '+mesc).join(self.lsmagic()),
442 442 Magic.auto_status[self.shell.rc.automagic] ) )
443 443
444 444 page(outmsg,screen_lines=self.shell.rc.screen_length)
445 445
446 446 def magic_automagic(self, parameter_s = ''):
447 447 """Make magic functions callable without having to type the initial %.
448 448
449 449 Toggles on/off (when off, you must call it as %automagic, of
450 450 course). Note that magic functions have lowest priority, so if there's
451 451 a variable whose name collides with that of a magic fn, automagic
452 452 won't work for that function (you get the variable instead). However,
453 453 if you delete the variable (del var), the previously shadowed magic
454 454 function becomes visible to automagic again."""
455 455
456 456 rc = self.shell.rc
457 457 rc.automagic = not rc.automagic
458 458 print '\n' + Magic.auto_status[rc.automagic]
459 459
460 460 def magic_autocall(self, parameter_s = ''):
461 461 """Make functions callable without having to type parentheses.
462 462
463 463 Usage:
464 464
465 465 %autocall [mode]
466 466
467 467 The mode can be one of: 0->Off, 1->Smart, 2->Full. If not given, the
468 468 value is toggled on and off (remembering the previous state)."""
469 469
470 470 rc = self.shell.rc
471 471
472 472 if parameter_s:
473 473 arg = int(parameter_s)
474 474 else:
475 475 arg = 'toggle'
476 476
477 477 if not arg in (0,1,2,'toggle'):
478 478 error('Valid modes: (0->Off, 1->Smart, 2->Full')
479 479 return
480 480
481 481 if arg in (0,1,2):
482 482 rc.autocall = arg
483 483 else: # toggle
484 484 if rc.autocall:
485 485 self._magic_state.autocall_save = rc.autocall
486 486 rc.autocall = 0
487 487 else:
488 488 try:
489 489 rc.autocall = self._magic_state.autocall_save
490 490 except AttributeError:
491 491 rc.autocall = self._magic_state.autocall_save = 1
492 492
493 493 print "Automatic calling is:",['OFF','Smart','Full'][rc.autocall]
494 494
495 495 def magic_autoindent(self, parameter_s = ''):
496 496 """Toggle autoindent on/off (if available)."""
497 497
498 498 self.shell.set_autoindent()
499 499 print "Automatic indentation is:",['OFF','ON'][self.shell.autoindent]
500 500
501 501 def magic_system_verbose(self, parameter_s = ''):
502 502 """Toggle verbose printing of system calls on/off."""
503 503
504 504 self.shell.rc_set_toggle('system_verbose')
505 505 print "System verbose printing is:",\
506 506 ['OFF','ON'][self.shell.rc.system_verbose]
507 507
508 508 def magic_history(self, parameter_s = ''):
509 509 """Print input history (_i<n> variables), with most recent last.
510 510
511 511 %history -> print at most 40 inputs (some may be multi-line)\\
512 512 %history n -> print at most n inputs\\
513 513 %history n1 n2 -> print inputs between n1 and n2 (n2 not included)\\
514 514
515 515 Each input's number <n> is shown, and is accessible as the
516 516 automatically generated variable _i<n>. Multi-line statements are
517 517 printed starting at a new line for easy copy/paste.
518 518
519 519
520 520 Options:
521 521
522 522 -n: do NOT print line numbers. This is useful if you want to get a
523 523 printout of many lines which can be directly pasted into a text
524 524 editor.
525 525
526 526 This feature is only available if numbered prompts are in use.
527 527
528 528 -r: print the 'raw' history. IPython filters your input and
529 529 converts it all into valid Python source before executing it (things
530 530 like magics or aliases are turned into function calls, for
531 531 example). With this option, you'll see the unfiltered history
532 532 instead of the filtered version: '%cd /' will be seen as '%cd /'
533 533 instead of '_ip.magic("%cd /")'.
534 534 """
535 535
536 536 shell = self.shell
537 537 if not shell.outputcache.do_full_cache:
538 538 print 'This feature is only available if numbered prompts are in use.'
539 539 return
540 540 opts,args = self.parse_options(parameter_s,'nr',mode='list')
541 541
542 542 if opts.has_key('r'):
543 543 input_hist = shell.input_hist_raw
544 544 else:
545 545 input_hist = shell.input_hist
546 546
547 547 default_length = 40
548 548 if len(args) == 0:
549 549 final = len(input_hist)
550 550 init = max(1,final-default_length)
551 551 elif len(args) == 1:
552 552 final = len(input_hist)
553 553 init = max(1,final-int(args[0]))
554 554 elif len(args) == 2:
555 555 init,final = map(int,args)
556 556 else:
557 557 warn('%hist takes 0, 1 or 2 arguments separated by spaces.')
558 558 print self.magic_hist.__doc__
559 559 return
560 560 width = len(str(final))
561 561 line_sep = ['','\n']
562 562 print_nums = not opts.has_key('n')
563 563 for in_num in range(init,final):
564 564 inline = input_hist[in_num]
565 565 multiline = int(inline.count('\n') > 1)
566 566 if print_nums:
567 567 print '%s:%s' % (str(in_num).ljust(width),line_sep[multiline]),
568 568 print inline,
569 569
570 570 def magic_hist(self, parameter_s=''):
571 571 """Alternate name for %history."""
572 572 return self.magic_history(parameter_s)
573 573
574 574 def magic_p(self, parameter_s=''):
575 575 """Just a short alias for Python's 'print'."""
576 576 exec 'print ' + parameter_s in self.shell.user_ns
577 577
578 578 def magic_r(self, parameter_s=''):
579 579 """Repeat previous input.
580 580
581 581 If given an argument, repeats the previous command which starts with
582 582 the same string, otherwise it just repeats the previous input.
583 583
584 584 Shell escaped commands (with ! as first character) are not recognized
585 585 by this system, only pure python code and magic commands.
586 586 """
587 587
588 588 start = parameter_s.strip()
589 589 esc_magic = self.shell.ESC_MAGIC
590 590 # Identify magic commands even if automagic is on (which means
591 591 # the in-memory version is different from that typed by the user).
592 592 if self.shell.rc.automagic:
593 593 start_magic = esc_magic+start
594 594 else:
595 595 start_magic = start
596 596 # Look through the input history in reverse
597 597 for n in range(len(self.shell.input_hist)-2,0,-1):
598 598 input = self.shell.input_hist[n]
599 599 # skip plain 'r' lines so we don't recurse to infinity
600 600 if input != '_ip.magic("r")\n' and \
601 601 (input.startswith(start) or input.startswith(start_magic)):
602 602 #print 'match',`input` # dbg
603 603 print 'Executing:',input,
604 604 self.shell.runlines(input)
605 605 return
606 606 print 'No previous input matching `%s` found.' % start
607 607
608 608 def magic_page(self, parameter_s=''):
609 609 """Pretty print the object and display it through a pager.
610 610
611 611 If no parameter is given, use _ (last output)."""
612 612 # After a function contributed by Olivier Aubert, slightly modified.
613 613
614 614 oname = parameter_s and parameter_s or '_'
615 615 info = self._ofind(oname)
616 616 if info['found']:
617 617 page(pformat(info['obj']))
618 618 else:
619 619 print 'Object `%s` not found' % oname
620 620
621 621 def magic_profile(self, parameter_s=''):
622 622 """Print your currently active IPyhton profile."""
623 623 if self.shell.rc.profile:
624 624 printpl('Current IPython profile: $self.shell.rc.profile.')
625 625 else:
626 626 print 'No profile active.'
627 627
628 628 def _inspect(self,meth,oname,**kw):
629 629 """Generic interface to the inspector system.
630 630
631 631 This function is meant to be called by pdef, pdoc & friends."""
632 632
633 633 oname = oname.strip()
634 634 info = Struct(self._ofind(oname))
635 635 if info.found:
636 636 pmethod = getattr(self.shell.inspector,meth)
637 637 formatter = info.ismagic and self.format_screen or None
638 638 if meth == 'pdoc':
639 639 pmethod(info.obj,oname,formatter)
640 640 elif meth == 'pinfo':
641 641 pmethod(info.obj,oname,formatter,info,**kw)
642 642 else:
643 643 pmethod(info.obj,oname)
644 644 else:
645 645 print 'Object `%s` not found.' % oname
646 646 return 'not found' # so callers can take other action
647 647
648 648 def magic_pdef(self, parameter_s=''):
649 649 """Print the definition header for any callable object.
650 650
651 651 If the object is a class, print the constructor information."""
652 652 self._inspect('pdef',parameter_s)
653 653
654 654 def magic_pdoc(self, parameter_s=''):
655 655 """Print the docstring for an object.
656 656
657 657 If the given object is a class, it will print both the class and the
658 658 constructor docstrings."""
659 659 self._inspect('pdoc',parameter_s)
660 660
661 661 def magic_psource(self, parameter_s=''):
662 662 """Print (or run through pager) the source code for an object."""
663 663 self._inspect('psource',parameter_s)
664 664
665 665 def magic_pfile(self, parameter_s=''):
666 666 """Print (or run through pager) the file where an object is defined.
667 667
668 668 The file opens at the line where the object definition begins. IPython
669 669 will honor the environment variable PAGER if set, and otherwise will
670 670 do its best to print the file in a convenient form.
671 671
672 672 If the given argument is not an object currently defined, IPython will
673 673 try to interpret it as a filename (automatically adding a .py extension
674 674 if needed). You can thus use %pfile as a syntax highlighting code
675 675 viewer."""
676 676
677 677 # first interpret argument as an object name
678 678 out = self._inspect('pfile',parameter_s)
679 679 # if not, try the input as a filename
680 680 if out == 'not found':
681 681 try:
682 682 filename = get_py_filename(parameter_s)
683 683 except IOError,msg:
684 684 print msg
685 685 return
686 686 page(self.shell.inspector.format(file(filename).read()))
687 687
688 688 def magic_pinfo(self, parameter_s=''):
689 689 """Provide detailed information about an object.
690 690
691 691 '%pinfo object' is just a synonym for object? or ?object."""
692 692
693 693 #print 'pinfo par: <%s>' % parameter_s # dbg
694 694
695 695 # detail_level: 0 -> obj? , 1 -> obj??
696 696 detail_level = 0
697 697 # We need to detect if we got called as 'pinfo pinfo foo', which can
698 698 # happen if the user types 'pinfo foo?' at the cmd line.
699 699 pinfo,qmark1,oname,qmark2 = \
700 700 re.match('(pinfo )?(\?*)(.*?)(\??$)',parameter_s).groups()
701 701 if pinfo or qmark1 or qmark2:
702 702 detail_level = 1
703 703 if "*" in oname:
704 704 self.magic_psearch(oname)
705 705 else:
706 706 self._inspect('pinfo',oname,detail_level=detail_level)
707 707
708 708 def magic_psearch(self, parameter_s=''):
709 709 """Search for object in namespaces by wildcard.
710 710
711 711 %psearch [options] PATTERN [OBJECT TYPE]
712 712
713 713 Note: ? can be used as a synonym for %psearch, at the beginning or at
714 714 the end: both a*? and ?a* are equivalent to '%psearch a*'. Still, the
715 715 rest of the command line must be unchanged (options come first), so
716 716 for example the following forms are equivalent
717 717
718 718 %psearch -i a* function
719 719 -i a* function?
720 720 ?-i a* function
721 721
722 722 Arguments:
723 723
724 724 PATTERN
725 725
726 726 where PATTERN is a string containing * as a wildcard similar to its
727 727 use in a shell. The pattern is matched in all namespaces on the
728 728 search path. By default objects starting with a single _ are not
729 729 matched, many IPython generated objects have a single
730 730 underscore. The default is case insensitive matching. Matching is
731 731 also done on the attributes of objects and not only on the objects
732 732 in a module.
733 733
734 734 [OBJECT TYPE]
735 735
736 736 Is the name of a python type from the types module. The name is
737 737 given in lowercase without the ending type, ex. StringType is
738 738 written string. By adding a type here only objects matching the
739 739 given type are matched. Using all here makes the pattern match all
740 740 types (this is the default).
741 741
742 742 Options:
743 743
744 744 -a: makes the pattern match even objects whose names start with a
745 745 single underscore. These names are normally ommitted from the
746 746 search.
747 747
748 748 -i/-c: make the pattern case insensitive/sensitive. If neither of
749 749 these options is given, the default is read from your ipythonrc
750 750 file. The option name which sets this value is
751 751 'wildcards_case_sensitive'. If this option is not specified in your
752 752 ipythonrc file, IPython's internal default is to do a case sensitive
753 753 search.
754 754
755 755 -e/-s NAMESPACE: exclude/search a given namespace. The pattern you
756 756 specifiy can be searched in any of the following namespaces:
757 757 'builtin', 'user', 'user_global','internal', 'alias', where
758 758 'builtin' and 'user' are the search defaults. Note that you should
759 759 not use quotes when specifying namespaces.
760 760
761 761 'Builtin' contains the python module builtin, 'user' contains all
762 762 user data, 'alias' only contain the shell aliases and no python
763 763 objects, 'internal' contains objects used by IPython. The
764 764 'user_global' namespace is only used by embedded IPython instances,
765 765 and it contains module-level globals. You can add namespaces to the
766 766 search with -s or exclude them with -e (these options can be given
767 767 more than once).
768 768
769 769 Examples:
770 770
771 771 %psearch a* -> objects beginning with an a
772 772 %psearch -e builtin a* -> objects NOT in the builtin space starting in a
773 773 %psearch a* function -> all functions beginning with an a
774 774 %psearch re.e* -> objects beginning with an e in module re
775 775 %psearch r*.e* -> objects that start with e in modules starting in r
776 776 %psearch r*.* string -> all strings in modules beginning with r
777 777
778 778 Case sensitve search:
779 779
780 780 %psearch -c a* list all object beginning with lower case a
781 781
782 782 Show objects beginning with a single _:
783 783
784 784 %psearch -a _* list objects beginning with a single underscore"""
785 785
786 786 # default namespaces to be searched
787 787 def_search = ['user','builtin']
788 788
789 789 # Process options/args
790 790 opts,args = self.parse_options(parameter_s,'cias:e:',list_all=True)
791 791 opt = opts.get
792 792 shell = self.shell
793 793 psearch = shell.inspector.psearch
794 794
795 795 # select case options
796 796 if opts.has_key('i'):
797 797 ignore_case = True
798 798 elif opts.has_key('c'):
799 799 ignore_case = False
800 800 else:
801 801 ignore_case = not shell.rc.wildcards_case_sensitive
802 802
803 803 # Build list of namespaces to search from user options
804 804 def_search.extend(opt('s',[]))
805 805 ns_exclude = ns_exclude=opt('e',[])
806 806 ns_search = [nm for nm in def_search if nm not in ns_exclude]
807 807
808 808 # Call the actual search
809 809 try:
810 810 psearch(args,shell.ns_table,ns_search,
811 811 show_all=opt('a'),ignore_case=ignore_case)
812 812 except:
813 813 shell.showtraceback()
814 814
815 815 def magic_who_ls(self, parameter_s=''):
816 816 """Return a sorted list of all interactive variables.
817 817
818 818 If arguments are given, only variables of types matching these
819 819 arguments are returned."""
820 820
821 821 user_ns = self.shell.user_ns
822 822 internal_ns = self.shell.internal_ns
823 823 user_config_ns = self.shell.user_config_ns
824 824 out = []
825 825 typelist = parameter_s.split()
826 826
827 827 for i in user_ns:
828 828 if not (i.startswith('_') or i.startswith('_i')) \
829 829 and not (i in internal_ns or i in user_config_ns):
830 830 if typelist:
831 831 if type(user_ns[i]).__name__ in typelist:
832 832 out.append(i)
833 833 else:
834 834 out.append(i)
835 835 out.sort()
836 836 return out
837 837
838 838 def magic_who(self, parameter_s=''):
839 839 """Print all interactive variables, with some minimal formatting.
840 840
841 841 If any arguments are given, only variables whose type matches one of
842 842 these are printed. For example:
843 843
844 844 %who function str
845 845
846 846 will only list functions and strings, excluding all other types of
847 847 variables. To find the proper type names, simply use type(var) at a
848 848 command line to see how python prints type names. For example:
849 849
850 850 In [1]: type('hello')\\
851 851 Out[1]: <type 'str'>
852 852
853 853 indicates that the type name for strings is 'str'.
854 854
855 855 %who always excludes executed names loaded through your configuration
856 856 file and things which are internal to IPython.
857 857
858 858 This is deliberate, as typically you may load many modules and the
859 859 purpose of %who is to show you only what you've manually defined."""
860 860
861 861 varlist = self.magic_who_ls(parameter_s)
862 862 if not varlist:
863 863 print 'Interactive namespace is empty.'
864 864 return
865 865
866 866 # if we have variables, move on...
867 867
868 868 # stupid flushing problem: when prompts have no separators, stdout is
869 869 # getting lost. I'm starting to think this is a python bug. I'm having
870 870 # to force a flush with a print because even a sys.stdout.flush
871 871 # doesn't seem to do anything!
872 872
873 873 count = 0
874 874 for i in varlist:
875 875 print i+'\t',
876 876 count += 1
877 877 if count > 8:
878 878 count = 0
879 879 print
880 880 sys.stdout.flush() # FIXME. Why the hell isn't this flushing???
881 881
882 882 print # well, this does force a flush at the expense of an extra \n
883 883
884 884 def magic_whos(self, parameter_s=''):
885 885 """Like %who, but gives some extra information about each variable.
886 886
887 887 The same type filtering of %who can be applied here.
888 888
889 889 For all variables, the type is printed. Additionally it prints:
890 890
891 891 - For {},[],(): their length.
892 892
893 893 - For Numeric arrays, a summary with shape, number of elements,
894 894 typecode and size in memory.
895 895
896 896 - Everything else: a string representation, snipping their middle if
897 897 too long."""
898 898
899 899 varnames = self.magic_who_ls(parameter_s)
900 900 if not varnames:
901 901 print 'Interactive namespace is empty.'
902 902 return
903 903
904 904 # if we have variables, move on...
905 905
906 906 # for these types, show len() instead of data:
907 907 seq_types = [types.DictType,types.ListType,types.TupleType]
908 908
909 909 # for Numeric arrays, display summary info
910 910 try:
911 911 import Numeric
912 912 except ImportError:
913 913 array_type = None
914 914 else:
915 915 array_type = Numeric.ArrayType.__name__
916 916
917 917 # Find all variable names and types so we can figure out column sizes
918 918 get_vars = lambda i: self.shell.user_ns[i]
919 919 type_name = lambda v: type(v).__name__
920 920 varlist = map(get_vars,varnames)
921 921
922 922 typelist = []
923 923 for vv in varlist:
924 924 tt = type_name(vv)
925 925 if tt=='instance':
926 926 typelist.append(str(vv.__class__))
927 927 else:
928 928 typelist.append(tt)
929 929
930 930 # column labels and # of spaces as separator
931 931 varlabel = 'Variable'
932 932 typelabel = 'Type'
933 933 datalabel = 'Data/Info'
934 934 colsep = 3
935 935 # variable format strings
936 936 vformat = "$vname.ljust(varwidth)$vtype.ljust(typewidth)"
937 937 vfmt_short = '$vstr[:25]<...>$vstr[-25:]'
938 938 aformat = "%s: %s elems, type `%s`, %s bytes"
939 939 # find the size of the columns to format the output nicely
940 940 varwidth = max(max(map(len,varnames)), len(varlabel)) + colsep
941 941 typewidth = max(max(map(len,typelist)), len(typelabel)) + colsep
942 942 # table header
943 943 print varlabel.ljust(varwidth) + typelabel.ljust(typewidth) + \
944 944 ' '+datalabel+'\n' + '-'*(varwidth+typewidth+len(datalabel)+1)
945 945 # and the table itself
946 946 kb = 1024
947 947 Mb = 1048576 # kb**2
948 948 for vname,var,vtype in zip(varnames,varlist,typelist):
949 949 print itpl(vformat),
950 950 if vtype in seq_types:
951 951 print len(var)
952 952 elif vtype==array_type:
953 953 vshape = str(var.shape).replace(',','').replace(' ','x')[1:-1]
954 954 vsize = Numeric.size(var)
955 955 vbytes = vsize*var.itemsize()
956 956 if vbytes < 100000:
957 957 print aformat % (vshape,vsize,var.typecode(),vbytes)
958 958 else:
959 959 print aformat % (vshape,vsize,var.typecode(),vbytes),
960 960 if vbytes < Mb:
961 961 print '(%s kb)' % (vbytes/kb,)
962 962 else:
963 963 print '(%s Mb)' % (vbytes/Mb,)
964 964 else:
965 965 vstr = str(var).replace('\n','\\n')
966 966 if len(vstr) < 50:
967 967 print vstr
968 968 else:
969 969 printpl(vfmt_short)
970 970
971 971 def magic_reset(self, parameter_s=''):
972 972 """Resets the namespace by removing all names defined by the user.
973 973
974 974 Input/Output history are left around in case you need them."""
975 975
976 976 ans = raw_input(
977 977 "Once deleted, variables cannot be recovered. Proceed (y/n)? ")
978 978 if not ans.lower() == 'y':
979 979 print 'Nothing done.'
980 980 return
981 981 user_ns = self.shell.user_ns
982 982 for i in self.magic_who_ls():
983 983 del(user_ns[i])
984 984
985 985 def magic_config(self,parameter_s=''):
986 986 """Show IPython's internal configuration."""
987 987
988 988 page('Current configuration structure:\n'+
989 989 pformat(self.shell.rc.dict()))
990 990
991 991 def magic_logstart(self,parameter_s=''):
992 992 """Start logging anywhere in a session.
993 993
994 994 %logstart [-o|-r|-t] [log_name [log_mode]]
995 995
996 996 If no name is given, it defaults to a file named 'ipython_log.py' in your
997 997 current directory, in 'rotate' mode (see below).
998 998
999 999 '%logstart name' saves to file 'name' in 'backup' mode. It saves your
1000 1000 history up to that point and then continues logging.
1001 1001
1002 1002 %logstart takes a second optional parameter: logging mode. This can be one
1003 1003 of (note that the modes are given unquoted):\\
1004 1004 append: well, that says it.\\
1005 1005 backup: rename (if exists) to name~ and start name.\\
1006 1006 global: single logfile in your home dir, appended to.\\
1007 1007 over : overwrite existing log.\\
1008 1008 rotate: create rotating logs name.1~, name.2~, etc.
1009 1009
1010 1010 Options:
1011 1011
1012 1012 -o: log also IPython's output. In this mode, all commands which
1013 1013 generate an Out[NN] prompt are recorded to the logfile, right after
1014 1014 their corresponding input line. The output lines are always
1015 1015 prepended with a '#[Out]# ' marker, so that the log remains valid
1016 1016 Python code.
1017 1017
1018 1018 Since this marker is always the same, filtering only the output from
1019 1019 a log is very easy, using for example a simple awk call:
1020 1020
1021 1021 awk -F'#\\[Out\\]# ' '{if($2) {print $2}}' ipython_log.py
1022 1022
1023 1023 -r: log 'raw' input. Normally, IPython's logs contain the processed
1024 1024 input, so that user lines are logged in their final form, converted
1025 1025 into valid Python. For example, %Exit is logged as
1026 1026 '_ip.magic("Exit"). If the -r flag is given, all input is logged
1027 1027 exactly as typed, with no transformations applied.
1028 1028
1029 1029 -t: put timestamps before each input line logged (these are put in
1030 1030 comments)."""
1031 1031
1032 1032 opts,par = self.parse_options(parameter_s,'ort')
1033 1033 log_output = 'o' in opts
1034 1034 log_raw_input = 'r' in opts
1035 1035 timestamp = 't' in opts
1036 1036
1037 1037 rc = self.shell.rc
1038 1038 logger = self.shell.logger
1039 1039
1040 1040 # if no args are given, the defaults set in the logger constructor by
1041 1041 # ipytohn remain valid
1042 1042 if par:
1043 1043 try:
1044 1044 logfname,logmode = par.split()
1045 1045 except:
1046 1046 logfname = par
1047 1047 logmode = 'backup'
1048 1048 else:
1049 1049 logfname = logger.logfname
1050 1050 logmode = logger.logmode
1051 1051 # put logfname into rc struct as if it had been called on the command
1052 1052 # line, so it ends up saved in the log header Save it in case we need
1053 1053 # to restore it...
1054 1054 old_logfile = rc.opts.get('logfile','')
1055 1055 if logfname:
1056 1056 logfname = os.path.expanduser(logfname)
1057 1057 rc.opts.logfile = logfname
1058 1058 loghead = self.shell.loghead_tpl % (rc.opts,rc.args)
1059 1059 try:
1060 1060 started = logger.logstart(logfname,loghead,logmode,
1061 1061 log_output,timestamp,log_raw_input)
1062 1062 except:
1063 1063 rc.opts.logfile = old_logfile
1064 1064 warn("Couldn't start log: %s" % sys.exc_info()[1])
1065 1065 else:
1066 1066 # log input history up to this point, optionally interleaving
1067 1067 # output if requested
1068 1068
1069 1069 if timestamp:
1070 1070 # disable timestamping for the previous history, since we've
1071 1071 # lost those already (no time machine here).
1072 1072 logger.timestamp = False
1073 1073
1074 1074 if log_raw_input:
1075 1075 input_hist = self.shell.input_hist_raw
1076 1076 else:
1077 1077 input_hist = self.shell.input_hist
1078 1078
1079 1079 if log_output:
1080 1080 log_write = logger.log_write
1081 1081 output_hist = self.shell.output_hist
1082 1082 for n in range(1,len(input_hist)-1):
1083 1083 log_write(input_hist[n].rstrip())
1084 1084 if n in output_hist:
1085 1085 log_write(repr(output_hist[n]),'output')
1086 1086 else:
1087 1087 logger.log_write(input_hist[1:])
1088 1088 if timestamp:
1089 1089 # re-enable timestamping
1090 1090 logger.timestamp = True
1091 1091
1092 1092 print ('Activating auto-logging. '
1093 1093 'Current session state plus future input saved.')
1094 1094 logger.logstate()
1095 1095
1096 1096 def magic_logoff(self,parameter_s=''):
1097 1097 """Temporarily stop logging.
1098 1098
1099 1099 You must have previously started logging."""
1100 1100 self.shell.logger.switch_log(0)
1101 1101
1102 1102 def magic_logon(self,parameter_s=''):
1103 1103 """Restart logging.
1104 1104
1105 1105 This function is for restarting logging which you've temporarily
1106 1106 stopped with %logoff. For starting logging for the first time, you
1107 1107 must use the %logstart function, which allows you to specify an
1108 1108 optional log filename."""
1109 1109
1110 1110 self.shell.logger.switch_log(1)
1111 1111
1112 1112 def magic_logstate(self,parameter_s=''):
1113 1113 """Print the status of the logging system."""
1114 1114
1115 1115 self.shell.logger.logstate()
1116 1116
1117 1117 def magic_pdb(self, parameter_s=''):
1118 1118 """Control the calling of the pdb interactive debugger.
1119 1119
1120 1120 Call as '%pdb on', '%pdb 1', '%pdb off' or '%pdb 0'. If called without
1121 1121 argument it works as a toggle.
1122 1122
1123 1123 When an exception is triggered, IPython can optionally call the
1124 1124 interactive pdb debugger after the traceback printout. %pdb toggles
1125 1125 this feature on and off."""
1126 1126
1127 1127 par = parameter_s.strip().lower()
1128 1128
1129 1129 if par:
1130 1130 try:
1131 1131 new_pdb = {'off':0,'0':0,'on':1,'1':1}[par]
1132 1132 except KeyError:
1133 1133 print ('Incorrect argument. Use on/1, off/0, '
1134 1134 'or nothing for a toggle.')
1135 1135 return
1136 1136 else:
1137 1137 # toggle
1138 1138 new_pdb = not self.shell.InteractiveTB.call_pdb
1139 1139
1140 1140 # set on the shell
1141 1141 self.shell.call_pdb = new_pdb
1142 1142 print 'Automatic pdb calling has been turned',on_off(new_pdb)
1143 1143
1144 1144 def magic_prun(self, parameter_s ='',user_mode=1,
1145 1145 opts=None,arg_lst=None,prog_ns=None):
1146 1146
1147 1147 """Run a statement through the python code profiler.
1148 1148
1149 1149 Usage:\\
1150 1150 %prun [options] statement
1151 1151
1152 1152 The given statement (which doesn't require quote marks) is run via the
1153 1153 python profiler in a manner similar to the profile.run() function.
1154 1154 Namespaces are internally managed to work correctly; profile.run
1155 1155 cannot be used in IPython because it makes certain assumptions about
1156 1156 namespaces which do not hold under IPython.
1157 1157
1158 1158 Options:
1159 1159
1160 1160 -l <limit>: you can place restrictions on what or how much of the
1161 1161 profile gets printed. The limit value can be:
1162 1162
1163 1163 * A string: only information for function names containing this string
1164 1164 is printed.
1165 1165
1166 1166 * An integer: only these many lines are printed.
1167 1167
1168 1168 * A float (between 0 and 1): this fraction of the report is printed
1169 1169 (for example, use a limit of 0.4 to see the topmost 40% only).
1170 1170
1171 1171 You can combine several limits with repeated use of the option. For
1172 1172 example, '-l __init__ -l 5' will print only the topmost 5 lines of
1173 1173 information about class constructors.
1174 1174
1175 1175 -r: return the pstats.Stats object generated by the profiling. This
1176 1176 object has all the information about the profile in it, and you can
1177 1177 later use it for further analysis or in other functions.
1178 1178
1179 1179 Since magic functions have a particular form of calling which prevents
1180 1180 you from writing something like:\\
1181 1181 In [1]: p = %prun -r print 4 # invalid!\\
1182 1182 you must instead use IPython's automatic variables to assign this:\\
1183 1183 In [1]: %prun -r print 4 \\
1184 1184 Out[1]: <pstats.Stats instance at 0x8222cec>\\
1185 1185 In [2]: stats = _
1186 1186
1187 1187 If you really need to assign this value via an explicit function call,
1188 1188 you can always tap directly into the true name of the magic function
1189 1189 by using the _ip.magic function:\\
1190 1190 In [3]: stats = _ip.magic('prun','-r print 4')
1191 1191
1192 1192 You can type _ip.magic? for more details.
1193 1193
1194 1194 -s <key>: sort profile by given key. You can provide more than one key
1195 1195 by using the option several times: '-s key1 -s key2 -s key3...'. The
1196 1196 default sorting key is 'time'.
1197 1197
1198 1198 The following is copied verbatim from the profile documentation
1199 1199 referenced below:
1200 1200
1201 1201 When more than one key is provided, additional keys are used as
1202 1202 secondary criteria when the there is equality in all keys selected
1203 1203 before them.
1204 1204
1205 1205 Abbreviations can be used for any key names, as long as the
1206 1206 abbreviation is unambiguous. The following are the keys currently
1207 1207 defined:
1208 1208
1209 1209 Valid Arg Meaning\\
1210 1210 "calls" call count\\
1211 1211 "cumulative" cumulative time\\
1212 1212 "file" file name\\
1213 1213 "module" file name\\
1214 1214 "pcalls" primitive call count\\
1215 1215 "line" line number\\
1216 1216 "name" function name\\
1217 1217 "nfl" name/file/line\\
1218 1218 "stdname" standard name\\
1219 1219 "time" internal time
1220 1220
1221 1221 Note that all sorts on statistics are in descending order (placing
1222 1222 most time consuming items first), where as name, file, and line number
1223 1223 searches are in ascending order (i.e., alphabetical). The subtle
1224 1224 distinction between "nfl" and "stdname" is that the standard name is a
1225 1225 sort of the name as printed, which means that the embedded line
1226 1226 numbers get compared in an odd way. For example, lines 3, 20, and 40
1227 1227 would (if the file names were the same) appear in the string order
1228 1228 "20" "3" and "40". In contrast, "nfl" does a numeric compare of the
1229 1229 line numbers. In fact, sort_stats("nfl") is the same as
1230 1230 sort_stats("name", "file", "line").
1231 1231
1232 1232 -T <filename>: save profile results as shown on screen to a text
1233 1233 file. The profile is still shown on screen.
1234 1234
1235 1235 -D <filename>: save (via dump_stats) profile statistics to given
1236 1236 filename. This data is in a format understod by the pstats module, and
1237 1237 is generated by a call to the dump_stats() method of profile
1238 1238 objects. The profile is still shown on screen.
1239 1239
1240 1240 If you want to run complete programs under the profiler's control, use
1241 1241 '%run -p [prof_opts] filename.py [args to program]' where prof_opts
1242 1242 contains profiler specific options as described here.
1243 1243
1244 1244 You can read the complete documentation for the profile module with:\\
1245 1245 In [1]: import profile; profile.help() """
1246 1246
1247 1247 opts_def = Struct(D=[''],l=[],s=['time'],T=[''])
1248 1248 # protect user quote marks
1249 1249 parameter_s = parameter_s.replace('"',r'\"').replace("'",r"\'")
1250 1250
1251 1251 if user_mode: # regular user call
1252 1252 opts,arg_str = self.parse_options(parameter_s,'D:l:rs:T:',
1253 1253 list_all=1)
1254 1254 namespace = self.shell.user_ns
1255 1255 else: # called to run a program by %run -p
1256 1256 try:
1257 1257 filename = get_py_filename(arg_lst[0])
1258 1258 except IOError,msg:
1259 1259 error(msg)
1260 1260 return
1261 1261
1262 1262 arg_str = 'execfile(filename,prog_ns)'
1263 1263 namespace = locals()
1264 1264
1265 1265 opts.merge(opts_def)
1266 1266
1267 1267 prof = profile.Profile()
1268 1268 try:
1269 1269 prof = prof.runctx(arg_str,namespace,namespace)
1270 1270 sys_exit = ''
1271 1271 except SystemExit:
1272 1272 sys_exit = """*** SystemExit exception caught in code being profiled."""
1273 1273
1274 1274 stats = pstats.Stats(prof).strip_dirs().sort_stats(*opts.s)
1275 1275
1276 1276 lims = opts.l
1277 1277 if lims:
1278 1278 lims = [] # rebuild lims with ints/floats/strings
1279 1279 for lim in opts.l:
1280 1280 try:
1281 1281 lims.append(int(lim))
1282 1282 except ValueError:
1283 1283 try:
1284 1284 lims.append(float(lim))
1285 1285 except ValueError:
1286 1286 lims.append(lim)
1287 1287
1288 1288 # trap output
1289 1289 sys_stdout = sys.stdout
1290 1290 stdout_trap = StringIO()
1291 1291 try:
1292 1292 sys.stdout = stdout_trap
1293 1293 stats.print_stats(*lims)
1294 1294 finally:
1295 1295 sys.stdout = sys_stdout
1296 1296 output = stdout_trap.getvalue()
1297 1297 output = output.rstrip()
1298 1298
1299 1299 page(output,screen_lines=self.shell.rc.screen_length)
1300 1300 print sys_exit,
1301 1301
1302 1302 dump_file = opts.D[0]
1303 1303 text_file = opts.T[0]
1304 1304 if dump_file:
1305 1305 prof.dump_stats(dump_file)
1306 1306 print '\n*** Profile stats marshalled to file',\
1307 1307 `dump_file`+'.',sys_exit
1308 1308 if text_file:
1309 1309 file(text_file,'w').write(output)
1310 1310 print '\n*** Profile printout saved to text file',\
1311 1311 `text_file`+'.',sys_exit
1312 1312
1313 1313 if opts.has_key('r'):
1314 1314 return stats
1315 1315 else:
1316 1316 return None
1317 1317
1318 1318 def magic_run(self, parameter_s ='',runner=None):
1319 1319 """Run the named file inside IPython as a program.
1320 1320
1321 1321 Usage:\\
1322 1322 %run [-n -i -t [-N<N>] -d [-b<N>] -p [profile options]] file [args]
1323 1323
1324 1324 Parameters after the filename are passed as command-line arguments to
1325 1325 the program (put in sys.argv). Then, control returns to IPython's
1326 1326 prompt.
1327 1327
1328 1328 This is similar to running at a system prompt:\\
1329 1329 $ python file args\\
1330 1330 but with the advantage of giving you IPython's tracebacks, and of
1331 1331 loading all variables into your interactive namespace for further use
1332 1332 (unless -p is used, see below).
1333 1333
1334 1334 The file is executed in a namespace initially consisting only of
1335 1335 __name__=='__main__' and sys.argv constructed as indicated. It thus
1336 1336 sees its environment as if it were being run as a stand-alone
1337 1337 program. But after execution, the IPython interactive namespace gets
1338 1338 updated with all variables defined in the program (except for __name__
1339 1339 and sys.argv). This allows for very convenient loading of code for
1340 1340 interactive work, while giving each program a 'clean sheet' to run in.
1341 1341
1342 1342 Options:
1343 1343
1344 1344 -n: __name__ is NOT set to '__main__', but to the running file's name
1345 1345 without extension (as python does under import). This allows running
1346 1346 scripts and reloading the definitions in them without calling code
1347 1347 protected by an ' if __name__ == "__main__" ' clause.
1348 1348
1349 1349 -i: run the file in IPython's namespace instead of an empty one. This
1350 1350 is useful if you are experimenting with code written in a text editor
1351 1351 which depends on variables defined interactively.
1352 1352
1353 1353 -e: ignore sys.exit() calls or SystemExit exceptions in the script
1354 1354 being run. This is particularly useful if IPython is being used to
1355 1355 run unittests, which always exit with a sys.exit() call. In such
1356 1356 cases you are interested in the output of the test results, not in
1357 1357 seeing a traceback of the unittest module.
1358 1358
1359 1359 -t: print timing information at the end of the run. IPython will give
1360 1360 you an estimated CPU time consumption for your script, which under
1361 1361 Unix uses the resource module to avoid the wraparound problems of
1362 1362 time.clock(). Under Unix, an estimate of time spent on system tasks
1363 1363 is also given (for Windows platforms this is reported as 0.0).
1364 1364
1365 1365 If -t is given, an additional -N<N> option can be given, where <N>
1366 1366 must be an integer indicating how many times you want the script to
1367 1367 run. The final timing report will include total and per run results.
1368 1368
1369 1369 For example (testing the script uniq_stable.py):
1370 1370
1371 1371 In [1]: run -t uniq_stable
1372 1372
1373 1373 IPython CPU timings (estimated):\\
1374 1374 User : 0.19597 s.\\
1375 1375 System: 0.0 s.\\
1376 1376
1377 1377 In [2]: run -t -N5 uniq_stable
1378 1378
1379 1379 IPython CPU timings (estimated):\\
1380 1380 Total runs performed: 5\\
1381 1381 Times : Total Per run\\
1382 1382 User : 0.910862 s, 0.1821724 s.\\
1383 1383 System: 0.0 s, 0.0 s.
1384 1384
1385 1385 -d: run your program under the control of pdb, the Python debugger.
1386 1386 This allows you to execute your program step by step, watch variables,
1387 1387 etc. Internally, what IPython does is similar to calling:
1388 1388
1389 1389 pdb.run('execfile("YOURFILENAME")')
1390 1390
1391 1391 with a breakpoint set on line 1 of your file. You can change the line
1392 1392 number for this automatic breakpoint to be <N> by using the -bN option
1393 1393 (where N must be an integer). For example:
1394 1394
1395 1395 %run -d -b40 myscript
1396 1396
1397 1397 will set the first breakpoint at line 40 in myscript.py. Note that
1398 1398 the first breakpoint must be set on a line which actually does
1399 1399 something (not a comment or docstring) for it to stop execution.
1400 1400
1401 1401 When the pdb debugger starts, you will see a (Pdb) prompt. You must
1402 1402 first enter 'c' (without qoutes) to start execution up to the first
1403 1403 breakpoint.
1404 1404
1405 1405 Entering 'help' gives information about the use of the debugger. You
1406 1406 can easily see pdb's full documentation with "import pdb;pdb.help()"
1407 1407 at a prompt.
1408 1408
1409 1409 -p: run program under the control of the Python profiler module (which
1410 1410 prints a detailed report of execution times, function calls, etc).
1411 1411
1412 1412 You can pass other options after -p which affect the behavior of the
1413 1413 profiler itself. See the docs for %prun for details.
1414 1414
1415 1415 In this mode, the program's variables do NOT propagate back to the
1416 1416 IPython interactive namespace (because they remain in the namespace
1417 1417 where the profiler executes them).
1418 1418
1419 1419 Internally this triggers a call to %prun, see its documentation for
1420 1420 details on the options available specifically for profiling."""
1421 1421
1422 1422 # get arguments and set sys.argv for program to be run.
1423 1423 opts,arg_lst = self.parse_options(parameter_s,'nidtN:b:pD:l:rs:T:e',
1424 1424 mode='list',list_all=1)
1425 1425
1426 1426 try:
1427 1427 filename = get_py_filename(arg_lst[0])
1428 1428 except IndexError:
1429 1429 warn('you must provide at least a filename.')
1430 1430 print '\n%run:\n',OInspect.getdoc(self.magic_run)
1431 1431 return
1432 1432 except IOError,msg:
1433 1433 error(msg)
1434 1434 return
1435 1435
1436 1436 # Control the response to exit() calls made by the script being run
1437 1437 exit_ignore = opts.has_key('e')
1438 1438
1439 1439 # Make sure that the running script gets a proper sys.argv as if it
1440 1440 # were run from a system shell.
1441 1441 save_argv = sys.argv # save it for later restoring
1442 1442 sys.argv = [filename]+ arg_lst[1:] # put in the proper filename
1443 1443
1444 1444 if opts.has_key('i'):
1445 1445 prog_ns = self.shell.user_ns
1446 1446 __name__save = self.shell.user_ns['__name__']
1447 1447 prog_ns['__name__'] = '__main__'
1448 1448 else:
1449 1449 if opts.has_key('n'):
1450 1450 name = os.path.splitext(os.path.basename(filename))[0]
1451 1451 else:
1452 1452 name = '__main__'
1453 1453 prog_ns = {'__name__':name}
1454 1454
1455 1455 # Since '%run foo' emulates 'python foo.py' at the cmd line, we must
1456 1456 # set the __file__ global in the script's namespace
1457 1457 prog_ns['__file__'] = filename
1458 1458
1459 1459 # pickle fix. See iplib for an explanation. But we need to make sure
1460 1460 # that, if we overwrite __main__, we replace it at the end
1461 1461 if prog_ns['__name__'] == '__main__':
1462 1462 restore_main = sys.modules['__main__']
1463 1463 else:
1464 1464 restore_main = False
1465 1465
1466 1466 sys.modules[prog_ns['__name__']] = FakeModule(prog_ns)
1467 1467
1468 1468 stats = None
1469 1469 try:
1470 1470 if opts.has_key('p'):
1471 1471 stats = self.magic_prun('',0,opts,arg_lst,prog_ns)
1472 1472 else:
1473 1473 if opts.has_key('d'):
1474 1474 deb = Debugger.Pdb(self.shell.rc.colors)
1475 1475 # reset Breakpoint state, which is moronically kept
1476 1476 # in a class
1477 1477 bdb.Breakpoint.next = 1
1478 1478 bdb.Breakpoint.bplist = {}
1479 1479 bdb.Breakpoint.bpbynumber = [None]
1480 1480 # Set an initial breakpoint to stop execution
1481 1481 maxtries = 10
1482 1482 bp = int(opts.get('b',[1])[0])
1483 1483 checkline = deb.checkline(filename,bp)
1484 1484 if not checkline:
1485 1485 for bp in range(bp+1,bp+maxtries+1):
1486 1486 if deb.checkline(filename,bp):
1487 1487 break
1488 1488 else:
1489 1489 msg = ("\nI failed to find a valid line to set "
1490 1490 "a breakpoint\n"
1491 1491 "after trying up to line: %s.\n"
1492 1492 "Please set a valid breakpoint manually "
1493 1493 "with the -b option." % bp)
1494 1494 error(msg)
1495 1495 return
1496 1496 # if we find a good linenumber, set the breakpoint
1497 1497 deb.do_break('%s:%s' % (filename,bp))
1498 1498 # Start file run
1499 1499 print "NOTE: Enter 'c' at the",
1500 1500 print "ipdb> prompt to start your script."
1501 1501 try:
1502 1502 deb.run('execfile("%s")' % filename,prog_ns)
1503 1503 except:
1504 1504 etype, value, tb = sys.exc_info()
1505 1505 # Skip three frames in the traceback: the %run one,
1506 1506 # one inside bdb.py, and the command-line typed by the
1507 1507 # user (run by exec in pdb itself).
1508 1508 self.shell.InteractiveTB(etype,value,tb,tb_offset=3)
1509 1509 else:
1510 1510 if runner is None:
1511 1511 runner = self.shell.safe_execfile
1512 1512 if opts.has_key('t'):
1513 1513 try:
1514 1514 nruns = int(opts['N'][0])
1515 1515 if nruns < 1:
1516 1516 error('Number of runs must be >=1')
1517 1517 return
1518 1518 except (KeyError):
1519 1519 nruns = 1
1520 1520 if nruns == 1:
1521 1521 t0 = clock2()
1522 1522 runner(filename,prog_ns,prog_ns,exit_ignore=exit_ignore)
1523 1523 t1 = clock2()
1524 1524 t_usr = t1[0]-t0[0]
1525 1525 t_sys = t1[1]-t1[1]
1526 1526 print "\nIPython CPU timings (estimated):"
1527 1527 print " User : %10s s." % t_usr
1528 1528 print " System: %10s s." % t_sys
1529 1529 else:
1530 1530 runs = range(nruns)
1531 1531 t0 = clock2()
1532 1532 for nr in runs:
1533 1533 runner(filename,prog_ns,prog_ns,exit_ignore=exit_ignore)
1534 1534 t1 = clock2()
1535 1535 t_usr = t1[0]-t0[0]
1536 1536 t_sys = t1[1]-t1[1]
1537 1537 print "\nIPython CPU timings (estimated):"
1538 1538 print "Total runs performed:",nruns
1539 1539 print " Times : %10s %10s" % ('Total','Per run')
1540 1540 print " User : %10s s, %10s s." % (t_usr,t_usr/nruns)
1541 1541 print " System: %10s s, %10s s." % (t_sys,t_sys/nruns)
1542 1542
1543 1543 else:
1544 1544 runner(filename,prog_ns,prog_ns,exit_ignore=exit_ignore)
1545 1545 if opts.has_key('i'):
1546 1546 self.shell.user_ns['__name__'] = __name__save
1547 1547 else:
1548 1548 # update IPython interactive namespace
1549 1549 del prog_ns['__name__']
1550 1550 self.shell.user_ns.update(prog_ns)
1551 1551 finally:
1552 1552 sys.argv = save_argv
1553 1553 if restore_main:
1554 1554 sys.modules['__main__'] = restore_main
1555 1555 return stats
1556 1556
1557 1557 def magic_runlog(self, parameter_s =''):
1558 1558 """Run files as logs.
1559 1559
1560 1560 Usage:\\
1561 1561 %runlog file1 file2 ...
1562 1562
1563 1563 Run the named files (treating them as log files) in sequence inside
1564 1564 the interpreter, and return to the prompt. This is much slower than
1565 1565 %run because each line is executed in a try/except block, but it
1566 1566 allows running files with syntax errors in them.
1567 1567
1568 1568 Normally IPython will guess when a file is one of its own logfiles, so
1569 1569 you can typically use %run even for logs. This shorthand allows you to
1570 1570 force any file to be treated as a log file."""
1571 1571
1572 1572 for f in parameter_s.split():
1573 1573 self.shell.safe_execfile(f,self.shell.user_ns,
1574 1574 self.shell.user_ns,islog=1)
1575 1575
1576 1576 def magic_timeit(self, parameter_s =''):
1577 1577 """Time execution of a Python statement or expression
1578 1578
1579 1579 Usage:\\
1580 1580 %timeit [-n<N> -r<R> [-t|-c]] statement
1581 1581
1582 1582 Time execution of a Python statement or expression using the timeit
1583 1583 module.
1584 1584
1585 1585 Options:
1586 1586 -n<N>: execute the given statement <N> times in a loop. If this value
1587 1587 is not given, a fitting value is chosen.
1588 1588
1589 1589 -r<R>: repeat the loop iteration <R> times and take the best result.
1590 1590 Default: 3
1591 1591
1592 1592 -t: use time.time to measure the time, which is the default on Unix.
1593 1593 This function measures wall time.
1594 1594
1595 1595 -c: use time.clock to measure the time, which is the default on
1596 1596 Windows and measures wall time. On Unix, resource.getrusage is used
1597 1597 instead and returns the CPU user time.
1598 1598
1599 1599 -p<P>: use a precision of <P> digits to display the timing result.
1600 1600 Default: 3
1601 1601
1602 1602
1603 1603 Examples:\\
1604 1604 In [1]: %timeit pass
1605 1605 10000000 loops, best of 3: 53.3 ns per loop
1606 1606
1607 1607 In [2]: u = None
1608 1608
1609 1609 In [3]: %timeit u is None
1610 1610 10000000 loops, best of 3: 184 ns per loop
1611 1611
1612 1612 In [4]: %timeit -r 4 u == None
1613 1613 1000000 loops, best of 4: 242 ns per loop
1614 1614
1615 1615 In [5]: import time
1616 1616
1617 1617 In [6]: %timeit -n1 time.sleep(2)
1618 1618 1 loops, best of 3: 2 s per loop
1619 1619
1620 1620
1621 1621 The times reported by %timeit will be slightly higher than those reported
1622 1622 by the timeit.py script when variables are accessed. This is due to the
1623 1623 fact that %timeit executes the statement in the namespace of the shell,
1624 1624 compared with timeit.py, which uses a single setup statement to import
1625 1625 function or create variables. Generally, the bias does not matter as long
1626 1626 as results from timeit.py are not mixed with those from %timeit."""
1627 1627 import timeit
1628 1628 import math
1629 1629
1630 1630 units = ["s", "ms", "\xc2\xb5s", "ns"]
1631 1631 scaling = [1, 1e3, 1e6, 1e9]
1632 1632
1633 1633 opts, stmt = self.parse_options(parameter_s,'n:r:tcp:')
1634 1634 if stmt == "":
1635 1635 return
1636 1636 timefunc = timeit.default_timer
1637 1637 number = int(getattr(opts, "n", 0))
1638 1638 repeat = int(getattr(opts, "r", timeit.default_repeat))
1639 1639 precision = int(getattr(opts, "p", 3))
1640 1640 if hasattr(opts, "t"):
1641 1641 timefunc = time.time
1642 1642 if hasattr(opts, "c"):
1643 1643 timefunc = clock
1644 1644
1645 1645 timer = timeit.Timer(timer=timefunc)
1646 1646 # this code has tight coupling to the inner workings of timeit.Timer,
1647 1647 # but is there a better way to achieve that the code stmt has access
1648 1648 # to the shell namespace?
1649 1649
1650 1650 src = timeit.template % {'stmt': timeit.reindent(stmt, 8), 'setup': "pass"}
1651 1651 code = compile(src, "<magic-timeit>", "exec")
1652 1652 ns = {}
1653 1653 exec code in self.shell.user_ns, ns
1654 1654 timer.inner = ns["inner"]
1655 1655
1656 1656 if number == 0:
1657 1657 # determine number so that 0.2 <= total time < 2.0
1658 1658 number = 1
1659 1659 for i in range(1, 10):
1660 1660 number *= 10
1661 1661 if timer.timeit(number) >= 0.2:
1662 1662 break
1663 1663
1664 1664 best = min(timer.repeat(repeat, number)) / number
1665 1665
1666 1666 if best > 0.0:
1667 1667 order = min(-int(math.floor(math.log10(best)) // 3), 3)
1668 1668 else:
1669 1669 order = 3
1670 1670 print "%d loops, best of %d: %.*g %s per loop" % (number, repeat,
1671 1671 precision,
1672 1672 best * scaling[order],
1673 1673 units[order])
1674 1674
1675 1675 def magic_time(self,parameter_s = ''):
1676 1676 """Time execution of a Python statement or expression.
1677 1677
1678 1678 The CPU and wall clock times are printed, and the value of the
1679 1679 expression (if any) is returned. Note that under Win32, system time
1680 1680 is always reported as 0, since it can not be measured.
1681 1681
1682 1682 This function provides very basic timing functionality. In Python
1683 1683 2.3, the timeit module offers more control and sophistication, so this
1684 1684 could be rewritten to use it (patches welcome).
1685 1685
1686 1686 Some examples:
1687 1687
1688 1688 In [1]: time 2**128
1689 1689 CPU times: user 0.00 s, sys: 0.00 s, total: 0.00 s
1690 1690 Wall time: 0.00
1691 1691 Out[1]: 340282366920938463463374607431768211456L
1692 1692
1693 1693 In [2]: n = 1000000
1694 1694
1695 1695 In [3]: time sum(range(n))
1696 1696 CPU times: user 1.20 s, sys: 0.05 s, total: 1.25 s
1697 1697 Wall time: 1.37
1698 1698 Out[3]: 499999500000L
1699 1699
1700 1700 In [4]: time print 'hello world'
1701 1701 hello world
1702 1702 CPU times: user 0.00 s, sys: 0.00 s, total: 0.00 s
1703 1703 Wall time: 0.00
1704 1704 """
1705 1705
1706 1706 # fail immediately if the given expression can't be compiled
1707 1707 try:
1708 1708 mode = 'eval'
1709 1709 code = compile(parameter_s,'<timed eval>',mode)
1710 1710 except SyntaxError:
1711 1711 mode = 'exec'
1712 1712 code = compile(parameter_s,'<timed exec>',mode)
1713 1713 # skew measurement as little as possible
1714 1714 glob = self.shell.user_ns
1715 1715 clk = clock2
1716 1716 wtime = time.time
1717 1717 # time execution
1718 1718 wall_st = wtime()
1719 1719 if mode=='eval':
1720 1720 st = clk()
1721 1721 out = eval(code,glob)
1722 1722 end = clk()
1723 1723 else:
1724 1724 st = clk()
1725 1725 exec code in glob
1726 1726 end = clk()
1727 1727 out = None
1728 1728 wall_end = wtime()
1729 1729 # Compute actual times and report
1730 1730 wall_time = wall_end-wall_st
1731 1731 cpu_user = end[0]-st[0]
1732 1732 cpu_sys = end[1]-st[1]
1733 1733 cpu_tot = cpu_user+cpu_sys
1734 1734 print "CPU times: user %.2f s, sys: %.2f s, total: %.2f s" % \
1735 1735 (cpu_user,cpu_sys,cpu_tot)
1736 1736 print "Wall time: %.2f" % wall_time
1737 1737 return out
1738 1738
1739 1739 def magic_macro(self,parameter_s = ''):
1740 1740 """Define a set of input lines as a macro for future re-execution.
1741 1741
1742 1742 Usage:\\
1743 1743 %macro [options] name n1-n2 n3-n4 ... n5 .. n6 ...
1744 1744
1745 1745 Options:
1746 1746
1747 1747 -r: use 'raw' input. By default, the 'processed' history is used,
1748 1748 so that magics are loaded in their transformed version to valid
1749 1749 Python. If this option is given, the raw input as typed as the
1750 1750 command line is used instead.
1751 1751
1752 1752 This will define a global variable called `name` which is a string
1753 1753 made of joining the slices and lines you specify (n1,n2,... numbers
1754 1754 above) from your input history into a single string. This variable
1755 1755 acts like an automatic function which re-executes those lines as if
1756 1756 you had typed them. You just type 'name' at the prompt and the code
1757 1757 executes.
1758 1758
1759 1759 The notation for indicating number ranges is: n1-n2 means 'use line
1760 1760 numbers n1,...n2' (the endpoint is included). That is, '5-7' means
1761 1761 using the lines numbered 5,6 and 7.
1762 1762
1763 1763 Note: as a 'hidden' feature, you can also use traditional python slice
1764 1764 notation, where N:M means numbers N through M-1.
1765 1765
1766 1766 For example, if your history contains (%hist prints it):
1767 1767
1768 1768 44: x=1\\
1769 1769 45: y=3\\
1770 1770 46: z=x+y\\
1771 1771 47: print x\\
1772 1772 48: a=5\\
1773 1773 49: print 'x',x,'y',y\\
1774 1774
1775 1775 you can create a macro with lines 44 through 47 (included) and line 49
1776 1776 called my_macro with:
1777 1777
1778 1778 In [51]: %macro my_macro 44-47 49
1779 1779
1780 1780 Now, typing `my_macro` (without quotes) will re-execute all this code
1781 1781 in one pass.
1782 1782
1783 1783 You don't need to give the line-numbers in order, and any given line
1784 1784 number can appear multiple times. You can assemble macros with any
1785 1785 lines from your input history in any order.
1786 1786
1787 1787 The macro is a simple object which holds its value in an attribute,
1788 1788 but IPython's display system checks for macros and executes them as
1789 1789 code instead of printing them when you type their name.
1790 1790
1791 1791 You can view a macro's contents by explicitly printing it with:
1792 1792
1793 1793 'print macro_name'.
1794 1794
1795 1795 For one-off cases which DON'T contain magic function calls in them you
1796 1796 can obtain similar results by explicitly executing slices from your
1797 1797 input history with:
1798 1798
1799 1799 In [60]: exec In[44:48]+In[49]"""
1800 1800
1801 1801 opts,args = self.parse_options(parameter_s,'r',mode='list')
1802 1802 name,ranges = args[0], args[1:]
1803 1803 #print 'rng',ranges # dbg
1804 1804 lines = self.extract_input_slices(ranges,opts.has_key('r'))
1805 1805 macro = Macro(lines)
1806 1806 self.shell.user_ns.update({name:macro})
1807 1807 print 'Macro `%s` created. To execute, type its name (without quotes).' % name
1808 1808 print 'Macro contents:'
1809 1809 print macro,
1810 1810
1811 1811 def magic_save(self,parameter_s = ''):
1812 1812 """Save a set of lines to a given filename.
1813 1813
1814 1814 Usage:\\
1815 1815 %save [options] filename n1-n2 n3-n4 ... n5 .. n6 ...
1816 1816
1817 1817 Options:
1818 1818
1819 1819 -r: use 'raw' input. By default, the 'processed' history is used,
1820 1820 so that magics are loaded in their transformed version to valid
1821 1821 Python. If this option is given, the raw input as typed as the
1822 1822 command line is used instead.
1823 1823
1824 1824 This function uses the same syntax as %macro for line extraction, but
1825 1825 instead of creating a macro it saves the resulting string to the
1826 1826 filename you specify.
1827 1827
1828 1828 It adds a '.py' extension to the file if you don't do so yourself, and
1829 1829 it asks for confirmation before overwriting existing files."""
1830 1830
1831 1831 opts,args = self.parse_options(parameter_s,'r',mode='list')
1832 1832 fname,ranges = args[0], args[1:]
1833 1833 if not fname.endswith('.py'):
1834 1834 fname += '.py'
1835 1835 if os.path.isfile(fname):
1836 1836 ans = raw_input('File `%s` exists. Overwrite (y/[N])? ' % fname)
1837 1837 if ans.lower() not in ['y','yes']:
1838 1838 print 'Operation cancelled.'
1839 1839 return
1840 1840 cmds = ''.join(self.extract_input_slices(ranges,opts.has_key('r')))
1841 1841 f = file(fname,'w')
1842 1842 f.write(cmds)
1843 1843 f.close()
1844 1844 print 'The following commands were written to file `%s`:' % fname
1845 1845 print cmds
1846 1846
1847 1847 def _edit_macro(self,mname,macro):
1848 1848 """open an editor with the macro data in a file"""
1849 1849 filename = self.shell.mktempfile(macro.value)
1850 1850 self.shell.hooks.editor(filename)
1851 1851
1852 1852 # and make a new macro object, to replace the old one
1853 1853 mfile = open(filename)
1854 1854 mvalue = mfile.read()
1855 1855 mfile.close()
1856 1856 self.shell.user_ns[mname] = Macro(mvalue)
1857 1857
1858 1858 def magic_ed(self,parameter_s=''):
1859 1859 """Alias to %edit."""
1860 1860 return self.magic_edit(parameter_s)
1861 1861
1862 1862 def magic_edit(self,parameter_s='',last_call=['','']):
1863 1863 """Bring up an editor and execute the resulting code.
1864 1864
1865 1865 Usage:
1866 1866 %edit [options] [args]
1867 1867
1868 1868 %edit runs IPython's editor hook. The default version of this hook is
1869 1869 set to call the __IPYTHON__.rc.editor command. This is read from your
1870 1870 environment variable $EDITOR. If this isn't found, it will default to
1871 1871 vi under Linux/Unix and to notepad under Windows. See the end of this
1872 1872 docstring for how to change the editor hook.
1873 1873
1874 1874 You can also set the value of this editor via the command line option
1875 1875 '-editor' or in your ipythonrc file. This is useful if you wish to use
1876 1876 specifically for IPython an editor different from your typical default
1877 1877 (and for Windows users who typically don't set environment variables).
1878 1878
1879 1879 This command allows you to conveniently edit multi-line code right in
1880 1880 your IPython session.
1881 1881
1882 1882 If called without arguments, %edit opens up an empty editor with a
1883 1883 temporary file and will execute the contents of this file when you
1884 1884 close it (don't forget to save it!).
1885 1885
1886 1886
1887 1887 Options:
1888 1888
1889 1889 -n <number>: open the editor at a specified line number. By default,
1890 1890 the IPython editor hook uses the unix syntax 'editor +N filename', but
1891 1891 you can configure this by providing your own modified hook if your
1892 1892 favorite editor supports line-number specifications with a different
1893 1893 syntax.
1894 1894
1895 1895 -p: this will call the editor with the same data as the previous time
1896 1896 it was used, regardless of how long ago (in your current session) it
1897 1897 was.
1898 1898
1899 1899 -r: use 'raw' input. This option only applies to input taken from the
1900 1900 user's history. By default, the 'processed' history is used, so that
1901 1901 magics are loaded in their transformed version to valid Python. If
1902 1902 this option is given, the raw input as typed as the command line is
1903 1903 used instead. When you exit the editor, it will be executed by
1904 1904 IPython's own processor.
1905 1905
1906 1906 -x: do not execute the edited code immediately upon exit. This is
1907 1907 mainly useful if you are editing programs which need to be called with
1908 1908 command line arguments, which you can then do using %run.
1909 1909
1910 1910
1911 1911 Arguments:
1912 1912
1913 1913 If arguments are given, the following possibilites exist:
1914 1914
1915 1915 - The arguments are numbers or pairs of colon-separated numbers (like
1916 1916 1 4:8 9). These are interpreted as lines of previous input to be
1917 1917 loaded into the editor. The syntax is the same of the %macro command.
1918 1918
1919 1919 - If the argument doesn't start with a number, it is evaluated as a
1920 1920 variable and its contents loaded into the editor. You can thus edit
1921 1921 any string which contains python code (including the result of
1922 1922 previous edits).
1923 1923
1924 1924 - If the argument is the name of an object (other than a string),
1925 1925 IPython will try to locate the file where it was defined and open the
1926 1926 editor at the point where it is defined. You can use `%edit function`
1927 1927 to load an editor exactly at the point where 'function' is defined,
1928 1928 edit it and have the file be executed automatically.
1929 1929
1930 1930 If the object is a macro (see %macro for details), this opens up your
1931 1931 specified editor with a temporary file containing the macro's data.
1932 1932 Upon exit, the macro is reloaded with the contents of the file.
1933 1933
1934 1934 Note: opening at an exact line is only supported under Unix, and some
1935 1935 editors (like kedit and gedit up to Gnome 2.8) do not understand the
1936 1936 '+NUMBER' parameter necessary for this feature. Good editors like
1937 1937 (X)Emacs, vi, jed, pico and joe all do.
1938 1938
1939 1939 - If the argument is not found as a variable, IPython will look for a
1940 1940 file with that name (adding .py if necessary) and load it into the
1941 1941 editor. It will execute its contents with execfile() when you exit,
1942 1942 loading any code in the file into your interactive namespace.
1943 1943
1944 1944 After executing your code, %edit will return as output the code you
1945 1945 typed in the editor (except when it was an existing file). This way
1946 1946 you can reload the code in further invocations of %edit as a variable,
1947 1947 via _<NUMBER> or Out[<NUMBER>], where <NUMBER> is the prompt number of
1948 1948 the output.
1949 1949
1950 1950 Note that %edit is also available through the alias %ed.
1951 1951
1952 1952 This is an example of creating a simple function inside the editor and
1953 1953 then modifying it. First, start up the editor:
1954 1954
1955 1955 In [1]: ed\\
1956 1956 Editing... done. Executing edited code...\\
1957 1957 Out[1]: 'def foo():\\n print "foo() was defined in an editing session"\\n'
1958 1958
1959 1959 We can then call the function foo():
1960 1960
1961 1961 In [2]: foo()\\
1962 1962 foo() was defined in an editing session
1963 1963
1964 1964 Now we edit foo. IPython automatically loads the editor with the
1965 1965 (temporary) file where foo() was previously defined:
1966 1966
1967 1967 In [3]: ed foo\\
1968 1968 Editing... done. Executing edited code...
1969 1969
1970 1970 And if we call foo() again we get the modified version:
1971 1971
1972 1972 In [4]: foo()\\
1973 1973 foo() has now been changed!
1974 1974
1975 1975 Here is an example of how to edit a code snippet successive
1976 1976 times. First we call the editor:
1977 1977
1978 1978 In [8]: ed\\
1979 1979 Editing... done. Executing edited code...\\
1980 1980 hello\\
1981 1981 Out[8]: "print 'hello'\\n"
1982 1982
1983 1983 Now we call it again with the previous output (stored in _):
1984 1984
1985 1985 In [9]: ed _\\
1986 1986 Editing... done. Executing edited code...\\
1987 1987 hello world\\
1988 1988 Out[9]: "print 'hello world'\\n"
1989 1989
1990 1990 Now we call it with the output #8 (stored in _8, also as Out[8]):
1991 1991
1992 1992 In [10]: ed _8\\
1993 1993 Editing... done. Executing edited code...\\
1994 1994 hello again\\
1995 1995 Out[10]: "print 'hello again'\\n"
1996 1996
1997 1997
1998 1998 Changing the default editor hook:
1999 1999
2000 2000 If you wish to write your own editor hook, you can put it in a
2001 2001 configuration file which you load at startup time. The default hook
2002 2002 is defined in the IPython.hooks module, and you can use that as a
2003 2003 starting example for further modifications. That file also has
2004 2004 general instructions on how to set a new hook for use once you've
2005 2005 defined it."""
2006 2006
2007 2007 # FIXME: This function has become a convoluted mess. It needs a
2008 2008 # ground-up rewrite with clean, simple logic.
2009 2009
2010 2010 def make_filename(arg):
2011 2011 "Make a filename from the given args"
2012 2012 try:
2013 2013 filename = get_py_filename(arg)
2014 2014 except IOError:
2015 2015 if args.endswith('.py'):
2016 2016 filename = arg
2017 2017 else:
2018 2018 filename = None
2019 2019 return filename
2020 2020
2021 2021 # custom exceptions
2022 2022 class DataIsObject(Exception): pass
2023 2023
2024 2024 opts,args = self.parse_options(parameter_s,'prxn:')
2025 2025 # Set a few locals from the options for convenience:
2026 2026 opts_p = opts.has_key('p')
2027 2027 opts_r = opts.has_key('r')
2028 2028
2029 2029 # Default line number value
2030 2030 lineno = opts.get('n',None)
2031 2031
2032 2032 if opts_p:
2033 2033 args = '_%s' % last_call[0]
2034 2034 if not self.shell.user_ns.has_key(args):
2035 2035 args = last_call[1]
2036 2036
2037 2037 # use last_call to remember the state of the previous call, but don't
2038 2038 # let it be clobbered by successive '-p' calls.
2039 2039 try:
2040 2040 last_call[0] = self.shell.outputcache.prompt_count
2041 2041 if not opts_p:
2042 2042 last_call[1] = parameter_s
2043 2043 except:
2044 2044 pass
2045 2045
2046 2046 # by default this is done with temp files, except when the given
2047 2047 # arg is a filename
2048 2048 use_temp = 1
2049 2049
2050 2050 if re.match(r'\d',args):
2051 2051 # Mode where user specifies ranges of lines, like in %macro.
2052 2052 # This means that you can't edit files whose names begin with
2053 2053 # numbers this way. Tough.
2054 2054 ranges = args.split()
2055 2055 data = ''.join(self.extract_input_slices(ranges,opts_r))
2056 2056 elif args.endswith('.py'):
2057 2057 filename = make_filename(args)
2058 2058 data = ''
2059 2059 use_temp = 0
2060 2060 elif args:
2061 2061 try:
2062 2062 # Load the parameter given as a variable. If not a string,
2063 2063 # process it as an object instead (below)
2064 2064
2065 2065 #print '*** args',args,'type',type(args) # dbg
2066 2066 data = eval(args,self.shell.user_ns)
2067 2067 if not type(data) in StringTypes:
2068 2068 raise DataIsObject
2069 2069
2070 2070 except (NameError,SyntaxError):
2071 2071 # given argument is not a variable, try as a filename
2072 2072 filename = make_filename(args)
2073 2073 if filename is None:
2074 2074 warn("Argument given (%s) can't be found as a variable "
2075 2075 "or as a filename." % args)
2076 2076 return
2077 2077
2078 2078 data = ''
2079 2079 use_temp = 0
2080 2080 except DataIsObject:
2081 2081
2082 2082 # macros have a special edit function
2083 2083 if isinstance(data,Macro):
2084 2084 self._edit_macro(args,data)
2085 2085 return
2086 2086
2087 2087 # For objects, try to edit the file where they are defined
2088 2088 try:
2089 2089 filename = inspect.getabsfile(data)
2090 2090 datafile = 1
2091 2091 except TypeError:
2092 2092 filename = make_filename(args)
2093 2093 datafile = 1
2094 2094 warn('Could not find file where `%s` is defined.\n'
2095 2095 'Opening a file named `%s`' % (args,filename))
2096 2096 # Now, make sure we can actually read the source (if it was in
2097 2097 # a temp file it's gone by now).
2098 2098 if datafile:
2099 2099 try:
2100 2100 if lineno is None:
2101 2101 lineno = inspect.getsourcelines(data)[1]
2102 2102 except IOError:
2103 2103 filename = make_filename(args)
2104 2104 if filename is None:
2105 2105 warn('The file `%s` where `%s` was defined cannot '
2106 2106 'be read.' % (filename,data))
2107 2107 return
2108 2108 use_temp = 0
2109 2109 else:
2110 2110 data = ''
2111 2111
2112 2112 if use_temp:
2113 2113 filename = self.shell.mktempfile(data)
2114 2114 print 'IPython will make a temporary file named:',filename
2115 2115
2116 2116 # do actual editing here
2117 2117 print 'Editing...',
2118 2118 sys.stdout.flush()
2119 2119 self.shell.hooks.editor(filename,lineno)
2120 2120 if opts.has_key('x'): # -x prevents actual execution
2121 2121 print
2122 2122 else:
2123 2123 print 'done. Executing edited code...'
2124 2124 if opts_r:
2125 2125 self.shell.runlines(file_read(filename))
2126 2126 else:
2127 2127 self.shell.safe_execfile(filename,self.shell.user_ns)
2128 2128 if use_temp:
2129 2129 try:
2130 2130 return open(filename).read()
2131 2131 except IOError,msg:
2132 2132 if msg.filename == filename:
2133 2133 warn('File not found. Did you forget to save?')
2134 2134 return
2135 2135 else:
2136 2136 self.shell.showtraceback()
2137 2137
2138 2138 def magic_xmode(self,parameter_s = ''):
2139 2139 """Switch modes for the exception handlers.
2140 2140
2141 2141 Valid modes: Plain, Context and Verbose.
2142 2142
2143 2143 If called without arguments, acts as a toggle."""
2144 2144
2145 2145 def xmode_switch_err(name):
2146 2146 warn('Error changing %s exception modes.\n%s' %
2147 2147 (name,sys.exc_info()[1]))
2148 2148
2149 2149 shell = self.shell
2150 2150 new_mode = parameter_s.strip().capitalize()
2151 2151 try:
2152 2152 shell.InteractiveTB.set_mode(mode=new_mode)
2153 2153 print 'Exception reporting mode:',shell.InteractiveTB.mode
2154 2154 except:
2155 2155 xmode_switch_err('user')
2156 2156
2157 2157 # threaded shells use a special handler in sys.excepthook
2158 2158 if shell.isthreaded:
2159 2159 try:
2160 2160 shell.sys_excepthook.set_mode(mode=new_mode)
2161 2161 except:
2162 2162 xmode_switch_err('threaded')
2163 2163
2164 2164 def magic_colors(self,parameter_s = ''):
2165 2165 """Switch color scheme for prompts, info system and exception handlers.
2166 2166
2167 2167 Currently implemented schemes: NoColor, Linux, LightBG.
2168 2168
2169 2169 Color scheme names are not case-sensitive."""
2170 2170
2171 2171 def color_switch_err(name):
2172 2172 warn('Error changing %s color schemes.\n%s' %
2173 2173 (name,sys.exc_info()[1]))
2174 2174
2175 2175
2176 2176 new_scheme = parameter_s.strip()
2177 2177 if not new_scheme:
2178 2178 print 'You must specify a color scheme.'
2179 2179 return
2180 2180 import IPython.rlineimpl as readline
2181 2181 if not readline.have_readline:
2182 2182 msg = """\
2183 2183 Proper color support under MS Windows requires Gary Bishop's readline library.
2184 2184 You can find it at:
2185 2185 http://sourceforge.net/projects/uncpythontools
2186 2186 Gary's readline needs the ctypes module, from:
2187 2187 http://starship.python.net/crew/theller/ctypes
2188 2188
2189 2189 Defaulting color scheme to 'NoColor'"""
2190 2190 new_scheme = 'NoColor'
2191 2191 warn(msg)
2192 2192 # local shortcut
2193 2193 shell = self.shell
2194 2194
2195 2195 # Set prompt colors
2196 2196 try:
2197 2197 shell.outputcache.set_colors(new_scheme)
2198 2198 except:
2199 2199 color_switch_err('prompt')
2200 2200 else:
2201 2201 shell.rc.colors = \
2202 2202 shell.outputcache.color_table.active_scheme_name
2203 2203 # Set exception colors
2204 2204 try:
2205 2205 shell.InteractiveTB.set_colors(scheme = new_scheme)
2206 2206 shell.SyntaxTB.set_colors(scheme = new_scheme)
2207 2207 except:
2208 2208 color_switch_err('exception')
2209 2209
2210 2210 # threaded shells use a verbose traceback in sys.excepthook
2211 2211 if shell.isthreaded:
2212 2212 try:
2213 2213 shell.sys_excepthook.set_colors(scheme=new_scheme)
2214 2214 except:
2215 2215 color_switch_err('system exception handler')
2216 2216
2217 2217 # Set info (for 'object?') colors
2218 2218 if shell.rc.color_info:
2219 2219 try:
2220 2220 shell.inspector.set_active_scheme(new_scheme)
2221 2221 except:
2222 2222 color_switch_err('object inspector')
2223 2223 else:
2224 2224 shell.inspector.set_active_scheme('NoColor')
2225 2225
2226 2226 def magic_color_info(self,parameter_s = ''):
2227 2227 """Toggle color_info.
2228 2228
2229 2229 The color_info configuration parameter controls whether colors are
2230 2230 used for displaying object details (by things like %psource, %pfile or
2231 2231 the '?' system). This function toggles this value with each call.
2232 2232
2233 2233 Note that unless you have a fairly recent pager (less works better
2234 2234 than more) in your system, using colored object information displays
2235 2235 will not work properly. Test it and see."""
2236 2236
2237 2237 self.shell.rc.color_info = 1 - self.shell.rc.color_info
2238 2238 self.magic_colors(self.shell.rc.colors)
2239 2239 print 'Object introspection functions have now coloring:',
2240 2240 print ['OFF','ON'][self.shell.rc.color_info]
2241 2241
2242 2242 def magic_Pprint(self, parameter_s=''):
2243 2243 """Toggle pretty printing on/off."""
2244 2244
2245 2245 self.shell.rc.pprint = 1 - self.shell.rc.pprint
2246 2246 print 'Pretty printing has been turned', \
2247 2247 ['OFF','ON'][self.shell.rc.pprint]
2248 2248
2249 2249 def magic_exit(self, parameter_s=''):
2250 2250 """Exit IPython, confirming if configured to do so.
2251 2251
2252 2252 You can configure whether IPython asks for confirmation upon exit by
2253 2253 setting the confirm_exit flag in the ipythonrc file."""
2254 2254
2255 2255 self.shell.exit()
2256 2256
2257 2257 def magic_quit(self, parameter_s=''):
2258 2258 """Exit IPython, confirming if configured to do so (like %exit)"""
2259 2259
2260 2260 self.shell.exit()
2261 2261
2262 2262 def magic_Exit(self, parameter_s=''):
2263 2263 """Exit IPython without confirmation."""
2264 2264
2265 2265 self.shell.exit_now = True
2266 2266
2267 2267 def magic_Quit(self, parameter_s=''):
2268 2268 """Exit IPython without confirmation (like %Exit)."""
2269 2269
2270 2270 self.shell.exit_now = True
2271 2271
2272 2272 #......................................................................
2273 2273 # Functions to implement unix shell-type things
2274 2274
2275 2275 def magic_alias(self, parameter_s = ''):
2276 2276 """Define an alias for a system command.
2277 2277
2278 2278 '%alias alias_name cmd' defines 'alias_name' as an alias for 'cmd'
2279 2279
2280 2280 Then, typing 'alias_name params' will execute the system command 'cmd
2281 2281 params' (from your underlying operating system).
2282 2282
2283 2283 Aliases have lower precedence than magic functions and Python normal
2284 2284 variables, so if 'foo' is both a Python variable and an alias, the
2285 2285 alias can not be executed until 'del foo' removes the Python variable.
2286 2286
2287 2287 You can use the %l specifier in an alias definition to represent the
2288 2288 whole line when the alias is called. For example:
2289 2289
2290 2290 In [2]: alias all echo "Input in brackets: <%l>"\\
2291 2291 In [3]: all hello world\\
2292 2292 Input in brackets: <hello world>
2293 2293
2294 2294 You can also define aliases with parameters using %s specifiers (one
2295 2295 per parameter):
2296 2296
2297 2297 In [1]: alias parts echo first %s second %s\\
2298 2298 In [2]: %parts A B\\
2299 2299 first A second B\\
2300 2300 In [3]: %parts A\\
2301 2301 Incorrect number of arguments: 2 expected.\\
2302 2302 parts is an alias to: 'echo first %s second %s'
2303 2303
2304 2304 Note that %l and %s are mutually exclusive. You can only use one or
2305 2305 the other in your aliases.
2306 2306
2307 2307 Aliases expand Python variables just like system calls using ! or !!
2308 2308 do: all expressions prefixed with '$' get expanded. For details of
2309 2309 the semantic rules, see PEP-215:
2310 2310 http://www.python.org/peps/pep-0215.html. This is the library used by
2311 2311 IPython for variable expansion. If you want to access a true shell
2312 2312 variable, an extra $ is necessary to prevent its expansion by IPython:
2313 2313
2314 2314 In [6]: alias show echo\\
2315 2315 In [7]: PATH='A Python string'\\
2316 2316 In [8]: show $PATH\\
2317 2317 A Python string\\
2318 2318 In [9]: show $$PATH\\
2319 2319 /usr/local/lf9560/bin:/usr/local/intel/compiler70/ia32/bin:...
2320 2320
2321 2321 You can use the alias facility to acess all of $PATH. See the %rehash
2322 2322 and %rehashx functions, which automatically create aliases for the
2323 2323 contents of your $PATH.
2324 2324
2325 2325 If called with no parameters, %alias prints the current alias table."""
2326 2326
2327 2327 par = parameter_s.strip()
2328 2328 if not par:
2329 2329 if self.shell.rc.automagic:
2330 2330 prechar = ''
2331 2331 else:
2332 2332 prechar = self.shell.ESC_MAGIC
2333 2333 #print 'Alias\t\tSystem Command\n'+'-'*30
2334 2334 atab = self.shell.alias_table
2335 2335 aliases = atab.keys()
2336 2336 aliases.sort()
2337 2337 res = []
2338 2338 for alias in aliases:
2339 2339 res.append((alias, atab[alias][1]))
2340 2340 print "Total number of aliases:",len(aliases)
2341 2341 return res
2342 2342 try:
2343 2343 alias,cmd = par.split(None,1)
2344 2344 except:
2345 2345 print OInspect.getdoc(self.magic_alias)
2346 2346 else:
2347 2347 nargs = cmd.count('%s')
2348 2348 if nargs>0 and cmd.find('%l')>=0:
2349 2349 error('The %s and %l specifiers are mutually exclusive '
2350 2350 'in alias definitions.')
2351 2351 else: # all looks OK
2352 2352 self.shell.alias_table[alias] = (nargs,cmd)
2353 2353 self.shell.alias_table_validate(verbose=0)
2354 2354 # end magic_alias
2355 2355
2356 2356 def magic_unalias(self, parameter_s = ''):
2357 2357 """Remove an alias"""
2358 2358
2359 2359 aname = parameter_s.strip()
2360 2360 if aname in self.shell.alias_table:
2361 2361 del self.shell.alias_table[aname]
2362 2362
2363 2363 def magic_rehash(self, parameter_s = ''):
2364 2364 """Update the alias table with all entries in $PATH.
2365 2365
2366 2366 This version does no checks on execute permissions or whether the
2367 2367 contents of $PATH are truly files (instead of directories or something
2368 2368 else). For such a safer (but slower) version, use %rehashx."""
2369 2369
2370 2370 # This function (and rehashx) manipulate the alias_table directly
2371 2371 # rather than calling magic_alias, for speed reasons. A rehash on a
2372 2372 # typical Linux box involves several thousand entries, so efficiency
2373 2373 # here is a top concern.
2374 2374
2375 2375 path = filter(os.path.isdir,os.environ['PATH'].split(os.pathsep))
2376 2376 alias_table = self.shell.alias_table
2377 2377 for pdir in path:
2378 2378 for ff in os.listdir(pdir):
2379 2379 # each entry in the alias table must be (N,name), where
2380 2380 # N is the number of positional arguments of the alias.
2381 2381 alias_table[ff] = (0,ff)
2382 2382 # Make sure the alias table doesn't contain keywords or builtins
2383 2383 self.shell.alias_table_validate()
2384 2384 # Call again init_auto_alias() so we get 'rm -i' and other modified
2385 2385 # aliases since %rehash will probably clobber them
2386 2386 self.shell.init_auto_alias()
2387 2387
2388 2388 def magic_rehashx(self, parameter_s = ''):
2389 2389 """Update the alias table with all executable files in $PATH.
2390 2390
2391 2391 This version explicitly checks that every entry in $PATH is a file
2392 2392 with execute access (os.X_OK), so it is much slower than %rehash.
2393 2393
2394 2394 Under Windows, it checks executability as a match agains a
2395 2395 '|'-separated string of extensions, stored in the IPython config
2396 2396 variable win_exec_ext. This defaults to 'exe|com|bat'. """
2397 2397
2398 2398 path = [os.path.abspath(os.path.expanduser(p)) for p in
2399 2399 os.environ['PATH'].split(os.pathsep)]
2400 2400 path = filter(os.path.isdir,path)
2401 2401
2402 2402 alias_table = self.shell.alias_table
2403 2403 syscmdlist = []
2404 2404 if os.name == 'posix':
2405 2405 isexec = lambda fname:os.path.isfile(fname) and \
2406 2406 os.access(fname,os.X_OK)
2407 2407 else:
2408 2408
2409 2409 try:
2410 2410 winext = os.environ['pathext'].replace(';','|').replace('.','')
2411 2411 except KeyError:
2412 2412 winext = 'exe|com|bat'
2413 2413
2414 2414 execre = re.compile(r'(.*)\.(%s)$' % winext,re.IGNORECASE)
2415 2415 isexec = lambda fname:os.path.isfile(fname) and execre.match(fname)
2416 2416 savedir = os.getcwd()
2417 2417 try:
2418 2418 # write the whole loop for posix/Windows so we don't have an if in
2419 2419 # the innermost part
2420 2420 if os.name == 'posix':
2421 2421 for pdir in path:
2422 2422 os.chdir(pdir)
2423 2423 for ff in os.listdir(pdir):
2424 if isexec(ff):
2424 if isexec(ff) and ff not in self.shell.no_alias:
2425 2425 # each entry in the alias table must be (N,name),
2426 2426 # where N is the number of positional arguments of the
2427 2427 # alias.
2428 2428 alias_table[ff] = (0,ff)
2429 2429 syscmdlist.append(ff)
2430 2430 else:
2431 2431 for pdir in path:
2432 2432 os.chdir(pdir)
2433 2433 for ff in os.listdir(pdir):
2434 if isexec(ff):
2434 if isexec(ff) and os.path.splitext(ff)[0] not in self.shell.no_alias:
2435 2435 alias_table[execre.sub(r'\1',ff)] = (0,ff)
2436 2436 syscmdlist.append(ff)
2437 2437 # Make sure the alias table doesn't contain keywords or builtins
2438 2438 self.shell.alias_table_validate()
2439 2439 # Call again init_auto_alias() so we get 'rm -i' and other
2440 2440 # modified aliases since %rehashx will probably clobber them
2441 2441 self.shell.init_auto_alias()
2442 2442 db = self.getapi().db
2443 2443 db['syscmdlist'] = syscmdlist
2444 2444 finally:
2445 2445 os.chdir(savedir)
2446 2446
2447 2447 def magic_pwd(self, parameter_s = ''):
2448 2448 """Return the current working directory path."""
2449 2449 return os.getcwd()
2450 2450
2451 2451 def magic_cd(self, parameter_s=''):
2452 2452 """Change the current working directory.
2453 2453
2454 2454 This command automatically maintains an internal list of directories
2455 2455 you visit during your IPython session, in the variable _dh. The
2456 2456 command %dhist shows this history nicely formatted.
2457 2457
2458 2458 Usage:
2459 2459
2460 2460 cd 'dir': changes to directory 'dir'.
2461 2461
2462 2462 cd -: changes to the last visited directory.
2463 2463
2464 2464 cd -<n>: changes to the n-th directory in the directory history.
2465 2465
2466 2466 cd -b <bookmark_name>: jump to a bookmark set by %bookmark
2467 2467 (note: cd <bookmark_name> is enough if there is no
2468 2468 directory <bookmark_name>, but a bookmark with the name exists.)
2469 2469
2470 2470 Options:
2471 2471
2472 2472 -q: quiet. Do not print the working directory after the cd command is
2473 2473 executed. By default IPython's cd command does print this directory,
2474 2474 since the default prompts do not display path information.
2475 2475
2476 2476 Note that !cd doesn't work for this purpose because the shell where
2477 2477 !command runs is immediately discarded after executing 'command'."""
2478 2478
2479 2479 parameter_s = parameter_s.strip()
2480 2480 #bkms = self.shell.persist.get("bookmarks",{})
2481 2481
2482 2482 numcd = re.match(r'(-)(\d+)$',parameter_s)
2483 2483 # jump in directory history by number
2484 2484 if numcd:
2485 2485 nn = int(numcd.group(2))
2486 2486 try:
2487 2487 ps = self.shell.user_ns['_dh'][nn]
2488 2488 except IndexError:
2489 2489 print 'The requested directory does not exist in history.'
2490 2490 return
2491 2491 else:
2492 2492 opts = {}
2493 2493 else:
2494 2494 #turn all non-space-escaping backslashes to slashes,
2495 2495 # for c:\windows\directory\names\
2496 2496 parameter_s = re.sub(r'\\(?! )','/', parameter_s)
2497 2497 opts,ps = self.parse_options(parameter_s,'qb',mode='string')
2498 2498 # jump to previous
2499 2499 if ps == '-':
2500 2500 try:
2501 2501 ps = self.shell.user_ns['_dh'][-2]
2502 2502 except IndexError:
2503 2503 print 'No previous directory to change to.'
2504 2504 return
2505 2505 # jump to bookmark if needed
2506 2506 else:
2507 2507 if not os.path.isdir(ps) or opts.has_key('b'):
2508 2508 bkms = self.db.get('bookmarks', {})
2509 2509
2510 2510 if bkms.has_key(ps):
2511 2511 target = bkms[ps]
2512 2512 print '(bookmark:%s) -> %s' % (ps,target)
2513 2513 ps = target
2514 2514 else:
2515 2515 if opts.has_key('b'):
2516 2516 error("Bookmark '%s' not found. "
2517 2517 "Use '%%bookmark -l' to see your bookmarks." % ps)
2518 2518 return
2519 2519
2520 2520 # at this point ps should point to the target dir
2521 2521 if ps:
2522 2522 try:
2523 2523 os.chdir(os.path.expanduser(ps))
2524 2524 ttitle = ("IPy:" + (
2525 2525 os.getcwd() == '/' and '/' or os.path.basename(os.getcwd())))
2526 2526 platutils.set_term_title(ttitle)
2527 2527 except OSError:
2528 2528 print sys.exc_info()[1]
2529 2529 else:
2530 2530 self.shell.user_ns['_dh'].append(os.getcwd())
2531 2531 else:
2532 2532 os.chdir(self.shell.home_dir)
2533 2533 platutils.set_term_title("IPy:~")
2534 2534 self.shell.user_ns['_dh'].append(os.getcwd())
2535 2535 if not 'q' in opts:
2536 2536 print self.shell.user_ns['_dh'][-1]
2537 2537
2538 2538 def magic_dhist(self, parameter_s=''):
2539 2539 """Print your history of visited directories.
2540 2540
2541 2541 %dhist -> print full history\\
2542 2542 %dhist n -> print last n entries only\\
2543 2543 %dhist n1 n2 -> print entries between n1 and n2 (n1 not included)\\
2544 2544
2545 2545 This history is automatically maintained by the %cd command, and
2546 2546 always available as the global list variable _dh. You can use %cd -<n>
2547 2547 to go to directory number <n>."""
2548 2548
2549 2549 dh = self.shell.user_ns['_dh']
2550 2550 if parameter_s:
2551 2551 try:
2552 2552 args = map(int,parameter_s.split())
2553 2553 except:
2554 2554 self.arg_err(Magic.magic_dhist)
2555 2555 return
2556 2556 if len(args) == 1:
2557 2557 ini,fin = max(len(dh)-(args[0]),0),len(dh)
2558 2558 elif len(args) == 2:
2559 2559 ini,fin = args
2560 2560 else:
2561 2561 self.arg_err(Magic.magic_dhist)
2562 2562 return
2563 2563 else:
2564 2564 ini,fin = 0,len(dh)
2565 2565 nlprint(dh,
2566 2566 header = 'Directory history (kept in _dh)',
2567 2567 start=ini,stop=fin)
2568 2568
2569 2569 def magic_env(self, parameter_s=''):
2570 2570 """List environment variables."""
2571 2571
2572 2572 return os.environ.data
2573 2573
2574 2574 def magic_pushd(self, parameter_s=''):
2575 2575 """Place the current dir on stack and change directory.
2576 2576
2577 2577 Usage:\\
2578 2578 %pushd ['dirname']
2579 2579
2580 2580 %pushd with no arguments does a %pushd to your home directory.
2581 2581 """
2582 2582 if parameter_s == '': parameter_s = '~'
2583 2583 dir_s = self.shell.dir_stack
2584 2584 if len(dir_s)>0 and os.path.expanduser(parameter_s) != \
2585 2585 os.path.expanduser(self.shell.dir_stack[0]):
2586 2586 try:
2587 2587 self.magic_cd(parameter_s)
2588 2588 dir_s.insert(0,os.getcwd().replace(self.home_dir,'~'))
2589 2589 self.magic_dirs()
2590 2590 except:
2591 2591 print 'Invalid directory'
2592 2592 else:
2593 2593 print 'You are already there!'
2594 2594
2595 2595 def magic_popd(self, parameter_s=''):
2596 2596 """Change to directory popped off the top of the stack.
2597 2597 """
2598 2598 if len (self.shell.dir_stack) > 1:
2599 2599 self.shell.dir_stack.pop(0)
2600 2600 self.magic_cd(self.shell.dir_stack[0])
2601 2601 print self.shell.dir_stack[0]
2602 2602 else:
2603 2603 print "You can't remove the starting directory from the stack:",\
2604 2604 self.shell.dir_stack
2605 2605
2606 2606 def magic_dirs(self, parameter_s=''):
2607 2607 """Return the current directory stack."""
2608 2608
2609 2609 return self.shell.dir_stack[:]
2610 2610
2611 2611 def magic_sc(self, parameter_s=''):
2612 2612 """Shell capture - execute a shell command and capture its output.
2613 2613
2614 2614 DEPRECATED. Suboptimal, retained for backwards compatibility.
2615 2615
2616 2616 You should use the form 'var = !command' instead. Example:
2617 2617
2618 2618 "%sc -l myfiles = ls ~" should now be written as
2619 2619
2620 2620 "myfiles = !ls ~"
2621 2621
2622 2622 myfiles.s, myfiles.l and myfiles.n still apply as documented
2623 2623 below.
2624 2624
2625 2625 --
2626 2626 %sc [options] varname=command
2627 2627
2628 2628 IPython will run the given command using commands.getoutput(), and
2629 2629 will then update the user's interactive namespace with a variable
2630 2630 called varname, containing the value of the call. Your command can
2631 2631 contain shell wildcards, pipes, etc.
2632 2632
2633 2633 The '=' sign in the syntax is mandatory, and the variable name you
2634 2634 supply must follow Python's standard conventions for valid names.
2635 2635
2636 2636 (A special format without variable name exists for internal use)
2637 2637
2638 2638 Options:
2639 2639
2640 2640 -l: list output. Split the output on newlines into a list before
2641 2641 assigning it to the given variable. By default the output is stored
2642 2642 as a single string.
2643 2643
2644 2644 -v: verbose. Print the contents of the variable.
2645 2645
2646 2646 In most cases you should not need to split as a list, because the
2647 2647 returned value is a special type of string which can automatically
2648 2648 provide its contents either as a list (split on newlines) or as a
2649 2649 space-separated string. These are convenient, respectively, either
2650 2650 for sequential processing or to be passed to a shell command.
2651 2651
2652 2652 For example:
2653 2653
2654 2654 # Capture into variable a
2655 2655 In [9]: sc a=ls *py
2656 2656
2657 2657 # a is a string with embedded newlines
2658 2658 In [10]: a
2659 2659 Out[10]: 'setup.py\nwin32_manual_post_install.py'
2660 2660
2661 2661 # which can be seen as a list:
2662 2662 In [11]: a.l
2663 2663 Out[11]: ['setup.py', 'win32_manual_post_install.py']
2664 2664
2665 2665 # or as a whitespace-separated string:
2666 2666 In [12]: a.s
2667 2667 Out[12]: 'setup.py win32_manual_post_install.py'
2668 2668
2669 2669 # a.s is useful to pass as a single command line:
2670 2670 In [13]: !wc -l $a.s
2671 2671 146 setup.py
2672 2672 130 win32_manual_post_install.py
2673 2673 276 total
2674 2674
2675 2675 # while the list form is useful to loop over:
2676 2676 In [14]: for f in a.l:
2677 2677 ....: !wc -l $f
2678 2678 ....:
2679 2679 146 setup.py
2680 2680 130 win32_manual_post_install.py
2681 2681
2682 2682 Similiarly, the lists returned by the -l option are also special, in
2683 2683 the sense that you can equally invoke the .s attribute on them to
2684 2684 automatically get a whitespace-separated string from their contents:
2685 2685
2686 2686 In [1]: sc -l b=ls *py
2687 2687
2688 2688 In [2]: b
2689 2689 Out[2]: ['setup.py', 'win32_manual_post_install.py']
2690 2690
2691 2691 In [3]: b.s
2692 2692 Out[3]: 'setup.py win32_manual_post_install.py'
2693 2693
2694 2694 In summary, both the lists and strings used for ouptut capture have
2695 2695 the following special attributes:
2696 2696
2697 2697 .l (or .list) : value as list.
2698 2698 .n (or .nlstr): value as newline-separated string.
2699 2699 .s (or .spstr): value as space-separated string.
2700 2700 """
2701 2701
2702 2702 opts,args = self.parse_options(parameter_s,'lv')
2703 2703 # Try to get a variable name and command to run
2704 2704 try:
2705 2705 # the variable name must be obtained from the parse_options
2706 2706 # output, which uses shlex.split to strip options out.
2707 2707 var,_ = args.split('=',1)
2708 2708 var = var.strip()
2709 2709 # But the the command has to be extracted from the original input
2710 2710 # parameter_s, not on what parse_options returns, to avoid the
2711 2711 # quote stripping which shlex.split performs on it.
2712 2712 _,cmd = parameter_s.split('=',1)
2713 2713 except ValueError:
2714 2714 var,cmd = '',''
2715 2715 # If all looks ok, proceed
2716 2716 out,err = self.shell.getoutputerror(cmd)
2717 2717 if err:
2718 2718 print >> Term.cerr,err
2719 2719 if opts.has_key('l'):
2720 2720 out = SList(out.split('\n'))
2721 2721 else:
2722 2722 out = LSString(out)
2723 2723 if opts.has_key('v'):
2724 2724 print '%s ==\n%s' % (var,pformat(out))
2725 2725 if var:
2726 2726 self.shell.user_ns.update({var:out})
2727 2727 else:
2728 2728 return out
2729 2729
2730 2730 def magic_sx(self, parameter_s=''):
2731 2731 """Shell execute - run a shell command and capture its output.
2732 2732
2733 2733 %sx command
2734 2734
2735 2735 IPython will run the given command using commands.getoutput(), and
2736 2736 return the result formatted as a list (split on '\\n'). Since the
2737 2737 output is _returned_, it will be stored in ipython's regular output
2738 2738 cache Out[N] and in the '_N' automatic variables.
2739 2739
2740 2740 Notes:
2741 2741
2742 2742 1) If an input line begins with '!!', then %sx is automatically
2743 2743 invoked. That is, while:
2744 2744 !ls
2745 2745 causes ipython to simply issue system('ls'), typing
2746 2746 !!ls
2747 2747 is a shorthand equivalent to:
2748 2748 %sx ls
2749 2749
2750 2750 2) %sx differs from %sc in that %sx automatically splits into a list,
2751 2751 like '%sc -l'. The reason for this is to make it as easy as possible
2752 2752 to process line-oriented shell output via further python commands.
2753 2753 %sc is meant to provide much finer control, but requires more
2754 2754 typing.
2755 2755
2756 2756 3) Just like %sc -l, this is a list with special attributes:
2757 2757
2758 2758 .l (or .list) : value as list.
2759 2759 .n (or .nlstr): value as newline-separated string.
2760 2760 .s (or .spstr): value as whitespace-separated string.
2761 2761
2762 2762 This is very useful when trying to use such lists as arguments to
2763 2763 system commands."""
2764 2764
2765 2765 if parameter_s:
2766 2766 out,err = self.shell.getoutputerror(parameter_s)
2767 2767 if err:
2768 2768 print >> Term.cerr,err
2769 2769 return SList(out.split('\n'))
2770 2770
2771 2771 def magic_bg(self, parameter_s=''):
2772 2772 """Run a job in the background, in a separate thread.
2773 2773
2774 2774 For example,
2775 2775
2776 2776 %bg myfunc(x,y,z=1)
2777 2777
2778 2778 will execute 'myfunc(x,y,z=1)' in a background thread. As soon as the
2779 2779 execution starts, a message will be printed indicating the job
2780 2780 number. If your job number is 5, you can use
2781 2781
2782 2782 myvar = jobs.result(5) or myvar = jobs[5].result
2783 2783
2784 2784 to assign this result to variable 'myvar'.
2785 2785
2786 2786 IPython has a job manager, accessible via the 'jobs' object. You can
2787 2787 type jobs? to get more information about it, and use jobs.<TAB> to see
2788 2788 its attributes. All attributes not starting with an underscore are
2789 2789 meant for public use.
2790 2790
2791 2791 In particular, look at the jobs.new() method, which is used to create
2792 2792 new jobs. This magic %bg function is just a convenience wrapper
2793 2793 around jobs.new(), for expression-based jobs. If you want to create a
2794 2794 new job with an explicit function object and arguments, you must call
2795 2795 jobs.new() directly.
2796 2796
2797 2797 The jobs.new docstring also describes in detail several important
2798 2798 caveats associated with a thread-based model for background job
2799 2799 execution. Type jobs.new? for details.
2800 2800
2801 2801 You can check the status of all jobs with jobs.status().
2802 2802
2803 2803 The jobs variable is set by IPython into the Python builtin namespace.
2804 2804 If you ever declare a variable named 'jobs', you will shadow this
2805 2805 name. You can either delete your global jobs variable to regain
2806 2806 access to the job manager, or make a new name and assign it manually
2807 2807 to the manager (stored in IPython's namespace). For example, to
2808 2808 assign the job manager to the Jobs name, use:
2809 2809
2810 2810 Jobs = __builtins__.jobs"""
2811 2811
2812 2812 self.shell.jobs.new(parameter_s,self.shell.user_ns)
2813 2813
2814 2814
2815 2815 def magic_bookmark(self, parameter_s=''):
2816 2816 """Manage IPython's bookmark system.
2817 2817
2818 2818 %bookmark <name> - set bookmark to current dir
2819 2819 %bookmark <name> <dir> - set bookmark to <dir>
2820 2820 %bookmark -l - list all bookmarks
2821 2821 %bookmark -d <name> - remove bookmark
2822 2822 %bookmark -r - remove all bookmarks
2823 2823
2824 2824 You can later on access a bookmarked folder with:
2825 2825 %cd -b <name>
2826 2826 or simply '%cd <name>' if there is no directory called <name> AND
2827 2827 there is such a bookmark defined.
2828 2828
2829 2829 Your bookmarks persist through IPython sessions, but they are
2830 2830 associated with each profile."""
2831 2831
2832 2832 opts,args = self.parse_options(parameter_s,'drl',mode='list')
2833 2833 if len(args) > 2:
2834 2834 error('You can only give at most two arguments')
2835 2835 return
2836 2836
2837 2837 bkms = self.db.get('bookmarks',{})
2838 2838
2839 2839 if opts.has_key('d'):
2840 2840 try:
2841 2841 todel = args[0]
2842 2842 except IndexError:
2843 2843 error('You must provide a bookmark to delete')
2844 2844 else:
2845 2845 try:
2846 2846 del bkms[todel]
2847 2847 except:
2848 2848 error("Can't delete bookmark '%s'" % todel)
2849 2849 elif opts.has_key('r'):
2850 2850 bkms = {}
2851 2851 elif opts.has_key('l'):
2852 2852 bks = bkms.keys()
2853 2853 bks.sort()
2854 2854 if bks:
2855 2855 size = max(map(len,bks))
2856 2856 else:
2857 2857 size = 0
2858 2858 fmt = '%-'+str(size)+'s -> %s'
2859 2859 print 'Current bookmarks:'
2860 2860 for bk in bks:
2861 2861 print fmt % (bk,bkms[bk])
2862 2862 else:
2863 2863 if not args:
2864 2864 error("You must specify the bookmark name")
2865 2865 elif len(args)==1:
2866 2866 bkms[args[0]] = os.getcwd()
2867 2867 elif len(args)==2:
2868 2868 bkms[args[0]] = args[1]
2869 2869 self.db['bookmarks'] = bkms
2870 2870
2871 2871 def magic_pycat(self, parameter_s=''):
2872 2872 """Show a syntax-highlighted file through a pager.
2873 2873
2874 2874 This magic is similar to the cat utility, but it will assume the file
2875 2875 to be Python source and will show it with syntax highlighting. """
2876 2876
2877 2877 try:
2878 2878 filename = get_py_filename(parameter_s)
2879 2879 cont = file_read(filename)
2880 2880 except IOError:
2881 2881 try:
2882 2882 cont = eval(parameter_s,self.user_ns)
2883 2883 except NameError:
2884 2884 cont = None
2885 2885 if cont is None:
2886 2886 print "Error: no such file or variable"
2887 2887 return
2888 2888
2889 2889 page(self.shell.pycolorize(cont),
2890 2890 screen_lines=self.shell.rc.screen_length)
2891 2891
2892 2892 def magic_cpaste(self, parameter_s=''):
2893 2893 """Allows you to paste & execute a pre-formatted code block from clipboard
2894 2894
2895 2895 You must terminate the block with '--' (two minus-signs) alone on the
2896 2896 line. You can also provide your own sentinel with '%paste -s %%' ('%%'
2897 2897 is the new sentinel for this operation)
2898 2898
2899 2899 The block is dedented prior to execution to enable execution of
2900 2900 method definitions. The executed block is also assigned to variable
2901 2901 named 'pasted_block' for later editing with '%edit pasted_block'.
2902 2902
2903 2903 You can also pass a variable name as an argument, e.g. '%cpaste foo'.
2904 2904 This assigns the pasted block to variable 'foo' as string, without
2905 2905 dedenting or executing it.
2906 2906
2907 2907 Do not be alarmed by garbled output on Windows (it's a readline bug).
2908 2908 Just press enter and type -- (and press enter again) and the block
2909 2909 will be what was just pasted.
2910 2910
2911 2911 IPython statements (magics, shell escapes) are not supported (yet).
2912 2912 """
2913 2913 opts,args = self.parse_options(parameter_s,'s:',mode='string')
2914 2914 par = args.strip()
2915 2915 sentinel = opts.get('s','--')
2916 2916
2917 2917 from IPython import iplib
2918 2918 lines = []
2919 2919 print "Pasting code; enter '%s' alone on the line to stop." % sentinel
2920 2920 while 1:
2921 2921 l = iplib.raw_input_original(':')
2922 2922 if l ==sentinel:
2923 2923 break
2924 2924 lines.append(l)
2925 2925 block = "\n".join(lines) + '\n'
2926 2926 #print "block:\n",block
2927 2927 if not par:
2928 2928 b = textwrap.dedent(block)
2929 2929 exec b in self.user_ns
2930 2930 self.user_ns['pasted_block'] = b
2931 2931 else:
2932 2932 self.user_ns[par] = block
2933 2933 print "Block assigned to '%s'" % par
2934 2934
2935 2935 def magic_quickref(self,arg):
2936 2936 """ Show a quick reference sheet """
2937 2937 import IPython.usage
2938 2938 qr = IPython.usage.quick_reference + self.magic_magic('-brief')
2939 2939
2940 2940 page(qr)
2941 2941
2942 2942 def magic_upgrade(self,arg):
2943 2943 """ Upgrade your IPython installation
2944 2944
2945 2945 This will copy the config files that don't yet exist in your
2946 2946 ipython dir from the system config dir. Use this after upgrading
2947 2947 IPython if you don't wish to delete your .ipython dir.
2948 2948
2949 2949 Call with -nolegacy to get rid of ipythonrc* files (recommended for
2950 2950 new users)
2951 2951
2952 2952 """
2953 2953 ip = self.getapi()
2954 2954 ipinstallation = path(IPython.__file__).dirname()
2955 2955 upgrade_script = '%s "%s"' % (sys.executable,ipinstallation / 'upgrade_dir.py')
2956 2956 src_config = ipinstallation / 'UserConfig'
2957 2957 userdir = path(ip.options.ipythondir)
2958 2958 cmd = '%s "%s" "%s"' % (upgrade_script, src_config, userdir)
2959 2959 print ">",cmd
2960 2960 shell(cmd)
2961 2961 if arg == '-nolegacy':
2962 2962 legacy = userdir.files('ipythonrc*')
2963 2963 print "Nuking legacy files:",legacy
2964 2964
2965 2965 [p.remove() for p in legacy]
2966 2966 suffix = (sys.platform == 'win32' and '.ini' or '')
2967 2967 (userdir / ('ipythonrc' + suffix)).write_text('# Empty, see ipy_user_conf.py\n')
2968 2968
2969 2969
2970 2970 # end Magic
@@ -1,5512 +1,5517 b''
1 ο»Ώ2006-06-05 Ville Vainio <vivainio@gmail.com>
2
3 * Magic.py (magic_rehashx): Honor no_alias list earlier in
4 %rehashx, to avoid clobbering builtins in ipy_profile_sh.py
5
1 6 2006-06-03 Fernando Perez <Fernando.Perez@colorado.edu>
2 7
3 8 * IPython/genutils.py (ask_yes_no): treat EOF as a default answer
4 9 instead of looping 20 times.
5 10
6 11 * IPython/ipmaker.py (make_IPython): honor -ipythondir flag
7 12 correctly at initialization time. Bug reported by Krishna Mohan
8 13 Gundu <gkmohan-AT-gmail.com> on the user list.
9 14
10 15 * IPython/Release.py (version): Mark 0.7.2 version to start
11 16 testing for release on 06/06.
12 17
13 18 2006-05-31 Fernando Perez <Fernando.Perez@colorado.edu>
14 19
15 20 * scripts/irunner: thin script interface so users don't have to
16 21 find the module and call it as an executable, since modules rarely
17 22 live in people's PATH.
18 23
19 24 * IPython/irunner.py (InteractiveRunner.__init__): added
20 25 delaybeforesend attribute to control delays with newer versions of
21 26 pexpect. Thanks to detailed help from pexpect's author, Noah
22 27 Spurrier <noah-AT-noah.org>. Noted how to use the SAGE runner
23 28 correctly (it works in NoColor mode).
24 29
25 30 * IPython/iplib.py (handle_normal): fix nasty crash reported on
26 31 SAGE list, from improper log() calls.
27 32
28 33 2006-05-31 Ville Vainio <vivainio@gmail.com>
29 34
30 35 * upgrade_dir.py, Magic.py (magic_upgrade): call upgrade_dir
31 36 with args in parens to work correctly with dirs that have spaces.
32 37
33 38 2006-05-30 Fernando Perez <Fernando.Perez@colorado.edu>
34 39
35 40 * IPython/Logger.py (Logger.logstart): add option to log raw input
36 41 instead of the processed one. A -r flag was added to the
37 42 %logstart magic used for controlling logging.
38 43
39 44 2006-05-29 Fernando Perez <Fernando.Perez@colorado.edu>
40 45
41 46 * IPython/iplib.py (InteractiveShell.__init__): add check for the
42 47 *BSDs to omit --color from all 'ls' aliases, since *BSD ls doesn't
43 48 recognize the option. After a bug report by Will Maier. This
44 49 closes #64 (will do it after confirmation from W. Maier).
45 50
46 51 * IPython/irunner.py: New module to run scripts as if manually
47 52 typed into an interactive environment, based on pexpect. After a
48 53 submission by Ken Schutte <kschutte-AT-csail.mit.edu> on the
49 54 ipython-user list. Simple unittests in the tests/ directory.
50 55
51 56 * tools/release: add Will Maier, OpenBSD port maintainer, to
52 57 recepients list. We are now officially part of the OpenBSD ports:
53 58 http://www.openbsd.org/ports.html ! Many thanks to Will for the
54 59 work.
55 60
56 61 2006-05-26 Fernando Perez <Fernando.Perez@colorado.edu>
57 62
58 63 * IPython/ipmaker.py (make_IPython): modify sys.argv fix (below)
59 64 so that it doesn't break tkinter apps.
60 65
61 66 * IPython/iplib.py (_prefilter): fix bug where aliases would
62 67 shadow variables when autocall was fully off. Reported by SAGE
63 68 author William Stein.
64 69
65 70 * IPython/OInspect.py (Inspector.__init__): add a flag to control
66 71 at what detail level strings are computed when foo? is requested.
67 72 This allows users to ask for example that the string form of an
68 73 object is only computed when foo?? is called, or even never, by
69 74 setting the object_info_string_level >= 2 in the configuration
70 75 file. This new option has been added and documented. After a
71 76 request by SAGE to be able to control the printing of very large
72 77 objects more easily.
73 78
74 79 2006-05-25 Fernando Perez <Fernando.Perez@colorado.edu>
75 80
76 81 * IPython/ipmaker.py (make_IPython): remove the ipython call path
77 82 from sys.argv, to be 100% consistent with how Python itself works
78 83 (as seen for example with python -i file.py). After a bug report
79 84 by Jeffrey Collins.
80 85
81 86 * IPython/Shell.py (MatplotlibShellBase._matplotlib_config): Fix
82 87 nasty bug which was preventing custom namespaces with -pylab,
83 88 reported by M. Foord. Minor cleanup, remove old matplotlib.matlab
84 89 compatibility (long gone from mpl).
85 90
86 91 * IPython/ipapi.py (make_session): name change: create->make. We
87 92 use make in other places (ipmaker,...), it's shorter and easier to
88 93 type and say, etc. I'm trying to clean things before 0.7.2 so
89 94 that I can keep things stable wrt to ipapi in the chainsaw branch.
90 95
91 96 * ipython.el: fix the py-pdbtrack-input-prompt variable so that
92 97 python-mode recognizes our debugger mode. Add support for
93 98 autoindent inside (X)emacs. After a patch sent in by Jin Liu
94 99 <m.liu.jin-AT-gmail.com> originally written by
95 100 doxgen-AT-newsmth.net (with minor modifications for xemacs
96 101 compatibility)
97 102
98 103 * IPython/Debugger.py (Pdb.format_stack_entry): fix formatting of
99 104 tracebacks when walking the stack so that the stack tracking system
100 105 in emacs' python-mode can identify the frames correctly.
101 106
102 107 * IPython/ipmaker.py (make_IPython): make the internal (and
103 108 default config) autoedit_syntax value false by default. Too many
104 109 users have complained to me (both on and off-list) about problems
105 110 with this option being on by default, so I'm making it default to
106 111 off. It can still be enabled by anyone via the usual mechanisms.
107 112
108 113 * IPython/completer.py (Completer.attr_matches): add support for
109 114 PyCrust-style _getAttributeNames magic method. Patch contributed
110 115 by <mscott-AT-goldenspud.com>. Closes #50.
111 116
112 117 * IPython/iplib.py (InteractiveShell.__init__): remove the
113 118 deletion of exit/quit from __builtin__, which can break
114 119 third-party tools like the Zope debugging console. The
115 120 %exit/%quit magics remain. In general, it's probably a good idea
116 121 not to delete anything from __builtin__, since we never know what
117 122 that will break. In any case, python now (for 2.5) will support
118 123 'real' exit/quit, so this issue is moot. Closes #55.
119 124
120 125 * IPython/genutils.py (with_obj): rename the 'with' function to
121 126 'withobj' to avoid incompatibilities with Python 2.5, where 'with'
122 127 becomes a language keyword. Closes #53.
123 128
124 129 * IPython/FakeModule.py (FakeModule.__init__): add a proper
125 130 __file__ attribute to this so it fools more things into thinking
126 131 it is a real module. Closes #59.
127 132
128 133 * IPython/Magic.py (magic_edit): add -n option to open the editor
129 134 at a specific line number. After a patch by Stefan van der Walt.
130 135
131 136 2006-05-23 Fernando Perez <Fernando.Perez@colorado.edu>
132 137
133 138 * IPython/iplib.py (edit_syntax_error): fix crash when for some
134 139 reason the file could not be opened. After automatic crash
135 140 reports sent by James Graham <jgraham-AT-ast.cam.ac.uk> and
136 141 Charles Dolan <charlespatrickdolan-AT-yahoo.com>.
137 142 (_should_recompile): Don't fire editor if using %bg, since there
138 143 is no file in the first place. From the same report as above.
139 144 (raw_input): protect against faulty third-party prefilters. After
140 145 an automatic crash report sent by Dirk Laurie <dirk-AT-sun.ac.za>
141 146 while running under SAGE.
142 147
143 148 2006-05-23 Ville Vainio <vivainio@gmail.com>
144 149
145 150 * ipapi.py: Stripped down ip.to_user_ns() to work only as
146 151 ip.to_user_ns("x1 y1"), which exposes vars x1 and y1. ipapi.get()
147 152 now returns None (again), unless dummy is specifically allowed by
148 153 ipapi.get(allow_dummy=True).
149 154
150 155 2006-05-18 Fernando Perez <Fernando.Perez@colorado.edu>
151 156
152 157 * IPython: remove all 2.2-compatibility objects and hacks from
153 158 everywhere, since we only support 2.3 at this point. Docs
154 159 updated.
155 160
156 161 * IPython/ipapi.py (IPApi.__init__): Clean up of all getters.
157 162 Anything requiring extra validation can be turned into a Python
158 163 property in the future. I used a property for the db one b/c
159 164 there was a nasty circularity problem with the initialization
160 165 order, which right now I don't have time to clean up.
161 166
162 167 * IPython/Shell.py (MTInteractiveShell.runcode): Fix, I think,
163 168 another locking bug reported by Jorgen. I'm not 100% sure though,
164 169 so more testing is needed...
165 170
166 171 2006-05-17 Fernando Perez <Fernando.Perez@colorado.edu>
167 172
168 173 * IPython/ipapi.py (IPApi.to_user_ns): New function to inject
169 174 local variables from any routine in user code (typically executed
170 175 with %run) directly into the interactive namespace. Very useful
171 176 when doing complex debugging.
172 177 (IPythonNotRunning): Changed the default None object to a dummy
173 178 whose attributes can be queried as well as called without
174 179 exploding, to ease writing code which works transparently both in
175 180 and out of ipython and uses some of this API.
176 181
177 182 2006-05-16 Fernando Perez <Fernando.Perez@colorado.edu>
178 183
179 184 * IPython/hooks.py (result_display): Fix the fact that our display
180 185 hook was using str() instead of repr(), as the default python
181 186 console does. This had gone unnoticed b/c it only happened if
182 187 %Pprint was off, but the inconsistency was there.
183 188
184 189 2006-05-15 Ville Vainio <vivainio@gmail.com>
185 190
186 191 * Oinspect.py: Only show docstring for nonexisting/binary files
187 192 when doing object??, closing ticket #62
188 193
189 194 2006-05-13 Fernando Perez <Fernando.Perez@colorado.edu>
190 195
191 196 * IPython/Shell.py (MTInteractiveShell.runsource): Fix threading
192 197 bug, closes http://www.scipy.net/roundup/ipython/issue55. A lock
193 198 was being released in a routine which hadn't checked if it had
194 199 been the one to acquire it.
195 200
196 201 2006-05-07 Fernando Perez <Fernando.Perez@colorado.edu>
197 202
198 203 * IPython/Release.py (version): put out 0.7.2.rc1 for testing.
199 204
200 205 2006-04-11 Ville Vainio <vivainio@gmail.com>
201 206
202 207 * iplib.py, ipmaker.py: .ipy extension now means "ipython batch file"
203 208 in command line. E.g. "ipython test.ipy" runs test.ipy with ipython
204 209 prefilters, allowing stuff like magics and aliases in the file.
205 210
206 211 * Prompts.py, Extensions/clearcmd.py, ipy_system_conf.py: %clear magic
207 212 added. Supported now are "%clear in" and "%clear out" (clear input and
208 213 output history, respectively). Also fixed CachedOutput.flush to
209 214 properly flush the output cache.
210 215
211 216 * Extensions/pspersistence.py: Fix %store to avoid "%store obj.attr"
212 217 half-success (and fail explicitly).
213 218
214 219 2006-03-28 Ville Vainio <vivainio@gmail.com>
215 220
216 221 * iplib.py: Fix quoting of aliases so that only argless ones
217 222 are quoted
218 223
219 224 2006-03-28 Ville Vainio <vivainio@gmail.com>
220 225
221 226 * iplib.py: Quote aliases with spaces in the name.
222 227 "c:\program files\blah\bin" is now legal alias target.
223 228
224 229 * ext_rehashdir.py: Space no longer allowed as arg
225 230 separator, since space is legal in path names.
226 231
227 232 2006-03-16 Ville Vainio <vivainio@gmail.com>
228 233
229 234 * upgrade_dir.py: Take path.py from Extensions, correcting
230 235 %upgrade magic
231 236
232 237 * ipmaker.py: Suggest using %upgrade if ipy_user_conf.py isn't found.
233 238
234 239 * hooks.py: Only enclose editor binary in quotes if legal and
235 240 necessary (space in the name, and is an existing file). Fixes a bug
236 241 reported by Zachary Pincus.
237 242
238 243 2006-03-13 Fernando Perez <Fernando.Perez@colorado.edu>
239 244
240 245 * Manual: thanks to a tip on proper color handling for Emacs, by
241 246 Eric J Haywiser <ejh1-AT-MIT.EDU>.
242 247
243 248 * ipython.el: close http://www.scipy.net/roundup/ipython/issue57
244 249 by applying the provided patch. Thanks to Liu Jin
245 250 <m.liu.jin-AT-gmail.com> for the contribution. No problems under
246 251 XEmacs/Linux, I'm trusting the submitter that it actually helps
247 252 under win32/GNU Emacs. Will revisit if any problems are reported.
248 253
249 254 2006-03-12 Fernando Perez <Fernando.Perez@colorado.edu>
250 255
251 256 * IPython/Gnuplot2.py (_FileClass): update for current Gnuplot.py
252 257 from SVN, thanks to a patch by Ryan Woodard <rywo@bas.ac.uk>.
253 258
254 259 2006-03-12 Ville Vainio <vivainio@gmail.com>
255 260
256 261 * Magic.py (magic_timeit): Added %timeit magic, contributed by
257 262 Torsten Marek.
258 263
259 264 2006-03-12 Fernando Perez <Fernando.Perez@colorado.edu>
260 265
261 266 * IPython/Magic.py (magic_macro): fix so that the n1-n2 syntax for
262 267 line ranges works again.
263 268
264 269 2006-03-11 Fernando Perez <Fernando.Perez@colorado.edu>
265 270
266 271 * IPython/iplib.py (showtraceback): add back sys.last_traceback
267 272 and friends, after a discussion with Zach Pincus on ipython-user.
268 273 I'm not 100% sure, but after thinking aobut it quite a bit, it may
269 274 be OK. Testing with the multithreaded shells didn't reveal any
270 275 problems, but let's keep an eye out.
271 276
272 277 In the process, I fixed a few things which were calling
273 278 self.InteractiveTB() directly (like safe_execfile), which is a
274 279 mistake: ALL exception reporting should be done by calling
275 280 self.showtraceback(), which handles state and tab-completion and
276 281 more.
277 282
278 283 2006-03-01 Ville Vainio <vivainio@gmail.com>
279 284
280 285 * Extensions/ipipe.py: Added Walter Doerwald's "ipipe" module.
281 286 To use, do "from ipipe import *".
282 287
283 288 2006-02-24 Ville Vainio <vivainio@gmail.com>
284 289
285 290 * Magic.py, upgrade_dir.py: %upgrade magic added. Does things more
286 291 "cleanly" and safely than the older upgrade mechanism.
287 292
288 293 2006-02-21 Ville Vainio <vivainio@gmail.com>
289 294
290 295 * Magic.py: %save works again.
291 296
292 297 2006-02-15 Ville Vainio <vivainio@gmail.com>
293 298
294 299 * Magic.py: %Pprint works again
295 300
296 301 * Extensions/ipy_sane_defaults.py: Provide everything provided
297 302 in default ipythonrc, to make it possible to have a completely empty
298 303 ipythonrc (and thus completely rc-file free configuration)
299 304
300 305
301 306 2006-02-11 Fernando Perez <Fernando.Perez@colorado.edu>
302 307
303 308 * IPython/hooks.py (editor): quote the call to the editor command,
304 309 to allow commands with spaces in them. Problem noted by watching
305 310 Ian Oswald's video about textpad under win32 at
306 311 http://showmedo.com/videoListPage?listKey=PythonIPythonSeries
307 312
308 313 * IPython/UserConfig/ipythonrc: Replace @ signs with % when
309 314 describing magics (we haven't used @ for a loong time).
310 315
311 316 * IPython/ultraTB.py (VerboseTB.text.text_repr): Added patch
312 317 contributed by marienz to close
313 318 http://www.scipy.net/roundup/ipython/issue53.
314 319
315 320 2006-02-10 Ville Vainio <vivainio@gmail.com>
316 321
317 322 * genutils.py: getoutput now works in win32 too
318 323
319 324 * completer.py: alias and magic completion only invoked
320 325 at the first "item" in the line, to avoid "cd %store"
321 326 nonsense.
322 327
323 328 2006-02-09 Ville Vainio <vivainio@gmail.com>
324 329
325 330 * test/*: Added a unit testing framework (finally).
326 331 '%run runtests.py' to run test_*.
327 332
328 333 * ipapi.py: Exposed runlines and set_custom_exc
329 334
330 335 2006-02-07 Ville Vainio <vivainio@gmail.com>
331 336
332 337 * iplib.py: don't split "f 1 2" to "f(1,2)" in autocall,
333 338 instead use "f(1 2)" as before.
334 339
335 340 2006-02-05 Fernando Perez <Fernando.Perez@colorado.edu>
336 341
337 342 * IPython/demo.py (IPythonDemo): Add new classes to the demo
338 343 facilities, for demos processed by the IPython input filter
339 344 (IPythonDemo), and for running a script one-line-at-a-time as a
340 345 demo, both for pure Python (LineDemo) and for IPython-processed
341 346 input (IPythonLineDemo). After a request by Dave Kohel, from the
342 347 SAGE team.
343 348 (Demo.edit): added and edit() method to the demo objects, to edit
344 349 the in-memory copy of the last executed block.
345 350
346 351 * IPython/Magic.py (magic_edit): add '-r' option for 'raw'
347 352 processing to %edit, %macro and %save. These commands can now be
348 353 invoked on the unprocessed input as it was typed by the user
349 354 (without any prefilters applied). After requests by the SAGE team
350 355 at SAGE days 2006: http://modular.ucsd.edu/sage/days1/schedule.html.
351 356
352 357 2006-02-01 Ville Vainio <vivainio@gmail.com>
353 358
354 359 * setup.py, eggsetup.py: easy_install ipython==dev works
355 360 correctly now (on Linux)
356 361
357 362 * ipy_user_conf,ipmaker: user config changes, removed spurious
358 363 warnings
359 364
360 365 * iplib: if rc.banner is string, use it as is.
361 366
362 367 * Magic: %pycat accepts a string argument and pages it's contents.
363 368
364 369
365 370 2006-01-30 Ville Vainio <vivainio@gmail.com>
366 371
367 372 * pickleshare,pspersistence,ipapi,Magic: persistence overhaul.
368 373 Now %store and bookmarks work through PickleShare, meaning that
369 374 concurrent access is possible and all ipython sessions see the
370 375 same database situation all the time, instead of snapshot of
371 376 the situation when the session was started. Hence, %bookmark
372 377 results are immediately accessible from othes sessions. The database
373 378 is also available for use by user extensions. See:
374 379 http://www.python.org/pypi/pickleshare
375 380
376 381 * hooks.py: Two new hooks, 'shutdown_hook' and 'late_startup_hook'.
377 382
378 383 * aliases can now be %store'd
379 384
380 385 * path.py move to Extensions so that pickleshare does not need
381 386 IPython-specific import. Extensions added to pythonpath right
382 387 at __init__.
383 388
384 389 * iplib.py: ipalias deprecated/redundant; aliases are converted and
385 390 called with _ip.system and the pre-transformed command string.
386 391
387 392 2006-01-29 Fernando Perez <Fernando.Perez@colorado.edu>
388 393
389 394 * IPython/iplib.py (interact): Fix that we were not catching
390 395 KeyboardInterrupt exceptions properly. I'm not quite sure why the
391 396 logic here had to change, but it's fixed now.
392 397
393 398 2006-01-29 Ville Vainio <vivainio@gmail.com>
394 399
395 400 * iplib.py: Try to import pyreadline on Windows.
396 401
397 402 2006-01-27 Ville Vainio <vivainio@gmail.com>
398 403
399 404 * iplib.py: Expose ipapi as _ip in builtin namespace.
400 405 Makes ipmagic (-> _ip.magic), ipsystem (-> _ip.system)
401 406 and ip_set_hook (-> _ip.set_hook) redundant. % and !
402 407 syntax now produce _ip.* variant of the commands.
403 408
404 409 * "_ip.options().autoedit_syntax = 2" automatically throws
405 410 user to editor for syntax error correction without prompting.
406 411
407 412 2006-01-27 Ville Vainio <vivainio@gmail.com>
408 413
409 414 * ipmaker.py: Give "realistic" sys.argv for scripts (without
410 415 'ipython' at argv[0]) executed through command line.
411 416 NOTE: this DEPRECATES calling ipython with multiple scripts
412 417 ("ipython a.py b.py c.py")
413 418
414 419 * iplib.py, hooks.py: Added configurable input prefilter,
415 420 named 'input_prefilter'. See ext_rescapture.py for example
416 421 usage.
417 422
418 423 * ext_rescapture.py, Magic.py: Better system command output capture
419 424 through 'var = !ls' (deprecates user-visible %sc). Same notation
420 425 applies for magics, 'var = %alias' assigns alias list to var.
421 426
422 427 * ipapi.py: added meta() for accessing extension-usable data store.
423 428
424 429 * iplib.py: added InteractiveShell.getapi(). New magics should be
425 430 written doing self.getapi() instead of using the shell directly.
426 431
427 432 * Magic.py: %store now allows doing %store foo > ~/myfoo.txt and
428 433 %store foo >> ~/myfoo.txt to store variables to files (in clean
429 434 textual form, not a restorable pickle).
430 435
431 436 * ipmaker.py: now import ipy_profile_PROFILENAME automatically
432 437
433 438 * usage.py, Magic.py: added %quickref
434 439
435 440 * iplib.py: ESC_PAREN fixes: /f 1 2 -> f(1,2), not f(1 2).
436 441
437 442 * GetoptErrors when invoking magics etc. with wrong args
438 443 are now more helpful:
439 444 GetoptError: option -l not recognized (allowed: "qb" )
440 445
441 446 2006-01-25 Fernando Perez <Fernando.Perez@colorado.edu>
442 447
443 448 * IPython/demo.py (Demo.show): Flush stdout after each block, so
444 449 computationally intensive blocks don't appear to stall the demo.
445 450
446 451 2006-01-24 Ville Vainio <vivainio@gmail.com>
447 452
448 453 * iplib.py, hooks.py: 'result_display' hook can return a non-None
449 454 value to manipulate resulting history entry.
450 455
451 456 * ipapi.py: Moved TryNext here from hooks.py. Moved functions
452 457 to instance methods of IPApi class, to make extending an embedded
453 458 IPython feasible. See ext_rehashdir.py for example usage.
454 459
455 460 * Merged 1071-1076 from banches/0.7.1
456 461
457 462
458 463 2006-01-23 Fernando Perez <Fernando.Perez@colorado.edu>
459 464
460 465 * tools/release (daystamp): Fix build tools to use the new
461 466 eggsetup.py script to build lightweight eggs.
462 467
463 468 * Applied changesets 1062 and 1064 before 0.7.1 release.
464 469
465 470 * IPython/Magic.py (magic_history): Add '-r' option to %hist, to
466 471 see the raw input history (without conversions like %ls ->
467 472 ipmagic("ls")). After a request from W. Stein, SAGE
468 473 (http://modular.ucsd.edu/sage) developer. This information is
469 474 stored in the input_hist_raw attribute of the IPython instance, so
470 475 developers can access it if needed (it's an InputList instance).
471 476
472 477 * Versionstring = 0.7.2.svn
473 478
474 479 * eggsetup.py: A separate script for constructing eggs, creates
475 480 proper launch scripts even on Windows (an .exe file in
476 481 \python24\scripts).
477 482
478 483 * ipapi.py: launch_new_instance, launch entry point needed for the
479 484 egg.
480 485
481 486 2006-01-23 Ville Vainio <vivainio@gmail.com>
482 487
483 488 * Added %cpaste magic for pasting python code
484 489
485 490 2006-01-22 Ville Vainio <vivainio@gmail.com>
486 491
487 492 * Merge from branches/0.7.1 into trunk, revs 1052-1057
488 493
489 494 * Versionstring = 0.7.2.svn
490 495
491 496 * eggsetup.py: A separate script for constructing eggs, creates
492 497 proper launch scripts even on Windows (an .exe file in
493 498 \python24\scripts).
494 499
495 500 * ipapi.py: launch_new_instance, launch entry point needed for the
496 501 egg.
497 502
498 503 2006-01-22 Fernando Perez <Fernando.Perez@colorado.edu>
499 504
500 505 * IPython/OInspect.py (Inspector.pinfo): fix bug where foo?? or
501 506 %pfile foo would print the file for foo even if it was a binary.
502 507 Now, extensions '.so' and '.dll' are skipped.
503 508
504 509 * IPython/Shell.py (MTInteractiveShell.__init__): Fix threading
505 510 bug, where macros would fail in all threaded modes. I'm not 100%
506 511 sure, so I'm going to put out an rc instead of making a release
507 512 today, and wait for feedback for at least a few days.
508 513
509 514 * IPython/iplib.py (handle_normal): fix (finally? somehow I doubt
510 515 it...) the handling of pasting external code with autoindent on.
511 516 To get out of a multiline input, the rule will appear for most
512 517 users unchanged: two blank lines or change the indent level
513 518 proposed by IPython. But there is a twist now: you can
514 519 add/subtract only *one or two spaces*. If you add/subtract three
515 520 or more (unless you completely delete the line), IPython will
516 521 accept that line, and you'll need to enter a second one of pure
517 522 whitespace. I know it sounds complicated, but I can't find a
518 523 different solution that covers all the cases, with the right
519 524 heuristics. Hopefully in actual use, nobody will really notice
520 525 all these strange rules and things will 'just work'.
521 526
522 527 2006-01-21 Fernando Perez <Fernando.Perez@colorado.edu>
523 528
524 529 * IPython/iplib.py (interact): catch exceptions which can be
525 530 triggered asynchronously by signal handlers. Thanks to an
526 531 automatic crash report, submitted by Colin Kingsley
527 532 <tercel-AT-gentoo.org>.
528 533
529 534 2006-01-20 Ville Vainio <vivainio@gmail.com>
530 535
531 536 * Ipython/Extensions/ext_rehashdir.py: Created a usable example
532 537 (%rehashdir, very useful, try it out) of how to extend ipython
533 538 with new magics. Also added Extensions dir to pythonpath to make
534 539 importing extensions easy.
535 540
536 541 * %store now complains when trying to store interactively declared
537 542 classes / instances of those classes.
538 543
539 544 * Extensions/ipy_system_conf.py, UserConfig/ipy_user_conf.py,
540 545 ipmaker.py: Config rehaul. Now ipy_..._conf.py are always imported
541 546 if they exist, and ipy_user_conf.py with some defaults is created for
542 547 the user.
543 548
544 549 * Startup rehashing done by the config file, not InterpreterExec.
545 550 This means system commands are available even without selecting the
546 551 pysh profile. It's the sensible default after all.
547 552
548 553 2006-01-20 Fernando Perez <Fernando.Perez@colorado.edu>
549 554
550 555 * IPython/iplib.py (raw_input): I _think_ I got the pasting of
551 556 multiline code with autoindent on working. But I am really not
552 557 sure, so this needs more testing. Will commit a debug-enabled
553 558 version for now, while I test it some more, so that Ville and
554 559 others may also catch any problems. Also made
555 560 self.indent_current_str() a method, to ensure that there's no
556 561 chance of the indent space count and the corresponding string
557 562 falling out of sync. All code needing the string should just call
558 563 the method.
559 564
560 565 2006-01-18 Fernando Perez <Fernando.Perez@colorado.edu>
561 566
562 567 * IPython/Magic.py (magic_edit): fix check for when users don't
563 568 save their output files, the try/except was in the wrong section.
564 569
565 570 2006-01-17 Fernando Perez <Fernando.Perez@colorado.edu>
566 571
567 572 * IPython/Magic.py (magic_run): fix __file__ global missing from
568 573 script's namespace when executed via %run. After a report by
569 574 Vivian.
570 575
571 576 * IPython/Debugger.py (Pdb.__init__): Fix breakage with '%run -d'
572 577 when using python 2.4. The parent constructor changed in 2.4, and
573 578 we need to track it directly (we can't call it, as it messes up
574 579 readline and tab-completion inside our pdb would stop working).
575 580 After a bug report by R. Bernstein <rocky-AT-panix.com>.
576 581
577 582 2006-01-16 Ville Vainio <vivainio@gmail.com>
578 583
579 584 * Ipython/magic.py:Reverted back to old %edit functionality
580 585 that returns file contents on exit.
581 586
582 587 * IPython/path.py: Added Jason Orendorff's "path" module to
583 588 IPython tree, http://www.jorendorff.com/articles/python/path/.
584 589 You can get path objects conveniently through %sc, and !!, e.g.:
585 590 sc files=ls
586 591 for p in files.paths: # or files.p
587 592 print p,p.mtime
588 593
589 594 * Ipython/iplib.py:"," and ";" autoquoting-upon-autocall
590 595 now work again without considering the exclusion regexp -
591 596 hence, things like ',foo my/path' turn to 'foo("my/path")'
592 597 instead of syntax error.
593 598
594 599
595 600 2006-01-14 Ville Vainio <vivainio@gmail.com>
596 601
597 602 * IPython/ipapi.py (ashook, asmagic, options): Added convenience
598 603 ipapi decorators for python 2.4 users, options() provides access to rc
599 604 data.
600 605
601 606 * IPython/Magic.py (magic_cd): %cd now accepts backslashes
602 607 as path separators (even on Linux ;-). Space character after
603 608 backslash (as yielded by tab completer) is still space;
604 609 "%cd long\ name" works as expected.
605 610
606 611 * IPython/ipapi.py,hooks.py,iplib.py: Hooks now implemented
607 612 as "chain of command", with priority. API stays the same,
608 613 TryNext exception raised by a hook function signals that
609 614 current hook failed and next hook should try handling it, as
610 615 suggested by Walter DΓΆrwald <walter@livinglogic.de>. Walter also
611 616 requested configurable display hook, which is now implemented.
612 617
613 618 2006-01-13 Ville Vainio <vivainio@gmail.com>
614 619
615 620 * IPython/platutils*.py: platform specific utility functions,
616 621 so far only set_term_title is implemented (change terminal
617 622 label in windowing systems). %cd now changes the title to
618 623 current dir.
619 624
620 625 * IPython/Release.py: Added myself to "authors" list,
621 626 had to create new files.
622 627
623 628 * IPython/iplib.py (handle_shell_escape): fixed logical flaw in
624 629 shell escape; not a known bug but had potential to be one in the
625 630 future.
626 631
627 632 * IPython/ipapi.py (added),OInspect.py,iplib.py: "Public"
628 633 extension API for IPython! See the module for usage example. Fix
629 634 OInspect for docstring-less magic functions.
630 635
631 636
632 637 2006-01-13 Fernando Perez <Fernando.Perez@colorado.edu>
633 638
634 639 * IPython/iplib.py (raw_input): temporarily deactivate all
635 640 attempts at allowing pasting of code with autoindent on. It
636 641 introduced bugs (reported by Prabhu) and I can't seem to find a
637 642 robust combination which works in all cases. Will have to revisit
638 643 later.
639 644
640 645 * IPython/genutils.py: remove isspace() function. We've dropped
641 646 2.2 compatibility, so it's OK to use the string method.
642 647
643 648 2006-01-12 Fernando Perez <Fernando.Perez@colorado.edu>
644 649
645 650 * IPython/iplib.py (InteractiveShell.__init__): fix regexp
646 651 matching what NOT to autocall on, to include all python binary
647 652 operators (including things like 'and', 'or', 'is' and 'in').
648 653 Prompted by a bug report on 'foo & bar', but I realized we had
649 654 many more potential bug cases with other operators. The regexp is
650 655 self.re_exclude_auto, it's fairly commented.
651 656
652 657 2006-01-12 Ville Vainio <vivainio@gmail.com>
653 658
654 659 * IPython/iplib.py (make_quoted_expr,handle_shell_escape):
655 660 Prettified and hardened string/backslash quoting with ipsystem(),
656 661 ipalias() and ipmagic(). Now even \ characters are passed to
657 662 %magics, !shell escapes and aliases exactly as they are in the
658 663 ipython command line. Should improve backslash experience,
659 664 particularly in Windows (path delimiter for some commands that
660 665 won't understand '/'), but Unix benefits as well (regexps). %cd
661 666 magic still doesn't support backslash path delimiters, though. Also
662 667 deleted all pretense of supporting multiline command strings in
663 668 !system or %magic commands. Thanks to Jerry McRae for suggestions.
664 669
665 670 * doc/build_doc_instructions.txt added. Documentation on how to
666 671 use doc/update_manual.py, added yesterday. Both files contributed
667 672 by JΓΆrgen Stenarson <jorgen.stenarson-AT-bostream.nu>. This slates
668 673 doc/*.sh for deprecation at a later date.
669 674
670 675 * /ipython.py Added ipython.py to root directory for
671 676 zero-installation (tar xzvf ipython.tgz; cd ipython; python
672 677 ipython.py) and development convenience (no need to kee doing
673 678 "setup.py install" between changes).
674 679
675 680 * Made ! and !! shell escapes work (again) in multiline expressions:
676 681 if 1:
677 682 !ls
678 683 !!ls
679 684
680 685 2006-01-12 Fernando Perez <Fernando.Perez@colorado.edu>
681 686
682 687 * IPython/ipstruct.py (Struct): Rename IPython.Struct to
683 688 IPython.ipstruct, to avoid local shadowing of the stdlib 'struct'
684 689 module in case-insensitive installation. Was causing crashes
685 690 under win32. Closes http://www.scipy.net/roundup/ipython/issue49.
686 691
687 692 * IPython/Magic.py (magic_pycat): Fix pycat, patch by Marien Zwart
688 693 <marienz-AT-gentoo.org>, closes
689 694 http://www.scipy.net/roundup/ipython/issue51.
690 695
691 696 2006-01-11 Fernando Perez <Fernando.Perez@colorado.edu>
692 697
693 698 * IPython/Shell.py (IPShellGTK.on_timer): Finally fix the the
694 699 problem of excessive CPU usage under *nix and keyboard lag under
695 700 win32.
696 701
697 702 2006-01-10 *** Released version 0.7.0
698 703
699 704 2006-01-10 Fernando Perez <Fernando.Perez@colorado.edu>
700 705
701 706 * IPython/Release.py (revision): tag version number to 0.7.0,
702 707 ready for release.
703 708
704 709 * IPython/Magic.py (magic_edit): Add print statement to %edit so
705 710 it informs the user of the name of the temp. file used. This can
706 711 help if you decide later to reuse that same file, so you know
707 712 where to copy the info from.
708 713
709 714 2006-01-09 Fernando Perez <Fernando.Perez@colorado.edu>
710 715
711 716 * setup_bdist_egg.py: little script to build an egg. Added
712 717 support in the release tools as well.
713 718
714 719 2006-01-08 Fernando Perez <Fernando.Perez@colorado.edu>
715 720
716 721 * IPython/Shell.py (IPShellWX.__init__): add support for WXPython
717 722 version selection (new -wxversion command line and ipythonrc
718 723 parameter). Patch contributed by Arnd Baecker
719 724 <arnd.baecker-AT-web.de>.
720 725
721 726 * IPython/iplib.py (embed_mainloop): fix tab-completion in
722 727 embedded instances, for variables defined at the interactive
723 728 prompt of the embedded ipython. Reported by Arnd.
724 729
725 730 * IPython/Magic.py (magic_autocall): Fix %autocall magic. Now
726 731 it can be used as a (stateful) toggle, or with a direct parameter.
727 732
728 733 * IPython/ultraTB.py (_fixed_getinnerframes): remove debug assert which
729 734 could be triggered in certain cases and cause the traceback
730 735 printer not to work.
731 736
732 737 2006-01-07 Fernando Perez <Fernando.Perez@colorado.edu>
733 738
734 739 * IPython/iplib.py (_should_recompile): Small fix, closes
735 740 http://www.scipy.net/roundup/ipython/issue48. Patch by Scott.
736 741
737 742 2006-01-04 Fernando Perez <Fernando.Perez@colorado.edu>
738 743
739 744 * IPython/Shell.py (IPShellGTK.mainloop): fix bug in the GTK
740 745 backend for matplotlib (100% cpu utiliziation). Thanks to Charlie
741 746 Moad for help with tracking it down.
742 747
743 748 * IPython/iplib.py (handle_auto): fix autocall handling for
744 749 objects which support BOTH __getitem__ and __call__ (so that f [x]
745 750 is left alone, instead of becoming f([x]) automatically).
746 751
747 752 * IPython/Magic.py (magic_cd): fix crash when cd -b was used.
748 753 Ville's patch.
749 754
750 755 2006-01-03 Fernando Perez <Fernando.Perez@colorado.edu>
751 756
752 757 * IPython/iplib.py (handle_auto): changed autocall semantics to
753 758 include 'smart' mode, where the autocall transformation is NOT
754 759 applied if there are no arguments on the line. This allows you to
755 760 just type 'foo' if foo is a callable to see its internal form,
756 761 instead of having it called with no arguments (typically a
757 762 mistake). The old 'full' autocall still exists: for that, you
758 763 need to set the 'autocall' parameter to 2 in your ipythonrc file.
759 764
760 765 * IPython/completer.py (Completer.attr_matches): add
761 766 tab-completion support for Enthoughts' traits. After a report by
762 767 Arnd and a patch by Prabhu.
763 768
764 769 2006-01-02 Fernando Perez <Fernando.Perez@colorado.edu>
765 770
766 771 * IPython/ultraTB.py (_fixed_getinnerframes): added Alex
767 772 Schmolck's patch to fix inspect.getinnerframes().
768 773
769 774 * IPython/iplib.py (InteractiveShell.__init__): significant fixes
770 775 for embedded instances, regarding handling of namespaces and items
771 776 added to the __builtin__ one. Multiple embedded instances and
772 777 recursive embeddings should work better now (though I'm not sure
773 778 I've got all the corner cases fixed, that code is a bit of a brain
774 779 twister).
775 780
776 781 * IPython/Magic.py (magic_edit): added support to edit in-memory
777 782 macros (automatically creates the necessary temp files). %edit
778 783 also doesn't return the file contents anymore, it's just noise.
779 784
780 785 * IPython/completer.py (Completer.attr_matches): revert change to
781 786 complete only on attributes listed in __all__. I realized it
782 787 cripples the tab-completion system as a tool for exploring the
783 788 internals of unknown libraries (it renders any non-__all__
784 789 attribute off-limits). I got bit by this when trying to see
785 790 something inside the dis module.
786 791
787 792 2005-12-31 Fernando Perez <Fernando.Perez@colorado.edu>
788 793
789 794 * IPython/iplib.py (InteractiveShell.__init__): add .meta
790 795 namespace for users and extension writers to hold data in. This
791 796 follows the discussion in
792 797 http://projects.scipy.org/ipython/ipython/wiki/RefactoringIPython.
793 798
794 799 * IPython/completer.py (IPCompleter.complete): small patch to help
795 800 tab-completion under Emacs, after a suggestion by John Barnard
796 801 <barnarj-AT-ccf.org>.
797 802
798 803 * IPython/Magic.py (Magic.extract_input_slices): added support for
799 804 the slice notation in magics to use N-M to represent numbers N...M
800 805 (closed endpoints). This is used by %macro and %save.
801 806
802 807 * IPython/completer.py (Completer.attr_matches): for modules which
803 808 define __all__, complete only on those. After a patch by Jeffrey
804 809 Collins <jcollins_boulder-AT-earthlink.net>. Also, clean up and
805 810 speed up this routine.
806 811
807 812 * IPython/Logger.py (Logger.log): fix a history handling bug. I
808 813 don't know if this is the end of it, but the behavior now is
809 814 certainly much more correct. Note that coupled with macros,
810 815 slightly surprising (at first) behavior may occur: a macro will in
811 816 general expand to multiple lines of input, so upon exiting, the
812 817 in/out counters will both be bumped by the corresponding amount
813 818 (as if the macro's contents had been typed interactively). Typing
814 819 %hist will reveal the intermediate (silently processed) lines.
815 820
816 821 * IPython/Magic.py (magic_run): fix a subtle bug which could cause
817 822 pickle to fail (%run was overwriting __main__ and not restoring
818 823 it, but pickle relies on __main__ to operate).
819 824
820 825 * IPython/iplib.py (InteractiveShell): fix pdb calling: I'm now
821 826 using properties, but forgot to make the main InteractiveShell
822 827 class a new-style class. Properties fail silently, and
823 828 misteriously, with old-style class (getters work, but
824 829 setters don't do anything).
825 830
826 831 2005-12-30 Fernando Perez <Fernando.Perez@colorado.edu>
827 832
828 833 * IPython/Magic.py (magic_history): fix history reporting bug (I
829 834 know some nasties are still there, I just can't seem to find a
830 835 reproducible test case to track them down; the input history is
831 836 falling out of sync...)
832 837
833 838 * IPython/iplib.py (handle_shell_escape): fix bug where both
834 839 aliases and system accesses where broken for indented code (such
835 840 as loops).
836 841
837 842 * IPython/genutils.py (shell): fix small but critical bug for
838 843 win32 system access.
839 844
840 845 2005-12-29 Fernando Perez <Fernando.Perez@colorado.edu>
841 846
842 847 * IPython/iplib.py (showtraceback): remove use of the
843 848 sys.last_{type/value/traceback} structures, which are non
844 849 thread-safe.
845 850 (_prefilter): change control flow to ensure that we NEVER
846 851 introspect objects when autocall is off. This will guarantee that
847 852 having an input line of the form 'x.y', where access to attribute
848 853 'y' has side effects, doesn't trigger the side effect TWICE. It
849 854 is important to note that, with autocall on, these side effects
850 855 can still happen.
851 856 (ipsystem): new builtin, to complete the ip{magic/alias/system}
852 857 trio. IPython offers these three kinds of special calls which are
853 858 not python code, and it's a good thing to have their call method
854 859 be accessible as pure python functions (not just special syntax at
855 860 the command line). It gives us a better internal implementation
856 861 structure, as well as exposing these for user scripting more
857 862 cleanly.
858 863
859 864 * IPython/macro.py (Macro.__init__): moved macros to a standalone
860 865 file. Now that they'll be more likely to be used with the
861 866 persistance system (%store), I want to make sure their module path
862 867 doesn't change in the future, so that we don't break things for
863 868 users' persisted data.
864 869
865 870 * IPython/iplib.py (autoindent_update): move indentation
866 871 management into the _text_ processing loop, not the keyboard
867 872 interactive one. This is necessary to correctly process non-typed
868 873 multiline input (such as macros).
869 874
870 875 * IPython/Magic.py (Magic.format_latex): patch by Stefan van der
871 876 Walt <stefan-AT-sun.ac.za> to fix latex formatting of docstrings,
872 877 which was producing problems in the resulting manual.
873 878 (magic_whos): improve reporting of instances (show their class,
874 879 instead of simply printing 'instance' which isn't terribly
875 880 informative).
876 881
877 882 * IPython/genutils.py (shell): commit Jorgen Stenarson's patch
878 883 (minor mods) to support network shares under win32.
879 884
880 885 * IPython/winconsole.py (get_console_size): add new winconsole
881 886 module and fixes to page_dumb() to improve its behavior under
882 887 win32. Contributed by Alexander Belchenko <bialix-AT-ukr.net>.
883 888
884 889 * IPython/Magic.py (Macro): simplified Macro class to just
885 890 subclass list. We've had only 2.2 compatibility for a very long
886 891 time, yet I was still avoiding subclassing the builtin types. No
887 892 more (I'm also starting to use properties, though I won't shift to
888 893 2.3-specific features quite yet).
889 894 (magic_store): added Ville's patch for lightweight variable
890 895 persistence, after a request on the user list by Matt Wilkie
891 896 <maphew-AT-gmail.com>. The new %store magic's docstring has full
892 897 details.
893 898
894 899 * IPython/iplib.py (InteractiveShell.post_config_initialization):
895 900 changed the default logfile name from 'ipython.log' to
896 901 'ipython_log.py'. These logs are real python files, and now that
897 902 we have much better multiline support, people are more likely to
898 903 want to use them as such. Might as well name them correctly.
899 904
900 905 * IPython/Magic.py: substantial cleanup. While we can't stop
901 906 using magics as mixins, due to the existing customizations 'out
902 907 there' which rely on the mixin naming conventions, at least I
903 908 cleaned out all cross-class name usage. So once we are OK with
904 909 breaking compatibility, the two systems can be separated.
905 910
906 911 * IPython/Logger.py: major cleanup. This one is NOT a mixin
907 912 anymore, and the class is a fair bit less hideous as well. New
908 913 features were also introduced: timestamping of input, and logging
909 914 of output results. These are user-visible with the -t and -o
910 915 options to %logstart. Closes
911 916 http://www.scipy.net/roundup/ipython/issue11 and a request by
912 917 William Stein (SAGE developer - http://modular.ucsd.edu/sage).
913 918
914 919 2005-12-28 Fernando Perez <Fernando.Perez@colorado.edu>
915 920
916 921 * IPython/iplib.py (handle_shell_escape): add Ville's patch to
917 922 better hadnle backslashes in paths. See the thread 'More Windows
918 923 questions part 2 - \/ characters revisited' on the iypthon user
919 924 list:
920 925 http://scipy.net/pipermail/ipython-user/2005-June/000907.html
921 926
922 927 (InteractiveShell.__init__): fix tab-completion bug in threaded shells.
923 928
924 929 (InteractiveShell.__init__): change threaded shells to not use the
925 930 ipython crash handler. This was causing more problems than not,
926 931 as exceptions in the main thread (GUI code, typically) would
927 932 always show up as a 'crash', when they really weren't.
928 933
929 934 The colors and exception mode commands (%colors/%xmode) have been
930 935 synchronized to also take this into account, so users can get
931 936 verbose exceptions for their threaded code as well. I also added
932 937 support for activating pdb inside this exception handler as well,
933 938 so now GUI authors can use IPython's enhanced pdb at runtime.
934 939
935 940 * IPython/ipmaker.py (make_IPython): make the autoedit_syntax flag
936 941 true by default, and add it to the shipped ipythonrc file. Since
937 942 this asks the user before proceeding, I think it's OK to make it
938 943 true by default.
939 944
940 945 * IPython/Magic.py (magic_exit): make new exit/quit magics instead
941 946 of the previous special-casing of input in the eval loop. I think
942 947 this is cleaner, as they really are commands and shouldn't have
943 948 a special role in the middle of the core code.
944 949
945 950 2005-12-27 Fernando Perez <Fernando.Perez@colorado.edu>
946 951
947 952 * IPython/iplib.py (edit_syntax_error): added support for
948 953 automatically reopening the editor if the file had a syntax error
949 954 in it. Thanks to scottt who provided the patch at:
950 955 http://www.scipy.net/roundup/ipython/issue36 (slightly modified
951 956 version committed).
952 957
953 958 * IPython/iplib.py (handle_normal): add suport for multi-line
954 959 input with emtpy lines. This fixes
955 960 http://www.scipy.net/roundup/ipython/issue43 and a similar
956 961 discussion on the user list.
957 962
958 963 WARNING: a behavior change is necessarily introduced to support
959 964 blank lines: now a single blank line with whitespace does NOT
960 965 break the input loop, which means that when autoindent is on, by
961 966 default hitting return on the next (indented) line does NOT exit.
962 967
963 968 Instead, to exit a multiline input you can either have:
964 969
965 970 - TWO whitespace lines (just hit return again), or
966 971 - a single whitespace line of a different length than provided
967 972 by the autoindent (add or remove a space).
968 973
969 974 * IPython/completer.py (MagicCompleter.__init__): new 'completer'
970 975 module to better organize all readline-related functionality.
971 976 I've deleted FlexCompleter and put all completion clases here.
972 977
973 978 * IPython/iplib.py (raw_input): improve indentation management.
974 979 It is now possible to paste indented code with autoindent on, and
975 980 the code is interpreted correctly (though it still looks bad on
976 981 screen, due to the line-oriented nature of ipython).
977 982 (MagicCompleter.complete): change behavior so that a TAB key on an
978 983 otherwise empty line actually inserts a tab, instead of completing
979 984 on the entire global namespace. This makes it easier to use the
980 985 TAB key for indentation. After a request by Hans Meine
981 986 <hans_meine-AT-gmx.net>
982 987 (_prefilter): add support so that typing plain 'exit' or 'quit'
983 988 does a sensible thing. Originally I tried to deviate as little as
984 989 possible from the default python behavior, but even that one may
985 990 change in this direction (thread on python-dev to that effect).
986 991 Regardless, ipython should do the right thing even if CPython's
987 992 '>>>' prompt doesn't.
988 993 (InteractiveShell): removed subclassing code.InteractiveConsole
989 994 class. By now we'd overridden just about all of its methods: I've
990 995 copied the remaining two over, and now ipython is a standalone
991 996 class. This will provide a clearer picture for the chainsaw
992 997 branch refactoring.
993 998
994 999 2005-12-26 Fernando Perez <Fernando.Perez@colorado.edu>
995 1000
996 1001 * IPython/ultraTB.py (VerboseTB.text): harden reporting against
997 1002 failures for objects which break when dir() is called on them.
998 1003
999 1004 * IPython/FlexCompleter.py (Completer.__init__): Added support for
1000 1005 distinct local and global namespaces in the completer API. This
1001 1006 change allows us top properly handle completion with distinct
1002 1007 scopes, including in embedded instances (this had never really
1003 1008 worked correctly).
1004 1009
1005 1010 Note: this introduces a change in the constructor for
1006 1011 MagicCompleter, as a new global_namespace parameter is now the
1007 1012 second argument (the others were bumped one position).
1008 1013
1009 1014 2005-12-25 Fernando Perez <Fernando.Perez@colorado.edu>
1010 1015
1011 1016 * IPython/iplib.py (embed_mainloop): fix tab-completion in
1012 1017 embedded instances (which can be done now thanks to Vivian's
1013 1018 frame-handling fixes for pdb).
1014 1019 (InteractiveShell.__init__): Fix namespace handling problem in
1015 1020 embedded instances. We were overwriting __main__ unconditionally,
1016 1021 and this should only be done for 'full' (non-embedded) IPython;
1017 1022 embedded instances must respect the caller's __main__. Thanks to
1018 1023 a bug report by Yaroslav Bulatov <yaroslavvb-AT-gmail.com>
1019 1024
1020 1025 2005-12-24 Fernando Perez <Fernando.Perez@colorado.edu>
1021 1026
1022 1027 * setup.py: added download_url to setup(). This registers the
1023 1028 download address at PyPI, which is not only useful to humans
1024 1029 browsing the site, but is also picked up by setuptools (the Eggs
1025 1030 machinery). Thanks to Ville and R. Kern for the info/discussion
1026 1031 on this.
1027 1032
1028 1033 2005-12-23 Fernando Perez <Fernando.Perez@colorado.edu>
1029 1034
1030 1035 * IPython/Debugger.py (Pdb.__init__): Major pdb mode enhancements.
1031 1036 This brings a lot of nice functionality to the pdb mode, which now
1032 1037 has tab-completion, syntax highlighting, and better stack handling
1033 1038 than before. Many thanks to Vivian De Smedt
1034 1039 <vivian-AT-vdesmedt.com> for the original patches.
1035 1040
1036 1041 2005-12-08 Fernando Perez <Fernando.Perez@colorado.edu>
1037 1042
1038 1043 * IPython/Shell.py (IPShellGTK.mainloop): fix mainloop() calling
1039 1044 sequence to consistently accept the banner argument. The
1040 1045 inconsistency was tripping SAGE, thanks to Gary Zablackis
1041 1046 <gzabl-AT-yahoo.com> for the report.
1042 1047
1043 1048 2005-11-15 Fernando Perez <Fernando.Perez@colorado.edu>
1044 1049
1045 1050 * IPython/iplib.py (InteractiveShell.post_config_initialization):
1046 1051 Fix bug where a naked 'alias' call in the ipythonrc file would
1047 1052 cause a crash. Bug reported by Jorgen Stenarson.
1048 1053
1049 1054 2005-11-15 Fernando Perez <Fernando.Perez@colorado.edu>
1050 1055
1051 1056 * IPython/ipmaker.py (make_IPython): cleanups which should improve
1052 1057 startup time.
1053 1058
1054 1059 * IPython/iplib.py (runcode): my globals 'fix' for embedded
1055 1060 instances had introduced a bug with globals in normal code. Now
1056 1061 it's working in all cases.
1057 1062
1058 1063 * IPython/Magic.py (magic_psearch): Finish wildcard cleanup and
1059 1064 API changes. A new ipytonrc option, 'wildcards_case_sensitive'
1060 1065 has been introduced to set the default case sensitivity of the
1061 1066 searches. Users can still select either mode at runtime on a
1062 1067 per-search basis.
1063 1068
1064 1069 2005-11-13 Fernando Perez <Fernando.Perez@colorado.edu>
1065 1070
1066 1071 * IPython/wildcard.py (NameSpace.__init__): fix resolution of
1067 1072 attributes in wildcard searches for subclasses. Modified version
1068 1073 of a patch by Jorgen.
1069 1074
1070 1075 2005-11-12 Fernando Perez <Fernando.Perez@colorado.edu>
1071 1076
1072 1077 * IPython/iplib.py (embed_mainloop): Fix handling of globals for
1073 1078 embedded instances. I added a user_global_ns attribute to the
1074 1079 InteractiveShell class to handle this.
1075 1080
1076 1081 2005-10-31 Fernando Perez <Fernando.Perez@colorado.edu>
1077 1082
1078 1083 * IPython/Shell.py (IPShellGTK.mainloop): Change timeout_add to
1079 1084 idle_add, which fixes horrible keyboard lag problems under gtk 2.6
1080 1085 (reported under win32, but may happen also in other platforms).
1081 1086 Bug report and fix courtesy of Sean Moore <smm-AT-logic.bm>
1082 1087
1083 1088 2005-10-15 Fernando Perez <Fernando.Perez@colorado.edu>
1084 1089
1085 1090 * IPython/Magic.py (magic_psearch): new support for wildcard
1086 1091 patterns. Now, typing ?a*b will list all names which begin with a
1087 1092 and end in b, for example. The %psearch magic has full
1088 1093 docstrings. Many thanks to JΓΆrgen Stenarson
1089 1094 <jorgen.stenarson-AT-bostream.nu>, author of the patches
1090 1095 implementing this functionality.
1091 1096
1092 1097 2005-09-27 Fernando Perez <Fernando.Perez@colorado.edu>
1093 1098
1094 1099 * Manual: fixed long-standing annoyance of double-dashes (as in
1095 1100 --prefix=~, for example) being stripped in the HTML version. This
1096 1101 is a latex2html bug, but a workaround was provided. Many thanks
1097 1102 to George K. Thiruvathukal <gthiruv-AT-luc.edu> for the detailed
1098 1103 help, and Michael Tobis <mtobis-AT-gmail.com> for getting the ball
1099 1104 rolling. This seemingly small issue had tripped a number of users
1100 1105 when first installing, so I'm glad to see it gone.
1101 1106
1102 1107 2005-09-27 Fernando Perez <Fernando.Perez@colorado.edu>
1103 1108
1104 1109 * IPython/Extensions/numeric_formats.py: fix missing import,
1105 1110 reported by Stephen Walton.
1106 1111
1107 1112 2005-09-24 Fernando Perez <Fernando.Perez@colorado.edu>
1108 1113
1109 1114 * IPython/demo.py: finish demo module, fully documented now.
1110 1115
1111 1116 * IPython/genutils.py (file_read): simple little utility to read a
1112 1117 file and ensure it's closed afterwards.
1113 1118
1114 1119 2005-09-23 Fernando Perez <Fernando.Perez@colorado.edu>
1115 1120
1116 1121 * IPython/demo.py (Demo.__init__): added support for individually
1117 1122 tagging blocks for automatic execution.
1118 1123
1119 1124 * IPython/Magic.py (magic_pycat): new %pycat magic for showing
1120 1125 syntax-highlighted python sources, requested by John.
1121 1126
1122 1127 2005-09-22 Fernando Perez <Fernando.Perez@colorado.edu>
1123 1128
1124 1129 * IPython/demo.py (Demo.again): fix bug where again() blocks after
1125 1130 finishing.
1126 1131
1127 1132 * IPython/genutils.py (shlex_split): moved from Magic to here,
1128 1133 where all 2.2 compatibility stuff lives. I needed it for demo.py.
1129 1134
1130 1135 * IPython/demo.py (Demo.__init__): added support for silent
1131 1136 blocks, improved marks as regexps, docstrings written.
1132 1137 (Demo.__init__): better docstring, added support for sys.argv.
1133 1138
1134 1139 * IPython/genutils.py (marquee): little utility used by the demo
1135 1140 code, handy in general.
1136 1141
1137 1142 * IPython/demo.py (Demo.__init__): new class for interactive
1138 1143 demos. Not documented yet, I just wrote it in a hurry for
1139 1144 scipy'05. Will docstring later.
1140 1145
1141 1146 2005-09-20 Fernando Perez <Fernando.Perez@colorado.edu>
1142 1147
1143 1148 * IPython/Shell.py (sigint_handler): Drastic simplification which
1144 1149 also seems to make Ctrl-C work correctly across threads! This is
1145 1150 so simple, that I can't beleive I'd missed it before. Needs more
1146 1151 testing, though.
1147 1152 (KBINT): Never mind, revert changes. I'm sure I'd tried something
1148 1153 like this before...
1149 1154
1150 1155 * IPython/genutils.py (get_home_dir): add protection against
1151 1156 non-dirs in win32 registry.
1152 1157
1153 1158 * IPython/iplib.py (InteractiveShell.alias_table_validate): fix
1154 1159 bug where dict was mutated while iterating (pysh crash).
1155 1160
1156 1161 2005-09-06 Fernando Perez <Fernando.Perez@colorado.edu>
1157 1162
1158 1163 * IPython/iplib.py (handle_auto): Fix inconsistency arising from
1159 1164 spurious newlines added by this routine. After a report by
1160 1165 F. Mantegazza.
1161 1166
1162 1167 2005-09-05 Fernando Perez <Fernando.Perez@colorado.edu>
1163 1168
1164 1169 * IPython/Shell.py (hijack_gtk): remove pygtk.require("2.0")
1165 1170 calls. These were a leftover from the GTK 1.x days, and can cause
1166 1171 problems in certain cases (after a report by John Hunter).
1167 1172
1168 1173 * IPython/iplib.py (InteractiveShell.__init__): Trap exception if
1169 1174 os.getcwd() fails at init time. Thanks to patch from David Remahl
1170 1175 <chmod007-AT-mac.com>.
1171 1176 (InteractiveShell.__init__): prevent certain special magics from
1172 1177 being shadowed by aliases. Closes
1173 1178 http://www.scipy.net/roundup/ipython/issue41.
1174 1179
1175 1180 2005-08-31 Fernando Perez <Fernando.Perez@colorado.edu>
1176 1181
1177 1182 * IPython/iplib.py (InteractiveShell.complete): Added new
1178 1183 top-level completion method to expose the completion mechanism
1179 1184 beyond readline-based environments.
1180 1185
1181 1186 2005-08-19 Fernando Perez <Fernando.Perez@colorado.edu>
1182 1187
1183 1188 * tools/ipsvnc (svnversion): fix svnversion capture.
1184 1189
1185 1190 * IPython/iplib.py (InteractiveShell.__init__): Add has_readline
1186 1191 attribute to self, which was missing. Before, it was set by a
1187 1192 routine which in certain cases wasn't being called, so the
1188 1193 instance could end up missing the attribute. This caused a crash.
1189 1194 Closes http://www.scipy.net/roundup/ipython/issue40.
1190 1195
1191 1196 2005-08-16 Fernando Perez <fperez@colorado.edu>
1192 1197
1193 1198 * IPython/ultraTB.py (VerboseTB.text): don't crash if object
1194 1199 contains non-string attribute. Closes
1195 1200 http://www.scipy.net/roundup/ipython/issue38.
1196 1201
1197 1202 2005-08-14 Fernando Perez <fperez@colorado.edu>
1198 1203
1199 1204 * tools/ipsvnc: Minor improvements, to add changeset info.
1200 1205
1201 1206 2005-08-12 Fernando Perez <fperez@colorado.edu>
1202 1207
1203 1208 * IPython/iplib.py (runsource): remove self.code_to_run_src
1204 1209 attribute. I realized this is nothing more than
1205 1210 '\n'.join(self.buffer), and having the same data in two different
1206 1211 places is just asking for synchronization bugs. This may impact
1207 1212 people who have custom exception handlers, so I need to warn
1208 1213 ipython-dev about it (F. Mantegazza may use them).
1209 1214
1210 1215 2005-07-29 Fernando Perez <Fernando.Perez@colorado.edu>
1211 1216
1212 1217 * IPython/genutils.py: fix 2.2 compatibility (generators)
1213 1218
1214 1219 2005-07-18 Fernando Perez <fperez@colorado.edu>
1215 1220
1216 1221 * IPython/genutils.py (get_home_dir): fix to help users with
1217 1222 invalid $HOME under win32.
1218 1223
1219 1224 2005-07-17 Fernando Perez <fperez@colorado.edu>
1220 1225
1221 1226 * IPython/Prompts.py (str_safe): Make unicode-safe. Also remove
1222 1227 some old hacks and clean up a bit other routines; code should be
1223 1228 simpler and a bit faster.
1224 1229
1225 1230 * IPython/iplib.py (interact): removed some last-resort attempts
1226 1231 to survive broken stdout/stderr. That code was only making it
1227 1232 harder to abstract out the i/o (necessary for gui integration),
1228 1233 and the crashes it could prevent were extremely rare in practice
1229 1234 (besides being fully user-induced in a pretty violent manner).
1230 1235
1231 1236 * IPython/genutils.py (IOStream.__init__): Simplify the i/o stuff.
1232 1237 Nothing major yet, but the code is simpler to read; this should
1233 1238 make it easier to do more serious modifications in the future.
1234 1239
1235 1240 * IPython/Extensions/InterpreterExec.py: Fix auto-quoting in pysh,
1236 1241 which broke in .15 (thanks to a report by Ville).
1237 1242
1238 1243 * IPython/Itpl.py (Itpl.__init__): add unicode support (it may not
1239 1244 be quite correct, I know next to nothing about unicode). This
1240 1245 will allow unicode strings to be used in prompts, amongst other
1241 1246 cases. It also will prevent ipython from crashing when unicode
1242 1247 shows up unexpectedly in many places. If ascii encoding fails, we
1243 1248 assume utf_8. Currently the encoding is not a user-visible
1244 1249 setting, though it could be made so if there is demand for it.
1245 1250
1246 1251 * IPython/ipmaker.py (make_IPython): remove old 2.1-specific hack.
1247 1252
1248 1253 * IPython/Struct.py (Struct.merge): switch keys() to iterator.
1249 1254
1250 1255 * IPython/background_jobs.py: moved 2.2 compatibility to genutils.
1251 1256
1252 1257 * IPython/genutils.py: Add 2.2 compatibility here, so all other
1253 1258 code can work transparently for 2.2/2.3.
1254 1259
1255 1260 2005-07-16 Fernando Perez <fperez@colorado.edu>
1256 1261
1257 1262 * IPython/ultraTB.py (ExceptionColors): Make a global variable
1258 1263 out of the color scheme table used for coloring exception
1259 1264 tracebacks. This allows user code to add new schemes at runtime.
1260 1265 This is a minimally modified version of the patch at
1261 1266 http://www.scipy.net/roundup/ipython/issue35, many thanks to pabw
1262 1267 for the contribution.
1263 1268
1264 1269 * IPython/FlexCompleter.py (Completer.attr_matches): Add a
1265 1270 slightly modified version of the patch in
1266 1271 http://www.scipy.net/roundup/ipython/issue34, which also allows me
1267 1272 to remove the previous try/except solution (which was costlier).
1268 1273 Thanks to Gaetan Lehmann <gaetan.lehmann-AT-jouy.inra.fr> for the fix.
1269 1274
1270 1275 2005-06-08 Fernando Perez <fperez@colorado.edu>
1271 1276
1272 1277 * IPython/iplib.py (write/write_err): Add methods to abstract all
1273 1278 I/O a bit more.
1274 1279
1275 1280 * IPython/Shell.py (IPShellGTK.mainloop): Fix GTK deprecation
1276 1281 warning, reported by Aric Hagberg, fix by JD Hunter.
1277 1282
1278 1283 2005-06-02 *** Released version 0.6.15
1279 1284
1280 1285 2005-06-01 Fernando Perez <fperez@colorado.edu>
1281 1286
1282 1287 * IPython/iplib.py (MagicCompleter.file_matches): Fix
1283 1288 tab-completion of filenames within open-quoted strings. Note that
1284 1289 this requires that in ~/.ipython/ipythonrc, users change the
1285 1290 readline delimiters configuration to read:
1286 1291
1287 1292 readline_remove_delims -/~
1288 1293
1289 1294
1290 1295 2005-05-31 *** Released version 0.6.14
1291 1296
1292 1297 2005-05-29 Fernando Perez <fperez@colorado.edu>
1293 1298
1294 1299 * IPython/ultraTB.py (VerboseTB.text): Fix crash for tracebacks
1295 1300 with files not on the filesystem. Reported by Eliyahu Sandler
1296 1301 <eli@gondolin.net>
1297 1302
1298 1303 2005-05-22 Fernando Perez <fperez@colorado.edu>
1299 1304
1300 1305 * IPython/iplib.py: Fix a few crashes in the --upgrade option.
1301 1306 After an initial report by LUK ShunTim <shuntim.luk@polyu.edu.hk>.
1302 1307
1303 1308 2005-05-19 Fernando Perez <fperez@colorado.edu>
1304 1309
1305 1310 * IPython/iplib.py (safe_execfile): close a file which could be
1306 1311 left open (causing problems in win32, which locks open files).
1307 1312 Thanks to a bug report by D Brown <dbrown2@yahoo.com>.
1308 1313
1309 1314 2005-05-18 Fernando Perez <fperez@colorado.edu>
1310 1315
1311 1316 * IPython/Shell.py (MatplotlibShellBase.mplot_exec): pass all
1312 1317 keyword arguments correctly to safe_execfile().
1313 1318
1314 1319 2005-05-13 Fernando Perez <fperez@colorado.edu>
1315 1320
1316 1321 * ipython.1: Added info about Qt to manpage, and threads warning
1317 1322 to usage page (invoked with --help).
1318 1323
1319 1324 * IPython/iplib.py (MagicCompleter.python_func_kw_matches): Added
1320 1325 new matcher (it goes at the end of the priority list) to do
1321 1326 tab-completion on named function arguments. Submitted by George
1322 1327 Sakkis <gsakkis-AT-eden.rutgers.edu>. See the thread at
1323 1328 http://www.scipy.net/pipermail/ipython-dev/2005-April/000436.html
1324 1329 for more details.
1325 1330
1326 1331 * IPython/Magic.py (magic_run): Added new -e flag to ignore
1327 1332 SystemExit exceptions in the script being run. Thanks to a report
1328 1333 by danny shevitz <danny_shevitz-AT-yahoo.com>, about this
1329 1334 producing very annoying behavior when running unit tests.
1330 1335
1331 1336 2005-05-12 Fernando Perez <fperez@colorado.edu>
1332 1337
1333 1338 * IPython/iplib.py (handle_auto): fixed auto-quoting and parens,
1334 1339 which I'd broken (again) due to a changed regexp. In the process,
1335 1340 added ';' as an escape to auto-quote the whole line without
1336 1341 splitting its arguments. Thanks to a report by Jerry McRae
1337 1342 <qrs0xyc02-AT-sneakemail.com>.
1338 1343
1339 1344 * IPython/ultraTB.py (VerboseTB.text): protect against rare but
1340 1345 possible crashes caused by a TokenError. Reported by Ed Schofield
1341 1346 <schofield-AT-ftw.at>.
1342 1347
1343 1348 2005-05-06 Fernando Perez <fperez@colorado.edu>
1344 1349
1345 1350 * IPython/Shell.py (hijack_wx): Fix to work with WX v.2.6.
1346 1351
1347 1352 2005-04-29 Fernando Perez <fperez@colorado.edu>
1348 1353
1349 1354 * IPython/Shell.py (IPShellQt): Thanks to Denis Rivière
1350 1355 <nudz-AT-free.fr>, Yann Cointepas <yann-AT-sapetnioc.org> and Benjamin
1351 1356 Thyreau <Benji2-AT-decideur.info>, we now have a -qthread option
1352 1357 which provides support for Qt interactive usage (similar to the
1353 1358 existing one for WX and GTK). This had been often requested.
1354 1359
1355 1360 2005-04-14 *** Released version 0.6.13
1356 1361
1357 1362 2005-04-08 Fernando Perez <fperez@colorado.edu>
1358 1363
1359 1364 * IPython/Magic.py (Magic._ofind): remove docstring evaluation
1360 1365 from _ofind, which gets called on almost every input line. Now,
1361 1366 we only try to get docstrings if they are actually going to be
1362 1367 used (the overhead of fetching unnecessary docstrings can be
1363 1368 noticeable for certain objects, such as Pyro proxies).
1364 1369
1365 1370 * IPython/iplib.py (MagicCompleter.python_matches): Change the API
1366 1371 for completers. For some reason I had been passing them the state
1367 1372 variable, which completers never actually need, and was in
1368 1373 conflict with the rlcompleter API. Custom completers ONLY need to
1369 1374 take the text parameter.
1370 1375
1371 1376 * IPython/Extensions/InterpreterExec.py: Fix regexp so that magics
1372 1377 work correctly in pysh. I've also moved all the logic which used
1373 1378 to be in pysh.py here, which will prevent problems with future
1374 1379 upgrades. However, this time I must warn users to update their
1375 1380 pysh profile to include the line
1376 1381
1377 1382 import_all IPython.Extensions.InterpreterExec
1378 1383
1379 1384 because otherwise things won't work for them. They MUST also
1380 1385 delete pysh.py and the line
1381 1386
1382 1387 execfile pysh.py
1383 1388
1384 1389 from their ipythonrc-pysh.
1385 1390
1386 1391 * IPython/FlexCompleter.py (Completer.attr_matches): Make more
1387 1392 robust in the face of objects whose dir() returns non-strings
1388 1393 (which it shouldn't, but some broken libs like ITK do). Thanks to
1389 1394 a patch by John Hunter (implemented differently, though). Also
1390 1395 minor improvements by using .extend instead of + on lists.
1391 1396
1392 1397 * pysh.py:
1393 1398
1394 1399 2005-04-06 Fernando Perez <fperez@colorado.edu>
1395 1400
1396 1401 * IPython/ipmaker.py (make_IPython): Make multi_line_specials on
1397 1402 by default, so that all users benefit from it. Those who don't
1398 1403 want it can still turn it off.
1399 1404
1400 1405 * IPython/UserConfig/ipythonrc: Add multi_line_specials to the
1401 1406 config file, I'd forgotten about this, so users were getting it
1402 1407 off by default.
1403 1408
1404 1409 * IPython/iplib.py (ipmagic): big overhaul of the magic system for
1405 1410 consistency. Now magics can be called in multiline statements,
1406 1411 and python variables can be expanded in magic calls via $var.
1407 1412 This makes the magic system behave just like aliases or !system
1408 1413 calls.
1409 1414
1410 1415 2005-03-28 Fernando Perez <fperez@colorado.edu>
1411 1416
1412 1417 * IPython/iplib.py (handle_auto): cleanup to use %s instead of
1413 1418 expensive string additions for building command. Add support for
1414 1419 trailing ';' when autocall is used.
1415 1420
1416 1421 2005-03-26 Fernando Perez <fperez@colorado.edu>
1417 1422
1418 1423 * ipython.el: Fix http://www.scipy.net/roundup/ipython/issue31.
1419 1424 Bugfix by A. Schmolck, the ipython.el maintainer. Also make
1420 1425 ipython.el robust against prompts with any number of spaces
1421 1426 (including 0) after the ':' character.
1422 1427
1423 1428 * IPython/Prompts.py (Prompt2.set_p_str): Fix spurious space in
1424 1429 continuation prompt, which misled users to think the line was
1425 1430 already indented. Closes debian Bug#300847, reported to me by
1426 1431 Norbert Tretkowski <tretkowski-AT-inittab.de>.
1427 1432
1428 1433 2005-03-23 Fernando Perez <fperez@colorado.edu>
1429 1434
1430 1435 * IPython/Prompts.py (Prompt1.__str__): Make sure that prompts are
1431 1436 properly aligned if they have embedded newlines.
1432 1437
1433 1438 * IPython/iplib.py (runlines): Add a public method to expose
1434 1439 IPython's code execution machinery, so that users can run strings
1435 1440 as if they had been typed at the prompt interactively.
1436 1441 (InteractiveShell.__init__): Added getoutput() to the __IPYTHON__
1437 1442 methods which can call the system shell, but with python variable
1438 1443 expansion. The three such methods are: __IPYTHON__.system,
1439 1444 .getoutput and .getoutputerror. These need to be documented in a
1440 1445 'public API' section (to be written) of the manual.
1441 1446
1442 1447 2005-03-20 Fernando Perez <fperez@colorado.edu>
1443 1448
1444 1449 * IPython/iplib.py (InteractiveShell.set_custom_exc): new system
1445 1450 for custom exception handling. This is quite powerful, and it
1446 1451 allows for user-installable exception handlers which can trap
1447 1452 custom exceptions at runtime and treat them separately from
1448 1453 IPython's default mechanisms. At the request of FrΓ©dΓ©ric
1449 1454 Mantegazza <mantegazza-AT-ill.fr>.
1450 1455 (InteractiveShell.set_custom_completer): public API function to
1451 1456 add new completers at runtime.
1452 1457
1453 1458 2005-03-19 Fernando Perez <fperez@colorado.edu>
1454 1459
1455 1460 * IPython/OInspect.py (getdoc): Add a call to obj.getdoc(), to
1456 1461 allow objects which provide their docstrings via non-standard
1457 1462 mechanisms (like Pyro proxies) to still be inspected by ipython's
1458 1463 ? system.
1459 1464
1460 1465 * IPython/iplib.py (InteractiveShell.__init__): back off the _o/_e
1461 1466 automatic capture system. I tried quite hard to make it work
1462 1467 reliably, and simply failed. I tried many combinations with the
1463 1468 subprocess module, but eventually nothing worked in all needed
1464 1469 cases (not blocking stdin for the child, duplicating stdout
1465 1470 without blocking, etc). The new %sc/%sx still do capture to these
1466 1471 magical list/string objects which make shell use much more
1467 1472 conveninent, so not all is lost.
1468 1473
1469 1474 XXX - FIX MANUAL for the change above!
1470 1475
1471 1476 (runsource): I copied code.py's runsource() into ipython to modify
1472 1477 it a bit. Now the code object and source to be executed are
1473 1478 stored in ipython. This makes this info accessible to third-party
1474 1479 tools, like custom exception handlers. After a request by FrΓ©dΓ©ric
1475 1480 Mantegazza <mantegazza-AT-ill.fr>.
1476 1481
1477 1482 * IPython/UserConfig/ipythonrc: Add up/down arrow keys to
1478 1483 history-search via readline (like C-p/C-n). I'd wanted this for a
1479 1484 long time, but only recently found out how to do it. For users
1480 1485 who already have their ipythonrc files made and want this, just
1481 1486 add:
1482 1487
1483 1488 readline_parse_and_bind "\e[A": history-search-backward
1484 1489 readline_parse_and_bind "\e[B": history-search-forward
1485 1490
1486 1491 2005-03-18 Fernando Perez <fperez@colorado.edu>
1487 1492
1488 1493 * IPython/Magic.py (magic_sc): %sc and %sx now use the fancy
1489 1494 LSString and SList classes which allow transparent conversions
1490 1495 between list mode and whitespace-separated string.
1491 1496 (magic_r): Fix recursion problem in %r.
1492 1497
1493 1498 * IPython/genutils.py (LSString): New class to be used for
1494 1499 automatic storage of the results of all alias/system calls in _o
1495 1500 and _e (stdout/err). These provide a .l/.list attribute which
1496 1501 does automatic splitting on newlines. This means that for most
1497 1502 uses, you'll never need to do capturing of output with %sc/%sx
1498 1503 anymore, since ipython keeps this always done for you. Note that
1499 1504 only the LAST results are stored, the _o/e variables are
1500 1505 overwritten on each call. If you need to save their contents
1501 1506 further, simply bind them to any other name.
1502 1507
1503 1508 2005-03-17 Fernando Perez <fperez@colorado.edu>
1504 1509
1505 1510 * IPython/Prompts.py (BasePrompt.cwd_filt): a few more fixes for
1506 1511 prompt namespace handling.
1507 1512
1508 1513 2005-03-16 Fernando Perez <fperez@colorado.edu>
1509 1514
1510 1515 * IPython/Prompts.py (CachedOutput.__init__): Fix default and
1511 1516 classic prompts to be '>>> ' (final space was missing, and it
1512 1517 trips the emacs python mode).
1513 1518 (BasePrompt.__str__): Added safe support for dynamic prompt
1514 1519 strings. Now you can set your prompt string to be '$x', and the
1515 1520 value of x will be printed from your interactive namespace. The
1516 1521 interpolation syntax includes the full Itpl support, so
1517 1522 ${foo()+x+bar()} is a valid prompt string now, and the function
1518 1523 calls will be made at runtime.
1519 1524
1520 1525 2005-03-15 Fernando Perez <fperez@colorado.edu>
1521 1526
1522 1527 * IPython/Magic.py (magic_history): renamed %hist to %history, to
1523 1528 avoid name clashes in pylab. %hist still works, it just forwards
1524 1529 the call to %history.
1525 1530
1526 1531 2005-03-02 *** Released version 0.6.12
1527 1532
1528 1533 2005-03-02 Fernando Perez <fperez@colorado.edu>
1529 1534
1530 1535 * IPython/iplib.py (handle_magic): log magic calls properly as
1531 1536 ipmagic() function calls.
1532 1537
1533 1538 * IPython/Magic.py (magic_time): Improved %time to support
1534 1539 statements and provide wall-clock as well as CPU time.
1535 1540
1536 1541 2005-02-27 Fernando Perez <fperez@colorado.edu>
1537 1542
1538 1543 * IPython/hooks.py: New hooks module, to expose user-modifiable
1539 1544 IPython functionality in a clean manner. For now only the editor
1540 1545 hook is actually written, and other thigns which I intend to turn
1541 1546 into proper hooks aren't yet there. The display and prefilter
1542 1547 stuff, for example, should be hooks. But at least now the
1543 1548 framework is in place, and the rest can be moved here with more
1544 1549 time later. IPython had had a .hooks variable for a long time for
1545 1550 this purpose, but I'd never actually used it for anything.
1546 1551
1547 1552 2005-02-26 Fernando Perez <fperez@colorado.edu>
1548 1553
1549 1554 * IPython/ipmaker.py (make_IPython): make the default ipython
1550 1555 directory be called _ipython under win32, to follow more the
1551 1556 naming peculiarities of that platform (where buggy software like
1552 1557 Visual Sourcesafe breaks with .named directories). Reported by
1553 1558 Ville Vainio.
1554 1559
1555 1560 2005-02-23 Fernando Perez <fperez@colorado.edu>
1556 1561
1557 1562 * IPython/iplib.py (InteractiveShell.__init__): removed a few
1558 1563 auto_aliases for win32 which were causing problems. Users can
1559 1564 define the ones they personally like.
1560 1565
1561 1566 2005-02-21 Fernando Perez <fperez@colorado.edu>
1562 1567
1563 1568 * IPython/Magic.py (magic_time): new magic to time execution of
1564 1569 expressions. After a request by Charles Moad <cmoad-AT-indiana.edu>.
1565 1570
1566 1571 2005-02-19 Fernando Perez <fperez@colorado.edu>
1567 1572
1568 1573 * IPython/ConfigLoader.py (ConfigLoader.load): Allow empty strings
1569 1574 into keys (for prompts, for example).
1570 1575
1571 1576 * IPython/Prompts.py (BasePrompt.set_p_str): Fix to allow empty
1572 1577 prompts in case users want them. This introduces a small behavior
1573 1578 change: ipython does not automatically add a space to all prompts
1574 1579 anymore. To get the old prompts with a space, users should add it
1575 1580 manually to their ipythonrc file, so for example prompt_in1 should
1576 1581 now read 'In [\#]: ' instead of 'In [\#]:'.
1577 1582 (BasePrompt.__init__): New option prompts_pad_left (only in rc
1578 1583 file) to control left-padding of secondary prompts.
1579 1584
1580 1585 * IPython/Magic.py (Magic.profile_missing_notice): Don't crash if
1581 1586 the profiler can't be imported. Fix for Debian, which removed
1582 1587 profile.py because of License issues. I applied a slightly
1583 1588 modified version of the original Debian patch at
1584 1589 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=294500.
1585 1590
1586 1591 2005-02-17 Fernando Perez <fperez@colorado.edu>
1587 1592
1588 1593 * IPython/genutils.py (native_line_ends): Fix bug which would
1589 1594 cause improper line-ends under win32 b/c I was not opening files
1590 1595 in binary mode. Bug report and fix thanks to Ville.
1591 1596
1592 1597 * IPython/iplib.py (handle_auto): Fix bug which I introduced when
1593 1598 trying to catch spurious foo[1] autocalls. My fix actually broke
1594 1599 ',/' autoquote/call with explicit escape (bad regexp).
1595 1600
1596 1601 2005-02-15 *** Released version 0.6.11
1597 1602
1598 1603 2005-02-14 Fernando Perez <fperez@colorado.edu>
1599 1604
1600 1605 * IPython/background_jobs.py: New background job management
1601 1606 subsystem. This is implemented via a new set of classes, and
1602 1607 IPython now provides a builtin 'jobs' object for background job
1603 1608 execution. A convenience %bg magic serves as a lightweight
1604 1609 frontend for starting the more common type of calls. This was
1605 1610 inspired by discussions with B. Granger and the BackgroundCommand
1606 1611 class described in the book Python Scripting for Computational
1607 1612 Science, by H. P. Langtangen: http://folk.uio.no/hpl/scripting
1608 1613 (although ultimately no code from this text was used, as IPython's
1609 1614 system is a separate implementation).
1610 1615
1611 1616 * IPython/iplib.py (MagicCompleter.python_matches): add new option
1612 1617 to control the completion of single/double underscore names
1613 1618 separately. As documented in the example ipytonrc file, the
1614 1619 readline_omit__names variable can now be set to 2, to omit even
1615 1620 single underscore names. Thanks to a patch by Brian Wong
1616 1621 <BrianWong-AT-AirgoNetworks.Com>.
1617 1622 (InteractiveShell.__init__): Fix bug which would cause foo[1] to
1618 1623 be autocalled as foo([1]) if foo were callable. A problem for
1619 1624 things which are both callable and implement __getitem__.
1620 1625 (init_readline): Fix autoindentation for win32. Thanks to a patch
1621 1626 by Vivian De Smedt <vivian-AT-vdesmedt.com>.
1622 1627
1623 1628 2005-02-12 Fernando Perez <fperez@colorado.edu>
1624 1629
1625 1630 * IPython/ipmaker.py (make_IPython): Disabled the stout traps
1626 1631 which I had written long ago to sort out user error messages which
1627 1632 may occur during startup. This seemed like a good idea initially,
1628 1633 but it has proven a disaster in retrospect. I don't want to
1629 1634 change much code for now, so my fix is to set the internal 'debug'
1630 1635 flag to true everywhere, whose only job was precisely to control
1631 1636 this subsystem. This closes issue 28 (as well as avoiding all
1632 1637 sorts of strange hangups which occur from time to time).
1633 1638
1634 1639 2005-02-07 Fernando Perez <fperez@colorado.edu>
1635 1640
1636 1641 * IPython/Magic.py (magic_edit): Fix 'ed -p' not working when the
1637 1642 previous call produced a syntax error.
1638 1643
1639 1644 * IPython/OInspect.py (Inspector.pinfo): Fix crash when inspecting
1640 1645 classes without constructor.
1641 1646
1642 1647 2005-02-06 Fernando Perez <fperez@colorado.edu>
1643 1648
1644 1649 * IPython/iplib.py (MagicCompleter.complete): Extend the list of
1645 1650 completions with the results of each matcher, so we return results
1646 1651 to the user from all namespaces. This breaks with ipython
1647 1652 tradition, but I think it's a nicer behavior. Now you get all
1648 1653 possible completions listed, from all possible namespaces (python,
1649 1654 filesystem, magics...) After a request by John Hunter
1650 1655 <jdhunter-AT-nitace.bsd.uchicago.edu>.
1651 1656
1652 1657 2005-02-05 Fernando Perez <fperez@colorado.edu>
1653 1658
1654 1659 * IPython/Magic.py (magic_prun): Fix bug where prun would fail if
1655 1660 the call had quote characters in it (the quotes were stripped).
1656 1661
1657 1662 2005-01-31 Fernando Perez <fperez@colorado.edu>
1658 1663
1659 1664 * IPython/iplib.py (InteractiveShell.__init__): reduce reliance on
1660 1665 Itpl.itpl() to make the code more robust against psyco
1661 1666 optimizations.
1662 1667
1663 1668 * IPython/Itpl.py (Itpl.__str__): Use a _getframe() call instead
1664 1669 of causing an exception. Quicker, cleaner.
1665 1670
1666 1671 2005-01-28 Fernando Perez <fperez@colorado.edu>
1667 1672
1668 1673 * scripts/ipython_win_post_install.py (install): hardcode
1669 1674 sys.prefix+'python.exe' as the executable path. It turns out that
1670 1675 during the post-installation run, sys.executable resolves to the
1671 1676 name of the binary installer! I should report this as a distutils
1672 1677 bug, I think. I updated the .10 release with this tiny fix, to
1673 1678 avoid annoying the lists further.
1674 1679
1675 1680 2005-01-27 *** Released version 0.6.10
1676 1681
1677 1682 2005-01-27 Fernando Perez <fperez@colorado.edu>
1678 1683
1679 1684 * IPython/numutils.py (norm): Added 'inf' as optional name for
1680 1685 L-infinity norm, included references to mathworld.com for vector
1681 1686 norm definitions.
1682 1687 (amin/amax): added amin/amax for array min/max. Similar to what
1683 1688 pylab ships with after the recent reorganization of names.
1684 1689 (spike/spike_odd): removed deprecated spike/spike_odd functions.
1685 1690
1686 1691 * ipython.el: committed Alex's recent fixes and improvements.
1687 1692 Tested with python-mode from CVS, and it looks excellent. Since
1688 1693 python-mode hasn't released anything in a while, I'm temporarily
1689 1694 putting a copy of today's CVS (v 4.70) of python-mode in:
1690 1695 http://ipython.scipy.org/tmp/python-mode.el
1691 1696
1692 1697 * scripts/ipython_win_post_install.py (install): Win32 fix to use
1693 1698 sys.executable for the executable name, instead of assuming it's
1694 1699 called 'python.exe' (the post-installer would have produced broken
1695 1700 setups on systems with a differently named python binary).
1696 1701
1697 1702 * IPython/PyColorize.py (Parser.__call__): change explicit '\n'
1698 1703 references to os.linesep, to make the code more
1699 1704 platform-independent. This is also part of the win32 coloring
1700 1705 fixes.
1701 1706
1702 1707 * IPython/genutils.py (page_dumb): Remove attempts to chop long
1703 1708 lines, which actually cause coloring bugs because the length of
1704 1709 the line is very difficult to correctly compute with embedded
1705 1710 escapes. This was the source of all the coloring problems under
1706 1711 Win32. I think that _finally_, Win32 users have a properly
1707 1712 working ipython in all respects. This would never have happened
1708 1713 if not for Gary Bishop and Viktor Ransmayr's great help and work.
1709 1714
1710 1715 2005-01-26 *** Released version 0.6.9
1711 1716
1712 1717 2005-01-25 Fernando Perez <fperez@colorado.edu>
1713 1718
1714 1719 * setup.py: finally, we have a true Windows installer, thanks to
1715 1720 the excellent work of Viktor Ransmayr
1716 1721 <viktor.ransmayr-AT-t-online.de>. The docs have been updated for
1717 1722 Windows users. The setup routine is quite a bit cleaner thanks to
1718 1723 this, and the post-install script uses the proper functions to
1719 1724 allow a clean de-installation using the standard Windows Control
1720 1725 Panel.
1721 1726
1722 1727 * IPython/genutils.py (get_home_dir): changed to use the $HOME
1723 1728 environment variable under all OSes (including win32) if
1724 1729 available. This will give consistency to win32 users who have set
1725 1730 this variable for any reason. If os.environ['HOME'] fails, the
1726 1731 previous policy of using HOMEDRIVE\HOMEPATH kicks in.
1727 1732
1728 1733 2005-01-24 Fernando Perez <fperez@colorado.edu>
1729 1734
1730 1735 * IPython/numutils.py (empty_like): add empty_like(), similar to
1731 1736 zeros_like() but taking advantage of the new empty() Numeric routine.
1732 1737
1733 1738 2005-01-23 *** Released version 0.6.8
1734 1739
1735 1740 2005-01-22 Fernando Perez <fperez@colorado.edu>
1736 1741
1737 1742 * IPython/Shell.py (MatplotlibShellBase.mplot_exec): I removed the
1738 1743 automatic show() calls. After discussing things with JDH, it
1739 1744 turns out there are too many corner cases where this can go wrong.
1740 1745 It's best not to try to be 'too smart', and simply have ipython
1741 1746 reproduce as much as possible the default behavior of a normal
1742 1747 python shell.
1743 1748
1744 1749 * IPython/iplib.py (InteractiveShell.__init__): Modified the
1745 1750 line-splitting regexp and _prefilter() to avoid calling getattr()
1746 1751 on assignments. This closes
1747 1752 http://www.scipy.net/roundup/ipython/issue24. Note that Python's
1748 1753 readline uses getattr(), so a simple <TAB> keypress is still
1749 1754 enough to trigger getattr() calls on an object.
1750 1755
1751 1756 2005-01-21 Fernando Perez <fperez@colorado.edu>
1752 1757
1753 1758 * IPython/Shell.py (MatplotlibShellBase.magic_run): Fix the %run
1754 1759 docstring under pylab so it doesn't mask the original.
1755 1760
1756 1761 2005-01-21 *** Released version 0.6.7
1757 1762
1758 1763 2005-01-21 Fernando Perez <fperez@colorado.edu>
1759 1764
1760 1765 * IPython/Shell.py (MTInteractiveShell.runcode): Trap a crash with
1761 1766 signal handling for win32 users in multithreaded mode.
1762 1767
1763 1768 2005-01-17 Fernando Perez <fperez@colorado.edu>
1764 1769
1765 1770 * IPython/OInspect.py (Inspector.pinfo): Fix crash when inspecting
1766 1771 instances with no __init__. After a crash report by Norbert Nemec
1767 1772 <Norbert-AT-nemec-online.de>.
1768 1773
1769 1774 2005-01-14 Fernando Perez <fperez@colorado.edu>
1770 1775
1771 1776 * IPython/ultraTB.py (VerboseTB.text): Fix bug in reporting of
1772 1777 names for verbose exceptions, when multiple dotted names and the
1773 1778 'parent' object were present on the same line.
1774 1779
1775 1780 2005-01-11 Fernando Perez <fperez@colorado.edu>
1776 1781
1777 1782 * IPython/genutils.py (flag_calls): new utility to trap and flag
1778 1783 calls in functions. I need it to clean up matplotlib support.
1779 1784 Also removed some deprecated code in genutils.
1780 1785
1781 1786 * IPython/Shell.py (MatplotlibShellBase.mplot_exec): small fix so
1782 1787 that matplotlib scripts called with %run, which don't call show()
1783 1788 themselves, still have their plotting windows open.
1784 1789
1785 1790 2005-01-05 Fernando Perez <fperez@colorado.edu>
1786 1791
1787 1792 * IPython/Shell.py (IPShellGTK.__init__): Patch by Andrew Straw
1788 1793 <astraw-AT-caltech.edu>, to fix gtk deprecation warnings.
1789 1794
1790 1795 2004-12-19 Fernando Perez <fperez@colorado.edu>
1791 1796
1792 1797 * IPython/Shell.py (MTInteractiveShell.runcode): Get rid of
1793 1798 parent_runcode, which was an eyesore. The same result can be
1794 1799 obtained with Python's regular superclass mechanisms.
1795 1800
1796 1801 2004-12-17 Fernando Perez <fperez@colorado.edu>
1797 1802
1798 1803 * IPython/Magic.py (Magic.magic_sc): Fix quote stripping problem
1799 1804 reported by Prabhu.
1800 1805 (Magic.magic_sx): direct all errors to Term.cerr (defaults to
1801 1806 sys.stderr) instead of explicitly calling sys.stderr. This helps
1802 1807 maintain our I/O abstractions clean, for future GUI embeddings.
1803 1808
1804 1809 * IPython/genutils.py (info): added new utility for sys.stderr
1805 1810 unified info message handling (thin wrapper around warn()).
1806 1811
1807 1812 * IPython/ultraTB.py (VerboseTB.text): Fix misreported global
1808 1813 composite (dotted) names on verbose exceptions.
1809 1814 (VerboseTB.nullrepr): harden against another kind of errors which
1810 1815 Python's inspect module can trigger, and which were crashing
1811 1816 IPython. Thanks to a report by Marco Lombardi
1812 1817 <mlombard-AT-ma010192.hq.eso.org>.
1813 1818
1814 1819 2004-12-13 *** Released version 0.6.6
1815 1820
1816 1821 2004-12-12 Fernando Perez <fperez@colorado.edu>
1817 1822
1818 1823 * IPython/Shell.py (IPShellGTK.mainloop): catch RuntimeErrors
1819 1824 generated by pygtk upon initialization if it was built without
1820 1825 threads (for matplotlib users). After a crash reported by
1821 1826 Leguijt, Jaap J SIEP-EPT-RES <Jaap.Leguijt-AT-shell.com>.
1822 1827
1823 1828 * IPython/ipmaker.py (make_IPython): fix small bug in the
1824 1829 import_some parameter for multiple imports.
1825 1830
1826 1831 * IPython/iplib.py (ipmagic): simplified the interface of
1827 1832 ipmagic() to take a single string argument, just as it would be
1828 1833 typed at the IPython cmd line.
1829 1834 (ipalias): Added new ipalias() with an interface identical to
1830 1835 ipmagic(). This completes exposing a pure python interface to the
1831 1836 alias and magic system, which can be used in loops or more complex
1832 1837 code where IPython's automatic line mangling is not active.
1833 1838
1834 1839 * IPython/genutils.py (timing): changed interface of timing to
1835 1840 simply run code once, which is the most common case. timings()
1836 1841 remains unchanged, for the cases where you want multiple runs.
1837 1842
1838 1843 * IPython/Shell.py (MatplotlibShellBase._matplotlib_config): Fix a
1839 1844 bug where Python2.2 crashes with exec'ing code which does not end
1840 1845 in a single newline. Python 2.3 is OK, so I hadn't noticed this
1841 1846 before.
1842 1847
1843 1848 2004-12-10 Fernando Perez <fperez@colorado.edu>
1844 1849
1845 1850 * IPython/Magic.py (Magic.magic_prun): changed name of option from
1846 1851 -t to -T, to accomodate the new -t flag in %run (the %run and
1847 1852 %prun options are kind of intermixed, and it's not easy to change
1848 1853 this with the limitations of python's getopt).
1849 1854
1850 1855 * IPython/Magic.py (Magic.magic_run): Added new -t option to time
1851 1856 the execution of scripts. It's not as fine-tuned as timeit.py,
1852 1857 but it works from inside ipython (and under 2.2, which lacks
1853 1858 timeit.py). Optionally a number of runs > 1 can be given for
1854 1859 timing very short-running code.
1855 1860
1856 1861 * IPython/genutils.py (uniq_stable): new routine which returns a
1857 1862 list of unique elements in any iterable, but in stable order of
1858 1863 appearance. I needed this for the ultraTB fixes, and it's a handy
1859 1864 utility.
1860 1865
1861 1866 * IPython/ultraTB.py (VerboseTB.text): Fix proper reporting of
1862 1867 dotted names in Verbose exceptions. This had been broken since
1863 1868 the very start, now x.y will properly be printed in a Verbose
1864 1869 traceback, instead of x being shown and y appearing always as an
1865 1870 'undefined global'. Getting this to work was a bit tricky,
1866 1871 because by default python tokenizers are stateless. Saved by
1867 1872 python's ability to easily add a bit of state to an arbitrary
1868 1873 function (without needing to build a full-blown callable object).
1869 1874
1870 1875 Also big cleanup of this code, which had horrendous runtime
1871 1876 lookups of zillions of attributes for colorization. Moved all
1872 1877 this code into a few templates, which make it cleaner and quicker.
1873 1878
1874 1879 Printout quality was also improved for Verbose exceptions: one
1875 1880 variable per line, and memory addresses are printed (this can be
1876 1881 quite handy in nasty debugging situations, which is what Verbose
1877 1882 is for).
1878 1883
1879 1884 * IPython/ipmaker.py (make_IPython): Do NOT execute files named in
1880 1885 the command line as scripts to be loaded by embedded instances.
1881 1886 Doing so has the potential for an infinite recursion if there are
1882 1887 exceptions thrown in the process. This fixes a strange crash
1883 1888 reported by Philippe MULLER <muller-AT-irit.fr>.
1884 1889
1885 1890 2004-12-09 Fernando Perez <fperez@colorado.edu>
1886 1891
1887 1892 * IPython/Shell.py (MatplotlibShellBase.use): Change pylab support
1888 1893 to reflect new names in matplotlib, which now expose the
1889 1894 matlab-compatible interface via a pylab module instead of the
1890 1895 'matlab' name. The new code is backwards compatible, so users of
1891 1896 all matplotlib versions are OK. Patch by J. Hunter.
1892 1897
1893 1898 * IPython/OInspect.py (Inspector.pinfo): Add to object? printing
1894 1899 of __init__ docstrings for instances (class docstrings are already
1895 1900 automatically printed). Instances with customized docstrings
1896 1901 (indep. of the class) are also recognized and all 3 separate
1897 1902 docstrings are printed (instance, class, constructor). After some
1898 1903 comments/suggestions by J. Hunter.
1899 1904
1900 1905 2004-12-05 Fernando Perez <fperez@colorado.edu>
1901 1906
1902 1907 * IPython/iplib.py (MagicCompleter.complete): Remove annoying
1903 1908 warnings when tab-completion fails and triggers an exception.
1904 1909
1905 1910 2004-12-03 Fernando Perez <fperez@colorado.edu>
1906 1911
1907 1912 * IPython/Magic.py (magic_prun): Fix bug where an exception would
1908 1913 be triggered when using 'run -p'. An incorrect option flag was
1909 1914 being set ('d' instead of 'D').
1910 1915 (manpage): fix missing escaped \- sign.
1911 1916
1912 1917 2004-11-30 *** Released version 0.6.5
1913 1918
1914 1919 2004-11-30 Fernando Perez <fperez@colorado.edu>
1915 1920
1916 1921 * IPython/Magic.py (Magic.magic_run): Fix bug in breakpoint
1917 1922 setting with -d option.
1918 1923
1919 1924 * setup.py (docfiles): Fix problem where the doc glob I was using
1920 1925 was COMPLETELY BROKEN. It was giving the right files by pure
1921 1926 accident, but failed once I tried to include ipython.el. Note:
1922 1927 glob() does NOT allow you to do exclusion on multiple endings!
1923 1928
1924 1929 2004-11-29 Fernando Perez <fperez@colorado.edu>
1925 1930
1926 1931 * IPython/usage.py (__doc__): cleaned up usage docstring, by using
1927 1932 the manpage as the source. Better formatting & consistency.
1928 1933
1929 1934 * IPython/Magic.py (magic_run): Added new -d option, to run
1930 1935 scripts under the control of the python pdb debugger. Note that
1931 1936 this required changing the %prun option -d to -D, to avoid a clash
1932 1937 (since %run must pass options to %prun, and getopt is too dumb to
1933 1938 handle options with string values with embedded spaces). Thanks
1934 1939 to a suggestion by Matthew Arnison <maffew-AT-cat.org.au>.
1935 1940 (magic_who_ls): added type matching to %who and %whos, so that one
1936 1941 can filter their output to only include variables of certain
1937 1942 types. Another suggestion by Matthew.
1938 1943 (magic_whos): Added memory summaries in kb and Mb for arrays.
1939 1944 (magic_who): Improve formatting (break lines every 9 vars).
1940 1945
1941 1946 2004-11-28 Fernando Perez <fperez@colorado.edu>
1942 1947
1943 1948 * IPython/Logger.py (Logger.log): Fix bug in syncing the input
1944 1949 cache when empty lines were present.
1945 1950
1946 1951 2004-11-24 Fernando Perez <fperez@colorado.edu>
1947 1952
1948 1953 * IPython/usage.py (__doc__): document the re-activated threading
1949 1954 options for WX and GTK.
1950 1955
1951 1956 2004-11-23 Fernando Perez <fperez@colorado.edu>
1952 1957
1953 1958 * IPython/Shell.py (start): Added Prabhu's big patch to reactivate
1954 1959 the -wthread and -gthread options, along with a new -tk one to try
1955 1960 and coordinate Tk threading with wx/gtk. The tk support is very
1956 1961 platform dependent, since it seems to require Tcl and Tk to be
1957 1962 built with threads (Fedora1/2 appears NOT to have it, but in
1958 1963 Prabhu's Debian boxes it works OK). But even with some Tk
1959 1964 limitations, this is a great improvement.
1960 1965
1961 1966 * IPython/Prompts.py (prompt_specials_color): Added \t for time
1962 1967 info in user prompts. Patch by Prabhu.
1963 1968
1964 1969 2004-11-18 Fernando Perez <fperez@colorado.edu>
1965 1970
1966 1971 * IPython/genutils.py (ask_yes_no): Add check for a max of 20
1967 1972 EOFErrors and bail, to avoid infinite loops if a non-terminating
1968 1973 file is fed into ipython. Patch submitted in issue 19 by user,
1969 1974 many thanks.
1970 1975
1971 1976 * IPython/iplib.py (InteractiveShell.handle_auto): do NOT trigger
1972 1977 autoquote/parens in continuation prompts, which can cause lots of
1973 1978 problems. Closes roundup issue 20.
1974 1979
1975 1980 2004-11-17 Fernando Perez <fperez@colorado.edu>
1976 1981
1977 1982 * debian/control (Build-Depends-Indep): Fix dpatch dependency,
1978 1983 reported as debian bug #280505. I'm not sure my local changelog
1979 1984 entry has the proper debian format (Jack?).
1980 1985
1981 1986 2004-11-08 *** Released version 0.6.4
1982 1987
1983 1988 2004-11-08 Fernando Perez <fperez@colorado.edu>
1984 1989
1985 1990 * IPython/iplib.py (init_readline): Fix exit message for Windows
1986 1991 when readline is active. Thanks to a report by Eric Jones
1987 1992 <eric-AT-enthought.com>.
1988 1993
1989 1994 2004-11-07 Fernando Perez <fperez@colorado.edu>
1990 1995
1991 1996 * IPython/genutils.py (page): Add a trap for OSError exceptions,
1992 1997 sometimes seen by win2k/cygwin users.
1993 1998
1994 1999 2004-11-06 Fernando Perez <fperez@colorado.edu>
1995 2000
1996 2001 * IPython/iplib.py (interact): Change the handling of %Exit from
1997 2002 trying to propagate a SystemExit to an internal ipython flag.
1998 2003 This is less elegant than using Python's exception mechanism, but
1999 2004 I can't get that to work reliably with threads, so under -pylab
2000 2005 %Exit was hanging IPython. Cross-thread exception handling is
2001 2006 really a bitch. Thaks to a bug report by Stephen Walton
2002 2007 <stephen.walton-AT-csun.edu>.
2003 2008
2004 2009 2004-11-04 Fernando Perez <fperez@colorado.edu>
2005 2010
2006 2011 * IPython/iplib.py (raw_input_original): store a pointer to the
2007 2012 true raw_input to harden against code which can modify it
2008 2013 (wx.py.PyShell does this and would otherwise crash ipython).
2009 2014 Thanks to a bug report by Jim Flowers <james.flowers-AT-lgx.com>.
2010 2015
2011 2016 * IPython/Shell.py (MTInteractiveShell.runsource): Cleaner fix for
2012 2017 Ctrl-C problem, which does not mess up the input line.
2013 2018
2014 2019 2004-11-03 Fernando Perez <fperez@colorado.edu>
2015 2020
2016 2021 * IPython/Release.py: Changed licensing to BSD, in all files.
2017 2022 (name): lowercase name for tarball/RPM release.
2018 2023
2019 2024 * IPython/OInspect.py (getdoc): wrap inspect.getdoc() safely for
2020 2025 use throughout ipython.
2021 2026
2022 2027 * IPython/Magic.py (Magic._ofind): Switch to using the new
2023 2028 OInspect.getdoc() function.
2024 2029
2025 2030 * IPython/Shell.py (sigint_handler): Hack to ignore the execution
2026 2031 of the line currently being canceled via Ctrl-C. It's extremely
2027 2032 ugly, but I don't know how to do it better (the problem is one of
2028 2033 handling cross-thread exceptions).
2029 2034
2030 2035 2004-10-28 Fernando Perez <fperez@colorado.edu>
2031 2036
2032 2037 * IPython/Shell.py (signal_handler): add signal handlers to trap
2033 2038 SIGINT and SIGSEGV in threaded code properly. Thanks to a bug
2034 2039 report by Francesc Alted.
2035 2040
2036 2041 2004-10-21 Fernando Perez <fperez@colorado.edu>
2037 2042
2038 2043 * IPython/Extensions/InterpreterExec.py (prefilter_shell): Fix @
2039 2044 to % for pysh syntax extensions.
2040 2045
2041 2046 2004-10-09 Fernando Perez <fperez@colorado.edu>
2042 2047
2043 2048 * IPython/Magic.py (Magic.magic_whos): modify output of Numeric
2044 2049 arrays to print a more useful summary, without calling str(arr).
2045 2050 This avoids the problem of extremely lengthy computations which
2046 2051 occur if arr is large, and appear to the user as a system lockup
2047 2052 with 100% cpu activity. After a suggestion by Kristian Sandberg
2048 2053 <Kristian.Sandberg@colorado.edu>.
2049 2054 (Magic.__init__): fix bug in global magic escapes not being
2050 2055 correctly set.
2051 2056
2052 2057 2004-10-08 Fernando Perez <fperez@colorado.edu>
2053 2058
2054 2059 * IPython/Magic.py (__license__): change to absolute imports of
2055 2060 ipython's own internal packages, to start adapting to the absolute
2056 2061 import requirement of PEP-328.
2057 2062
2058 2063 * IPython/genutils.py (__author__): Fix coding to utf-8 on all
2059 2064 files, and standardize author/license marks through the Release
2060 2065 module instead of having per/file stuff (except for files with
2061 2066 particular licenses, like the MIT/PSF-licensed codes).
2062 2067
2063 2068 * IPython/Debugger.py: remove dead code for python 2.1
2064 2069
2065 2070 2004-10-04 Fernando Perez <fperez@colorado.edu>
2066 2071
2067 2072 * IPython/iplib.py (ipmagic): New function for accessing magics
2068 2073 via a normal python function call.
2069 2074
2070 2075 * IPython/Magic.py (Magic.magic_magic): Change the magic escape
2071 2076 from '@' to '%', to accomodate the new @decorator syntax of python
2072 2077 2.4.
2073 2078
2074 2079 2004-09-29 Fernando Perez <fperez@colorado.edu>
2075 2080
2076 2081 * IPython/Shell.py (MatplotlibShellBase.use): Added a wrapper to
2077 2082 matplotlib.use to prevent running scripts which try to switch
2078 2083 interactive backends from within ipython. This will just crash
2079 2084 the python interpreter, so we can't allow it (but a detailed error
2080 2085 is given to the user).
2081 2086
2082 2087 2004-09-28 Fernando Perez <fperez@colorado.edu>
2083 2088
2084 2089 * IPython/Shell.py (MatplotlibShellBase.mplot_exec):
2085 2090 matplotlib-related fixes so that using @run with non-matplotlib
2086 2091 scripts doesn't pop up spurious plot windows. This requires
2087 2092 matplotlib >= 0.63, where I had to make some changes as well.
2088 2093
2089 2094 * IPython/ipmaker.py (make_IPython): update version requirement to
2090 2095 python 2.2.
2091 2096
2092 2097 * IPython/iplib.py (InteractiveShell.mainloop): Add an optional
2093 2098 banner arg for embedded customization.
2094 2099
2095 2100 * IPython/Magic.py (Magic.__init__): big cleanup to remove all
2096 2101 explicit uses of __IP as the IPython's instance name. Now things
2097 2102 are properly handled via the shell.name value. The actual code
2098 2103 is a bit ugly b/c I'm doing it via a global in Magic.py, but this
2099 2104 is much better than before. I'll clean things completely when the
2100 2105 magic stuff gets a real overhaul.
2101 2106
2102 2107 * ipython.1: small fixes, sent in by Jack Moffit. He also sent in
2103 2108 minor changes to debian dir.
2104 2109
2105 2110 * IPython/iplib.py (InteractiveShell.__init__): Fix adding a
2106 2111 pointer to the shell itself in the interactive namespace even when
2107 2112 a user-supplied dict is provided. This is needed for embedding
2108 2113 purposes (found by tests with Michel Sanner).
2109 2114
2110 2115 2004-09-27 Fernando Perez <fperez@colorado.edu>
2111 2116
2112 2117 * IPython/UserConfig/ipythonrc: remove []{} from
2113 2118 readline_remove_delims, so that things like [modname.<TAB> do
2114 2119 proper completion. This disables [].TAB, but that's a less common
2115 2120 case than module names in list comprehensions, for example.
2116 2121 Thanks to a report by Andrea Riciputi.
2117 2122
2118 2123 2004-09-09 Fernando Perez <fperez@colorado.edu>
2119 2124
2120 2125 * IPython/Shell.py (IPShellGTK.mainloop): reorder to avoid
2121 2126 blocking problems in win32 and osx. Fix by John.
2122 2127
2123 2128 2004-09-08 Fernando Perez <fperez@colorado.edu>
2124 2129
2125 2130 * IPython/Shell.py (IPShellWX.OnInit): Fix output redirection bug
2126 2131 for Win32 and OSX. Fix by John Hunter.
2127 2132
2128 2133 2004-08-30 *** Released version 0.6.3
2129 2134
2130 2135 2004-08-30 Fernando Perez <fperez@colorado.edu>
2131 2136
2132 2137 * setup.py (isfile): Add manpages to list of dependent files to be
2133 2138 updated.
2134 2139
2135 2140 2004-08-27 Fernando Perez <fperez@colorado.edu>
2136 2141
2137 2142 * IPython/Shell.py (start): I've disabled -wthread and -gthread
2138 2143 for now. They don't really work with standalone WX/GTK code
2139 2144 (though matplotlib IS working fine with both of those backends).
2140 2145 This will neeed much more testing. I disabled most things with
2141 2146 comments, so turning it back on later should be pretty easy.
2142 2147
2143 2148 * IPython/iplib.py (InteractiveShell.__init__): Fix accidental
2144 2149 autocalling of expressions like r'foo', by modifying the line
2145 2150 split regexp. Closes
2146 2151 http://www.scipy.net/roundup/ipython/issue18, reported by Nicholas
2147 2152 Riley <ipythonbugs-AT-sabi.net>.
2148 2153 (InteractiveShell.mainloop): honor --nobanner with banner
2149 2154 extensions.
2150 2155
2151 2156 * IPython/Shell.py: Significant refactoring of all classes, so
2152 2157 that we can really support ALL matplotlib backends and threading
2153 2158 models (John spotted a bug with Tk which required this). Now we
2154 2159 should support single-threaded, WX-threads and GTK-threads, both
2155 2160 for generic code and for matplotlib.
2156 2161
2157 2162 * IPython/ipmaker.py (__call__): Changed -mpthread option to
2158 2163 -pylab, to simplify things for users. Will also remove the pylab
2159 2164 profile, since now all of matplotlib configuration is directly
2160 2165 handled here. This also reduces startup time.
2161 2166
2162 2167 * IPython/Shell.py (IPShellGTK.run): Fixed bug where mainloop() of
2163 2168 shell wasn't being correctly called. Also in IPShellWX.
2164 2169
2165 2170 * IPython/iplib.py (InteractiveShell.__init__): Added option to
2166 2171 fine-tune banner.
2167 2172
2168 2173 * IPython/numutils.py (spike): Deprecate these spike functions,
2169 2174 delete (long deprecated) gnuplot_exec handler.
2170 2175
2171 2176 2004-08-26 Fernando Perez <fperez@colorado.edu>
2172 2177
2173 2178 * ipython.1: Update for threading options, plus some others which
2174 2179 were missing.
2175 2180
2176 2181 * IPython/ipmaker.py (__call__): Added -wthread option for
2177 2182 wxpython thread handling. Make sure threading options are only
2178 2183 valid at the command line.
2179 2184
2180 2185 * scripts/ipython: moved shell selection into a factory function
2181 2186 in Shell.py, to keep the starter script to a minimum.
2182 2187
2183 2188 2004-08-25 Fernando Perez <fperez@colorado.edu>
2184 2189
2185 2190 * IPython/Shell.py (IPShellWX.wxexit): fixes to WX threading, by
2186 2191 John. Along with some recent changes he made to matplotlib, the
2187 2192 next versions of both systems should work very well together.
2188 2193
2189 2194 2004-08-24 Fernando Perez <fperez@colorado.edu>
2190 2195
2191 2196 * IPython/Magic.py (Magic.magic_prun): cleanup some dead code. I
2192 2197 tried to switch the profiling to using hotshot, but I'm getting
2193 2198 strange errors from prof.runctx() there. I may be misreading the
2194 2199 docs, but it looks weird. For now the profiling code will
2195 2200 continue to use the standard profiler.
2196 2201
2197 2202 2004-08-23 Fernando Perez <fperez@colorado.edu>
2198 2203
2199 2204 * IPython/Shell.py (IPShellWX.__init__): Improvements to the WX
2200 2205 threaded shell, by John Hunter. It's not quite ready yet, but
2201 2206 close.
2202 2207
2203 2208 2004-08-22 Fernando Perez <fperez@colorado.edu>
2204 2209
2205 2210 * IPython/iplib.py (InteractiveShell.interact): tab cleanups, also
2206 2211 in Magic and ultraTB.
2207 2212
2208 2213 * ipython.1: document threading options in manpage.
2209 2214
2210 2215 * scripts/ipython: Changed name of -thread option to -gthread,
2211 2216 since this is GTK specific. I want to leave the door open for a
2212 2217 -wthread option for WX, which will most likely be necessary. This
2213 2218 change affects usage and ipmaker as well.
2214 2219
2215 2220 * IPython/Shell.py (matplotlib_shell): Add a factory function to
2216 2221 handle the matplotlib shell issues. Code by John Hunter
2217 2222 <jdhunter-AT-nitace.bsd.uchicago.edu>.
2218 2223 (IPShellMatplotlibWX.__init__): Rudimentary WX support. It's
2219 2224 broken (and disabled for end users) for now, but it puts the
2220 2225 infrastructure in place.
2221 2226
2222 2227 2004-08-21 Fernando Perez <fperez@colorado.edu>
2223 2228
2224 2229 * ipythonrc-pylab: Add matplotlib support.
2225 2230
2226 2231 * matplotlib_config.py: new files for matplotlib support, part of
2227 2232 the pylab profile.
2228 2233
2229 2234 * IPython/usage.py (__doc__): documented the threading options.
2230 2235
2231 2236 2004-08-20 Fernando Perez <fperez@colorado.edu>
2232 2237
2233 2238 * ipython: Modified the main calling routine to handle the -thread
2234 2239 and -mpthread options. This needs to be done as a top-level hack,
2235 2240 because it determines which class to instantiate for IPython
2236 2241 itself.
2237 2242
2238 2243 * IPython/Shell.py (MTInteractiveShell.__init__): New set of
2239 2244 classes to support multithreaded GTK operation without blocking,
2240 2245 and matplotlib with all backends. This is a lot of still very
2241 2246 experimental code, and threads are tricky. So it may still have a
2242 2247 few rough edges... This code owes a lot to
2243 2248 http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/65109, by
2244 2249 Brian # McErlean and John Finlay, to Antoon Pardon for fixes, and
2245 2250 to John Hunter for all the matplotlib work.
2246 2251
2247 2252 * IPython/ipmaker.py (__call__): Added -thread and -mpthread
2248 2253 options for gtk thread and matplotlib support.
2249 2254
2250 2255 2004-08-16 Fernando Perez <fperez@colorado.edu>
2251 2256
2252 2257 * IPython/iplib.py (InteractiveShell.__init__): don't trigger
2253 2258 autocall for things like p*q,p/q,p+q,p-q, when p is callable. Bug
2254 2259 reported by Stephen Walton <stephen.walton-AT-csun.edu>.
2255 2260
2256 2261 2004-08-11 Fernando Perez <fperez@colorado.edu>
2257 2262
2258 2263 * setup.py (isfile): Fix build so documentation gets updated for
2259 2264 rpms (it was only done for .tgz builds).
2260 2265
2261 2266 2004-08-10 Fernando Perez <fperez@colorado.edu>
2262 2267
2263 2268 * genutils.py (Term): Fix misspell of stdin stream (sin->cin).
2264 2269
2265 2270 * iplib.py : Silence syntax error exceptions in tab-completion.
2266 2271
2267 2272 2004-08-05 Fernando Perez <fperez@colorado.edu>
2268 2273
2269 2274 * IPython/Prompts.py (Prompt2.set_colors): Fix incorrectly set
2270 2275 'color off' mark for continuation prompts. This was causing long
2271 2276 continuation lines to mis-wrap.
2272 2277
2273 2278 2004-08-01 Fernando Perez <fperez@colorado.edu>
2274 2279
2275 2280 * IPython/ipmaker.py (make_IPython): Allow the shell class used
2276 2281 for building ipython to be a parameter. All this is necessary
2277 2282 right now to have a multithreaded version, but this insane
2278 2283 non-design will be cleaned up soon. For now, it's a hack that
2279 2284 works.
2280 2285
2281 2286 * IPython/Shell.py (IPShell.__init__): Stop using mutable default
2282 2287 args in various places. No bugs so far, but it's a dangerous
2283 2288 practice.
2284 2289
2285 2290 2004-07-31 Fernando Perez <fperez@colorado.edu>
2286 2291
2287 2292 * IPython/iplib.py (complete): ignore SyntaxError exceptions to
2288 2293 fix completion of files with dots in their names under most
2289 2294 profiles (pysh was OK because the completion order is different).
2290 2295
2291 2296 2004-07-27 Fernando Perez <fperez@colorado.edu>
2292 2297
2293 2298 * IPython/iplib.py (InteractiveShell.__init__): build dict of
2294 2299 keywords manually, b/c the one in keyword.py was removed in python
2295 2300 2.4. Patch by Anakim Border <aborder-AT-users.sourceforge.net>.
2296 2301 This is NOT a bug under python 2.3 and earlier.
2297 2302
2298 2303 2004-07-26 Fernando Perez <fperez@colorado.edu>
2299 2304
2300 2305 * IPython/ultraTB.py (VerboseTB.text): Add another
2301 2306 linecache.checkcache() call to try to prevent inspect.py from
2302 2307 crashing under python 2.3. I think this fixes
2303 2308 http://www.scipy.net/roundup/ipython/issue17.
2304 2309
2305 2310 2004-07-26 *** Released version 0.6.2
2306 2311
2307 2312 2004-07-26 Fernando Perez <fperez@colorado.edu>
2308 2313
2309 2314 * IPython/Magic.py (Magic.magic_cd): Fix bug where 'cd -N' would
2310 2315 fail for any number.
2311 2316 (Magic.magic_bookmark): Fix bug where 'bookmark -l' would fail for
2312 2317 empty bookmarks.
2313 2318
2314 2319 2004-07-26 *** Released version 0.6.1
2315 2320
2316 2321 2004-07-26 Fernando Perez <fperez@colorado.edu>
2317 2322
2318 2323 * ipython_win_post_install.py (run): Added pysh shortcut for Windows.
2319 2324
2320 2325 * IPython/iplib.py (protect_filename): Applied Ville's patch for
2321 2326 escaping '()[]{}' in filenames.
2322 2327
2323 2328 * IPython/Magic.py (shlex_split): Fix handling of '*' and '?' for
2324 2329 Python 2.2 users who lack a proper shlex.split.
2325 2330
2326 2331 2004-07-19 Fernando Perez <fperez@colorado.edu>
2327 2332
2328 2333 * IPython/iplib.py (InteractiveShell.init_readline): Add support
2329 2334 for reading readline's init file. I follow the normal chain:
2330 2335 $INPUTRC is honored, otherwise ~/.inputrc is used. Thanks to a
2331 2336 report by Mike Heeter. This closes
2332 2337 http://www.scipy.net/roundup/ipython/issue16.
2333 2338
2334 2339 2004-07-18 Fernando Perez <fperez@colorado.edu>
2335 2340
2336 2341 * IPython/iplib.py (__init__): Add better handling of '\' under
2337 2342 Win32 for filenames. After a patch by Ville.
2338 2343
2339 2344 2004-07-17 Fernando Perez <fperez@colorado.edu>
2340 2345
2341 2346 * IPython/iplib.py (InteractiveShell._prefilter): fix bug where
2342 2347 autocalling would be triggered for 'foo is bar' if foo is
2343 2348 callable. I also cleaned up the autocall detection code to use a
2344 2349 regexp, which is faster. Bug reported by Alexander Schmolck.
2345 2350
2346 2351 * IPython/Magic.py (Magic.magic_pinfo): Fix bug where strings with
2347 2352 '?' in them would confuse the help system. Reported by Alex
2348 2353 Schmolck.
2349 2354
2350 2355 2004-07-16 Fernando Perez <fperez@colorado.edu>
2351 2356
2352 2357 * IPython/GnuplotInteractive.py (__all__): added plot2.
2353 2358
2354 2359 * IPython/Gnuplot2.py (Gnuplot.plot2): added new function for
2355 2360 plotting dictionaries, lists or tuples of 1d arrays.
2356 2361
2357 2362 * IPython/Magic.py (Magic.magic_hist): small clenaups and
2358 2363 optimizations.
2359 2364
2360 2365 * IPython/iplib.py:Remove old Changelog info for cleanup. This is
2361 2366 the information which was there from Janko's original IPP code:
2362 2367
2363 2368 03.05.99 20:53 porto.ifm.uni-kiel.de
2364 2369 --Started changelog.
2365 2370 --make clear do what it say it does
2366 2371 --added pretty output of lines from inputcache
2367 2372 --Made Logger a mixin class, simplifies handling of switches
2368 2373 --Added own completer class. .string<TAB> expands to last history
2369 2374 line which starts with string. The new expansion is also present
2370 2375 with Ctrl-r from the readline library. But this shows, who this
2371 2376 can be done for other cases.
2372 2377 --Added convention that all shell functions should accept a
2373 2378 parameter_string This opens the door for different behaviour for
2374 2379 each function. @cd is a good example of this.
2375 2380
2376 2381 04.05.99 12:12 porto.ifm.uni-kiel.de
2377 2382 --added logfile rotation
2378 2383 --added new mainloop method which freezes first the namespace
2379 2384
2380 2385 07.05.99 21:24 porto.ifm.uni-kiel.de
2381 2386 --added the docreader classes. Now there is a help system.
2382 2387 -This is only a first try. Currently it's not easy to put new
2383 2388 stuff in the indices. But this is the way to go. Info would be
2384 2389 better, but HTML is every where and not everybody has an info
2385 2390 system installed and it's not so easy to change html-docs to info.
2386 2391 --added global logfile option
2387 2392 --there is now a hook for object inspection method pinfo needs to
2388 2393 be provided for this. Can be reached by two '??'.
2389 2394
2390 2395 08.05.99 20:51 porto.ifm.uni-kiel.de
2391 2396 --added a README
2392 2397 --bug in rc file. Something has changed so functions in the rc
2393 2398 file need to reference the shell and not self. Not clear if it's a
2394 2399 bug or feature.
2395 2400 --changed rc file for new behavior
2396 2401
2397 2402 2004-07-15 Fernando Perez <fperez@colorado.edu>
2398 2403
2399 2404 * IPython/Logger.py (Logger.log): fixed recent bug where the input
2400 2405 cache was falling out of sync in bizarre manners when multi-line
2401 2406 input was present. Minor optimizations and cleanup.
2402 2407
2403 2408 (Logger): Remove old Changelog info for cleanup. This is the
2404 2409 information which was there from Janko's original code:
2405 2410
2406 2411 Changes to Logger: - made the default log filename a parameter
2407 2412
2408 2413 - put a check for lines beginning with !@? in log(). Needed
2409 2414 (even if the handlers properly log their lines) for mid-session
2410 2415 logging activation to work properly. Without this, lines logged
2411 2416 in mid session, which get read from the cache, would end up
2412 2417 'bare' (with !@? in the open) in the log. Now they are caught
2413 2418 and prepended with a #.
2414 2419
2415 2420 * IPython/iplib.py (InteractiveShell.init_readline): added check
2416 2421 in case MagicCompleter fails to be defined, so we don't crash.
2417 2422
2418 2423 2004-07-13 Fernando Perez <fperez@colorado.edu>
2419 2424
2420 2425 * IPython/Gnuplot2.py (Gnuplot.hardcopy): add automatic generation
2421 2426 of EPS if the requested filename ends in '.eps'.
2422 2427
2423 2428 2004-07-04 Fernando Perez <fperez@colorado.edu>
2424 2429
2425 2430 * IPython/iplib.py (InteractiveShell.handle_shell_escape): Fix
2426 2431 escaping of quotes when calling the shell.
2427 2432
2428 2433 2004-07-02 Fernando Perez <fperez@colorado.edu>
2429 2434
2430 2435 * IPython/Prompts.py (CachedOutput.update): Fix problem with
2431 2436 gettext not working because we were clobbering '_'. Fixes
2432 2437 http://www.scipy.net/roundup/ipython/issue6.
2433 2438
2434 2439 2004-07-01 Fernando Perez <fperez@colorado.edu>
2435 2440
2436 2441 * IPython/Magic.py (Magic.magic_cd): integrated bookmark handling
2437 2442 into @cd. Patch by Ville.
2438 2443
2439 2444 * IPython/iplib.py (InteractiveShell.post_config_initialization):
2440 2445 new function to store things after ipmaker runs. Patch by Ville.
2441 2446 Eventually this will go away once ipmaker is removed and the class
2442 2447 gets cleaned up, but for now it's ok. Key functionality here is
2443 2448 the addition of the persistent storage mechanism, a dict for
2444 2449 keeping data across sessions (for now just bookmarks, but more can
2445 2450 be implemented later).
2446 2451
2447 2452 * IPython/Magic.py (Magic.magic_bookmark): New bookmark system,
2448 2453 persistent across sections. Patch by Ville, I modified it
2449 2454 soemwhat to allow bookmarking arbitrary dirs other than CWD. Also
2450 2455 added a '-l' option to list all bookmarks.
2451 2456
2452 2457 * IPython/iplib.py (InteractiveShell.atexit_operations): new
2453 2458 center for cleanup. Registered with atexit.register(). I moved
2454 2459 here the old exit_cleanup(). After a patch by Ville.
2455 2460
2456 2461 * IPython/Magic.py (get_py_filename): added '~' to the accepted
2457 2462 characters in the hacked shlex_split for python 2.2.
2458 2463
2459 2464 * IPython/iplib.py (file_matches): more fixes to filenames with
2460 2465 whitespace in them. It's not perfect, but limitations in python's
2461 2466 readline make it impossible to go further.
2462 2467
2463 2468 2004-06-29 Fernando Perez <fperez@colorado.edu>
2464 2469
2465 2470 * IPython/iplib.py (file_matches): escape whitespace correctly in
2466 2471 filename completions. Bug reported by Ville.
2467 2472
2468 2473 2004-06-28 Fernando Perez <fperez@colorado.edu>
2469 2474
2470 2475 * IPython/ipmaker.py (__call__): Added per-profile histories. Now
2471 2476 the history file will be called 'history-PROFNAME' (or just
2472 2477 'history' if no profile is loaded). I was getting annoyed at
2473 2478 getting my Numerical work history clobbered by pysh sessions.
2474 2479
2475 2480 * IPython/iplib.py (InteractiveShell.__init__): Internal
2476 2481 getoutputerror() function so that we can honor the system_verbose
2477 2482 flag for _all_ system calls. I also added escaping of #
2478 2483 characters here to avoid confusing Itpl.
2479 2484
2480 2485 * IPython/Magic.py (shlex_split): removed call to shell in
2481 2486 parse_options and replaced it with shlex.split(). The annoying
2482 2487 part was that in Python 2.2, shlex.split() doesn't exist, so I had
2483 2488 to backport it from 2.3, with several frail hacks (the shlex
2484 2489 module is rather limited in 2.2). Thanks to a suggestion by Ville
2485 2490 Vainio <vivainio@kolumbus.fi>. For Python 2.3 there should be no
2486 2491 problem.
2487 2492
2488 2493 (Magic.magic_system_verbose): new toggle to print the actual
2489 2494 system calls made by ipython. Mainly for debugging purposes.
2490 2495
2491 2496 * IPython/GnuplotRuntime.py (gnu_out): fix bug for cygwin, which
2492 2497 doesn't support persistence. Reported (and fix suggested) by
2493 2498 Travis Caldwell <travis_caldwell2000@yahoo.com>.
2494 2499
2495 2500 2004-06-26 Fernando Perez <fperez@colorado.edu>
2496 2501
2497 2502 * IPython/Logger.py (Logger.log): fix to handle correctly empty
2498 2503 continue prompts.
2499 2504
2500 2505 * IPython/Extensions/InterpreterExec.py (pysh): moved the pysh()
2501 2506 function (basically a big docstring) and a few more things here to
2502 2507 speedup startup. pysh.py is now very lightweight. We want because
2503 2508 it gets execfile'd, while InterpreterExec gets imported, so
2504 2509 byte-compilation saves time.
2505 2510
2506 2511 2004-06-25 Fernando Perez <fperez@colorado.edu>
2507 2512
2508 2513 * IPython/Magic.py (Magic.magic_cd): Fixed to restore usage of 'cd
2509 2514 -NUM', which was recently broken.
2510 2515
2511 2516 * IPython/iplib.py (InteractiveShell.handle_shell_escape): allow !
2512 2517 in multi-line input (but not !!, which doesn't make sense there).
2513 2518
2514 2519 * IPython/UserConfig/ipythonrc: made autoindent on by default.
2515 2520 It's just too useful, and people can turn it off in the less
2516 2521 common cases where it's a problem.
2517 2522
2518 2523 2004-06-24 Fernando Perez <fperez@colorado.edu>
2519 2524
2520 2525 * IPython/iplib.py (InteractiveShell._prefilter): big change -
2521 2526 special syntaxes (like alias calling) is now allied in multi-line
2522 2527 input. This is still _very_ experimental, but it's necessary for
2523 2528 efficient shell usage combining python looping syntax with system
2524 2529 calls. For now it's restricted to aliases, I don't think it
2525 2530 really even makes sense to have this for magics.
2526 2531
2527 2532 2004-06-23 Fernando Perez <fperez@colorado.edu>
2528 2533
2529 2534 * IPython/Extensions/InterpreterExec.py (prefilter_shell): Added
2530 2535 $var=cmd <=> @sc var=cmd and $$var=cmd <=> @sc -l var=cmd.
2531 2536
2532 2537 * IPython/Magic.py (Magic.magic_rehashx): modified to handle
2533 2538 extensions under Windows (after code sent by Gary Bishop). The
2534 2539 extensions considered 'executable' are stored in IPython's rc
2535 2540 structure as win_exec_ext.
2536 2541
2537 2542 * IPython/genutils.py (shell): new function, like system() but
2538 2543 without return value. Very useful for interactive shell work.
2539 2544
2540 2545 * IPython/Magic.py (Magic.magic_unalias): New @unalias function to
2541 2546 delete aliases.
2542 2547
2543 2548 * IPython/iplib.py (InteractiveShell.alias_table_update): make
2544 2549 sure that the alias table doesn't contain python keywords.
2545 2550
2546 2551 2004-06-21 Fernando Perez <fperez@colorado.edu>
2547 2552
2548 2553 * IPython/Magic.py (Magic.magic_rehash): Fix crash when
2549 2554 non-existent items are found in $PATH. Reported by Thorsten.
2550 2555
2551 2556 2004-06-20 Fernando Perez <fperez@colorado.edu>
2552 2557
2553 2558 * IPython/iplib.py (complete): modified the completer so that the
2554 2559 order of priorities can be easily changed at runtime.
2555 2560
2556 2561 * IPython/Extensions/InterpreterExec.py (prefilter_shell):
2557 2562 Modified to auto-execute all lines beginning with '~', '/' or '.'.
2558 2563
2559 2564 * IPython/Magic.py (Magic.magic_sx): modified @sc and @sx to
2560 2565 expand Python variables prepended with $ in all system calls. The
2561 2566 same was done to InteractiveShell.handle_shell_escape. Now all
2562 2567 system access mechanisms (!, !!, @sc, @sx and aliases) allow the
2563 2568 expansion of python variables and expressions according to the
2564 2569 syntax of PEP-215 - http://www.python.org/peps/pep-0215.html.
2565 2570
2566 2571 Though PEP-215 has been rejected, a similar (but simpler) one
2567 2572 seems like it will go into Python 2.4, PEP-292 -
2568 2573 http://www.python.org/peps/pep-0292.html.
2569 2574
2570 2575 I'll keep the full syntax of PEP-215, since IPython has since the
2571 2576 start used Ka-Ping Yee's reference implementation discussed there
2572 2577 (Itpl), and I actually like the powerful semantics it offers.
2573 2578
2574 2579 In order to access normal shell variables, the $ has to be escaped
2575 2580 via an extra $. For example:
2576 2581
2577 2582 In [7]: PATH='a python variable'
2578 2583
2579 2584 In [8]: !echo $PATH
2580 2585 a python variable
2581 2586
2582 2587 In [9]: !echo $$PATH
2583 2588 /usr/local/lf9560/bin:/usr/local/intel/compiler70/ia32/bin:...
2584 2589
2585 2590 (Magic.parse_options): escape $ so the shell doesn't evaluate
2586 2591 things prematurely.
2587 2592
2588 2593 * IPython/iplib.py (InteractiveShell.call_alias): added the
2589 2594 ability for aliases to expand python variables via $.
2590 2595
2591 2596 * IPython/Magic.py (Magic.magic_rehash): based on the new alias
2592 2597 system, now there's a @rehash/@rehashx pair of magics. These work
2593 2598 like the csh rehash command, and can be invoked at any time. They
2594 2599 build a table of aliases to everything in the user's $PATH
2595 2600 (@rehash uses everything, @rehashx is slower but only adds
2596 2601 executable files). With this, the pysh.py-based shell profile can
2597 2602 now simply call rehash upon startup, and full access to all
2598 2603 programs in the user's path is obtained.
2599 2604
2600 2605 * IPython/iplib.py (InteractiveShell.call_alias): The new alias
2601 2606 functionality is now fully in place. I removed the old dynamic
2602 2607 code generation based approach, in favor of a much lighter one
2603 2608 based on a simple dict. The advantage is that this allows me to
2604 2609 now have thousands of aliases with negligible cost (unthinkable
2605 2610 with the old system).
2606 2611
2607 2612 2004-06-19 Fernando Perez <fperez@colorado.edu>
2608 2613
2609 2614 * IPython/iplib.py (__init__): extended MagicCompleter class to
2610 2615 also complete (last in priority) on user aliases.
2611 2616
2612 2617 * IPython/Itpl.py (Itpl.__str__): fixed order of globals/locals in
2613 2618 call to eval.
2614 2619 (ItplNS.__init__): Added a new class which functions like Itpl,
2615 2620 but allows configuring the namespace for the evaluation to occur
2616 2621 in.
2617 2622
2618 2623 2004-06-18 Fernando Perez <fperez@colorado.edu>
2619 2624
2620 2625 * IPython/iplib.py (InteractiveShell.runcode): modify to print a
2621 2626 better message when 'exit' or 'quit' are typed (a common newbie
2622 2627 confusion).
2623 2628
2624 2629 * IPython/Magic.py (Magic.magic_colors): Added the runtime color
2625 2630 check for Windows users.
2626 2631
2627 2632 * IPython/iplib.py (InteractiveShell.user_setup): removed
2628 2633 disabling of colors for Windows. I'll test at runtime and issue a
2629 2634 warning if Gary's readline isn't found, as to nudge users to
2630 2635 download it.
2631 2636
2632 2637 2004-06-16 Fernando Perez <fperez@colorado.edu>
2633 2638
2634 2639 * IPython/genutils.py (Stream.__init__): changed to print errors
2635 2640 to sys.stderr. I had a circular dependency here. Now it's
2636 2641 possible to run ipython as IDLE's shell (consider this pre-alpha,
2637 2642 since true stdout things end up in the starting terminal instead
2638 2643 of IDLE's out).
2639 2644
2640 2645 * IPython/Prompts.py (Prompt2.set_colors): prevent crashes for
2641 2646 users who haven't # updated their prompt_in2 definitions. Remove
2642 2647 eventually.
2643 2648 (multiple_replace): added credit to original ASPN recipe.
2644 2649
2645 2650 2004-06-15 Fernando Perez <fperez@colorado.edu>
2646 2651
2647 2652 * IPython/iplib.py (InteractiveShell.__init__): add 'cp' to the
2648 2653 list of auto-defined aliases.
2649 2654
2650 2655 2004-06-13 Fernando Perez <fperez@colorado.edu>
2651 2656
2652 2657 * setup.py (scriptfiles): Don't trigger win_post_install unless an
2653 2658 install was really requested (so setup.py can be used for other
2654 2659 things under Windows).
2655 2660
2656 2661 2004-06-10 Fernando Perez <fperez@colorado.edu>
2657 2662
2658 2663 * IPython/Logger.py (Logger.create_log): Manually remove any old
2659 2664 backup, since os.remove may fail under Windows. Fixes bug
2660 2665 reported by Thorsten.
2661 2666
2662 2667 2004-06-09 Fernando Perez <fperez@colorado.edu>
2663 2668
2664 2669 * examples/example-embed.py: fixed all references to %n (replaced
2665 2670 with \\# for ps1/out prompts and with \\D for ps2 prompts). Done
2666 2671 for all examples and the manual as well.
2667 2672
2668 2673 2004-06-08 Fernando Perez <fperez@colorado.edu>
2669 2674
2670 2675 * IPython/Prompts.py (Prompt2.set_p_str): fixed all prompt
2671 2676 alignment and color management. All 3 prompt subsystems now
2672 2677 inherit from BasePrompt.
2673 2678
2674 2679 * tools/release: updates for windows installer build and tag rpms
2675 2680 with python version (since paths are fixed).
2676 2681
2677 2682 * IPython/UserConfig/ipythonrc: modified to use \# instead of %n,
2678 2683 which will become eventually obsolete. Also fixed the default
2679 2684 prompt_in2 to use \D, so at least new users start with the correct
2680 2685 defaults.
2681 2686 WARNING: Users with existing ipythonrc files will need to apply
2682 2687 this fix manually!
2683 2688
2684 2689 * setup.py: make windows installer (.exe). This is finally the
2685 2690 integration of an old patch by Cory Dodt <dodt-AT-fcoe.k12.ca.us>,
2686 2691 which I hadn't included because it required Python 2.3 (or recent
2687 2692 distutils).
2688 2693
2689 2694 * IPython/usage.py (__doc__): update docs (and manpage) to reflect
2690 2695 usage of new '\D' escape.
2691 2696
2692 2697 * IPython/Prompts.py (ROOT_SYMBOL): Small fix for Windows (which
2693 2698 lacks os.getuid())
2694 2699 (CachedOutput.set_colors): Added the ability to turn coloring
2695 2700 on/off with @colors even for manually defined prompt colors. It
2696 2701 uses a nasty global, but it works safely and via the generic color
2697 2702 handling mechanism.
2698 2703 (Prompt2.__init__): Introduced new escape '\D' for continuation
2699 2704 prompts. It represents the counter ('\#') as dots.
2700 2705 *** NOTE *** THIS IS A BACKWARDS-INCOMPATIBLE CHANGE. Users will
2701 2706 need to update their ipythonrc files and replace '%n' with '\D' in
2702 2707 their prompt_in2 settings everywhere. Sorry, but there's
2703 2708 otherwise no clean way to get all prompts to properly align. The
2704 2709 ipythonrc shipped with IPython has been updated.
2705 2710
2706 2711 2004-06-07 Fernando Perez <fperez@colorado.edu>
2707 2712
2708 2713 * setup.py (isfile): Pass local_icons option to latex2html, so the
2709 2714 resulting HTML file is self-contained. Thanks to
2710 2715 dryice-AT-liu.com.cn for the tip.
2711 2716
2712 2717 * pysh.py: I created a new profile 'shell', which implements a
2713 2718 _rudimentary_ IPython-based shell. This is in NO WAY a realy
2714 2719 system shell, nor will it become one anytime soon. It's mainly
2715 2720 meant to illustrate the use of the new flexible bash-like prompts.
2716 2721 I guess it could be used by hardy souls for true shell management,
2717 2722 but it's no tcsh/bash... pysh.py is loaded by the 'shell'
2718 2723 profile. This uses the InterpreterExec extension provided by
2719 2724 W.J. van der Laan <gnufnork-AT-hetdigitalegat.nl>
2720 2725
2721 2726 * IPython/Prompts.py (PromptOut.__str__): now it will correctly
2722 2727 auto-align itself with the length of the previous input prompt
2723 2728 (taking into account the invisible color escapes).
2724 2729 (CachedOutput.__init__): Large restructuring of this class. Now
2725 2730 all three prompts (primary1, primary2, output) are proper objects,
2726 2731 managed by the 'parent' CachedOutput class. The code is still a
2727 2732 bit hackish (all prompts share state via a pointer to the cache),
2728 2733 but it's overall far cleaner than before.
2729 2734
2730 2735 * IPython/genutils.py (getoutputerror): modified to add verbose,
2731 2736 debug and header options. This makes the interface of all getout*
2732 2737 functions uniform.
2733 2738 (SystemExec.getoutputerror): added getoutputerror to SystemExec.
2734 2739
2735 2740 * IPython/Magic.py (Magic.default_option): added a function to
2736 2741 allow registering default options for any magic command. This
2737 2742 makes it easy to have profiles which customize the magics globally
2738 2743 for a certain use. The values set through this function are
2739 2744 picked up by the parse_options() method, which all magics should
2740 2745 use to parse their options.
2741 2746
2742 2747 * IPython/genutils.py (warn): modified the warnings framework to
2743 2748 use the Term I/O class. I'm trying to slowly unify all of
2744 2749 IPython's I/O operations to pass through Term.
2745 2750
2746 2751 * IPython/Prompts.py (Prompt2._str_other): Added functionality in
2747 2752 the secondary prompt to correctly match the length of the primary
2748 2753 one for any prompt. Now multi-line code will properly line up
2749 2754 even for path dependent prompts, such as the new ones available
2750 2755 via the prompt_specials.
2751 2756
2752 2757 2004-06-06 Fernando Perez <fperez@colorado.edu>
2753 2758
2754 2759 * IPython/Prompts.py (prompt_specials): Added the ability to have
2755 2760 bash-like special sequences in the prompts, which get
2756 2761 automatically expanded. Things like hostname, current working
2757 2762 directory and username are implemented already, but it's easy to
2758 2763 add more in the future. Thanks to a patch by W.J. van der Laan
2759 2764 <gnufnork-AT-hetdigitalegat.nl>
2760 2765 (prompt_specials): Added color support for prompt strings, so
2761 2766 users can define arbitrary color setups for their prompts.
2762 2767
2763 2768 2004-06-05 Fernando Perez <fperez@colorado.edu>
2764 2769
2765 2770 * IPython/genutils.py (Term.reopen_all): Added Windows-specific
2766 2771 code to load Gary Bishop's readline and configure it
2767 2772 automatically. Thanks to Gary for help on this.
2768 2773
2769 2774 2004-06-01 Fernando Perez <fperez@colorado.edu>
2770 2775
2771 2776 * IPython/Logger.py (Logger.create_log): fix bug for logging
2772 2777 with no filename (previous fix was incomplete).
2773 2778
2774 2779 2004-05-25 Fernando Perez <fperez@colorado.edu>
2775 2780
2776 2781 * IPython/Magic.py (Magic.parse_options): fix bug where naked
2777 2782 parens would get passed to the shell.
2778 2783
2779 2784 2004-05-20 Fernando Perez <fperez@colorado.edu>
2780 2785
2781 2786 * IPython/Magic.py (Magic.magic_prun): changed default profile
2782 2787 sort order to 'time' (the more common profiling need).
2783 2788
2784 2789 * IPython/OInspect.py (Inspector.pinfo): flush the inspect cache
2785 2790 so that source code shown is guaranteed in sync with the file on
2786 2791 disk (also changed in psource). Similar fix to the one for
2787 2792 ultraTB on 2004-05-06. Thanks to a bug report by Yann Le Du
2788 2793 <yann.ledu-AT-noos.fr>.
2789 2794
2790 2795 * IPython/Magic.py (Magic.parse_options): Fixed bug where commands
2791 2796 with a single option would not be correctly parsed. Closes
2792 2797 http://www.scipy.net/roundup/ipython/issue14. This bug had been
2793 2798 introduced in 0.6.0 (on 2004-05-06).
2794 2799
2795 2800 2004-05-13 *** Released version 0.6.0
2796 2801
2797 2802 2004-05-13 Fernando Perez <fperez@colorado.edu>
2798 2803
2799 2804 * debian/: Added debian/ directory to CVS, so that debian support
2800 2805 is publicly accessible. The debian package is maintained by Jack
2801 2806 Moffit <jack-AT-xiph.org>.
2802 2807
2803 2808 * Documentation: included the notes about an ipython-based system
2804 2809 shell (the hypothetical 'pysh') into the new_design.pdf document,
2805 2810 so that these ideas get distributed to users along with the
2806 2811 official documentation.
2807 2812
2808 2813 2004-05-10 Fernando Perez <fperez@colorado.edu>
2809 2814
2810 2815 * IPython/Logger.py (Logger.create_log): fix recently introduced
2811 2816 bug (misindented line) where logstart would fail when not given an
2812 2817 explicit filename.
2813 2818
2814 2819 2004-05-09 Fernando Perez <fperez@colorado.edu>
2815 2820
2816 2821 * IPython/Magic.py (Magic.parse_options): skip system call when
2817 2822 there are no options to look for. Faster, cleaner for the common
2818 2823 case.
2819 2824
2820 2825 * Documentation: many updates to the manual: describing Windows
2821 2826 support better, Gnuplot updates, credits, misc small stuff. Also
2822 2827 updated the new_design doc a bit.
2823 2828
2824 2829 2004-05-06 *** Released version 0.6.0.rc1
2825 2830
2826 2831 2004-05-06 Fernando Perez <fperez@colorado.edu>
2827 2832
2828 2833 * IPython/ultraTB.py (ListTB.text): modified a ton of string +=
2829 2834 operations to use the vastly more efficient list/''.join() method.
2830 2835 (FormattedTB.text): Fix
2831 2836 http://www.scipy.net/roundup/ipython/issue12 - exception source
2832 2837 extract not updated after reload. Thanks to Mike Salib
2833 2838 <msalib-AT-mit.edu> for pinning the source of the problem.
2834 2839 Fortunately, the solution works inside ipython and doesn't require
2835 2840 any changes to python proper.
2836 2841
2837 2842 * IPython/Magic.py (Magic.parse_options): Improved to process the
2838 2843 argument list as a true shell would (by actually using the
2839 2844 underlying system shell). This way, all @magics automatically get
2840 2845 shell expansion for variables. Thanks to a comment by Alex
2841 2846 Schmolck.
2842 2847
2843 2848 2004-04-04 Fernando Perez <fperez@colorado.edu>
2844 2849
2845 2850 * IPython/iplib.py (InteractiveShell.interact): Added a special
2846 2851 trap for a debugger quit exception, which is basically impossible
2847 2852 to handle by normal mechanisms, given what pdb does to the stack.
2848 2853 This fixes a crash reported by <fgibbons-AT-llama.med.harvard.edu>.
2849 2854
2850 2855 2004-04-03 Fernando Perez <fperez@colorado.edu>
2851 2856
2852 2857 * IPython/genutils.py (Term): Standardized the names of the Term
2853 2858 class streams to cin/cout/cerr, following C++ naming conventions
2854 2859 (I can't use in/out/err because 'in' is not a valid attribute
2855 2860 name).
2856 2861
2857 2862 * IPython/iplib.py (InteractiveShell.interact): don't increment
2858 2863 the prompt if there's no user input. By Daniel 'Dang' Griffith
2859 2864 <pythondev-dang-AT-lazytwinacres.net>, after a suggestion from
2860 2865 Francois Pinard.
2861 2866
2862 2867 2004-04-02 Fernando Perez <fperez@colorado.edu>
2863 2868
2864 2869 * IPython/genutils.py (Stream.__init__): Modified to survive at
2865 2870 least importing in contexts where stdin/out/err aren't true file
2866 2871 objects, such as PyCrust (they lack fileno() and mode). However,
2867 2872 the recovery facilities which rely on these things existing will
2868 2873 not work.
2869 2874
2870 2875 2004-04-01 Fernando Perez <fperez@colorado.edu>
2871 2876
2872 2877 * IPython/Magic.py (Magic.magic_sx): modified (as well as @sc) to
2873 2878 use the new getoutputerror() function, so it properly
2874 2879 distinguishes stdout/err.
2875 2880
2876 2881 * IPython/genutils.py (getoutputerror): added a function to
2877 2882 capture separately the standard output and error of a command.
2878 2883 After a comment from dang on the mailing lists. This code is
2879 2884 basically a modified version of commands.getstatusoutput(), from
2880 2885 the standard library.
2881 2886
2882 2887 * IPython/iplib.py (InteractiveShell.handle_shell_escape): added
2883 2888 '!!' as a special syntax (shorthand) to access @sx.
2884 2889
2885 2890 * IPython/Magic.py (Magic.magic_sx): new magic, to execute a shell
2886 2891 command and return its output as a list split on '\n'.
2887 2892
2888 2893 2004-03-31 Fernando Perez <fperez@colorado.edu>
2889 2894
2890 2895 * IPython/FakeModule.py (FakeModule.__init__): added __nonzero__
2891 2896 method to dictionaries used as FakeModule instances if they lack
2892 2897 it. At least pydoc in python2.3 breaks for runtime-defined
2893 2898 functions without this hack. At some point I need to _really_
2894 2899 understand what FakeModule is doing, because it's a gross hack.
2895 2900 But it solves Arnd's problem for now...
2896 2901
2897 2902 2004-02-27 Fernando Perez <fperez@colorado.edu>
2898 2903
2899 2904 * IPython/Logger.py (Logger.create_log): Fix bug where 'rotate'
2900 2905 mode would behave erratically. Also increased the number of
2901 2906 possible logs in rotate mod to 999. Thanks to Rod Holland
2902 2907 <rhh@StructureLABS.com> for the report and fixes.
2903 2908
2904 2909 2004-02-26 Fernando Perez <fperez@colorado.edu>
2905 2910
2906 2911 * IPython/genutils.py (page): Check that the curses module really
2907 2912 has the initscr attribute before trying to use it. For some
2908 2913 reason, the Solaris curses module is missing this. I think this
2909 2914 should be considered a Solaris python bug, but I'm not sure.
2910 2915
2911 2916 2004-01-17 Fernando Perez <fperez@colorado.edu>
2912 2917
2913 2918 * IPython/genutils.py (Stream.__init__): Changes to try to make
2914 2919 ipython robust against stdin/out/err being closed by the user.
2915 2920 This is 'user error' (and blocks a normal python session, at least
2916 2921 the stdout case). However, Ipython should be able to survive such
2917 2922 instances of abuse as gracefully as possible. To simplify the
2918 2923 coding and maintain compatibility with Gary Bishop's Term
2919 2924 contributions, I've made use of classmethods for this. I think
2920 2925 this introduces a dependency on python 2.2.
2921 2926
2922 2927 2004-01-13 Fernando Perez <fperez@colorado.edu>
2923 2928
2924 2929 * IPython/numutils.py (exp_safe): simplified the code a bit and
2925 2930 removed the need for importing the kinds module altogether.
2926 2931
2927 2932 2004-01-06 Fernando Perez <fperez@colorado.edu>
2928 2933
2929 2934 * IPython/Magic.py (Magic.magic_sc): Made the shell capture system
2930 2935 a magic function instead, after some community feedback. No
2931 2936 special syntax will exist for it, but its name is deliberately
2932 2937 very short.
2933 2938
2934 2939 2003-12-20 Fernando Perez <fperez@colorado.edu>
2935 2940
2936 2941 * IPython/iplib.py (InteractiveShell.handle_shell_assign): Added
2937 2942 new functionality, to automagically assign the result of a shell
2938 2943 command to a variable. I'll solicit some community feedback on
2939 2944 this before making it permanent.
2940 2945
2941 2946 * IPython/OInspect.py (Inspector.pinfo): Fix crash when info was
2942 2947 requested about callables for which inspect couldn't obtain a
2943 2948 proper argspec. Thanks to a crash report sent by Etienne
2944 2949 Posthumus <etienne-AT-apple01.cs.vu.nl>.
2945 2950
2946 2951 2003-12-09 Fernando Perez <fperez@colorado.edu>
2947 2952
2948 2953 * IPython/genutils.py (page): patch for the pager to work across
2949 2954 various versions of Windows. By Gary Bishop.
2950 2955
2951 2956 2003-12-04 Fernando Perez <fperez@colorado.edu>
2952 2957
2953 2958 * IPython/Gnuplot2.py (PlotItems): Fixes for working with
2954 2959 Gnuplot.py version 1.7, whose internal names changed quite a bit.
2955 2960 While I tested this and it looks ok, there may still be corner
2956 2961 cases I've missed.
2957 2962
2958 2963 2003-12-01 Fernando Perez <fperez@colorado.edu>
2959 2964
2960 2965 * IPython/iplib.py (InteractiveShell._prefilter): Fixed a bug
2961 2966 where a line like 'p,q=1,2' would fail because the automagic
2962 2967 system would be triggered for @p.
2963 2968
2964 2969 * IPython/DPyGetOpt.py (DPyGetOpt.processArguments): Tab-related
2965 2970 cleanups, code unmodified.
2966 2971
2967 2972 * IPython/genutils.py (Term): added a class for IPython to handle
2968 2973 output. In most cases it will just be a proxy for stdout/err, but
2969 2974 having this allows modifications to be made for some platforms,
2970 2975 such as handling color escapes under Windows. All of this code
2971 2976 was contributed by Gary Bishop, with minor modifications by me.
2972 2977 The actual changes affect many files.
2973 2978
2974 2979 2003-11-30 Fernando Perez <fperez@colorado.edu>
2975 2980
2976 2981 * IPython/iplib.py (file_matches): new completion code, courtesy
2977 2982 of Jeff Collins. This enables filename completion again under
2978 2983 python 2.3, which disabled it at the C level.
2979 2984
2980 2985 2003-11-11 Fernando Perez <fperez@colorado.edu>
2981 2986
2982 2987 * IPython/numutils.py (amap): Added amap() fn. Simple shorthand
2983 2988 for Numeric.array(map(...)), but often convenient.
2984 2989
2985 2990 2003-11-05 Fernando Perez <fperez@colorado.edu>
2986 2991
2987 2992 * IPython/numutils.py (frange): Changed a call from int() to
2988 2993 int(round()) to prevent a problem reported with arange() in the
2989 2994 numpy list.
2990 2995
2991 2996 2003-10-06 Fernando Perez <fperez@colorado.edu>
2992 2997
2993 2998 * IPython/DPyGetOpt.py (DPyGetOpt.processArguments): changed to
2994 2999 prevent crashes if sys lacks an argv attribute (it happens with
2995 3000 embedded interpreters which build a bare-bones sys module).
2996 3001 Thanks to a report/bugfix by Adam Hupp <hupp-AT-cs.wisc.edu>.
2997 3002
2998 3003 2003-09-24 Fernando Perez <fperez@colorado.edu>
2999 3004
3000 3005 * IPython/Magic.py (Magic._ofind): blanket except around getattr()
3001 3006 to protect against poorly written user objects where __getattr__
3002 3007 raises exceptions other than AttributeError. Thanks to a bug
3003 3008 report by Oliver Sander <osander-AT-gmx.de>.
3004 3009
3005 3010 * IPython/FakeModule.py (FakeModule.__repr__): this method was
3006 3011 missing. Thanks to bug report by Ralf Schmitt <ralf-AT-brainbot.com>.
3007 3012
3008 3013 2003-09-09 Fernando Perez <fperez@colorado.edu>
3009 3014
3010 3015 * IPython/iplib.py (InteractiveShell._prefilter): fix bug where
3011 3016 unpacking a list whith a callable as first element would
3012 3017 mistakenly trigger autocalling. Thanks to a bug report by Jeffery
3013 3018 Collins.
3014 3019
3015 3020 2003-08-25 *** Released version 0.5.0
3016 3021
3017 3022 2003-08-22 Fernando Perez <fperez@colorado.edu>
3018 3023
3019 3024 * IPython/ultraTB.py (VerboseTB.linereader): Improved handling of
3020 3025 improperly defined user exceptions. Thanks to feedback from Mark
3021 3026 Russell <mrussell-AT-verio.net>.
3022 3027
3023 3028 2003-08-20 Fernando Perez <fperez@colorado.edu>
3024 3029
3025 3030 * IPython/OInspect.py (Inspector.pinfo): changed String Form
3026 3031 printing so that it would print multi-line string forms starting
3027 3032 with a new line. This way the formatting is better respected for
3028 3033 objects which work hard to make nice string forms.
3029 3034
3030 3035 * IPython/iplib.py (InteractiveShell.handle_auto): Fix bug where
3031 3036 autocall would overtake data access for objects with both
3032 3037 __getitem__ and __call__.
3033 3038
3034 3039 2003-08-19 *** Released version 0.5.0-rc1
3035 3040
3036 3041 2003-08-19 Fernando Perez <fperez@colorado.edu>
3037 3042
3038 3043 * IPython/deep_reload.py (load_tail): single tiny change here
3039 3044 seems to fix the long-standing bug of dreload() failing to work
3040 3045 for dotted names. But this module is pretty tricky, so I may have
3041 3046 missed some subtlety. Needs more testing!.
3042 3047
3043 3048 * IPython/ultraTB.py (VerboseTB.linereader): harden against user
3044 3049 exceptions which have badly implemented __str__ methods.
3045 3050 (VerboseTB.text): harden against inspect.getinnerframes crashing,
3046 3051 which I've been getting reports about from Python 2.3 users. I
3047 3052 wish I had a simple test case to reproduce the problem, so I could
3048 3053 either write a cleaner workaround or file a bug report if
3049 3054 necessary.
3050 3055
3051 3056 * IPython/Magic.py (Magic.magic_edit): fixed bug where after
3052 3057 making a class 'foo', file 'foo.py' couldn't be edited. Thanks to
3053 3058 a bug report by Tjabo Kloppenburg.
3054 3059
3055 3060 * IPython/ultraTB.py (VerboseTB.debugger): hardened against pdb
3056 3061 crashes. Wrapped the pdb call in a blanket try/except, since pdb
3057 3062 seems rather unstable. Thanks to a bug report by Tjabo
3058 3063 Kloppenburg <tjabo.kloppenburg-AT-unix-ag.uni-siegen.de>.
3059 3064
3060 3065 * IPython/Release.py (version): release 0.5.0-rc1. I want to put
3061 3066 this out soon because of the critical fixes in the inner loop for
3062 3067 generators.
3063 3068
3064 3069 * IPython/Magic.py (Magic.getargspec): removed. This (and
3065 3070 _get_def) have been obsoleted by OInspect for a long time, I
3066 3071 hadn't noticed that they were dead code.
3067 3072 (Magic._ofind): restored _ofind functionality for a few literals
3068 3073 (those in ["''",'""','[]','{}','()']). But it won't work anymore
3069 3074 for things like "hello".capitalize?, since that would require a
3070 3075 potentially dangerous eval() again.
3071 3076
3072 3077 * IPython/iplib.py (InteractiveShell._prefilter): reorganized the
3073 3078 logic a bit more to clean up the escapes handling and minimize the
3074 3079 use of _ofind to only necessary cases. The interactive 'feel' of
3075 3080 IPython should have improved quite a bit with the changes in
3076 3081 _prefilter and _ofind (besides being far safer than before).
3077 3082
3078 3083 * IPython/Magic.py (Magic.magic_edit): Fixed old bug (but rather
3079 3084 obscure, never reported). Edit would fail to find the object to
3080 3085 edit under some circumstances.
3081 3086 (Magic._ofind): CRITICAL FIX. Finally removed the eval() calls
3082 3087 which were causing double-calling of generators. Those eval calls
3083 3088 were _very_ dangerous, since code with side effects could be
3084 3089 triggered. As they say, 'eval is evil'... These were the
3085 3090 nastiest evals in IPython. Besides, _ofind is now far simpler,
3086 3091 and it should also be quite a bit faster. Its use of inspect is
3087 3092 also safer, so perhaps some of the inspect-related crashes I've
3088 3093 seen lately with Python 2.3 might be taken care of. That will
3089 3094 need more testing.
3090 3095
3091 3096 2003-08-17 Fernando Perez <fperez@colorado.edu>
3092 3097
3093 3098 * IPython/iplib.py (InteractiveShell._prefilter): significant
3094 3099 simplifications to the logic for handling user escapes. Faster
3095 3100 and simpler code.
3096 3101
3097 3102 2003-08-14 Fernando Perez <fperez@colorado.edu>
3098 3103
3099 3104 * IPython/numutils.py (sum_flat): rewrote to be non-recursive.
3100 3105 Now it requires O(N) storage (N=size(a)) for non-contiguous input,
3101 3106 but it should be quite a bit faster. And the recursive version
3102 3107 generated O(log N) intermediate storage for all rank>1 arrays,
3103 3108 even if they were contiguous.
3104 3109 (l1norm): Added this function.
3105 3110 (norm): Added this function for arbitrary norms (including
3106 3111 l-infinity). l1 and l2 are still special cases for convenience
3107 3112 and speed.
3108 3113
3109 3114 2003-08-03 Fernando Perez <fperez@colorado.edu>
3110 3115
3111 3116 * IPython/Magic.py (Magic.magic_edit): Removed all remaining string
3112 3117 exceptions, which now raise PendingDeprecationWarnings in Python
3113 3118 2.3. There were some in Magic and some in Gnuplot2.
3114 3119
3115 3120 2003-06-30 Fernando Perez <fperez@colorado.edu>
3116 3121
3117 3122 * IPython/genutils.py (page): modified to call curses only for
3118 3123 terminals where TERM=='xterm'. After problems under many other
3119 3124 terminals were reported by Keith Beattie <KSBeattie-AT-lbl.gov>.
3120 3125
3121 3126 * IPython/iplib.py (complete): removed spurious 'print "IE"' which
3122 3127 would be triggered when readline was absent. This was just an old
3123 3128 debugging statement I'd forgotten to take out.
3124 3129
3125 3130 2003-06-20 Fernando Perez <fperez@colorado.edu>
3126 3131
3127 3132 * IPython/genutils.py (clock): modified to return only user time
3128 3133 (not counting system time), after a discussion on scipy. While
3129 3134 system time may be a useful quantity occasionally, it may much
3130 3135 more easily be skewed by occasional swapping or other similar
3131 3136 activity.
3132 3137
3133 3138 2003-06-05 Fernando Perez <fperez@colorado.edu>
3134 3139
3135 3140 * IPython/numutils.py (identity): new function, for building
3136 3141 arbitrary rank Kronecker deltas (mostly backwards compatible with
3137 3142 Numeric.identity)
3138 3143
3139 3144 2003-06-03 Fernando Perez <fperez@colorado.edu>
3140 3145
3141 3146 * IPython/iplib.py (InteractiveShell.handle_magic): protect
3142 3147 arguments passed to magics with spaces, to allow trailing '\' to
3143 3148 work normally (mainly for Windows users).
3144 3149
3145 3150 2003-05-29 Fernando Perez <fperez@colorado.edu>
3146 3151
3147 3152 * IPython/ipmaker.py (make_IPython): Load site._Helper() as help
3148 3153 instead of pydoc.help. This fixes a bizarre behavior where
3149 3154 printing '%s' % locals() would trigger the help system. Now
3150 3155 ipython behaves like normal python does.
3151 3156
3152 3157 Note that if one does 'from pydoc import help', the bizarre
3153 3158 behavior returns, but this will also happen in normal python, so
3154 3159 it's not an ipython bug anymore (it has to do with how pydoc.help
3155 3160 is implemented).
3156 3161
3157 3162 2003-05-22 Fernando Perez <fperez@colorado.edu>
3158 3163
3159 3164 * IPython/FlexCompleter.py (Completer.attr_matches): fixed to
3160 3165 return [] instead of None when nothing matches, also match to end
3161 3166 of line. Patch by Gary Bishop.
3162 3167
3163 3168 * IPython/ipmaker.py (make_IPython): Added same sys.excepthook
3164 3169 protection as before, for files passed on the command line. This
3165 3170 prevents the CrashHandler from kicking in if user files call into
3166 3171 sys.excepthook (such as PyQt and WxWindows have a nasty habit of
3167 3172 doing). After a report by Kasper Souren <Kasper.Souren-AT-ircam.fr>
3168 3173
3169 3174 2003-05-20 *** Released version 0.4.0
3170 3175
3171 3176 2003-05-20 Fernando Perez <fperez@colorado.edu>
3172 3177
3173 3178 * setup.py: added support for manpages. It's a bit hackish b/c of
3174 3179 a bug in the way the bdist_rpm distutils target handles gzipped
3175 3180 manpages, but it works. After a patch by Jack.
3176 3181
3177 3182 2003-05-19 Fernando Perez <fperez@colorado.edu>
3178 3183
3179 3184 * IPython/numutils.py: added a mockup of the kinds module, since
3180 3185 it was recently removed from Numeric. This way, numutils will
3181 3186 work for all users even if they are missing kinds.
3182 3187
3183 3188 * IPython/Magic.py (Magic._ofind): Harden against an inspect
3184 3189 failure, which can occur with SWIG-wrapped extensions. After a
3185 3190 crash report from Prabhu.
3186 3191
3187 3192 2003-05-16 Fernando Perez <fperez@colorado.edu>
3188 3193
3189 3194 * IPython/iplib.py (InteractiveShell.excepthook): New method to
3190 3195 protect ipython from user code which may call directly
3191 3196 sys.excepthook (this looks like an ipython crash to the user, even
3192 3197 when it isn't). After a patch by Gary Bishop <gb-AT-cs.unc.edu>.
3193 3198 This is especially important to help users of WxWindows, but may
3194 3199 also be useful in other cases.
3195 3200
3196 3201 * IPython/ultraTB.py (AutoFormattedTB.__call__): Changed to allow
3197 3202 an optional tb_offset to be specified, and to preserve exception
3198 3203 info if given. After a patch by Gary Bishop <gb-AT-cs.unc.edu>.
3199 3204
3200 3205 * ipython.1 (Default): Thanks to Jack's work, we now have manpages!
3201 3206
3202 3207 2003-05-15 Fernando Perez <fperez@colorado.edu>
3203 3208
3204 3209 * IPython/iplib.py (InteractiveShell.user_setup): Fix crash when
3205 3210 installing for a new user under Windows.
3206 3211
3207 3212 2003-05-12 Fernando Perez <fperez@colorado.edu>
3208 3213
3209 3214 * IPython/iplib.py (InteractiveShell.handle_emacs): New line
3210 3215 handler for Emacs comint-based lines. Currently it doesn't do
3211 3216 much (but importantly, it doesn't update the history cache). In
3212 3217 the future it may be expanded if Alex needs more functionality
3213 3218 there.
3214 3219
3215 3220 * IPython/CrashHandler.py (CrashHandler.__call__): Added platform
3216 3221 info to crash reports.
3217 3222
3218 3223 * IPython/iplib.py (InteractiveShell.mainloop): Added -c option,
3219 3224 just like Python's -c. Also fixed crash with invalid -color
3220 3225 option value at startup. Thanks to Will French
3221 3226 <wfrench-AT-bestweb.net> for the bug report.
3222 3227
3223 3228 2003-05-09 Fernando Perez <fperez@colorado.edu>
3224 3229
3225 3230 * IPython/genutils.py (EvalDict.__getitem__): Renamed EvalString
3226 3231 to EvalDict (it's a mapping, after all) and simplified its code
3227 3232 quite a bit, after a nice discussion on c.l.py where Gustavo
3228 3233 CΓ³rdova <gcordova-AT-sismex.com> suggested the new version.
3229 3234
3230 3235 2003-04-30 Fernando Perez <fperez@colorado.edu>
3231 3236
3232 3237 * IPython/genutils.py (timings_out): modified it to reduce its
3233 3238 overhead in the common reps==1 case.
3234 3239
3235 3240 2003-04-29 Fernando Perez <fperez@colorado.edu>
3236 3241
3237 3242 * IPython/genutils.py (timings_out): Modified to use the resource
3238 3243 module, which avoids the wraparound problems of time.clock().
3239 3244
3240 3245 2003-04-17 *** Released version 0.2.15pre4
3241 3246
3242 3247 2003-04-17 Fernando Perez <fperez@colorado.edu>
3243 3248
3244 3249 * setup.py (scriptfiles): Split windows-specific stuff over to a
3245 3250 separate file, in an attempt to have a Windows GUI installer.
3246 3251 That didn't work, but part of the groundwork is done.
3247 3252
3248 3253 * IPython/UserConfig/ipythonrc: Added M-i, M-o and M-I for
3249 3254 indent/unindent with 4 spaces. Particularly useful in combination
3250 3255 with the new auto-indent option.
3251 3256
3252 3257 2003-04-16 Fernando Perez <fperez@colorado.edu>
3253 3258
3254 3259 * IPython/Magic.py: various replacements of self.rc for
3255 3260 self.shell.rc. A lot more remains to be done to fully disentangle
3256 3261 this class from the main Shell class.
3257 3262
3258 3263 * IPython/GnuplotRuntime.py: added checks for mouse support so
3259 3264 that we don't try to enable it if the current gnuplot doesn't
3260 3265 really support it. Also added checks so that we don't try to
3261 3266 enable persist under Windows (where Gnuplot doesn't recognize the
3262 3267 option).
3263 3268
3264 3269 * IPython/iplib.py (InteractiveShell.interact): Added optional
3265 3270 auto-indenting code, after a patch by King C. Shu
3266 3271 <kingshu-AT-myrealbox.com>. It's off by default because it doesn't
3267 3272 get along well with pasting indented code. If I ever figure out
3268 3273 how to make that part go well, it will become on by default.
3269 3274
3270 3275 * IPython/Prompts.py (Prompt1.auto_rewrite): Fixed bug which would
3271 3276 crash ipython if there was an unmatched '%' in the user's prompt
3272 3277 string. Reported by Thorsten Kampe <thorsten-AT-thorstenkampe.de>.
3273 3278
3274 3279 * IPython/iplib.py (InteractiveShell.interact): removed the
3275 3280 ability to ask the user whether he wants to crash or not at the
3276 3281 'last line' exception handler. Calling functions at that point
3277 3282 changes the stack, and the error reports would have incorrect
3278 3283 tracebacks.
3279 3284
3280 3285 * IPython/Magic.py (Magic.magic_page): Added new @page magic, to
3281 3286 pass through a peger a pretty-printed form of any object. After a
3282 3287 contribution by Olivier Aubert <oaubert-AT-bat710.univ-lyon1.fr>
3283 3288
3284 3289 2003-04-14 Fernando Perez <fperez@colorado.edu>
3285 3290
3286 3291 * IPython/iplib.py (InteractiveShell.user_setup): Fixed bug where
3287 3292 all files in ~ would be modified at first install (instead of
3288 3293 ~/.ipython). This could be potentially disastrous, as the
3289 3294 modification (make line-endings native) could damage binary files.
3290 3295
3291 3296 2003-04-10 Fernando Perez <fperez@colorado.edu>
3292 3297
3293 3298 * IPython/iplib.py (InteractiveShell.handle_help): Modified to
3294 3299 handle only lines which are invalid python. This now means that
3295 3300 lines like 'x=1 #?' execute properly. Thanks to Jeffery Collins
3296 3301 for the bug report.
3297 3302
3298 3303 2003-04-01 Fernando Perez <fperez@colorado.edu>
3299 3304
3300 3305 * IPython/iplib.py (InteractiveShell.showtraceback): Fixed bug
3301 3306 where failing to set sys.last_traceback would crash pdb.pm().
3302 3307 Thanks to Jeffery D. Collins <Jeff.Collins-AT-vexcel.com> for the bug
3303 3308 report.
3304 3309
3305 3310 2003-03-25 Fernando Perez <fperez@colorado.edu>
3306 3311
3307 3312 * IPython/Magic.py (Magic.magic_prun): rstrip() output of profiler
3308 3313 before printing it (it had a lot of spurious blank lines at the
3309 3314 end).
3310 3315
3311 3316 * IPython/Gnuplot2.py (Gnuplot.hardcopy): fixed bug where lpr
3312 3317 output would be sent 21 times! Obviously people don't use this
3313 3318 too often, or I would have heard about it.
3314 3319
3315 3320 2003-03-24 Fernando Perez <fperez@colorado.edu>
3316 3321
3317 3322 * setup.py (scriptfiles): renamed the data_files parameter from
3318 3323 'base' to 'data' to fix rpm build issues. Thanks to Ralf Ahlbrink
3319 3324 for the patch.
3320 3325
3321 3326 2003-03-20 Fernando Perez <fperez@colorado.edu>
3322 3327
3323 3328 * IPython/genutils.py (error): added error() and fatal()
3324 3329 functions.
3325 3330
3326 3331 2003-03-18 *** Released version 0.2.15pre3
3327 3332
3328 3333 2003-03-18 Fernando Perez <fperez@colorado.edu>
3329 3334
3330 3335 * setupext/install_data_ext.py
3331 3336 (install_data_ext.initialize_options): Class contributed by Jack
3332 3337 Moffit for fixing the old distutils hack. He is sending this to
3333 3338 the distutils folks so in the future we may not need it as a
3334 3339 private fix.
3335 3340
3336 3341 * MANIFEST.in: Extensive reorganization, based on Jack Moffit's
3337 3342 changes for Debian packaging. See his patch for full details.
3338 3343 The old distutils hack of making the ipythonrc* files carry a
3339 3344 bogus .py extension is gone, at last. Examples were moved to a
3340 3345 separate subdir under doc/, and the separate executable scripts
3341 3346 now live in their own directory. Overall a great cleanup. The
3342 3347 manual was updated to use the new files, and setup.py has been
3343 3348 fixed for this setup.
3344 3349
3345 3350 * IPython/PyColorize.py (Parser.usage): made non-executable and
3346 3351 created a pycolor wrapper around it to be included as a script.
3347 3352
3348 3353 2003-03-12 *** Released version 0.2.15pre2
3349 3354
3350 3355 2003-03-12 Fernando Perez <fperez@colorado.edu>
3351 3356
3352 3357 * IPython/ColorANSI.py (make_color_table): Finally fixed the
3353 3358 long-standing problem with garbage characters in some terminals.
3354 3359 The issue was really that the \001 and \002 escapes must _only_ be
3355 3360 passed to input prompts (which call readline), but _never_ to
3356 3361 normal text to be printed on screen. I changed ColorANSI to have
3357 3362 two classes: TermColors and InputTermColors, each with the
3358 3363 appropriate escapes for input prompts or normal text. The code in
3359 3364 Prompts.py got slightly more complicated, but this very old and
3360 3365 annoying bug is finally fixed.
3361 3366
3362 3367 All the credit for nailing down the real origin of this problem
3363 3368 and the correct solution goes to Jack Moffit <jack-AT-xiph.org>.
3364 3369 *Many* thanks to him for spending quite a bit of effort on this.
3365 3370
3366 3371 2003-03-05 *** Released version 0.2.15pre1
3367 3372
3368 3373 2003-03-03 Fernando Perez <fperez@colorado.edu>
3369 3374
3370 3375 * IPython/FakeModule.py: Moved the former _FakeModule to a
3371 3376 separate file, because it's also needed by Magic (to fix a similar
3372 3377 pickle-related issue in @run).
3373 3378
3374 3379 2003-03-02 Fernando Perez <fperez@colorado.edu>
3375 3380
3376 3381 * IPython/Magic.py (Magic.magic_autocall): new magic to control
3377 3382 the autocall option at runtime.
3378 3383 (Magic.magic_dhist): changed self.user_ns to self.shell.user_ns
3379 3384 across Magic.py to start separating Magic from InteractiveShell.
3380 3385 (Magic._ofind): Fixed to return proper namespace for dotted
3381 3386 names. Before, a dotted name would always return 'not currently
3382 3387 defined', because it would find the 'parent'. s.x would be found,
3383 3388 but since 'x' isn't defined by itself, it would get confused.
3384 3389 (Magic.magic_run): Fixed pickling problems reported by Ralf
3385 3390 Ahlbrink <RAhlbrink-AT-RosenInspection.net>. The fix was similar to
3386 3391 that I'd used when Mike Heeter reported similar issues at the
3387 3392 top-level, but now for @run. It boils down to injecting the
3388 3393 namespace where code is being executed with something that looks
3389 3394 enough like a module to fool pickle.dump(). Since a pickle stores
3390 3395 a named reference to the importing module, we need this for
3391 3396 pickles to save something sensible.
3392 3397
3393 3398 * IPython/ipmaker.py (make_IPython): added an autocall option.
3394 3399
3395 3400 * IPython/iplib.py (InteractiveShell._prefilter): reordered all of
3396 3401 the auto-eval code. Now autocalling is an option, and the code is
3397 3402 also vastly safer. There is no more eval() involved at all.
3398 3403
3399 3404 2003-03-01 Fernando Perez <fperez@colorado.edu>
3400 3405
3401 3406 * IPython/Magic.py (Magic._ofind): Changed interface to return a
3402 3407 dict with named keys instead of a tuple.
3403 3408
3404 3409 * IPython: Started using CVS for IPython as of 0.2.15pre1.
3405 3410
3406 3411 * setup.py (make_shortcut): Fixed message about directories
3407 3412 created during Windows installation (the directories were ok, just
3408 3413 the printed message was misleading). Thanks to Chris Liechti
3409 3414 <cliechti-AT-gmx.net> for the heads up.
3410 3415
3411 3416 2003-02-21 Fernando Perez <fperez@colorado.edu>
3412 3417
3413 3418 * IPython/iplib.py (InteractiveShell._prefilter): Fixed catching
3414 3419 of ValueError exception when checking for auto-execution. This
3415 3420 one is raised by things like Numeric arrays arr.flat when the
3416 3421 array is non-contiguous.
3417 3422
3418 3423 2003-01-31 Fernando Perez <fperez@colorado.edu>
3419 3424
3420 3425 * IPython/genutils.py (SystemExec.bq): Fixed bug where bq would
3421 3426 not return any value at all (even though the command would get
3422 3427 executed).
3423 3428 (xsys): Flush stdout right after printing the command to ensure
3424 3429 proper ordering of commands and command output in the total
3425 3430 output.
3426 3431 (SystemExec/xsys/bq): Switched the names of xsys/bq and
3427 3432 system/getoutput as defaults. The old ones are kept for
3428 3433 compatibility reasons, so no code which uses this library needs
3429 3434 changing.
3430 3435
3431 3436 2003-01-27 *** Released version 0.2.14
3432 3437
3433 3438 2003-01-25 Fernando Perez <fperez@colorado.edu>
3434 3439
3435 3440 * IPython/Magic.py (Magic.magic_edit): Fixed problem where
3436 3441 functions defined in previous edit sessions could not be re-edited
3437 3442 (because the temp files were immediately removed). Now temp files
3438 3443 are removed only at IPython's exit.
3439 3444 (Magic.magic_run): Improved @run to perform shell-like expansions
3440 3445 on its arguments (~users and $VARS). With this, @run becomes more
3441 3446 like a normal command-line.
3442 3447
3443 3448 * IPython/Shell.py (IPShellEmbed.__call__): Fixed a bunch of small
3444 3449 bugs related to embedding and cleaned up that code. A fairly
3445 3450 important one was the impossibility to access the global namespace
3446 3451 through the embedded IPython (only local variables were visible).
3447 3452
3448 3453 2003-01-14 Fernando Perez <fperez@colorado.edu>
3449 3454
3450 3455 * IPython/iplib.py (InteractiveShell._prefilter): Fixed
3451 3456 auto-calling to be a bit more conservative. Now it doesn't get
3452 3457 triggered if any of '!=()<>' are in the rest of the input line, to
3453 3458 allow comparing callables. Thanks to Alex for the heads up.
3454 3459
3455 3460 2003-01-07 Fernando Perez <fperez@colorado.edu>
3456 3461
3457 3462 * IPython/genutils.py (page): fixed estimation of the number of
3458 3463 lines in a string to be paged to simply count newlines. This
3459 3464 prevents over-guessing due to embedded escape sequences. A better
3460 3465 long-term solution would involve stripping out the control chars
3461 3466 for the count, but it's potentially so expensive I just don't
3462 3467 think it's worth doing.
3463 3468
3464 3469 2002-12-19 *** Released version 0.2.14pre50
3465 3470
3466 3471 2002-12-19 Fernando Perez <fperez@colorado.edu>
3467 3472
3468 3473 * tools/release (version): Changed release scripts to inform
3469 3474 Andrea and build a NEWS file with a list of recent changes.
3470 3475
3471 3476 * IPython/ColorANSI.py (__all__): changed terminal detection
3472 3477 code. Seems to work better for xterms without breaking
3473 3478 konsole. Will need more testing to determine if WinXP and Mac OSX
3474 3479 also work ok.
3475 3480
3476 3481 2002-12-18 *** Released version 0.2.14pre49
3477 3482
3478 3483 2002-12-18 Fernando Perez <fperez@colorado.edu>
3479 3484
3480 3485 * Docs: added new info about Mac OSX, from Andrea.
3481 3486
3482 3487 * IPython/Gnuplot2.py (String): Added a String PlotItem class to
3483 3488 allow direct plotting of python strings whose format is the same
3484 3489 of gnuplot data files.
3485 3490
3486 3491 2002-12-16 Fernando Perez <fperez@colorado.edu>
3487 3492
3488 3493 * IPython/iplib.py (InteractiveShell.interact): fixed default (y)
3489 3494 value of exit question to be acknowledged.
3490 3495
3491 3496 2002-12-03 Fernando Perez <fperez@colorado.edu>
3492 3497
3493 3498 * IPython/ipmaker.py: removed generators, which had been added
3494 3499 by mistake in an earlier debugging run. This was causing trouble
3495 3500 to users of python 2.1.x. Thanks to Abel Daniel <abli-AT-freemail.hu>
3496 3501 for pointing this out.
3497 3502
3498 3503 2002-11-17 Fernando Perez <fperez@colorado.edu>
3499 3504
3500 3505 * Manual: updated the Gnuplot section.
3501 3506
3502 3507 * IPython/GnuplotRuntime.py: refactored a lot all this code, with
3503 3508 a much better split of what goes in Runtime and what goes in
3504 3509 Interactive.
3505 3510
3506 3511 * IPython/ipmaker.py: fixed bug where import_fail_info wasn't
3507 3512 being imported from iplib.
3508 3513
3509 3514 * IPython/GnuplotInteractive.py (magic_gpc): renamed @gp to @gpc
3510 3515 for command-passing. Now the global Gnuplot instance is called
3511 3516 'gp' instead of 'g', which was really a far too fragile and
3512 3517 common name.
3513 3518
3514 3519 * IPython/Gnuplot2.py (eps_fix_bbox): added this to fix broken
3515 3520 bounding boxes generated by Gnuplot for square plots.
3516 3521
3517 3522 * IPython/genutils.py (popkey): new function added. I should
3518 3523 suggest this on c.l.py as a dict method, it seems useful.
3519 3524
3520 3525 * IPython/Gnuplot2.py (Gnuplot.plot): Overhauled plot and replot
3521 3526 to transparently handle PostScript generation. MUCH better than
3522 3527 the previous plot_eps/replot_eps (which I removed now). The code
3523 3528 is also fairly clean and well documented now (including
3524 3529 docstrings).
3525 3530
3526 3531 2002-11-13 Fernando Perez <fperez@colorado.edu>
3527 3532
3528 3533 * IPython/Magic.py (Magic.magic_edit): fixed docstring
3529 3534 (inconsistent with options).
3530 3535
3531 3536 * IPython/Gnuplot2.py (Gnuplot.hardcopy): hardcopy had been
3532 3537 manually disabled, I don't know why. Fixed it.
3533 3538 (Gnuplot._plot_eps): added new plot_eps/replot_eps to get directly
3534 3539 eps output.
3535 3540
3536 3541 2002-11-12 Fernando Perez <fperez@colorado.edu>
3537 3542
3538 3543 * IPython/genutils.py (ask_yes_no): trap EOF and ^C so that they
3539 3544 don't propagate up to caller. Fixes crash reported by François
3540 3545 Pinard.
3541 3546
3542 3547 2002-11-09 Fernando Perez <fperez@colorado.edu>
3543 3548
3544 3549 * IPython/ipmaker.py (make_IPython): fixed problem with writing
3545 3550 history file for new users.
3546 3551 (make_IPython): fixed bug where initial install would leave the
3547 3552 user running in the .ipython dir.
3548 3553 (make_IPython): fixed bug where config dir .ipython would be
3549 3554 created regardless of the given -ipythondir option. Thanks to Cory
3550 3555 Dodt <cdodt-AT-fcoe.k12.ca.us> for the bug report.
3551 3556
3552 3557 * IPython/genutils.py (ask_yes_no): new function for asking yes/no
3553 3558 type confirmations. Will need to use it in all of IPython's code
3554 3559 consistently.
3555 3560
3556 3561 * IPython/CrashHandler.py (CrashHandler.__call__): changed the
3557 3562 context to print 31 lines instead of the default 5. This will make
3558 3563 the crash reports extremely detailed in case the problem is in
3559 3564 libraries I don't have access to.
3560 3565
3561 3566 * IPython/iplib.py (InteractiveShell.interact): changed the 'last
3562 3567 line of defense' code to still crash, but giving users fair
3563 3568 warning. I don't want internal errors to go unreported: if there's
3564 3569 an internal problem, IPython should crash and generate a full
3565 3570 report.
3566 3571
3567 3572 2002-11-08 Fernando Perez <fperez@colorado.edu>
3568 3573
3569 3574 * IPython/iplib.py (InteractiveShell.interact): added code to trap
3570 3575 otherwise uncaught exceptions which can appear if people set
3571 3576 sys.stdout to something badly broken. Thanks to a crash report
3572 3577 from henni-AT-mail.brainbot.com.
3573 3578
3574 3579 2002-11-04 Fernando Perez <fperez@colorado.edu>
3575 3580
3576 3581 * IPython/iplib.py (InteractiveShell.interact): added
3577 3582 __IPYTHON__active to the builtins. It's a flag which goes on when
3578 3583 the interaction starts and goes off again when it stops. This
3579 3584 allows embedding code to detect being inside IPython. Before this
3580 3585 was done via __IPYTHON__, but that only shows that an IPython
3581 3586 instance has been created.
3582 3587
3583 3588 * IPython/Magic.py (Magic.magic_env): I realized that in a
3584 3589 UserDict, instance.data holds the data as a normal dict. So I
3585 3590 modified @env to return os.environ.data instead of rebuilding a
3586 3591 dict by hand.
3587 3592
3588 3593 2002-11-02 Fernando Perez <fperez@colorado.edu>
3589 3594
3590 3595 * IPython/genutils.py (warn): changed so that level 1 prints no
3591 3596 header. Level 2 is now the default (with 'WARNING' header, as
3592 3597 before). I think I tracked all places where changes were needed in
3593 3598 IPython, but outside code using the old level numbering may have
3594 3599 broken.
3595 3600
3596 3601 * IPython/iplib.py (InteractiveShell.runcode): added this to
3597 3602 handle the tracebacks in SystemExit traps correctly. The previous
3598 3603 code (through interact) was printing more of the stack than
3599 3604 necessary, showing IPython internal code to the user.
3600 3605
3601 3606 * IPython/UserConfig/ipythonrc.py: Made confirm_exit 1 by
3602 3607 default. Now that the default at the confirmation prompt is yes,
3603 3608 it's not so intrusive. François' argument that ipython sessions
3604 3609 tend to be complex enough not to lose them from an accidental C-d,
3605 3610 is a valid one.
3606 3611
3607 3612 * IPython/iplib.py (InteractiveShell.interact): added a
3608 3613 showtraceback() call to the SystemExit trap, and modified the exit
3609 3614 confirmation to have yes as the default.
3610 3615
3611 3616 * IPython/UserConfig/ipythonrc.py: removed 'session' option from
3612 3617 this file. It's been gone from the code for a long time, this was
3613 3618 simply leftover junk.
3614 3619
3615 3620 2002-11-01 Fernando Perez <fperez@colorado.edu>
3616 3621
3617 3622 * IPython/UserConfig/ipythonrc.py: new confirm_exit option
3618 3623 added. If set, IPython now traps EOF and asks for
3619 3624 confirmation. After a request by François Pinard.
3620 3625
3621 3626 * IPython/Magic.py (Magic.magic_Exit): New @Exit and @Quit instead
3622 3627 of @abort, and with a new (better) mechanism for handling the
3623 3628 exceptions.
3624 3629
3625 3630 2002-10-27 Fernando Perez <fperez@colorado.edu>
3626 3631
3627 3632 * IPython/usage.py (__doc__): updated the --help information and
3628 3633 the ipythonrc file to indicate that -log generates
3629 3634 ./ipython.log. Also fixed the corresponding info in @logstart.
3630 3635 This and several other fixes in the manuals thanks to reports by
3631 3636 François Pinard <pinard-AT-iro.umontreal.ca>.
3632 3637
3633 3638 * IPython/Logger.py (Logger.switch_log): Fixed error message to
3634 3639 refer to @logstart (instead of @log, which doesn't exist).
3635 3640
3636 3641 * IPython/iplib.py (InteractiveShell._prefilter): fixed
3637 3642 AttributeError crash. Thanks to Christopher Armstrong
3638 3643 <radix-AT-twistedmatrix.com> for the report/fix. This bug had been
3639 3644 introduced recently (in 0.2.14pre37) with the fix to the eval
3640 3645 problem mentioned below.
3641 3646
3642 3647 2002-10-17 Fernando Perez <fperez@colorado.edu>
3643 3648
3644 3649 * IPython/ConfigLoader.py (ConfigLoader.load): Fixes for Windows
3645 3650 installation. Thanks to Leonardo Santagada <retype-AT-terra.com.br>.
3646 3651
3647 3652 * IPython/iplib.py (InteractiveShell._prefilter): Many changes to
3648 3653 this function to fix a problem reported by Alex Schmolck. He saw
3649 3654 it with list comprehensions and generators, which were getting
3650 3655 called twice. The real problem was an 'eval' call in testing for
3651 3656 automagic which was evaluating the input line silently.
3652 3657
3653 3658 This is a potentially very nasty bug, if the input has side
3654 3659 effects which must not be repeated. The code is much cleaner now,
3655 3660 without any blanket 'except' left and with a regexp test for
3656 3661 actual function names.
3657 3662
3658 3663 But an eval remains, which I'm not fully comfortable with. I just
3659 3664 don't know how to find out if an expression could be a callable in
3660 3665 the user's namespace without doing an eval on the string. However
3661 3666 that string is now much more strictly checked so that no code
3662 3667 slips by, so the eval should only happen for things that can
3663 3668 really be only function/method names.
3664 3669
3665 3670 2002-10-15 Fernando Perez <fperez@colorado.edu>
3666 3671
3667 3672 * Updated LyX to 1.2.1 so I can work on the docs again. Added Mac
3668 3673 OSX information to main manual, removed README_Mac_OSX file from
3669 3674 distribution. Also updated credits for recent additions.
3670 3675
3671 3676 2002-10-10 Fernando Perez <fperez@colorado.edu>
3672 3677
3673 3678 * README_Mac_OSX: Added a README for Mac OSX users for fixing
3674 3679 terminal-related issues. Many thanks to Andrea Riciputi
3675 3680 <andrea.riciputi-AT-libero.it> for writing it.
3676 3681
3677 3682 * IPython/UserConfig/ipythonrc.py: Fixes to various small issues,
3678 3683 thanks to Thorsten Kampe <thorsten-AT-thorstenkampe.de>.
3679 3684
3680 3685 * setup.py (make_shortcut): Fixes for Windows installation. Thanks
3681 3686 to Fredrik Kant <fredrik.kant-AT-front.com> and Syver Enstad
3682 3687 <syver-en-AT-online.no> who both submitted patches for this problem.
3683 3688
3684 3689 * IPython/iplib.py (InteractiveShell.embed_mainloop): Patch for
3685 3690 global embedding to make sure that things don't overwrite user
3686 3691 globals accidentally. Thanks to Richard <rxe-AT-renre-europe.com>
3687 3692
3688 3693 * IPython/Gnuplot2.py (gp): Patch for Gnuplot.py 1.6
3689 3694 compatibility. Thanks to Hayden Callow
3690 3695 <h.callow-AT-elec.canterbury.ac.nz>
3691 3696
3692 3697 2002-10-04 Fernando Perez <fperez@colorado.edu>
3693 3698
3694 3699 * IPython/Gnuplot2.py (PlotItem): Added 'index' option for
3695 3700 Gnuplot.File objects.
3696 3701
3697 3702 2002-07-23 Fernando Perez <fperez@colorado.edu>
3698 3703
3699 3704 * IPython/genutils.py (timing): Added timings() and timing() for
3700 3705 quick access to the most commonly needed data, the execution
3701 3706 times. Old timing() renamed to timings_out().
3702 3707
3703 3708 2002-07-18 Fernando Perez <fperez@colorado.edu>
3704 3709
3705 3710 * IPython/Shell.py (IPShellEmbed.restore_system_completer): fixed
3706 3711 bug with nested instances disrupting the parent's tab completion.
3707 3712
3708 3713 * IPython/iplib.py (all_completions): Added Alex Schmolck's
3709 3714 all_completions code to begin the emacs integration.
3710 3715
3711 3716 * IPython/Gnuplot2.py (zip_items): Added optional 'titles'
3712 3717 argument to allow titling individual arrays when plotting.
3713 3718
3714 3719 2002-07-15 Fernando Perez <fperez@colorado.edu>
3715 3720
3716 3721 * setup.py (make_shortcut): changed to retrieve the value of
3717 3722 'Program Files' directory from the registry (this value changes in
3718 3723 non-english versions of Windows). Thanks to Thomas Fanslau
3719 3724 <tfanslau-AT-gmx.de> for the report.
3720 3725
3721 3726 2002-07-10 Fernando Perez <fperez@colorado.edu>
3722 3727
3723 3728 * IPython/ultraTB.py (VerboseTB.debugger): enabled workaround for
3724 3729 a bug in pdb, which crashes if a line with only whitespace is
3725 3730 entered. Bug report submitted to sourceforge.
3726 3731
3727 3732 2002-07-09 Fernando Perez <fperez@colorado.edu>
3728 3733
3729 3734 * IPython/ultraTB.py (VerboseTB.nullrepr): fixed rare crash when
3730 3735 reporting exceptions (it's a bug in inspect.py, I just set a
3731 3736 workaround).
3732 3737
3733 3738 2002-07-08 Fernando Perez <fperez@colorado.edu>
3734 3739
3735 3740 * IPython/iplib.py (InteractiveShell.__init__): fixed reference to
3736 3741 __IPYTHON__ in __builtins__ to show up in user_ns.
3737 3742
3738 3743 2002-07-03 Fernando Perez <fperez@colorado.edu>
3739 3744
3740 3745 * IPython/GnuplotInteractive.py (magic_gp_set_default): changed
3741 3746 name from @gp_set_instance to @gp_set_default.
3742 3747
3743 3748 * IPython/ipmaker.py (make_IPython): default editor value set to
3744 3749 '0' (a string), to match the rc file. Otherwise will crash when
3745 3750 .strip() is called on it.
3746 3751
3747 3752
3748 3753 2002-06-28 Fernando Perez <fperez@colorado.edu>
3749 3754
3750 3755 * IPython/iplib.py (InteractiveShell.safe_execfile): fix importing
3751 3756 of files in current directory when a file is executed via
3752 3757 @run. Patch also by RA <ralf_ahlbrink-AT-web.de>.
3753 3758
3754 3759 * setup.py (manfiles): fix for rpm builds, submitted by RA
3755 3760 <ralf_ahlbrink-AT-web.de>. Now we have RPMs!
3756 3761
3757 3762 * IPython/ipmaker.py (make_IPython): fixed lookup of default
3758 3763 editor when set to '0'. Problem was, '0' evaluates to True (it's a
3759 3764 string!). A. Schmolck caught this one.
3760 3765
3761 3766 2002-06-27 Fernando Perez <fperez@colorado.edu>
3762 3767
3763 3768 * IPython/ipmaker.py (make_IPython): fixed bug when running user
3764 3769 defined files at the cmd line. __name__ wasn't being set to
3765 3770 __main__.
3766 3771
3767 3772 * IPython/Gnuplot2.py (zip_items): improved it so it can plot also
3768 3773 regular lists and tuples besides Numeric arrays.
3769 3774
3770 3775 * IPython/Prompts.py (CachedOutput.__call__): Added output
3771 3776 supression for input ending with ';'. Similar to Mathematica and
3772 3777 Matlab. The _* vars and Out[] list are still updated, just like
3773 3778 Mathematica behaves.
3774 3779
3775 3780 2002-06-25 Fernando Perez <fperez@colorado.edu>
3776 3781
3777 3782 * IPython/ConfigLoader.py (ConfigLoader.load): fixed checking of
3778 3783 .ini extensions for profiels under Windows.
3779 3784
3780 3785 * IPython/OInspect.py (Inspector.pinfo): improved alignment of
3781 3786 string form. Fix contributed by Alexander Schmolck
3782 3787 <a.schmolck-AT-gmx.net>
3783 3788
3784 3789 * IPython/GnuplotRuntime.py (gp_new): new function. Returns a
3785 3790 pre-configured Gnuplot instance.
3786 3791
3787 3792 2002-06-21 Fernando Perez <fperez@colorado.edu>
3788 3793
3789 3794 * IPython/numutils.py (exp_safe): new function, works around the
3790 3795 underflow problems in Numeric.
3791 3796 (log2): New fn. Safe log in base 2: returns exact integer answer
3792 3797 for exact integer powers of 2.
3793 3798
3794 3799 * IPython/Magic.py (get_py_filename): fixed it not expanding '~'
3795 3800 properly.
3796 3801
3797 3802 2002-06-20 Fernando Perez <fperez@colorado.edu>
3798 3803
3799 3804 * IPython/genutils.py (timing): new function like
3800 3805 Mathematica's. Similar to time_test, but returns more info.
3801 3806
3802 3807 2002-06-18 Fernando Perez <fperez@colorado.edu>
3803 3808
3804 3809 * IPython/Magic.py (Magic.magic_save): modified @save and @r
3805 3810 according to Mike Heeter's suggestions.
3806 3811
3807 3812 2002-06-16 Fernando Perez <fperez@colorado.edu>
3808 3813
3809 3814 * IPython/GnuplotRuntime.py: Massive overhaul to the Gnuplot
3810 3815 system. GnuplotMagic is gone as a user-directory option. New files
3811 3816 make it easier to use all the gnuplot stuff both from external
3812 3817 programs as well as from IPython. Had to rewrite part of
3813 3818 hardcopy() b/c of a strange bug: often the ps files simply don't
3814 3819 get created, and require a repeat of the command (often several
3815 3820 times).
3816 3821
3817 3822 * IPython/ultraTB.py (AutoFormattedTB.__call__): changed to
3818 3823 resolve output channel at call time, so that if sys.stderr has
3819 3824 been redirected by user this gets honored.
3820 3825
3821 3826 2002-06-13 Fernando Perez <fperez@colorado.edu>
3822 3827
3823 3828 * IPython/Shell.py (IPShell.__init__): Changed IPythonShell to
3824 3829 IPShell. Kept a copy with the old names to avoid breaking people's
3825 3830 embedded code.
3826 3831
3827 3832 * IPython/ipython: simplified it to the bare minimum after
3828 3833 Holger's suggestions. Added info about how to use it in
3829 3834 PYTHONSTARTUP.
3830 3835
3831 3836 * IPython/Shell.py (IPythonShell): changed the options passing
3832 3837 from a string with funky %s replacements to a straight list. Maybe
3833 3838 a bit more typing, but it follows sys.argv conventions, so there's
3834 3839 less special-casing to remember.
3835 3840
3836 3841 2002-06-12 Fernando Perez <fperez@colorado.edu>
3837 3842
3838 3843 * IPython/Magic.py (Magic.magic_r): new magic auto-repeat
3839 3844 command. Thanks to a suggestion by Mike Heeter.
3840 3845 (Magic.magic_pfile): added behavior to look at filenames if given
3841 3846 arg is not a defined object.
3842 3847 (Magic.magic_save): New @save function to save code snippets. Also
3843 3848 a Mike Heeter idea.
3844 3849
3845 3850 * IPython/UserConfig/GnuplotMagic.py (plot): Improvements to
3846 3851 plot() and replot(). Much more convenient now, especially for
3847 3852 interactive use.
3848 3853
3849 3854 * IPython/Magic.py (Magic.magic_run): Added .py automatically to
3850 3855 filenames.
3851 3856
3852 3857 2002-06-02 Fernando Perez <fperez@colorado.edu>
3853 3858
3854 3859 * IPython/Struct.py (Struct.__init__): modified to admit
3855 3860 initialization via another struct.
3856 3861
3857 3862 * IPython/genutils.py (SystemExec.__init__): New stateful
3858 3863 interface to xsys and bq. Useful for writing system scripts.
3859 3864
3860 3865 2002-05-30 Fernando Perez <fperez@colorado.edu>
3861 3866
3862 3867 * MANIFEST.in: Changed docfile selection to exclude all the lyx
3863 3868 documents. This will make the user download smaller (it's getting
3864 3869 too big).
3865 3870
3866 3871 2002-05-29 Fernando Perez <fperez@colorado.edu>
3867 3872
3868 3873 * IPython/iplib.py (_FakeModule.__init__): New class introduced to
3869 3874 fix problems with shelve and pickle. Seems to work, but I don't
3870 3875 know if corner cases break it. Thanks to Mike Heeter
3871 3876 <korora-AT-SDF.LONESTAR.ORG> for the bug reports and test cases.
3872 3877
3873 3878 2002-05-24 Fernando Perez <fperez@colorado.edu>
3874 3879
3875 3880 * IPython/Magic.py (Macro.__init__): fixed magics embedded in
3876 3881 macros having broken.
3877 3882
3878 3883 2002-05-21 Fernando Perez <fperez@colorado.edu>
3879 3884
3880 3885 * IPython/Magic.py (Magic.magic_logstart): fixed recently
3881 3886 introduced logging bug: all history before logging started was
3882 3887 being written one character per line! This came from the redesign
3883 3888 of the input history as a special list which slices to strings,
3884 3889 not to lists.
3885 3890
3886 3891 2002-05-20 Fernando Perez <fperez@colorado.edu>
3887 3892
3888 3893 * IPython/Prompts.py (CachedOutput.__init__): made the color table
3889 3894 be an attribute of all classes in this module. The design of these
3890 3895 classes needs some serious overhauling.
3891 3896
3892 3897 * IPython/DPyGetOpt.py (DPyGetOpt.setPosixCompliance): fixed bug
3893 3898 which was ignoring '_' in option names.
3894 3899
3895 3900 * IPython/ultraTB.py (FormattedTB.__init__): Changed
3896 3901 'Verbose_novars' to 'Context' and made it the new default. It's a
3897 3902 bit more readable and also safer than verbose.
3898 3903
3899 3904 * IPython/PyColorize.py (Parser.__call__): Fixed coloring of
3900 3905 triple-quoted strings.
3901 3906
3902 3907 * IPython/OInspect.py (__all__): new module exposing the object
3903 3908 introspection facilities. Now the corresponding magics are dummy
3904 3909 wrappers around this. Having this module will make it much easier
3905 3910 to put these functions into our modified pdb.
3906 3911 This new object inspector system uses the new colorizing module,
3907 3912 so source code and other things are nicely syntax highlighted.
3908 3913
3909 3914 2002-05-18 Fernando Perez <fperez@colorado.edu>
3910 3915
3911 3916 * IPython/ColorANSI.py: Split the coloring tools into a separate
3912 3917 module so I can use them in other code easier (they were part of
3913 3918 ultraTB).
3914 3919
3915 3920 2002-05-17 Fernando Perez <fperez@colorado.edu>
3916 3921
3917 3922 * IPython/UserConfig/GnuplotMagic.py (magic_gp_set_instance):
3918 3923 fixed it to set the global 'g' also to the called instance, as
3919 3924 long as 'g' was still a gnuplot instance (so it doesn't overwrite
3920 3925 user's 'g' variables).
3921 3926
3922 3927 * IPython/iplib.py (InteractiveShell.__init__): Added In/Out
3923 3928 global variables (aliases to _ih,_oh) so that users which expect
3924 3929 In[5] or Out[7] to work aren't unpleasantly surprised.
3925 3930 (InputList.__getslice__): new class to allow executing slices of
3926 3931 input history directly. Very simple class, complements the use of
3927 3932 macros.
3928 3933
3929 3934 2002-05-16 Fernando Perez <fperez@colorado.edu>
3930 3935
3931 3936 * setup.py (docdirbase): make doc directory be just doc/IPython
3932 3937 without version numbers, it will reduce clutter for users.
3933 3938
3934 3939 * IPython/Magic.py (Magic.magic_run): Add explicit local dict to
3935 3940 execfile call to prevent possible memory leak. See for details:
3936 3941 http://mail.python.org/pipermail/python-list/2002-February/088476.html
3937 3942
3938 3943 2002-05-15 Fernando Perez <fperez@colorado.edu>
3939 3944
3940 3945 * IPython/Magic.py (Magic.magic_psource): made the object
3941 3946 introspection names be more standard: pdoc, pdef, pfile and
3942 3947 psource. They all print/page their output, and it makes
3943 3948 remembering them easier. Kept old names for compatibility as
3944 3949 aliases.
3945 3950
3946 3951 2002-05-14 Fernando Perez <fperez@colorado.edu>
3947 3952
3948 3953 * IPython/UserConfig/GnuplotMagic.py: I think I finally understood
3949 3954 what the mouse problem was. The trick is to use gnuplot with temp
3950 3955 files and NOT with pipes (for data communication), because having
3951 3956 both pipes and the mouse on is bad news.
3952 3957
3953 3958 2002-05-13 Fernando Perez <fperez@colorado.edu>
3954 3959
3955 3960 * IPython/Magic.py (Magic._ofind): fixed namespace order search
3956 3961 bug. Information would be reported about builtins even when
3957 3962 user-defined functions overrode them.
3958 3963
3959 3964 2002-05-11 Fernando Perez <fperez@colorado.edu>
3960 3965
3961 3966 * IPython/__init__.py (__all__): removed FlexCompleter from
3962 3967 __all__ so that things don't fail in platforms without readline.
3963 3968
3964 3969 2002-05-10 Fernando Perez <fperez@colorado.edu>
3965 3970
3966 3971 * IPython/__init__.py (__all__): removed numutils from __all__ b/c
3967 3972 it requires Numeric, effectively making Numeric a dependency for
3968 3973 IPython.
3969 3974
3970 3975 * Released 0.2.13
3971 3976
3972 3977 * IPython/Magic.py (Magic.magic_prun): big overhaul to the
3973 3978 profiler interface. Now all the major options from the profiler
3974 3979 module are directly supported in IPython, both for single
3975 3980 expressions (@prun) and for full programs (@run -p).
3976 3981
3977 3982 2002-05-09 Fernando Perez <fperez@colorado.edu>
3978 3983
3979 3984 * IPython/Magic.py (Magic.magic_doc): fixed to show docstrings of
3980 3985 magic properly formatted for screen.
3981 3986
3982 3987 * setup.py (make_shortcut): Changed things to put pdf version in
3983 3988 doc/ instead of doc/manual (had to change lyxport a bit).
3984 3989
3985 3990 * IPython/Magic.py (Profile.string_stats): made profile runs go
3986 3991 through pager (they are long and a pager allows searching, saving,
3987 3992 etc.)
3988 3993
3989 3994 2002-05-08 Fernando Perez <fperez@colorado.edu>
3990 3995
3991 3996 * Released 0.2.12
3992 3997
3993 3998 2002-05-06 Fernando Perez <fperez@colorado.edu>
3994 3999
3995 4000 * IPython/Magic.py (Magic.magic_hist): small bug fixed (recently
3996 4001 introduced); 'hist n1 n2' was broken.
3997 4002 (Magic.magic_pdb): added optional on/off arguments to @pdb
3998 4003 (Magic.magic_run): added option -i to @run, which executes code in
3999 4004 the IPython namespace instead of a clean one. Also added @irun as
4000 4005 an alias to @run -i.
4001 4006
4002 4007 * IPython/UserConfig/GnuplotMagic.py (magic_gp_set_instance):
4003 4008 fixed (it didn't really do anything, the namespaces were wrong).
4004 4009
4005 4010 * IPython/Debugger.py (__init__): Added workaround for python 2.1
4006 4011
4007 4012 * IPython/__init__.py (__all__): Fixed package namespace, now
4008 4013 'import IPython' does give access to IPython.<all> as
4009 4014 expected. Also renamed __release__ to Release.
4010 4015
4011 4016 * IPython/Debugger.py (__license__): created new Pdb class which
4012 4017 functions like a drop-in for the normal pdb.Pdb but does NOT
4013 4018 import readline by default. This way it doesn't muck up IPython's
4014 4019 readline handling, and now tab-completion finally works in the
4015 4020 debugger -- sort of. It completes things globally visible, but the
4016 4021 completer doesn't track the stack as pdb walks it. That's a bit
4017 4022 tricky, and I'll have to implement it later.
4018 4023
4019 4024 2002-05-05 Fernando Perez <fperez@colorado.edu>
4020 4025
4021 4026 * IPython/Magic.py (Magic.magic_oinfo): fixed formatting bug for
4022 4027 magic docstrings when printed via ? (explicit \'s were being
4023 4028 printed).
4024 4029
4025 4030 * IPython/ipmaker.py (make_IPython): fixed namespace
4026 4031 identification bug. Now variables loaded via logs or command-line
4027 4032 files are recognized in the interactive namespace by @who.
4028 4033
4029 4034 * IPython/iplib.py (InteractiveShell.safe_execfile): Fixed bug in
4030 4035 log replay system stemming from the string form of Structs.
4031 4036
4032 4037 * IPython/Magic.py (Macro.__init__): improved macros to properly
4033 4038 handle magic commands in them.
4034 4039 (Magic.magic_logstart): usernames are now expanded so 'logstart
4035 4040 ~/mylog' now works.
4036 4041
4037 4042 * IPython/iplib.py (complete): fixed bug where paths starting with
4038 4043 '/' would be completed as magic names.
4039 4044
4040 4045 2002-05-04 Fernando Perez <fperez@colorado.edu>
4041 4046
4042 4047 * IPython/Magic.py (Magic.magic_run): added options -p and -f to
4043 4048 allow running full programs under the profiler's control.
4044 4049
4045 4050 * IPython/ultraTB.py (FormattedTB.__init__): Added Verbose_novars
4046 4051 mode to report exceptions verbosely but without formatting
4047 4052 variables. This addresses the issue of ipython 'freezing' (it's
4048 4053 not frozen, but caught in an expensive formatting loop) when huge
4049 4054 variables are in the context of an exception.
4050 4055 (VerboseTB.text): Added '--->' markers at line where exception was
4051 4056 triggered. Much clearer to read, especially in NoColor modes.
4052 4057
4053 4058 * IPython/Magic.py (Magic.magic_run): bugfix: -n option had been
4054 4059 implemented in reverse when changing to the new parse_options().
4055 4060
4056 4061 2002-05-03 Fernando Perez <fperez@colorado.edu>
4057 4062
4058 4063 * IPython/Magic.py (Magic.parse_options): new function so that
4059 4064 magics can parse options easier.
4060 4065 (Magic.magic_prun): new function similar to profile.run(),
4061 4066 suggested by Chris Hart.
4062 4067 (Magic.magic_cd): fixed behavior so that it only changes if
4063 4068 directory actually is in history.
4064 4069
4065 4070 * IPython/usage.py (__doc__): added information about potential
4066 4071 slowness of Verbose exception mode when there are huge data
4067 4072 structures to be formatted (thanks to Archie Paulson).
4068 4073
4069 4074 * IPython/ipmaker.py (make_IPython): Changed default logging
4070 4075 (when simply called with -log) to use curr_dir/ipython.log in
4071 4076 rotate mode. Fixed crash which was occuring with -log before
4072 4077 (thanks to Jim Boyle).
4073 4078
4074 4079 2002-05-01 Fernando Perez <fperez@colorado.edu>
4075 4080
4076 4081 * Released 0.2.11 for these fixes (mainly the ultraTB one which
4077 4082 was nasty -- though somewhat of a corner case).
4078 4083
4079 4084 * IPython/ultraTB.py (AutoFormattedTB.text): renamed __text to
4080 4085 text (was a bug).
4081 4086
4082 4087 2002-04-30 Fernando Perez <fperez@colorado.edu>
4083 4088
4084 4089 * IPython/UserConfig/GnuplotMagic.py (magic_gp): Minor fix to add
4085 4090 a print after ^D or ^C from the user so that the In[] prompt
4086 4091 doesn't over-run the gnuplot one.
4087 4092
4088 4093 2002-04-29 Fernando Perez <fperez@colorado.edu>
4089 4094
4090 4095 * Released 0.2.10
4091 4096
4092 4097 * IPython/__release__.py (version): get date dynamically.
4093 4098
4094 4099 * Misc. documentation updates thanks to Arnd's comments. Also ran
4095 4100 a full spellcheck on the manual (hadn't been done in a while).
4096 4101
4097 4102 2002-04-27 Fernando Perez <fperez@colorado.edu>
4098 4103
4099 4104 * IPython/Magic.py (Magic.magic_logstart): Fixed bug where
4100 4105 starting a log in mid-session would reset the input history list.
4101 4106
4102 4107 2002-04-26 Fernando Perez <fperez@colorado.edu>
4103 4108
4104 4109 * IPython/iplib.py (InteractiveShell.wait): Fixed bug where not
4105 4110 all files were being included in an update. Now anything in
4106 4111 UserConfig that matches [A-Za-z]*.py will go (this excludes
4107 4112 __init__.py)
4108 4113
4109 4114 2002-04-25 Fernando Perez <fperez@colorado.edu>
4110 4115
4111 4116 * IPython/iplib.py (InteractiveShell.__init__): Added __IPYTHON__
4112 4117 to __builtins__ so that any form of embedded or imported code can
4113 4118 test for being inside IPython.
4114 4119
4115 4120 * IPython/UserConfig/GnuplotMagic.py: (magic_gp_set_instance):
4116 4121 changed to GnuplotMagic because it's now an importable module,
4117 4122 this makes the name follow that of the standard Gnuplot module.
4118 4123 GnuplotMagic can now be loaded at any time in mid-session.
4119 4124
4120 4125 2002-04-24 Fernando Perez <fperez@colorado.edu>
4121 4126
4122 4127 * IPython/numutils.py: removed SIUnits. It doesn't properly set
4123 4128 the globals (IPython has its own namespace) and the
4124 4129 PhysicalQuantity stuff is much better anyway.
4125 4130
4126 4131 * IPython/UserConfig/example-gnuplot.py (g2): Added gnuplot
4127 4132 embedding example to standard user directory for
4128 4133 distribution. Also put it in the manual.
4129 4134
4130 4135 * IPython/numutils.py (gnuplot_exec): Changed to take a gnuplot
4131 4136 instance as first argument (so it doesn't rely on some obscure
4132 4137 hidden global).
4133 4138
4134 4139 * IPython/UserConfig/ipythonrc.py: put () back in accepted
4135 4140 delimiters. While it prevents ().TAB from working, it allows
4136 4141 completions in open (... expressions. This is by far a more common
4137 4142 case.
4138 4143
4139 4144 2002-04-23 Fernando Perez <fperez@colorado.edu>
4140 4145
4141 4146 * IPython/Extensions/InterpreterPasteInput.py: new
4142 4147 syntax-processing module for pasting lines with >>> or ... at the
4143 4148 start.
4144 4149
4145 4150 * IPython/Extensions/PhysicalQ_Interactive.py
4146 4151 (PhysicalQuantityInteractive.__int__): fixed to work with either
4147 4152 Numeric or math.
4148 4153
4149 4154 * IPython/UserConfig/ipythonrc-numeric.py: reorganized the
4150 4155 provided profiles. Now we have:
4151 4156 -math -> math module as * and cmath with its own namespace.
4152 4157 -numeric -> Numeric as *, plus gnuplot & grace
4153 4158 -physics -> same as before
4154 4159
4155 4160 * IPython/Magic.py (Magic.magic_magic): Fixed bug where
4156 4161 user-defined magics wouldn't be found by @magic if they were
4157 4162 defined as class methods. Also cleaned up the namespace search
4158 4163 logic and the string building (to use %s instead of many repeated
4159 4164 string adds).
4160 4165
4161 4166 * IPython/UserConfig/example-magic.py (magic_foo): updated example
4162 4167 of user-defined magics to operate with class methods (cleaner, in
4163 4168 line with the gnuplot code).
4164 4169
4165 4170 2002-04-22 Fernando Perez <fperez@colorado.edu>
4166 4171
4167 4172 * setup.py: updated dependency list so that manual is updated when
4168 4173 all included files change.
4169 4174
4170 4175 * IPython/ipmaker.py (make_IPython): Fixed bug which was ignoring
4171 4176 the delimiter removal option (the fix is ugly right now).
4172 4177
4173 4178 * IPython/UserConfig/ipythonrc-physics.py: simplified not to load
4174 4179 all of the math profile (quicker loading, no conflict between
4175 4180 g-9.8 and g-gnuplot).
4176 4181
4177 4182 * IPython/CrashHandler.py (CrashHandler.__call__): changed default
4178 4183 name of post-mortem files to IPython_crash_report.txt.
4179 4184
4180 4185 * Cleanup/update of the docs. Added all the new readline info and
4181 4186 formatted all lists as 'real lists'.
4182 4187
4183 4188 * IPython/ipmaker.py (make_IPython): removed now-obsolete
4184 4189 tab-completion options, since the full readline parse_and_bind is
4185 4190 now accessible.
4186 4191
4187 4192 * IPython/iplib.py (InteractiveShell.init_readline): Changed
4188 4193 handling of readline options. Now users can specify any string to
4189 4194 be passed to parse_and_bind(), as well as the delimiters to be
4190 4195 removed.
4191 4196 (InteractiveShell.__init__): Added __name__ to the global
4192 4197 namespace so that things like Itpl which rely on its existence
4193 4198 don't crash.
4194 4199 (InteractiveShell._prefilter): Defined the default with a _ so
4195 4200 that prefilter() is easier to override, while the default one
4196 4201 remains available.
4197 4202
4198 4203 2002-04-18 Fernando Perez <fperez@colorado.edu>
4199 4204
4200 4205 * Added information about pdb in the docs.
4201 4206
4202 4207 2002-04-17 Fernando Perez <fperez@colorado.edu>
4203 4208
4204 4209 * IPython/ipmaker.py (make_IPython): added rc_override option to
4205 4210 allow passing config options at creation time which may override
4206 4211 anything set in the config files or command line. This is
4207 4212 particularly useful for configuring embedded instances.
4208 4213
4209 4214 2002-04-15 Fernando Perez <fperez@colorado.edu>
4210 4215
4211 4216 * IPython/Logger.py (Logger.log): Fixed a nasty bug which could
4212 4217 crash embedded instances because of the input cache falling out of
4213 4218 sync with the output counter.
4214 4219
4215 4220 * IPython/Shell.py (IPythonShellEmbed.__init__): added a debug
4216 4221 mode which calls pdb after an uncaught exception in IPython itself.
4217 4222
4218 4223 2002-04-14 Fernando Perez <fperez@colorado.edu>
4219 4224
4220 4225 * IPython/iplib.py (InteractiveShell.showtraceback): pdb mucks up
4221 4226 readline, fix it back after each call.
4222 4227
4223 4228 * IPython/ultraTB.py (AutoFormattedTB.__text): made text a private
4224 4229 method to force all access via __call__(), which guarantees that
4225 4230 traceback references are properly deleted.
4226 4231
4227 4232 * IPython/Prompts.py (CachedOutput._display): minor fixes to
4228 4233 improve printing when pprint is in use.
4229 4234
4230 4235 2002-04-13 Fernando Perez <fperez@colorado.edu>
4231 4236
4232 4237 * IPython/Shell.py (IPythonShellEmbed.__call__): SystemExit
4233 4238 exceptions aren't caught anymore. If the user triggers one, he
4234 4239 should know why he's doing it and it should go all the way up,
4235 4240 just like any other exception. So now @abort will fully kill the
4236 4241 embedded interpreter and the embedding code (unless that happens
4237 4242 to catch SystemExit).
4238 4243
4239 4244 * IPython/ultraTB.py (VerboseTB.__init__): added a call_pdb flag
4240 4245 and a debugger() method to invoke the interactive pdb debugger
4241 4246 after printing exception information. Also added the corresponding
4242 4247 -pdb option and @pdb magic to control this feature, and updated
4243 4248 the docs. After a suggestion from Christopher Hart
4244 4249 (hart-AT-caltech.edu).
4245 4250
4246 4251 2002-04-12 Fernando Perez <fperez@colorado.edu>
4247 4252
4248 4253 * IPython/Shell.py (IPythonShellEmbed.__init__): modified to use
4249 4254 the exception handlers defined by the user (not the CrashHandler)
4250 4255 so that user exceptions don't trigger an ipython bug report.
4251 4256
4252 4257 * IPython/ultraTB.py (ColorTB.__init__): made the color scheme
4253 4258 configurable (it should have always been so).
4254 4259
4255 4260 2002-03-26 Fernando Perez <fperez@colorado.edu>
4256 4261
4257 4262 * IPython/Shell.py (IPythonShellEmbed.__call__): many changes here
4258 4263 and there to fix embedding namespace issues. This should all be
4259 4264 done in a more elegant way.
4260 4265
4261 4266 2002-03-25 Fernando Perez <fperez@colorado.edu>
4262 4267
4263 4268 * IPython/genutils.py (get_home_dir): Try to make it work under
4264 4269 win9x also.
4265 4270
4266 4271 2002-03-20 Fernando Perez <fperez@colorado.edu>
4267 4272
4268 4273 * IPython/Shell.py (IPythonShellEmbed.__init__): leave
4269 4274 sys.displayhook untouched upon __init__.
4270 4275
4271 4276 2002-03-19 Fernando Perez <fperez@colorado.edu>
4272 4277
4273 4278 * Released 0.2.9 (for embedding bug, basically).
4274 4279
4275 4280 * IPython/Shell.py (IPythonShellEmbed.__call__): Trap SystemExit
4276 4281 exceptions so that enclosing shell's state can be restored.
4277 4282
4278 4283 * Changed magic_gnuplot.py to magic-gnuplot.py to standardize
4279 4284 naming conventions in the .ipython/ dir.
4280 4285
4281 4286 * IPython/iplib.py (InteractiveShell.init_readline): removed '-'
4282 4287 from delimiters list so filenames with - in them get expanded.
4283 4288
4284 4289 * IPython/Shell.py (IPythonShellEmbed.__call__): fixed bug with
4285 4290 sys.displayhook not being properly restored after an embedded call.
4286 4291
4287 4292 2002-03-18 Fernando Perez <fperez@colorado.edu>
4288 4293
4289 4294 * Released 0.2.8
4290 4295
4291 4296 * IPython/iplib.py (InteractiveShell.user_setup): fixed bug where
4292 4297 some files weren't being included in a -upgrade.
4293 4298 (InteractiveShell.init_readline): Added 'set show-all-if-ambiguous
4294 4299 on' so that the first tab completes.
4295 4300 (InteractiveShell.handle_magic): fixed bug with spaces around
4296 4301 quotes breaking many magic commands.
4297 4302
4298 4303 * setup.py: added note about ignoring the syntax error messages at
4299 4304 installation.
4300 4305
4301 4306 * IPython/UserConfig/magic_gnuplot.py (magic_gp): finished
4302 4307 streamlining the gnuplot interface, now there's only one magic @gp.
4303 4308
4304 4309 2002-03-17 Fernando Perez <fperez@colorado.edu>
4305 4310
4306 4311 * IPython/UserConfig/magic_gnuplot.py: new name for the
4307 4312 example-magic_pm.py file. Much enhanced system, now with a shell
4308 4313 for communicating directly with gnuplot, one command at a time.
4309 4314
4310 4315 * IPython/Magic.py (Magic.magic_run): added option -n to prevent
4311 4316 setting __name__=='__main__'.
4312 4317
4313 4318 * IPython/UserConfig/example-magic_pm.py (magic_pm): Added
4314 4319 mini-shell for accessing gnuplot from inside ipython. Should
4315 4320 extend it later for grace access too. Inspired by Arnd's
4316 4321 suggestion.
4317 4322
4318 4323 * IPython/iplib.py (InteractiveShell.handle_magic): fixed bug when
4319 4324 calling magic functions with () in their arguments. Thanks to Arnd
4320 4325 Baecker for pointing this to me.
4321 4326
4322 4327 * IPython/numutils.py (sum_flat): fixed bug. Would recurse
4323 4328 infinitely for integer or complex arrays (only worked with floats).
4324 4329
4325 4330 2002-03-16 Fernando Perez <fperez@colorado.edu>
4326 4331
4327 4332 * setup.py: Merged setup and setup_windows into a single script
4328 4333 which properly handles things for windows users.
4329 4334
4330 4335 2002-03-15 Fernando Perez <fperez@colorado.edu>
4331 4336
4332 4337 * Big change to the manual: now the magics are all automatically
4333 4338 documented. This information is generated from their docstrings
4334 4339 and put in a latex file included by the manual lyx file. This way
4335 4340 we get always up to date information for the magics. The manual
4336 4341 now also has proper version information, also auto-synced.
4337 4342
4338 4343 For this to work, an undocumented --magic_docstrings option was added.
4339 4344
4340 4345 2002-03-13 Fernando Perez <fperez@colorado.edu>
4341 4346
4342 4347 * IPython/ultraTB.py (TermColors): fixed problem with dark colors
4343 4348 under CDE terminals. An explicit ;2 color reset is needed in the escapes.
4344 4349
4345 4350 2002-03-12 Fernando Perez <fperez@colorado.edu>
4346 4351
4347 4352 * IPython/ultraTB.py (TermColors): changed color escapes again to
4348 4353 fix the (old, reintroduced) line-wrapping bug. Basically, if
4349 4354 \001..\002 aren't given in the color escapes, lines get wrapped
4350 4355 weirdly. But giving those screws up old xterms and emacs terms. So
4351 4356 I added some logic for emacs terms to be ok, but I can't identify old
4352 4357 xterms separately ($TERM=='xterm' for many terminals, like konsole).
4353 4358
4354 4359 2002-03-10 Fernando Perez <fperez@colorado.edu>
4355 4360
4356 4361 * IPython/usage.py (__doc__): Various documentation cleanups and
4357 4362 updates, both in usage docstrings and in the manual.
4358 4363
4359 4364 * IPython/Prompts.py (CachedOutput.set_colors): cleanups for
4360 4365 handling of caching. Set minimum acceptabe value for having a
4361 4366 cache at 20 values.
4362 4367
4363 4368 * IPython/iplib.py (InteractiveShell.user_setup): moved the
4364 4369 install_first_time function to a method, renamed it and added an
4365 4370 'upgrade' mode. Now people can update their config directory with
4366 4371 a simple command line switch (-upgrade, also new).
4367 4372
4368 4373 * IPython/Magic.py (Magic.magic_pfile): Made @pfile an alias to
4369 4374 @file (convenient for automagic users under Python >= 2.2).
4370 4375 Removed @files (it seemed more like a plural than an abbrev. of
4371 4376 'file show').
4372 4377
4373 4378 * IPython/iplib.py (install_first_time): Fixed crash if there were
4374 4379 backup files ('~') in .ipython/ install directory.
4375 4380
4376 4381 * IPython/ipmaker.py (make_IPython): fixes for new prompt
4377 4382 system. Things look fine, but these changes are fairly
4378 4383 intrusive. Test them for a few days.
4379 4384
4380 4385 * IPython/Prompts.py (CachedOutput.__init__): Massive rewrite of
4381 4386 the prompts system. Now all in/out prompt strings are user
4382 4387 controllable. This is particularly useful for embedding, as one
4383 4388 can tag embedded instances with particular prompts.
4384 4389
4385 4390 Also removed global use of sys.ps1/2, which now allows nested
4386 4391 embeddings without any problems. Added command-line options for
4387 4392 the prompt strings.
4388 4393
4389 4394 2002-03-08 Fernando Perez <fperez@colorado.edu>
4390 4395
4391 4396 * IPython/UserConfig/example-embed-short.py (ipshell): added
4392 4397 example file with the bare minimum code for embedding.
4393 4398
4394 4399 * IPython/Shell.py (IPythonShellEmbed.set_dummy_mode): added
4395 4400 functionality for the embeddable shell to be activated/deactivated
4396 4401 either globally or at each call.
4397 4402
4398 4403 * IPython/Prompts.py (Prompt1.auto_rewrite): Fixes the problem of
4399 4404 rewriting the prompt with '--->' for auto-inputs with proper
4400 4405 coloring. Now the previous UGLY hack in handle_auto() is gone, and
4401 4406 this is handled by the prompts class itself, as it should.
4402 4407
4403 4408 2002-03-05 Fernando Perez <fperez@colorado.edu>
4404 4409
4405 4410 * IPython/Magic.py (Magic.magic_logstart): Changed @log to
4406 4411 @logstart to avoid name clashes with the math log function.
4407 4412
4408 4413 * Big updates to X/Emacs section of the manual.
4409 4414
4410 4415 * Removed ipython_emacs. Milan explained to me how to pass
4411 4416 arguments to ipython through Emacs. Some day I'm going to end up
4412 4417 learning some lisp...
4413 4418
4414 4419 2002-03-04 Fernando Perez <fperez@colorado.edu>
4415 4420
4416 4421 * IPython/ipython_emacs: Created script to be used as the
4417 4422 py-python-command Emacs variable so we can pass IPython
4418 4423 parameters. I can't figure out how to tell Emacs directly to pass
4419 4424 parameters to IPython, so a dummy shell script will do it.
4420 4425
4421 4426 Other enhancements made for things to work better under Emacs'
4422 4427 various types of terminals. Many thanks to Milan Zamazal
4423 4428 <pdm-AT-zamazal.org> for all the suggestions and pointers.
4424 4429
4425 4430 2002-03-01 Fernando Perez <fperez@colorado.edu>
4426 4431
4427 4432 * IPython/ipmaker.py (make_IPython): added a --readline! option so
4428 4433 that loading of readline is now optional. This gives better
4429 4434 control to emacs users.
4430 4435
4431 4436 * IPython/ultraTB.py (__date__): Modified color escape sequences
4432 4437 and now things work fine under xterm and in Emacs' term buffers
4433 4438 (though not shell ones). Well, in emacs you get colors, but all
4434 4439 seem to be 'light' colors (no difference between dark and light
4435 4440 ones). But the garbage chars are gone, and also in xterms. It
4436 4441 seems that now I'm using 'cleaner' ansi sequences.
4437 4442
4438 4443 2002-02-21 Fernando Perez <fperez@colorado.edu>
4439 4444
4440 4445 * Released 0.2.7 (mainly to publish the scoping fix).
4441 4446
4442 4447 * IPython/Logger.py (Logger.logstate): added. A corresponding
4443 4448 @logstate magic was created.
4444 4449
4445 4450 * IPython/Magic.py: fixed nested scoping problem under Python
4446 4451 2.1.x (automagic wasn't working).
4447 4452
4448 4453 2002-02-20 Fernando Perez <fperez@colorado.edu>
4449 4454
4450 4455 * Released 0.2.6.
4451 4456
4452 4457 * IPython/OutputTrap.py (OutputTrap.__init__): added a 'quiet'
4453 4458 option so that logs can come out without any headers at all.
4454 4459
4455 4460 * IPython/UserConfig/ipythonrc-scipy.py: created a profile for
4456 4461 SciPy.
4457 4462
4458 4463 * IPython/iplib.py (InteractiveShell.embed_mainloop): Changed so
4459 4464 that embedded IPython calls don't require vars() to be explicitly
4460 4465 passed. Now they are extracted from the caller's frame (code
4461 4466 snatched from Eric Jones' weave). Added better documentation to
4462 4467 the section on embedding and the example file.
4463 4468
4464 4469 * IPython/genutils.py (page): Changed so that under emacs, it just
4465 4470 prints the string. You can then page up and down in the emacs
4466 4471 buffer itself. This is how the builtin help() works.
4467 4472
4468 4473 * IPython/Prompts.py (CachedOutput.__call__): Fixed issue with
4469 4474 macro scoping: macros need to be executed in the user's namespace
4470 4475 to work as if they had been typed by the user.
4471 4476
4472 4477 * IPython/Magic.py (Magic.magic_macro): Changed macros so they
4473 4478 execute automatically (no need to type 'exec...'). They then
4474 4479 behave like 'true macros'. The printing system was also modified
4475 4480 for this to work.
4476 4481
4477 4482 2002-02-19 Fernando Perez <fperez@colorado.edu>
4478 4483
4479 4484 * IPython/genutils.py (page_file): new function for paging files
4480 4485 in an OS-independent way. Also necessary for file viewing to work
4481 4486 well inside Emacs buffers.
4482 4487 (page): Added checks for being in an emacs buffer.
4483 4488 (page): fixed bug for Windows ($TERM isn't set in Windows). Fixed
4484 4489 same bug in iplib.
4485 4490
4486 4491 2002-02-18 Fernando Perez <fperez@colorado.edu>
4487 4492
4488 4493 * IPython/iplib.py (InteractiveShell.init_readline): modified use
4489 4494 of readline so that IPython can work inside an Emacs buffer.
4490 4495
4491 4496 * IPython/ultraTB.py (AutoFormattedTB.__call__): some fixes to
4492 4497 method signatures (they weren't really bugs, but it looks cleaner
4493 4498 and keeps PyChecker happy).
4494 4499
4495 4500 * IPython/ipmaker.py (make_IPython): added hooks Struct to __IP
4496 4501 for implementing various user-defined hooks. Currently only
4497 4502 display is done.
4498 4503
4499 4504 * IPython/Prompts.py (CachedOutput._display): changed display
4500 4505 functions so that they can be dynamically changed by users easily.
4501 4506
4502 4507 * IPython/Extensions/numeric_formats.py (num_display): added an
4503 4508 extension for printing NumPy arrays in flexible manners. It
4504 4509 doesn't do anything yet, but all the structure is in
4505 4510 place. Ultimately the plan is to implement output format control
4506 4511 like in Octave.
4507 4512
4508 4513 * IPython/Magic.py (Magic.lsmagic): changed so that bound magic
4509 4514 methods are found at run-time by all the automatic machinery.
4510 4515
4511 4516 2002-02-17 Fernando Perez <fperez@colorado.edu>
4512 4517
4513 4518 * setup_Windows.py (make_shortcut): documented. Cleaned up the
4514 4519 whole file a little.
4515 4520
4516 4521 * ToDo: closed this document. Now there's a new_design.lyx
4517 4522 document for all new ideas. Added making a pdf of it for the
4518 4523 end-user distro.
4519 4524
4520 4525 * IPython/Logger.py (Logger.switch_log): Created this to replace
4521 4526 logon() and logoff(). It also fixes a nasty crash reported by
4522 4527 Philip Hisley <compsys-AT-starpower.net>. Many thanks to him.
4523 4528
4524 4529 * IPython/iplib.py (complete): got auto-completion to work with
4525 4530 automagic (I had wanted this for a long time).
4526 4531
4527 4532 * IPython/Magic.py (Magic.magic_files): Added @files as an alias
4528 4533 to @file, since file() is now a builtin and clashes with automagic
4529 4534 for @file.
4530 4535
4531 4536 * Made some new files: Prompts, CrashHandler, Magic, Logger. All
4532 4537 of this was previously in iplib, which had grown to more than 2000
4533 4538 lines, way too long. No new functionality, but it makes managing
4534 4539 the code a bit easier.
4535 4540
4536 4541 * IPython/iplib.py (IPythonCrashHandler.__call__): Added version
4537 4542 information to crash reports.
4538 4543
4539 4544 2002-02-12 Fernando Perez <fperez@colorado.edu>
4540 4545
4541 4546 * Released 0.2.5.
4542 4547
4543 4548 2002-02-11 Fernando Perez <fperez@colorado.edu>
4544 4549
4545 4550 * Wrote a relatively complete Windows installer. It puts
4546 4551 everything in place, creates Start Menu entries and fixes the
4547 4552 color issues. Nothing fancy, but it works.
4548 4553
4549 4554 2002-02-10 Fernando Perez <fperez@colorado.edu>
4550 4555
4551 4556 * IPython/iplib.py (InteractiveShell.safe_execfile): added an
4552 4557 os.path.expanduser() call so that we can type @run ~/myfile.py and
4553 4558 have thigs work as expected.
4554 4559
4555 4560 * IPython/genutils.py (page): fixed exception handling so things
4556 4561 work both in Unix and Windows correctly. Quitting a pager triggers
4557 4562 an IOError/broken pipe in Unix, and in windows not finding a pager
4558 4563 is also an IOError, so I had to actually look at the return value
4559 4564 of the exception, not just the exception itself. Should be ok now.
4560 4565
4561 4566 * IPython/ultraTB.py (ColorSchemeTable.set_active_scheme):
4562 4567 modified to allow case-insensitive color scheme changes.
4563 4568
4564 4569 2002-02-09 Fernando Perez <fperez@colorado.edu>
4565 4570
4566 4571 * IPython/genutils.py (native_line_ends): new function to leave
4567 4572 user config files with os-native line-endings.
4568 4573
4569 4574 * README and manual updates.
4570 4575
4571 4576 * IPython/genutils.py: fixed unicode bug: use types.StringTypes
4572 4577 instead of StringType to catch Unicode strings.
4573 4578
4574 4579 * IPython/genutils.py (filefind): fixed bug for paths with
4575 4580 embedded spaces (very common in Windows).
4576 4581
4577 4582 * IPython/ipmaker.py (make_IPython): added a '.ini' to the rc
4578 4583 files under Windows, so that they get automatically associated
4579 4584 with a text editor. Windows makes it a pain to handle
4580 4585 extension-less files.
4581 4586
4582 4587 * IPython/iplib.py (InteractiveShell.init_readline): Made the
4583 4588 warning about readline only occur for Posix. In Windows there's no
4584 4589 way to get readline, so why bother with the warning.
4585 4590
4586 4591 * IPython/Struct.py (Struct.__str__): fixed to use self.__dict__
4587 4592 for __str__ instead of dir(self), since dir() changed in 2.2.
4588 4593
4589 4594 * Ported to Windows! Tested on XP, I suspect it should work fine
4590 4595 on NT/2000, but I don't think it will work on 98 et al. That
4591 4596 series of Windows is such a piece of junk anyway that I won't try
4592 4597 porting it there. The XP port was straightforward, showed a few
4593 4598 bugs here and there (fixed all), in particular some string
4594 4599 handling stuff which required considering Unicode strings (which
4595 4600 Windows uses). This is good, but hasn't been too tested :) No
4596 4601 fancy installer yet, I'll put a note in the manual so people at
4597 4602 least make manually a shortcut.
4598 4603
4599 4604 * IPython/iplib.py (Magic.magic_colors): Unified the color options
4600 4605 into a single one, "colors". This now controls both prompt and
4601 4606 exception color schemes, and can be changed both at startup
4602 4607 (either via command-line switches or via ipythonrc files) and at
4603 4608 runtime, with @colors.
4604 4609 (Magic.magic_run): renamed @prun to @run and removed the old
4605 4610 @run. The two were too similar to warrant keeping both.
4606 4611
4607 4612 2002-02-03 Fernando Perez <fperez@colorado.edu>
4608 4613
4609 4614 * IPython/iplib.py (install_first_time): Added comment on how to
4610 4615 configure the color options for first-time users. Put a <return>
4611 4616 request at the end so that small-terminal users get a chance to
4612 4617 read the startup info.
4613 4618
4614 4619 2002-01-23 Fernando Perez <fperez@colorado.edu>
4615 4620
4616 4621 * IPython/iplib.py (CachedOutput.update): Changed output memory
4617 4622 variable names from _o,_oo,_ooo,_o<n> to simply _,__,___,_<n>. For
4618 4623 input history we still use _i. Did this b/c these variable are
4619 4624 very commonly used in interactive work, so the less we need to
4620 4625 type the better off we are.
4621 4626 (Magic.magic_prun): updated @prun to better handle the namespaces
4622 4627 the file will run in, including a fix for __name__ not being set
4623 4628 before.
4624 4629
4625 4630 2002-01-20 Fernando Perez <fperez@colorado.edu>
4626 4631
4627 4632 * IPython/ultraTB.py (VerboseTB.linereader): Fixed printing of
4628 4633 extra garbage for Python 2.2. Need to look more carefully into
4629 4634 this later.
4630 4635
4631 4636 2002-01-19 Fernando Perez <fperez@colorado.edu>
4632 4637
4633 4638 * IPython/iplib.py (InteractiveShell.showtraceback): fixed to
4634 4639 display SyntaxError exceptions properly formatted when they occur
4635 4640 (they can be triggered by imported code).
4636 4641
4637 4642 2002-01-18 Fernando Perez <fperez@colorado.edu>
4638 4643
4639 4644 * IPython/iplib.py (InteractiveShell.safe_execfile): now
4640 4645 SyntaxError exceptions are reported nicely formatted, instead of
4641 4646 spitting out only offset information as before.
4642 4647 (Magic.magic_prun): Added the @prun function for executing
4643 4648 programs with command line args inside IPython.
4644 4649
4645 4650 2002-01-16 Fernando Perez <fperez@colorado.edu>
4646 4651
4647 4652 * IPython/iplib.py (Magic.magic_hist): Changed @hist and @dhist
4648 4653 to *not* include the last item given in a range. This brings their
4649 4654 behavior in line with Python's slicing:
4650 4655 a[n1:n2] -> a[n1]...a[n2-1]
4651 4656 It may be a bit less convenient, but I prefer to stick to Python's
4652 4657 conventions *everywhere*, so users never have to wonder.
4653 4658 (Magic.magic_macro): Added @macro function to ease the creation of
4654 4659 macros.
4655 4660
4656 4661 2002-01-05 Fernando Perez <fperez@colorado.edu>
4657 4662
4658 4663 * Released 0.2.4.
4659 4664
4660 4665 * IPython/iplib.py (Magic.magic_pdef):
4661 4666 (InteractiveShell.safe_execfile): report magic lines and error
4662 4667 lines without line numbers so one can easily copy/paste them for
4663 4668 re-execution.
4664 4669
4665 4670 * Updated manual with recent changes.
4666 4671
4667 4672 * IPython/iplib.py (Magic.magic_oinfo): added constructor
4668 4673 docstring printing when class? is called. Very handy for knowing
4669 4674 how to create class instances (as long as __init__ is well
4670 4675 documented, of course :)
4671 4676 (Magic.magic_doc): print both class and constructor docstrings.
4672 4677 (Magic.magic_pdef): give constructor info if passed a class and
4673 4678 __call__ info for callable object instances.
4674 4679
4675 4680 2002-01-04 Fernando Perez <fperez@colorado.edu>
4676 4681
4677 4682 * Made deep_reload() off by default. It doesn't always work
4678 4683 exactly as intended, so it's probably safer to have it off. It's
4679 4684 still available as dreload() anyway, so nothing is lost.
4680 4685
4681 4686 2002-01-02 Fernando Perez <fperez@colorado.edu>
4682 4687
4683 4688 * Released 0.2.3 (contacted R.Singh at CU about biopython course,
4684 4689 so I wanted an updated release).
4685 4690
4686 4691 2001-12-27 Fernando Perez <fperez@colorado.edu>
4687 4692
4688 4693 * IPython/iplib.py (InteractiveShell.interact): Added the original
4689 4694 code from 'code.py' for this module in order to change the
4690 4695 handling of a KeyboardInterrupt. This was necessary b/c otherwise
4691 4696 the history cache would break when the user hit Ctrl-C, and
4692 4697 interact() offers no way to add any hooks to it.
4693 4698
4694 4699 2001-12-23 Fernando Perez <fperez@colorado.edu>
4695 4700
4696 4701 * setup.py: added check for 'MANIFEST' before trying to remove
4697 4702 it. Thanks to Sean Reifschneider.
4698 4703
4699 4704 2001-12-22 Fernando Perez <fperez@colorado.edu>
4700 4705
4701 4706 * Released 0.2.2.
4702 4707
4703 4708 * Finished (reasonably) writing the manual. Later will add the
4704 4709 python-standard navigation stylesheets, but for the time being
4705 4710 it's fairly complete. Distribution will include html and pdf
4706 4711 versions.
4707 4712
4708 4713 * Bugfix: '.' wasn't being added to sys.path. Thanks to Prabhu
4709 4714 (MayaVi author).
4710 4715
4711 4716 2001-12-21 Fernando Perez <fperez@colorado.edu>
4712 4717
4713 4718 * Released 0.2.1. Barring any nasty bugs, this is it as far as a
4714 4719 good public release, I think (with the manual and the distutils
4715 4720 installer). The manual can use some work, but that can go
4716 4721 slowly. Otherwise I think it's quite nice for end users. Next
4717 4722 summer, rewrite the guts of it...
4718 4723
4719 4724 * Changed format of ipythonrc files to use whitespace as the
4720 4725 separator instead of an explicit '='. Cleaner.
4721 4726
4722 4727 2001-12-20 Fernando Perez <fperez@colorado.edu>
4723 4728
4724 4729 * Started a manual in LyX. For now it's just a quick merge of the
4725 4730 various internal docstrings and READMEs. Later it may grow into a
4726 4731 nice, full-blown manual.
4727 4732
4728 4733 * Set up a distutils based installer. Installation should now be
4729 4734 trivially simple for end-users.
4730 4735
4731 4736 2001-12-11 Fernando Perez <fperez@colorado.edu>
4732 4737
4733 4738 * Released 0.2.0. First public release, announced it at
4734 4739 comp.lang.python. From now on, just bugfixes...
4735 4740
4736 4741 * Went through all the files, set copyright/license notices and
4737 4742 cleaned up things. Ready for release.
4738 4743
4739 4744 2001-12-10 Fernando Perez <fperez@colorado.edu>
4740 4745
4741 4746 * Changed the first-time installer not to use tarfiles. It's more
4742 4747 robust now and less unix-dependent. Also makes it easier for
4743 4748 people to later upgrade versions.
4744 4749
4745 4750 * Changed @exit to @abort to reflect the fact that it's pretty
4746 4751 brutal (a sys.exit()). The difference between @abort and Ctrl-D
4747 4752 becomes significant only when IPyhton is embedded: in that case,
4748 4753 C-D closes IPython only, but @abort kills the enclosing program
4749 4754 too (unless it had called IPython inside a try catching
4750 4755 SystemExit).
4751 4756
4752 4757 * Created Shell module which exposes the actuall IPython Shell
4753 4758 classes, currently the normal and the embeddable one. This at
4754 4759 least offers a stable interface we won't need to change when
4755 4760 (later) the internals are rewritten. That rewrite will be confined
4756 4761 to iplib and ipmaker, but the Shell interface should remain as is.
4757 4762
4758 4763 * Added embed module which offers an embeddable IPShell object,
4759 4764 useful to fire up IPython *inside* a running program. Great for
4760 4765 debugging or dynamical data analysis.
4761 4766
4762 4767 2001-12-08 Fernando Perez <fperez@colorado.edu>
4763 4768
4764 4769 * Fixed small bug preventing seeing info from methods of defined
4765 4770 objects (incorrect namespace in _ofind()).
4766 4771
4767 4772 * Documentation cleanup. Moved the main usage docstrings to a
4768 4773 separate file, usage.py (cleaner to maintain, and hopefully in the
4769 4774 future some perlpod-like way of producing interactive, man and
4770 4775 html docs out of it will be found).
4771 4776
4772 4777 * Added @profile to see your profile at any time.
4773 4778
4774 4779 * Added @p as an alias for 'print'. It's especially convenient if
4775 4780 using automagic ('p x' prints x).
4776 4781
4777 4782 * Small cleanups and fixes after a pychecker run.
4778 4783
4779 4784 * Changed the @cd command to handle @cd - and @cd -<n> for
4780 4785 visiting any directory in _dh.
4781 4786
4782 4787 * Introduced _dh, a history of visited directories. @dhist prints
4783 4788 it out with numbers.
4784 4789
4785 4790 2001-12-07 Fernando Perez <fperez@colorado.edu>
4786 4791
4787 4792 * Released 0.1.22
4788 4793
4789 4794 * Made initialization a bit more robust against invalid color
4790 4795 options in user input (exit, not traceback-crash).
4791 4796
4792 4797 * Changed the bug crash reporter to write the report only in the
4793 4798 user's .ipython directory. That way IPython won't litter people's
4794 4799 hard disks with crash files all over the place. Also print on
4795 4800 screen the necessary mail command.
4796 4801
4797 4802 * With the new ultraTB, implemented LightBG color scheme for light
4798 4803 background terminals. A lot of people like white backgrounds, so I
4799 4804 guess we should at least give them something readable.
4800 4805
4801 4806 2001-12-06 Fernando Perez <fperez@colorado.edu>
4802 4807
4803 4808 * Modified the structure of ultraTB. Now there's a proper class
4804 4809 for tables of color schemes which allow adding schemes easily and
4805 4810 switching the active scheme without creating a new instance every
4806 4811 time (which was ridiculous). The syntax for creating new schemes
4807 4812 is also cleaner. I think ultraTB is finally done, with a clean
4808 4813 class structure. Names are also much cleaner (now there's proper
4809 4814 color tables, no need for every variable to also have 'color' in
4810 4815 its name).
4811 4816
4812 4817 * Broke down genutils into separate files. Now genutils only
4813 4818 contains utility functions, and classes have been moved to their
4814 4819 own files (they had enough independent functionality to warrant
4815 4820 it): ConfigLoader, OutputTrap, Struct.
4816 4821
4817 4822 2001-12-05 Fernando Perez <fperez@colorado.edu>
4818 4823
4819 4824 * IPython turns 21! Released version 0.1.21, as a candidate for
4820 4825 public consumption. If all goes well, release in a few days.
4821 4826
4822 4827 * Fixed path bug (files in Extensions/ directory wouldn't be found
4823 4828 unless IPython/ was explicitly in sys.path).
4824 4829
4825 4830 * Extended the FlexCompleter class as MagicCompleter to allow
4826 4831 completion of @-starting lines.
4827 4832
4828 4833 * Created __release__.py file as a central repository for release
4829 4834 info that other files can read from.
4830 4835
4831 4836 * Fixed small bug in logging: when logging was turned on in
4832 4837 mid-session, old lines with special meanings (!@?) were being
4833 4838 logged without the prepended comment, which is necessary since
4834 4839 they are not truly valid python syntax. This should make session
4835 4840 restores produce less errors.
4836 4841
4837 4842 * The namespace cleanup forced me to make a FlexCompleter class
4838 4843 which is nothing but a ripoff of rlcompleter, but with selectable
4839 4844 namespace (rlcompleter only works in __main__.__dict__). I'll try
4840 4845 to submit a note to the authors to see if this change can be
4841 4846 incorporated in future rlcompleter releases (Dec.6: done)
4842 4847
4843 4848 * More fixes to namespace handling. It was a mess! Now all
4844 4849 explicit references to __main__.__dict__ are gone (except when
4845 4850 really needed) and everything is handled through the namespace
4846 4851 dicts in the IPython instance. We seem to be getting somewhere
4847 4852 with this, finally...
4848 4853
4849 4854 * Small documentation updates.
4850 4855
4851 4856 * Created the Extensions directory under IPython (with an
4852 4857 __init__.py). Put the PhysicalQ stuff there. This directory should
4853 4858 be used for all special-purpose extensions.
4854 4859
4855 4860 * File renaming:
4856 4861 ipythonlib --> ipmaker
4857 4862 ipplib --> iplib
4858 4863 This makes a bit more sense in terms of what these files actually do.
4859 4864
4860 4865 * Moved all the classes and functions in ipythonlib to ipplib, so
4861 4866 now ipythonlib only has make_IPython(). This will ease up its
4862 4867 splitting in smaller functional chunks later.
4863 4868
4864 4869 * Cleaned up (done, I think) output of @whos. Better column
4865 4870 formatting, and now shows str(var) for as much as it can, which is
4866 4871 typically what one gets with a 'print var'.
4867 4872
4868 4873 2001-12-04 Fernando Perez <fperez@colorado.edu>
4869 4874
4870 4875 * Fixed namespace problems. Now builtin/IPyhton/user names get
4871 4876 properly reported in their namespace. Internal namespace handling
4872 4877 is finally getting decent (not perfect yet, but much better than
4873 4878 the ad-hoc mess we had).
4874 4879
4875 4880 * Removed -exit option. If people just want to run a python
4876 4881 script, that's what the normal interpreter is for. Less
4877 4882 unnecessary options, less chances for bugs.
4878 4883
4879 4884 * Added a crash handler which generates a complete post-mortem if
4880 4885 IPython crashes. This will help a lot in tracking bugs down the
4881 4886 road.
4882 4887
4883 4888 * Fixed nasty bug in auto-evaluation part of prefilter(). Names
4884 4889 which were boud to functions being reassigned would bypass the
4885 4890 logger, breaking the sync of _il with the prompt counter. This
4886 4891 would then crash IPython later when a new line was logged.
4887 4892
4888 4893 2001-12-02 Fernando Perez <fperez@colorado.edu>
4889 4894
4890 4895 * Made IPython a package. This means people don't have to clutter
4891 4896 their sys.path with yet another directory. Changed the INSTALL
4892 4897 file accordingly.
4893 4898
4894 4899 * Cleaned up the output of @who_ls, @who and @whos. @who_ls now
4895 4900 sorts its output (so @who shows it sorted) and @whos formats the
4896 4901 table according to the width of the first column. Nicer, easier to
4897 4902 read. Todo: write a generic table_format() which takes a list of
4898 4903 lists and prints it nicely formatted, with optional row/column
4899 4904 separators and proper padding and justification.
4900 4905
4901 4906 * Released 0.1.20
4902 4907
4903 4908 * Fixed bug in @log which would reverse the inputcache list (a
4904 4909 copy operation was missing).
4905 4910
4906 4911 * Code cleanup. @config was changed to use page(). Better, since
4907 4912 its output is always quite long.
4908 4913
4909 4914 * Itpl is back as a dependency. I was having too many problems
4910 4915 getting the parametric aliases to work reliably, and it's just
4911 4916 easier to code weird string operations with it than playing %()s
4912 4917 games. It's only ~6k, so I don't think it's too big a deal.
4913 4918
4914 4919 * Found (and fixed) a very nasty bug with history. !lines weren't
4915 4920 getting cached, and the out of sync caches would crash
4916 4921 IPython. Fixed it by reorganizing the prefilter/handlers/logger
4917 4922 division of labor a bit better. Bug fixed, cleaner structure.
4918 4923
4919 4924 2001-12-01 Fernando Perez <fperez@colorado.edu>
4920 4925
4921 4926 * Released 0.1.19
4922 4927
4923 4928 * Added option -n to @hist to prevent line number printing. Much
4924 4929 easier to copy/paste code this way.
4925 4930
4926 4931 * Created global _il to hold the input list. Allows easy
4927 4932 re-execution of blocks of code by slicing it (inspired by Janko's
4928 4933 comment on 'macros').
4929 4934
4930 4935 * Small fixes and doc updates.
4931 4936
4932 4937 * Rewrote @history function (was @h). Renamed it to @hist, @h is
4933 4938 much too fragile with automagic. Handles properly multi-line
4934 4939 statements and takes parameters.
4935 4940
4936 4941 2001-11-30 Fernando Perez <fperez@colorado.edu>
4937 4942
4938 4943 * Version 0.1.18 released.
4939 4944
4940 4945 * Fixed nasty namespace bug in initial module imports.
4941 4946
4942 4947 * Added copyright/license notes to all code files (except
4943 4948 DPyGetOpt). For the time being, LGPL. That could change.
4944 4949
4945 4950 * Rewrote a much nicer README, updated INSTALL, cleaned up
4946 4951 ipythonrc-* samples.
4947 4952
4948 4953 * Overall code/documentation cleanup. Basically ready for
4949 4954 release. Only remaining thing: licence decision (LGPL?).
4950 4955
4951 4956 * Converted load_config to a class, ConfigLoader. Now recursion
4952 4957 control is better organized. Doesn't include the same file twice.
4953 4958
4954 4959 2001-11-29 Fernando Perez <fperez@colorado.edu>
4955 4960
4956 4961 * Got input history working. Changed output history variables from
4957 4962 _p to _o so that _i is for input and _o for output. Just cleaner
4958 4963 convention.
4959 4964
4960 4965 * Implemented parametric aliases. This pretty much allows the
4961 4966 alias system to offer full-blown shell convenience, I think.
4962 4967
4963 4968 * Version 0.1.17 released, 0.1.18 opened.
4964 4969
4965 4970 * dot_ipython/ipythonrc (alias): added documentation.
4966 4971 (xcolor): Fixed small bug (xcolors -> xcolor)
4967 4972
4968 4973 * Changed the alias system. Now alias is a magic command to define
4969 4974 aliases just like the shell. Rationale: the builtin magics should
4970 4975 be there for things deeply connected to IPython's
4971 4976 architecture. And this is a much lighter system for what I think
4972 4977 is the really important feature: allowing users to define quickly
4973 4978 magics that will do shell things for them, so they can customize
4974 4979 IPython easily to match their work habits. If someone is really
4975 4980 desperate to have another name for a builtin alias, they can
4976 4981 always use __IP.magic_newname = __IP.magic_oldname. Hackish but
4977 4982 works.
4978 4983
4979 4984 2001-11-28 Fernando Perez <fperez@colorado.edu>
4980 4985
4981 4986 * Changed @file so that it opens the source file at the proper
4982 4987 line. Since it uses less, if your EDITOR environment is
4983 4988 configured, typing v will immediately open your editor of choice
4984 4989 right at the line where the object is defined. Not as quick as
4985 4990 having a direct @edit command, but for all intents and purposes it
4986 4991 works. And I don't have to worry about writing @edit to deal with
4987 4992 all the editors, less does that.
4988 4993
4989 4994 * Version 0.1.16 released, 0.1.17 opened.
4990 4995
4991 4996 * Fixed some nasty bugs in the page/page_dumb combo that could
4992 4997 crash IPython.
4993 4998
4994 4999 2001-11-27 Fernando Perez <fperez@colorado.edu>
4995 5000
4996 5001 * Version 0.1.15 released, 0.1.16 opened.
4997 5002
4998 5003 * Finally got ? and ?? to work for undefined things: now it's
4999 5004 possible to type {}.get? and get information about the get method
5000 5005 of dicts, or os.path? even if only os is defined (so technically
5001 5006 os.path isn't). Works at any level. For example, after import os,
5002 5007 os?, os.path?, os.path.abspath? all work. This is great, took some
5003 5008 work in _ofind.
5004 5009
5005 5010 * Fixed more bugs with logging. The sanest way to do it was to add
5006 5011 to @log a 'mode' parameter. Killed two in one shot (this mode
5007 5012 option was a request of Janko's). I think it's finally clean
5008 5013 (famous last words).
5009 5014
5010 5015 * Added a page_dumb() pager which does a decent job of paging on
5011 5016 screen, if better things (like less) aren't available. One less
5012 5017 unix dependency (someday maybe somebody will port this to
5013 5018 windows).
5014 5019
5015 5020 * Fixed problem in magic_log: would lock of logging out if log
5016 5021 creation failed (because it would still think it had succeeded).
5017 5022
5018 5023 * Improved the page() function using curses to auto-detect screen
5019 5024 size. Now it can make a much better decision on whether to print
5020 5025 or page a string. Option screen_length was modified: a value 0
5021 5026 means auto-detect, and that's the default now.
5022 5027
5023 5028 * Version 0.1.14 released, 0.1.15 opened. I think this is ready to
5024 5029 go out. I'll test it for a few days, then talk to Janko about
5025 5030 licences and announce it.
5026 5031
5027 5032 * Fixed the length of the auto-generated ---> prompt which appears
5028 5033 for auto-parens and auto-quotes. Getting this right isn't trivial,
5029 5034 with all the color escapes, different prompt types and optional
5030 5035 separators. But it seems to be working in all the combinations.
5031 5036
5032 5037 2001-11-26 Fernando Perez <fperez@colorado.edu>
5033 5038
5034 5039 * Wrote a regexp filter to get option types from the option names
5035 5040 string. This eliminates the need to manually keep two duplicate
5036 5041 lists.
5037 5042
5038 5043 * Removed the unneeded check_option_names. Now options are handled
5039 5044 in a much saner manner and it's easy to visually check that things
5040 5045 are ok.
5041 5046
5042 5047 * Updated version numbers on all files I modified to carry a
5043 5048 notice so Janko and Nathan have clear version markers.
5044 5049
5045 5050 * Updated docstring for ultraTB with my changes. I should send
5046 5051 this to Nathan.
5047 5052
5048 5053 * Lots of small fixes. Ran everything through pychecker again.
5049 5054
5050 5055 * Made loading of deep_reload an cmd line option. If it's not too
5051 5056 kosher, now people can just disable it. With -nodeep_reload it's
5052 5057 still available as dreload(), it just won't overwrite reload().
5053 5058
5054 5059 * Moved many options to the no| form (-opt and -noopt
5055 5060 accepted). Cleaner.
5056 5061
5057 5062 * Changed magic_log so that if called with no parameters, it uses
5058 5063 'rotate' mode. That way auto-generated logs aren't automatically
5059 5064 over-written. For normal logs, now a backup is made if it exists
5060 5065 (only 1 level of backups). A new 'backup' mode was added to the
5061 5066 Logger class to support this. This was a request by Janko.
5062 5067
5063 5068 * Added @logoff/@logon to stop/restart an active log.
5064 5069
5065 5070 * Fixed a lot of bugs in log saving/replay. It was pretty
5066 5071 broken. Now special lines (!@,/) appear properly in the command
5067 5072 history after a log replay.
5068 5073
5069 5074 * Tried and failed to implement full session saving via pickle. My
5070 5075 idea was to pickle __main__.__dict__, but modules can't be
5071 5076 pickled. This would be a better alternative to replaying logs, but
5072 5077 seems quite tricky to get to work. Changed -session to be called
5073 5078 -logplay, which more accurately reflects what it does. And if we
5074 5079 ever get real session saving working, -session is now available.
5075 5080
5076 5081 * Implemented color schemes for prompts also. As for tracebacks,
5077 5082 currently only NoColor and Linux are supported. But now the
5078 5083 infrastructure is in place, based on a generic ColorScheme
5079 5084 class. So writing and activating new schemes both for the prompts
5080 5085 and the tracebacks should be straightforward.
5081 5086
5082 5087 * Version 0.1.13 released, 0.1.14 opened.
5083 5088
5084 5089 * Changed handling of options for output cache. Now counter is
5085 5090 hardwired starting at 1 and one specifies the maximum number of
5086 5091 entries *in the outcache* (not the max prompt counter). This is
5087 5092 much better, since many statements won't increase the cache
5088 5093 count. It also eliminated some confusing options, now there's only
5089 5094 one: cache_size.
5090 5095
5091 5096 * Added 'alias' magic function and magic_alias option in the
5092 5097 ipythonrc file. Now the user can easily define whatever names he
5093 5098 wants for the magic functions without having to play weird
5094 5099 namespace games. This gives IPython a real shell-like feel.
5095 5100
5096 5101 * Fixed doc/?/?? for magics. Now all work, in all forms (explicit
5097 5102 @ or not).
5098 5103
5099 5104 This was one of the last remaining 'visible' bugs (that I know
5100 5105 of). I think if I can clean up the session loading so it works
5101 5106 100% I'll release a 0.2.0 version on c.p.l (talk to Janko first
5102 5107 about licensing).
5103 5108
5104 5109 2001-11-25 Fernando Perez <fperez@colorado.edu>
5105 5110
5106 5111 * Rewrote somewhat oinfo (?/??). Nicer, now uses page() and
5107 5112 there's a cleaner distinction between what ? and ?? show.
5108 5113
5109 5114 * Added screen_length option. Now the user can define his own
5110 5115 screen size for page() operations.
5111 5116
5112 5117 * Implemented magic shell-like functions with automatic code
5113 5118 generation. Now adding another function is just a matter of adding
5114 5119 an entry to a dict, and the function is dynamically generated at
5115 5120 run-time. Python has some really cool features!
5116 5121
5117 5122 * Renamed many options to cleanup conventions a little. Now all
5118 5123 are lowercase, and only underscores where needed. Also in the code
5119 5124 option name tables are clearer.
5120 5125
5121 5126 * Changed prompts a little. Now input is 'In [n]:' instead of
5122 5127 'In[n]:='. This allows it the numbers to be aligned with the
5123 5128 Out[n] numbers, and removes usage of ':=' which doesn't exist in
5124 5129 Python (it was a Mathematica thing). The '...' continuation prompt
5125 5130 was also changed a little to align better.
5126 5131
5127 5132 * Fixed bug when flushing output cache. Not all _p<n> variables
5128 5133 exist, so their deletion needs to be wrapped in a try:
5129 5134
5130 5135 * Figured out how to properly use inspect.formatargspec() (it
5131 5136 requires the args preceded by *). So I removed all the code from
5132 5137 _get_pdef in Magic, which was just replicating that.
5133 5138
5134 5139 * Added test to prefilter to allow redefining magic function names
5135 5140 as variables. This is ok, since the @ form is always available,
5136 5141 but whe should allow the user to define a variable called 'ls' if
5137 5142 he needs it.
5138 5143
5139 5144 * Moved the ToDo information from README into a separate ToDo.
5140 5145
5141 5146 * General code cleanup and small bugfixes. I think it's close to a
5142 5147 state where it can be released, obviously with a big 'beta'
5143 5148 warning on it.
5144 5149
5145 5150 * Got the magic function split to work. Now all magics are defined
5146 5151 in a separate class. It just organizes things a bit, and now
5147 5152 Xemacs behaves nicer (it was choking on InteractiveShell b/c it
5148 5153 was too long).
5149 5154
5150 5155 * Changed @clear to @reset to avoid potential confusions with
5151 5156 the shell command clear. Also renamed @cl to @clear, which does
5152 5157 exactly what people expect it to from their shell experience.
5153 5158
5154 5159 Added a check to the @reset command (since it's so
5155 5160 destructive, it's probably a good idea to ask for confirmation).
5156 5161 But now reset only works for full namespace resetting. Since the
5157 5162 del keyword is already there for deleting a few specific
5158 5163 variables, I don't see the point of having a redundant magic
5159 5164 function for the same task.
5160 5165
5161 5166 2001-11-24 Fernando Perez <fperez@colorado.edu>
5162 5167
5163 5168 * Updated the builtin docs (esp. the ? ones).
5164 5169
5165 5170 * Ran all the code through pychecker. Not terribly impressed with
5166 5171 it: lots of spurious warnings and didn't really find anything of
5167 5172 substance (just a few modules being imported and not used).
5168 5173
5169 5174 * Implemented the new ultraTB functionality into IPython. New
5170 5175 option: xcolors. This chooses color scheme. xmode now only selects
5171 5176 between Plain and Verbose. Better orthogonality.
5172 5177
5173 5178 * Large rewrite of ultraTB. Much cleaner now, with a separation of
5174 5179 mode and color scheme for the exception handlers. Now it's
5175 5180 possible to have the verbose traceback with no coloring.
5176 5181
5177 5182 2001-11-23 Fernando Perez <fperez@colorado.edu>
5178 5183
5179 5184 * Version 0.1.12 released, 0.1.13 opened.
5180 5185
5181 5186 * Removed option to set auto-quote and auto-paren escapes by
5182 5187 user. The chances of breaking valid syntax are just too high. If
5183 5188 someone *really* wants, they can always dig into the code.
5184 5189
5185 5190 * Made prompt separators configurable.
5186 5191
5187 5192 2001-11-22 Fernando Perez <fperez@colorado.edu>
5188 5193
5189 5194 * Small bugfixes in many places.
5190 5195
5191 5196 * Removed the MyCompleter class from ipplib. It seemed redundant
5192 5197 with the C-p,C-n history search functionality. Less code to
5193 5198 maintain.
5194 5199
5195 5200 * Moved all the original ipython.py code into ipythonlib.py. Right
5196 5201 now it's just one big dump into a function called make_IPython, so
5197 5202 no real modularity has been gained. But at least it makes the
5198 5203 wrapper script tiny, and since ipythonlib is a module, it gets
5199 5204 compiled and startup is much faster.
5200 5205
5201 5206 This is a reasobably 'deep' change, so we should test it for a
5202 5207 while without messing too much more with the code.
5203 5208
5204 5209 2001-11-21 Fernando Perez <fperez@colorado.edu>
5205 5210
5206 5211 * Version 0.1.11 released, 0.1.12 opened for further work.
5207 5212
5208 5213 * Removed dependency on Itpl. It was only needed in one place. It
5209 5214 would be nice if this became part of python, though. It makes life
5210 5215 *a lot* easier in some cases.
5211 5216
5212 5217 * Simplified the prefilter code a bit. Now all handlers are
5213 5218 expected to explicitly return a value (at least a blank string).
5214 5219
5215 5220 * Heavy edits in ipplib. Removed the help system altogether. Now
5216 5221 obj?/?? is used for inspecting objects, a magic @doc prints
5217 5222 docstrings, and full-blown Python help is accessed via the 'help'
5218 5223 keyword. This cleans up a lot of code (less to maintain) and does
5219 5224 the job. Since 'help' is now a standard Python component, might as
5220 5225 well use it and remove duplicate functionality.
5221 5226
5222 5227 Also removed the option to use ipplib as a standalone program. By
5223 5228 now it's too dependent on other parts of IPython to function alone.
5224 5229
5225 5230 * Fixed bug in genutils.pager. It would crash if the pager was
5226 5231 exited immediately after opening (broken pipe).
5227 5232
5228 5233 * Trimmed down the VerboseTB reporting a little. The header is
5229 5234 much shorter now and the repeated exception arguments at the end
5230 5235 have been removed. For interactive use the old header seemed a bit
5231 5236 excessive.
5232 5237
5233 5238 * Fixed small bug in output of @whos for variables with multi-word
5234 5239 types (only first word was displayed).
5235 5240
5236 5241 2001-11-17 Fernando Perez <fperez@colorado.edu>
5237 5242
5238 5243 * Version 0.1.10 released, 0.1.11 opened for further work.
5239 5244
5240 5245 * Modified dirs and friends. dirs now *returns* the stack (not
5241 5246 prints), so one can manipulate it as a variable. Convenient to
5242 5247 travel along many directories.
5243 5248
5244 5249 * Fixed bug in magic_pdef: would only work with functions with
5245 5250 arguments with default values.
5246 5251
5247 5252 2001-11-14 Fernando Perez <fperez@colorado.edu>
5248 5253
5249 5254 * Added the PhysicsInput stuff to dot_ipython so it ships as an
5250 5255 example with IPython. Various other minor fixes and cleanups.
5251 5256
5252 5257 * Version 0.1.9 released, 0.1.10 opened for further work.
5253 5258
5254 5259 * Added sys.path to the list of directories searched in the
5255 5260 execfile= option. It used to be the current directory and the
5256 5261 user's IPYTHONDIR only.
5257 5262
5258 5263 2001-11-13 Fernando Perez <fperez@colorado.edu>
5259 5264
5260 5265 * Reinstated the raw_input/prefilter separation that Janko had
5261 5266 initially. This gives a more convenient setup for extending the
5262 5267 pre-processor from the outside: raw_input always gets a string,
5263 5268 and prefilter has to process it. We can then redefine prefilter
5264 5269 from the outside and implement extensions for special
5265 5270 purposes.
5266 5271
5267 5272 Today I got one for inputting PhysicalQuantity objects
5268 5273 (from Scientific) without needing any function calls at
5269 5274 all. Extremely convenient, and it's all done as a user-level
5270 5275 extension (no IPython code was touched). Now instead of:
5271 5276 a = PhysicalQuantity(4.2,'m/s**2')
5272 5277 one can simply say
5273 5278 a = 4.2 m/s**2
5274 5279 or even
5275 5280 a = 4.2 m/s^2
5276 5281
5277 5282 I use this, but it's also a proof of concept: IPython really is
5278 5283 fully user-extensible, even at the level of the parsing of the
5279 5284 command line. It's not trivial, but it's perfectly doable.
5280 5285
5281 5286 * Added 'add_flip' method to inclusion conflict resolver. Fixes
5282 5287 the problem of modules being loaded in the inverse order in which
5283 5288 they were defined in
5284 5289
5285 5290 * Version 0.1.8 released, 0.1.9 opened for further work.
5286 5291
5287 5292 * Added magics pdef, source and file. They respectively show the
5288 5293 definition line ('prototype' in C), source code and full python
5289 5294 file for any callable object. The object inspector oinfo uses
5290 5295 these to show the same information.
5291 5296
5292 5297 * Version 0.1.7 released, 0.1.8 opened for further work.
5293 5298
5294 5299 * Separated all the magic functions into a class called Magic. The
5295 5300 InteractiveShell class was becoming too big for Xemacs to handle
5296 5301 (de-indenting a line would lock it up for 10 seconds while it
5297 5302 backtracked on the whole class!)
5298 5303
5299 5304 FIXME: didn't work. It can be done, but right now namespaces are
5300 5305 all messed up. Do it later (reverted it for now, so at least
5301 5306 everything works as before).
5302 5307
5303 5308 * Got the object introspection system (magic_oinfo) working! I
5304 5309 think this is pretty much ready for release to Janko, so he can
5305 5310 test it for a while and then announce it. Pretty much 100% of what
5306 5311 I wanted for the 'phase 1' release is ready. Happy, tired.
5307 5312
5308 5313 2001-11-12 Fernando Perez <fperez@colorado.edu>
5309 5314
5310 5315 * Version 0.1.6 released, 0.1.7 opened for further work.
5311 5316
5312 5317 * Fixed bug in printing: it used to test for truth before
5313 5318 printing, so 0 wouldn't print. Now checks for None.
5314 5319
5315 5320 * Fixed bug where auto-execs increase the prompt counter by 2 (b/c
5316 5321 they have to call len(str(sys.ps1)) ). But the fix is ugly, it
5317 5322 reaches by hand into the outputcache. Think of a better way to do
5318 5323 this later.
5319 5324
5320 5325 * Various small fixes thanks to Nathan's comments.
5321 5326
5322 5327 * Changed magic_pprint to magic_Pprint. This way it doesn't
5323 5328 collide with pprint() and the name is consistent with the command
5324 5329 line option.
5325 5330
5326 5331 * Changed prompt counter behavior to be fully like
5327 5332 Mathematica's. That is, even input that doesn't return a result
5328 5333 raises the prompt counter. The old behavior was kind of confusing
5329 5334 (getting the same prompt number several times if the operation
5330 5335 didn't return a result).
5331 5336
5332 5337 * Fixed Nathan's last name in a couple of places (Gray, not Graham).
5333 5338
5334 5339 * Fixed -Classic mode (wasn't working anymore).
5335 5340
5336 5341 * Added colored prompts using Nathan's new code. Colors are
5337 5342 currently hardwired, they can be user-configurable. For
5338 5343 developers, they can be chosen in file ipythonlib.py, at the
5339 5344 beginning of the CachedOutput class def.
5340 5345
5341 5346 2001-11-11 Fernando Perez <fperez@colorado.edu>
5342 5347
5343 5348 * Version 0.1.5 released, 0.1.6 opened for further work.
5344 5349
5345 5350 * Changed magic_env to *return* the environment as a dict (not to
5346 5351 print it). This way it prints, but it can also be processed.
5347 5352
5348 5353 * Added Verbose exception reporting to interactive
5349 5354 exceptions. Very nice, now even 1/0 at the prompt gives a verbose
5350 5355 traceback. Had to make some changes to the ultraTB file. This is
5351 5356 probably the last 'big' thing in my mental todo list. This ties
5352 5357 in with the next entry:
5353 5358
5354 5359 * Changed -Xi and -Xf to a single -xmode option. Now all the user
5355 5360 has to specify is Plain, Color or Verbose for all exception
5356 5361 handling.
5357 5362
5358 5363 * Removed ShellServices option. All this can really be done via
5359 5364 the magic system. It's easier to extend, cleaner and has automatic
5360 5365 namespace protection and documentation.
5361 5366
5362 5367 2001-11-09 Fernando Perez <fperez@colorado.edu>
5363 5368
5364 5369 * Fixed bug in output cache flushing (missing parameter to
5365 5370 __init__). Other small bugs fixed (found using pychecker).
5366 5371
5367 5372 * Version 0.1.4 opened for bugfixing.
5368 5373
5369 5374 2001-11-07 Fernando Perez <fperez@colorado.edu>
5370 5375
5371 5376 * Version 0.1.3 released, mainly because of the raw_input bug.
5372 5377
5373 5378 * Fixed NASTY bug in raw_input: input line wasn't properly parsed
5374 5379 and when testing for whether things were callable, a call could
5375 5380 actually be made to certain functions. They would get called again
5376 5381 once 'really' executed, with a resulting double call. A disaster
5377 5382 in many cases (list.reverse() would never work!).
5378 5383
5379 5384 * Removed prefilter() function, moved its code to raw_input (which
5380 5385 after all was just a near-empty caller for prefilter). This saves
5381 5386 a function call on every prompt, and simplifies the class a tiny bit.
5382 5387
5383 5388 * Fix _ip to __ip name in magic example file.
5384 5389
5385 5390 * Changed 'tar -x -f' to 'tar xvf' in auto-installer. This should
5386 5391 work with non-gnu versions of tar.
5387 5392
5388 5393 2001-11-06 Fernando Perez <fperez@colorado.edu>
5389 5394
5390 5395 * Version 0.1.2. Just to keep track of the recent changes.
5391 5396
5392 5397 * Fixed nasty bug in output prompt routine. It used to check 'if
5393 5398 arg != None...'. Problem is, this fails if arg implements a
5394 5399 special comparison (__cmp__) which disallows comparing to
5395 5400 None. Found it when trying to use the PhysicalQuantity module from
5396 5401 ScientificPython.
5397 5402
5398 5403 2001-11-05 Fernando Perez <fperez@colorado.edu>
5399 5404
5400 5405 * Also added dirs. Now the pushd/popd/dirs family functions
5401 5406 basically like the shell, with the added convenience of going home
5402 5407 when called with no args.
5403 5408
5404 5409 * pushd/popd slightly modified to mimic shell behavior more
5405 5410 closely.
5406 5411
5407 5412 * Added env,pushd,popd from ShellServices as magic functions. I
5408 5413 think the cleanest will be to port all desired functions from
5409 5414 ShellServices as magics and remove ShellServices altogether. This
5410 5415 will provide a single, clean way of adding functionality
5411 5416 (shell-type or otherwise) to IP.
5412 5417
5413 5418 2001-11-04 Fernando Perez <fperez@colorado.edu>
5414 5419
5415 5420 * Added .ipython/ directory to sys.path. This way users can keep
5416 5421 customizations there and access them via import.
5417 5422
5418 5423 2001-11-03 Fernando Perez <fperez@colorado.edu>
5419 5424
5420 5425 * Opened version 0.1.1 for new changes.
5421 5426
5422 5427 * Changed version number to 0.1.0: first 'public' release, sent to
5423 5428 Nathan and Janko.
5424 5429
5425 5430 * Lots of small fixes and tweaks.
5426 5431
5427 5432 * Minor changes to whos format. Now strings are shown, snipped if
5428 5433 too long.
5429 5434
5430 5435 * Changed ShellServices to work on __main__ so they show up in @who
5431 5436
5432 5437 * Help also works with ? at the end of a line:
5433 5438 ?sin and sin?
5434 5439 both produce the same effect. This is nice, as often I use the
5435 5440 tab-complete to find the name of a method, but I used to then have
5436 5441 to go to the beginning of the line to put a ? if I wanted more
5437 5442 info. Now I can just add the ? and hit return. Convenient.
5438 5443
5439 5444 2001-11-02 Fernando Perez <fperez@colorado.edu>
5440 5445
5441 5446 * Python version check (>=2.1) added.
5442 5447
5443 5448 * Added LazyPython documentation. At this point the docs are quite
5444 5449 a mess. A cleanup is in order.
5445 5450
5446 5451 * Auto-installer created. For some bizarre reason, the zipfiles
5447 5452 module isn't working on my system. So I made a tar version
5448 5453 (hopefully the command line options in various systems won't kill
5449 5454 me).
5450 5455
5451 5456 * Fixes to Struct in genutils. Now all dictionary-like methods are
5452 5457 protected (reasonably).
5453 5458
5454 5459 * Added pager function to genutils and changed ? to print usage
5455 5460 note through it (it was too long).
5456 5461
5457 5462 * Added the LazyPython functionality. Works great! I changed the
5458 5463 auto-quote escape to ';', it's on home row and next to '. But
5459 5464 both auto-quote and auto-paren (still /) escapes are command-line
5460 5465 parameters.
5461 5466
5462 5467
5463 5468 2001-11-01 Fernando Perez <fperez@colorado.edu>
5464 5469
5465 5470 * Version changed to 0.0.7. Fairly large change: configuration now
5466 5471 is all stored in a directory, by default .ipython. There, all
5467 5472 config files have normal looking names (not .names)
5468 5473
5469 5474 * Version 0.0.6 Released first to Lucas and Archie as a test
5470 5475 run. Since it's the first 'semi-public' release, change version to
5471 5476 > 0.0.6 for any changes now.
5472 5477
5473 5478 * Stuff I had put in the ipplib.py changelog:
5474 5479
5475 5480 Changes to InteractiveShell:
5476 5481
5477 5482 - Made the usage message a parameter.
5478 5483
5479 5484 - Require the name of the shell variable to be given. It's a bit
5480 5485 of a hack, but allows the name 'shell' not to be hardwire in the
5481 5486 magic (@) handler, which is problematic b/c it requires
5482 5487 polluting the global namespace with 'shell'. This in turn is
5483 5488 fragile: if a user redefines a variable called shell, things
5484 5489 break.
5485 5490
5486 5491 - magic @: all functions available through @ need to be defined
5487 5492 as magic_<name>, even though they can be called simply as
5488 5493 @<name>. This allows the special command @magic to gather
5489 5494 information automatically about all existing magic functions,
5490 5495 even if they are run-time user extensions, by parsing the shell
5491 5496 instance __dict__ looking for special magic_ names.
5492 5497
5493 5498 - mainloop: added *two* local namespace parameters. This allows
5494 5499 the class to differentiate between parameters which were there
5495 5500 before and after command line initialization was processed. This
5496 5501 way, later @who can show things loaded at startup by the
5497 5502 user. This trick was necessary to make session saving/reloading
5498 5503 really work: ideally after saving/exiting/reloading a session,
5499 5504 *everythin* should look the same, including the output of @who. I
5500 5505 was only able to make this work with this double namespace
5501 5506 trick.
5502 5507
5503 5508 - added a header to the logfile which allows (almost) full
5504 5509 session restoring.
5505 5510
5506 5511 - prepend lines beginning with @ or !, with a and log
5507 5512 them. Why? !lines: may be useful to know what you did @lines:
5508 5513 they may affect session state. So when restoring a session, at
5509 5514 least inform the user of their presence. I couldn't quite get
5510 5515 them to properly re-execute, but at least the user is warned.
5511 5516
5512 5517 * Started ChangeLog.
General Comments 0
You need to be logged in to leave comments. Login now