Skip to content

therubymug/hitch

Repository files navigation

hitch

by Rogelio J. Samour (http://blog.therubymug.com)

Build Status

Description:

Hitch allows developers to be properly credited when Pair Programming and using Git.

Features:

  • Persists pair(s) between different terminal instances.
  • Creates a unique email address for the pair. (e.g. [email protected]) This provides the ability to create a Gravatar for the pair.
  • Allows you to expire the pair information in N hours. e.g. hitch --expire 8 fry leela

Synopsis:

  • For leela and fry to pair:
    • hitch leela fry
  • To override group email:
  • To clear pair info:
    • hitch -u
  • For a complete list of features:
    • hitch -h
  • Creating a Gravatar for your pair:
    • Once I've hitched with my pair. (e.g. hitch leela fry) I have now created a unique email: [email protected]
    • Then, I go to gravatar.com. Add an image to that particular email address and I'm done.

Install:

  • gem install hitch
  • chruby users run this:
for x in $(chruby | cut -c 3- | awk '{print $1}'); do chruby $x && gem install hitch; done
  • rvm users run this:
for x in $(rvm list strings); do rvm use $x@global && gem install hitch; done
  • rbenv users run this:
for x in $(rbenv versions | cut -c 3- | awk '{print $1}'); do rbenv shell $x && gem install hitch; done
  • hitch --setup >> ~/.bashrc
    • this prints out the necessary shell function and aliases you need to add to your ~/.bashrc or ~/.zshrc
  • Or copy/paste the code into your ~/.bashrc or ~/.zshrc
  • As another option, copy/symlink the script to a separate file (e.g. ~/.bash/hitch.sh or /etc/profile.d/hitch.sh) and source it. You can get the path using hitch --setup-path.

Development:

  • It's easier if you use rvm.
  • Fork hitch
  • When you cd into the directory the .rvmrc will activate and create a hitch gemset
  • Add tests and code for your feature
  • Create a pull request
  • Double-check TravisCI to make sure all tests pass

Requirements:

  • Git, HighLine

Acknowledgements:

  • Stephen Caudill
  • Les Hill
  • Tim Pope

License:

Released under the MIT License. See the LICENSE file for further details.