Rogelio J. Samour

The Install (Lion Edition)

2011-07-26T15:51:17-04:00

update: [2011-08-23] minor updates
update: [2011-11-05] I have automated this blog post into a shell script. Check it out here

TL;DR

- Copy & paste the following into a Terminal window:

test -f /tmp/the_install.sh && rm /tmp/the_install.sh
curl -s\
  https://raw.github.com/gist/1341873/60ccc411faadf1194941d7b65347ec09b10adac2/the_install.sh \
  -o /tmp/the_install.sh
chmod 0700 /tmp/the_install.sh
. /tmp/the_install.sh

The saga continues

So this is the follow-up post to The Install – Snow Leopard Edition which helped you, the Ruby developer, set up a near-perfect development environment in Mac OS X. Only this time it’s on Apple’s latest version of Mac OS X, 10.7 (Lion). Again, feel free to copy and paste the commands into your terminal.

Take-away

This post walks you through setting up a very sustainable Ruby development environment on your Mac. You’ll be able to write Ruby on Rails apps along with anything else that uses Ruby. e.g. Sinatra, Padrino, Merb, et al. It is also the setup we use everyday at Hashrocket.

A Word of Caution

As usual, while it is unlikely any instruction given below might damage your system, it’s always a good idea to back up everything before doing any of it, just in case. I am not responsible for anything that may result from following the instructions below. Proceed at your own risk.

Step 0:

- Uninstall MacPorts!

Prerequisite OS X Apps:

- Chrome (+ vimium)
- Firefox (+ firebug, ~~note that Selenium is not yet compatible with Firefox 5~~)
- Fluid.app
- Gitx
- SizeUp
- Teleport

Install Xcode

You need to install Xcode for homebrew to compile code from source. It’s free in the Mac App Store! Xcode

OS X Named Streams issue ¹

- Fix it system wide, with the following:

12	echo "[default]" \| sudo tee /etc/nsmb.confecho "streams=no" \| sudo tee -a /etc/nsmb.conf

Install homebrew

123	sudo mkdir /usr/localsudo chown -R `whoami` /usr/localcurl -L https://github.com/mxcl/homebrew/tarball/master \| tar xz --strip 1 -C /usr/local

Create .bash_profile

1 echo '. "$HOME/.bashrc"' > ~/.bash_profile

Install MacVim

1 brew install macvim

Install utilities

1 brew install wget proctools ack ctags-exuberant markdown

Install ImageMagick (optional)

1 brew install imagemagick

Get git

1 brew install git

dotfiles, dev folder

mkdir ~/hashrocket
cd ~/hashrocket
git clone https://github.com/hashrocket/dotmatrix.git

ln -s ~/hashrocket/dotmatrix/.bashrc ~/
ln -s ~/hashrocket/dotmatrix/.hashrc ~/
ln -s ~/hashrocket/dotmatrix/.vim ~/
ln -s ~/hashrocket/dotmatrix/.vimrc ~/
sh ~/hashrocket/dotmatrix/bin/vimbundles.sh

Install rvm

