kinetic_sdk 5.0.25 → 5.0.26

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/handlers/c/base.rb

@@ -1,164 +1,164 @@
-# frozen_string_literal: true
-module YARD
-  module Handlers
-    module C
-      class Base < Handlers::Base
-        include YARD::Parser::C
-        include HandlerMethods
-
-        # @return [Boolean] whether the handler handles this statement
-        def self.handles?(statement, processor)
-          processor.globals.cruby_processed_files ||= {}
-          processor.globals.cruby_processed_files[processor.file] = true
-
-          src = statement.respond_to?(:declaration) ?
-            statement.declaration : statement.source
-
-          handlers.any? do |a_handler|
-            statement_class >= statement.class &&
-              case a_handler
-              when String
-                src == a_handler
-              when Regexp
-                src =~ a_handler
-              end
-          end
-        end
-
-        def self.statement_class(type = nil)
-          if type
-            @statement_class = type
-          else
-            (defined?(@statement_class) && @statement_class) || Statement
-          end
-        end
-
-        # @group Registering objects
-
-        def register_docstring(object, docstring = nil, stmt = nil)
-          super(object, docstring, stmt) if docstring
-        end
-
-        def register_file_info(object, file = nil, line = nil, comments = nil)
-          super(object, file, line, comments) if file
-        end
-
-        def register_source(object, source = nil, type = nil)
-          super(object, source, type) if source
-        end
-
-        def register_visibility(object, visibility = nil)
-          super(object, visibility) if visibility
-        end
-
-        # @group Looking up Symbol and Var Values
-
-        def symbols
-          globals.cruby_symbols ||= {}
-        end
-
-        def override_comments
-          globals.cruby_override_comments ||= []
-        end
-
-        def namespace_for_variable(var)
-          return namespaces[var] if namespaces[var]
-
-          # The global variables for Ruby's core error classes does not
-          # represent their Ruby name. So we need to look up these names.
-          name = ERROR_CLASS_NAMES[var]
-          return P(name) if name
-
-          # Otherwise the name is inferred from the C variable name.
-          var = remove_var_prefix(var)
-          var.empty? ? nil : P(var)
-        end
-
-        def ensure_variable_defined!(var, max_retries = 1)
-          retries = 0
-          object = nil
-
-          loop do
-            object = namespace_for_variable(var)
-            break unless object.is_a?(Proxy)
-
-            raise NamespaceMissingError, object if retries > max_retries
-            log.debug "Missing namespace variable #{var} in file `#{parser.file}', moving it to the back of the line."
-            parser.parse_remaining_files
-            retries += 1
-          end
-
-          object
-        end
-
-        def namespaces
-          globals.cruby_namespaces ||= {}
-        end
-
-        def processed_files
-          globals.cruby_processed_files ||= {}
-        end
-
-        # @group Parsing an Inner Block
-
-        def parse_block(opts = {})
-          return if !statement.block || statement.block.empty?
-          push_state(opts) do
-            parser.process(statement.block)
-          end
-        end
-
-        # @group Processing other files
-
-        def process_file(file, object)
-          file = File.cleanpath(file)
-          return if processed_files[file]
-          processed_files[file] = file
-          begin
-            log.debug "Processing embedded call to C source #{file}..."
-            globals.ordered_parser.files.delete(file) if globals.ordered_parser
-            parser.process(Parser::C::CParser.new(File.read(file), file).parse)
-          rescue Errno::ENOENT
-            log.warn "Missing source file `#{file}' when parsing #{object}"
-          end
-        end
-
-        # @endgroup
-
-        private
-
-        # Generated by update_error_map.rb (Copy+past results)
-        ERROR_CLASS_NAMES = {
-          'rb_eArgError' => 'ArgumentError',
-          'rb_eEncodingError' => 'EncodingError',
-          'rb_eException' => 'Exception',
-          'rb_eFatal' => 'fatal',
-          'rb_eFrozenError' => 'FrozenError',
-          'rb_eIndexError' => 'IndexError',
-          'rb_eInterrupt' => 'Interrupt',
-          'rb_eKeyError' => 'KeyError',
-          'rb_eLoadError' => 'LoadError',
-          'rb_eNameError' => 'NameError',
-          'rb_eNoMatchingPatternError' => 'NoMatchingPatternError',
-          'rb_eNoMemError' => 'NoMemoryError',
-          'rb_eNoMethodError' => 'NoMethodError',
-          'rb_eNotImpError' => 'NotImplementedError',
-          'rb_eRangeError' => 'RangeError',
-          'rb_eRuntimeError' => 'RuntimeError',
-          'rb_eScriptError' => 'ScriptError',
-          'rb_eSecurityError' => 'SecurityError',
-          'rb_eSignal' => 'SignalException',
-          'rb_eStandardError' => 'StandardError',
-          'rb_eSyntaxError' => 'SyntaxError',
-          'rb_eSystemCallError' => 'SystemCallError',
-          'rb_eSystemExit' => 'SystemExit',
-          'rb_eTypeError' => 'TypeError',
-        }
-
-        def remove_var_prefix(var)
-          var.gsub(/^rb_[mc]|^[a-z_]+/, '')
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+module YARD
+  module Handlers
+    module C
+      class Base < Handlers::Base
+        include YARD::Parser::C
+        include HandlerMethods
+
+        # @return [Boolean] whether the handler handles this statement
+        def self.handles?(statement, processor)
+          processor.globals.cruby_processed_files ||= {}
+          processor.globals.cruby_processed_files[processor.file] = true
+
+          src = statement.respond_to?(:declaration) ?
+            statement.declaration : statement.source
+
+          handlers.any? do |a_handler|
+            statement_class >= statement.class &&
+              case a_handler
+              when String
+                src == a_handler
+              when Regexp
+                src =~ a_handler
+              end
+          end
+        end
+
+        def self.statement_class(type = nil)
+          if type
+            @statement_class = type
+          else
+            (defined?(@statement_class) && @statement_class) || Statement
+          end
+        end
+
+        # @group Registering objects
+
+        def register_docstring(object, docstring = nil, stmt = nil)
+          super(object, docstring, stmt) if docstring
+        end
+
+        def register_file_info(object, file = nil, line = nil, comments = nil)
+          super(object, file, line, comments) if file
+        end
+
+        def register_source(object, source = nil, type = nil)
+          super(object, source, type) if source
+        end
+
+        def register_visibility(object, visibility = nil)
+          super(object, visibility) if visibility
+        end
+
+        # @group Looking up Symbol and Var Values
+
+        def symbols
+          globals.cruby_symbols ||= {}
+        end
+
+        def override_comments
+          globals.cruby_override_comments ||= []
+        end
+
+        def namespace_for_variable(var)
+          return namespaces[var] if namespaces[var]
+
+          # The global variables for Ruby's core error classes does not
+          # represent their Ruby name. So we need to look up these names.
+          name = ERROR_CLASS_NAMES[var]
+          return P(name) if name
+
+          # Otherwise the name is inferred from the C variable name.
+          var = remove_var_prefix(var)
+          var.empty? ? nil : P(var)
+        end
+
+        def ensure_variable_defined!(var, max_retries = 1)
+          retries = 0
+          object = nil
+
+          loop do
+            object = namespace_for_variable(var)
+            break unless object.is_a?(Proxy)
+
+            raise NamespaceMissingError, object if retries > max_retries
+            log.debug "Missing namespace variable #{var} in file `#{parser.file}', moving it to the back of the line."
+            parser.parse_remaining_files
+            retries += 1
+          end
+
+          object
+        end
+
+        def namespaces
+          globals.cruby_namespaces ||= {}
+        end
+
+        def processed_files
+          globals.cruby_processed_files ||= {}
+        end
+
+        # @group Parsing an Inner Block
+
+        def parse_block(opts = {})
+          return if !statement.block || statement.block.empty?
+          push_state(opts) do
+            parser.process(statement.block)
+          end
+        end
+
+        # @group Processing other files
+
+        def process_file(file, object)
+          file = File.cleanpath(file)
+          return if processed_files[file]
+          processed_files[file] = file
+          begin
+            log.debug "Processing embedded call to C source #{file}..."
+            globals.ordered_parser.files.delete(file) if globals.ordered_parser
+            parser.process(Parser::C::CParser.new(File.read(file), file).parse)
+          rescue Errno::ENOENT
+            log.warn "Missing source file `#{file}' when parsing #{object}"
+          end
+        end
+
+        # @endgroup
+
+        private
+
+        # Generated by update_error_map.rb (Copy+past results)
+        ERROR_CLASS_NAMES = {
+          'rb_eArgError' => 'ArgumentError',
+          'rb_eEncodingError' => 'EncodingError',
+          'rb_eException' => 'Exception',
+          'rb_eFatal' => 'fatal',
+          'rb_eFrozenError' => 'FrozenError',
+          'rb_eIndexError' => 'IndexError',
+          'rb_eInterrupt' => 'Interrupt',
+          'rb_eKeyError' => 'KeyError',
+          'rb_eLoadError' => 'LoadError',
+          'rb_eNameError' => 'NameError',
+          'rb_eNoMatchingPatternError' => 'NoMatchingPatternError',
+          'rb_eNoMemError' => 'NoMemoryError',
+          'rb_eNoMethodError' => 'NoMethodError',
+          'rb_eNotImpError' => 'NotImplementedError',
+          'rb_eRangeError' => 'RangeError',
+          'rb_eRuntimeError' => 'RuntimeError',
+          'rb_eScriptError' => 'ScriptError',
+          'rb_eSecurityError' => 'SecurityError',
+          'rb_eSignal' => 'SignalException',
+          'rb_eStandardError' => 'StandardError',
+          'rb_eSyntaxError' => 'SyntaxError',
+          'rb_eSystemCallError' => 'SystemCallError',
+          'rb_eSystemExit' => 'SystemExit',
+          'rb_eTypeError' => 'TypeError',
+        }
+
+        def remove_var_prefix(var)
+          var.gsub(/^rb_[mc]|^[a-z_]+/, '')
+        end
+      end
+    end
+  end
+end

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/handlers/ruby/attribute_handler.rb

