# Bud

This is Bud, a.k.a. "Bloom Under Development".  It is an initial cut at a Bloom
DSL, using Ruby as a setting.

See LICENSE for licensing information.

Language cheatsheet in docs/cheat.md ; see the docs/ directory for other
documentation.

Main deficiencies at this point are:

- No Ruby constraints: Within Bloom programs the full power of Ruby is also
  available, including mutable state.  This allows programmers to get outside
  the Bloom framework and lose cleanliness.

- Compatibility: Bud only works with Ruby (MRI) 1.8 and 1.9. JRuby and other
  Ruby implementations are currently not supported.

## Installation

To install the latest release:
    % gem install bud

To build and install a new gem from the current development sources:
    % gem build bud.gemspec ; gem install bud*.gem

Note that GraphViz must be installed.

Simple example programs can be found in examples. A much larger set of example
programs and libraries can be found in the bud-sandbox repository.

To run the unit tests:
    % cd test; ruby ts_bud.rb

## Optional Dependencies

The bud gem has a handful of mandatory dependencies. It also has one optional
dependency: if you wish to use Bud collections backed by Zookeeper, the
"zookeeper" gem must be installed.