simple-cli-options 0.1.0.beta1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 13bfaed8074ca4a161936d0e7467e10f5268c9ae8aaab4a68d3a47bb1861a6f6
+  data.tar.gz: 2916c0ea3b668b499a5a0d22fa7e7a3e0a2de753f856d2fd2529ca284dcee920
+SHA512:
+  metadata.gz: 3b416b95da5e146933480332868968382291864aa1fadab49e140e736adff1f6bc2c2543c1480a2d526113f42ad0da44895d43e01fba65d30d4038e1ecdbda71
+  data.tar.gz: 41420744ead523fa5b942e59987928a5013dc08305d725a4aeabce726c9e7c45738a470a9d413cbe80c3b8b202aefdda41d317a8ed1be7416306e951bdbd0814

data/lib/option.rb

@@ -0,0 +1,76 @@
+# typed: strict
+# frozen_string_literal: true
+
+require 'sorbet-runtime'
+require 'stringio'
+
+# ==========================================
+# 1. Option クラス（各フラグの定義と検証・変換）
+# ==========================================
+class Option
+  extend T::Sig
+
+  sig { returns(Symbol) }
+  attr_reader :name
+
+  sig { returns(String) }
+  attr_reader :short, :long, :desc
+
+  sig { returns(T::Boolean) }
+  attr_reader :required_flag
+
+  sig do
+    params(
+      name: Symbol,
+      short: String,
+      long: String,
+      desc: String,
+      required: T::Boolean,
+      options: T.untyped
+    ).void
+  end
+  def initialize(name, short:, long:, desc:, required: false, **options)
+    @name = name
+    @short = short
+    @long = long
+    @desc = desc
+    @required_flag = required
+
+    validate_structure!
+
+    # バリデーションは追加(Array)可能、変換は上書き
+    @validators = T.let([options[:validate]].compact, T::Array[T.proc.params(arg0: String).returns(T::Boolean)])
+    @converter  = T.let(options[:convert] || ->(v) { v }, T.proc.params(arg0: String).returns(T.untyped))
+  end
+
+  sig { params(block: T.proc.params(arg0: String).returns(T::Boolean)).returns(T.self_type) }
+  def validate(&block)
+    @validators << block
+    self
+  end
+
+  sig { params(block: T.proc.params(arg0: String).returns(T.untyped)).returns(T.self_type) }
+  def convert(&block)
+    @converter = block
+    self
+  end
+
+  sig { params(value: String).returns(T.untyped) }
+  def process(value)
+    @validators.each do |v|
+      raise "Validation failed for option '#{@name}' with value: #{value}" unless v.call(value)
+    end
+    @converter.call(value)
+  end
+
+  private
+
+  sig { void }
+  def validate_structure!
+    raise ArgumentError, "Property 'name' and 'desc' cannot be empty." if @name.to_s.empty? || @desc.empty?
+
+    return unless @short.empty? && @long.empty?
+
+    raise ArgumentError, "At least one of 'short' or 'long' flags must be provided for option '#{@name}'."
+  end
+end

data/lib/options.rb

@@ -0,0 +1,64 @@
+# typed: strict
+# frozen_string_literal: true
+
+require 'sorbet-runtime'
+require_relative 'option'
+
+# ==========================================
+# 2. Options クラス（オプションの管理と解析）
+# ==========================================
+class Options
+  extend T::Sig
+
+  sig { params(description: String).void }
+  def initialize(description: '')
+    @description = T.let(description, String)
+    @options = T.let([], T::Array[Option])
+    @values = T.let({}, T::Hash[Symbol, T.untyped])
+    @program_name = T.let(File.basename($0), String)
+  end
+
+  sig { params(option: Option).void }
+  def add(option)
+    @options << option
+  end
+
+  sig { void }
+  def show_help
+    puts "#{@description}\n\n" unless @description.empty?
+    puts "Usage:\n  #{@program_name} [flags]\n\n"
+    puts 'Flags:'
+    @options.each do |opt|
+      flags = [
+        opt.short.empty? ? nil : opt.short,
+        opt.long.empty? ? nil : opt.long
+      ].compact.join(', ')
+      printf "  %-20s %s\n", flags, opt.desc
+    end
+  end
+
+  sig { params(argv: T::Array[String]).void }
+  def parse!(argv)
+    if argv.include?('-h') || argv.include?('--help')
+      show_help
+      exit 0
+    end
+
+    @options.each do |opt|
+      # short または long に一致する引数を探す
+      idx = argv.find_index { |arg| arg == opt.short || arg == opt.long }
+
+      if idx && argv[idx + 1]
+        @values[opt.name] = opt.process(T.must(argv[idx + 1]))
+      elsif opt.required_flag
+        warn "Error: Missing required option: #{opt.long.empty? ? opt.short : opt.long}"
+        exit 1
+      end
+    end
+  end
+
+  sig { params(name: Symbol).returns(T.untyped) }
+  def get(name)
+    @values[name]
+  end
+end

data/lib/simple-cli-options.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'option'
+require_relative 'options'

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: simple-cli-options
+version: !ruby/object:Gem::Version
+  version: 0.1.0.beta1
+platform: ruby
+authors:
+- HIROAKI SATOU
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+description: |
+  simple-cli-options is a small Ruby library for parsing command-line flags with validation and conversion.
+  Define options with short/long forms, then parse ARGV and read values by name.
+  This gem is currently in BETA; APIs may change in future releases.
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/option.rb
+- lib/options.rb
+- lib/simple-cli-options.rb
+homepage: https://github.com/hiroakisatou/simple-options
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/hiroakisatou/simple-options
+  source_code_uri: https://github.com/hiroakisatou/simple-options
+  changelog_uri: https://github.com/hiroakisatou/simple-options/blob/main/README.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: A small Ruby library for parsing command-line flags (short and long options
+  with values).
+test_files: []