Know your Rails command line tools

In a keynote at last week’s Ruby Midwest conference in Kansas City, Rails core contributor Yehuda Katz talked about the attention the Rails team puts into the experience of the developer. A large part of this experience is the command line, and Yehuda pointed to the efforts that have been put into making sure that interface to Rails and the software you write with it is as useful as possible. The goal is to keep you from having to refer to a manual or stack trace as little as possible.

If Rails is your first real exposure to the command line—and I know a few people for whom this is true—you may think that command lines aren’t what we use to interact with computers anymore (especially on Macs). With a bit of practice, though, you may discover that the command line is a much quicker and more powerful way to get things done on your computer than a graphical interface and a mouse. Here are some resources to get you started with the command line in Rails.

The basics

• RailsGuides has documentation on the Rails 2.3 command line and the Rails 3 command line. As usual with RailsGuides, these are very thorough and well-written.
• The Rails 3 screencast series has a good video outlining what’s new in the Rails 3 command line. In particular, there are new flags to rails when setting up your application, and changes to the contents of the script/ directory in a Rails application.

Generators

Rails has default generators like scaffold, model and the like; various gems and plugins add generators of their own to help you quickly get your applications up and running. See the RailsGuides above for the defaults and the documentation of your installed gems and plugins for what they provide.

For Rails 2.3:

• Pat Shaughnessy has a good writeup on writing generators (see also part two).
• Railscasts has an episode on creating your own generators

When it comes to generators, everything changes in Rails 3.

• Ryan Bates covers the changes to generators in Rails 3 in Railscasts;
• He’s also got an episode on writing generators in Rails 3
• Ben Scofield has written a good series on Rails 3 generators that gives a line-by-line comparison of the Rails 2 way to the Rails 3 way of using generators—see the standard generators, some less common generators like mailers, helpers, and observers, some more testing-specific generators.

Rake

Rake, Ruby’s build tool, is essential to Rails development. Rake is discussed in the RailsGuides referenced above. You’re not limited to the tasks Rails provides—the gems and plugins your app uses may add tasks, and you can create your own.

• Type rake -T to view the tasks you have access to within your application.
• This Railscasts episode on writing your own Rake tasks is essential viewing.
• Jason Siefer has also written a good guide to writing Rake tasks.

Unix

These last links aren’t specific to Rails, but a general grasp of the Unix command line is going to make your life as a Rails developer much easier, and can help you get other things done on your computer that are cumbersome (or impossible) via a graphical interface. Seriously, if you’re using a Mac or Linux-based computer, learn the command line.

• The Unix/Linux tutorial for beginners is a good start, especially if the day you installed Rails was the first time you’d opened Terminal.
• Here’s a summary of Unix commands for quick reference.

Discussion