osh 0.8.1



REQUIREMENTS

Osh requires Python 2.3 or later. 



INSTALLATION

This procedure must be executed as root:

1) Unpackage the tarball: tar xzvf osh-0.8.1.tar.gz. (Do not extract the
tar file manually. The installation needs the tar.gz file to support
the installosh command.)

2) cd into the osh-0.8.1 directory.

3) Do the installation: python ./setup.py install

You can test that osh is working properly as follows:

4) cd /usr/share/osh/test

5) Run: ./testall_cli. Output should look something like this:

    gen and out
    f
    select
    agg
    sort
    expand
    squish
    window
    relabeling
    unique
    stdin and sh
    n()
    pipeline

Also run ./testall_cli. Output should look like this:

    gen and out
    f (lambda)
    f (string)
    select (lambda)
    select (string)
    agg (lambda)
    agg (string)
    agg group (lambda)
    agg group (string)
    agg consecutive (lambda)
    agg consecutive (string)
    sort (lambda)
    sort (string)
    expand
    expand (position)
    squish (0-1)
    squish (>1)
    window (default)
    window (disjoint)
    window (overlap)
    window (predicate function)
    window (predicate string)
    unique
    unique (consecutive)
    sh

test_oshargs is out of date and won't run right now.


WHAT INSTALLATION DOES

- osh executables are placed in /usr/bin.

- The python scripts implementing osh are placed in
/usr/lib/pythonX.Y/site-packages, and the subdirectories osh and
oshtypes.

- Documentation is placed in /usr/share/doc/osh.



KNOWN PROBLEMS

1) Command-line parsing often gets confused if there are two tokens
with no intervening whitespace. E.g. "osh @mycluster[sh uptime]$"
causes a syntax error to be reported, but "osh @mycluster [ sh uptime
] $" does not.

2) The sql command works only for Postgresql. Contributions for other
database systems are welcome.

3) The processes() function depends on the proc filesystem, and has
only been tested on RedHat FC3 and FC4. Contributions for other OSes
are welcome.



BUG REPORTS AND SUGGESTIONS:

Jack Orenstein
jao@geophile.com
