Nunja is a small portable web server for use with Nu.

It is based on the libevent event notification library (http://monkey.org/~provos/libevent/), and has been tested on OS X 10.5 and Linux (Ubuntu-7.10) systems.

REQUIREMENTS

Nunja requires Nu and nuke, the Nu build tool. To obtain Nu, please visit http://programming.nu or get the source from the Nu git repository on github: http://github.com/timburks/nu

Nunja requires libevent. Before building Nunja, please be sure that libevent is installed on your system. The default build configuration expects libevent to be installed in /usr/local.

Helpers for working with URL query strings have been factored out into a separate project, NuHTTPHelpers, which is now required to run Nunja.

On Linux systems, Nunja requires an implementation of the Foundation classes. It has been tested with NuFound, a modified version of the libFoundation library that has been updated to work with Nu and which can be built using the GNU autotools. The primary NuFound repository is on github: http://github.com/timburks/nufound

The primary Nunja repository is also on github: http://github.com/timburks/nunja

INSTALLATION

After installing all prerequisites, build the Nunja framework by typing "nuke" in the top-level Nunja directory.

AN EXAMPLE

Let's start with the simplest possible Nunja app:

============================================== #!/usr/local/bin/nush (load "Nunja") (set nunja (Nunja nunjaWithCommandLineArguments))

(get "/" "hello!")

(nunja run)

Nunja can also be run from the command line using the "nunjad" (nunja daemon) script. nunjad accepts arguments that can be used to specify a port and a site description. A sample site description is in the sample directory. To run it in Nunja, use the following command: nunjad --site sample

Currently the sample site is very simple, but illustrates the processing of GET and POST requests and the basics of response generation, including the use of cookies.

INFLUENCES

Nunja is modeled on Blake Mizerany's Sinatra, http://sinatra.rubyforge.org/ but has the clarity and transparency of implementation that can only be achieved with Objective-C and Nu.

AUTHOR

Nunja was written by Tim Burks and awaits a host of updates and improvements from its users.

Nunja is released under the Apache License, version 2.0.

Copyright 2008-2009, Neon Design Technology, Inc.