rake-clone 13.4.2

data/lib/rake/thread_pool.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require_relative "promise"
+require "set"
+
+module Rake
+
+  class ThreadPool # :nodoc: all
+
+    # Creates a ThreadPool object.  The +thread_count+ parameter is the size
+    # of the pool.
+    def initialize(thread_count)
+      @max_active_threads = [thread_count, 0].max
+      @threads = Set.new
+      @threads_mon = Monitor.new
+      @queue = Queue.new
+      @join_cond = @threads_mon.new_cond
+
+      @history_start_time = nil
+      @history = []
+      @history_mon = Monitor.new
+      @total_threads_in_play = 0
+    end
+
+    # Creates a future executed by the +ThreadPool+.
+    #
+    # The args are passed to the block when executing (similarly to
+    # Thread#new) The return value is an object representing
+    # a future which has been created and added to the queue in the
+    # pool. Sending #value to the object will sleep the
+    # current thread until the future is finished and will return the
+    # result (or raise an exception thrown from the future)
+    def future(*args, &block)
+      promise = Promise.new(args, &block)
+      promise.recorder = lambda { |*stats| stat(*stats) }
+
+      @queue.enq promise
+      stat :queued, item_id: promise.object_id
+      start_thread
+      promise
+    end
+
+    # Waits until the queue of futures is empty and all threads have exited.
+    def join
+      @threads_mon.synchronize do
+        begin
+          stat :joining
+          @join_cond.wait unless @threads.empty?
+          stat :joined
+        rescue Exception => e
+          stat :joined
+          $stderr.puts e
+          $stderr.print "Queue contains #{@queue.size} items. " +
+            "Thread pool contains #{@threads.count} threads\n"
+          $stderr.print "Current Thread #{Thread.current} status = " +
+            "#{Thread.current.status}\n"
+          $stderr.puts e.backtrace.join("\n")
+          @threads.each do |t|
+            $stderr.print "Thread #{t} status = #{t.status}\n"
+            $stderr.puts t.backtrace.join("\n")
+          end
+          raise e
+        end
+      end
+    end
+
+    # Enable the gathering of history events.
+    def gather_history          #:nodoc:
+      @history_start_time = Time.now if @history_start_time.nil?
+    end
+
+    # Return a array of history events for the thread pool.
+    #
+    # History gathering must be enabled to be able to see the events
+    # (see #gather_history). Best to call this when the job is
+    # complete (i.e. after ThreadPool#join is called).
+    def history                 # :nodoc:
+      @history_mon.synchronize { @history.dup }.
+        sort_by { |i| i[:time] }.
+        each { |i| i[:time] -= @history_start_time }
+    end
+
+    # Return a hash of always collected statistics for the thread pool.
+    def statistics              #  :nodoc:
+      {
+        total_threads_in_play: @total_threads_in_play,
+        max_active_threads: @max_active_threads,
+      }
+    end
+
+    private
+
+    # processes one item on the queue. Returns true if there was an
+    # item to process, false if there was no item
+    def process_queue_item      #:nodoc:
+      return false if @queue.empty?
+
+      # Even though we just asked if the queue was empty, it
+      # still could have had an item which by this statement
+      # is now gone. For this reason we pass true to Queue#deq
+      # because we will sleep indefinitely if it is empty.
+      promise = @queue.deq(true)
+      stat :dequeued, item_id: promise.object_id
+      promise.work
+      return true
+
+    rescue ThreadError # this means the queue is empty
+      false
+    end
+
+    def start_thread # :nodoc:
+      @threads_mon.synchronize do
+        next unless @threads.count < @max_active_threads
+
+        t = Thread.new do
+          begin
+            loop do
+              break unless process_queue_item
+            end
+          ensure
+            @threads_mon.synchronize do
+              @threads.delete Thread.current
+              stat :ended, thread_count: @threads.count
+              @join_cond.broadcast if @threads.empty?
+            end
+          end
+        end
+
+        @threads << t
+        stat(
+          :spawned,
+          new_thread: t.object_id,
+          thread_count: @threads.count)
+        @total_threads_in_play = @threads.count if
+          @threads.count > @total_threads_in_play
+      end
+    end
+
+    def stat(event, data=nil) # :nodoc:
+      return if @history_start_time.nil?
+      info = {
+        event: event,
+        data: data,
+        time: Time.now,
+        thread: Thread.current.object_id,
+      }
+      @history_mon.synchronize { @history << info }
+    end
+
+    # for testing only
+
+    def __queue__ # :nodoc:
+      @queue
+    end
+  end
+
+end