bash < <(curl -s https://rvm.beginrescueend.com/install/rvm)

echo 'if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then source "$HOME/.rvm/scripts/rvm" ; fi' \
       >> ~/.bashrc.local

echo -e "export rvm_project_rvmrc_default=1
export rvm_install_on_use_flag=1
export rvm_project_rvmrc=1
export rvm_path='$HOME/.rvm'" > ~/.rvmrc

echo '[[ -r $rvm_path/scripts/completion ]] && source $rvm_path/scripts/completion' \
       >> ~/.bashrc.local # rvm autocompletion

Create your .gemrc by copying & pasting the following in your terminal:

echo -e '---
:benchmark: false
gem: --no-ri --no-rdoc
:update_sources: true
:bulk_threshold: 1000
:verbose: true
:sources:
- http://rubygems.org
:backtrace: false' > ~/.gemrc

Setup your global gems

A neat feature of rvm is defining the gems every rvm-controlled ruby will install on its global gemset. More here

Simply add your desired gems to the file: ~/.rvm/gemsets/global.gems like so:

123	rake -v0.9.2hitchdirty

Now each time you rvm install a ruby version, you’ll have hitch, dirty and rake version 0.9.2!

Install the rubies to your heart’s content

123	rvm install 1.8.7rvm install 1.9.2rvm use 1.9.2 --default

`Mongo`

1 brew install mongo # Follow instructions

`Postgresql`

1 brew install postgresql # Follow instructions

`MySQL`

1 brew install mysql # Follow instructions

Generate a pubkey for this box

12	ssh-keygen -t rsa# Add public key to your github account

Enjoy

¹ More info

Going Global with RVM Gemsets

2010-09-23T20:48:17-04:00

I wanted to share briefly on installing global or default gems in your rvm-controlled rubies. So here it is, say you wanted to always have a certain list of gems installed in all versions of ruby that your rvm controls. Right now you’d have to do something like this to install one or more gems in all your rubies:

1234	for x in $(rvm list strings)do rvm use $x@global && gem install hitch bundlerdone

And the above works great for your existing rubies. However, going forward the best thing to do is to make your ~/.rvm/gemsets/global.gems look like so:

1234	bundlerhitchmysqlrake

Perfecto! Now the next time you install a new ruby version, bundler, hitch, mysql and rake will be available across all gemsets!

$ rvm install 1.9.2

[...] blah blah Installing Ruby blah blah [...]

$ rvm use 1.9.2
Using ~/.rvm/gems/ruby-1.9.2-p0
$ gem list

*** LOCAL GEMS ***

bundler (1.0.0)
highline (1.6.1)
hitch (0.6.0)
mysql (2.8.1)
rake (0.8.7)

$

Now you can do the following to retrofit your currently installed rubies:

1234	for x in $(rvm list strings)do rvm use $x@global && gem install $(cat ~/.rvm/gemsets/global.gems)done

For more info on how to get your environment setup to use rvm in all its glory, go here.

Let's Hitch and Hack Forever

2010-08-25T01:18:52-04:00

I recently released hitch 0.6, a complete rewrite of the original hitch. We now have a test suite! :-) hitch is a Git author attribution helper for pair programmers. It will modify your git author name and email to reflect who you are pairing with.

The itch we’re scratching

Les Hill originally wrote:

Pair programming does present some unique problems, one that we encountered at Hashrocket was commit attribution: a commit message would be identified with one member of the pair only. This is not exactly tragic, but from the perspective of a passionate developer, having commit credit (and accountability) is a critical and visible part of the ethos.

Tim Pope had the brilliant idea of using a group email address with tags (such as group+you@example.com) to identify the commits a pair made to git. A little bash script fu lead to a nifty command line utility that let us track pairs with our git commits. With that script as a starting point, Ro Samour wrote a pure ruby implementation: hitch

This is what a typical hitch commit message looks like in your terminal:

commit e518dd0637e7d1d77d3bd79a645e5d0bc93eae2d
Author: Philip J. Fry and Turanga Leela <planex+fry+leela@example.com>
Commit: Bender Pairing Station <bender@example.com>

    Fix infite loop in empathy chip

This is a commit message from hitch on github:

Getting started

You will need to install the hitch gem:

% gem install hitch

Or rvm users should copy and paste the following into your terminal:

1234	for x in $(rvm list strings)do rvm use $x@global && gem install hitchdone

Then you will need to add a shell function to your .bashrc or .zshrc:

hitch() {
  command hitch "$@"
  if [[ -s "$HOME/.hitch_export_authors" ]]; then
    source "$HOME/.hitch_export_authors"
  fi
}
alias unhitch='hitch -u'
# Uncomment to persist pair info between terminal instances
# hitch

Alternatively, you can also run the following:

% hitch --setup >> ~/.bashrc

rvm users: (that should be everyone ;-) You should add the shell commands from above after you source the rvm scripts.

Once that’s done, source the ~/.bashrc or open a new terminal and you’re good to go.

The Group Email

You will need a group email account with a service such as GMail or GoogleApps GMail that allows email tags¹ (as an example, twitter is a tag in this email address bender+twitter@example.com which is considered to be the same email address as bender@example.com):

At Hashrocket, we use a Gravatar for our group email account so that the commits show the custom gravatar along with our commit messages. For every pair, we register a new gravatar and associate it with a tagged email address of the form:

