RingoJS

**Note: Narwhal/Tusk support is currently broken due to our update to the latest Filesystem/A proposal. To make Narwhal/Tusk work again under RingoJS, please download and copy [this file](http://gist.github.com/376498) to `modules/file.js` in your RingoJS installation directory.**

Tusk is [Narwhal](http://narwhaljs.org/)'s package manager. There is a fair number of packages available for Narwhal, and we're currently working on making Tusk run on RingoJS to make these available to Ringo as well. The features described in this page are rather fresh and currently only available in our git repository at <http://github.com/ringo/ringojs>.

RingoJS now comes with simple package support compatible to Narwhal/Tusk. In order to run scripts which rely on Narwhal such as jackup or jake, there is also a bin/narwhal script that is a simple proxy to `bin/ringo`. By putting the ringo bin directory on your PATH environment variable, you can effectively use Ringo as a Narwhal replacement with these packages.

To bootstrap this functionality you have to install Narwhal as a package in the RingoJS packages directory so the Narwhal libraries are available to scripts. To do this run the following command:

ringo-admin install 280north/narwhal

This will pull a new version of Narwhal from github.com and install it in RingoJS's packages directory. Note that `280north/narwhal` in the command above is a shortcut to `http://github.com/280north/narwhal/zipball/master`. You can use the full URL instead, and you can install any zipped package from any URL using `ringo-admin install`.

It will also install a number of new commands in RingoJS's bin directory, including `bin/tusk`. Thus, if the `bin/narwhal` command from RingoJS is on your `PATH`, you can now use `tusk` to manage packages for RingoJS. Installed packages will be available to all RingoJS applications and scripts. You can also manually install packages simply by adding them to the packages directory and they will be available to ringo.

Here's a few things to try:

* `tusk update`
 * `tusk catalog`
 * `tusk list`
 * `tusk install <package>`

For example, to install Jack, run `tusk install jack`. This will also install the `jackup` script to run Jack applications:

jackup packages/jack/examples/example.js

cancel | markdown help

Revision history: v0 → v1 → v2 → v3 → v4 → v5 → v6 → v7 → v8 → v9 → v10 → v11 → v12 → v13 → v14 → v15 → v16 → v17 → v18 → v19 → v20 → Version 21