Simplify .py listing code, moving Misc examples.

examples/list_pyfiles.ipy

@@ -0,0 +1,6 b''
+# A simple IPython script that provides Notebook links to .py files in the cwd
+
+from IPython.display import FileLink, display
+files =!ls *.py
+for f in files:
+    display(FileLink(f))
  No newline at end of file

examples/list_subdirs.ipy

@@ -0,0 +1,6 b''
+# A simple IPython script that lists files in all subdirs
+
+from IPython.display import FileLinks, display
+dirs =!ls -d */
+for d in dirs:
+    display(FileLinks(d))
  No newline at end of file

examples/Customization/Index.ipynb

@@ -1,124 +1,111 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:2fc11a62b83396569f64bfde2516a0219a62108a64f920dedb7217a63d67a9bc"
+  "signature": "sha256:a805b2c46cc61ed300cc06162f057e5c2f934cf3df10daa27ca885a1ab74674a"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Customization"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "IPython has rich APIs for customization. Many behaviors of the different IPython applications can be configured using command line arguments or configuration files. IPython's core syntax and command line features can also be customized through input filters, custom magic commands, etc."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Coming soon."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Coming soon."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Non-notebook examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This directory also contains examples that are regular Python (`.py`) files."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
-      "from IPython.display import FileLink, display"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 1
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "files =!ls *.py\n",
-      "for f in files:\n",
-      "    display(FileLink(f))"
+      "%run ../list_pyfiles.ipy"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "html": [
         "<a href='appconfig.py' target='_blank'>appconfig.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Customization/appconfig.py"
        ]
       }
      ],
      "prompt_number": 2
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Embedding/Index.ipynb

@@ -1,201 +1,188 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:78b90d18791f32ff5abbbf5b4a9846ad8fad0a46af65125faac15f86f68da57f"
+  "signature": "sha256:29db13dc7016ac387a7b8f535ee31c19456004997ba93c328fa0abae41704e5f"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Embedding IPython Into Other Applications"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "The architecture of IPython is built with reusable components. These components include:\n",
       "\n",
       "* The configuration system for processing command line arguments and configuration files\n",
       "* The IPython `InteractiveShell` object that provides the core interactive features across the entire code base\n",
       "* The IPython kernel, which provides the capabilities of the `InteractiveShell` object over a ZeroMQ/JSON based message protocol to various frontends\n",
       "* The IPython frontends (Notebook, Qt Console, Console, Terminal)\n",
       "\n",
       "These components can be embedded into other applications."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Coming soon."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Coming soon."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Non-notebook examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This directory also contains examples that are regular Python (`.py`) files."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
-      "from IPython.display import FileLink, display"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 2
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "files =!ls *.py\n",
-      "for f in files:\n",
-      "    display(FileLink(f))"
+      "%run ../list_pyfiles.ipy"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "html": [
         "<a href='embed_class_long.py' target='_blank'>embed_class_long.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/embed_class_long.py"
        ]
       },
       {
        "html": [
         "<a href='embed_class_short.py' target='_blank'>embed_class_short.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/embed_class_short.py"
        ]
       },
       {
        "html": [
         "<a href='embed_function.py' target='_blank'>embed_function.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/embed_function.py"
        ]
       },
       {
        "html": [
         "<a href='inprocess_qtconsole.py' target='_blank'>inprocess_qtconsole.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/inprocess_qtconsole.py"
        ]
       },
       {
        "html": [
         "<a href='inprocess_terminal.py' target='_blank'>inprocess_terminal.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/inprocess_terminal.py"
        ]
       },
       {
        "html": [
         "<a href='internal_ipkernel.py' target='_blank'>internal_ipkernel.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/internal_ipkernel.py"
        ]
       },
       {
        "html": [
         "<a href='ipkernel_qtapp.py' target='_blank'>ipkernel_qtapp.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/ipkernel_qtapp.py"
        ]
       },
       {
        "html": [
         "<a href='ipkernel_wxapp.py' target='_blank'>ipkernel_wxapp.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Embedding/ipkernel_wxapp.py"
        ]
       }
      ],
-     "prompt_number": 3
+     "prompt_number": 1
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/IPython Kernel/Background Jobs.ipynb

