NOTE: This README is now very out of date.

                        hs-plugins

Compiler and tool support for compiling and loading, and evaluating Haskell at runtime.

The library provides a convenient interface to GHC's runtime loader and linker, letting you load compiled Haskell code.

It also provides a `make' system for compiling plugin source automagically and for combining the user's .hs file with a stub of standard declarations and syntax, saving the user from having to write standard code themselves.

It provides an `eval' function, for generating new, well-typed, compiled code from a Haskell source string.

It also provides a new variation of printf for Haskell-- a runtime generated, dynamically-typed printf.

Read the documentation in doc/ for more.

BUILDING: $ chmod +x Setup.lhs configure $ ./Setup.lhs configure --prefix=/usr/local $ ./Setup.lhs build $ ./Setup.lhs install

DEPENDENCIES:

• Requires GHC >= 6.4
• Requires Cabal

• Optional: If you are doing a lot of `merge'-related operations, and require an extended haskell parser, you can compile hs-plugins to use HSX, Niklas Broberg's Haskell parser library, available at:

  darcs get http://www.cs.chalmers.se/~d00nibro/haskell-src-exts

  To get hs-plugins to use HSX, use:

  $ mv plugins.cabal.hsx plugins.cabal
  $ ./Setup.lhs configure --enable-hsx

  Make sure to install HSX first though :)

• On cygwin/windows you (a) make sure the cygwin "find" is before the windows "find" on your PATH, and (b) to give the windows-style path (e.g., "c:/cygwin/usr/local") in the ./configure --prefix=foo/bar step

• 'plugs' requires a working readline library.

• If you wish to use TH in plugins, or to run load()-programs in GHCi, you require a patch to GHC's linker, that was committed into ghc 6.3, and ghc 6.2 -stable branch, and is available from 6.2.2 onwards.

• If you need to regenerate ./configure you need >= autoreconf-2.53

• The documentation relies on haddock, latex, dvips, tex2page:

  $ cd doc && make

EXAMPLES:

Have a look in the testsuite/ directory for many examples of how to arrange your code.

LICENSE:

This library is distributed under the terms of the LGPL. The runtime loader code is based on code written by André Pang, and others, and is distributed under the BSD-style Glasgow University license.

PORTABILITY:

Requires GHC 6.4 or greater, though most testing has be done on 6.4. The dynamic loader requires a functional GHCi implementation.

---------------------+-------------------------------------------------- Platform | Works Should work Unknown Won't work ---------------------+-------------------------------------------------- i386--linux | X i386--freebsd | X i386--openbsd | X
powerpc-apple-darwin | X
powerpc--linux | X
sparc--solaris2 | X
ia64--linux | # i386--solaris2 | X sparc--linux | X sparc--openbsd | X i386--netbsd | X amd64--openbsd | X mips64-sgi-irix | X ---------------------+--------------------------------------------------

.hi file parsing is currently broken