To complete the Twilio Ruby quickstarts, you’ll need to have the following tools installed:
We’ll cover the installation process for all of these dependencies.
If you are on a Mac or a Linux machine, you probably already have Ruby installed. You can check by typing this at the command line:
ruby -v ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-darwin10.8.0]
If you get any output back other than
ruby: command not found, you’ve got Ruby installed. If you don’t, follow these
instructions to install Ruby for Mac or Linux.
If you’re using Windows, download the RubyInstaller package, which contains a complete Ruby environment.
Third-party dependencies in Ruby are managed with RubyGems, a command line tool that makes it very easy to add new libraries and include them in your Ruby projects. You can check if you have RubyGems installed already by running this at the command line:
gem --version 1.8.24
If you get
gem: command not found, you can download RubyGems from their downloads page.
RubyGems for Windows will be installed by RubyInstaller.
Once you have RubyGems installed, installing Sinatra and twilio-ruby is a snap. Just type this at the command line:
gem install sinatra twilio-ruby
RubyGems will take care of the rest of the work.
Let’s try our installed tools out with a short test file. Create a new file called
test.rb and add the following code:
require 'rubygems' require 'twilio-ruby' require 'sinatra' get '/' do 'Hello World! Currently running version ' + Twilio::VERSION + \ ' of the twilio-ruby library.' end
Now start up a local web server by running your
test.rb file at the command line:
You should see output like this:
Sinatra/1.3.2 has taken the stage on 4567 for development with backup from Thin >> Thin web server (v1.4.1 codename Chromeo) >> Maximum connections set to 1024 >> Listening on 0.0.0.0:4567, CTRL+C to stop
http://localhost:4567 in a browser. You should see a “Hello World” message, with the verison of the
twilio-ruby library posted too.
If you received an error along the way, contact our support team with a description of what you were trying to do, what you expected to see, and what actually happened. They’ll be glad to help you figure out what’s going on.
Now that you’ve got your local environment set up, you’re ready to dive into the Quickstarts. Have fun!