@@ -1,352 +1,358 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:178b84c6ec2464bc76d655fb49d06913fcdcac5aad9e3442b6039c219f583e49"
+  "signature": "sha256:481e128e553ec13e039f3e3f5e567cc3caffe391b78b9821ee883fb8770ebc82"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
+     "cell_type": "heading",
+     "level": 1,
+     "metadata": {},
+     "source": [
+      "Background Jobs"
+     ]
+    },
+    {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "# Simple interactive bacgkround jobs with IPython\n",
-      "\n",
       "We start by loading the `backgroundjobs` library and defining a few trivial functions to illustrate things with."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "from __future__ import print_function\n",
       "from IPython.lib import backgroundjobs as bg\n",
       "\n",
       "import sys\n",
       "import time\n",
       "\n",
       "def sleepfunc(interval=2, *a, **kw):\n",
       "    args = dict(interval=interval,\n",
       "                args=a,\n",
       "                kwargs=kw)\n",
       "    time.sleep(interval)\n",
       "    return args\n",
       "\n",
       "def diefunc(interval=2, *a, **kw):\n",
       "    time.sleep(interval)\n",
       "    raise Exception(\"Dead job with interval %s\" % interval)\n",
       "\n",
       "def printfunc(interval=1, reps=5):\n",
       "    for n in range(reps):\n",
       "        time.sleep(interval)\n",
       "        print('In the background...', n)\n",
       "        sys.stdout.flush()\n",
       "    print('All done!')\n",
       "    sys.stdout.flush()"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [],
      "prompt_number": 1
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Now, we can create a job manager (called simply `jobs`) and use it to submit new jobs.\n",
       "<br>\n",
       "Run the cell below and wait a few seconds for the whole thing to finish, until you see the \"All done!\" printout."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "jobs = bg.BackgroundJobManager()\n",
       "\n",
       "# Start a few jobs, the first one will have ID # 0\n",
       "jobs.new(sleepfunc, 4)\n",
       "jobs.new(sleepfunc, kw={'reps':2})\n",
       "jobs.new('printfunc(1,3)')\n",
       "\n",
       "# This makes a couple of jobs which will die.  Let's keep a reference to\n",
       "# them for easier traceback reporting later\n",
       "diejob1 = jobs.new(diefunc, 1)\n",
       "diejob2 = jobs.new(diefunc, 2)"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "Starting job # 0 in a separate thread.\n",
         "Starting job # 2 in a separate thread.\n",
         "Starting job # 3 in a separate thread.\n",
         "Starting job # 4 in a separate thread.\n",
         "Starting job # 5 in a separate thread.\n"
        ]
       }
      ],
      "prompt_number": 2
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can check the status of your jobs at any time:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "jobs.status()"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "In the background... 0\n",
         "Running jobs:"
        ]
       },
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "\n",
         "0 : <function sleepfunc at 0x102cc6848>\n",
         "2 : <function sleepfunc at 0x102cc6848>\n",
         "3 : printfunc(1,3)\n",
         "5 : <function diefunc at 0x102cc68c0>\n",
         "\n",
         "Dead jobs:\n",
         "4 : <function diefunc at 0x102cc68c0>\n",
         "\n"
        ]
       }
      ],
      "prompt_number": 3
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "For any completed job, you can get its result easily:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "jobs[0].result\n",
       "j0 = jobs[0]\n",
       "j0.join?"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [],
      "prompt_number": 4
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "You can get the traceback of any dead job.  Run the line\n",
       "below again interactively until it prints a traceback (check the status\n",
       "of the job):\n"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "print \"Status of diejob1:\", diejob1.status\n",
       "diejob1.traceback()  # jobs.traceback(4) would also work here, with the job number"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "In the background... 1\n",
         "In the background... 2\n",
         "All done!\n"
        ]
       },
       {
        "ename": "SyntaxError",
        "evalue": "invalid syntax (<ipython-input-5-a90bd59af669>, line 1)",
        "output_type": "pyerr",
        "traceback": [
         "\u001b[0;36m  File \u001b[0;32m\"<ipython-input-5-a90bd59af669>\"\u001b[0;36m, line \u001b[0;32m1\u001b[0m\n\u001b[0;31m    print \"Status of diejob1:\", diejob1.status\u001b[0m\n\u001b[0m                             ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid syntax\n"
        ]
       }
      ],
      "prompt_number": 5
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This will print all tracebacks for all dead jobs:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "jobs.traceback()"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "Traceback for: <BackgroundJob #4: <function diefunc at 0x102cc68c0>>\n",
         "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m\n",
         "\u001b[0;31mException\u001b[0m                                 Traceback (most recent call last)\n",
         "\u001b[0;32m/Users/bgranger/Documents/Computing/IPython/code/ipython/IPython/lib/backgroundjobs.pyc\u001b[0m in \u001b[0;36mcall\u001b[0;34m(self)\u001b[0m\n",
         "\u001b[1;32m    489\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[1;32m    490\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0mcall\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0;32m--> 491\u001b[0;31m         \u001b[0;32mreturn\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m*\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0m\n",
         "\u001b[0;32m<ipython-input-1-7391f8ae281b>\u001b[0m in \u001b[0;36mdiefunc\u001b[0;34m(interval, *a, **kw)\u001b[0m\n",
         "\u001b[1;32m     14\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mdiefunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minterval\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m2\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0ma\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkw\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[1;32m     15\u001b[0m     \u001b[0mtime\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0msleep\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minterval\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0;32m---> 16\u001b[0;31m     \u001b[0;32mraise\u001b[0m \u001b[0mException\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m\"Dead job with interval %s\"\u001b[0m \u001b[0;34m%\u001b[0m \u001b[0minterval\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0m\u001b[1;32m     17\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[1;32m     18\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mprintfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minterval\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mreps\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m5\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\n",
         "\u001b[0;31mException\u001b[0m: Dead job with interval 1\n",
         "\n",
         "Traceback for: <BackgroundJob #5: <function diefunc at 0x102cc68c0>>\n",
         "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m\n",
         "\u001b[0;31mException\u001b[0m                                 Traceback (most recent call last)\n",
         "\u001b[0;32m/Users/bgranger/Documents/Computing/IPython/code/ipython/IPython/lib/backgroundjobs.pyc\u001b[0m in \u001b[0;36mcall\u001b[0;34m(self)\u001b[0m\n",
         "\u001b[1;32m    489\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[1;32m    490\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0mcall\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0;32m--> 491\u001b[0;31m         \u001b[0;32mreturn\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m*\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0m\n",
         "\u001b[0;32m<ipython-input-1-7391f8ae281b>\u001b[0m in \u001b[0;36mdiefunc\u001b[0;34m(interval, *a, **kw)\u001b[0m\n",
         "\u001b[1;32m     14\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mdiefunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minterval\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m2\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0ma\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkw\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[1;32m     15\u001b[0m     \u001b[0mtime\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0msleep\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minterval\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0;32m---> 16\u001b[0;31m     \u001b[0;32mraise\u001b[0m \u001b[0mException\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m\"Dead job with interval %s\"\u001b[0m \u001b[0;34m%\u001b[0m \u001b[0minterval\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[0m\u001b[1;32m     17\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
         "\u001b[1;32m     18\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mprintfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minterval\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mreps\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m5\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
         "\n",
         "\u001b[0;31mException\u001b[0m: Dead job with interval 2\n",
         "\n"
        ]
       }
      ],
      "prompt_number": 6
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "The job manager can be flushed of all completed jobs at any time:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "jobs.flush()"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "Flushing 3 Completed jobs.\n",
         "Flushing 2 Dead jobs.\n"
        ]
       }
      ],
      "prompt_number": 7
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "After that, the status is simply empty:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": true,
      "input": [
       "jobs.status()"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [],
      "prompt_number": 8
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "It's easy to wait on a job:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
       "j = jobs.new(sleepfunc, 2)\n",
       "print(\"Will wait for j now...\")\n",
       "sys.stdout.flush()\n",
       "j.join()\n",
       "print(\"Result from j:\")\n",
       "j.result"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "Starting job # 0 in a separate thread.\n",
         "Will wait for j now...\n"
        ]
       },
       {
        "output_type": "stream",
        "stream": "stdout",
        "text": [
         "Result from j:\n"
        ]
       },
       {
        "metadata": {},
        "output_type": "pyout",
        "prompt_number": 9,
        "text": [
         "{'args': (), 'interval': 2, 'kwargs': {}}"
        ]
       }
      ],
      "prompt_number": 9
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/IPython Kernel/Index.ipynb