@@ -52,7 +52,7 @@ class YARD::Handlers::Ruby::AttributeHandler < YARD::Handlers::Ruby::Base
           register(o)
           o.docstring = doc if o.docstring.blank?(false)
 
-          # Regsiter the object explicitly
+          # Register the object explicitly
           namespace.attributes[scope][name][type] = o
         else
           obj = namespace.children.find {|other| other.name == meth.to_sym && other.scope == scope }

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/handlers/ruby/legacy/attribute_handler.rb

@@ -51,7 +51,7 @@ class YARD::Handlers::Ruby::Legacy::AttributeHandler < YARD::Handlers::Ruby::Leg
           register(o)
           o.docstring = doc if o.docstring.blank?(false)
 
-          # Regsiter the object explicitly
+          # Register the object explicitly
           namespace.attributes[scope][name][type] = o
         else
           obj = namespace.children.find {|other| other.name == meth.to_sym && other.scope == scope }

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/handlers/ruby/method_handler.rb

@@ -67,7 +67,7 @@ class YARD::Handlers::Ruby::MethodHandler < YARD::Handlers::Ruby::Base
   end
 
   def format_args
-    args = statement.parameters
+    return [] unless args = statement.parameters
 
     params = []
 
@@ -97,7 +97,7 @@ class YARD::Handlers::Ruby::MethodHandler < YARD::Handlers::Ruby::Base
       params << ['**' + args.double_splat_param.source, nil]
     end
 
