“The time has come…to talk of many [technologies].” –Lewis Carroll(‘The Walrus and the Carpenter’)
Ruby/Rails
Setting Up Rails Development Environment on Windows Vista/XP
191338 days
There are different ways in which you might want to set up a complete development environment for Ruby on Rails on a Windows machine. I am going to cover how to setup Rails on a Windows machine using Ruby, RubyGems, Rails, Mongrel, MySQL, NetBeans and Subversion as part of the development stack. I will be using Windows Vista as the reference OS but most of the instructions work for Windows XP too.
- Installing Ruby: Download and install the latest final version of the Ruby installer(currently 1.8.6) from the rubyforge.net website: One-Click Ruby Installer for Windows
Leave all the default settings as they are and proceed with the installation wizard. It is important that you install Ruby in a path which doesn’t contain any spaces in it(the path c:\ruby selected in the wizard by default works fine).
After the installation is complete, confirm that the ruby commands are added to the system path. Start the Command Prompt(Start -> Accessories -> Command Prompt) and type the following command:
C:\> ruby -v
ruby 1.8.6 (2007-09-24 patchlevel 111) [i386-mswin32]
C:\> gem -v
0.9.4If you get the “not recognized as an internal or external command” error, add the path to the ruby bin directory(e.g. c:\ruby\bin) to the system PATH environment variable(Control Panel -> System -> Advanced System Settings).
- Updating RubyGems:
The above installer also installs RubyGems package and SciTE editor as part of the “one-click” installation process. Unfortunately though, the installed version of RubyGems may be a bit old(~0.9.4), so run the following command to update it to the latest available version(currently 1.1.1):C:\> gem update ––system
C:\> gem -v
1.1.1Note: Add “-p http://proxy:port” to all gem install commands if you are connecting to the Internet through a proxy.
- Installing Rails:
Now it is time to install the Rails package. Run the following command to install Rails as a ruby gem:C:\> gem install rails
C:\> rails -v
2.1.0In future, whenever you want to update Rails to a newer version, simply run the following command:
C:\> gem update rails
The basic Rails development environment is now installed on your system and you can skip the rest of the post if you are happy with WEBrick as the web server, SQLite as the database server and SciTE as the editor(or your favourite text editor/IDE already installed on your system). The following instructions cover installing an alternate web server called Mongrel; MySQL database server and its GUI tools; NetBeans IDE, Subversion and their integration.
- Installing Mongrel:
Installing the Rails gem also installs the WEBrick web server which is ideally suited for development purposes. Another much recommended web server for Rails development as well as production environment is the Mongrel web server. To install the Mongrel web server, run the following gem command:C:\> gem install mongrel
C:\> gem list mongrel*** LOCAL GEMS ***
mongrel (1.1.5)
After installing Mongrel, Rails automatically starts the Mongrel instead of WEBrick web server when you run the Rails applications in development mode. (Refer to Mongrel documentation to know more about runing Rails applications under Mongrel in production mode.)
- Installing MySQL:
This step covers the installation of MySQL database server and its GUI tools. Skip this step if you want to use some other database server.Download and install the MySQL 5 database server. You can safely accept all the default settings of the installation wizard. After MySQL database server is installed, you need to run its configuration wizard to configure the MySQL installation.
- If you are a Windows XP user, run the configuration wizard directly from Start -> MySQL -> MySQL Server 5.0 -> MySQL Server Instance Config Wizard.
- If you are a Windows Vista user, you first need to patch the configuration wizard before running it. Follow these instructions to patch the MySQL configuration executable using ResHack utility. Once that is done, you can run the configuration wizard from Start -> MySQL -> MySQL Server 5.0 -> MySQL Server Instance Config Wizard.
One important step during the configuration process is to select a root password(you will need to enter it in the database.yml configuration file of your Rails application).
Now download and install the MySQL GUI tools. This step can be skipped if you want to use mysql command line tools or if you prefer other GUI front-ends like HeidiSQL.
- Installing Netbeans:
You can use your favourite text editor or IDE to code your Rails application. Two of the most popular, Free Rails IDEs are NetBeans and Eclipse. NetBeans in particular has shown great improvement in its support for Ruby programming language and the Rails framework. I am going to cover configuring Netbeans for developing applications with Rails, so feel free to skip this step if you want to go with some other IDE(Aptana, IntelliJ IDEA etc.).Go to the download page of Netbeans IDE and download either the “Ruby” version(~29MB) or the “All” version(~219MB). (Ruby version supports only Ruby where as the All version supports Java, C++, etc. in addition to Ruby.)
Install NetBeans. Run it. When creating a new Rails project in NetBeans, remember to select “Ruby” as the default instead of the default “JRuby” and then select Mongrel as the web server.
For more information on developing Ruby on Rails applications using the NetBeans IDE, refer to the following links:
There are many alternative IDEs that you can checkout, like Aptana Studio, Komodo, IntelliJ IDEA, etc.
- Installing Subversion:
Go to the Subversion download page, scroll down to the Windows section and click the “Win32 packages built against Apache 2.2″ link and download and install the ‘basic win32 binaries’ package.
You can now work with the Rails applications stored in subversion repositories. You can also install and use TortoiseSVN which is a GUI subversion client that integrates very well with the Windows Explorer. I couldn’t find a way to integrated it with NetBeans though, so I install the subversion command line version to use with NetBeans even if I have TortoiseSVN installed on my system.
- Configuring Subversion in NetBeans:
Start the NetBeans IDE and go to Versioning -> Subversion -> Checkout. If you see a dialog box as shown in the screenshot below, it means subversion is properly installed and configured on your system. You can enter the repository details in the fields shown by the wizard, checkout a Rails application and work on it from the NetBeans IDE.
(If you see an error instead, then you need to either add the subversion bin directory to the system PATH variable or enter the path in the shown NetBeans configuration window.)
NetBeans has direct support for CVS, Subversion and Mercurial and NetBeans support for Git is currently under development.
Now you can create/checkout rails applications, edit them and run them under Mongrel from within the NetBeans IDE. One crucial item missing from this development environment is an alternative, more powerful automated build tool CruiseControl, which can also be integrated with NetBeans. Perhaps a topic for another post. In the next post I will explain how to create a basic “Hello World” application in Rails using the above development tools.
Programming in Ruby Using SciTE – Windows Issues and Other Tips
01577 days
by tabrez
in Ruby/Rails
Couple of comments(by Mihail and Jonathan) on my earlier post about programming in Ruby using SciTE editor brought this to my notice: When using SciTE to develop Ruby programs on Windows platform, there are a few issues that one needs to be aware of.
- To run the ruby interactive interpreter (or any other ruby command-line tool) from within SciTE editor on Windows, use full file name of the command, like irb.bat. If not already visible, open the output pane from View -> Output and type irb.bat in it. You should be dropped in the ruby shell; type ‘exit’ to exit the shell. You can any ruby command in this way, e.g. irb.bat, ri.bat. You can also run windows commands that are in the system path in the same way.
- When you run a Ruby program either using Tools -> Go menu item or using F5 key command, SciTE spawns a shell process to run ruby.exe in it. This may result in a DOS box popping up when you run a ruby program. You never will have to deal with this DOS command window directly, if it comes in your way, just minimize it and go back to the SciTE editor. All the output will be visible in the output window(View -> Output if it is not visible) and any input needed by your Ruby program should also be entered in the same output window. To reduce such confusion, it is always a good practice to print a prompt string whenever reading input from the user; if such a prompt string shouldn’t be a part of the interface, keep it anyway in the development version:
[ruby]
print “Enter a number between 5 and 55:”; STDOUT.flush
num = gets.to_i
[/ruby]
Adding a Menu Entry to Invoke irb Command
If you use the Ruby interactive shell frequently and don’t want to type seven characters each time you want to invoke it, then create a menu entry/keyboard shortcut for it. To do this, open the Ruby properties file by selecting Options -> Open ruby.properties menu item and search for Windows-specific settings(PLAT_WIN section).
Add the following lines in that section:
command.name.0.*.rb=irb
command.0.*.rb=irb.bat
command.is.filter.0.*.rb=1
command.0.subsystem.*.rb=1
Use another number in place of ’0′ if you have already bound it to something else. The first line(command.name.0) defines the name to be used in as the menu entry. The second line(command.0) defines the command to be invoked when this menu entry is selected. A value of ’1′ in the third line(command.is.filter.0) indicates to SciTE that the command may modify the contents of the current file(file is reloaded based on the value of load.on.activate setting).
The section in the properties file should look like this:
You can now invoke irb from Tools -> irb or by using Ctrl-0 key command. Note that this menu item will be visible only when editing .rb files. Ctrl-F6 will switch you between the file pane and the output pane.
What about GNU/Linux?
You can add a similar section in PLAT_GTK section if you are using SciTE on GNU/Linux platform, but use irb in the second line in place of irb.bat:
command.name.0.*.rb=irb
command.0.*.rb=irb
command.is.filter.0.*.rb=1
command.0.subsystem.*.rb=1
Add menu items to other frequently used commands in the same way(even links to help documents). For more information, refer to help document available from Help -> SciTE Help.
Develop Ruby Applications Using Vim 7.0 Editor
141964 days
I know that the geeks amongst you would like to believe that only one text editor program exists in this world. Depending on which of the two groups you fall into, its either Emacs or Vi. Its a cool life for such people: they don’t need to bother checking out the greatest and the latest of the development environments getting released in the market every day. Emacs and Vi always grow up to become the greatest editors soon after every technological innovation that takes place in the software world. They are stable, powerful, feature-rich, modular, customisable, extendable, ubiquitous and available in multiple flavours to suit the slightly different tastes even by the geek standards. The only downside of these two evergreen editors is the steep learning curve associated with them. But as with all great things, it more than pays off by the end.
In this article, we’ll witness the support for the Ruby language present in the latest version of the Vim editor – Vim 7. If the latest version of Vim is not available on your preferred distribution(through its package manager, for example), then you can build it from the source, and install it in the user home directory if you don’t want to mess up with the file organization of your package manager. Here is the procedure to install Vim 7.0 from the sources in the user’s home directory. If you already have it installed, then skip to the next section.
- Download the source package for Vim 7.0 editor.
- Extract it in the home directory and ‘cd’ into it:
sh# tar xvjf vim-7.0.tar.bz2
sh# cd vim70 - Install using the usual method for building from the source:
sh# mkdir $HOME/vim7
sh# ./configure –prefix=$HOME/vim7 –enable-rubyinterp
sh# make && make installMake sure that you run the above commands as an unprivileged user(non-root) so that the generated files get proper file ownerships. (Run the above commands as root and drop the ‘–prefix’ option to install it in system directories and make it available to all the users.)
-
Now you can run the editor by running the command ‘./vim’ from the ~/vim7/bin directory. The procedure to run the vi editor can be simplified using one of the following techniques:
- Add the ‘bin’ directory of Vim installation(~/vim70/bin in our case) to $PATH variable in the user’s profile(~/.bash_profile).
- As root user, create links to all the executables present in ~/vim7/bin directory into the /usr/bin directory under different names(vim7, vimdiff7 etc so as not to conflict with the files from a possibly already existing Vim installation) and then run them from anywhere using these new names.
- If you have installed it in the system directories, then of course you don’t have to worry about all these settings and can directly run the editor using the ‘vim’ command from any directory.
Configuring Vim 7.0 For Ruby Support
The first step that we had taken to get Ruby support in the Vim editor was to compile it using the ‘–enable-rubyinterp’ configure option. To get complete support for the Ruby programming language in the Vim editor, we need to add the following lines to the Vim configuration file .vimrc present in the home directory.
[Create it if it's not already there; an easy way to do this is to make a copy the sample vimrc file that comes with Vim 7.0, i.e.
sh# cp /home/user/vim7/share/vimrc_example.vim /home/user/.vimrc
Then add the following lines at the bottom of the .vimrc file]
set nocompatible
syntax on
filetype on
filetype indent on
filetype plugin on
Creating & Running Ruby Programs Using Vim 7.0
Now you are set to create your first Ruby program in the Vim editor.
sh# cd ~/vim7/bin
sh# mkdir -p ~/progs/ruby
sh# ./vim ~/progs/ruby/first.rb
sh# mkdir -p ~/progs/ruby
sh# ./vim ~/progs/ruby/first.rb
Type the following program in the editor.
[ruby]
class Greeting
def say(name)
puts “Hello, #{name}”
end
def shout(name)
puts “HELLOOOOOOO, #{name}”
def
end
greet = Greeting.new
greet.say(“Marc”)
[/ruby]
The editor should now look like this:
Apart from the neat syntax colouring that is visible in the picture, the Vim editor also does automatic code indentation and helps in code completion too. You can even run the programs from within the editor. Let us see how to access these features in Vim.
Add one more method(optional) to the ‘Greeting’ class that we had created earlier and name it something starting with ‘s’. I have added a function called ‘stash()’. Go to the end of the Ruby program and type ‘greet.s’ and stop – don’t complete the function name. If you press the key combination Ctrl-X Ctrl-O at this stage, Vim will pop-up a list of possible completions of the code that you have typed until now and lets you select one of those options. Below is a picture demonstrating the same.
To run the Ruby program from the Vim editor, let’s first introduce a small mistake in it: change the code from ‘Greeting.new’ to ‘Greeting.ne’ and issue the following command in the vi command mode(presss the escape key and type the following line):
:rubyf ~/progs/ruby/greet.rb
You should see the following error message displayed at the bottom of the Vim screen.
Now go back to the program and remove the error that we had introduced and re-execute the program. You should see the output of the program as shown below.
For more help on the Ruby support in the Vim editor, issue the “:help ruby” command and scroll through the information displayed.
End Notes
The biggest advantage of developing Ruby programs using the Vim editor is that one gets all the powerful features of the vi editor which we have been using for years and have completely gotten used to. If you are searching for an easy to learn and easy to use programming editor, then perhaps you need to search elsewhere(see links below for some options) but if you are primarily a vi user, or don’t mind investing some time initially to get used to this powerful editor, then the Ruby support available in it should make it an ideal choice for developing Ruby programs.
Develop Ruby Applications Using JEdit Editor
21973 days
The JEdit editor today is among the most widely used programming editors. The editor has a very strong and committed developer & user community around it, which means an ever increasing number of features and its constantly improving stability. Today, it has enough number of features to compete with some of the best programming IDEs around. As is expected of a popular editor like JEdit, it has support for multiple programming languages(100+; eg: C++, Java, PHP, Ruby etc) and works on Windows, Mac OSX and GNU/Linux platforms. In this part of the “IDEs for Ruby Development” series, I discuss how to use JEdit editor to develop Ruby programs.
(Screenshots are taken in the GNU/Linux OS; same features are available on other platforms too.)
Download And Install JEdit Editor
Download the appropriate version of the JEdit package from the JEdit Download Page(the page also contains links to JEdit User Manual and JEdit Source Code).
JEdit depends on the Java Runtime Environment(JRE) to execute – make sure that Java is installed on your system before installing JEdit. Its straigh-forward to install JEdit on Windows and Mac OSX operating systems.
If you are a Gentoo user, the following command should download and install the latest version of JEdit available in the Gentoo portage tree:
sh# emerge jedit
On a Debian/Ubuntu system, add the following line to the ‘/etc/apt/sources.list’ file:
deb http://dl.sourceforge.net/sourceforge/jedit ./
Now running the following two commands will install the JEdit package:
sh# apt-get update
sh# apt-get install jedit
sh# apt-get install jedit
(Use ‘sudo’ in front of all the commands if you are an Ubuntu user.)
You can use similar software package management tools to install JEdit on other GNU/Linux distributions(yum for Fedora, yast for SUSE etc) or install it using the RPM files. The application can be installed by building it from the source too.
Once the JEdit package is installed on your system, its time to install the plugin for the Ruby language.
Installing Ruby plugin for JEdit
Since the 0.8 version of the Ruby plugin for JEdit, it can be installed right from the JEdit editor. To install the plugin, start the JEdit editor, go to Plugins -> Plugin Manager menu, and click on the “Install” tab of the displayed dialog box. Wait for the dialog to fetch a list of all the plugins available for download and installation(you can view the list of plugins available for JEdit once it is downloaded and displayed in the dialog box, or you can also view a partial list of the plugins at the JEdit Quick Start page).
Once the table in the dialog box is filled with the available plugins, scroll down and search for the “RubyPlugin” entry and select it when found. Click “Install” to begin the download and installation process.
Develop Ruby Applications With JEdit
Once the plugin is installed, you are set to create Ruby applications in the JEdit editor environment. Some of the important feature that the Ruby plugin adds to the JEdit are code completion for methods, syntax error highlighting, automatic code indentation and integrated Ruby documentation. The plugin also adds the support to popup a window in which the user can browse the entire file structure of the Ruby program. The plugin is a work in progress and many more helpful features can be expected in the near future. RubyJedit.org website contains screenshots demonstrating some of the above mentioned features. Some more screenshots(related to integrated Ruby documentation in JEdit) follow.
JEdit is an excellent editor for editing programming code even without the Ruby plugin(Splitting and Docking Windows; Expanding and Collapsing Code Blocks); the plugin then adds sufficient Ruby specific functionality on top of it to make it one of the most feature-rich programming environments available today. For more ways to enhance the functionality of the JEdit editor, look at the other plugins available for installation in the Plugin Manager. The only downside of this editor is its sluggish behaviour especially when a lot of plugins are installed for it. Its load times become long and the general response afterwards won’t be too fast either. But with limited number of plugins, its an excellent choice to develop Ruby applications.
In the next and the last part of this “IDEs for Ruby Development” series, I will discuss using the ever popular Emacs and Vim editors to develop Ruby applications.
Develop Ruby Applications Using SciTE Editor
131988 days
In the first and second parts of the series “Popular IDEs For Ruby Development”, I have mentioned two of the excellent IDEs available for developing Ruby applications:
1. Ruby Development With Eclipse IDE
2. Ruby Development With Komodo IDE
Though these IDEs boast of a large number of useful features to help developers achieve higher productivity levels, some people might find the very same features to be needless quirks that come in the way of the software development. For all the programmers who swear by the rich functionality provided by an IDE like Eclipse, an equal number of programmers feel more comfortable and more productive with simple but elegant, fast to load editors like Emacs and Vi. One such popular editor which has got inbuilt support for the Ruby programming language is SciTE. I will discuss Ruby program development with the SciTE editor in this post; Ruby development with Emacs and Vim will be the topic of the next post in this series.
SciTE is actually one of my favourite editors to develop Ruby programs. The reasons are very basic: it’s light-weight, it’s fast, it has out-of the box support for the Ruby language(no plugins as in Eclipse or editing modes as in Emacs are needed to be installed) and it runs on multiple platforms including Windows and GNU/Linux. It also has got excellent support for the other programming languages(more than 40!) like C/C++, Java, Perl, Python and PHP. And of course its free in every sense of the word.
Open the SciTE editor from the system menu or from the command line, create a new file and save the file with .rb extension; the editor will automatically switch to the Ruby mode and will do the appropriate syntax highlighting for the code. The Ruby language can also be explicitly selected for the program currently being edited, by selecting Language->Ruby menu item.
Once the editing is complete, the Ruby program can be executed by selecting the menu item Tools -> Go or by pressing the F5 key.
A new pane will be opened on the right side of the window to run the script and it will show if any errors are present in the program, or the output of the program otherwise.
Once all the errors in the program are fixed, pressing the F5 key will show the output of the program in the right pane.
With fast load times, support for syntax highlighting and code indentation, ruby interpreter and ruby interactive shell being supported from within the editor, SciTE provides an excellent environment for Ruby application development. It doesn’t end here though; SciTE also allows a lot of customisations to be done to the programming environment according to the tastes of the programmers. To affect the global settings of the editor that apply to the settings of all the programming languages(not just Ruby), select Options -> Open Global Options File menu item.
As an example, scroll down to around line 100(View -> Line Numbers to view the line numbers) and search for a property called “tabsize” and change it to 4(or whatever you prefer). Or scroll down roughly to the line number 300 and increase/decrease the font size by editing font.base property(under your platform):
Settings specific to the Ruby mode can be customised by going to Options -> Edit Properties -> Open ruby.properties.
You will see a similar list of properties that were present in the global properties file and the values of specific properties can be edited in the same way.
Ruby interactive shell can also be used from within the SciTE editor to test simple Ruby expression before using them in the programs. Just place the cursor in the right pane(output window; go to View -> Output if it is already not visible), type the command ‘irb’ and press the ENTER key. You will be dropped to an irb shell where you can experiment with various Ruby expressions.
I prefer to work with the SciTE editor(not just for Ruby) for various reasons pointed out earlier in this post. Most important of them all are that its available for both Windows and GNU/Linux(it looks and works the same way in both these OSes) and it supports most of the programming languages that I use. If you open a lot of different files for editing during one marathon editing session, you can save the state for later retrieval by saving and loading the sessions. The program files can also be exported to different document formats like PDF, RTF, HTML etc(from File -> Export menu). If you are searching for a light-weight, fast, multi-platform programming editor, then SciTE will be a great option to consider.
Recent Comments