Live coding in Python implemented as an Eclipse plugin or an Emacs minor mode.
If you like this project, check out some of my other projects.
Installing the Eclipse plugin
- Install the PyDev plugin and Eclipse if you don't already have them. It's been tested with PyDev 2.7.5 and 3.1.0, Eclipse 4.2 and 4.3, Python 2.7, 3.2, and 3.3. It seems to be particularly sensitive to changes in PyDev.
- Download the latest version of the live-py plugin jar file from the releases page.
Copy the plugin jar file to Eclipse's dropins folder. On my workstation I was able to do that in two different ways.
Copy it to the system-wide Eclipse installation.
sudo cp live-py_22.214.171.124209171018.jar /usr/lib/eclipse/dropins/
Copy it to your
.eclipsefolder in your home directory. This doesn't require sudo permission.
mkdir ~/.eclipse/org.eclipse.platform_3.7.0_155965261/dropins cp live-py_126.96.36.199209171018.jar \ ~/.eclipse/org.eclipse.platform_3.7.0_155965261/dropins
- Restart Eclipse.
- Open any Python file, and from the Pydev menu, choose Live Coding. You should see an extra panel on the right that shows the results of running your code.
- To try the turtle graphics features, open the Window menu, and choose Show View: Other.... Then under PyDev, click Live Coding Canvas and click OK.
Uninstalling the Eclipse plugin
- Delete the jar file from the dropins directory.
- Restart Eclipse.
Installing the Emacs mode
- Install GNU Emacs if you don't already have it.
Clone the latest version of the live-py Emacs mode:
git clone https://github.com/donkirkby/live-py-plugin.git
Copy the Emacs Lisp file and the supporting Python files into a directory which is in your Emacs
load-path. For example:
cd live-py-plugin cp emacs-live-py-mode/live-py-mode.el plugin/PySrc/*.py ~/.emacs.d/
Add ~/.emacs.d/ to your
(add-to-list 'load-path "~/.emacs.d")
Load the Lisp library in your
- Restart Emacs.
- Open any Python file, and activate live-py-mode with
M-x live-py-mode. You should see an extra window on the right that shows the results of running your code.
Uninstalling the Emacs mode
- Remove the files you copied into
- Revert additions to
- Restart Emacs.
- turtle graphics, including filled polygons (Eclipse only)
- local variable assignments
- function calls, and multiple calls.
- compile errors
- runtime exceptions
- infinite loops halted.
- print statements work.
- PyUnit integration
- canvas coordinates?
- Any syntax error currently blanks out the results, should just show previous result with error marker.
code_tracer.pyasynchronously so the editor doesn't block (Emacs only).
- Also see the issues list.
Running from source code
- You need the Eclipse Plug-in Development Environment (PDE). You can either install the standard edition of Eclipse that includes it, or you can open the Help menu, choose Eclipse Marketplace..., click on the Yoxos marketplace, search for PDE, and install it.
- Open the plugin.xml file with the Plug-in Manifest Editor.
- Click on the green play button to launch the Eclipse application.
- Create a new PyDev project, add a Python file, and then turn on Live Coding.
- Now you can hack on the live-py source code and see the results.
Creating an Install Package for the Eclipse plugin
- Open live-py/plugin.xml, and increment the Version field.
- Click the Export Wizard in the bottom right corner.
- Change the destination to Directory, and click Finish.
- Go to the directory you chose, and find the .jar file. You can distribute that as your install package.