skip to navigation
skip to content

IPythonBell 0.9.1

Python line & cell magic to notify the programmer when a line/cell has completed execution

## About
IPython Bell is a simple magic for IPython, which notifies the user when the current line/cell has finished execution. This is particularly useful for long tasks. This also works in IPython QT and IPython Notebook. It can also notify you via. OS X Notification Center.

## Installation
IPython bell can be installed as a standard Python package: `cd ipython-bell/ && python install`

This can be imported into an IPython shell session using either: `import ipybell` or `%load_ext ipybell`

Although you probably want it to load when IPython loads, in which case, edit your IPython profile file (by default `~/.ipython/profile_default/`)
and add `ipybell` to :

c.TerminalIPythonApp.extensions = [

(you may need to create this).

## Usage
This can be used as a magic for a single line (line magic):

In [1]: %bell print 'hello'

or across multiple lines (cell magic):

In[2]: %%bell
import time

There are four currently available notifiers, selectable with the `-n` or `--notifier` arguments:
* **Terminal Bell** `term` -- (default) prints an audible bell character to `stdout` (doesn't work in Notebook).
* **Mac System Beep** `osx` -- system beep (Mac OS X only).
* **Notification Center** `nc` -- Notification Center (Mac OS X 10.8+ only)
* **Notification Center (silent)** `ncsilent` -- Notification Center, just popup (Mac OS X 10.8+ only)

Specified as follows (in this case, for Notification Center):

In [1]: %bell -n nc print 'hello'

In[2]: %%bell -n nc
import time
File Type Py Version Uploaded on Size
IPythonBell-0.9.1.tar.gz (md5) Source 2014-04-13 2KB