-    params << ['&' + args.block_param.source, nil] if args.block_param
+    params << ['&' + args.block_param.source, nil] if args.block_param && !args.args_forward
 
     params
   end

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/handlers/ruby/mixin_handler.rb

@@ -2,6 +2,7 @@
 # Handles the 'include' statement to mixin a module in the instance scope
 class YARD::Handlers::Ruby::MixinHandler < YARD::Handlers::Ruby::Base
   handles method_call(:include)
+  handles method_call(:prepend)
   namespace_only
 
   process do
@@ -25,20 +26,31 @@ class YARD::Handlers::Ruby::MixinHandler < YARD::Handlers::Ruby::Base
     raise YARD::Parser::UndocumentableError unless mixin.ref?
     raise YARD::Parser::UndocumentableError if mixin.first.type == :ident
 
-    case obj = Proxy.new(namespace, mixin.source)
-    when ConstantObject # If a constant is included, use its value as the real object
-      obj = Proxy.new(namespace, obj.value, :module)
+    if mixin.type == :var_ref && mixin[0] == s(:kw, "self")
+      obj = namespace
     else
-      obj = Proxy.new(namespace, mixin.source, :module)
+      case obj = Proxy.new(namespace, mixin.source)
+      when ConstantObject # If a constant is included, use its value as the real object
+        obj = Proxy.new(namespace, obj.value, :module)
+      else
+        obj = Proxy.new(namespace, mixin.source, :module)
+      end
     end
 
     rec = recipient(mixin)
-    return if rec.nil? || rec.mixins(scope).include?(obj)
-    rec.mixins(scope).unshift(obj)
+    return if rec.nil?
+
+    ensure_loaded!(rec)
+    return if rec.mixins(scope).include?(obj)
+
+    shift = statement.method_name(true) == :include ? :unshift : :push
+    rec.mixins(scope).send(shift, obj)
   end
 
   def recipient(mixin)
-    if statement[0].type == :var_ref && statement[0][0] != s(:kw, "self")
+    if statement[0].type == :const_path_ref || statement[0].type == :top_const_ref
+      Proxy.new(namespace, statement[0].source)
+    elsif statement[0].type == :var_ref && statement[0][0] != s(:kw, "self")
       statement[0][0].type == :const ?
         Proxy.new(namespace, statement.namespace.source) :
         nil

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/handlers/ruby/module_function_handler.rb

