mx-platform-ruby 0.4.0 → 0.4.1

data/vendor/bundle/ruby/2.6.0/gems/rake-13.0.6/doc/rational.rdoc

@@ -1,151 +0,0 @@
-= Why rake?
-
-Ok, let me state from the beginning that I never intended to write this
-code.  I'm not convinced it is useful, and I'm not convinced anyone
-would even be interested in it.  All I can say is that Why's onion truck
-must by been passing through the Ohio valley.
-
-What am I talking about? ... A Ruby version of Make.
-
-See, I can sense you cringing already, and I agree.  The world certainly
-doesn't need yet another reworking of the "make" program.  I mean, we
-already have "ant".  Isn't that enough?
-
-It started yesterday.  I was helping a coworker fix a problem in one of
-the Makefiles we use in our project.  Not a particularly tough problem,
-but during the course of the conversation I began lamenting some of the
-shortcomings of make.  In particular, in one of my makefiles I wanted to
-determine the name of a file dynamically and had to resort to some
-simple scripting (in Ruby) to make it work.  "Wouldn't it be nice if you
-could just use Ruby inside a Makefile" I said.
-
-My coworker (a recent convert to Ruby) agreed, but wondered what it
-would look like.  So I sketched the following on the whiteboard...
-
-    "What if you could specify the make tasks in Ruby, like this ..."
-
-      task "build" do
-        java_compile(...args, etc ...)
-      end
-
-    "The task function would register "build" as a target to be made,
-    and the block would be the action executed whenever the build
-    system determined that it was time to do the build target."
-
-We agreed that would be cool, but writing make from scratch would be WAY
-too much work.  And that was the end of that!
-
-... Except I couldn't get the thought out of my head.  What exactly
-would be needed to make the about syntax work as a make file?  Hmmm, you
-would need to register the tasks, you need some way of specifying
-dependencies between tasks, and some way of kicking off the process.
-Hey!  What if we did ... and fifteen minutes later I had a working
-prototype of Ruby make, complete with dependencies and actions.
-
-I showed the code to my coworker and we had a good laugh.  It was just
-about a page worth of code that reproduced an amazing amount of the
-functionality of make.  We were both truly stunned with the power of
-Ruby.
-
-But it didn't do everything make did.  In particular, it didn't have
-timestamp based file dependencies (where a file is rebuilt if any of its
-prerequisite files have a later timestamp).  Obviously THAT would be a
-pain to add and so Ruby Make would remain an interesting experiment.
-
-... Except as I walked back to my desk, I started thinking about what
-file based dependencies would really need.  Rats!  I was hooked again,
-and by adding a new class and two new methods, file/timestamp
-dependencies were implemented.
-
-Ok, now I was really hooked.  Last night (during CSI!) I massaged the
-code and cleaned it up a bit.  The result is a bare-bones replacement
-for make in exactly 100 lines of code.
-
-For the curious, you can see it at ...
-* doc/proto_rake.rdoc
-
-Oh, about the name.  When I wrote the example Ruby Make task on my
-whiteboard, my coworker exclaimed "Oh! I have the perfect name: Rake ...
-Get it?  Ruby-Make. Rake!"  He said he envisioned the tasks as leaves
-and Rake would clean them up  ... or something like that.  Anyways, the
-name stuck.
-
-Some quick examples ...
-
-A simple task to delete backup files ...
-
-   task :clean do
-     Dir['*~'].each {|fn| rm fn rescue nil}
-   end
-
-Note that task names are symbols (they are slightly easier to type
-than quoted strings ... but you may use quoted string if you would
-rather). Rake makes the methods of the FileUtils module directly
-available, so we take advantage of the <tt>rm</tt> command.  Also note
-the use of "rescue nil" to trap and ignore errors in the <tt>rm</tt>
-command.
-
-To run it, just type "rake clean".  Rake will automatically find a
-Rakefile in the current directory (or above!) and will invoke the
-targets named on the command line.  If there are no targets explicitly
-named, rake will invoke the task "default".
-
-Here's another task with dependencies ...
-
-   task :clobber => [:clean] do
-     rm_r "tempdir"
-   end
-
-Task :clobber depends upon task :clean, so :clean will be run before
-:clobber is executed.
-
-Files are specified by using the "file" command.  It is similar to the
-task command, except that the task name represents a file, and the task
-will be run only if the file doesn't exist, or if its modification time
-is earlier than any of its prerequisites.
-
-Here is a file based dependency that will compile "hello.cc" to
-"hello.o".
-
-   file "hello.cc"
-   file "hello.o" => ["hello.cc"] do |t|
-     srcfile = t.name.sub(/\.o$/, ".cc")
-     sh %{g++ #{srcfile} -c -o #{t.name}}
-   end
-
-I normally specify file tasks with string (rather than symbols).  Some
-file names can't be represented by symbols.  Plus it makes the
-distinction between them more clear to the casual reader.
-
-Currently writing a task for each and every file in the project would be
-tedious at best.  I envision a set of libraries to make this job
-easier.  For instance, perhaps something like this ...
-
-   require 'rake/ctools'
-   Dir['*.c'].each do |fn|
-     c_source_file(fn)
-   end
-
-where "c_source_file" will create all the tasks need to compile all the
-C source files in a directory.  Any number of useful libraries could be
-created for rake.
-
-That's it.  There's no documentation (other than whats in this
-message).  Does this sound interesting to anyone?  If so, I'll continue
-to clean it up and write it up and publish it on RAA.  Otherwise, I'll
-leave it as an interesting exercise and a tribute to the power of Ruby.
-
-Why /might/ rake be interesting to Ruby programmers.  I don't know,
-perhaps ...
-
-* No weird make syntax (only weird Ruby syntax :-)
-* No need to edit or read XML (a la ant)
-* Platform independent build scripts.
-* Will run anywhere Ruby exists, so no need to have "make" installed.
-  If you stay away from the "sys" command and use things like
-  'ftools', you can have a perfectly platform independent
-  build script.  Also rake is only 100 lines of code, so it can
-  easily be packaged along with the rest of your code.
-
-So ... Sorry for the long rambling message.  Like I said, I never
-intended to write this code at all.

data/vendor/bundle/ruby/2.6.0/gems/rake-13.0.6/exe/rake

@@ -1,27 +0,0 @@
-#!/usr/bin/env ruby
-
-#--
-# Copyright (c) 2003, 2004, 2005, 2006, 2007  Jim Weirich
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to
-# deal in the Software without restriction, including without limitation the
-# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-# sell copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-#++
-
-require "rake"
-
-Rake.application.run

data/vendor/bundle/ruby/2.6.0/gems/rake-13.0.6/lib/rake/application.rb

@@ -1,831 +0,0 @@
-# frozen_string_literal: true
-require "optparse"
-
-require "rake/task_manager"
-require "rake/file_list"
-require "rake/thread_pool"
-require "rake/thread_history_display"
-require "rake/trace_output"
-require "rake/win32"
-
-module Rake
-
-  CommandLineOptionError = Class.new(StandardError)
-
-  ##
-  # Rake main application object.  When invoking +rake+ from the
-  # command line, a Rake::Application object is created and run.
-
-  class Application
-    include TaskManager
-    include TraceOutput
-
-    # The name of the application (typically 'rake')
-    attr_reader :name
-
-    # The original directory where rake was invoked.
-    attr_reader :original_dir
-
-    # Name of the actual rakefile used.
-    attr_reader :rakefile
-
-    # Number of columns on the terminal
-    attr_accessor :terminal_columns
-
-    # List of the top level task names (task names from the command line).
-    attr_reader :top_level_tasks
-
-    # Override the detected TTY output state (mostly for testing)
-    attr_writer :tty_output
-
-    DEFAULT_RAKEFILES = [
-      "rakefile",
-      "Rakefile",
-      "rakefile.rb",
-      "Rakefile.rb"
-    ].freeze
-
-    # Initialize a Rake::Application object.
-    def initialize
-      super
-      @name = "rake"
-      @rakefiles = DEFAULT_RAKEFILES.dup
-      @rakefile = nil
-      @pending_imports = []
-      @imported = []
-      @loaders = {}
-      @default_loader = Rake::DefaultLoader.new
-      @original_dir = Dir.pwd
-      @top_level_tasks = []
-      add_loader("rb", DefaultLoader.new)
-      add_loader("rf", DefaultLoader.new)
-      add_loader("rake", DefaultLoader.new)
-      @tty_output = STDOUT.tty?
-      @terminal_columns = ENV["RAKE_COLUMNS"].to_i
-
-      set_default_options
-    end
-
-    # Run the Rake application.  The run method performs the following
-    # three steps:
-    #
-    # * Initialize the command line options (+init+).
-    # * Define the tasks (+load_rakefile+).
-    # * Run the top level tasks (+top_level+).
-    #
-    # If you wish to build a custom rake command, you should call
-    # +init+ on your application.  Then define any tasks.  Finally,
-    # call +top_level+ to run your top level tasks.
-    def run(argv = ARGV)
-      standard_exception_handling do
-        init "rake", argv
-        load_rakefile
-        top_level
-      end
-    end
-
-    # Initialize the command line parameters and app name.
-    def init(app_name="rake", argv = ARGV)
-      standard_exception_handling do
-        @name = app_name
-        begin
-          args = handle_options argv
-        rescue ArgumentError
-          # Backward compatibility for capistrano
-          args = handle_options
-        end
-        collect_command_line_tasks(args)
-      end
-    end
-
-    # Find the rakefile and then load it and any pending imports.
-    def load_rakefile
-      standard_exception_handling do
-        raw_load_rakefile
-      end
-    end
-
-    # Run the top level tasks of a Rake application.
-    def top_level
-      run_with_threads do
-        if options.show_tasks
-          display_tasks_and_comments
-        elsif options.show_prereqs
-          display_prerequisites
-        else
-          top_level_tasks.each { |task_name| invoke_task(task_name) }
-        end
-      end
-    end
-
-    # Run the given block with the thread startup and shutdown.
-    def run_with_threads
-      thread_pool.gather_history if options.job_stats == :history
-
-      yield
-
-      thread_pool.join
-      if options.job_stats
-        stats = thread_pool.statistics
-        puts "Maximum active threads: #{stats[:max_active_threads]} + main"
-        puts "Total threads in play:  #{stats[:total_threads_in_play]} + main"
-      end
-      ThreadHistoryDisplay.new(thread_pool.history).show if
-        options.job_stats == :history
-    end
-
-    # Add a loader to handle imported files ending in the extension
-    # +ext+.
-    def add_loader(ext, loader)
-      ext = ".#{ext}" unless ext =~ /^\./
-      @loaders[ext] = loader
-    end
-
-    # Application options from the command line
-    def options
-      @options ||= OpenStruct.new
-    end
-
-    # Return the thread pool used for multithreaded processing.
-    def thread_pool             # :nodoc:
-      @thread_pool ||= ThreadPool.new(options.thread_pool_size || Rake.suggested_thread_count-1)
-    end
-
-    # internal ----------------------------------------------------------------
-
-    # Invokes a task with arguments that are extracted from +task_string+
-    def invoke_task(task_string) # :nodoc:
-      name, args = parse_task_string(task_string)
-      t = self[name]
-      t.invoke(*args)
-    end
-
-    def parse_task_string(string) # :nodoc:
-      /^([^\[]+)(?:\[(.*)\])$/ =~ string.to_s
-
-      name           = $1
-      remaining_args = $2
-
-      return string, [] unless name
-      return name,   [] if     remaining_args.empty?
-
-      args = []
-
-      begin
-        /\s*((?:[^\\,]|\\.)*?)\s*(?:,\s*(.*))?$/ =~ remaining_args
-
-        remaining_args = $2
-        args << $1.gsub(/\\(.)/, '\1')
-      end while remaining_args
-
-      return name, args
-    end
-
-    # Provide standard exception handling for the given block.
-    def standard_exception_handling # :nodoc:
-      yield
-    rescue SystemExit
-      # Exit silently with current status
-      raise
-    rescue OptionParser::InvalidOption => ex
-      $stderr.puts ex.message
-      exit(false)
-    rescue Exception => ex
-      # Exit with error message
-      display_error_message(ex)
-      exit_because_of_exception(ex)
-    end
-
-    # Exit the program because of an unhandled exception.
-    # (may be overridden by subclasses)
-    def exit_because_of_exception(ex) # :nodoc:
-      exit(false)
-    end
-
-    # Display the error message that caused the exception.
-    def display_error_message(ex) # :nodoc:
-      trace "#{name} aborted!"
-      display_exception_details(ex)
-      trace "Tasks: #{ex.chain}" if has_chain?(ex)
-      trace "(See full trace by running task with --trace)" unless
-         options.backtrace
-    end
-
-    def display_exception_details(ex) # :nodoc:
-      display_exception_details_seen << ex
-
-      display_exception_message_details(ex)
-      display_exception_backtrace(ex)
-      display_cause_details(ex.cause) if has_cause?(ex)
-    end
-
-    def display_cause_details(ex) # :nodoc:
-      return if display_exception_details_seen.include? ex
-
-      trace "\nCaused by:"
-      display_exception_details(ex)
-    end
-
-    def display_exception_details_seen # :nodoc:
-      Thread.current[:rake_display_exception_details_seen] ||= []
-    end
-
-    def has_cause?(ex) # :nodoc:
-      ex.respond_to?(:cause) && ex.cause
-    end
-
-    def display_exception_message_details(ex) # :nodoc:
-      if ex.instance_of?(RuntimeError)
-        trace ex.message
-      else
-        trace "#{ex.class.name}: #{ex.message}"
-      end
-    end
-
-    def display_exception_backtrace(ex) # :nodoc:
-      if options.backtrace
-        trace ex.backtrace.join("\n")
-      else
-        trace Backtrace.collapse(ex.backtrace).join("\n")
-      end
-    end
-
-    # Warn about deprecated usage.
-    #
-    # Example:
-    #    Rake.application.deprecate("import", "Rake.import", caller.first)
-    #
-    def deprecate(old_usage, new_usage, call_site) # :nodoc:
-      unless options.ignore_deprecate
-        $stderr.puts "WARNING: '#{old_usage}' is deprecated.  " +
-          "Please use '#{new_usage}' instead.\n" +
-          "    at #{call_site}"
-      end
-    end
-
-    # Does the exception have a task invocation chain?
-    def has_chain?(exception) # :nodoc:
-      exception.respond_to?(:chain) && exception.chain
-    end
-    private :has_chain?
-
-    # True if one of the files in RAKEFILES is in the current directory.
-    # If a match is found, it is copied into @rakefile.
-    def have_rakefile # :nodoc:
-      @rakefiles.each do |fn|
-        if File.exist?(fn)
-          others = FileList.glob(fn, File::FNM_CASEFOLD)
-          return others.size == 1 ? others.first : fn
-        elsif fn == ""
-          return fn
-        end
-      end
-      return nil
-    end
-
-    # True if we are outputting to TTY, false otherwise
-    def tty_output? # :nodoc:
-      @tty_output
-    end
-
-    # We will truncate output if we are outputting to a TTY or if we've been
-    # given an explicit column width to honor
-    def truncate_output? # :nodoc:
-      tty_output? || @terminal_columns.nonzero?
-    end
-
-    # Display the tasks and comments.
-    def display_tasks_and_comments # :nodoc:
-      displayable_tasks = tasks.select { |t|
-        (options.show_all_tasks || t.comment) &&
-          t.name =~ options.show_task_pattern
-      }
-      case options.show_tasks
-      when :tasks
-        width = displayable_tasks.map { |t| t.name_with_args.length }.max || 10
-        if truncate_output?
-          max_column = terminal_width - name.size - width - 7
-        else
-          max_column = nil
-        end
-
-        displayable_tasks.each do |t|
-          printf("#{name} %-#{width}s  # %s\n",
-            t.name_with_args,
-            max_column ? truncate(t.comment, max_column) : t.comment)
-        end
-      when :describe
-        displayable_tasks.each do |t|
-          puts "#{name} #{t.name_with_args}"
-          comment = t.full_comment || ""
-          comment.split("\n").each do |line|
-            puts "    #{line}"
-          end
-          puts
-        end
-      when :lines
-        displayable_tasks.each do |t|
-          t.locations.each do |loc|
-            printf "#{name} %-30s %s\n", t.name_with_args, loc
-          end
-        end
-      else
-        fail "Unknown show task mode: '#{options.show_tasks}'"
-      end
-    end
-
-    def terminal_width # :nodoc:
-      if @terminal_columns.nonzero?
-        result = @terminal_columns
-      else
-        result = unix? ? dynamic_width : 80
-      end
-      (result < 10) ? 80 : result
-    rescue
-      80
-    end
-
-    # Calculate the dynamic width of the
-    def dynamic_width # :nodoc:
-      @dynamic_width ||= (dynamic_width_stty.nonzero? || dynamic_width_tput)
-    end
-
-    def dynamic_width_stty # :nodoc:
-      %x{stty size 2>/dev/null}.split[1].to_i
-    end
-
-    def dynamic_width_tput # :nodoc:
-      %x{tput cols 2>/dev/null}.to_i
-    end
-
-    def unix? # :nodoc:
-      RbConfig::CONFIG["host_os"] =~
-        /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i
-    end
-
-    def windows? # :nodoc:
-      Win32.windows?
-    end
-
-    def truncate(string, width) # :nodoc:
-      if string.nil?
-        ""
-      elsif string.length <= width
-        string
-      else
-        (string[0, width - 3] || "") + "..."
-      end
-    end
-
-    # Display the tasks and prerequisites
-    def display_prerequisites # :nodoc:
-      tasks.each do |t|
-        puts "#{name} #{t.name}"
-        t.prerequisites.each { |pre| puts "    #{pre}" }
-      end
-    end
-
-    def trace(*strings) # :nodoc:
-      options.trace_output ||= $stderr
-      trace_on(options.trace_output, *strings)
-    end
-
-    def sort_options(options) # :nodoc:
-      options.sort_by { |opt|
-        opt.select { |o| o.is_a?(String) && o =~ /^-/ }.map(&:downcase).sort.reverse
-      }
-    end
-    private :sort_options
-
-    # A list of all the standard options used in rake, suitable for
-    # passing to OptionParser.
-    def standard_rake_options # :nodoc:
-      sort_options(
-        [
-          ["--all", "-A",
-            "Show all tasks, even uncommented ones (in combination with -T or -D)",
-            lambda { |value|
-              options.show_all_tasks = value
-            }
-          ],
-          ["--backtrace=[OUT]",
-            "Enable full backtrace.  OUT can be stderr (default) or stdout.",
-            lambda { |value|
-              options.backtrace = true
-              select_trace_output(options, "backtrace", value)
-            }
-          ],
-          ["--build-all", "-B",
-           "Build all prerequisites, including those which are up-to-date.",
-           lambda { |value|
-             options.build_all = true
-           }
-          ],
-          ["--comments",
-            "Show commented tasks only",
-            lambda { |value|
-              options.show_all_tasks = !value
-            }
-          ],
-          ["--describe", "-D [PATTERN]",
-            "Describe the tasks (matching optional PATTERN), then exit.",
-            lambda { |value|
-              select_tasks_to_show(options, :describe, value)
-            }
-          ],
-          ["--directory", "-C [DIRECTORY]",
-            "Change to DIRECTORY before doing anything.",
-            lambda { |value|
-              Dir.chdir value
-              @original_dir = Dir.pwd
-            }
-          ],
-          ["--dry-run", "-n",
-            "Do a dry run without executing actions.",
-            lambda { |value|
-              Rake.verbose(true)
-              Rake.nowrite(true)
-              options.dryrun = true
-              options.trace = true
-            }
-          ],
-          ["--execute", "-e CODE",
-            "Execute some Ruby code and exit.",
-            lambda { |value|
-              eval(value)
-              exit
-            }
-          ],
-          ["--execute-print", "-p CODE",
-            "Execute some Ruby code, print the result, then exit.",
-            lambda { |value|
-              puts eval(value)
-              exit
-            }
-          ],
-          ["--execute-continue",  "-E CODE",
-            "Execute some Ruby code, " +
-            "then continue with normal task processing.",
-            lambda { |value| eval(value) }
-          ],
-          ["--jobs",  "-j [NUMBER]",
-            "Specifies the maximum number of tasks to execute in parallel. " +
-            "(default is number of CPU cores + 4)",
-            lambda { |value|
-              if value.nil? || value == ""
-                value = Float::INFINITY
-              elsif value =~ /^\d+$/
-                value = value.to_i
-              else
-                value = Rake.suggested_thread_count
-              end
-              value = 1 if value < 1
-              options.thread_pool_size = value - 1
-            }
-          ],
-          ["--job-stats [LEVEL]",
-            "Display job statistics. " +
-            "LEVEL=history displays a complete job list",
-            lambda { |value|
-              if value =~ /^history/i
-                options.job_stats = :history
-              else
-                options.job_stats = true
-              end
-            }
-          ],
-          ["--libdir", "-I LIBDIR",
-            "Include LIBDIR in the search path for required modules.",
-            lambda { |value| $:.push(value) }
-          ],
-          ["--multitask", "-m",
-            "Treat all tasks as multitasks.",
-            lambda { |value| options.always_multitask = true }
-          ],
-          ["--no-search", "--nosearch",
-            "-N", "Do not search parent directories for the Rakefile.",
-            lambda { |value| options.nosearch = true }
-          ],
-          ["--prereqs", "-P",
-            "Display the tasks and dependencies, then exit.",
-            lambda { |value| options.show_prereqs = true }
-          ],
-          ["--quiet", "-q",
-            "Do not log messages to standard output.",
-            lambda { |value| Rake.verbose(false) }
-          ],
-          ["--rakefile", "-f [FILENAME]",
-            "Use FILENAME as the rakefile to search for.",
-            lambda { |value|
-              value ||= ""
-              @rakefiles.clear
-              @rakefiles << value
-            }
-          ],
-          ["--rakelibdir", "--rakelib", "-R RAKELIBDIR",
-            "Auto-import any .rake files in RAKELIBDIR. " +
-            "(default is 'rakelib')",
-            lambda { |value|
-              options.rakelib = value.split(File::PATH_SEPARATOR)
-            }
-          ],
-          ["--require", "-r MODULE",
-            "Require MODULE before executing rakefile.",
-            lambda { |value|
-              begin
-                require value
-              rescue LoadError => ex
-                begin
-                  rake_require value
-                rescue LoadError
-                  raise ex
-                end
-              end
-            }
-          ],
-          ["--rules",
-            "Trace the rules resolution.",
-            lambda { |value| options.trace_rules = true }
-          ],
-          ["--silent", "-s",
-            "Like --quiet, but also suppresses the " +
-            "'in directory' announcement.",
-            lambda { |value|
-              Rake.verbose(false)
-              options.silent = true
-            }
-          ],
-          ["--suppress-backtrace PATTERN",
-            "Suppress backtrace lines matching regexp PATTERN. " +
-            "Ignored if --trace is on.",
-            lambda { |value|
-              options.suppress_backtrace_pattern = Regexp.new(value)
-            }
-          ],
-          ["--system",  "-g",
-            "Using system wide (global) rakefiles " +
-            "(usually '~/.rake/*.rake').",
-            lambda { |value| options.load_system = true }
-          ],
-          ["--no-system", "--nosystem", "-G",
-            "Use standard project Rakefile search paths, " +
-            "ignore system wide rakefiles.",
-            lambda { |value| options.ignore_system = true }
-          ],
-          ["--tasks", "-T [PATTERN]",
-            "Display the tasks (matching optional PATTERN) " +
-            "with descriptions, then exit. " +
-            "-AT combination displays all of tasks contained no description.",
-            lambda { |value|
-              select_tasks_to_show(options, :tasks, value)
-            }
-          ],
-          ["--trace=[OUT]", "-t",
-            "Turn on invoke/execute tracing, enable full backtrace. " +
-            "OUT can be stderr (default) or stdout.",
-            lambda { |value|
-              options.trace = true
-              options.backtrace = true
-              select_trace_output(options, "trace", value)
-              Rake.verbose(true)
-            }
-          ],
-          ["--verbose", "-v",
-            "Log message to standard output.",
-            lambda { |value| Rake.verbose(true) }
-          ],
-          ["--version", "-V",
-            "Display the program version.",
-            lambda { |value|
-              puts "rake, version #{Rake::VERSION}"
-              exit
-            }
-          ],
-          ["--where", "-W [PATTERN]",
-            "Describe the tasks (matching optional PATTERN), then exit.",
-            lambda { |value|
-              select_tasks_to_show(options, :lines, value)
-              options.show_all_tasks = true
-            }
-          ],
-          ["--no-deprecation-warnings", "-X",
-            "Disable the deprecation warnings.",
-            lambda { |value|
-              options.ignore_deprecate = true
-            }
-          ],
-        ])
-    end
-
-    def select_tasks_to_show(options, show_tasks, value) # :nodoc:
-      options.show_tasks = show_tasks
-      options.show_task_pattern = Regexp.new(value || "")
-      Rake::TaskManager.record_task_metadata = true
-    end
-    private :select_tasks_to_show
-
-    def select_trace_output(options, trace_option, value) # :nodoc:
-      value = value.strip unless value.nil?
-      case value
-      when "stdout"
-        options.trace_output = $stdout
-      when "stderr", nil
-        options.trace_output = $stderr
-      else
-        fail CommandLineOptionError,
-          "Unrecognized --#{trace_option} option '#{value}'"
-      end
-    end
-    private :select_trace_output
-
-    # Read and handle the command line options.  Returns the command line
-    # arguments that we didn't understand, which should (in theory) be just
-    # task names and env vars.
-    def handle_options(argv) # :nodoc:
-      set_default_options
-
-      OptionParser.new do |opts|
-        opts.banner = "#{Rake.application.name} [-f rakefile] {options} targets..."
-        opts.separator ""
-        opts.separator "Options are ..."
-
-        opts.on_tail("-h", "--help", "-H", "Display this help message.") do
-          puts opts
-          exit
-        end
-
-        standard_rake_options.each { |args| opts.on(*args) }
-        opts.environment("RAKEOPT")
-      end.parse(argv)
-    end
-
-    # Similar to the regular Ruby +require+ command, but will check
-    # for *.rake files in addition to *.rb files.
-    def rake_require(file_name, paths=$LOAD_PATH, loaded=$") # :nodoc:
-      fn = file_name + ".rake"
-      return false if loaded.include?(fn)
-      paths.each do |path|
-        full_path = File.join(path, fn)
-        if File.exist?(full_path)
-          Rake.load_rakefile(full_path)
-          loaded << fn
-          return true
-        end
-      end
-      fail LoadError, "Can't find #{file_name}"
-    end
-
-    def find_rakefile_location # :nodoc:
-      here = Dir.pwd
-      until (fn = have_rakefile)
-        Dir.chdir("..")
-        return nil if Dir.pwd == here || options.nosearch
-        here = Dir.pwd
-      end
-      [fn, here]
-    ensure
-      Dir.chdir(Rake.original_dir)
-    end
-
-    def print_rakefile_directory(location) # :nodoc:
-      $stderr.puts "(in #{Dir.pwd})" unless
-        options.silent or original_dir == location
-    end
-
-    def raw_load_rakefile # :nodoc:
-      rakefile, location = find_rakefile_location
-      if (!options.ignore_system) &&
-          (options.load_system || rakefile.nil?) &&
-          system_dir && File.directory?(system_dir)
-        print_rakefile_directory(location)
-        glob("#{system_dir}/*.rake") do |name|
-          add_import name
-        end
-      else
-        fail "No Rakefile found (looking for: #{@rakefiles.join(', ')})" if
-          rakefile.nil?
-        @rakefile = rakefile
-        Dir.chdir(location)
-        print_rakefile_directory(location)
-        Rake.load_rakefile(File.expand_path(@rakefile)) if
-          @rakefile && @rakefile != ""
-        options.rakelib.each do |rlib|
-          glob("#{rlib}/*.rake") do |name|
-            add_import name
-          end
-        end
-      end
-      load_imports
-    end
-
-    def glob(path, &block) # :nodoc:
-      FileList.glob(path.tr("\\", "/")).each(&block)
-    end
-    private :glob
-
-    # The directory path containing the system wide rakefiles.
-    def system_dir # :nodoc:
-      @system_dir ||=
-        begin
-          if ENV["RAKE_SYSTEM"]
-            ENV["RAKE_SYSTEM"]
-          else
-            standard_system_dir
-          end
-        end
-    end
-
-    # The standard directory containing system wide rake files.
-    if Win32.windows?
-      def standard_system_dir #:nodoc:
-        Win32.win32_system_dir
-      end
-    else
-      def standard_system_dir #:nodoc:
-        File.join(File.expand_path("~"), ".rake")
-      end
-    end
-    private :standard_system_dir
-
-    # Collect the list of tasks on the command line.  If no tasks are
-    # given, return a list containing only the default task.
-    # Environmental assignments are processed at this time as well.
-    #
-    # `args` is the list of arguments to peruse to get the list of tasks.
-    # It should be the command line that was given to rake, less any
-    # recognised command-line options, which OptionParser.parse will
-    # have taken care of already.
-    def collect_command_line_tasks(args) # :nodoc:
-      @top_level_tasks = []
-      args.each do |arg|
-        if arg =~ /^(\w+)=(.*)$/m
-          ENV[$1] = $2
-        else
-          @top_level_tasks << arg unless arg =~ /^-/
-        end
-      end
-      @top_level_tasks.push(default_task_name) if @top_level_tasks.empty?
-    end
-
-    # Default task name ("default").
-    # (May be overridden by subclasses)
-    def default_task_name # :nodoc:
-      "default"
-    end
-
-    # Add a file to the list of files to be imported.
-    def add_import(fn) # :nodoc:
-      @pending_imports << fn
-    end
-
-    # Load the pending list of imported files.
-    def load_imports # :nodoc:
-      while fn = @pending_imports.shift
-        next if @imported.member?(fn)
-        fn_task = lookup(fn) and fn_task.invoke
-        ext = File.extname(fn)
-        loader = @loaders[ext] || @default_loader
-        loader.load(fn)
-        if fn_task = lookup(fn) and fn_task.needed?
-          fn_task.reenable
-          fn_task.invoke
-          loader.load(fn)
-        end
-        @imported << fn
-      end
-    end
-
-    def rakefile_location(backtrace=caller) # :nodoc:
-      backtrace.map { |t| t[/([^:]+):/, 1] }
-
-      re = /^#{@rakefile}$/
-      re = /#{re.source}/i if windows?
-
-      backtrace.find { |str| str =~ re } || ""
-    end
-
-    def set_default_options # :nodoc:
-      options.always_multitask           = false
-      options.backtrace                  = false
-      options.build_all                  = false
-      options.dryrun                     = false
-      options.ignore_deprecate           = false
-      options.ignore_system              = false
-      options.job_stats                  = false
-      options.load_system                = false
-      options.nosearch                   = false
-      options.rakelib                    = %w[rakelib]
-      options.show_all_tasks             = false
-      options.show_prereqs               = false
-      options.show_task_pattern          = nil
-      options.show_tasks                 = nil
-      options.silent                     = false
-      options.suppress_backtrace_pattern = nil
-      options.thread_pool_size           = Rake.suggested_thread_count
-      options.trace                      = false
-      options.trace_output               = $stderr
-      options.trace_rules                = false
-    end
-
-  end
-end