Gecko [ primetaxinc.net ]

Name	Size	Permission
contrib	[ DIR ]	drwxr-xr-x
ext	[ DIR ]	drwxr-xr-x
lib	[ DIR ]	drwxr-xr-x
loaders	[ DIR ]	drwxr-xr-x
alt_system.rb	3.17 KB	-rw-r--r--
application.rb	23.14 KB	-rw-r--r--
backtrace.rb	868 B	-rw-r--r--
clean.rb	1.93 KB	-rw-r--r--
cloneable.rb	418 B	-rw-r--r--
cpu_counter.rb	2.83 KB	-rw-r--r--
default_loader.rb	235 B	-rw-r--r--
dsl_definition.rb	5.64 KB	-rw-r--r--
early_time.rb	340 B	-rw-r--r--
file_creation_task.rb	670 B	-rw-r--r--
file_list.rb	12.13 KB	-rw-r--r--
file_task.rb	1.26 KB	-rw-r--r--
file_utils.rb	3.66 KB	-rw-r--r--
file_utils_ext.rb	4.05 KB	-rw-r--r--
gempackagetask.rb	144 B	-rw-r--r--
invocation_chain.rb	1.16 KB	-rw-r--r--
invocation_exception_mixin.rb	431 B	-rw-r--r--
late_time.rb	265 B	-rw-r--r--
linked_list.rb	2.27 KB	-rw-r--r--
multi_task.rb	315 B	-rw-r--r--
name_space.rb	673 B	-rw-r--r--
packagetask.rb	5.28 KB	-rw-r--r--
pathmap.rb	53 B	-rw-r--r--
phony.rb	351 B	-rw-r--r--
private_reader.rb	364 B	-rw-r--r--
promise.rb	2.28 KB	-rw-r--r--
pseudo_status.rb	375 B	-rw-r--r--
rake_module.rb	770 B	-rw-r--r--
rake_test_loader.rb	341 B	-rw-r--r--
rdoctask.rb	153 B	-rw-r--r--
ruby182_test_unit_fix.rb	897 B	-rw-r--r--
rule_recursion_overflow_error....	353 B	-rw-r--r--
runtest.rb	594 B	-rw-r--r--
scope.rb	882 B	-rw-r--r--
task.rb	11.02 KB	-rw-r--r--
task_argument_error.rb	119 B	-rw-r--r--
task_arguments.rb	2.15 KB	-rw-r--r--
task_manager.rb	8.84 KB	-rw-r--r--
tasklib.rb	618 B	-rw-r--r--
testtask.rb	5.55 KB	-rw-r--r--
thread_history_display.rb	1.11 KB	-rw-r--r--
thread_pool.rb	4.78 KB	-rw-r--r--
trace_output.rb	543 B	-rw-r--r--
version.rb	156 B	-rw-r--r--
win32.rb	1.55 KB	-rw-r--r--

Code Editor : task.rb

require 'rake/invocation_exception_mixin'

module Rake

##
  # A Task is the basic unit of work in a Rakefile.  Tasks have associated
  # actions (possibly more than one) and a list of prerequisites.  When
  # invoked, a task will first ensure that all of its prerequisites have an
  # opportunity to run and then it will execute its own actions.
  #
  # Tasks are not usually created directly using the new method, but rather
  # use the +file+ and +task+ convenience methods.
  #
  class Task
    # List of prerequisites for a task.
    attr_reader :prerequisites

# List of actions attached to a task.
    attr_reader :actions

# Application owning this task.
    attr_accessor :application

# Array of nested namespaces names used for task lookup by this task.
    attr_reader :scope

# File/Line locations of each of the task definitions for this
    # task (only valid if the task was defined with the detect
    # location option set).
    attr_reader :locations

# Return task name
    def to_s
      name
    end

def inspect # :nodoc:
      "<#{self.class} #{name} => [#{prerequisites.join(', ')}]>"
    end

# List of sources for task.
    attr_writer :sources
    def sources
      if defined?(@sources)
        @sources
      else
        prerequisites
      end
    end

# List of prerequisite tasks
    def prerequisite_tasks
      prerequisites.map { |pre| lookup_prerequisite(pre) }
    end

def lookup_prerequisite(prerequisite_name) # :nodoc:
      application[prerequisite_name, @scope]
    end
    private :lookup_prerequisite

