123456789_123456789_123456789_123456789_123456789_

Module: Rake::DSL

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Extended In:
::self
Included In:
MakefileLoader, PackageTask, Rake::RubyForgePublisher, SshDirPublisher, SshFilePublisher, SshFreshDirPublisher, TaskLib, TestTask
Super Chains via Extension / Inclusion / Inheritance
Instance Chain:
self, FileUtilsExt, ::FileUtils
Defined in: lib/rake/dsl_definition.rb

Overview

DSL is a module that provides #task, #desc, #namespace, etc. Use this when you'd like to use rake outside the top level scope.

For a Rakefile you run from the comamnd line this module is automatically included.

Constant Summary

::FileUtils - Included

LN_SUPPORTED, RUBY

FileUtilsExt - Included

DEFAULT

Instance Method Summary

FileUtilsExt - Included

#nowrite

Get/set the nowrite flag controlling output from the ::FileUtils utilities.
#rake_check_options

Check that the options do not contain options not listed in optdecl.
#rake_merge_option

Merge the given options with the default values.
#rake_output_message

Send the message to the default rake output (which is $stderr).
#verbose

Get/set the verbose flag controlling output from the ::FileUtils utilities.
#when_writing

Use this function to prevent potentially destructive ruby code from running when the :nowrite flag is set.

::FileUtils - Included

#ruby

Run a Ruby interpreter with the given arguments.
#safe_ln

Attempt to do a normal file link, but fall back to a copy if the link fails.
#sh

Run the system command cmd.
#split_all

Split a file path into individual directory names.

Instance Method Details

#desc(description) (private)

Describes the next rake task. Duplicate descriptions are discarded. Descriptions are shown with rake -T (up to the first sentence) and rake -D (the entire description).

Example:

desc "Run the Unit Tests"
task test: [:build]
  # ... run tests
end
[ GitHub ] 

  


# File 'lib/rake/dsl_definition.rb', line 171



def desc(description) # :doc:
  Rake.application.last_description = description
end


  








  

    #directory(*args, &block)   (private)
  



  

    

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



Example:



directory "testdata/doc"


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 98



def directory(*args, &block) # :doc:
  result = file_create(*args, &block)
  dir, _ = *Rake.application.resolve_args(args)
  dir = Rake.from_pathname(dir)
  Rake.each_dir_parent(dir) do |d|
    file_create d do |t|
      mkdir_p t.name unless File.exist?(t.name)
    end
  end
  result
end


  








  

    #file(*args, &block)   (private)
  



  

    

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


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 82



def file(*args, &block) # :doc:
  Rake::FileTask.define_task(*args, &block)
end


  








  

    #file_create(*args, &block)   (private)
  



  

    

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


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 88



def file_create(*args, &block)
  Rake::FileCreationTask.define_task(*args, &block)
end


  








  

    #import(*fns)   (private)
  



  

    

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"


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 189



def import(*fns) # :doc:
  fns.each do |fn|
    Rake.application.add_import(fn)
  end
end


  








  

    #multitask(*args, &block)   (private)
  



  

    

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: %w[deploy_gem deploy_rdoc]


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 118



def multitask(*args, &block) # :doc:
  Rake::MultiTask.define_task(*args, &block)
end


  








  

    #namespace(name = nil, &block)   (private)
  



  

    

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.



Example:



ns = namespace "nested" do
  # the "nested:run" task
  task :run
end
task_run = ns[:run] # find :run in the given namespace.



Tasks can also be defined in a namespace by using a “:” in the task name:



task "nested:test" do
  # ...
end


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 141



def namespace(name=nil, &block) # :doc:
  name = name.to_s if name.kind_of?(Symbol)
  name = name.to_str if name.respond_to?(:to_str)
  unless name.kind_of?(String) || name.nil?
    raise ArgumentError, "Expected a String or Symbol for a namespace name"
  end
  Rake.application.in_namespace(name, &block)
end


  








  

    #rule(*args, &block)   (private)
  



  

    

Declare a rule for auto-tasks.



Example:



rule '.o' => '.c' do |t|
  sh 'cc', '-o', t.name, t.source
end


  



  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 157



def rule(*args, &block) # :doc:
  Rake::Task.create_rule(*args, &block)
end


  








  

    

      #task(task_name)   (private)
      #task(task_name: dependencies)  
      #task(task_name, arguments)  ⇒ dependencies 
      #task(task_name, argument[, argument ...], :needs: dependencies)  
    

  



  

    

Declare a basic task.  The task_name is always the first argument.  If the task name contains a “:” it is defined in that namespace.



The dependencies may be a single task name or an Array of task names. The argument (a single name) or arguments (an Array of names) define the arguments provided to the task.



The task, argument and dependency names may be either symbols or strings.



A task with a single dependency:



task clobber: %w[clean] do
  rm_rf "html"
end



A task with an argument and a dependency:



task :package, [:version] => :test do |t, args|
  # ...
end



To invoke this task from the command line:



$ rake package[1.2.3]



Alternate definition:



task :package, :version, needs: :test do |t, args|
  # ...
end


  





  


  [ GitHub ]


  

  


# File 'lib/rake/dsl_definition.rb', line 65



def task(*args, &block) # :doc:
  Rake::Task.define_task(*args, &block)
end