= Introduction

Cabar is an extensible software component backplane for
managing software components.
It can be used with Ruby or other software technologies.

For more info see:
 
* http://cabar.rubyforge.org/classes/Cabar.html
* http://cabar.rubyforge.org
* lib/ruby/cabar.rb

Cabar is sponsored by CashNetUSA (http://cashnetusa.com).

= Quick Cabar Demo

* Go to cabar/example.

    > cd cabar/example

* Using bin/cbr_env.

Sets up basic CABAR_* environment variables for cbr command:

    > bin/cbr_env --env
    > eval `bin/cbr_env --env`

* List available commands.

    > cbr help
    > cbr --verbose help comp

* List plugins.

    > cbr plugin list

* List available components.

    > cbr comp list
    > cbr comp list - c2

* Directory structure.

    > find . -type d

* Cabar cabar.yml specification.

    > find . -type f -name 'cabar.yml'

* Components and facets:

    > cbr comp show - c1

* Component version selection:

    > cbr comp run - c2 c2_prog foo bar
    > cbr comp run - c2/1.1 c2_prog foo bar

* Cabar configuration cabar_conf.yml.

Show how component version selection can be done outside
of component requirements.

1. Version Selection
2. Dependencies
3. Version Defaults

    > cbr comp show - c1

* Facet environment for a component:

    > cbr env - c1

* See plugins:

    > cat prod/boc_locale/1.1/cabar.yml
    > cat prod/boc_config/1.0/cabar.rb

* Show graph:

    > CABAR_PATH=@. cbr comp dot --show-dependencies
    > cbr comp dot | dot -Tsvg:cairo -o graph.svg
    > cbr comp dot --show-dependencies - c1 | dot -Tsvg:cairo -o graph.svg
    > cbr comp dot --show-facets - c1 | dot -Tsvg:cairo -o graph.svg
    > cbr comp dot --show-dependencies --show-facets - c1 | dot -Tsvg:cairo -o graph.svg
    > rake
    > ls doc

* In-place run scripts for ruby.

    > cbr bin run - c1 c2_prog

* Cabar as component

    > (cd .. && CABAR_PATH=@. bin/cbr comp list)
    > (cd .. && CABAR_PATH=@. bin/cbr run - cabar cbr list) 

* cbr-run on a #! line.

    > cbr-run-test