kinetic_sdk 5.0.19 → 5.0.20

data/gems/yard-0.9.25/lib/yard/rubygems/backports/source_index.rb

@@ -0,0 +1,365 @@
+# frozen_string_literal: true
+#--
+# Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others.
+# All rights reserved.
+# See LICENSE.txt for permissions.
+#++
+
+require 'rubygems/specification'
+
+##
+# The SourceIndex object indexes all the gems available from a
+# particular source (e.g. a list of gem directories, or a remote
+# source).  A SourceIndex maps a gem full name to a gem
+# specification.
+#
+# NOTE:: The class used to be named Cache, but that became
+#        confusing when cached source fetchers where introduced. The
+#        constant Gem::Cache is an alias for this class to allow old
+#        YAMLized source index objects to load properly.
+
+class Gem::SourceIndex
+  # Undef old methods
+  alias old_initialize initialize
+  undef old_initialize
+  %w(all_gems prerelease_gems load_gems_in latest_specs prerelease_specs
+      released_specs add_spec add_specs remove_spec each specification
+      index_signature gem_signature size length find_name search released_gems
+      refresh! outdated == dump gems spec_dirs spec_dirs=).each do |meth|
+    undef_method(meth) if method_defined?(meth)
+  end
+
+  include Enumerable
+
+  attr_reader :gems # :nodoc:
+
+  ##
+  # Directories to use to refresh this SourceIndex when calling refresh!
+
+  attr_accessor :spec_dirs
+
+  class << self
+    # Undef old methods
+    %w(from_installed_gems installed_spec_directories
+        from_gems_in load_specification).each do |meth|
+      undef_method(meth) if instance_methods(true).find {|m| m.to_s == meth }
+    end
+
+    ##
+    # Factory method to construct a source index instance for a given
+    # path.
+    #
+    # deprecated::
+    #   If supplied, from_installed_gems will act just like
+    #   +from_gems_in+.  This argument is deprecated and is provided
+    #   just for backwards compatibility, and should not generally
+    #   be used.
+    #
+    # return::
+    #   SourceIndex instance
+
+    def from_installed_gems(*deprecated)
+      if deprecated.empty?
+        from_gems_in(*installed_spec_directories)
+      else
+        from_gems_in(*deprecated) # HACK: warn
+      end
+    end
+
+    ##
+    # Returns a list of directories from Gem.path that contain specifications.
+
+    def installed_spec_directories
+      Gem.path.collect {|dir| File.join(dir, "specifications") }
+    end
+
+    ##
+    # Creates a new SourceIndex from the ruby format gem specifications in
+    # +spec_dirs+.
+
+    def from_gems_in(*spec_dirs)
+      source_index = new
+      source_index.spec_dirs = spec_dirs
+      source_index.refresh!
+    end
+
+    ##
+    # Loads a ruby-format specification from +file_name+ and returns the
+    # loaded spec.
+
+    def load_specification(file_name)
+      Gem::Specification.load file_name
+    end
+  end
+
+  ##
+  # Constructs a source index instance from the provided specifications, which
+  # is a Hash of gem full names and Gem::Specifications.
+  #--
+  # TODO merge @gems and @prerelease_gems and provide a separate method
+  # #prerelease_gems
+
+  def initialize(specifications = {})
+    @gems = {}
+    specifications.each {|_full_name, spec| add_spec spec }
+    @spec_dirs = nil
+  end
+
+  # TODO: remove method
+  def all_gems
+    @gems
+  end
+
+  def prerelease_gems
+    @gems.reject {|_name, gem| !gem.version.prerelease? }
+  end
+
+  def released_gems
+    @gems.reject {|_name, gem| gem.version.prerelease? }
+  end
+
+  ##
+  # Reconstruct the source index from the specifications in +spec_dirs+.
+
+  def load_gems_in(*spec_dirs)
+    @gems.clear
+
+    spec_dirs.reverse_each do |spec_dir|
+      spec_files = Dir.glob File.join(spec_dir, '*.gemspec')
+
+      spec_files.each do |spec_file|
+        gemspec = Gem::Specification.load spec_file
+        add_spec gemspec if gemspec
+      end
+    end
+
+    self
+  end
+
+  ##
+  # Returns an Array specifications for the latest released versions
+  # of each gem in this index.
+
+  def latest_specs(include_prerelease = false)
+    result = Hash.new {|h, k| h[k] = [] }
+    latest = {}
+
+    sort.each do |_, spec|
+      name = spec.name
+      curr_ver = spec.version
+      prev_ver = latest.key?(name) ? latest[name].version : nil
+
+      next if !include_prerelease && curr_ver.prerelease?
+      next unless prev_ver.nil? || curr_ver >= prev_ver ||
+                  latest[name].platform != Gem::Platform::RUBY
+
+      if prev_ver.nil? ||
+         (curr_ver > prev_ver && spec.platform == Gem::Platform::RUBY)
+        result[name].clear
+        latest[name] = spec
+      end
+
+      if spec.platform != Gem::Platform::RUBY
+        result[name].delete_if do |result_spec|
+          result_spec.platform == spec.platform
+        end
+      end
+
+      result[name] << spec
+    end
+
+    # TODO: why is this a hash while @gems is an array? Seems like
+    # structural similarity would be good.
+    result.values.flatten
+  end
+
+  ##
+  # An array including only the prerelease gemspecs
+
+  def prerelease_specs
+    prerelease_gems.values
+  end
+
+  ##
+  # An array including only the released gemspecs
+
+  def released_specs
+    released_gems.values
+  end
+
+  ##
+  # Add a gem specification to the source index.
+
+  def add_spec(gem_spec, name = gem_spec.full_name)
+    # No idea why, but the Indexer wants to insert them using original_name
+    # instead of full_name. So we make it an optional arg.
+    @gems[name] = gem_spec
+  end
+
+  ##
+  # Add gem specifications to the source index.
+
+  def add_specs(*gem_specs)
+    gem_specs.each do |spec|
+      add_spec spec
+    end
+  end
+
+  ##
+  # Remove a gem specification named +full_name+.
+
+  def remove_spec(full_name)
+    @gems.delete full_name
+  end
+
+  ##
+  # Iterate over the specifications in the source index.
+
+  def each(&block) # :yields: gem.full_name, gem
+    @gems.each(&block)
+  end
+
+  ##
+  # The gem specification given a full gem spec name.
+
+  def specification(full_name)
+    @gems[full_name]
+  end
+
+  ##
+  # The signature for the source index.  Changes in the signature indicate a
+  # change in the index.
+
+  def index_signature
+    require 'digest'
+
+    Digest::SHA256.new.hexdigest(@gems.keys.sort.join(',')).to_s
+  end
+
+  ##
+  # The signature for the given gem specification.
+
+  def gem_signature(gem_full_name)
+    require 'digest'
+
+    Digest::SHA256.new.hexdigest(@gems[gem_full_name].to_yaml).to_s
+  end
+
+  def size
+    @gems.size
+  end
+  alias length size
+
+  ##
+  # Find a gem by an exact match on the short name.
+
+  def find_name(gem_name, requirement = Gem::Requirement.default)
+    dep = Gem::Dependency.new gem_name, requirement
+    search dep
+  end
+
+  ##
+  # Search for a gem by Gem::Dependency +gem_pattern+.  If +only_platform+
+  # is true, only gems matching Gem::Platform.local will be returned.  An
+  # Array of matching Gem::Specification objects is returned.
+  #
+  # For backwards compatibility, a String or Regexp pattern may be passed as
+  # +gem_pattern+, and a Gem::Requirement for +platform_only+.  This
+  # behavior is deprecated and will be removed.
+
+  def search(gem_pattern, platform_only = false)
+    requirement = nil
+    only_platform = false
+
+    # TODO: Remove support and warning for legacy arguments after 2008/11
+    unless Gem::Dependency === gem_pattern
+      warn "#{Gem.location_of_caller.join ':'}:Warning: Gem::SourceIndex#search support for #{gem_pattern.class} patterns is deprecated, use #find_name"
+    end
+
+    case gem_pattern
+    when Regexp then
+      requirement = platform_only || Gem::Requirement.default
+    when Gem::Dependency then
+      only_platform = platform_only
+      requirement = gem_pattern.requirement
+
+      gem_pattern = if Regexp === gem_pattern.name
+                      gem_pattern.name
+                    elsif gem_pattern.name.empty?
+                      //
+                    else
+                      /^#{Regexp.escape gem_pattern.name}$/
+                    end
+    else
+      requirement = platform_only || Gem::Requirement.default
+      gem_pattern = /#{gem_pattern}/i
+    end
+
+    unless Gem::Requirement === requirement
+      requirement = Gem::Requirement.create requirement
+    end
+
+    specs = all_gems.values.select do |spec|
+      spec.name =~ gem_pattern &&
+        requirement.satisfied_by?(spec.version)
+    end
+
+    if only_platform
+      specs = specs.select do |spec|
+        Gem::Platform.match spec.platform
+      end
+    end
+
+    specs.sort_by(&:sort_obj)
+  end
+
+  ##
+  # Replaces the gems in the source index from specifications in the
+  # directories this source index was created from.  Raises an exception if
+  # this source index wasn't created from a directory (via from_gems_in or
+  # from_installed_gems, or having spec_dirs set).
+
+  def refresh!
+    raise 'source index not created from disk' if @spec_dirs.nil?
+    load_gems_in(*@spec_dirs)
+  end
+
+  ##
+  # Returns an Array of Gem::Specifications that are not up to date.
+
+  def outdated
+    outdateds = []
+
+    latest_specs.each do |local|
+      dependency = Gem::Dependency.new local.name, ">= #{local.version}"
+
+      fetcher = Gem::SpecFetcher.fetcher
+      remotes = fetcher.find_matching dependency
+      remotes = remotes.map {|(_, version, _), _| version }
+
+      latest = remotes.sort.last
+
+      outdateds << local.name if latest && local.version < latest
+    end
+
+    outdateds
+  end
+
+  def ==(other) # :nodoc:
+    self.class === other && @gems == other.gems
+  end
+
+  def dump
+    Marshal.dump(self)
+  end
+end
+
+# :stopdoc:
+module Gem
+  ##
+  # Cache is an alias for SourceIndex to allow older YAMLized source index
+  # objects to load properly.
+
+  Cache = SourceIndex unless defined?(Cache)
+end
+# :startdoc:

