See my Braid 0.4 post for informations about how to upgrade.

Updated to work with the latest version (0.3.1)

Braid is a tool made by Cristi Balan and is a simple tool to help track vendor branches across different SCMs.

It was originally named giston, and was providing functionality similar to piston for git. Braid, however, will work with most SCMs as both source and host.

Warning, Braid is still under development and may change in the future.

To start you need to get and install, on a linux like my ubuntu you can do it by writing:

mihai@mihai-laptop:~$ sudo gem install main open4 mihai@mihai-laptop:~$ git clone git://github.com/evilchelu/braid.git braid mihai@mihai-laptop:~$ cd braid mihai@mihai-laptop:~$ sudo ruby setup.rb

For this example I will use it to install rspec (the development version) on a Rails project. Go to your project root and type:



mihai@mihai-laptop:~/Web/piku$ git config --global mirror.summary true mihai@mihai-laptop:~/Web/piku$ braid add http://rspec.rubyforge.org/svn/trunk/rspec --type svn vendor/plugins/rspec braid: Creating work branch 'braid/track' braid: Checking out work branch 'braid/track'. braid: Adding svn mirror from 'http://rspec.rubyforge.org/svn/trunk/rspec' into 'vendor/plugins/rspec' using local branch 'master'. braid: Setting up remote branch and fetching data mihai@mihai-laptop:~/Web/piku$ git merge braid/track

You do the same to install rspec_on_rails:

mihai@mihai-laptop:~/Web/piku$ braid add http://rspec.rubyforge.org/svn/trunk/rspec_on_rails --type svn vendor/plugins/rspec_on_rails braid: Creating work branch 'braid/track' braid: Checking out work branch 'braid/track'. braid: Adding svn mirror from 'http://rspec.rubyforge.org/svn/trunk/rspec_on_rails' into 'vendor/plugins/rspec_on_rails' using local branch 'master'. braid: Setting up remote branch and fetching data mihai@mihai-laptop:~/Web/piku$ git merge braid/track

That installed rspec, now just type

mihai@mihai-laptop:~/Web/piku$ ruby script/generate rspec

and you are ready to spec. Have fun testing and using git.

To update to the latest version your plugins just type

mihai@kodo:~/Web/piku$ braid update

and to update just rspec use

mihai@kodo:~/Web/piku$ braid update vendor/plugins/rspec

Braid stores the meta information in a file called .braids

mihai@kodo:~/Web/piku$ cat .braids --- vendor/plugins/rspec: local_branch: braid/svn/vendor/plugins/rspec type: svn branch: master remote: http://rspec.rubyforge.org/svn/trunk/rspec vendor/plugins/rspec_on_rails: local_branch: braid/svn/vendor/plugins/rspec-on-rails type: svn branch: master remote: http://rspec.rubyforge.org/svn/trunk/rspec_on_rails

Reddit it – Save it to del.icio.us