module Rake::TaskManager (Ruby 3.3 リファレンスマニュアル)

要約

タスクを管理するためのモジュールです。

インスタンスメソッド

self[task_name, scopes = nil] -> Rake::TaskRuby 1.9.3 から[permalink][rdoc][edit]

与えられたタスク名にマッチするタスクを検索します。

[PARAM] task_name:: タスク名を指定します。
[PARAM] scopes:: スコープを指定します。

# Rakefile での記載例とする

task default: :test_rake_app
task :test_rake_app do
  p Rake.application["test_rake_app"] # => <Rake::Task test_rake_app => []>
end

clearRuby 1.9.3 から[permalink][rdoc][edit]

全てのタスクとルールをクリアします。

# Rakefile での記載例とする

task default: :test_rake_app
task :test_rake_app do
  p Rake.application.tasks # => [<Rake::Task default => [test_rake_app]>, <Rake::Task test_rake_app => []>]
  p Rake.application.clear # => []
  p Rake.application.tasks # => []
end

create_rule(*args) { ... }Ruby 1.9.3 から[permalink][rdoc][edit]

与えられたパラメータに従ってルールを作成します。

[PARAM] args:: ルールに与えるパラメータを指定します。

# Rakefile での記載例とする

task default: :test_rake_app
task :test_rake_app do
  rule = Rake.application.create_rule '.txt' => '.md' do |t|
    "#{t}"
  end
  p rule # => [[/\.txt$/, [], [".md"], nil, #<Proc:0x0000558dd2e32d20 /path/to/Rakefile:5>]]
end

current_scope -> ArrayRuby 1.9.3 から[permalink][rdoc][edit]

現在のスコープを返します。

# Rakefile での記載例とする

task default: :test_rake_app
task :test_rake_app do
  p Rake.application.current_scope # => LL()
end

define_task(task_class, *args) { ... } -> Rake::TaskRuby 1.9.3 から[permalink][rdoc][edit]

タスクを定義します。

[PARAM] task_class:: タスククラスを指定します。
[PARAM] args:: タスクに渡すパラメータを指定します。

# Rakefile での記載例とする

task default: :test_rake_app
task :test_rake_app do
  p Rake.application.define_task(Rake::Task, :t) # => <Rake::Task t => []>
end

enhance_with_matching_rule(task_name, level = 0) -> Rake::Task | nilRuby 1.9.3 から[permalink][rdoc][edit]

与えられたタスク名にマッチしたルールが存在する場合は、そのタスクに見つかったルールの事前タスクとアクションを追加して返します。

[PARAM] task_name:: タスクの名前を指定します。
[PARAM] level:: 現在のルール解決のネストの深さを指定します。
[EXCEPTION] RuntimeError:: ルールの解決時にオーバーフローした場合に発生します。

in_namespace(name) {|name_space| ... } -> ArrayRuby 1.9.3 から[permalink][rdoc][edit]

与えられた名前の名前空間でブロックを評価します。

[PARAM] name:: 名前を指定します。

# Rakefile での記載例とする

task default: :test_rake_app

namespace :sample do
  def hoge
    puts "hoge"
  end
end

task :test_rake_app do
  task.application.in_namespace("sample") do
    p hoge # => "hoge"
  end
end

intern(task_class, task_name) -> Rake::TaskRuby 1.9.3 から[permalink][rdoc][edit]

タスクを検索します。

タスクが見つかれば見つかったタスクを返します。見つからなければ、与えられた型のタスクを作成して返します。

[PARAM] task_class:: タスクのクラスを指定します。
[PARAM] task_name:: タスクの名前を指定します。

# Rakefile での記載例とする

task default: :test_rake_app

task :test_rake_app do |task|
  p task.application.intern(Rake::Task, "test_rake_app") # => <Rake::Task test_rake_app => []>
  p task.application.intern(Rake::Task, "sample_task") # => <Rake::Task sample_task => []>
end

last_description -> StringRuby 1.9.3 から[permalink][rdoc][edit]

last_comment -> String

Rakefile 内の最新の詳細説明を追跡するためのメソッドです。

# Rakefile での記載例とする

task default: :test_rake_app1

desc "test1"
task :test_rake_app1 do |task|
  p task.application.last_description # => "test2"
end

desc "test2"
task :test_rake_app2 do |task|
end

last_description=(description)Ruby 1.9.3 から[permalink][rdoc][edit]

最新の詳細説明をセットします。

# Rakefile での記載例とする

task default: :test_rake_app1

desc "test1"
task :test_rake_app1 do |task|
  p task.application.last_description # => "test2"
  task.application.last_description = "test3"
  p task.application.last_description # => "test3"
end

desc "test2"
task :test_rake_app2 do |task|
end

lookup(task_name, initial_scope = nil) -> Rake::Task | nilRuby 1.9.3 から[permalink][rdoc][edit]

与えられたタスク名にマッチするタスクを検索します。

このメソッドは、ファイルタスクやルールを合成せずにタスクを探します。特別なスコープ ('^' など) が存在します。スコープが省略された場合は現在のスコープを使用します。

[PARAM] task_name:: タスク名を指定します。
[PARAM] initial_scope:: 検索するスコープを指定します。

# Rakefile での記載例とする

task default: :test_rake_app

task :test_rake_app do |task|
  p task.application.lookup("test_rake_app") # => <Rake::Task test_rake_app => []>
end

resolve_args(args) -> ArrayRuby 1.9.3 から[permalink][rdoc][edit]

タスクやルールに与えられたパラメータを解釈します。

[PARAM] args:: パラメータを指定します。
[RETURN]: [task_name, arg_name_list, prerequisites] を返します。

synthesize_file_task(task_name) -> Rake::FileTask | nilRuby 1.9.3 から[permalink][rdoc][edit]

与えられたタスク名をもとにファイルタスクを合成します。

[PARAM] task_name:: タスク名を指定します。
[RETURN]: 与えられたタスク名と同名のファイルが存在する場合は、ファイルタスクを作成して返します。そうでない場合は nil を返します。
[EXCEPTION] RuntimeError:: タスクを合成できなかった場合に発生します。

# Rakefile での記載例とする

task default: :test_rake_app

task :test_rake_app do |task|
  p task.application.synthesize_file_task("sample_file") # => nil
  IO.write("sample_file", "")
  p task.application.synthesize_file_task("sample_file") # => <Rake::FileTask sample_file => []>
end

tasks -> ArrayRuby 1.9.3 から[permalink][rdoc][edit]

全てのタスクリストを返します。

# Rakefile での記載例とする
require 'pp'

task default: :test_rake_app2

task :test_rake_app1 do |task|
end

task :test_rake_app2 do |task|
  pp task.application.tasks
  # => [<Rake::Task default => [test_rake_app2]>,
  #    <Rake::Task test_rake_app1 => []>,
  #    <Rake::Task test_rake_app2 => []>]
end

要約

目次

インスタンスメソッド