utils 0.89.1 → 0.91.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bae48a704c2a4cf0b1ab2eaa4ef3e4fcae5d5e9c84fac4d3db59fbf03a5a24b
-  data.tar.gz: b1a0bd4139042eb1b737d5646d0b65b1bb13234aaf87e82ff0a3351314beea51
+  metadata.gz: b149334df404d05b42629dc6e31b42ce256deabef017d1f9b32a51461b40ebee
+  data.tar.gz: 122023649023e483bfe83fd17aa46c0f91e49d2713d37ebf8c88c93a07ff276a
 SHA512:
-  metadata.gz: 594e6c2ed20cd83ef59b979da3435b2ffcb1476913f52d2e1be5aa98667d0701fb737ee02cf2fd9ef764108afd50591aae0672fe5c69207635da55ed0f875a35
-  data.tar.gz: fe480b916e4a10261ccc51bf2f523a1902a21bef89fd65f231e18e768146b4c4b64ef954a4d39bc6e2ebe9a1d062964d7162b1ad7fcc1fc390f5cccdf2cb6d2c
+  metadata.gz: c1a2369321ea4b7f972b7d84533304f72c8c5cf9bfbd88a2cce706f89ccc525be5847992f1909dfc8669a7eeeebad57f861cca47841c3186f72ad368a24fe0d1
+  data.tar.gz: c58b333681c637c655dc628635de013550385e2eb384db3d26925d88eb339ce1a559663e85c0d1177b3cb1ab70339b39a04b148997c6d5209b60e5d02fc2eccd

data/bin/probe

@@ -117,16 +117,18 @@ def connect_server
     opts = $opts.subhash(*%w[n t]).each_with_object([]) { |(k, v), a|
       v.full? and a.concat [ "-#{k}", v ]
     }
-    probe_client.enqueue opts + $args
+    args = opts + $args
+    args += %w[ -- ] + $testrunner_args unless $testrunner_args.empty?
+    probe_client.enqueue(args)
     exit
   end
 end
 
 $config = Utils::ConfigFile.new
 $config.configure_from_paths
-testrunner_args = []
+$testrunner_args = []
 if i = ARGV.index('--')
-  testrunner_args.concat ARGV[(i + 1)..-1]
+  $testrunner_args.concat ARGV[(i + 1)..-1]
   $args = ARGV[0...i]
 else
   $args = ARGV.dup
@@ -134,6 +136,10 @@ end
 $opts = go 'lct:n:C:s:h', $args
 $opts[?h] and usage
 
+$args.freeze
+$testrunner_args.freeze
+$opts.freeze
+
 case
 when $opts[?l]
   start_server
@@ -156,11 +162,11 @@ when :rspec
     end
   end
   cmd 'ruby', '-I', $config.probe.include_dirs_argument, *rspec,
-    *($args + testrunner_args)
+    *($args + $testrunner_args)
 when :'test-unit'
   if testname = $opts[?n]
     cmd 'ruby', '-I', $config.probe.include_dirs_argument,