@@ -2,6 +2,8 @@
 # Handles module_function calls to turn methods into public class methods.
 # Also creates a private instance copy of the method.
 class YARD::Handlers::Ruby::ModuleFunctionHandler < YARD::Handlers::Ruby::Base
+  include YARD::Handlers::Ruby::DecoratorHandlerMethods
+
   handles method_call(:module_function)
   namespace_only
 
@@ -13,15 +15,25 @@ class YARD::Handlers::Ruby::ModuleFunctionHandler < YARD::Handlers::Ruby::Base
     when :fcall, :command
       statement[1].traverse do |node|
         case node.type
+        when :def
+          process_decorator do |instance_method|
+            make_module_function(instance_method, namespace)
+          end
+          break
         when :symbol; name = node.first.source
         when :string_content; name = node.source
         else next
         end
+
         instance_method = MethodObject.new(namespace, name)
-        class_method = MethodObject.new(namespace, name, :module)
-        instance_method.copy_to(class_method)
-        class_method.visibility = :public
+        make_module_function(instance_method, namespace)
       end
     end
   end
+
+  def make_module_function(instance_method, namespace)
+    class_method = MethodObject.new(namespace, instance_method.name, :module)
+    instance_method.copy_to(class_method)
+    class_method.visibility = :public
+  end
 end

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/i18n/locale.rb

@@ -57,7 +57,7 @@ module YARD
       end
 
       # @param [String] message the translation target message.
-      # @return [String] translated message. If tarnslation isn't
+      # @return [String] translated message. If translation isn't
       #   registered, the +message+ is returned.
       def translate(message)
         @messages[message] || message

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/i18n/message.rb

@@ -8,7 +8,7 @@ module YARD
     #
     # @since 0.8.1
     class Message
-      # @return [String] the message ID of the trnslation target message.
+      # @return [String] the message ID of the translation target message.
       attr_reader :id
 
       # @return [Set] the set of locations. Location is an array of
@@ -18,7 +18,7 @@ module YARD
       # @return [Set] the set of comments for the messages.
       attr_reader :comments
 
-      # Creates a trasnlate target message for message ID +id+.
+      # Creates a translate target message for message ID +id+.
       #
       # @param [String] id the message ID of the translate target message.
       def initialize(id)

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/i18n/messages.rb

@@ -28,7 +28,7 @@ module YARD
         @messages[id]
       end
 
-      # Registers a {Message}, the mssage ID of which is +id+. If
+      # Registers a {Message}, the message ID of which is +id+. If
       # corresponding +Message+ is already registered, the previously
       # registered object is returned.
       #

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/i18n/pot_generator.rb

@@ -113,7 +113,7 @@ module YARD
       #
       # Locations of the +Message+ are used to generate the reference
       # line that is started with "#: ". +relative_base_path+ passed
-      # when the generater is created is prepended to each path in location.
+      # when the generator is created is prepended to each path in location.
       #
       # Comments of the +Message+ are used to generate the
       # translator-comment line that is started with "# ".

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/options.rb

@@ -94,7 +94,7 @@ module YARD
     #
     # @example Setting an option with Hash syntax
     #   options[:format] = :html # equivalent to: options.format = :html
-    # @param [Symbol, String] key the optin to set
+    # @param [Symbol, String] key the option to set
     # @param [Object] value the value to set for the option
     # @return [Object] the value being set
     def []=(key, value) send("#{key}=", value) end

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/parser/ruby/ast_node.rb

@@ -426,6 +426,13 @@ module YARD
         def block_param
           self[-1] ? self[-1][0] : nil
         end
+
+        def args_forward
+          # shape is (required, optional, rest, more, keyword, keyword_rest, block)
+          # Ruby 3.1 moves :args_forward from rest to keyword_rest
+          args_index = YARD.ruby31? ? -2 : 2
+          self[args_index].type == :args_forward if self[args_index]
+        end
       end
 
       class MethodCallNode < AstNode
@@ -480,7 +487,7 @@ module YARD
         end
 
         def parameters(include_block_param = true)
-          params = self[1 + index_adjust]
+          return unless params = self[1 + index_adjust]
           params = params[0] if params.type == :paren
           include_block_param ? params : params[0...-1]
         end
@@ -488,7 +495,7 @@ module YARD
         def signature
           params_src = ''
           params = self[1 + index_adjust]