@@ -1,125 +1,165 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:1f73cbd161515fd1a2c4b327925f1f17e45ed057ffb039a22cf833f61154e000"
+  "signature": "sha256:dd3f8171dfb5c8cb7aa9b1c0f5dee915f4ac8f73d9dc19a20a95c8f1583578ae"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "IPython Kernel"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "IPython provides extensions to the Python programming language that make working interactively convenient and efficient. These extensions are implemented in the IPython Kernel and are available in all of the IPython Frontends (Notebook, Terminal, Console and Qt Console) when running this kernel."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Cell Magics](Cell Magics.ipynb)\n",
       "* [Script Magics](Script Magics.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Coming soon."
+      "* [Background Jobs](Background Jobs.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Non-notebook examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This directory also contains examples that are regular Python (`.py`) files."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
-      "from IPython.display import FileLink, display"
+      "%run ../list_pyfiles.ipy"
      ],
      "language": "python",
      "metadata": {},
-     "outputs": [],
+     "outputs": [
+      {
+       "html": [
+        "<a href='example-demo.py' target='_blank'>example-demo.py</a><br>"
+       ],
+       "metadata": {},
+       "output_type": "display_data",
+       "text": [
+        "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/IPython Kernel/example-demo.py"
+       ]
+      },
+      {
+       "html": [
+        "<a href='ipython-get-history.py' target='_blank'>ipython-get-history.py</a><br>"
+       ],
+       "metadata": {},
+       "output_type": "display_data",
+       "text": [
+        "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/IPython Kernel/ipython-get-history.py"
+       ]
+      }
+     ],
      "prompt_number": 1
     },
     {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "There are also a set of examples that show how to integrate IPython with different GUI event loops:"
+     ]
+    },
+    {
      "cell_type": "code",
      "collapsed": false,
      "input": [
-      "files =!ls *.py\n",
-      "for f in files:\n",
-      "    display(FileLink(f))"
+      "%run ../list_subdirs.ipy"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "html": [
-        "<a href='ipython-get-history.py' target='_blank'>ipython-get-history.py</a><br>"
+        "gui/<br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-glut.py' target='_blank'>gui-glut.py</a><br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-gtk.py' target='_blank'>gui-gtk.py</a><br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-gtk3.py' target='_blank'>gui-gtk3.py</a><br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-pyglet.py' target='_blank'>gui-pyglet.py</a><br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-qt.py' target='_blank'>gui-qt.py</a><br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-tk.py' target='_blank'>gui-tk.py</a><br>\n",
+        "&nbsp;&nbsp;<a href='gui/gui-wx.py' target='_blank'>gui-wx.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
-        "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/IPython Kernel/ipython-get-history.py"
+        "gui/\n",
+        "  gui-glut.py\n",
+        "  gui-gtk.py\n",
+        "  gui-gtk3.py\n",
+        "  gui-pyglet.py\n",
+        "  gui-qt.py\n",
+        "  gui-tk.py\n",
+        "  gui-wx.py"
        ]
       }
      ],
      "prompt_number": 2
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Index.ipynb

