rubycli 0.1.2 → 0.1.4

data/lib/rubycli/command_line.rb

@@ -3,7 +3,7 @@
 module Rubycli
   module CommandLine
     USAGE = <<~USAGE
-      Usage: rubycli [--new|-n] [--pre-script=<src>] [--json-args|-j | --eval-args|-e] <target-path> [<class-or-module>] [-- <cli-args>...]
+      Usage: rubycli [--new|-n] [--pre-script=<src>] [--json-args|-j | --eval-args|-e | --eval-lax|-E] <target-path> [<class-or-module>] [-- <cli-args>...]
 
       Examples:
         rubycli scripts/sample_runner.rb echo --message hello
@@ -15,7 +15,9 @@ module Rubycli
         --pre-script=<src>   Evaluate Ruby code and use its result as the exposed target (--init alias; also accepts space-separated form)
         --json-args, -j      Parse all following arguments strictly as JSON (no YAML literals)
         --eval-args, -e      Evaluate following arguments as Ruby code
-        (Note: --json-args and --eval-args are mutually exclusive)
+        --eval-lax, -E       Evaluate as Ruby but fall back to raw strings when parsing fails
+        --auto-target, -a    Auto-select the only callable constant when names don't match
+        (Note: --json-args cannot be combined with --eval-args or --eval-lax)
         (Note: Every option that accepts a value understands both --flag=value and --flag value forms.)
 
       When <class-or-module> is omitted, Rubycli infers it from the file name in CamelCase.
@@ -38,6 +40,8 @@ module Rubycli
       new_flag = false
       json_mode = false
       eval_mode = false
+      eval_lax_mode = false
+      constant_mode = nil
       pre_script_sources = []
 
       loop do
@@ -71,7 +75,14 @@ module Rubycli
         when '--eval-args', '-e'
           eval_mode = true
           args.shift
+        when '--eval-lax', '-E'
+          eval_mode = true
+          eval_lax_mode = true
+          args.shift
         when '--print-result'
+         args.shift
+        when '--auto-target', '-a'
+          constant_mode = :auto
           args.shift
         when '--'
           args.shift
@@ -95,7 +106,7 @@ module Rubycli
       args.shift if args.first == '--'
 
       if json_mode && eval_mode
-        warn '--json-args and --eval-args cannot be used at the same time'
+        warn '--json-args cannot be combined with --eval-args or --eval-lax'
         return 1
       end
 
@@ -106,13 +117,18 @@ module Rubycli
         new: new_flag,
         json: json_mode,
         eval_args: eval_mode,
-        pre_scripts: pre_script_sources
+        eval_lax: eval_lax_mode,
+        pre_scripts: pre_script_sources,
+        constant_mode: constant_mode
       )
 
       0
     rescue Rubycli::Runner::PreScriptError => e
       warn e.message
       1
+    rescue Rubycli::Runner::Error => e
+      warn e.message
+      1
     end
   end
 end

data/lib/rubycli/constant_capture.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Rubycli
+  # Observes constants defined while loading a file.
+  class ConstantCapture
+    def initialize
+      @captured = Hash.new { |hash, key| hash[key] = [] }
+    end
+
+    def capture(file)
+      trace = TracePoint.new(:class) do |tp|
+        location = tp.path
+        next unless location && same_file?(file, location)
+
+        constant_name = qualified_name_for(tp.self)
+        next unless constant_name
+
+        @captured[file] << constant_name
+      end
+
+      trace.enable
+      yield
+    ensure
+      trace&.disable
+    end
+
+    def constants_for(file)
+      Array(@captured[normalize(file)]).uniq
+    end
+
+    private
+
+    def same_file?(target, candidate)
+      normalize(target) == normalize(candidate)
+    end
+
+    def normalize(file)
+      File.expand_path(file.to_s)
+    end
+
+    def qualified_name_for(target)
+      return nil unless target.respond_to?(:name)
+
+      name = target.name
+      return nil unless name && !name.empty? && !name.start_with?('#<')
+
+      name
+    end
+  end
+end

data/lib/rubycli/documentation/comment_extractor.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Rubycli
+  module Documentation
+    # Extracts contiguous comment blocks that appear immediately before a method.
+    class CommentExtractor
+      def initialize
+        @file_cache = {}
+      end
+
+      def extract(file, line_number)
+        return [] unless file && line_number
+
+        lines = cached_lines_for(file)
+        index = line_number - 2
+        block = []
+
+        while index >= 0
+          line = lines[index]
+          break unless comment_line?(line)
+
+          block << line
+          index -= 1
+        end
+
+        block.reverse.map { |line| strip_comment_prefix(line) }
+      rescue Errno::ENOENT
+        []
+      end
+
+      def reset!
+        @file_cache.clear
+      end
+
+      private
+
+      def cached_lines_for(file)
+        @file_cache[file] ||= File.readlines(file, chomp: true)
+      end
+
+      def comment_line?(line)
+        return false unless line
+
+        line.lstrip.start_with?('#')
+      end
+
+      def strip_comment_prefix(line)
+        line.lstrip.sub(/^#/, '').lstrip
+      end
+    end
+  end
+end