dev+github_user1+github_user2@example.com

The github usernames should appear in the local part of the address in alphabetical order after the group address local part, each github username seperated by a +.

Using `hitch`

To pair with another developer whose github username is pair:

% hitch fry leela

hitch will prompt you if it does not recognize github username of your pair and save it for later use.

To unpair and code solo:

% hitch -u

% unhitch

To see who you are currently paired with:

% hitch

¹ Read about email tags on Wikipedia

The Install (Snow Leopard Edition)

2010-05-20T15:51:17-04:00

update 2011-07-26: The Install (Lion Edition) can be found here

Long story short

The following are steps we take at Hashrocket when setting up a near perfect Ruby development environment in OS X (Snow Leopard)¹. Feel free to copy and paste the commands into your terminal.

A Word of Caution

While it is unlikely any instruction given below might damage your system, it’s always a good idea to backup everything before doing any of it, just in case. I am not responsible for anything that may result from following the instructions below. Proceed at your own risk.

Step 0:

- Uninstall MacPorts!

Prerequisite OS X Apps:

- Chrome (+ vimium, make default?)
- Firefox (+ firebug)
- Fluid.app
- Gitx
- SizeUp
- Teleport
- xCode

Snow Leopard Samba Fix²

12	echo "[default]" > ~/Library/Preferences/nsmb.confecho "streams=no" >> ~/Library/Preferences/nsmb.conf

Remove system gems

123	sudo rm -r /System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/lib/ruby/gems/1.8sudo gem update --systemsudo gem clean

Install homebrew

123	sudo mkdir /usr/localsudo chown -R `whoami` /usr/localcurl -L http://github.com/mxcl/homebrew/tarball/master \| tar xz --strip 1 -C /usr/local

Create .bash_profile

1 echo '. "$HOME/.bashrc"' > ~/.bash_profile

Install MacVim

1 brew install macvim

Install utilities

1 brew install wget proctools ack ctags-exuberant markdown

Get git

1 brew install git

dotfiles, dev folder

mkdir ~/hashrocket
cd ~/hashrocket
git clone http://github.com/hashrocket/dotmatrix.git

ln -s ~/hashrocket/dotmatrix/.bashrc ~/
ln -s ~/hashrocket/dotmatrix/.hashrc ~/
ln -s ~/hashrocket/dotmatrix/.vim ~/
ln -s ~/hashrocket/dotmatrix/.vimrc ~/
sh ~/hashrocket/dotmatrix/bin/vimbundles.sh

Install rvm

mkdir -p ~/.rvm/src/ && \
  cd ~/.rvm/src && \
  rm -rf ./rvm/ && \
  git clone --depth 1 git://github.com/wayneeseguin/rvm.git && \
  cd rvm && \
  ./install
echo 'if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then source "$HOME/.rvm/scripts/rvm" ; fi' \
       >> ~/.bashrc.local
echo 'rvm_project_rvmrc_default=1' \
  > ~/.rvmrc # Use default gemset when leaving a .rvmrc project dir
echo '[[ -r $rvm_path/scripts/completion ]] && source $rvm_path/scripts/completion' \
       >> ~/.bashrc.local # rvm autocompletion

Install openssl

1 rvm package install openssl

Install the rubies to your heart’s content

1234	rvm install ree -C --enable-shared=yesrvm install 1.8.7 -C --enable-shared=yesrvm install 1.9.2 -C --enable-shared=yesrvm use 1.8.7 --default

Setup your .gemrc

echo -e '---
:benchmark: false
gem: --no-ri --no-rdoc
:update_sources: true
:bulk_threshold: 1000
:verbose: true
:sources:
- http://rubygems.org
- http://gems.github.com
:backtrace: false' > ~/.gemrc

MySQL

1 brew install mysql # Follow instructions

Postgresql

1 brew install postgresql # Follow instructions

If you get the following error:

FATAL: could not create shared memory segment: Cannot allocate memory

Run this in your terminal window and try the initdb command again.³

12	sudo sysctl -w kern.sysv.shmall=65536sudo sysctl -w kern.sysv.shmmax=16777216

Install global gems

