How to install Flusspferd

Dependencies

Before installing Flusspferd, you need to install its dependencies.

• Linux or Mac OS X (possibly other POSIX systems work too),
• cmake 2.6 or higher,
• Boost 1.40 or higher,
• Spidermonkey 1.8.1 or higher (NOT 1.8.0) (See our wiki for an explanation).
• Depending on your platform, you need to install iconv.

Recommended, but optional:

• libedit (BSD libedit) can be used for the integrated Javascript shell,
• or GNU/readline (attention, GPL!),
• cURL 7.19.0 or higher (for the cURL plugin),
• GMP (for the GMP plugin),
• SQLite 3 3.4 or higher (for the SQLite3 plugin).

To get direct access to the development repository, you also need GIT.

Download

If you haven't done so already, get the newest version of Flusspferd with

$ git clone git://github.com/ruediger/flusspferd.git

Alternatively, you can download a release from Sourceforge or a snapshot from Github.

Build

Make sure that you are in Flusspferd's directory.

$ cd flusspferd

$ ./configure
$ make
$ sudo make install

You can use -DCMAKE_INSTALL_PREFIX=/opt/local (or with another path in place of /opt/local) if you don't want to install Flusspferd in the default path /usr/local.

If you want to use GNU/readline (e.g. for working UTF-8 support), pass -DLINE_EDITOR=readline but beware that GNU/readline is GPL licensed.

If you have installed your dependencies in unusual paths, or your system is unusual in another way, you might need to specify additional options.

Test the results

If all went fine so far, we should test whether flusspferd works now.

$ flusspferd
> print("Hello", "world!");
Hello world!

Feel free to play around with the Javascript shell.

Bash Completions

Flusspferd provides a completion script for the bash shell. It is usually installed into PREFIX/etc/bash_completion.d/flusspferd since on most systems those files are not sourced you should either add the following line to your ~/.bashrc (replace PREFIX with the prefix where Flusspferd was installed)

. PREFIX/etc/bash_completion.d/flusspferd

or copy the file into a path which is already sourced, like /etc/bash_completion.d/ on most modern Linux systems.

Flusspferd's Emacs Mode

Flusspferd comes with an Emacs mode to call the Flusspferd Shell and interactively send javascript code to the Shell similar to emacs-lisp-mode or inferior python mode. See How to install and setup Flusspferd's Emacs Mode for more information.

Some notes

You might have noticed that Flusspferd doesn't use autotools or Makefiles (although we provide a compatibility layer for those who can't live without). Flusspferd uses CMake as its build system.

Install on Ubuntu 9.10

Since Flusspferd 0.9 we provide .deb packages for Ubuntu. You can install them from CommonJS' PPA (see the instructions on that page).

Install on Gentoo

On Gentoo, you can use our ebuilds, in the branch 'packages', directory 'gentoo/' to compile and install Flusspferd.

These ebuilds can not be found in the official Gentoo repository.

Install on Mac OS X via Macports

Flusspferd is included in the Macports packaging system since Macports 1.8. You can install Flusspferd with

$ sudo port install flusspferd

Different modules are available as variants. E.g. you can install the Flusspferd with the GMP module by using

$ sudo port install flusspferd +gmp

See the Macports Manual for more information.