docspring 3.0.0 → 3.1.0

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser/static_environment.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module Parser
+
+  class StaticEnvironment
+    FORWARD_ARGS = :FORWARD_ARGS
+
+    ANONYMOUS_RESTARG_IN_CURRENT_SCOPE = :ANONYMOUS_RESTARG_IN_CURRENT_SCOPE
+    ANONYMOUS_RESTARG_INHERITED = :ANONYMOUS_RESTARG_INHERITED
+
+    ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE = :ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE
+    ANONYMOUS_KWRESTARG_INHERITED = :ANONYMOUS_KWRESTARG_INHERITED
+
+    ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE = :ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE
+    ANONYMOUS_BLOCKARG_INHERITED = :ANONYMOUS_BLOCKARG_INHERITED
+
+    def initialize
+      reset
+    end
+
+    def reset
+      @variables = Set[]
+      @stack     = []
+    end
+
+    def extend_static
+      @stack.push(@variables)
+      @variables = Set[]
+
+      self
+    end
+
+    def extend_dynamic
+      @stack.push(@variables)
+      @variables = @variables.dup
+      if @variables.delete(ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE)
+        @variables.add(ANONYMOUS_BLOCKARG_INHERITED)
+      end
+      if @variables.delete(ANONYMOUS_RESTARG_IN_CURRENT_SCOPE)
+        @variables.add(ANONYMOUS_RESTARG_INHERITED)
+      end
+      if @variables.delete(ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE)
+        @variables.add(ANONYMOUS_KWRESTARG_INHERITED)
+      end
+
+      self
+    end
+
+    def unextend
+      @variables = @stack.pop
+
+      self
+    end
+
+    def declare(name)
+      @variables.add(name.to_sym)
+
+      self
+    end
+
+    def declared?(name)
+      @variables.include?(name.to_sym)
+    end
+
+    # Forward args
+
+    def declare_forward_args
+      declare(FORWARD_ARGS)
+    end
+
+    def declared_forward_args?
+      declared?(FORWARD_ARGS)
+    end
+
+    # Anonymous blockarg
+
+    def declare_anonymous_blockarg
+      declare(ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE)
+    end
+
+    def declared_anonymous_blockarg?
+      declared?(ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE) || declared?(ANONYMOUS_BLOCKARG_INHERITED)
+    end
+
+    def declared_anonymous_blockarg_in_current_scpe?
+      declared?(ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE)
+    end
+
+    def parent_has_anonymous_blockarg?
+      @stack.any? { |variables| variables.include?(ANONYMOUS_BLOCKARG_IN_CURRENT_SCOPE) }
+    end
+
+    # Anonymous restarg
+
+    def declare_anonymous_restarg
+      declare(ANONYMOUS_RESTARG_IN_CURRENT_SCOPE)
+    end
+
+    def declared_anonymous_restarg?
+      declared?(ANONYMOUS_RESTARG_IN_CURRENT_SCOPE) || declared?(ANONYMOUS_RESTARG_INHERITED)
+    end
+
+    def declared_anonymous_restarg_in_current_scope?
+      declared?(ANONYMOUS_RESTARG_IN_CURRENT_SCOPE)
+    end
+
+    def parent_has_anonymous_restarg?
+      @stack.any? { |variables| variables.include?(ANONYMOUS_RESTARG_IN_CURRENT_SCOPE) }
+    end
+
+    # Anonymous kwresarg
+
+    def declare_anonymous_kwrestarg
+      declare(ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE)
+    end
+
+    def declared_anonymous_kwrestarg?
+      declared?(ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE) || declared?(ANONYMOUS_KWRESTARG_INHERITED)
+    end
+
+    def declared_anonymous_kwrestarg_in_current_scope?
+      declared?(ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE)
+    end
+
+    def parent_has_anonymous_kwrestarg?
+      @stack.any? { |variables| variables.include?(ANONYMOUS_KWRESTARG_IN_CURRENT_SCOPE) }
+    end
+
+    def empty?
+      @stack.empty?
+    end
+  end
+
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser/syntax_error.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Parser
+  ##
+  # {Parser::SyntaxError} is raised whenever parser detects a syntax error,
+  # similar to the standard SyntaxError class.
+  #
+  # @api public
+  #
+  # @!attribute [r] diagnostic
+  #  @return [Parser::Diagnostic]
+  #
+  class SyntaxError < StandardError
+    attr_reader :diagnostic
+
+    def initialize(diagnostic)
+      @diagnostic = diagnostic
+      super(diagnostic.message)
+    end
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser/tree_rewriter.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+module Parser
+
+  ##
+  # {Parser::TreeRewriter} offers a basic API that makes it easy to rewrite
+  # existing ASTs. It's built on top of {Parser::AST::Processor} and
+  # {Parser::Source::TreeRewriter}
+  #
+  # For example, assume you want to remove `do` tokens from a while statement.
+  # You can do this as following:
+  #
+  #     require 'parser/current'
+  #
+  #     class RemoveDo < Parser::TreeRewriter
+  #       def on_while(node)
+  #         # Check if the statement starts with "do"
+  #         if node.location.begin.is?('do')
+  #           remove(node.location.begin)
+  #         end
+  #       end
+  #     end
+  #
+  #     code = <<-EOF
+  #     while true do
+  #       puts 'hello'
+  #     end
+  #     EOF
+  #
+  #     ast           = Parser::CurrentRuby.parse code
+  #     buffer        = Parser::Source::Buffer.new('(example)', source: code)
+  #     rewriter      = RemoveDo.new
+  #
+  #     # Rewrite the AST, returns a String with the new form.
+  #     puts rewriter.rewrite(buffer, ast)
+  #
+  # This would result in the following Ruby code:
+  #
+  #     while true
+  #       puts 'hello'
+  #     end
+  #
+  # Keep in mind that {Parser::TreeRewriter} does not take care of indentation when
+  # inserting/replacing code so you'll have to do this yourself.
+  #
+  # See also [a blog entry](http://whitequark.org/blog/2013/04/26/lets-play-with-ruby-code/)
+  # describing rewriters in greater detail.
+  #
+  # @api public
+  #
+  class TreeRewriter < Parser::AST::Processor
+    ##
+    # Rewrites the AST/source buffer and returns a String containing the new
+    # version.
+    #
+    # @param [Parser::Source::Buffer] source_buffer
+    # @param [Parser::AST::Node] ast
+    # @param [Symbol] crossing_deletions:, different_replacements:, swallowed_insertions:
+    #                 policy arguments for TreeRewriter (optional)
+    # @return [String]
+    #
+    def rewrite(source_buffer,
+                ast,
+                **policy)
+      @source_rewriter = Parser::Source::TreeRewriter.new(source_buffer, **policy)
+
+      process(ast)
+
+      @source_rewriter.process
+    end
+
+    ##
+    # Returns `true` if the specified node is an assignment node, returns false
+    # otherwise.
+    #
+    # @param [Parser::AST::Node] node
+    # @return [Boolean]
+    #
+    def assignment?(node)
+      [:lvasgn, :ivasgn, :gvasgn, :cvasgn, :casgn].include?(node.type)
+    end
+
+    ##
+    # Removes the source range.
+    #
+    # @param [Parser::Source::Range] range
+    #
+    def remove(range)
+      @source_rewriter.remove(range)
+    end
+
+    ##
+    # Wraps the given source range with the given values.
+    #
+    # @param [Parser::Source::Range] range
+    # @param [String] content
+    #
+    def wrap(range, before, after)
+      @source_rewriter.wrap(range, before, after)
+    end
+
+    ##
+    # Inserts new code before the given source range.
+    #
+    # @param [Parser::Source::Range] range
+    # @param [String] content
+    #
+    def insert_before(range, content)
+      @source_rewriter.insert_before(range, content)
+    end
+
+    ##
+    # Inserts new code after the given source range.
+    #
+    # @param [Parser::Source::Range] range
+    # @param [String] content
+    #
+    def insert_after(range, content)
+      @source_rewriter.insert_after(range, content)
+    end
+
+    ##
+    # Replaces the code of the source range `range` with `content`.
+    #
+    # @param [Parser::Source::Range] range
+    # @param [String] content
+    #
+    def replace(range, content)
+      @source_rewriter.replace(range, content)
+    end
+  end
+
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser/unknown_encoding_in_magic_comment_error.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Parser
+  ##
+  # {Parser::UnknownEncodingInMagicComment} is raised when a magic encoding
+  # comment is encountered that the currently running Ruby version doesn't
+  # recognize. It inherits from {ArgumentError} since that is the exception
+  # Ruby itself raises when trying to execute a file with an unknown encoding.
+  # As such, it is also not a {Parser::SyntaxError}.
+  #
+  # @api public
+  #
+  class UnknownEncodingInMagicComment < ArgumentError
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser/variables_stack.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Parser
+
+  class VariablesStack
+    def initialize
+      @stack = []
+      push
+    end
+
+    def empty?
+      @stack.empty?
+    end
+
+    def push
+      @stack << Set.new
+    end
+
+    def pop
+      @stack.pop
+    end
+
+    def reset
+      @stack.clear
+    end
+
+    def declare(name)
+      @stack.last << name.to_sym
+    end
+
+    def declared?(name)
+      @stack.last.include?(name.to_sym)
+    end
+  end
+
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Parser
+  VERSION = '3.3.7.2'
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/lib/parser.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+if RUBY_VERSION =~ /^1\.[89]\./
+  require_relative 'parser/version'
+  raise LoadError, <<-UNSUPPORTED_VERSION_MSG
+parser v#{Parser::VERSION} cannot run on Ruby #{RUBY_VERSION}.
+Please upgrade to Ruby 2.0.0 or higher, or use an older version of the parser gem.
+  UNSUPPORTED_VERSION_MSG
+end
+
+require 'set'
+require 'racc/parser'
+
+require 'ast'
+
+##
+# @api public
+#
+module Parser
+  require_relative 'parser/version'
+  require_relative 'parser/messages'
+  require_relative 'parser/deprecation'
+
+  module AST
+    require_relative 'parser/ast/node'
+    require_relative 'parser/ast/processor'
+    require_relative 'parser/meta'
+  end
+
+  module Source
+    require_relative 'parser/source/buffer'
+    require_relative 'parser/source/range'
+
+    require_relative 'parser/source/comment'
+    require_relative 'parser/source/comment/associator'
+
+    require_relative 'parser/source/rewriter'
+    require_relative 'parser/source/rewriter/action'
+    require_relative 'parser/source/tree_rewriter'
+    require_relative 'parser/source/tree_rewriter/action'
+
+    require_relative 'parser/source/map'
+    require_relative 'parser/source/map/operator'
+    require_relative 'parser/source/map/collection'
+    require_relative 'parser/source/map/constant'
+    require_relative 'parser/source/map/variable'
+    require_relative 'parser/source/map/keyword'
+    require_relative 'parser/source/map/definition'
+    require_relative 'parser/source/map/method_definition'
+    require_relative 'parser/source/map/send'
+    require_relative 'parser/source/map/index'
+    require_relative 'parser/source/map/condition'
+    require_relative 'parser/source/map/ternary'
+    require_relative 'parser/source/map/for'
+    require_relative 'parser/source/map/rescue_body'
+    require_relative 'parser/source/map/heredoc'
+    require_relative 'parser/source/map/objc_kwarg'
+  end
+
+  require_relative 'parser/syntax_error'
+  require_relative 'parser/clobbering_error'
+  require_relative 'parser/unknown_encoding_in_magic_comment_error'
+  require_relative 'parser/diagnostic'
+  require_relative 'parser/diagnostic/engine'
+
+  require_relative 'parser/static_environment'
+
+  if RUBY_ENGINE == 'truffleruby'
+    require_relative 'parser/lexer-F0'
+  else
+    require_relative 'parser/lexer-F1'
+  end
+  require_relative 'parser/lexer-strings'
+  require_relative 'parser/lexer/literal'
+  require_relative 'parser/lexer/stack_state'
+  require_relative 'parser/lexer/dedenter'
+
+  module Builders
+    require_relative 'parser/builders/default'
+  end
+
+  require_relative 'parser/context'
+  require_relative 'parser/max_numparam_stack'
+  require_relative 'parser/current_arg_stack'
+  require_relative 'parser/variables_stack'
+
+  require_relative 'parser/base'
+
+  require_relative 'parser/rewriter'
+  require_relative 'parser/tree_rewriter'
+end