data/lib/rake/trace_output.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+module Rake
+  module TraceOutput # :nodoc: all
+
+    # Write trace output to output stream +out+.
+    #
+    # The write is done as a single IO call (to print) to lessen the
+    # chance that the trace output is interrupted by other tasks also
+    # producing output.
+    def trace_on(out, *strings)
+      sep = $\ || "\n"
+      if strings.empty?
+        output = sep
+      else
+        output = strings.map { |s|
+          next if s.nil?
+          s.end_with?(sep) ? s : s + sep
+        }.join
+      end
+      out.print(output)
+    end
+  end
+end

data/lib/rake/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+module Rake
+  VERSION = "13.4.2"
+
+  module Version # :nodoc: all
+    MAJOR, MINOR, BUILD, *OTHER = Rake::VERSION.split "."
+
+    NUMBERS = [MAJOR, MINOR, BUILD, *OTHER]
+  end
+end

data/lib/rake/win32.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+require "rbconfig"
+
+module Rake
+  # Win 32 interface methods for Rake. Windows specific functionality
+  # will be placed here to collect that knowledge in one spot.
+  module Win32 # :nodoc: all
+
+    class << self
+      # True if running on a windows system.
+      def windows?
+        RbConfig::CONFIG["host_os"] =~ %r!(msdos|mswin|djgpp|mingw|[Ww]indows)!
+      end
+    end
+
+  end
+end

data/lib/rake.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+#--
+# Copyright 2003-2010 by Jim Weirich (jim.weirich@gmail.com)
+#
+# 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.
+#++
+
+module Rake; end
+
+require_relative "rake/version"
+
+require "rbconfig"
+require "fileutils"
+require "singleton"
+require "monitor"
+require "optparse"
+
+require_relative "rake/ext/string"
+
+require_relative "rake/win32"
+
+require_relative "rake/linked_list"
+require_relative "rake/cpu_counter"
+require_relative "rake/scope"
+require_relative "rake/task_argument_error"
+require_relative "rake/rule_recursion_overflow_error"
+require_relative "rake/rake_module"
+require_relative "rake/trace_output"
+require_relative "rake/pseudo_status"
+require_relative "rake/options"
+require_relative "rake/task_arguments"
+require_relative "rake/invocation_chain"
+require_relative "rake/task"
+require_relative "rake/file_task"
+require_relative "rake/file_creation_task"
+require_relative "rake/multi_task"
+require_relative "rake/dsl_definition"
+require_relative "rake/file_utils_ext"
+require_relative "rake/file_list"
+require_relative "rake/default_loader"
+require_relative "rake/early_time"
+require_relative "rake/late_time"
+require_relative "rake/name_space"
+require_relative "rake/task_manager"
+require_relative "rake/application"
+require_relative "rake/backtrace"
+
+# :stopdoc:
+#
+# Some top level Constants.
+
+FileList = Rake::FileList
+RakeFileUtils = Rake::FileUtilsExt

