jlawler / cabar
watch download tarball
public
Forks2Right
Watchers3Right
Fork of kstephens/cabar
Description: Cabar
Homepage: http://kurtstephens.com/cabar
Clone URL: git://github.com/jlawler/cabar.git 
Merge branch 'master' of git://github.com/kstephens/cabar
jlawler (author)
Sun Jul 12 02:53:27 -0700 2009
commit  cbe4b54f544e48f73f687c062c16b07b44b0e511
tree    857032629079cf2e33aa65c49db3a5104c29f01c
parent  fe55eb51db94c8acb8b619f0b327b6d43d539de4 parent  77631594a94a8e02da566790d6745839930cdd07
cabar /
name age
history
message
file .gitignore Loading commit data...
file .gitmodules
file LICENSE.txt Mon Mar 24 02:23:03 -0700 2008 MIT License. git-svn-id: http://cabar.rubyforg... [kstephens]
file Manifest
file README.txt Tue Jun 16 10:00:11 -0700 2009 Cabar is sponsored by cashnetusa.com. [kstephens]
file Rakefile
file Releases.txt Wed Mar 19 03:05:33 -0700 2008 Updated manifest. git-svn-id: http://cabar.rub... [kstephens]
file TODO.txt Tue Jun 16 16:35:50 -0700 2009 Renamed Cabar::Context to Cabar::Resolver; Remo... [kstephens]
directory bin/
file cabar.yml Tue Jun 23 11:15:09 -0700 2009 Relocated reusable cabar modules to cabar_core.... [kstephens]
directory comp/
directory doc/ Wed Jun 11 16:22:21 -0700 2008 Added UML .png diagrams. git-svn-id: http://ca... [kstephens]
directory example/ Tue Jul 07 16:54:05 -0700 2009 Load only the plugins for the component's of th... [kstephens]
directory lib/
file rake_helper.rb Wed Jun 04 16:39:00 -0700 2008 Added topographic_sort_subset. git-svn-id: htt... [kstephens]
directory src/ Mon Mar 17 10:52:56 -0700 2008 Moved doc to src/doc to avoid conflicting with ... [kstephens]
directory test/
README.txt
= 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