data/gems/yard-0.9.25/lib/yard/rubygems/backports.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+begin
+  require 'rubygems'
+  if defined?(Gem::VERSION) && Gem::VERSION >= '1.8.0'
+    require File.dirname(__FILE__) + '/backports/gem'
+    require File.dirname(__FILE__) + '/backports/source_index'
+  end
+rescue LoadError
+  nil # noop
+end

data/gems/yard-0.9.25/lib/yard/rubygems/doc_manager.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+begin
+  require 'rubygems/user_interaction'
+  require 'rubygems/doc_manager'
+rescue LoadError
+  nil # noop
+end
+
+class Gem::DocManager
+  def self.load_yardoc
+    require File.expand_path(File.join(File.dirname(__FILE__), *%w(.. .. yard)))
+  end
+
+  def run_yardoc(*args)
+    args << '--quiet'
+    args << '--backtrace' if Gem.configuration.backtrace
+    unless File.file?(File.join(@spec.full_gem_path, '.yardopts'))
+      args << @spec.require_paths
+      unless @spec.extra_rdoc_files.empty?
+        args << '-'
+        args += @spec.extra_rdoc_files
+      end
+    end
+    args = args.flatten.map(&:to_s)
+
+    old_pwd = Dir.pwd
+    Dir.chdir(@spec.full_gem_path)
+    YARD::CLI::Yardoc.run(*args)
+  rescue Errno::EACCES => e
+    dirname = File.dirname e.message.split("-")[1].strip
+    raise Gem::FilePermissionError, dirname
+  rescue => ex
+    alert_error "While generating documentation for #{@spec.full_name}"
+    ui.errs.puts "... MESSAGE:   #{ex}"
+    ui.errs.puts "... YARDOC args: #{args.join(' ')}"
+    ui.errs.puts "\t#{ex.backtrace.join("\n\t")}" if Gem.configuration.backtrace
+    ui.errs.puts "(continuing with the rest of the installation)"
+  ensure
+    Dir.chdir(old_pwd)
+  end
+
+  begin undef setup_rdoc; rescue NameError; nil end
+  def setup_rdoc
+    if File.exist?(@doc_dir) && !File.writable?(@doc_dir)
+      raise Gem::FilePermissionError, @doc_dir
+    end
+
+    FileUtils.mkdir_p @doc_dir unless File.exist?(@doc_dir)
+
+    self.class.load_rdoc if @spec.has_rdoc?
+    self.class.load_yardoc if @spec.has_yardoc?
+  end
+
+  def install_yardoc
+    rdoc_dir = File.join(@doc_dir, 'rdoc')
+
+    FileUtils.rm_rf rdoc_dir
+
+    say "Installing YARD documentation for #{@spec.full_name}..."
+    run_yardoc '-o', rdoc_dir
+  end
+
+  def install_ri_yard
+    install_ri_yard_orig if @spec.has_rdoc?
+    return if @spec.has_rdoc? == false
+    return if @spec.has_yardoc?
+
+    self.class.load_yardoc
+    say "Building YARD (yri) index for #{@spec.full_name}..."
+    run_yardoc '-c', '-n'
+  end
+
+  begin
+    alias install_ri_yard_orig install_ri
+    alias install_ri install_ri_yard
+  rescue NameError; nil end
+
+  def install_rdoc_yard
+    if @spec.has_rdoc?
+      install_rdoc_yard_orig
+    elsif @spec.has_yardoc?
+      install_yardoc
+    end
+  end
+
+  begin
+    alias install_rdoc_yard_orig install_rdoc
+    alias install_rdoc install_rdoc_yard
+  rescue NameError; nil end
+end

