Fork me on GitHub
Learn more at the sources:



This guide will focus on ruby - the language - alone.

After finishing this guide you will

  • have an overview of rubys type system
  • be able to use list processing functions in ruby
  • be able to use blocks and yield in ruby.

1 What is Ruby

Ruby Logo

Ruby is an open source project. It was started in 1996 by Yukihiro 'Matz' Matsumoto. He is still the "benevolent dictator" who decides on the future of the language.

In a colossal break with tradition he did not choose a name starting with p for his scripting language (think perl, python, php) but opted for r instead.

Ruby is a thoroughly object oriented scripting language. Even basic data types are object:

=> "1"

In this example the number 1 is used as an object, the method to_s is called on it. The result is an Object of class String.

1.1 What is ruby on rails

Ruby on Rails Logo

Ruby on Rails is a web framework written in ruby. It was created by David Heinemeier Hansson ('DHH') starting in 2005.

Rails is famous for the high productivity it gives to developers. It is often used in startups, where speed of delivery is very important. Rails moves fast, new versions with major improvement appear about every 18 months. The rails community values speed of development, DRY code, testing, version control, ... when you learn rails you also pick up a whole culture surrounding it.

1.2 Why Ruby? Why Rails ?

Why should you use Ruby and Rails over other programming languages and frameworks?

  • Because you want to be a highly productive web developer?
  • Because you want to learn from the best?
  • Because you want try out many different languages and many frameworks?

All these answers are equally valid.

Also, there are cool t-shirts:

Ruby and Rails T-Shirts

2 Ruby Basics

To get to know ruby you don't need to write whole programes. You can start out with interactive ruby - irb. When you start irb you get a command line to type in ruby code. When you press enter the code is evaluted immediatly and you get the result. Use the commands exit or quit or the key combination CONTROL-D to get out.

In this guide we will show code run in irb by marking the prompt as >> and the result as =>, for example:

>> 2 + 2
=> 4

2.1 Some code conventions

Try to stick to github's style for ruby.

When you chose names for your objects, classes and methods you should stick to the following conventions to avoid confusing other ruby developers:

the_variable =
             # variables are written in snake_case
             # classes in capital CamelCase

             # method names are written in snake_case
a = b.sugar  # a method the returns something
b.sweet?     # a method that returns true or false
             # ends in a question mark
b.sugar!     # a method that changes its object
             # ends in an exclamation mark

In the last to examples the punctuation marks are really part of the method names!

The parantheses around the arguments of a method are optional. Leave them off unless your code get's confusing:

puts("less code")
puts "less code"

Data Types

All of rubys basic data types are Classes.

  • Numeric, Integer, Fixnum, Bignum, Float # are converted automatically to each other
  • Ranges
  • String
  • true # TrueClass
  • false # FalseClass
  • Symbol
  • Array
  • Hash
  • Object
  • Regex

Ruby is strict about data types, there is no automatic conversion except between numeric types.

>> "a string" + "another"
=> "a stringanother"

>> "a string" + 2
TypeError: no implicit conversion of Fixnum into String

>> 42 + 3.141
=> 45.141

2.2 Strings

s = 'just a string of characters'
s = "string with #{the_variable} embedded"
s = "string with #{a+b/c} a ruby expression embedded"
s = <<EOM
This is a so called "Here-Document"
it can contain many lines of text
and ends with the identifier EOM (that i chose!)
but only if it's alone on a line all by itself:

2.3 Boolean Values

In ruby only false and nil are treated as false. This might be confusing for programmers used to other languages with more complex rules for truthyness:

if 0
  puts '0 is true!'
if "false"
  puts '"false" (the string) is not false'       

2.4 Shorthand version of Conditions

The two conditions shown in the last code block only have one statement inside the block.

This can also be written in another way by appending the condition to the statement, like so:

puts '0 is true!' if 0
puts '"false" is not false' if "false"

