public
Description: Run programs in the Emacs buffer holding their source, seeing their output inline, interactively.
Homepage: http://wry.me/project/halp
Clone URL: git://github.com/darius/halp.git
halp /
name age message
file CREDITS Sat Dec 20 22:54:32 -0800 2008 update docs/credits [darius]
file README Sat Dec 20 22:54:32 -0800 2008 update docs/credits [darius]
file TODO Sat Dec 20 22:54:32 -0800 2008 update docs/credits [darius]
file ghci-halp.sh Sat Aug 02 22:40:48 -0700 2008 add comment [darius]
file ghcihalp.py Thu Dec 18 23:56:58 -0800 2008 Windows-compatible [namin]
file halp.el Sat Dec 20 14:09:20 -0800 2008 avoid .bat files by changing halp.el to invoke ... [namin]
file perfectmedians.lhs Fri Aug 22 18:57:52 -0700 2008 support both .lhs and .hs files; change to a sy... [darius]
file pyhalp.py Sat Dec 20 14:11:00 -0800 2008 clearer elimination of inline if [namin]
file sample.js Wed Sep 03 22:30:41 -0700 2008 super-crude support for Javascript using the V8... [darius]
file sample.lhs Fri Aug 22 18:57:52 -0700 2008 support both .lhs and .hs files; change to a sy... [darius]
file sample.py Thu Sep 18 20:49:03 -0700 2008 explain all our features in sample.py [darius]
file sample.sh Sat Aug 02 22:41:34 -0700 2008 get sh-halp.sh to actually work again (once aga... [darius]
file sh-halp.sh Sat Aug 02 22:41:34 -0700 2008 get sh-halp.sh to actually work again (once aga... [darius]
file v8halp.cc Wed Sep 03 22:30:41 -0700 2008 super-crude support for Javascript using the V8... [darius]
file v8halp.py Sat Oct 04 12:18:39 -0700 2008 untabify sourcefiles [darius]
README
HALP

With Halp, one keystroke executes all specially-marked lines from a
buffer and inserts the results inline. It can do this for source code
in Python, Haskell (literate or illiterate), or sh. This helps you
interactively test your programs as you write them -- like a
read-eval-print loop, but different.

To try it out, first install halp.el as described below. Then visit a
suitable file, (like sample.py, sample.lhs, or sample.sh in this
directory), and hit M-i. These sample files will explain what you can
do and how it works. (Actually only sample.py explains much. But for
the other languages, currently, there's little to explain.)


INSTALLING

Add this line to your .emacs:

  (load-file "/path/to/halp.el")

or just do M-x load-file halp.el.

It will bind M-i in the modes that Halp supports. (Edit halp.el if you
want to change this.)

You will need python-mode, or haskell-mode, etc., installed already
(whichever of these you intend to use with Halp). You will also need
Python >= 2.4 and Emacs 22 or 21.


AUTHORS

Darius Bacon <darius@wry.me>
Brandon Moore
Evan Murphy