@@ -1,59 +1,58 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:f047f5edb4201c0c7aa38bdf31058bf6ab2785d53e7a03cdbd4e4ff4217c0007"
+  "signature": "sha256:0b4b631419772e40e0f4893f5a0f0fe089a39e46c8862af0256164628394302d"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "IPython Documentation"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This directory contains IPython's notebook-based documentation. This augments our [Sphinx-based documentation](http://ipython.org/ipython-doc/stable/index.html) with notebooks that contain interactive tutorials and examples. Over time, more of our documentation will be pulled into this format."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Topics"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [IPython Kernel](IPython Kernel/Index.ipynb): IPython's core syntax and command line features available in all frontends\n",
       "* [Notebook](Notebook/Index.ipynb): The IPython Notebook frontend\n",
       "* [Interactive Widgets](Interactive Widgets/Index.ipynb): Interactive JavaScript/HTML widgets and `interact`\n",
       "* [Parallel Computing](Parallel Computing/Index.ipynb): IPython's library for interactive parallel computing\n",
       "* [Customization](Customization/Index.ipynb): How to configure IPython and customize it with magics, extensions, etc.\n",
       "* [Embedding](Embedding/Index.ipynb): Embedding and reusing IPython's components into other applications\n",
-      "* [Builtin Extensions](Builtin Extensions/Index.ipynb): Extensions we ship with IPython\n",
-      "* [Miscellaneous](Miscellaneous/Index.ipynb): Documentation that doesn't fit anywhere else"
+      "* [Builtin Extensions](Builtin Extensions/Index.ipynb): Extensions we ship with IPython"
      ]
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file