data/vendor/bundle/ruby/3.3.0/gems/parser-3.3.7.2/parser.gemspec

@@ -0,0 +1,43 @@
+# encoding: utf-8
+# frozen_string_literal: true
+
+require File.expand_path('../lib/parser/version', __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name          = 'parser'
+  spec.version       = Parser::VERSION
+  spec.authors       = ['whitequark']
+  spec.email         = ['whitequark@whitequark.org']
+  spec.description   = 'A Ruby parser written in pure Ruby.'
+  spec.summary       = spec.description
+  spec.homepage      = 'https://github.com/whitequark/parser'
+  spec.license       = 'MIT'
+
+  spec.metadata = {
+    'bug_tracker_uri' => 'https://github.com/whitequark/parser/issues',
+    'changelog_uri' => "https://github.com/whitequark/parser/blob/v#{spec.version}/CHANGELOG.md",
+    'documentation_uri' => "https://www.rubydoc.info/gems/parser/#{spec.version}",
+    'source_code_uri' => "https://github.com/whitequark/parser/tree/v#{spec.version}"
+  }
+
+  spec.files         = Dir['bin/*', 'lib/**/*.rb', 'parser.gemspec', 'LICENSE.txt']
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_dependency             'ast',       '~> 2.4.1'
+  spec.add_dependency             'racc'
+
+  spec.add_development_dependency 'bundler',   '>= 1.15', '< 3.0.0'
+  spec.add_development_dependency 'rake',      '~> 13.0.1'
+  spec.add_development_dependency 'cliver',    '~> 0.3.2'
+
+  spec.add_development_dependency 'yard'
+  spec.add_development_dependency 'kramdown'
+
+  spec.add_development_dependency 'minitest',  '~> 5.10'
+  spec.add_development_dependency 'simplecov', '~> 0.15.1'
+
+  spec.add_development_dependency 'gauntlet'
+end

data/vendor/bundle/ruby/3.3.0/gems/pp-0.6.2/BSDL

@@ -0,0 +1,22 @@
+Copyright (C) 1993-2013 Yukihiro Matsumoto. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

data/vendor/bundle/ruby/3.3.0/gems/pp-0.6.2/COPYING

@@ -0,0 +1,56 @@
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.jp>.
+You can redistribute it and/or modify it under either the terms of the
+2-clause BSDL (see the file BSDL), or the conditions below:
+
+1. You may make and give away verbatim copies of the source form of the
+   software without restriction, provided that you duplicate all of the
+   original copyright notices and associated disclaimers.
+
+2. You may modify your copy of the software in any way, provided that
+   you do at least ONE of the following:
+
+   a. place your modifications in the Public Domain or otherwise
+      make them Freely Available, such as by posting said
+      modifications to Usenet or an equivalent medium, or by allowing
+      the author to include your modifications in the software.
+
+   b. use the modified software only within your corporation or
+      organization.
+
+   c. give non-standard binaries non-standard names, with
+      instructions on where to get the original software distribution.
+
+   d. make other distribution arrangements with the author.
+
+3. You may distribute the software in object code or binary form,
+   provided that you do at least ONE of the following:
+
+   a. distribute the binaries and library files of the software,
+      together with instructions (in the manual page or equivalent)
+      on where to get the original distribution.
+
+   b. accompany the distribution with the machine-readable source of
+      the software.
+
+   c. give non-standard binaries non-standard names, with
+      instructions on where to get the original software distribution.
+
+   d. make other distribution arrangements with the author.
+
+4. You may modify and include the part of the software into any other
+   software (possibly commercial).  But some files in the distribution
+   are not written by the author, so that they are not under these terms.
+
+   For the list of those files and their copying conditions, see the
+   file LEGAL.
+
+5. The scripts and library files supplied as input to or produced as
+   output from the software do not automatically fall under the
+   copyright of the software, but belong to whomever generated them,
+   and may be sold commercially, and may be aggregated with this
+   software.
+
+6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+   IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+   PURPOSE.