-      *($args + testrunner_args), '-n', testname
+      *($args + $testrunner_args), '-n', testname
   else
     $args = $args.inject([]) { |args, a|
       args.push(*File.directory?(a) ? Dir[File.join(a, ?*)] : a)
@@ -171,13 +177,13 @@ when :'test-unit'
         lf = Tins::LinesFile.for_filename(*sl)
         if testname = lf.match_backward(/def\s+(\S+?)(?:\(|\s*$)/).full?(:first)
           cmd 'ruby', '-I', $config.probe.include_dirs_argument,
-            sl.filename, *testrunner_args, '-n', testname
+            sl.filename, *$testrunner_args, '-n', testname
         else
           warn "no test found before line #{sl.linenumber}"
         end
       else
         cmd 'ruby', '-I', $config.probe.include_dirs_argument,
-          sl.filename, *testrunner_args
+          sl.filename, *$testrunner_args
       end
     end
   end
@@ -185,7 +191,7 @@ when :cucumber
   cucumber = find_cmd('cucumber')
   if linenumber = $opts[?n]
     cmd 'ruby', cucumber, '-r', $config.probe.include_dirs_argument, '-l',
-      linenumber, *($args + testrunner_args)
+      linenumber, *($args + $testrunner_args)
   else
     $args = $args.map do |a|
       if Utils::Editor::FILE_LINENUMBER_REGEXP =~ a
@@ -195,6 +201,6 @@ when :cucumber
       end
     end
     cmd 'ruby', cucumber, '-r', $config.probe.include_dirs_argument,
-      *($args + testrunner_args)
+      *($args + $testrunner_args)
   end
 end

data/lib/utils/irb/irb_server.rb

@@ -79,7 +79,7 @@ class Utils::IRB::IRBServer
       else
         @logger.warn("Message for action #{message.action.inspect} not supported.")
       end
-    rescue => e
+    rescue StandardError, SyntaxError => e
       @logger.error("#{self.class.name} caught #{e.class}: #{e} for #{message.to_json}.")
     end
     self

data/lib/utils/irb/regexp.rb

@@ -0,0 +1,32 @@
+# A module that extends Regexp functionality with additional pattern
+# matching and display capabilities.
+#
+# Provides enhanced regexp operations including match highlighting and
+# shell command integration.
+#
+# @example
+#   /pattern/ # => regular expression object
+#   /pattern/.show_match("text") # => highlighted text match
+module Utils::IRB::Regexp
+  # The show_match method evaluates a string against the receiver pattern
+  # and highlights matching portions.
+  #
+  # This method tests whether the provided string matches the pattern
+  # represented by the receiver. When a match is found, it applies the
+  # success proc to highlight the matched portion of the string. If no
+  # match is found, it applies the failure proc to indicate that no match
+  # was found.
+  #
+  # @param string [ String ] the string to be tested against the pattern
+  # @param success [ Proc ] a proc that processes the matched portion of the string
+  # @param failure [ Proc ] a proc that processes the "no match" indication
+  #
+  # @return [ String ] the formatted string with matched portions highlighted or a no match message
+  def show_match(
+    string,
+    success: -> s { Term::ANSIColor.green { s } },
+    failure: -> s { Term::ANSIColor.red { s } }
+  )
+    string =~ self ? "#{$`}#{success.($&)}#{$'}" : failure.("no match")
+  end
+end

data/lib/utils/irb/shell/wrappers.rb

@@ -0,0 +1,183 @@
+module Utils::IRB::Shell
+  # Base class for wrapping objects with descriptive metadata.
+  #
+  # This class provides a foundation for creating wrapper objects that
+  # associate descriptive information with underlying objects. It handles
+  # name conversion and provides common methods for accessing and comparing
+  # wrapped objects.
+  class WrapperBase
+    include Comparable
+
+    # The initialize method sets up the instance name by converting the
+    # input to a string representation.
+    #
+    # This method handles different input types by converting them to a
+    # string, prioritizing to_str over to_sym and falling back to to_s if
+    # neither is available.
+    #
+    # @param name [ Object ] the input name to be converted to a string
+    def initialize(name)
+      @name =
+        case
+        when name.respond_to?(:to_str)
+          name.to_str
+        when name.respond_to?(:to_sym)
+          name.to_sym.to_s
+        else
+          name.to_s
+        end
+    end
+
+    # The name reader method returns the value of the name instance
+    # variable.
+    #
+    # @return [ String] the value stored in the name instance variable
+    attr_reader :name
+
+    # The description reader method provides access to the description
+    # attribute.
+    #
+    # @return [ String, nil ] the description value or nil if not set
+    attr_reader :description
+
+    alias to_str description
+
+    alias inspect description
+
+    alias to_s description
+
+    # The == method assigns a new name value to the instance variable.
+    #
+    # @param name [ Object ] the name value to be assigned
+    #
+    # @return [ Object ] returns the assigned name value
+    def ==(name)
+      @name = name
+    end
+
+    alias eql? ==
+
+    # The hash method returns the hash value of the name attribute.
+    #
+    # @return [ Integer ] the hash value used for object identification
+    def hash
+      @name.hash
+    end
+
+    # The <=> method compares the names of two objects for sorting purposes.
+    #
+    # @param other [ Object ] the other object to compare against
+    #
+    # @return [ Integer ] -1 if this object's name is less than the other's,
+    #         0 if they are equal, or 1 if this object's name is greater than the other's
+    def <=>(other)
+      @name <=> other.name
+    end
+  end
+
+  # A wrapper class for Ruby constant objects that provides enhanced
+  # introspection and display capabilities.
+  #
+  # This class extends WrapperBase to create specialized wrappers for Ruby
+  # constant objects, offering detailed information about constants
+  # including their names and associated classes. It facilitates
+  # interactive exploration of Ruby constants in environments like IRB by
+  # providing structured access to constant metadata and enabling sorting
+  # and comparison operations based on constant descriptions.
+  class ConstantWrapper < WrapperBase
+    # The initialize method sets up a new instance with the provided object
+    # and name.
+    #
+    # This method configures the instance by storing a reference to the
+    # object's class and creating a description string that combines the
+    # name with the class name.
+    #
+    # @param obj [ Object ] the object whose class will be referenced
+    # @param name [ String ] the name to be used in the description
+    #
+    # @return [ Utils::Patterns::Pattern ] a new pattern instance configured with the provided arguments
+    def initialize(obj, name)
+      super(name)
+      @klass = obj.class
+      @description = "#@name:#@klass"
+    end
+
+    # The klass reader method provides access to the class value stored in the instance.
+    #
+    # @return [ Object ] the class value
+    attr_reader :klass
+  end
+
+
+  # A wrapper class for Ruby method objects that provides enhanced
+  # introspection and display capabilities.
+  #
+  # This class extends WrapperBase to create specialized wrappers for Ruby
+  # method objects, offering detailed information about methods including
+  # their source location, arity, and owner. It facilitates interactive
+  # exploration of Ruby methods in environments like IRB by providing
+  # structured access to method metadata and enabling sorting and
+  # comparison operations based on method descriptions.
+  class MethodWrapper < WrapperBase
+    # The initialize method sets up a new instance with the specified
+    # object, method name, and module flag.
+    #
+    # This method creates and configures a new instance by storing the
+    # method object and its description, handling both instance methods and
+    # regular methods based on the module flag parameter.
+    #
+    # @param obj [ Object ] the object from which to retrieve the method
+    # @param name [ String ] the name of the method to retrieve
+    # @param modul [ TrueClass, FalseClass ] flag indicating whether to retrieve an instance method
+    def initialize(obj, name, modul)
+      super(name)
+      @wrapped_method = modul ? obj.instance_method(name) : obj.method(name)
+      @description = @wrapped_method.description(style: :namespace)
+    end
+
+    # The method reader returns the method object associated with the
+    # instance.
+    attr_reader :wrapped_method
+
+    # The owner method retrieves the owner of the method object.
+    #
+    # This method checks if the wrapped method object responds to the owner
+    # message and returns the owner if available, otherwise it returns nil.
+    #
+    # @return [ Object, nil ] the owner of the method or nil if not applicable
+    def owner
+      @wrapped_method.respond_to?(:owner) ? @wrapped_method.owner : nil
+    end
+
+    # The arity method returns the number of parameters expected by the method.
+    #
+    # @return [ Integer ] the number of required parameters for the method
+    def arity
+      @wrapped_method.arity
+    end
+
+    # The source_location method retrieves the file path and line number
+    # where the method is defined.
+    #
+    # This method accesses the underlying source location information for
+    # the method object, returning an array that contains the filename and
+    # line number of the method's definition.
+    #
+    # @return [ Array<String, Integer> ] an array containing the filename and line number
+    #         where the method is defined, or nil if the location cannot be determined
+    def source_location
+      @wrapped_method.source_location
+    end
+
+    # The <=> method compares the descriptions of two objects for ordering
+    # purposes.
+    #
+    # @param other [ Object ] the other object to compare against
+    #
+    # @return [ Integer ] -1 if this object's description is less than the other's,
+    #         0 if they are equal, or 1 if this object's description is greater than the other's
+    def <=>(other)
+      @description <=> other.description
+    end
+  end
+end