INSTALL

bashlib 0.5

Installation of bashlib is relatively straightforward:

  # gunzip -c bashlib-0.5.tar.gz | tar xf -
  # cd bashlib-0.5
  # ./configure
  # make install

Using bashlib in your CGI scripts is as simple as beginning your
scripts with:

#!/bin/bash
. /path/to/bashlib

# Other stuff

Sourcing bashlib should be the first thing you do in your script;
it reads the environment and pulls out the parameters and cookies.
To get at a named parameter, call:

p=`param p`

In this case, the value of the parameter "p" will end up in p, and
can be accessed normally, through $p.

Cookies work similarly:

session=`cookie session`

will retrieve the cookie named session.

HELPING OUT

Any help is, of course, welcomed. Email me, and we can discuss what
needs to be done. Patches and feature requests are accepted.

TODO

 * Better documentation, probably a man page
 * Autoconf-based install script
 * More functions
   * Functions to generate HTML
   * Functions to set cookies
   * Create URL's
 * Better documentation
 * Add support for multivalued parameters, either via bash2's arrays
   or some other hack
 * sed-based templating system (I've started this one, and it's scary!)

AUTHOR

darren chamberlain <dlc@sevenroot.org>