for x in $(rvm list strings)
do
  # Uncomment the next 4 lines to install mysql, pg, & mongrel
  # rvm use $x@global && gem install mysql --\
  #  --with-mysql-dir=/usr/local \
  #  --with-mysql-config=/usr/local/bin/mysql_config
  # rvm use $x@global && gem install mongrel pg
  rvm use $x@global && gem install open_gem ruby-debug hitch
done

RubyCocoa (for rspactor)

mkdir -p /usr/local/src
cd /usr/local/src
wget http://sourceforge.net/projects/rubycocoa/files/RubyCocoa/1.0.0/RubyCocoa-1.0.0.tar.gz/download
tar xzf RubyCocoa-1.0.0.tar.gz && rm RubyCocoa-1.0.0.tar.gz && cd RubyCocoa-1.0.0
ruby install.rb config --build-universal=yes
ruby install.rb setup
# have to sudo to install this because the installer wants to copy example stuff out of the /System dir
sudo ruby install.rb install
sudo chown -R `whoami` /usr/local # For good measure

Growl

cd ~/Downloads
wget http://growl.cachefly.net/Growl-1.2.dmg
open Growl-1.2.dmg
cd /Volumes/Growl-1.2/Extras/growlnotify/
# Don't use the install shell script
# Use the following:
mkdir -p /usr/local/bin
echo "Creating /usr/local/bin"
mkdir -p /usr/local/man/man1
echo "Creating /usr/local/man/man1"
cp growlnotify /usr/local/bin/growlnotify
cp growlnotify.1 /usr/local/man/man1/growlnotify.1

Generate a pubkey for that station

12	ssh-keygen -t rsa# Add public key to your github account

¹ It may work for Leopard… I just haven’t tried it yet.

² More info (Thanks Alan Jones for the tip)

³ Found this here

The Install (Debian Edition)

2010-05-20T10:51:17-04:00

Long story short

The following are steps we take at Hashrocket when setting up a near perfect Ruby development environment in GNU/Linux (Debian/Ubuntu). Feel free to copy and paste the commands into your terminal.

A Word of Caution

Prerequisite Debian/Ubuntu Apps:

- Chrome (+ vimium, make default?)
- Firefox (+ firebug)

Install vim

1 sudo apt-get install vim-gnome

Install utilities

12	sudo apt-get install curl bison build-essential zlib1g-dev libssl-dev libreadline5-dev libxml2-devsudo apt-get install wget ack exuberant-ctags markdown gitk openssh-server

get git

1 sudo apt-get install git-core

Install rvm