examples/Parallel Computing/Index.ipynb

@@ -1,352 +1,330 b''
 {
  "metadata": {
   "name": "",
-  "signature": "sha256:24e7c8d3c3d2d4b6e7a5b9d01c7e413b736537327a485e257912943fc013a888"
+  "signature": "sha256:424566387e51dfd0dc559496301c86be9b1f610b6cfedb1cbd225ce9f0161b88"
  },
  "nbformat": 3,
  "nbformat_minor": 0,
  "worksheets": [
   {
    "cells": [
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "<img src=\"../images/ipython_logo.png\">"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "Back to the main [Index](../Index.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 1,
      "metadata": {},
      "source": [
       "Parallel Computing"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "IPython includes an architecture and library for interactive parallel computing. The enables Python functions, along with their arguments, to be run in parallel a multicore CPU, cluster or cloud using a simple Python API."
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Tutorials"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Data Publication API](Data Publication API.ipynb) "
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "* [Monitoring an MPI Simulation - 1](Monitoring an MPI Simulation - 1.ipynb)\n",
       "* [Monitoring an MPI Simulation - 2](Monitoring an MPI Simulation - 2.ipynb)\n",
       "* [Parallel Decorator and map](Parallel Decorator and map.ipynb)\n",
       "* [Parallel Magics](Parallel Magics.ipynb)\n",
       "* [Using Dill](Using Dill.ipynb)\n",
       "* [Using MPI with IPython Parallel](Using MPI with IPython Parallel.ipynb)\n",
       "* [Monte Carlo Options](Monte Carlo Options.ipynb)"
      ]
     },
     {
      "cell_type": "heading",
      "level": 2,
      "metadata": {},
      "source": [
       "Non-notebook examples"
      ]
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "This directory also contains examples that are regular Python (`.py`) files."
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
-      "from IPython.display import FileLink, display"
-     ],
-     "language": "python",
-     "metadata": {},
-     "outputs": [],
-     "prompt_number": 7
-    },
-    {
-     "cell_type": "markdown",
-     "metadata": {},
-     "source": [
-      "Here are single file Python examples:"
-     ]
-    },
-    {
-     "cell_type": "code",
-     "collapsed": false,
-     "input": [
-      "files =!ls *.py\n",
-      "for f in files:\n",
-      "    display(FileLink(f))"
+      "%run ../list_pyfiles.ipy"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "html": [
         "<a href='customresults.py' target='_blank'>customresults.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/customresults.py"
        ]
       },
       {
        "html": [
         "<a href='dagdeps.py' target='_blank'>dagdeps.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/dagdeps.py"
        ]
       },
       {
        "html": [
         "<a href='dependencies.py' target='_blank'>dependencies.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/dependencies.py"
        ]
       },
       {
        "html": [
         "<a href='fetchparse.py' target='_blank'>fetchparse.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/fetchparse.py"
        ]
       },
       {
        "html": [
         "<a href='iopubwatcher.py' target='_blank'>iopubwatcher.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/iopubwatcher.py"
        ]
       },
       {
        "html": [
         "<a href='itermapresult.py' target='_blank'>itermapresult.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/itermapresult.py"
        ]
       },
       {
        "html": [
         "<a href='nwmerge.py' target='_blank'>nwmerge.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/nwmerge.py"
        ]
       },
       {
        "html": [
         "<a href='phistogram.py' target='_blank'>phistogram.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/phistogram.py"
        ]
       },
       {
        "html": [
         "<a href='task_profiler.py' target='_blank'>task_profiler.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/task_profiler.py"
        ]
       },
       {
        "html": [
         "<a href='throughput.py' target='_blank'>throughput.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "/Users/bgranger/Documents/Computing/IPython/code/ipython/examples/Parallel Computing/throughput.py"
        ]
       }
      ],
-     "prompt_number": 9
+     "prompt_number": 4
     },
     {
      "cell_type": "markdown",
      "metadata": {},
      "source": [
       "More substantial examples can be found in subdirectories:"
      ]
     },
     {
      "cell_type": "code",
      "collapsed": false,
      "input": [
-      "files =!ls -d */\n",
-      "for f in files:\n",
-      "    display(FileLinks(f))"
+      "%run ../list_subdirs.ipy"
      ],
      "language": "python",
      "metadata": {},
      "outputs": [
       {
        "html": [
         "daVinci Word Count/<br>\n",
         "&nbsp;&nbsp;<a href='daVinci Word Count/pwordfreq.py' target='_blank'>pwordfreq.py</a><br>\n",
         "&nbsp;&nbsp;<a href='daVinci Word Count/wordfreq.py' target='_blank'>wordfreq.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "daVinci Word Count/\n",
         "  pwordfreq.py\n",
         "  wordfreq.py"
        ]
       },
       {
        "html": [
         "interengine/<br>\n",
         "&nbsp;&nbsp;<a href='interengine/bintree.py' target='_blank'>bintree.py</a><br>\n",
         "&nbsp;&nbsp;<a href='interengine/bintree_script.py' target='_blank'>bintree_script.py</a><br>\n",
         "&nbsp;&nbsp;<a href='interengine/communicator.py' target='_blank'>communicator.py</a><br>\n",
         "&nbsp;&nbsp;<a href='interengine/interengine.py' target='_blank'>interengine.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "interengine/\n",
         "  bintree.py\n",
         "  bintree_script.py\n",
         "  communicator.py\n",
         "  interengine.py"
        ]
       },
       {
        "html": [],
        "metadata": {},
        "output_type": "display_data",
        "text": []
       },
       {
        "html": [
         "pi/<br>\n",
         "&nbsp;&nbsp;<a href='pi/parallelpi.py' target='_blank'>parallelpi.py</a><br>\n",
         "&nbsp;&nbsp;<a href='pi/pidigits.py' target='_blank'>pidigits.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "pi/\n",
         "  parallelpi.py\n",
         "  pidigits.py"
        ]
       },
       {
        "html": [
         "rmt/<br>\n",
         "&nbsp;&nbsp;<a href='rmt/rmt.ipy' target='_blank'>rmt.ipy</a><br>\n",
         "&nbsp;&nbsp;<a href='rmt/rmt.ipynb' target='_blank'>rmt.ipynb</a><br>\n",
         "&nbsp;&nbsp;<a href='rmt/rmtkernel.py' target='_blank'>rmtkernel.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "rmt/\n",
         "  rmt.ipy\n",
         "  rmt.ipynb\n",
         "  rmtkernel.py"
        ]
       },
       {
        "html": [
         "wave2D/<br>\n",
         "&nbsp;&nbsp;<a href='wave2D/communicator.py' target='_blank'>communicator.py</a><br>\n",
         "&nbsp;&nbsp;<a href='wave2D/parallelwave-mpi.py' target='_blank'>parallelwave-mpi.py</a><br>\n",
         "&nbsp;&nbsp;<a href='wave2D/parallelwave.py' target='_blank'>parallelwave.py</a><br>\n",
         "&nbsp;&nbsp;<a href='wave2D/RectPartitioner.py' target='_blank'>RectPartitioner.py</a><br>\n",
         "&nbsp;&nbsp;<a href='wave2D/wavesolver.py' target='_blank'>wavesolver.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "wave2D/\n",
         "  communicator.py\n",
         "  parallelwave-mpi.py\n",
         "  parallelwave.py\n",
         "  RectPartitioner.py\n",
         "  wavesolver.py"
        ]
       },
       {
        "html": [
         "workflow/<br>\n",
         "&nbsp;&nbsp;<a href='workflow/client.py' target='_blank'>client.py</a><br>\n",
         "&nbsp;&nbsp;<a href='workflow/job_wrapper.py' target='_blank'>job_wrapper.py</a><br>\n",
         "&nbsp;&nbsp;<a href='workflow/wmanager.py' target='_blank'>wmanager.py</a><br>"
        ],
        "metadata": {},
        "output_type": "display_data",
        "text": [
         "workflow/\n",
         "  client.py\n",
         "  job_wrapper.py\n",
         "  wmanager.py"
        ]
       }
      ],
-     "prompt_number": 13
+     "prompt_number": 3
     }
    ],
    "metadata": {}
   }
  ]
 }
  No newline at end of file