data/gems/yard-0.9.25/lib/yard/rubygems/hook.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+require 'rubygems'
+require 'rubygems/user_interaction'
+require 'fileutils'
+
+##
+# Gem::YARDoc provides methods to generate YARDoc and yri data for installed gems
+# upon gem installation.
+#
+# This file is automatically required by RubyGems 1.9 and newer.
+
+module YARD
+  class RubygemsHook
+    include Gem::UserInteraction
+    extend Gem::UserInteraction
+
+    @yard_version = nil
+
+    ##
+    # Force installation of documentation?
+
+    attr_accessor :force
+
+    ##
+    # Generate yard?
+
+    attr_accessor :generate_yard
+
+    ##
+    # Generate yri data?
+
+    attr_accessor :generate_yri
+
+    class << self
+      ##
+      # Loaded version of YARD. Set by ::load_yard
+
+      attr_reader :yard_version
+    end
+
+    ##
+    # Post installs hook that generates documentation for each specification in
+    # +specs+
+
+    def self.generation_hook(installer, specs)
+      start = Time.now
+      types = installer.document
+
+      generate_yard = types.include?('yardoc') || types.include?('yard')
+      generate_yri = types.include? 'yri'
+
+      specs.each do |spec|
+        gen_yard = generate_yard
+        gen_yri = generate_yri
+        gen_yri = false if gen_yard # never generate both, no need
+        unless types.empty? # --no-document is not in effect
+          # look at spec.metadata['yard.run'] for override
+          run_yard = spec.metadata['yard.run']
+          gen_yard = true if run_yard && run_yard != 'yri'
+          gen_yri = true if run_yard == 'yri'
+        end
+
+        new(spec, gen_yard, gen_yri).generate
+      end
+
+      return unless generate_yard || generate_yri
+
+      duration = (Time.now - start).to_i
+      names = specs.map(&:name).join ', '
+
+      say "Done installing documentation for #{names} after #{duration} seconds"
+    end
+
+    ##
+    # Pre uninstalls hook that removes documentation
+    #
+
+    def self.removal_hook(uninstaller)
+      new(uninstaller.spec).remove
+    end
+
+    ##
+    # Loads the YARD generator
+
+    def self.load_yard
+      return if @yard_version
+
+      require 'yard'
+
+      @yard_version = Gem::Version.new ::YARD::VERSION
+    end
+
+    def initialize(spec, generate_yard = false, generate_yri = true)
+      @doc_dir = spec.doc_dir
+      @force = false
+      @spec = spec
+
+      @generate_yard = generate_yard
+      @generate_yri = generate_yri
+
+      @yard_dir = spec.doc_dir('yard')
+      @yri_dir = spec.doc_dir('.yardoc')
+    end
+
+    def run_yardoc(*args)
+      args << '--quiet' unless Gem.configuration.really_verbose
+      args << '--backtrace' if Gem.configuration.backtrace
+      unless File.file?(File.join(@spec.full_gem_path, '.yardopts'))
+        args << @spec.require_paths
+        unless @spec.extra_rdoc_files.empty?
+          args << '-'
+          args += @spec.extra_rdoc_files
+        end
+      end
+      args = args.flatten.map(&:to_s)
+
+      Dir.chdir(@spec.full_gem_path) do
+        YARD::CLI::Yardoc.run(*args)
+      end
+    rescue Errno::EACCES => e
+      dirname = File.dirname e.message.split("-")[1].strip
+      raise Gem::FilePermissionError, dirname
+    rescue => ex
+      alert_error "While generating documentation for #{@spec.full_name}"
+      ui.errs.puts "... MESSAGE:   #{ex}"
+      ui.errs.puts "... YARDOC args: #{args.join(' ')}"
+      ui.errs.puts "\t#{ex.backtrace.join("\n\t")}" if Gem.configuration.backtrace
+      ui.errs.puts "(continuing with the rest of the installation)"
+    end
+
+    def install_yard
+      FileUtils.rm_rf @yard_dir
+
+      say "Installing YARD documentation for #{@spec.full_name}..."
+      run_yardoc '--no-progress', '--db', @yri_dir, '-o', @yard_dir
+    end
+
+    def install_yri
+      FileUtils.rm_rf @yri_dir
+
+      say "Building YARD (yri) index for #{@spec.full_name}..."
+      run_yardoc '--no-progress', '-c', '-n', '--db', @yri_dir
+    end
+
+    ##
+    # Generates YARD and yri data
+
+    def generate
+      return if @spec.default_gem?
+      return unless @generate_yri || @generate_yard
+
+      setup
+
+      install_yri if @generate_yri && (@force || !File.exist?(@yri_dir))
+
+      install_yard if @generate_yard && (@force || !File.exist?(@yard_dir))
+    end
+
+    ##
+    # Prepares the spec for documentation generation
+
+    def setup
+      self.class.load_yard
+
+      if File.exist?(@doc_dir)
+        raise Gem::FilePermissionError, @doc_dir unless File.writable?(@doc_dir)
+      else
+        FileUtils.mkdir_p @doc_dir
+      end
+    end
+
+    def uninstall_yard
+      if File.exist?(@yard_dir)
+        raise Gem::FilePermissionError, @yard_dir unless File.writable?(@yard_dir)
+        FileUtils.rm_rf @yard_dir
+      end
+    end
+
+    def uninstall_yri
+      if File.exist?(@yri_dir)
+        raise Gem::FilePermissionError, @yri_dir unless File.writable?(@yri_dir)
+        FileUtils.rm_rf @yri_dir
+      end
+    end
+
+    ##
+    # Removes YARD and yri data
+
+    def remove
+      uninstall_yri
+      uninstall_yard
+    end
+  end
+end
+
+Gem.done_installing(&YARD::RubygemsHook.method(:generation_hook))
+Gem.pre_uninstall(&YARD::RubygemsHook.method(:removal_hook))