bash < <(curl -s https://rvm.beginrescueend.com/install/rvm)

echo 'if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then source "$HOME/.rvm/scripts/rvm" ; fi' \
       >> ~/.bashrc.local

echo -e "export rvm_project_rvmrc_default=1
export rvm_install_on_use_flag=1
export rvm_project_rvmrc=1
export rvm_path='$HOME/.rvm'" > ~/.rvmrc

echo '[[ -r $rvm_path/scripts/completion ]] && source $rvm_path/scripts/completion' \
       >> ~/.bashrc.local # rvm autocompletion

Setup your global gems

A neat feature of rvm is defining the gems every rvm-controlled ruby will install on its global gemset. More here

Simply add your desired gems to the file: ~/.rvm/gemsets/global.gems like so:

123	rake -v0.9.2hitchdirty

Now each time you rvm install a ruby version, you’ll have hitch, dirty and rake version 0.9.2!

Create your .gemrc by copying & pasting the following in your terminal:

echo -e '---
:benchmark: false
gem: --no-ri --no-rdoc
:update_sources: true
:bulk_threshold: 1000
:verbose: true
:sources:
- http://rubygems.org
:backtrace: false' > ~/.gemrc

Install the rubies to your heart’s content

123	rvm install 1.8.7rvm install 1.9.2rvm use 1.9.2 --default

Install the Hashrocket dot files (don’t worry, you can override your preferences)

123	mkdir ~/hashrocketcd ~/hashrocketgit clone http://github.com/hashrocket/dotmatrix.git

Symlink the good stuff!

ln -s ~/hashrocket/dotmatrix/.bashrc ~/
ln -s ~/hashrocket/dotmatrix/.hashrc ~/
ln -s ~/hashrocket/dotmatrix/.vim ~/
ln -s ~/hashrocket/dotmatrix/.vimrc ~/
sh ~/hashrocket/dotmatrix/bin/vimbundles.sh

Mongo

Follow these instructions

Postgresql (more in-depth install here)

1 sudo apt-get install postgresql-common postgresql-server-dev-8.4 # Follow instructions

MySQL

1 sudo apt-get install mysql-common mysql-server-5.1 # Follow instructions

Generate a pubkey for that station

12	ssh-keygen -t rsa# Add public key to your github account

Enjoy

update: [2011-08-23] rvm install process, other misc.

Engine Yard Cloud and Resque-Web

2010-04-20T17:13:16-04:00

So at Hashrocket, we’ve been deploying a number of apps to Engine Yard Cloud. Some of these apps have required the use of background jobs. A library that facilitates that is called Resque. Once set up¹, it has a Sinatra web app you can use to monitor the queue’s progress. To make a long story short, it isn’t trivial to setup Resque Web on Engine Yard Cloud. This is what we did to make it work:

In your environment.rb add the following line:

1 Rails::Initializer.run do |config|
2   #[...]
3   config.middleware.use 'ResqueWeb'
4 end

Then create a library under RAILS_ROOT/lib/resque_web.rb with the following:

 1 require 'sinatra/base'
 2 class ResqueWeb < Sinatra::Base
 3   require 'resque/server'
 4   use Rack::ShowExceptions
 5   def call(env)
 6     if env["PATH_INFO"] =~ /^\/resque/
 7       env["PATH_INFO"].sub!(/^\/resque/, '')
 8       env['SCRIPT_NAME'] = '/resque'
 9       app = Resque::Server.new
10       app.call(env)
11     else
12       super
13     end
14   end
15 end

That’s it. Deploy your app to staging to test it and boom!

¹ This assumes you already have Resque installed in your EY Cloud app.

Hitch!

2009-04-20T17:04:38-04:00

At Hashrocket, we pair program all the time. In order to properly give credit to both programmers, we wrote a helper in the form of a gem. We called it Hitch!

So how does it work?

In the spirit of staying DRY, I will direct you to Les Hill’s blog post: Pairing with Hitch

Enjoy.

Rogelio J. Samour

The Install (Lion Edition)

TL;DR

The saga continues

Take-away

A Word of Caution

Step 0:

Prerequisite OS X Apps:

Install Xcode

OS X Named Streams issue 1

Install homebrew

Create .bash_profile

Install MacVim

Install utilities

Install ImageMagick (optional)

Get git

dotfiles, dev folder

Install rvm

Create your .gemrc by copying & pasting the following in your terminal:

Setup your global gems

Install the rubies to your heart’s content

Mongo

Postgresql

MySQL

Generate a pubkey for this box

Enjoy

Going Global with RVM Gemsets

Let's Hitch and Hack Forever

The itch we’re scratching

Getting started

The Group Email

Using hitch

The Install (Snow Leopard Edition)

Long story short

A Word of Caution

Step 0:

Prerequisite OS X Apps:

Snow Leopard Samba Fix2

Remove system gems

Install homebrew

Create .bash_profile

Install MacVim

Install utilities

Get git

dotfiles, dev folder

Install rvm

Install openssl

Install the rubies to your heart’s content

Setup your .gemrc

MySQL

Postgresql

Install global gems

RubyCocoa (for rspactor)

Growl

Generate a pubkey for that station

The Install (Debian Edition)

Long story short

A Word of Caution

Prerequisite Debian/Ubuntu Apps:

Install vim

Install utilities

get git

Install rvm

Setup your global gems

Create your .gemrc by copying & pasting the following in your terminal:

Install the rubies to your heart’s content

Install the Hashrocket dot files (don’t worry, you can override your preferences)

Symlink the good stuff!

Mongo

Postgresql (more in-depth install here)

MySQL

Generate a pubkey for that station

Enjoy

Engine Yard Cloud and Resque-Web

In your environment.rb add the following line:

Then create a library under RAILS_ROOT/lib/resque_web.rb with the following:

Hitch!

So how does it work?

OS X Named Streams issue ¹

`Mongo`

`Postgresql`

`MySQL`

Using `hitch`

Snow Leopard Samba Fix²