-          if params.first
+          if params and params.first
             params_src = params.type == :paren ? '' : ' '
             params_src += params.source.gsub(/\s+(\s|\))/m, '\1')
           end

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/parser/ruby/ruby_parser.rb

@@ -133,6 +133,12 @@ module YARD
         AST_TOKENS = [:CHAR, :backref, :const, :cvar, :gvar, :heredoc_end, :ident,
           :int, :float, :ivar, :label, :period, :regexp_end, :tstring_content, :backtick]
 
+        COMMENT_SKIP_NODE_TYPES = [
+          :comment,
+          :void_stmt,
+          :list
+        ].freeze
+
         MAPPINGS.each do |k, v|
           if Array === v
             v.each {|vv| (REV_MAPPINGS[vv] ||= []) << k }
@@ -144,7 +150,7 @@ module YARD
         PARSER_EVENT_TABLE.each do |event, arity|
           node_class = AstNode.node_class_for(event)
 
-          if /_new\z/ =~ event.to_s && arity == 0
+          if arity == 0 && /_new\z/ =~ event.to_s
             module_eval(<<-eof, __FILE__, __LINE__ + 1)
               def on_#{event}(*args)
                 #{node_class}.new(:list, args, :listchar => charno...charno, :listline => lineno..lineno)
@@ -370,7 +376,7 @@ module YARD
 
         def on_aref(*args)
           @map[:lbracket].pop
-          ll, lc = *@map[:aref].pop
+          ll, lc = *@map[:aref].shift
           sr = args.first.source_range.first..lc
           lr = args.first.line_range.first..ll
           AstNode.new(:aref, args, :char => sr, :line => lr)
@@ -613,7 +619,7 @@ module YARD
 
         def insert_comments
           root.traverse do |node|
-            next if [:comment, :void_stmt, :list].include?(node.type) || node.parent.type != :list
+            next if COMMENT_SKIP_NODE_TYPES.include?(node.type) || node.parent.type != :list
 
             # never attach comments to if/unless mod nodes
             if node.type == :if_mod || node.type == :unless_mod

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/parser/source_parser.rb

@@ -64,7 +64,7 @@ module YARD
     class SourceParser
       SHEBANG_LINE  = /\A\s*#!\S+/
       ENCODING_LINE = %r{\A(?:\s*#*!.*\r?\n)?\s*(?:#+|/\*+|//+).*coding\s*[:=]{1,2}\s*([a-z\d_\-]+)}i
-      FROZEN_STRING_LINE = /frozen(-|_)string(-|_)literal: true/i
+      FROZEN_STRING_LINE = /frozen(-|_)string(-|_)literal:\s+(true|false)/i
 
       # The default glob of files to be parsed.
       # @since 0.9.0
@@ -476,9 +476,8 @@ module YARD
           content.force_encoding('binary')
           ENCODING_BYTE_ORDER_MARKS.each do |encoding, bom|
             bom.force_encoding('binary')
-            if content[0, bom.size] == bom
-              content.force_encoding(encoding)
-              return content
+            if content.start_with?(bom)
+              return content.sub(bom, '').force_encoding(encoding)
             end
           end
           content.force_encoding('utf-8') # UTF-8 is default encoding

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/registry_resolver.rb

@@ -132,7 +132,8 @@ module YARD
 
       path.scan(split_on_separators_match).each do |part, sep|
         cur_obj = nil
-        pos += "#{part}#{sep}".length
+        pos += part.length
+        pos += sep.length
         parsed_end = pos == path.length
 
         if !last_obj || (!parsed_end && !last_obj.is_a?(CodeObjects::NamespaceObject))

data/gems/{yard-0.9.25 → yard-0.9.36}/lib/yard/server/commands/base.rb

@@ -119,7 +119,7 @@ module YARD
         #     def run
         #       self.body = 'ERROR! The System is down!'
         #       self.status = 500
-        #       self.headers['Conten-Type'] = 'text/plain'
+        #       self.headers['Content-Type'] = 'text/plain'
         #     end
         #   end
         #
@@ -183,7 +183,7 @@ module YARD
           self.body = "Not found: #{request.path}"
           headers['Content-Type'] = 'text/plain'
           headers['X-Cascade'] = 'pass'
-          headers.delete('Cache-Control')
+          headers['Cache-Control'] = 'nocache'
         end
 
         # Sets the headers and status code for a redirection to a given URL
@@ -201,7 +201,7 @@ module YARD
         # requests served with "?1234567890" style timestamp query strings.
         def add_cache_control
           return if request.query_string.to_i == 0
-          headers['Cache-Control'] = 'private, max-age=300'
+          headers['Cache-Control'] ||= 'public, max-age=300'
         end
       end
     end