rubycli 0.1.1

data/lib/rubycli/command_line.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Rubycli
+  module CommandLine
+    USAGE = <<~USAGE
+      Usage: rubycli [--new|-n] [--pre-script SRC] [--json-args | --eval-args] TARGET_PATH [CLASS_OR_MODULE] [-- CLI_ARGS...]
+
+      Examples:
+        rubycli scripts/sample_runner.rb echo --message hello
+        rubycli scripts/sample_runner.rb AlternateRunner greet --name Ruby
+        rubycli --new lib/akiya_fetcher.rb fetch_simplified_html https://example.com
+
+      Options:
+        --new, -n            Instantiate the class/module before invoking CLI commands
+        --pre-script SRC     Evaluate Ruby code and use its result as the exposed target (--init alias)
+        --json-args          Treat all following arguments as JSON
+        --eval-args          Evaluate following arguments as Ruby code
+        (Note: --json-args and --eval-args are mutually exclusive)
+
+      When CLASS_OR_MODULE is omitted, Rubycli infers it from the file name in CamelCase.
+      Method return values are printed to STDOUT by default.
+      CLI_ARGS are forwarded to Rubycli unchanged.
+    USAGE
+
+    module_function
+
+    def run(argv = ARGV)
+      args = Array(argv).dup
+      Rubycli.environment.enable_print_result!
+
+      if args.empty?
+        $stdout.puts(USAGE)
+        return 1
+      end
+
+      new_flag = false
+      json_mode = false
+      eval_mode = false
+      pre_script_sources = []
+
+      loop do
+        arg = args.first
+        break unless arg
+
+        case arg
+        when '-h', '--help', 'help'
+          $stdout.puts(USAGE)
+          return 0
+        when '--new', '-n'
+          new_flag = true
+          args.shift
+        when /\A--pre-script=(.+)\z/, /\A--init=(.+)\z/
+          label = Regexp.last_match(0).start_with?('--pre-script') ? '--pre-script' : '--init'
+          expr = Regexp.last_match(1)
+          pre_script_sources << { value: expr, context: "(inline #{label})" }
+          args.shift
+        when '--pre-script', '--init'
+          flag = args.shift
+          src = args.shift
+          unless src
+            warn "#{flag} requires a file path or inline Ruby code"
+            return 1
+          end
+          context = File.file?(src) ? File.expand_path(src) : "(inline #{flag})"
+          pre_script_sources << { value: src, context: context }
+        when '--json-args'
+          json_mode = true
+          args.shift
+        when '--eval-args'
+          eval_mode = true
+          args.shift
+        when '--print-result'
+          args.shift
+        when '--'
+          args.shift
+          break
+        else
+          break
+        end
+      end
+
+      if args.empty?
+        $stdout.puts(USAGE)
+        return 1
+      end
+
+      target_path = args.shift
+      class_or_module = nil
+      possible_class = args.first
+      if possible_class && possible_class != '--' && possible_class.match?(/\A[A-Z]/)
+        class_or_module = args.shift
+      end
+      args.shift if args.first == '--'
+
+      if json_mode && eval_mode
+        warn '--json-args and --eval-args cannot be used at the same time'
+        return 1
+      end
+
+      Rubycli::Runner.execute(
+        target_path,
+        class_or_module,
+        args,
+        new: new_flag,
+        json: json_mode,
+        eval_args: eval_mode,
+        pre_scripts: pre_script_sources
+      )
+
+      0
+    rescue Rubycli::Runner::PreScriptError => e
+      warn e.message
+      1
+    end
+  end
+end