# List of all unique prerequisite tasks including prerequisite tasks'
    # prerequisites.
    # Includes self when cyclic dependencies are found.
    def all_prerequisite_tasks
      seen = {}
      collect_prerequisites(seen)
      seen.values
    end

def collect_prerequisites(seen) # :nodoc:
      prerequisite_tasks.each do |pre|
        next if seen[pre.name]
        seen[pre.name] = pre
        pre.collect_prerequisites(seen)
      end
    end
    protected :collect_prerequisites

# First source from a rule (nil if no sources)
    def source
      sources.first
    end

# Create a task named +task_name+ with no actions or prerequisites. Use
    # +enhance+ to add actions and prerequisites.
    def initialize(task_name, app)
      @name            = task_name.to_s
      @prerequisites   = []
      @actions         = []
      @already_invoked = false
      @comments        = []
      @lock            = Monitor.new
      @application     = app
      @scope           = app.current_scope
      @arg_names       = nil
      @locations       = []
    end

# Enhance a task with prerequisites or actions.  Returns self.
    def enhance(deps=nil, &block)
      @prerequisites |= deps if deps
      @actions << block if block_given?
      self
    end

# Name of the task, including any namespace qualifiers.
    def name
      @name.to_s
    end

# Name of task with argument list description.
    def name_with_args # :nodoc:
      if arg_description
        "#{name}#{arg_description}"
      else
        name
      end
    end

# Argument description (nil if none).
    def arg_description # :nodoc:
      @arg_names ? "[#{arg_names.join(',')}]" : nil
    end

# Name of arguments for this task.
    def arg_names
      @arg_names || []
    end

# Reenable the task, allowing its tasks to be executed if the task
    # is invoked again.
    def reenable
      @already_invoked = false
    end

# Clear the existing prerequisites and actions of a rake task.
    def clear
      clear_prerequisites
      clear_actions
      clear_comments
      self
    end

# Clear the existing prerequisites of a rake task.
    def clear_prerequisites
      prerequisites.clear
      self
    end

# Clear the existing actions on a rake task.
    def clear_actions
      actions.clear
      self
    end

# Clear the existing comments on a rake task.
    def clear_comments
      @comments = []
      self
    end

# Invoke the task if it is needed.  Prerequisites are invoked first.
    def invoke(*args)
      task_args = TaskArguments.new(arg_names, args)
      invoke_with_call_chain(task_args, InvocationChain::EMPTY)
    end

# Same as invoke, but explicitly pass a call chain to detect
    # circular dependencies.
    def invoke_with_call_chain(task_args, invocation_chain) # :nodoc:
      new_chain = InvocationChain.append(self, invocation_chain)
      @lock.synchronize do
        if application.options.trace
          application.trace "** Invoke #{name} #{format_trace_flags}"
        end
        return if @already_invoked
        @already_invoked = true
        invoke_prerequisites(task_args, new_chain)
        execute(task_args) if needed?
      end
    rescue Exception => ex
      add_chain_to(ex, new_chain)
      raise ex
    end
    protected :invoke_with_call_chain

def add_chain_to(exception, new_chain) # :nodoc:
      exception.extend(InvocationExceptionMixin) unless
        exception.respond_to?(:chain)
      exception.chain = new_chain if exception.chain.nil?
    end
    private :add_chain_to

# Invoke all the prerequisites of a task.
    def invoke_prerequisites(task_args, invocation_chain) # :nodoc:
      if application.options.always_multitask
        invoke_prerequisites_concurrently(task_args, invocation_chain)
      else
        prerequisite_tasks.each { |p|
          prereq_args = task_args.new_scope(p.arg_names)
          p.invoke_with_call_chain(prereq_args, invocation_chain)
        }
      end
    end

# Invoke all the prerequisites of a task in parallel.
    def invoke_prerequisites_concurrently(task_args, invocation_chain)# :nodoc:
      futures = prerequisite_tasks.map do |p|
        prereq_args = task_args.new_scope(p.arg_names)
        application.thread_pool.future(p) do |r|
          r.invoke_with_call_chain(prereq_args, invocation_chain)
        end
      end
      futures.each { |f| f.value }
    end

# Format the trace flags for display.
    def format_trace_flags
      flags = []
      flags << "first_time" unless @already_invoked
      flags << "not_needed" unless needed?
      flags.empty? ? "" : "(" + flags.join(", ") + ")"
    end
    private :format_trace_flags

