npm - @ai-ecoverse/wasix-ruby - Versions diffs - 3.4.11-3 → 3.4.11-4 - Mend

@ai-ecoverse/wasix-ruby 3.4.11-3 → 3.4.11-4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1127) hide show

package/lib/ruby/3.4.11/rdoc/code_object.rb DELETED Viewed

@@ -1,395 +0,0 @@
-# frozen_string_literal: true
-##
-# Base class for the RDoc code tree.
-#
-# We contain the common stuff for contexts (which are containers) and other
-# elements (methods, attributes and so on)
-#
-# Here's the tree of the CodeObject subclasses:
-#
-# * RDoc::Context
-#   * RDoc::TopLevel
-#   * RDoc::ClassModule
-#     * RDoc::AnonClass (never used so far)
-#     * RDoc::NormalClass
-#     * RDoc::NormalModule
-#     * RDoc::SingleClass
-# * RDoc::MethodAttr
-#   * RDoc::Attr
-#   * RDoc::AnyMethod
-#     * RDoc::GhostMethod
-#     * RDoc::MetaMethod
-# * RDoc::Alias
-# * RDoc::Constant
-# * RDoc::Require
-# * RDoc::Mixin
-#   * RDoc::Include
-#   * RDoc::Extend
-class RDoc::CodeObject
-  include RDoc::Text
-  ##
-  # Our comment
-  attr_reader :comment
-  ##
-  # Do we document our children?
-  attr_reader :document_children
-  ##
-  # Do we document ourselves?
-  attr_reader :document_self
-  ##
-  # Are we done documenting (ie, did we come across a :enddoc:)?
-  attr_reader :done_documenting
-  ##
-  # Which file this code object was defined in
-  attr_reader :file
-  ##
-  # Force documentation of this CodeObject
-  attr_reader :force_documentation
-  ##
-  # Line in #file where this CodeObject was defined
-  attr_accessor :line
-  ##
-  # Hash of arbitrary metadata for this CodeObject
-  attr_reader :metadata
-  ##
-  # Sets the parent CodeObject
-  attr_writer :parent
-  ##
-  # Did we ever receive a +:nodoc:+ directive?
-  attr_reader :received_nodoc
-  ##
-  # Set the section this CodeObject is in
-  attr_writer :section
-  ##
-  # The RDoc::Store for this object.
-  attr_reader :store
-  ##
-  # When mixed-in to a class, this points to the Context in which it was originally defined.
-  attr_accessor :mixin_from
-  ##
-  # Creates a new CodeObject that will document itself and its children
-  def initialize
-    @metadata         = {}
-    @comment          = ''
-    @parent           = nil
-    @parent_name      = nil # for loading
-    @parent_class     = nil # for loading
-    @section          = nil
-    @section_title    = nil # for loading
-    @file             = nil
-    @full_name        = nil
-    @store            = nil
-    @track_visibility = true
-    @mixin_from       = nil
-    initialize_visibility
-  end
-  ##
-  # Initializes state for visibility of this CodeObject and its children.
-  def initialize_visibility # :nodoc:
-    @document_children   = true
-    @document_self       = true
-    @done_documenting    = false
-    @force_documentation = false
-    @received_nodoc      = false
-    @ignored             = false
-    @suppressed          = false
-    @track_visibility    = true
-  end
-  ##
-  # Replaces our comment with +comment+, unless it is empty.
-  def comment=(comment)
-    @comment = case comment
-               when NilClass               then ''
-               when RDoc::Comment          then comment.normalize
-               else
-                 if comment and not comment.empty? then
-                   normalize_comment comment
-                 else
-                   # HACK correct fix is to have #initialize create @comment
-                   #      with the correct encoding
-                   if String === @comment and @comment.empty? then
-                     @comment = RDoc::Encoding.change_encoding @comment, comment.encoding
-                   end
-                   @comment
-                 end
-               end
-  end
-  ##
-  # Should this CodeObject be displayed in output?
-  #
-  # A code object should be displayed if:
-  #
-  # * The item didn't have a nodoc or wasn't in a container that had nodoc
-  # * The item wasn't ignored
-  # * The item has documentation and was not suppressed
-  def display?
-    @document_self and not @ignored and
-      (documented? or not @suppressed)
-  end
-  ##
-  # Enables or disables documentation of this CodeObject's children unless it
-  # has been turned off by :enddoc:
-  def document_children=(document_children)
-    return unless @track_visibility
-    @document_children = document_children unless @done_documenting
-  end
-  ##
-  # Enables or disables documentation of this CodeObject unless it has been
-  # turned off by :enddoc:.  If the argument is +nil+ it means the
-  # documentation is turned off by +:nodoc:+.
-  def document_self=(document_self)
-    return unless @track_visibility
-    return if @done_documenting
-    @document_self = document_self
-    @received_nodoc = true if document_self.nil?
-  end
-  ##
-  # Does this object have a comment with content or is #received_nodoc true?
-  def documented?
-    @received_nodoc or !@comment.empty?
-  end
-  ##
-  # Turns documentation on/off, and turns on/off #document_self
-  # and #document_children.
-  #
-  # Once documentation has been turned off (by +:enddoc:+),
-  # the object will refuse to turn #document_self or
-  # #document_children on, so +:doc:+ and +:start_doc:+ directives
-  # will have no effect in the current file.
-  def done_documenting=(value)
-    return unless @track_visibility
-    @done_documenting  = value
-    @document_self     = !value
-    @document_children = @document_self
-  end
-  ##
-  # File name where this CodeObject was found.
-  #
-  # See also RDoc::Context#in_files
-  def file_name
-    return unless @file
-    @file.absolute_name
-  end
-  ##
-  # Force the documentation of this object unless documentation
-  # has been turned off by :enddoc:
-  #--
-  # HACK untested, was assigning to an ivar
-  def force_documentation=(value)
-    @force_documentation = value unless @done_documenting
-  end
-  ##
-  # Sets the full_name overriding any computed full name.
-  #
-  # Set to +nil+ to clear RDoc's cached value
-  def full_name=(full_name)
-    @full_name = full_name
-  end
-  ##
-  # Use this to ignore a CodeObject and all its children until found again
-  # (#record_location is called).  An ignored item will not be displayed in
-  # documentation.
-  #
-  # See github issue #55
-  #
-  # The ignored status is temporary in order to allow implementation details
-  # to be hidden.  At the end of processing a file RDoc allows all classes
-  # and modules to add new documentation to previously created classes.
-  #
-  # If a class was ignored (via stopdoc) then reopened later with additional
-  # documentation it should be displayed.  If a class was ignored and never
-  # reopened it should not be displayed.  The ignore flag allows this to
-  # occur.
-  def ignore
-    return unless @track_visibility
-    @ignored = true
-    stop_doc
-  end
-  ##
-  # Has this class been ignored?
-  #
-  # See also #ignore
-  def ignored?
-    @ignored
-  end
-  ##
-  # The options instance from the store this CodeObject is attached to, or a
-  # default options instance if the CodeObject is not attached.
-  #
-  # This is used by Text#snippet
-  def options
-    @store&.options || RDoc::Options.new
-  end
-  ##
-  # Our parent CodeObject.  The parent may be missing for classes loaded from
-  # legacy RI data stores.
-  def parent
-    return @parent if @parent
-    return nil unless @parent_name
-    if @parent_class == RDoc::TopLevel then
-      @parent = @store.add_file @parent_name
-    else
-      @parent = @store.find_class_or_module @parent_name
-      return @parent if @parent
-      begin
-        @parent = @store.load_class @parent_name
-      rescue RDoc::Store::MissingFileError
-        nil
-      end
-    end
-  end
-  ##
-  # Name of our parent
-  def parent_name
-    @parent ? @parent.full_name : '(unknown)'
-  end
-  ##
-  # Records the RDoc::TopLevel (file) where this code object was defined
-  def record_location(top_level)
-    @ignored    = false
-    @suppressed = false
-    @file       = top_level
-  end
-  ##
-  # The section this CodeObject is in.  Sections allow grouping of constants,
-  # attributes and methods inside a class or module.
-  def section
-    return @section if @section
-    @section = parent.add_section @section_title if parent
-  end
-  ##
-  # Enable capture of documentation unless documentation has been
-  # turned off by :enddoc:
-  def start_doc
-    return if @done_documenting
-    @document_self = true
-    @document_children = true
-    @ignored    = false
-    @suppressed = false
-  end
-  ##
-  # Disable capture of documentation
-  def stop_doc
-    return unless @track_visibility
-    @document_self = false
-    @document_children = false
-  end
-  ##
-  # Sets the +store+ that contains this CodeObject
-  def store=(store)
-    @store = store
-    return unless @track_visibility
-    if :nodoc == options.visibility then
-      initialize_visibility
-      @track_visibility = false
-    end
-  end
-  ##
-  # Use this to suppress a CodeObject and all its children until the next file
-  # it is seen in or documentation is discovered.  A suppressed item with
-  # documentation will be displayed while an ignored item with documentation
-  # may not be displayed.
-  def suppress
-    return unless @track_visibility
-    @suppressed = true
-    stop_doc
-  end
-  ##
-  # Has this class been suppressed?
-  #
-  # See also #suppress
-  def suppressed?
-    @suppressed
-  end
-end

