This is a tutorial of how to compile and use RPProj on windows.

Table of Contents

1. General stuff
2. Installing the dependencies
   1. Installing Ruby and Rubygems
   2. Installing Mechanize and its dependencies
   3. Installing QtRuby4
3. Start RPProj

General stuff

RPProj stands for RPdev Project Management and is a desktop client which gives us the possibility to interact with the Drupal project management system, so that we do not need to visit the website itself.

It is written in Ruby using a bunch of other handy tools like Mechnize or Nokogiri. It also uses with Qt, and so we have to install all these dependencies first.

Installing the dependencies

Installing Ruby and Rubygems

First, install Ruby and the Rubygems. I recommend using Cygwin, as it has some advantages (as you'll see later). However, you can fetch all dependencies yourself, too.
Make sure, the path to the "ruby" executable is in your PATH. Test it by opening a command line and typing "ruby --version" (should print Ruby's version if everything is installed correctly).

Now, download the Rubygems. Unpack the archive and in a terminal window, navigate there. Type

This will install the Rubygems. Make also sure, that the executable "gem" in in your PATH (Again, in a terminal type "gem". It will complain if gem is not in your PATH.)

Installing Mechanize and its dependencies

In a terminal window, type in the following commands:

This will install Racc, Nokogiri and Mechanize. If you get errors in one of the steps, you probably miss some dependencies. Gem compiles some native bindings, so make sure, the following libraries and their header files are installed and available to gem:

• libxml2
• libxslt
• iconv

You will obviously also need the GNU C++ compiler (gcc-g++). If you are using Cygwin, all these dependencies can be installed easily with the Cygwin installer. Just make sure you tick the libraries and development packages (e.g. libxml2 and libxml2-devel).

Installing QtRuby4

First, install Rake:

Now, download the Qt4 Bindings ("QtRuby4"). More concrete, you'll need the Rubygem file (qtruby4-$VERSION-$ARCH-mswin32.gem). Download it and in a terminal, navigate there. Install it via

Start RPProj

Thats as easy as the stuff before. Open the shell and type in the following.

After a while a little window should pop up. And there you go ;)

Encoding errors: If you get encoding errors (e.g. when using German umlauts in your username or password) start RPProj passing these additional arguments to Ruby: