mega-max-hub 0.0.1

data/rdoc-8.0.0/exe/rdoc

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+#
+#  RDoc: Documentation tool for source code
+#        (see lib/rdoc/rdoc.rb for more information)
+#
+#  Copyright (c) 2003 Dave Thomas
+#  Released under the same terms as Ruby
+
+begin
+  gem 'rdoc'
+rescue NameError => e # --disable-gems
+  raise unless e.name == :gem
+rescue Gem::LoadError
+end
+
+require 'rdoc/rdoc'
+
+begin
+  r = RDoc::RDoc.new
+  r.document ARGV
+rescue Errno::ENOSPC
+  $stderr.puts 'Ran out of space creating documentation'
+  $stderr.puts
+  $stderr.puts 'Please free up some space and try again'
+rescue SystemExit
+  raise
+rescue Exception => e
+  if $DEBUG_RDOC then
+    $stderr.puts e.message
+    $stderr.puts "#{e.backtrace.join "\n\t"}"
+    $stderr.puts
+  elsif Interrupt === e then
+    $stderr.puts
+    $stderr.puts 'Interrupted'
+  else
+    $stderr.puts "uh-oh! RDoc had a problem:"
+    $stderr.puts e.message
+    $stderr.puts
+    $stderr.puts "run with --debug for full backtrace"
+  end
+
+  exit 1
+end

data/rdoc-8.0.0/exe/ri

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+begin
+  gem 'rdoc'
+rescue NameError => e # --disable-gems
+  raise unless e.name == :gem
+rescue Gem::LoadError
+end
+
+require 'rdoc/ri/driver'
+
+RDoc::RI::Driver.run ARGV

data/rdoc-8.0.0/lib/rdoc/code_object/alias.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+##
+# Represent an alias, which is an old_name/new_name pair associated with a
+# particular context
+#--
+# TODO implement Alias as a proxy to a method/attribute, inheriting from
+#      MethodAttr
+
+class RDoc::Alias < RDoc::CodeObject
+
+  ##
+  # Aliased method's name
+
+  attr_reader :new_name
+
+  alias name new_name
+
+  ##
+  # Aliasee method's name
+
+  attr_reader :old_name
+
+  ##
+  # Is this an alias declared in a singleton context?
+
+  attr_reader :singleton
+
+  ##
+  # Creates a new Alias that aliases +old_name+
+  # to +new_name+, has +comment+ and is a +singleton+ context.
+
+  def initialize(old_name, new_name, comment, singleton: false)
+    super()
+
+    @singleton = singleton
+    @old_name = old_name
+    @new_name = new_name
+    self.comment = comment
+  end
+
+  ##
+  # Order by #singleton then #new_name
+
+  def <=>(other)
+    [@singleton ? 0 : 1, new_name] <=> [other.singleton ? 0 : 1, other.new_name]
+  end
+
+  ##
+  # HTML fragment reference for this alias
+
+  def aref
+    type = singleton ? 'c' : 'i'
+    "#alias-#{type}-#{html_name}"
+  end
+
+  ##
+  # HTML id-friendly version of +#new_name+.
+
+  def html_name
+    CGI.escape(@new_name.gsub('-', '-2D')).gsub('%', '-').sub(/^-/, '')
+  end
+
+  def inspect # :nodoc:
+    parent_name = parent ? parent.name : '(unknown)'
+    "#<%s:0x%x %s.alias_method %s, %s>" % [
+      self.class, object_id,
+      parent_name, @old_name, @new_name,
+    ]
+  end
+
+  ##
+  # '::' for the alias of a singleton method/attribute, '#' for instance-level.
+
+  def name_prefix
+    singleton ? '::' : '#'
+  end
+
+  ##
+  # Old name with prefix '::' or '#'.
+
+  def pretty_old_name
+    "#{singleton ? '::' : '#'}#{@old_name}"
+  end
+
+  ##
+  # New name with prefix '::' or '#'.
+
+  def pretty_new_name
+    "#{singleton ? '::' : '#'}#{@new_name}"
+  end
+
+  alias pretty_name pretty_new_name
+
+  def to_s # :nodoc:
+    "alias: #{self.new_name} -> #{self.pretty_old_name} in: #{parent}"
+  end
+
+end

