rubycli 0.1.2 → 0.1.5

data/lib/rubycli/cli.rb

@@ -37,7 +37,7 @@ module Rubycli
 
       if should_show_help?(args)
         @help_renderer.print_help(target, catalog)
-        exit(0)
+        return 0
       end
 
       command = args.shift
@@ -48,6 +48,9 @@ module Rubycli
       else
         execute_method(entry.method, command, args, cli_mode)
       end
+    rescue Rubycli::ArgumentError => e
+      warn "[ERROR] #{e.message}"
+      1
     end
 
     def available_commands(target)
@@ -105,7 +108,7 @@ module Rubycli
         error_msg = "Command '#{command}' is not available."
         puts error_msg
         @help_renderer.print_help(target, catalog)
-        exit(1)
+        1
       end
     end
 
@@ -113,9 +116,11 @@ module Rubycli
       method = target.method(:call)
       pos_args, kw_args = @argument_parser.parse(args, method)
       Rubycli.apply_argument_coercions(pos_args, kw_args)
+      @argument_parser.validate_inputs(method, pos_args, kw_args)
       begin
         result = Rubycli.call_target(target, pos_args, kw_args)
         @result_emitter.emit(result)
+        0
       rescue StandardError => e
         handle_execution_error(e, command, method, pos_args, kw_args, cli_mode)
       end
@@ -132,15 +137,16 @@ module Rubycli
     def execute_parameterless_method(method_obj, command, args, cli_mode)
       if help_requested_for_parameterless?(args)
         puts usage_for_method(command, method_obj)
-        exit(0)
+        return 0
       end
 
       begin
         result = method_obj.call
         debug_log "Parameterless method returned: #{result.inspect}"
         if result
-          run(result, args, false)
+          return run(result, args, false)
         end
+        0
       rescue StandardError => e
         handle_execution_error(e, command, method_obj, [], {}, cli_mode)
       end
@@ -149,15 +155,16 @@ module Rubycli
     def execute_method_with_params(method_obj, command, args, cli_mode)
       pos_args, kw_args = @argument_parser.parse(args, method_obj)
       Rubycli.apply_argument_coercions(pos_args, kw_args)
-
       if should_show_method_help?(pos_args, kw_args)
         puts usage_for_method(command, method_obj)
-        exit(0)
+        return 0
       end
+      @argument_parser.validate_inputs(method_obj, pos_args, kw_args)
 
       begin
         result = Rubycli.call_target(method_obj, pos_args, kw_args)
         @result_emitter.emit(result)
+        0
       rescue StandardError => e
         handle_execution_error(e, command, method_obj, pos_args, kw_args, cli_mode)
       end
@@ -181,7 +188,7 @@ module Rubycli
       if cli_mode && !arguments_match?(method_obj, pos_args, kw_args) && usage_error?(error)
         puts "Error: #{error.message}"
         puts usage_for_method(command, method_obj)
-        exit(1)
+        1
       else
         raise error
       end

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] [--strict] [--check|-c] <target-path> [<class-or-module>] [-- <cli-args>...]
 
       Examples:
         rubycli scripts/sample_runner.rb echo --message hello
@@ -15,7 +15,11 @@ 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
+        --strict             Enforce documented input types/choices (invalid values abort)
+        --check, -c          Validate documentation/comments without executing commands
+        (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 +42,9 @@ module Rubycli
       new_flag = false
       json_mode = false
       eval_mode = false
+      eval_lax_mode = false
+      constant_mode = nil
+      check_mode = false
       pre_script_sources = []
 
       loop do
@@ -60,7 +67,7 @@ module Rubycli
           flag = args.shift
           src = args.shift
           unless src
-            warn "#{flag} requires a file path or inline Ruby code"
+            warn "[ERROR] #{flag} requires a file path or inline Ruby code"
             return 1
           end
           context = File.file?(src) ? File.expand_path(src) : "(inline #{flag})"
@@ -71,8 +78,26 @@ 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 '--strict'
+          Rubycli.environment.enable_strict_input!
+          args.shift
+        when '--check', '-c'
+          check_mode = true
+          Rubycli.environment.enable_doc_check!
+          args.shift
         when '--print-result'
           args.shift
+        when '--debug'
+          args.shift
+          warn "[ERROR] --debug flag has been removed; set RUBYCLI_DEBUG=true instead."
+          return 1
+        when '--auto-target', '-a'
+          constant_mode = :auto
+          args.shift
         when '--'
           args.shift
           break
@@ -95,10 +120,32 @@ 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 '[ERROR] --json-args cannot be combined with --eval-args or --eval-lax'
+        return 1
+      end
+
+      if check_mode && (json_mode || eval_mode)
+        warn '[ERROR] --check cannot be combined with --json-args or --eval-args'
+        return 1
+      end
+
+      if check_mode && !args.empty?
+        warn '[ERROR] --check does not accept command arguments'
         return 1
       end
 
+      Rubycli.environment.clear_documentation_issues!
+
+      if check_mode
+        return Rubycli::Runner.check(
+          target_path,
+          class_or_module,
+          new: new_flag,
+          pre_scripts: pre_script_sources,
+          constant_mode: constant_mode
+        )
+      end
+
       Rubycli::Runner.execute(
         target_path,
         class_or_module,
@@ -106,12 +153,17 @@ 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
+      warn "[ERROR] #{e.message}"
+      1
+    rescue Rubycli::Runner::Error => e
+      warn "[ERROR] #{e.message}"
       1
     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