braid - keep track of external git and svn repositories within a git repository

Attending Euruko 2009 was great! I recommend this conference to every ruby enthusiast. The authors auf braid held a flash talk and tried to demonstrate the power of braid. Unfortunately the didn’t manage to although they typed their commands incredibly fast :)

Back home I gave braid a try and this tool is great. Before I used git submodules but it’s not the same …

To make use of braid you have to install the gem. Just hit

sudo gem install braid

Now you can start using braid in your git repository. For example I want to use my forked acts_as_state_machine gem

braid add git://github.com/basiszwo/aasm.git vendor/gems/basiszwo-aasm-2.0.5

Notice the ‘basiszwo-aasm-2.0.5′. It’s important to add gems to your vendor/gems directory with name and a version number. If you don’t you’ll receive an error while loading your rails application.

You’ll get a .braids file where all your external repositories are listed.

To keep track of these repositories just type

braid update

That’s all! Pretty easy …

Have a look a the project’s github page for more infos!

Leave a Reply