data/rdoc-8.0.0/lib/rdoc/code_object/any_method.rb

@@ -0,0 +1,387 @@
+# frozen_string_literal: true
+##
+# AnyMethod is the base class for objects representing methods
+
+class RDoc::AnyMethod < RDoc::MethodAttr
+
+  ##
+  # 2::
+  #   RDoc 4
+  #   Added calls_super
+  #   Added parent name and class
+  #   Added section title
+  # 3::
+  #   RDoc 4.1
+  #   Added is_alias_for
+  # 4::
+  #   Added type_signature_lines (serialized as joined string)
+
+  MARSHAL_VERSION = 4 # :nodoc:
+
+  ##
+  # Don't rename \#initialize to \::new
+
+  attr_accessor :dont_rename_initialize
+
+  ##
+  # The C function that implements this method (if it was defined in a C file)
+
+  attr_accessor :c_function
+
+  # The section title of the method (if defined in a C file via +:category:+)
+  attr_accessor :section_title
+
+  ##
+  # If true this method uses +super+ to call a superclass version
+
+  attr_accessor :calls_super
+
+  include RDoc::TokenStream
+
+  ##
+  # Creates a new AnyMethod with name +name+
+
+  def initialize(name, singleton: false)
+    super(name, singleton: singleton)
+
+    @c_function = nil
+    @dont_rename_initialize = false
+    @token_stream = nil
+    @calls_super = false
+    @superclass_method = nil
+  end
+
+  ##
+  # Adds +an_alias+ as an alias for this method in +context+.
+
+  def add_alias(an_alias, context = nil)
+    method = self.class.new an_alias.new_name, singleton: singleton
+
+    method.record_location an_alias.file
+    method.params = self.params
+    method.visibility = self.visibility
+    method.comment = an_alias.comment
+    method.is_alias_for = self
+    method.type_signature_lines = self.type_signature_lines
+    @aliases << method
+    context.add_method method if context
+    method
+  end
+
+  ##
+  # Prefix for +aref+ is 'method'.
+
+  def aref_prefix
+    'method'
+  end
+
+  ##
+  # The call_seq or the param_seq with method name, if there is no call_seq.
+  #
+  # Use this for displaying a method's argument lists.
+
+  def arglists
+    if @call_seq then
+      @call_seq
+    elsif @params then
+      "#{name}#{param_seq}"
+    end
+  end
+
+  ##
+  # Different ways to call this method
+
+  def call_seq
+    unless call_seq = _call_seq
+      call_seq = is_alias_for._call_seq if is_alias_for
+    end
+
+    return unless call_seq
+
+    deduplicate_call_seq(call_seq)
+  end
+
+  ##
+  # Sets the different ways you can call this method.  If an empty +call_seq+
+  # is given nil is assumed.
+  #
+  # See also #param_seq
+
+  def call_seq=(call_seq)
+    return if call_seq.nil? || call_seq.empty?
+
+    @call_seq = call_seq
+  end
+
+  ##
+  # Whether the method has a call-seq.
+
+  def has_call_seq?
+    !!(@call_seq || is_alias_for&._call_seq)
+  end
+
+  ##
+  # Loads is_alias_for from the internal name.  Returns nil if the alias
+  # cannot be found.
+
+  def is_alias_for # :nodoc:
+    case @is_alias_for
+    when RDoc::MethodAttr then
+      @is_alias_for
+    when Array then
+      return nil unless @store
+
+      klass_name, singleton, method_name = @is_alias_for
+
+      return nil unless klass = @store.find_class_or_module(klass_name)
+
+      @is_alias_for = klass.find_method method_name, singleton
+    end
+  end
+
+  ##
+  # Dumps this AnyMethod for use by ri.  See also #marshal_load
+
+  def marshal_dump
+    aliases = @aliases.map do |a|
+      [a.name, parse(a.comment)]
+    end
+
+    is_alias_for = [
+      @is_alias_for.parent.full_name,
+      @is_alias_for.singleton,
+      @is_alias_for.name
+    ] if @is_alias_for
+
+    [ MARSHAL_VERSION,
+      @name,
+      full_name,
+      @singleton,
+      @visibility,
+      parse(@comment),
+      @call_seq,
+      @block_params,
+      aliases,
+      @params,
+      @file.relative_name,
+      @calls_super,
+      @parent.name,
+      @parent.class,
+      @section.title,
+      is_alias_for,
+      @type_signature_lines&.join("\n"),
+    ]
+  end
+
+  ##
+  # Loads this AnyMethod from +array+.  For a loaded AnyMethod the following
+  # methods will return cached values:
+  #
+  # * #full_name
+  # * #parent_name
+
+  def marshal_load(array)
+    initialize_visibility
+
+    @dont_rename_initialize = nil
+    @token_stream           = nil
+    @aliases                = []
+    @parent                 = nil
+    @parent_name            = nil
+    @parent_class           = nil
+    @section                = nil
+    @file                   = nil
+
+    version        = array[0]
+    @name          = array[1]
+    @full_name     = array[2]
+    @singleton     = array[3]
+    @visibility    = array[4]
+    @comment       = RDoc::Comment.from_document array[5]
+    @call_seq      = array[6]
+    @block_params  = array[7]
+    #                      8 handled below
+    @params        = array[9]
+    #                      10 handled below
+    @calls_super   = array[11]
+    @parent_name   = array[12]
+    @parent_title  = array[13]
+    @section_title = array[14]
+    @is_alias_for  = array[15]
+    @type_signature_lines = array[16]&.split("\n")
+
+    array[8].each do |new_name, document|
+      add_alias RDoc::Alias.new(@name, new_name, RDoc::Comment.from_document(document), singleton: @singleton)
+    end
+
+    @parent_name ||= if @full_name =~ /#/ then
+                       $`
+                     else
+                       name = @full_name.split('::')
+                       name.pop
+                       name.join '::'
+                     end
+
+    @file = RDoc::TopLevel.new array[10] if version > 0
+  end
+
+  ##
+  # Method name
+  #
+  # If the method has no assigned name, it extracts it from #call_seq.
+
+  def name
+    return @name if @name
+
+    @name =
+      @call_seq[/^.*?\.(\w+)/, 1] ||
+      @call_seq[/^.*?(\w+)/, 1] ||
+      @call_seq if @call_seq
+  end
+
+  ##
+  # A list of this method's method and yield parameters.  +call-seq+ params
+  # are preferred over parsed method and block params.
+
+  def param_list
+    if @call_seq then
+      params = @call_seq.split("\n").last
+      params = params.sub(/.*?\((.*)\)/, '\1')
+      params = params.sub(/(\{|do)\s*\|([^|]*)\|.*/, ',\2')
+    elsif @params then
+      params = @params.sub(/\((.*)\)/, '\1')
+
+      params << ",#{@block_params}" if @block_params
+    elsif @block_params then
+      params = @block_params
+    else
+      return []
+    end
+
+    if @block_params then
+      # If this method has explicit block parameters, remove any explicit
+      # &block
+      params = params.sub(/,?\s*&\w+/, '')
+    else
+      params = params.sub(/\&(\w+)/, '\1')
+    end
+
+    params = params.gsub(/\s+/, '').split(',').reject(&:empty?)
+
+    params.map { |param| param.sub(/=.*/, '') }
+  end
+
+  ##
+  # Pretty parameter list for this method.  If the method's parameters were
+  # given by +call-seq+ it is preferred over the parsed values.
+
+  def param_seq
+    if @call_seq then
+      params = @call_seq.split("\n").last
+      params = params.sub(/[^( ]+/, '')
+      params = params.sub(/(\|[^|]+\|)\s*\.\.\.\s*(end|\})/, '\1 \2')
+    elsif @params then
+      params = @params.gsub(/\s*\#.*/, '')
+      params = params.tr_s("\n ", " ")
+      params = "(#{params})" unless params[0] == ?(
+    else
+      params = ''
+    end
+
+    if @block_params then
+      # If this method has explicit block parameters, remove any explicit
+      # &block
+      params = params.sub(/,?\s*&\w+/, '')
+
+      block = @block_params.tr_s("\n ", " ")
+      if block[0] == ?(
+        block = block.sub(/^\(/, '').sub(/\)/, '')
+      end
+      params << " { |#{block}| ... }"
+    end
+
+    params
+  end
+
+  ##
+  # Whether to skip the method description, true for methods that have
+  # aliases with a call-seq that doesn't include the method name.
+
+  def skip_description?
+    has_call_seq? && call_seq.nil? && !!(is_alias_for || !aliases.empty?)
+  end
+
+  ##
+  # Sets the store for this method and its referenced code objects.
+
+  def store=(store)
+    super
+
+    @file = @store.add_file @file.full_name if @file
+  end
+
+  ##
+  # For methods that +super+, find the superclass method that would be called.
+
+  def superclass_method
+    return unless @calls_super
+    return @superclass_method if @superclass_method
+
+    parent.each_ancestor do |ancestor|
+      if method = ancestor.method_list.find { |m| m.name == @name } then
+        @superclass_method = method
+        break
+      end
+    end
+
+    @superclass_method
+  end
+
+  protected
+
+  ##
+  # call_seq without deduplication and alias lookup.
+
+  def _call_seq
+    @call_seq if defined?(@call_seq) && @call_seq
+  end
+
+  private
+
+  ##
+  # call_seq with alias examples information removed, if this
+  # method is an alias method.
+
+  def deduplicate_call_seq(call_seq)
+    return call_seq unless is_alias_for || !aliases.empty?
+
+    method_name = self.name
+
+    entries = call_seq.split "\n"
+
+    ignore = aliases.map(&:name)
+    if is_alias_for
+      ignore << is_alias_for.name
+      ignore.concat is_alias_for.aliases.map(&:name)
+    end
+
+    ignore.delete(method_name)
+    ignore_bracket_methods, ignore_other_methods = ignore.partition {|i| i.start_with?('[') }
+
+    if ignore_other_methods.any?
+      ignore_union = Regexp.union(ignore_other_methods)
+      entries.reject! do |entry|
+        /\A(?:\w*\.)?#{ignore_union}(?:[(\s]|\z)/.match?(entry) ||
+          /\s#{ignore_union}\s/.match?(entry)
+      end
+    end
+    if ignore_bracket_methods.any?
+      entries.reject! do |entry|
+        # Ignore `receiver[arg] -> return_type` `[](arg)` `[]`
+        /\A\w*\[.*?\](?:[(\s]|\z)/.match?(entry)
+      end
+    end
+
+    entries.empty? ? nil : entries.join("\n")
+  end
+end

data/rdoc-8.0.0/lib/rdoc/code_object/attr.rb

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+##
+# An attribute created by \#attr, \#attr_reader, \#attr_writer or
+# \#attr_accessor
+
+class RDoc::Attr < RDoc::MethodAttr
+
+  ##
+  # 3::
+  #   RDoc 4
+  #    Added parent name and class
+  #    Added section title
+  # 4::
+  #   Added type_signature_lines (serialized as joined string)
+
+  MARSHAL_VERSION = 4 # :nodoc:
+
+  ##
+  # Is the attribute readable ('R'), writable ('W') or both ('RW')?
+
+  attr_accessor :rw
+
+  ##
+  # Creates a new Attr with +name+, read/write status +rw+ and
+  # +comment+.  +singleton+ marks this as a class attribute.
+
+  def initialize(name, rw, comment, singleton: false)
+    super(name, singleton: singleton)
+
+    @rw = rw
+    self.comment = comment
+  end
+
+  ##
+  # Attributes are equal when their names, singleton and rw are identical
+
+  def ==(other)
+    self.class == other.class and
+      self.name == other.name and
+      self.rw == other.rw and
+      self.singleton == other.singleton
+  end
+
+  ##
+  # Add +an_alias+ as an attribute in +context+.
+
+  def add_alias(an_alias, context)
+    access_type = an_alias.new_name.end_with?('=') ? 'W' : 'R'
+    new_attr = self.class.new(an_alias.new_name, access_type, comment, singleton: singleton)
+    new_attr.record_location an_alias.file
+    new_attr.visibility = self.visibility
+    new_attr.is_alias_for = self
+    new_attr.type_signature_lines = self.type_signature_lines
+    @aliases << new_attr
+    context.add_attribute new_attr
+    new_attr
+  end
+
+  ##
+  # The #aref prefix for attributes
+
+  def aref_prefix
+    'attribute'
+  end
+
+  ##
+  # Attributes never call super.  See RDoc::AnyMethod#calls_super
+  #
+  # An RDoc::Attr can show up in the method list in some situations (see
+  # Gem::ConfigFile)
+
+  def calls_super # :nodoc:
+    false
+  end
+
+  ##
+  # Returns attr_reader, attr_writer or attr_accessor as appropriate.
+
+  def definition
+    case @rw
+    when 'RW' then 'attr_accessor'
+    when 'R'  then 'attr_reader'
+    when 'W'  then 'attr_writer'
+    end
+  end
+
+  def inspect # :nodoc:
+    alias_for = @is_alias_for ? " (alias for #{@is_alias_for.name})" : nil
+    visibility = self.visibility
+    visibility = "forced #{visibility}" if force_documentation
+    "#<%s:0x%x %s %s (%s)%s>" % [
+      self.class, object_id,
+      full_name,
+      rw,
+      visibility,
+      alias_for,
+    ]
+  end
+
+  ##
+  # Dumps this Attr for use by ri.  See also #marshal_load
+
+  def marshal_dump
+    [ MARSHAL_VERSION,
+      @name,
+      full_name,
+      @rw,
+      @visibility,
+      parse(@comment),
+      singleton,
+      @file.relative_name,
+      @parent.full_name,
+      @parent.class,
+      @section.title,
+      @type_signature_lines&.join("\n"),
+    ]
+  end
+
+  ##
+  # Loads this Attr from +array+.  For a loaded Attr the following
+  # methods will return cached values:
+  #
+  # * #full_name
+  # * #parent_name
+
+  def marshal_load(array)
+    initialize_visibility
+
+    @aliases      = []
+    @parent       = nil
+    @parent_name  = nil
+    @parent_class = nil
+    @section      = nil
+    @file         = nil
+
+    version        = array[0]
+    @name          = array[1]
+    @full_name     = array[2]
+    @rw            = array[3]
+    @visibility    = array[4]
+    @comment       = RDoc::Comment.from_document array[5]
+    @singleton     = array[6] || false # MARSHAL_VERSION == 0
+    #                      7 handled below
+    @parent_name   = array[8]
+    @parent_class  = array[9]
+    @section_title = array[10]
+    @type_signature_lines = array[11]&.split("\n")
+
+    @file = RDoc::TopLevel.new array[7] if version > 1
+
+    @parent_name ||= @full_name.split('#', 2).first
+  end
+
+  def pretty_print(q) # :nodoc:
+    q.group 2, "[#{self.class.name} #{full_name} #{rw} #{visibility}", "]" do
+      unless comment.empty? then
+        q.breakable
+        q.text "comment:"
+        q.breakable
+        q.pp @comment
+      end
+    end
+  end
+
+  def to_s # :nodoc:
+    "#{definition} #{name} in: #{parent}"
+  end
+
+  ##
+  # Attributes do not have token streams.
+  #
+  # An RDoc::Attr can show up in the method list in some situations (see
+  # Gem::ConfigFile)
+
+  def token_stream # :nodoc:
+  end
+
+end