Workshop Requirements

This session is a workshop. Please come prepared.

JRuby Workshop Setup

Java

• Have Java 1.6+ installed

• To check this simply fire up a command line prompt and run java -version. This is what shows up on my computer

  $ java -version
  java version “1.6.0_31”
  Java™ SE Runtime Environment (build 1.6.0_31-b04-415-11M3635)
  Java HotSpot™ 64-Bit Server VM (build 20.6-b01-415, mixed mode)

• If you don't have Java installed (or pre 1.6) you can download it here

• Make sure to run java -version on the command line after installation to make sure that you PATH is set up correctly

JRuby

• You can download JRuby here

• NOTE - JRuby 1.7 can leverage some of the newer JVM instructions such as invokeDynamic so it works best with Java 1.7. For this workshop JRuby 1.6.7.2 will also work.

• After installation, fire up a command prompt and run jruby -v to make sure that your PATH is set up correctly. This is what shows up on my computer

  $ jruby -v
  Listening for transport dt_socket at address: 5005
  jruby 1.6.5.1 (ruby-1.9.2-p136) (2011-12-27 1bf37c2) (Java HotSpot™ 64-Bit Server VM 1.6.0_31) [darwin-x86_64-java]

• Note that it says ruby-1.9.2 as the Ruby version it is using.

• If it does not say ruby-1.9.2 try export JRUBY_OPTS="--1.9" on your command line and then try jruby -v again. This will force JRuby to be Ruby 1.9 compatible.

RVM or rbenv Users (Mac OSX only)

• You can follow the instructions here to install JRuby alongside any other Rubies you might have installed.
• Once again, if running jruby -v does not show it as using Ruby 1.9 then try export JRUBY_OPTS="--1.9" and run jruby -v again.

Editor

• Have any editor installed that you like, and that preferably understands Ruby syntax. Here are a few options (I am personally inclined to - SublimeText and emacs - Both work across all operating systems)
  • Sublime Text [Highly recommended]
  • Emacs (For all OSes), AquaEmacs (Mac OSX only) - Here is another download site for emacs on Mac OSX
  • Notepad++ (for Windows)

Directory setup

• Create a directory called jRubyWorkshop (or something like that) somewhere on your computer. Avoid white space in your directory path if you can. C:\jRubyWorkshop is preferable to say C:\Documents and Settings\jRubyWorkshop. For Mac and Linux users anything under your home directory will work.

• cd to the newly created directory, and create a new file called test_jruby_install.rb. Open it in your favorite text editor and type in the following line

  puts “You have JRuby working with #{RUBY_VERSION}. Woohoo!!”

• Save the file, go back to the command line, make sure you are in the right directory, and run jruby test_jruby_install.rb. You should see

You have JRuby working with 1.9.2. Woohoo!!

• You can delete this file if you wish.

• Now, within the jRubyWorkshop directory, create a lib directory, and a src directory.

• This is what your tree should look like

  .

  • jRubyWorkshop/
    • lib/
    • src/

iText

• Awesome. We are almost done. Download iText jar from here, unzip it and put the itextpdf-5.2.1.jar file in your newly created lib directory under the jRubyWorkshop directory.

Feeling ambitious?

• If you feel like playing around with Ruby prior to coming to the workshop, head over to tryruby.org - It only takes 15 mins :)

Done! Now you are all set for our workshop. Hope to see you guys soon!