package/lib/ruby/3.4.11/rdoc/code_objects.rb DELETED Viewed

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-# This file was used to load all the RDoc::CodeObject subclasses at once.  Now
-# autoload handles this.
-require_relative '../rdoc'

package/lib/ruby/3.4.11/rdoc/comment.rb DELETED Viewed

@@ -1,236 +0,0 @@
-# frozen_string_literal: true
-##
-# A comment holds the text comment for a RDoc::CodeObject and provides a
-# unified way of cleaning it up and parsing it into an RDoc::Markup::Document.
-#
-# Each comment may have a different markup format set by #format=.  By default
-# 'rdoc' is used.  The :markup: directive tells RDoc which format to use.
-#
-# See RDoc::MarkupReference@Directive+for+Specifying+RDoc+Source+Format.
-class RDoc::Comment
-  include RDoc::Text
-  ##
-  # The format of this comment.  Defaults to RDoc::Markup
-  attr_reader :format
-  ##
-  # The RDoc::TopLevel this comment was found in
-  attr_accessor :location
-  ##
-  # Line where this Comment was written
-  attr_accessor :line
-  ##
-  # For duck-typing when merging classes at load time
-  alias file location # :nodoc:
-  ##
-  # The text for this comment
-  attr_reader :text
-  ##
-  # Alias for text
-  alias to_s text
-  ##
-  # Overrides the content returned by #parse.  Use when there is no #text
-  # source for this comment
-  attr_writer   :document
-  ##
-  # Creates a new comment with +text+ that is found in the RDoc::TopLevel
-  # +location+.
-  def initialize(text = nil, location = nil, language = nil)
-    @location = location
-    @text     = text.nil? ? nil : text.dup
-    @language = language
-    @document   = nil
-    @format     = 'rdoc'
-    @normalized = false
-  end
-  ##
-  #--
-  # TODO deep copy @document
-  def initialize_copy(copy) # :nodoc:
-    @text = copy.text.dup
-  end
-  def ==(other) # :nodoc:
-    self.class === other and
-      other.text == @text and other.location == @location
-  end
-  ##
-  # Look for a 'call-seq' in the comment to override the normal parameter
-  # handling.  The :call-seq: is indented from the baseline.  All lines of the
-  # same indentation level and prefix are consumed.
-  #
-  # For example, all of the following will be used as the :call-seq:
-  #
-  #   # :call-seq:
-  #   #   ARGF.readlines(sep=$/)     -> array
-  #   #   ARGF.readlines(limit)      -> array
-  #   #   ARGF.readlines(sep, limit) -> array
-  #   #
-  #   #   ARGF.to_a(sep=$/)     -> array
-  #   #   ARGF.to_a(limit)      -> array
-  #   #   ARGF.to_a(sep, limit) -> array
-  def extract_call_seq
-    # we must handle situations like the above followed by an unindented first
-    # comment.  The difficulty is to make sure not to match lines starting
-    # with ARGF at the same indent, but that are after the first description
-    # paragraph.
-    if /^(?<S> ((?!\n)\s)*+        (?# whitespaces except newline))
-         :?call-seq:
-           (?<B> \g<S>(?<N>\n|\z)  (?# trailing spaces))?
-         (?<seq>
-           (\g<S>(?!\w)\S.*\g<N>)*
-           (?>
-             (?<H> \g<S>\w+        (?# ' #   ARGF' in the example above))
-             .*\g<N>)?
-           (\g<S>\S.*\g<N>         (?# other non-blank line))*+
-           (\g<B>+(\k<H>.*\g<N>    (?# ARGF.to_a lines))++)*+
-         )
-         (?m:^\s*$|\z)
-        /x =~ @text
-      seq = $~[:seq]
-      all_start, all_stop = $~.offset(0)
-      @text.slice! all_start...all_stop
-      seq.gsub!(/^\s*/, '')
-    end
-  end
-  ##
-  # A comment is empty if its text String is empty.
-  def empty?
-    @text.empty? && (@document.nil? || @document.empty?)
-  end
-  ##
-  # HACK dubious
-  def encode!(encoding)
-    @text = String.new @text, encoding: encoding
-    self
-  end
-  ##
-  # Sets the format of this comment and resets any parsed document
-  def format=(format)
-    @format = format
-    @document = nil
-  end
-  def inspect # :nodoc:
-    location = @location ? @location.relative_name : '(unknown)'
-    "#<%s:%x %s %p>" % [self.class, object_id, location, @text]
-  end
-  ##
-  # Normalizes the text.  See RDoc::Text#normalize_comment for details
-  def normalize
-    return self unless @text
-    return self if @normalized # TODO eliminate duplicate normalization
-    @text = normalize_comment @text
-    @normalized = true
-    self
-  end
-  ##
-  # Was this text normalized?
-  def normalized? # :nodoc:
-    @normalized
-  end
-  ##
-  # Parses the comment into an RDoc::Markup::Document.  The parsed document is
-  # cached until the text is changed.
-  def parse
-    return @document if @document
-    @document = super @text, @format
-    @document.file = @location
-    @document
-  end
-  ##
-  # Removes private sections from this comment.  Private sections are flush to
-  # the comment marker and start with <tt>--</tt> and end with <tt>++</tt>.
-  # For C-style comments, a private marker may not start at the opening of the
-  # comment.
-  #
-  #   /*
-  #    *--
-  #    * private
-  #    *++
-  #    * public
-  #    */
-  def remove_private
-    # Workaround for gsub encoding for Ruby 1.9.2 and earlier
-    empty = ''
-    empty = RDoc::Encoding.change_encoding empty, @text.encoding
-    @text = @text.gsub(%r%^\s*([#*]?)--.*?^\s*(\1)\+\+\n?%m, empty)
-    @text = @text.sub(%r%^\s*[#*]?--.*%m, '')
-  end
-  ##
-  # Replaces this comment's text with +text+ and resets the parsed document.
-  #
-  # An error is raised if the comment contains a document but no text.
-  def text=(text)
-    raise RDoc::Error, 'replacing document-only comment is not allowed' if
-      @text.nil? and @document
-    @document = nil
-    @text = text.nil? ? nil : text.dup
-  end
-  ##
-  # Returns true if this comment is in TomDoc format.
-  def tomdoc?
-    @format == 'tomdoc'
-  end
-  ##
-  # Create a new parsed comment from a document
-  def self.from_document(document) # :nodoc:
-    comment = RDoc::Comment.new('')
-    comment.document = document
-    comment.location = RDoc::TopLevel.new(document.file) if document.file
-    comment
-  end
-end