data/rake.gemspec

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require_relative "lib/rake/version"
+
+Gem::Specification.new do |s|
+  s.name = 'rake-clone'
+  s.version = Rake::VERSION
+  s.authors = ["Hiroshi SHIBATA", "Eric Hodel", "Jim Weirich"]
+  s.email = ["hsbt@ruby-lang.org", "drbrain@segment7.net", ""]
+
+  s.summary = "Rake is a Make-like program implemented in Ruby"
+  s.description = <<~DESCRIPTION
+    Rake is a Make-like program implemented in Ruby. Tasks and dependencies are
+    specified in standard Ruby syntax.
+    Rake has the following features:
+      * Rakefiles (rake's version of Makefiles) are completely defined in standard Ruby syntax.
+        No XML files to edit. No quirky Makefile syntax to worry about (is that a tab or a space?)
+      * Users can specify tasks with prerequisites.
+      * Rake supports rule patterns to synthesize implicit tasks.
+      * Flexible FileLists that act like arrays but know about manipulating file names and paths.
+      * Supports parallel execution of tasks.
+  DESCRIPTION
+  s.homepage = "https://github.com/ruby/rake"
+  s.licenses = ["MIT"]
+
+  s.metadata = {
+    "bug_tracker_uri" => "https://github.com/ruby/rake/issues",
+    "changelog_uri" => "https://github.com/ruby/rake/releases",
+    "documentation_uri" => "https://ruby.github.io/rake",
+    "source_code_uri" => s.homepage
+  }
+
+  s.files = [
+    "History.rdoc",
+    "MIT-LICENSE",
+    "README.rdoc",
+    "doc/command_line_usage.rdoc",
+    "doc/example/Rakefile1",
+    "doc/example/Rakefile2",
+    "doc/example/a.c",
+    "doc/example/b.c",
+    "doc/example/main.c",
+    "doc/glossary.rdoc",
+    "doc/jamis.rb",
+    "doc/proto_rake.rdoc",
+    "doc/rake.1",
+    "doc/rakefile.rdoc",
+    "doc/rational.rdoc",
+    "exe/rake",
+    "lib/rake.rb",
+    "lib/rake/application.rb",
+    "lib/rake/backtrace.rb",
+    "lib/rake/clean.rb",
+    "lib/rake/cloneable.rb",
+    "lib/rake/cpu_counter.rb",
+    "lib/rake/default_loader.rb",
+    "lib/rake/dsl_definition.rb",
+    "lib/rake/early_time.rb",
+    "lib/rake/ext/core.rb",
+    "lib/rake/ext/string.rb",
+    "lib/rake/file_creation_task.rb",
+    "lib/rake/file_list.rb",
+    "lib/rake/file_task.rb",
+    "lib/rake/file_utils.rb",
+    "lib/rake/file_utils_ext.rb",
+    "lib/rake/invocation_chain.rb",
+    "lib/rake/invocation_exception_mixin.rb",
+    "lib/rake/late_time.rb",
+    "lib/rake/linked_list.rb",
+    "lib/rake/loaders/makefile.rb",
+    "lib/rake/multi_task.rb",
+    "lib/rake/name_space.rb",
+    "lib/rake/options.rb",
+    "lib/rake/packagetask.rb",
+    "lib/rake/phony.rb",
+    "lib/rake/private_reader.rb",
+    "lib/rake/promise.rb",
+    "lib/rake/pseudo_status.rb",
+    "lib/rake/rake_module.rb",
+    "lib/rake/rake_test_loader.rb",
+    "lib/rake/rule_recursion_overflow_error.rb",
+    "lib/rake/scope.rb",
+    "lib/rake/task.rb",
+    "lib/rake/task_argument_error.rb",
+    "lib/rake/task_arguments.rb",
+    "lib/rake/task_manager.rb",
+    "lib/rake/tasklib.rb",
+    "lib/rake/testtask.rb",
+    "lib/rake/thread_history_display.rb",
+    "lib/rake/thread_pool.rb",
+    "lib/rake/trace_output.rb",
+    "lib/rake/version.rb",
+    "lib/rake/win32.rb",
+    "rake.gemspec"
+  ]
+  s.bindir = "exe"
+  s.executables = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.required_ruby_version = Gem::Requirement.new(">= 2.3")
+  s.rdoc_options = ["--main", "README.rdoc"]
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: rake-clone
+version: !ruby/object:Gem::Version
+  version: 13.4.2
+platform: ruby
+authors:
+- Hiroshi SHIBATA
+- Eric Hodel
+- Jim Weirich
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: |
+  Rake is a Make-like program implemented in Ruby. Tasks and dependencies are
+  specified in standard Ruby syntax.
+  Rake has the following features:
+    * Rakefiles (rake's version of Makefiles) are completely defined in standard Ruby syntax.
+      No XML files to edit. No quirky Makefile syntax to worry about (is that a tab or a space?)
+    * Users can specify tasks with prerequisites.
+    * Rake supports rule patterns to synthesize implicit tasks.
+    * Flexible FileLists that act like arrays but know about manipulating file names and paths.
+    * Supports parallel execution of tasks.
+email:
+- hsbt@ruby-lang.org
+- drbrain@segment7.net
+- ''
+executables:
+- rake
+extensions: []
+extra_rdoc_files: []
+files:
+- History.rdoc
+- MIT-LICENSE
+- README.rdoc
+- doc/command_line_usage.rdoc
+- doc/example/Rakefile1
+- doc/example/Rakefile2
+- doc/example/a.c
+- doc/example/b.c
+- doc/example/main.c
+- doc/glossary.rdoc
+- doc/jamis.rb
+- doc/proto_rake.rdoc
+- doc/rake.1
+- doc/rakefile.rdoc
+- doc/rational.rdoc
+- exe/rake
+- lib/rake.rb
+- lib/rake/application.rb
+- lib/rake/backtrace.rb
+- lib/rake/clean.rb
+- lib/rake/cloneable.rb
+- lib/rake/cpu_counter.rb
+- lib/rake/default_loader.rb
+- lib/rake/dsl_definition.rb
+- lib/rake/early_time.rb
+- lib/rake/ext/core.rb
+- lib/rake/ext/string.rb
+- lib/rake/file_creation_task.rb
+- lib/rake/file_list.rb
+- lib/rake/file_task.rb
+- lib/rake/file_utils.rb
+- lib/rake/file_utils_ext.rb
+- lib/rake/invocation_chain.rb
+- lib/rake/invocation_exception_mixin.rb
+- lib/rake/late_time.rb
+- lib/rake/linked_list.rb
+- lib/rake/loaders/makefile.rb
+- lib/rake/multi_task.rb
+- lib/rake/name_space.rb
+- lib/rake/options.rb
+- lib/rake/packagetask.rb
+- lib/rake/phony.rb
+- lib/rake/private_reader.rb
+- lib/rake/promise.rb
+- lib/rake/pseudo_status.rb
+- lib/rake/rake_module.rb
+- lib/rake/rake_test_loader.rb
+- lib/rake/rule_recursion_overflow_error.rb
+- lib/rake/scope.rb
+- lib/rake/task.rb
+- lib/rake/task_argument_error.rb
+- lib/rake/task_arguments.rb
+- lib/rake/task_manager.rb
+- lib/rake/tasklib.rb
+- lib/rake/testtask.rb
+- lib/rake/thread_history_display.rb
+- lib/rake/thread_pool.rb
+- lib/rake/trace_output.rb
+- lib/rake/version.rb
+- lib/rake/win32.rb
+- rake.gemspec
+homepage: https://github.com/ruby/rake
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/ruby/rake/issues
+  changelog_uri: https://github.com/ruby/rake/releases
+  documentation_uri: https://ruby.github.io/rake
+  source_code_uri: https://github.com/ruby/rake
+rdoc_options:
+- "--main"
+- README.rdoc
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.15
+specification_version: 4
+summary: Rake is a Make-like program implemented in Ruby
+test_files: []