module Rake::DSL

Private Instance Methods

desc(description) click to toggle source

Describe the next rake task.

Example:

desc "Run the Unit Tests"
task :test => [:build]
  runtests
end
    # File lib/rake/dsl_definition.rb
117 def desc(description)
118   Rake.application.last_description = description
119 end
directory(dir) click to toggle source

Declare a set of files tasks to create the given directories on demand.

Example:

directory "testdata/doc"
   # File lib/rake/dsl_definition.rb
58 def directory(dir)
59   Rake.each_dir_parent(dir) do |d|
60     file_create d do |t|
61       mkdir_p t.name if ! File.exist?(t.name)
62     end
63   end
64 end
file(*args, &block) click to toggle source

Declare a file task.

Example:

 file "config.cfg" => ["config.template"] do
   open("config.cfg", "w") do |outfile|
     open("config.template") do |infile|
       while line = infile.gets
         outfile.puts line
       end
     end
   end
end
   # File lib/rake/dsl_definition.rb
42 def file(*args, &block)
43   Rake::FileTask.define_task(*args, &block)
44 end
file_create(args, &block) click to toggle source

Declare a file creation task. (Mainly used for the directory command).

   # File lib/rake/dsl_definition.rb
48 def file_create(args, &block)
49   Rake::FileCreationTask.define_task(args, &block)
50 end
import(*fns) click to toggle source

Import the partial Rakefiles fn. Imported files are loaded after the current file is completely loaded. This allows the import statement to appear anywhere in the importing file, and yet allowing the imported files to depend on objects defined in the importing file.

A common use of the import statement is to include files containing dependency declarations.

See also the –rakelibdir command line option.

Example:

import ".depend", "my_rules"
    # File lib/rake/dsl_definition.rb
135 def import(*fns)
136   fns.each do |fn|
137     Rake.application.add_import(fn)
138   end
139 end
multitask(args, &block) click to toggle source

Declare a task that performs its prerequisites in parallel. Multitasks does not guarantee that its prerequisites will execute in any given order (which is obvious when you think about it)

Example:

multitask :deploy => [:deploy_gem, :deploy_rdoc]
   # File lib/rake/dsl_definition.rb
74 def multitask(args, &block)
75   Rake::MultiTask.define_task(args, &block)
76 end
namespace(name=nil, &block) click to toggle source

Create a new rake namespace and use it for evaluating the given block. Returns a NameSpace object that can be used to lookup tasks defined in the namespace.

E.g.

ns = namespace "nested" do
  task :run
end
task_run = ns[:run] # find :run in the given namespace.
   # File lib/rake/dsl_definition.rb
89 def namespace(name=nil, &block)
90   name = name.to_s if name.kind_of?(Symbol)
91   name = name.to_str if name.respond_to?(:to_str)
92   unless name.kind_of?(String) || name.nil?
93     raise ArgumentError, "Expected a String or Symbol for a namespace name"
94   end
95   Rake.application.in_namespace(name, &block)
96 end
rule(*args, &block) click to toggle source

Declare a rule for auto-tasks.

Example:

rule '.o' => '.c' do |t|
  sh %{cc -o #{t.name} #{t.source}}
end
    # File lib/rake/dsl_definition.rb
105 def rule(*args, &block)
106   Rake::Task.create_rule(*args, &block)
107 end
task(*args, &block) click to toggle source

Declare a basic task.

Example:

task :clobber => [:clean] do
  rm_rf "html"
end
   # File lib/rake/dsl_definition.rb
24 def task(*args, &block)
25   Rake::Task.define_task(*args, &block)
26 end