This syntax should be familiar to you if you understand english. (yes, that's an english sentence using the same syntax).

2.5 Boolean Operators

When ruby evaluates a boolean operator, it does as little work as possible. It stops evaluation as soon as the result is clear:

# the second argument is not evaluated!
a =  true || ...
a = false && ...

The boolean operators don't just return true or false, they return the argument last evaluated. This is often used to set a variable:

default_value = "gray"
input_value = nil
# here input_value might be set...
a = input_value || default_value

2.6 Symbols

A Symbol looks - at first glance - similar to a string: you can invent it at any time (no 'declaration') and give it any name:

a = :foo
a = :bar

s = "foo"
s = "bar"

But: there is always just one instance of a symbol while there can be several strings that have the same content, but are different objects:

>> :foo.object_id
=> 635528
>> :foo.object_id
=> 635528
>> "foo".object_id
=> 70099463087600
>> "foo".object_id
=> 70099463106400

Use symbols where you would enums in a database or another language, or if you need distinct constants, when the value is not important.

2.7 Methods

Methods in ruby return the last expression - even if no explicit return statement is given.

def f(a,b)

f(1,42)  # returns "x"

2.8 Arrays

There are several ways of writing literal arrays in ruby. The first one looks like JSON:

>> a = ["this", "that", "something"]
=> ["this", "that", "something"]

For creating an array of words (strings without whitespace in them) you can use %w:

>> a = %w(this that something)
=> ["this", "that", "something"]

When creating an array of consecutive numbers you can use a Range and convert it to an Array:

>> (1..4).to_a
=> [1, 2, 3, 4]

3 Hashes

A Hash is a datastructure similar to an array. An array uses integers as keys while a Hash allows any type as the keys. Mostly strings and symbols are used:

h =
h["alice"] = "beer"
h["chris"] = "tea"
h["bob"] = "mate"

But you can use other objects:

t =
h[t] = "recently"

The data structure behind a ruby Hash is more complex than an array: The key is sent though a function (called hash function) that returns a number. This number is used as the index for an array. If the hash function for two keys is the same a linked list is built.

How Hash(tabl)es work

This datastructure seems like an serious waste of memory at first. But it offers the following intresting features:

  • looking up a key can be accomplised in constant time
  • inserting a new key / value pair can be accomplised in constant time

Most scripting languages offer Hashes as a basic data type, most compiled languages as a library. Read more about Hashes in Wikipedia:

(If you don't know what "in constant time" means above, you should learn more about the analysis of algorithms. e.g. by taking a algorithms and data strcture course as offered in the second semester of most computer science programs. Or by working through the the book by Bruno R. Preiss).

3.1 Implicit Form

A Hash can be created by using its "implicit form":

roomnumber = { "Jane Doe" => 10, "Jim Doe" => 6 }

Since Ruby 1.9.3 Hashes allow an alternate syntax when the keys are symbols. Instead of

style = { :font_size => 10, :font_family => "Arial" }

you could write this in a JSON-like way:

style = { font_size: 10, font_family: "Arial" }

This style of hash is often used as an argument for a method. Calling the method then reads like named arguments:

def apply_the_style( h )

apply_the_style(font_size: 10, font_family: "Arial")
apply_the_style font_size: 10, font_family: "Arial"

4 Enumerables and Piping Data

When working with a list of values ruby helps you think about data on a new, more abstract level with Enumerables:

4.1 "Piping Data"

From the UNIX shell you may now the concepts of piping data from one command to the next:

# many httpd processes are running. as which user(s) ?
$ ps aux | grep httpd | cut -c1-8 | sort | uniq

Each of those programs reads data from "Standard Input" and writes data to "Standard Output". The vertical bar symbol (called "pipe") takes the output of the preceding program and sends it input the next program. The data in question is plain text, consisting of several lines.

Try it out on your commmand line by building up the pipe step by step:

$ ps aux | less
$ ps aux | grep httpd | less
$ ps aux | grep httpd | cut -c1-8 | less
$ ps aux | grep httpd | cut -c1-8 | sort | less
$ ps aux | grep httpd | cut -c1-8 | sort | uniq | less

4.2 Piping Data in Ruby

When piping data in ruby you can start with an Array

languages = %w[Fortran Ada C C++ Java Scala Haskell]

The elements of the array are piped into the sort-method, which again outputs a list of elements. Theses are piped into first, which only returns the first three and discards the rest. The result is a list of 3 elements.

Here are some simple methods you can use on Arrays (and other Enumerables) that return a new Enumerable. You can connect theses methods to each other:

  • sort
  • first(n)
  • drop(n)
  • last(n)
  • grep(/pattern/)
  • reverse

Some other methods return just a single value, and thus end the pipe:

  • count
  • count("only this exact value")
  • max
  • min

More advanced methods take a Block (of code) as their argument. The method map applys the Block to each piece of data, and returns an Enumerable of the new data:

>> (1..10).map{ |x| 2*x }
=> [2, 4, 6, 8, 10, 12, 14, 16, 18, 20]

>> (1..10).map{ |x| 2*x }.reverse
=> [20, 18, 16, 14, 12, 10, 8, 6, 4, 2]

If the computation is more complex you can write the Block on several lines, ending with end

>> (1..10).map do |x|
?>   x*2
>> end
=> [2, 4, 6, 8, 10, 12, 14, 16, 18, 20]

>> (1..10).map do |x|
?>   x*2
>> end.reverse
=> [20, 18, 16, 14, 12, 10, 8, 6, 4, 2]

Some other methods for Enumerables that take a Block:

  • map {|x| new value computed from x }
  • select {|x| should x be selected? }
  • reduce(:+)
  • reduce{|memo, item| compute new value for memo, using current item }

These methods should help you avoid loops and thus simplify code considerably.

Read the Reference on

5 Blocks

Blocks of code are not just used in Enumerables, they are a basic building block of ruby. You can write functions that take a Block as an argument:

5.1 My Function takes a Block of Code

Any function you write can take an addictional block of code as its last argument. The block is only called if and when you call yield inside the function:

def my_function_with_block_arg
  puts "code in the funtion"
  puts "more code in the function"

my_function_with_block_arg { puts "code in the block" }

# code in the funtion
# code in the block
# more code in the function

Alternate syntax for defining the Block when calling the function:

my_function_with_block_arg do
  puts "code in the block"
  puts "more code in the block"

6 Summary

You now know about the basic data types, about enumerables and about blocks -
features that distinguish ruby from other scripting languages. This should be a good enough basis to start with rails.

But do take every oppertunity you got to learn more about ruby itself: if you are unsure about a line of code, look it up in the ruby documentation and use the opportunity to read a bit more than strictly necessary.

Get an offline version of the documentation installed on your development machine so you can look up stuff instantly.

  • Mac Tool Dash for keeping offline copies of documentation

6.1 Online Resources

6.2 Books