# Execute the actions associated with this task.
    def execute(args=nil)
      args ||= EMPTY_TASK_ARGS
      if application.options.dryrun
        application.trace "** Execute (dry run) #{name}"
        return
      end
      application.trace "** Execute #{name}" if application.options.trace
      application.enhance_with_matching_rule(name) if @actions.empty?
      @actions.each do |act|
        case act.arity
        when 1
          act.call(self)
        else
          act.call(self, args)
        end
      end
    end

# Is this task needed?
    def needed?
      true
    end

# Timestamp for this task.  Basic tasks return the current time for their
    # time stamp.  Other tasks can be more sophisticated.
    def timestamp
      Time.now
    end

# Add a description to the task.  The description can consist of an option
    # argument list (enclosed brackets) and an optional comment.
    def add_description(description)
      return unless description
      comment = description.strip
      add_comment(comment) if comment && ! comment.empty?
    end

def comment=(comment) # :nodoc:
      add_comment(comment)
    end

def add_comment(comment) # :nodoc:
      return if comment.nil?
      @comments << comment unless @comments.include?(comment)
    end
    private :add_comment

# Full collection of comments. Multiple comments are separated by
    # newlines.
    def full_comment
      transform_comments("\n")
    end

# First line (or sentence) of all comments. Multiple comments are
    # separated by a "/".
    def comment
      transform_comments(" / ") { |c| first_sentence(c) }
    end

# Transform the list of comments as specified by the block and
    # join with the separator.
    def transform_comments(separator, &block)
      if @comments.empty?
        nil
      else
        block ||= lambda { |c| c }
        @comments.map(&block).join(separator)
      end
    end
    private :transform_comments

# Get the first sentence in a string. The sentence is terminated
    # by the first period or the end of the line. Decimal points do
    # not count as periods.
    def first_sentence(string)
      string.split(/\.[ \t]|\.$|\n/).first
    end
    private :first_sentence

# Set the names of the arguments for this task. +args+ should be
    # an array of symbols, one for each argument name.
    def set_arg_names(args)
      @arg_names = args.map { |a| a.to_sym }
    end

# Return a string describing the internal state of a task.  Useful for
    # debugging.
    def investigation
      result = "------------------------------\n"
      result << "Investigating #{name}\n"
      result << "class: #{self.class}\n"
      result <<  "task needed: #{needed?}\n"
      result <<  "timestamp: #{timestamp}\n"
      result << "pre-requisites: \n"
      prereqs = prerequisite_tasks
      prereqs.sort! { |a, b| a.timestamp <=> b.timestamp }
      prereqs.each do |p|
        result << "--#{p.name} (#{p.timestamp})\n"
      end
      latest_prereq = prerequisite_tasks.map { |pre| pre.timestamp }.max
      result <<  "latest-prerequisite time: #{latest_prereq}\n"
      result << "................................\n\n"
      return result
    end

# ----------------------------------------------------------------
    # Rake Module Methods
    #
    class << self

# Clear the task list.  This cause rake to immediately forget all the
      # tasks that have been assigned.  (Normally used in the unit tests.)
      def clear
        Rake.application.clear
      end

# List of all defined tasks.
      def tasks
        Rake.application.tasks
      end

# Return a task with the given name.  If the task is not currently
      # known, try to synthesize one from the defined rules.  If no rules are
      # found, but an existing file matches the task name, assume it is a file
      # task with no dependencies or actions.
      def [](task_name)
        Rake.application[task_name]
      end

# TRUE if the task name is already defined.
      def task_defined?(task_name)
        Rake.application.lookup(task_name) != nil
      end

# Define a task given +args+ and an option block.  If a rule with the
      # given name already exists, the prerequisites and actions are added to
      # the existing task.  Returns the defined task.
      def define_task(*args, &block)
        Rake.application.define_task(self, *args, &block)
      end

# Define a rule for synthesizing tasks.
      def create_rule(*args, &block)
        Rake.application.create_rule(*args, &block)
      end

# Apply the scope to the task name according to the rules for
      # this kind of task.  Generic tasks will accept the scope as
      # part of the name.
      def scope_name(scope, task_name)
#        (scope + [task_name]).join(':')
        scope.path_with_task_name(task_name)
      end

end # class << Rake::Task
  end # class Rake::Task
end

${this.title}

Code Editor : task.rb