02 -- Command Line Invocation

Chapter 2—Command Line Invocation

Usage

Rake is invoked from the command line using:

% rake [options ...]  [VAR=VALUE]  [targets ...]

Options are:

name=value

Set the environment variable name to value during the execution of the rake command. You can access the value by using ENV[‘name‘].

—classic-namespace (-C)

Put Task and FileTask in the top level namespace

—dry-run (-n)

Do a dry run. Print the tasks invoked and executed, but do not actually execute any of the actions.

—help (-H)

Display some help text and exit.

—libdir directory (-I)

Add directory to the list of directories searched for require.

—nosearch (-N)

Do not search for a Rakefile in parent directories.

—prereqs (-P)

Display a list of all tasks and their immediate prerequisites.

—quiet (-q)

Do not echo commands from FileUtils.

—rakefile filename (-f)

Use filename as the name of the rakefile. The default rakefile names are rakefile and Rakefile (with rakefile taking precedence). If the rakefile is not found in the current directory, rake will search parent directories for a match. The directory where the Rakefile is found will become the current directory for the actions executed in the Rakefile.

—require name (-r)

Require name before executing the Rakefile.

—tasks (-T)

Display a list of the major tasks and their comments. Comments are defined using the “desc” command.

—trace (-t)

Turn on invoke/execute tracing. Also enable full backtrace on errors.

—usage (-h)

Display a usage message and exit.

—verbose (-v)

Echo the Sys commands to standard output.

—version (-V)

Display the program version and exit.