WhatsNew082¶

New features in 0.8.2¶

This does not list bugfixes, enhanced internals or api additions.

• “Shadow history” remembers everything you’ve entered, forever. Remember that arcane command line you entered three weeks ago? Just grep the shadow history with “%hist -g”! See cookbook for details.

• %rep is a new magic function that allows you to fetch command lines from history for editing. Do “%rep?” for details.

• System command aliases (created by %rehashx) are lower case in win32.

• Macros can now take arguments. See cookbook.

• %macro without arguments lists available macros.

• Directory history (the easiest way to see it is by doing ‘cd -<TAB>’) is now persistent across sessions.

• ipython -i -c <cmd>: -i (interact) prevents IPython session from exiting after executing <cmd>. <cmd> can now contain IPython syntax (!foo, %magic etc).

• new profiles: doctest, zope. scipy is now in ipy_profile_scipy.py instead of ipythonrc-scipy.

• new extensions:

  • ipy_traits_completer.py: complete Traits attributes

  • ipy_legacy.py: enable deprecated features

  • mglob.py: enhanced globbing - %mglob !.svn/ rec:*.py

  • ipy_exportdb.py: create a portable .py file from your %store’d macros, aliases, strings and bookmarks for distribution. See cookbook .

  • ipy_render.py: win32: render templates using Itpl format to clipboard (e.g. render ‘hello $a’). See cookbook.

  • ipy_editors.py: Bunch of popular editors readily configured for IPython. See ipy_user_conf.py for instructions on how to enable them.

  • ipy_fsops.py: Has useful shell utils for plain (non-cygwin enabled) win32 installations: icp, imv, imkdir, igrep, irm, collect (collect is useful for others as well).

• py2exe version supported (ipykit)

• The title bar of IPython window shows the currently executing system command.

• Prompt on win32 in pysh (‘-p sh’ profile) now has the drive letter for enhanced location awareness, and uses / instead of .

• Errors from misusing magics are much less verbose now (due to UserError exception).

• String Lists provide a convenient way to manipulate command output. See Cookbook.

• Directory stack (%pushd, %popd, %dirs) works more predictably now.

• %time allows IPython expressions (which includes system commands - e.g. try “%time !ls”)

• Callable aliases can be used to extend IPython (provide new commands) in a more elegant manner than magic commands. Also, no % is necessary/allowed. See ipy_fsops.py for examples.

• Improved Leopard support for tab-completion, though a few issues remain.

Known issues¶

• We still get crashes from KeyboardInterrupt occasionally (caused by pressing ctrl+C or ctrl+break)

• Unicode support is not yet perfect, so expect problems on Unicode input/output.

• The manual is hopelessly out of date. This is something we will look into during 0.8.3 cycle; in the meantime, see the documentation page on the wiki [superseded], and the user-maintained cookbook.

• Under OSX Leopard, we are seeing some readline-related problems with history recall. It is not clear yet whether the issue is with IPython or Leopard’s readline support itself. We’re investigating the issue.