commander-tool 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5fe0b76d088b96fcd3e9a46d540f79ff38d10bb49d1f35c8ed4d2b1f9bd26ddb
+  data.tar.gz: 2c349bc20037922113ea90e74a00c6688495f1950bebe67c505d502c6bffff4d
+SHA512:
+  metadata.gz: 4c20b7c34bcdb2663ee7f4554ac25b1c41c8910fe62d21e9e91b60b47f651c54fdfc7aa0e7f529db11e6a1e27e26d61ba12bc40c5f08ff8ad8fbd7fe8679b4fa
+  data.tar.gz: 3bd9b6f788e3b2bb33e714520db2b57eb299cce3d95670b15dfb6a203cac16acc233a5c5b908647d1f3a2e5d9e2118fc32a4ca60d79a7f095afade07fe90734b

data/lib/commander-tool.rb

@@ -0,0 +1,195 @@
+require 'did_you_mean'
+
+class Commander
+  class Command
+    attr_reader :name, :description, :options, :block
+
+    def initialize(name, description = '', &block)
+      @name = name.to_s
+      @description = description
+      @options = []
+      @block = block
+    end
+
+    def add_option(switches, description = '')
+      @options << Option.new(switches, description)
+      self
+    end
+  end
+
+  class Option
+    attr_reader :switches, :description, :key
+
+    def initialize(switches, description = '')
+      @switches = switches
+      @description = description
+
+      @key =
+        switches.find { |s| s.start_with?('--') }&.sub(/^--/, '')&.tr('-', '_') ||
+        switches.find { |s| s.start_with?('-') }&.sub(/^-/, '')
+    end
+
+    def matches?(arg)
+      @switches.include?(arg)
+    end
+
+    def value_required?
+      description.include?('<') ||
+        description.include?('argument') ||
+        description.include?('value') ||
+        description.include?('VALUE')
+    end
+  end
+
+  def initialize
+    @commands = {}
+    @global_options = []
+  end
+
+  def add_command(name, description = '', &block)
+    cmd = Command.new(name, description, &block)
+    @commands[cmd.name] = cmd
+    cmd
+  end
+
+  def add_option(switches, description = '')
+    @global_options << Option.new(switches, description)
+    self
+  end
+
+  def parse(args = ARGV)
+    global_parsed, remaining_args =
+      parse_options(args, @global_options)
+
+    command_name = remaining_args.shift
+
+    if command_name.nil?
+      handle_no_command(global_parsed)
+      return
+    end
+
+    if @commands.key?(command_name)
+      command = @commands[command_name]
+
+      cmd_parsed, command_args =
+        parse_options(remaining_args, command.options)
+
+      # Merge global and command options for execution
+      combined_options = global_parsed.merge(cmd_parsed)
+
+      command.block.call(combined_options, command_args) if command.block
+    else
+      raise_unknown_command(command_name)
+    end
+  end
+
+  private
+
+  def parse_options(args, available_options)
+    parsed = {}
+    remaining = []
+    i = 0
+
+    while i < args.length
+      arg = args[i]
+
+      if arg.start_with?('-')
+        option = available_options.find { |opt| opt.matches?(arg) }
+
+        unless option
+          raise_unknown_option(arg, available_options)
+        end
+
+        next_arg = args[i + 1]
+
+        if option.value_required?
+          if next_arg.nil? || next_arg.start_with?('-')
+            raise_missing_argument(arg)
+          end
+
+          parsed[option.key.to_sym] = next_arg
+          i += 2
+        elsif next_arg && !next_arg.start_with?('-')
+          parsed[option.key.to_sym] = next_arg
+          i += 2
+        else
+          parsed[option.key.to_sym] = true
+          i += 1
+        end
+      else
+        remaining << arg
+        i += 1
+      end
+    end
+
+    [parsed, remaining]
+  end
+
+  def raise_missing_argument(option_name)
+    abort "error: flag '#{option_name}' needs an argument"
+  end
+
+  def raise_unknown_command(command_name)
+    corrector = DidYouMean::SpellChecker.new(
+      dictionary: @commands.keys
+    )
+
+    suggestions = corrector.correct(command_name)
+
+    msg = "error: unknown command '#{command_name}'"
+
+    unless suggestions.empty?
+      msg += "\n\nDid you mean?\n"
+      msg += suggestions.map { |s| "\t#{s}" }.join("\n")
+    end
+
+    abort msg
+  end
+
+  def raise_unknown_option(option_name, available_options)
+    all_switches = available_options.flat_map(&:switches)
+
+    corrector = DidYouMean::SpellChecker.new(
+      dictionary: all_switches
+    )
+
+    suggestions = corrector.correct(option_name)
+
+    msg = "error: unknown option '#{option_name}'"
+
+    unless suggestions.empty?
+      msg += "\n\nDid you mean?\n"
+      msg += suggestions.map { |s| "\t#{s}" }.join("\n")
+    end
+
+    abort msg
+  end
+
+  def handle_no_command(options)
+    if options[:version] || options[:v]
+      puts "Commander CLI v1.0.0"
+      return
+    end
+
+    puts "Usage: <command> [options]"
+    puts
+    puts "Commands:"
+
+    if @commands.empty?
+      puts "  No commands available."
+    else
+      @commands.each_value do |command|
+        puts "  #{command.name.ljust(20)} #{command.description}"
+      end
+    end
+
+    unless @global_options.empty?
+      puts
+      puts "Options:"
+
+      @global_options.each do |option|
+        puts "  #{option.switches.join(', ').ljust(20)} #{option.description}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,38 @@
+--- !ruby/object:Gem::Specification
+name: commander-tool
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jjjm
+bindir: bin
+cert_chain: []
+date: 2026-09-17 00:00:00.000000000 Z
+dependencies: []
+description: Command and option parser with DidYouMean support.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/commander-tool.rb
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Lightweight Ruby command-line parser
+test_files: []