data/gems/yard-0.9.25/lib/yard/rubygems/specification.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+require 'rubygems/specification'
+
+class Gem::Specification
+  # @since 0.5.3
+  def has_yardoc=(value)
+    @has_rdoc = value ? 'yard' : false
+  end
+
+  def has_yardoc
+    @has_rdoc == 'yard'
+  end
+
+  undef has_rdoc?
+  def has_rdoc?
+    (@has_rdoc ||= true) && @has_rdoc != 'yard'
+  end
+
+  alias has_yardoc? has_yardoc
+
+  # has_rdoc should not be ignored!
+  if respond_to?(:overwrite_accessor)
+    overwrite_accessor(:has_rdoc) { @has_rdoc ||= true }
+    overwrite_accessor(:has_rdoc=) {|v| @has_rdoc = v }
+  else
+    attr_accessor :has_rdoc
+  end
+
+  if defined?(Gem::VERSION) && Gem::VERSION >= '1.7.'
+    def _dump_with_rdoc(limit)
+      dmp = _dump_without_rdoc(limit)
+      dmp[15] = @has_rdoc if dmp[15] == true
+      dmp
+    end
+    alias _dump_without_rdoc _dump
+    alias _dump _dump_with_rdoc
+
+    if class_variable_defined?(:@@default_value)
+      if @@default_value.frozen?
+        t = @@default_value.dup
+        t[:has_rdoc] = true
+        @@default_value = t.freeze
+      else
+        @@default_value[:has_rdoc] = true
+      end
+    end
+    @@attributes << 'has_rdoc' if class_variable_defined?(:@@attributes)
+    @@nil_attributes << 'has_rdoc' if class_variable_defined?(:@@nil_attributes)
+  end
+end