argvise 0.0.8 → 0.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96b6f0c2b58c2c978c647f988896d96377fa798b5df00eb372d8f2c13de6d479
-  data.tar.gz: ebdd6ef0219a35ab0c585f9310be93ac6f8a22b6376289002b8c414e4ffa6b4e
+  metadata.gz: 2d90fe07a2a4f58f550d26612903b467d83b99b1a0e0ae4ed00577e8e7459987
+  data.tar.gz: 444080af117dee382d702e6d3148d94733a90d94286187a55adda3744e37fb21
 SHA512:
-  metadata.gz: 6124154af43827d0b5d65d5c086ecb0941daf7f5b56a35655072ee6ba75486340d0eede11aebeb29e95cf69540cd3932e41f0d498d578e68e8ea580abef9ece2
-  data.tar.gz: 82a72a33658ea1e190a6f16f181e2d4a9f4c6bad414aa815307e4118a45d53624685809488e276ab84609509467b9fa7e7cda4001e89cfb3a428b073de6247a4
+  metadata.gz: ea1a7f17329319d8c172c092de516ebbaaf1440d4fafe4a12c3265f20e62e1169c34cc034c011bb84b1cb9feec1434c0eaccad3597d9361fc8b739e381b36d11
+  data.tar.gz: f7195c500e27b7cd429a6d23cbc95c76b1c32c468a22784503c491405cd5079190719ae4df76db9069d3dc54d091385c375bc0ae7984d6cf1f3e663e113d106d

data/.rubocop.yml

@@ -1,2 +1,45 @@
+# ln ~/.config/rubocop/config.yml .rubocop.yml
 AllCops:
   TargetRubyVersion: 3.1
+
+Lint/MissingCopEnableDirective:
+  Enabled: false
+Lint/RedundantCopDisableDirective:
+  Enabled: false
+Lint/EmptyExpression:
+  # disabled => allow ()
+  Enabled: false
+
+# https://docs.rubocop.org/rubocop/cops_style.html
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: diff_comma
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: diff_comma
+Style/Lambda:
+  EnforcedStyle: literal
+Style/ModuleFunction:
+  # EnforcedStyle: extend_self
+  EnforcedStyle: module_function
+Style/BlockDelimiters:
+  EnforcedStyle: braces_for_chaining
+Style/Documentation:
+  Enabled: false
+Style/ClassAndModuleChildren:
+  EnforcedStyle: compact
+
+# https://docs.rubocop.org/rubocop/cops_metrics.html
+Metrics/MethodLength:
+  Max: 15
+
+# https://docs.rubocop.org/rubocop/cops_layout.html
+Layout/CaseIndentation:
+  EnforcedStyle: end
+  IndentOneStep: true
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+
+Naming/AsciiIdentifiers:
+  # AsciiConstants: false
+  Enabled: false
+

data/.yardopts

@@ -0,0 +1,4 @@
+--markup markdown
+--title 'Argvise'
+--protected
+--no-private

data/docs/Readme.md

@@ -8,6 +8,12 @@ A Ruby gem for converting hash structures into command-line argument arrays.
 
 > **Note:** This is *not* a command-line parser — quite the opposite. Argvise helps you **build** CLI commands programmatically.
 
+## API DOC
+
+![ClassDiagram](../misc/assets/svg/ClassDiagram.svg)
+
+- Github Pages: <https://2moe.github.io/argvise-gem>
+
 ## Quick Start
 
 ```ruby
@@ -23,6 +29,9 @@ raw_cmd_hash = {
   cargo: (), b: (), r: true, target: "wasm32-wasip2"
 }
 
+using Argvise::HashRefin
+  # OR: include Argvise::HashMixin
+
 raw_cmd_hash
   .to_argv
   # .to_argv({bsd_style: false, kebab_case_flags: true})
@@ -183,16 +192,57 @@ Argvise.build(raw_cmd_hash)
 
 ### Shortcut
 
+#### Mixin
+
+```ruby
+require 'argvise'
+
+module A
+  module_function
+  include Argvise::HashMixin
+
+  def demo
+    { path: '/path/to/dir' }.to_argv.then { p it }
+    #=> ["--path", "/path/to/dir"]
+
+    { path: '/path/to/dir' }.to_argv_bsd.then { p it }
+    #=> ["-path", "/path/to/dir"]
+  end
+end
+
+A.demo
+Hash.method_defined?(:to_argv) # => true
+{}.respond_to?(:to_argv) #=> true
+```
+
+#### Refinement
+
 ```ruby
-{ v: true, dir: '/path/to/dir' }.to_argv
-# => ["-v", "--dir", "/path/to/dir"]
+require 'argvise'
+class A
+  using Argvise::HashRefin
+
+  def self.demo
+    { target: "wasm32-wasip2" }.to_argv.then { p it }
+      # => ["--target", "wasm32-wasip2"]
+
+    { target: "wasm32-wasip2" }.to_argv_bsd.then { p it }
+      # => ["-target", "wasm32-wasip2"]
+
+    {}.respond_to?(:to_argv).then { p it } #=> true
+  end
+end
+
+A.demo
+Hash.method_defined?(:to_argv) # => false
+{}.respond_to?(:to_argv) #=> false
 ```
 
 ### Configurable builder
 
 > Required
 >
-> - argvise: >= v0.0.6
+> - argvise: >= v0.0.9
 > - ruby: >= v3.1.0
 
 ```ruby
@@ -225,6 +275,10 @@ raw_cmd
 #=> ["compiler", "build", "--pack_type", "tar+zstd", "--push", "-v", "-f", "p2", "--tag", "v0.0.1", "--tag", "beta", "--platform", "wasi/wasm", "--label", "maintainer=user", "--label", "description=Demo", "/path/to/dir"]
 
 p '----------------'
+
+# argvise: >= v0.0.9
+using Argvise::HashRefin
+
 p 'GNU-style + kebab-case-flags=true'
 # argvise: >= v0.0.6
 raw_cmd
@@ -235,15 +289,13 @@ raw_cmd
 
 p '----------------'
 p 'BSD-style + kebab-case-flags=true'
-# argvise: >= v0.0.4
+# argvise: >= v0.0.9
 raw_cmd
-  .then(&Argvise.new_proc)
-  .with_bsd_style
-  .with_kebab_case_flags
-  .build
+  .to_argv_bsd
   .display
 
 #=> ["compiler", "build", "-pack-type", "tar+zstd", "-push", "-v", "-f", "p2", "-tag", "v0.0.1", "-tag", "beta", "-platform", "wasi/wasm", "-label", "maintainer=user", "-label", "description=Demo", "/path/to/dir"]
+p '----------------'
 ```
 
 ## Data Type
@@ -302,15 +354,27 @@ raw_cmd
 
 - `{ cargo: () }` => `["cargo"]`
 - `{ cargo: nil, b: nil }` => `["cargo", "b"]`
-- `{ "-fv": nil }` => `["-fv"]`
+- `{ "-fv": () }` => `["-fv"]`
 
 ## Changelog
 
 ### v0.0.6 (2025-11-05)
 
-Breaking Changes:
+Breaking Change:
 
 - `cmd_hash |> hash_to_argv` => `cmd_hash.to_argv(opts)`
-  - i.e.,
-    - old: `{a: true}.then(&hash_to_argv)`
-    - new: `{a: true}.to_argv`
+  - Previous: `{a: true}.then(&hash_to_argv)`
+  - Current: `{a: true}.to_argv`
+
+### v0.0.9 (2025-11-30)
+
+- add refinements for Hash
+- add `Hash#to_argv_bsd`
+
+Breaking Change:
+  - Mitigated side effects introduced by monkey patching.
+    - Previous:
+      - Simply calling `require 'argvise'` was enough to import `Hash#to_argv`;
+      - no explicit `include` or `using` was required.
+    - Current:
+      - We must manually `include Argvise::HashMixin` or `using Argvise::HashRefin` to import `Hash#to_argv`.

data/lib/argvise/core.rb

@@ -5,7 +5,7 @@
 # ------------------
 # Converts hash to command array
 #
-# == Example
+# @example
 #
 #   { cargo: nil, b: nil, r: true, target: "wasm32-wasip2" }
 #     .then(&Argvise.new_proc)
@@ -15,9 +15,9 @@
 #
 #   #=> ["cargo", "b", "-r", "--target", "wasm32-wasip2"]
 #
-# == Conversion Rules:
+# # Conversion Rules:
 #
-# === GNU Style:
+# ## GNU Style:
 #   - Boolean values:
 #     - `{ verbose: true }` => ["--verbose"]
 #     - `{ v: true }` => ["-v"]
@@ -32,7 +32,7 @@
 #     - `{ L: { env: 'test' } }` => `["-L", "env=test"]`
 #     - `{ label: { env: 'test' } }` => `["--label", "env=test"]`
 #
-# === BSD Style:
+# ## BSD Style:
 #   - Boolean values:
 #     - `{ verbose: true }` => ["-verbose"]
 #     - `{ v: true }` => ["-v"]
@@ -47,12 +47,12 @@
 #     - `{ L: { env: 'test' } }` => `["-L", "env=test"]`
 #     - `{ label: { env: 'test' } }` => `["-label", "env=test"]`
 #
-# === Common:
+# ## Common:
 #   - Raw values:
 #   - `{ cargo: nil, b: nil}` => `["cargo", "b"]`
 #   - `{ "-fv": nil}` => `["-fv"]`
 #
-# === About kebab_case_flags:
+# ## About kebab_case_flags:
 #   - `with_kebab_case_flags(true)`:
 #     - `{enable_jit: true}` =>
 #         - GNU-style: `["--enable-jit"]`
@@ -70,18 +70,17 @@ class Argvise
   class << self
     # Converts a hash into a command-line argument array
     #
-    # == Example
+    # @example
     #   require 'argvise'
     #   cmd = { ruby: nil, r: "argvise", verbose: true, e: true, "puts Argvise::VERSION": nil }
     #   opts = { bsd_style: false }
     #   Argvise.build(cmd, opts:)
     #
-    # == Params
-    #   - raw_cmd_hash [Hash] The hash to be converted (i.e., raw input data)
-    #   - opts [Hash] See also: [self.new]
+    # @param raw_cmd_hash [Hash] The hash to be converted (i.e., raw input data)
+    # @param opts [Hash]
+    # @see #initialize
     #
-    # == Returns
-    #   [Array<String>] The generated array of command-line arguments
+    # @return [Array<String>] The generated array of command-line arguments
     def build(
       raw_cmd_hash,
       opts: nil
@@ -94,15 +93,16 @@ class Argvise
     #
     # Useful for transforming a hash of CLI arguments into a command array.
     #
-    # == Example
+    # @example
     #
-    #   require 'argvise'
-    #   { ruby: nil, r: "argvise", e: true, "puts Argvise::VERSION": nil }
-    #     .then(&Argvise.new_proc)
-    #     .build
-    #     .then{system *_1}
+    #     require 'argvise'
+    #     { ruby: nil, r: "argvise", e: true, "puts Argvise::VERSION": nil }
+    #       .then(&Argvise.new_proc)
+    #       .build
+    #       .then{system *_1}
     #
-    # > See also: [self.new]
+    # @see #initialize
+    # @return [::Proc] `.call(raw_cmd_hash)` => self
     def new_proc
       ->(raw_cmd_hash) do
         new(raw_cmd_hash)
@@ -111,15 +111,16 @@ class Argvise
     # ----
   end
 
-  # == Example
+  # @example
   #
   #   require 'argvise'
   #   cmd = { ruby: nil, r: "argvise", verbose: true, e: true, "puts Argvise::VERSION": nil }
   #   opts = Argvise::DEFAULT_OPTS
   #   Argvise.new(cmd, opts:).build.then{system *_1}
   #
-  # == opts
-  #   [Hash]: { bsd_style: Boolean, kebab_case_flags: Boolean }
+  # @param opts [Hash]: { bsd_style: Boolean, kebab_case_flags: Boolean }
+  #
+  # ## opts
   #
   # - When `bsd_style` is set to `false`, the builder operates in **GNU-style mode**,
   #   which typically uses hyphenated flags.
@@ -128,12 +129,11 @@ class Argvise
   #   will be automatically converted to hyphens (`-`).
   #   - For example, a flag like `--enable_jit` will be transformed into `--enable-jit`.
   #
-  # When the value of a flag key is `nil`, the `kebab_case_flags` option has no effect
+  # When the value of a flag key is `nil`, the `kebab_case_flags` option has no effect.
   # — i.e., the key will not be transformed.
   #
   # For example, the input `{"a_b-c": nil}` will result in `["a_b-c"]`,
   # and **not** be automatically transformed into `["a-b-c"]`.
-  #
   def initialize(
     raw_cmd_hash,
     opts: nil
@@ -145,16 +145,21 @@ class Argvise
     @kebab_case_flags = opts[:kebab_case_flags]
   end
 
+  # Default: true
+  # @return [self]
   def with_bsd_style(value = true) # rubocop:disable Style/OptionalBooleanParameter
     @bsd_style = value
     self
   end
 
+  # Default: true
+  # @return [self]
   def with_kebab_case_flags(value = true) # rubocop:disable Style/OptionalBooleanParameter
     @kebab_case_flags = value
     self
   end
 
+  # @return [Array<String>]
   def build
     # @raw_cmd_hash.each_pair.flat_map { |k, v| process_pair(k.to_s, v) }
     @raw_cmd_hash.each_with_object([]) do |(k, v), memo|
@@ -185,13 +190,13 @@ class Argvise
   #  - short key, e.g., {verbose: true} => "-verbose"
   #  - no long key
   #
-  # @kebab_case_flags==true:
+  # kebab_case_flags==true:
   #  - "_" => "-"
   #  - e.g., {enable_jit: true} =>
   #    - BSD-style: "-enable-jit"
   #    - GNU-style: "--enable-jit"
   #
-  # @kebab_case_flags==false:
+  # kebab_case_flags==false:
   #  - e.g., {enable_jit: true} =>
   #    - BSD-style: "-enable_jit"
   #    - GNU-style: "--enable_jit"
@@ -216,21 +221,21 @@ class Argvise
   # Generates the corresponding argument array based on the value type
   def generate_args(flag, value)
     case value
-    when true
-      [flag]
-    when Array
-      expand_array(flag, value)
-    when Hash
-      expand_hash(flag, value)
-    else
-      # e.g., {tag: 'uuu'} => ["--tag", "uuu"]
-      [flag, value.to_s]
+      when true
+        [flag]
+      when Array
+        expand_array(flag, value)
+      when Hash
+        expand_hash(flag, value)
+      else
+        # e.g., {tag: 'uuu'} => ["--tag", "uuu"]
+        [flag, value.to_s]
     end
   end
 
-  # {tag: ["v1", "v2"]}
-  #   => (flag: "--tag", array: ['v1', 'v2'])
-  #   =>  ["--tag", "v1", "--tag", "v2"]
+  #     {tag: ["v1", "v2"]}
+  #       => (flag: "--tag", array: ['v1', 'v2'])
+  #       =>  ["--tag", "v1", "--tag", "v2"]
   def expand_array(flag, array)
     # FP style: array.flat_map { |v| [flag, v.to_s] }
     array.each_with_object([]) do |v, memo|
@@ -241,9 +246,9 @@ class Argvise
 
   # Processes hash values (generates key=value format)
   #
-  # {label: { env: "test", key: "value" }}
-  #   => (flag: "--label", hash)
-  #   => ["--label", "env=test", "--label", "key=value"]
+  #     {label: { env: "test", key: "value" }}
+  #       => (flag: "--label", hash)
+  #       => ["--label", "env=test", "--label", "key=value"]
   def expand_hash(flag, hash)
     # hash.flat_map { |k, v| [flag, "#{k}=#{v}"] }
     hash.each_with_object([]) do |(k, v), memo|
@@ -253,30 +258,90 @@ class Argvise
   end
 end
 
-class ::Hash # rubocop:disable Style/Documentation
-  # Converts a hash into command-line arguments
+class Argvise
+  # The foundation of {HashRefin} and {HashMixin}
+  module HashExt
+    # Converts a hash map into GNU-style command-line arguments.
+    #
+    # @param opts [Hash, nil] See also `Argvise.new`
+    #
+    # @see Argvise#initialize
+    # @see to_argv_bsd
+    #
+    # @example Basic usage
+    #
+    #     require 'argvise'
+    #     using Argvise::HashRefin
+    #
+    #     { v: true, path: '/path/to/dir' }.to_argv
+    #     #=> ["-v", "--path", "/path/to/dir"]
+    #
+    #
+    # @example raw_cmd_hash.to_argv is equivalent to:
+    #
+    #     raw_cmd_hash
+    #       .then(&Argvise.new_proc)
+    #       .with_bsd_style(false)
+    #       .with_kebab_case_flags(true)
+    #       .build
+    #
+    # @return [Array<String>]
+    def to_argv(opts = nil)
+      Argvise.build(self, opts:)
+    end
+
+    # Converts a hash map into BSD-style command-line arguments.
+    #
+    # @param opts [Hash]
+    # @see to_argv
+    # @example
+    #
+    #     require 'argvise'
+    #     using Argvise::HashRefin
+    #
+    #     { path: '/path/to/dir' }.to_argv_bsd
+    #     #=> ["-path", "/path/to/dir"]
+    #
+    # @return [Array<String>]
+    def to_argv_bsd(options = {})
+      # if options is not Hash Type => {}
+      options = {} unless options.is_a?(::Hash)
+
+      opts = options.merge({ bsd_style: true })
+      Argvise.build(self, opts:)
+    end
+  end
+
+  # Converts a hash map into command-line arguments.
   #
-  # == Example：
+  # Monkey Patching:
   #
-  #   { v: true, path: '/path/to/dir' }.to_argv
-  #   #=> ["-v", "--path", "/path/to/dir"]
+  # - Hash#to_argv
+  # - Hash#to_argv_bsd
   #
-  # == params:
+  # @example
   #
-  # - opts: See also [Argvise::new]
+  #     require 'argvise'
   #
-  # == raw_cmd_hash.to_argv is equivalent to:
+  #     module A
+  #       module_function
+  #       include Argvise::HashMixin
   #
-  #  raw_cmd_hash
-  #    .then(&Argvise.new_proc)
-  #    .with_bsd_style(false)
-  #    .with_kebab_case_flags(true)
-  #    .build
+  #       def demo
+  #         puts({ path: '/path/to/dir' }.to_argv)
+  #         #=> ["--path", "/path/to/dir"]
   #
-  # ---
+  #         puts({ path: '/path/to/dir' }.to_argv_bsd)
+  #         #=> ["-path", "/path/to/dir"]
+  #       end
+  #     end
   #
-  # sig { params(opts: T.nilable(Hash)).returns(T::Array[String]) }
-  def to_argv(opts = nil)
-    Argvise.build(self, opts:)
+  #     A.demo
+  #     Hash.method_defined?(:to_argv) # => true
+  #     {}.respond_to?(:to_argv) #=> true
+  module HashMixin
+    def self.included(_host)
+      ::Hash.include(HashExt)
+    end
   end
 end

data/lib/argvise/refinement.rb

@@ -0,0 +1,41 @@
+# typed: true
+# frozen_string_literal: true
+
+# To maintain `mruby` compatibility, define `private_constant` and
+#  `refinements` in **refinement.rb** rather than in **core.rb**.
+
+class Argvise # rubocop:disable Style/ClassAndModuleChildren
+  # Probably no need to mark this as private.
+  # private_constant :HashExt
+
+  # Refinements:
+  #
+  # - Hash#to_argv
+  # - Hash#to_argv_bsd
+  #
+  # @example
+  #
+  #     require 'argvise'
+  #     class A
+  #       using Argvise::HashRefin
+  #       def self.demo
+  #         puts({ target: "wasm32-wasip2" }.to_argv)
+  #           # => ["--target", "wasm32-wasip2"]
+  #
+  #         puts({ target: "wasm32-wasip2" }.to_argv_bsd)
+  #           # => ["-target", "wasm32-wasip2"]
+  #
+  #         puts({}.respond_to?(:to_argv)) #=> true
+  #       end
+  #     end
+  #
+  #     A.demo
+  #     Hash.method_defined?(:to_argv) # => false
+  #     {}.respond_to?(:to_argv) #=> false
+  #
+  module HashRefin
+    refine ::Hash do
+      import_methods HashExt
+    end
+  end
+end

data/lib/argvise/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 class Argvise
-  VERSION = '0.0.8'
+  VERSION = '0.0.10'
 end

data/lib/argvise.rb

@@ -3,3 +3,4 @@
 
 require_relative 'argvise/version'
 require_relative 'argvise/core'
+require_relative 'argvise/refinement'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: argvise
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.10
 platform: ruby
 authors:
 - 2moe
@@ -11,26 +11,24 @@ date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Provides flexible command-line argument generation with support for complex
   data structures
-email:
-- m@tmoe.me
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".rubocop.yml"
+- ".yardopts"
 - License
-- bin/build.rb
-- bin/console.rb
 - docs/Readme.md
 - lib/argvise.rb
 - lib/argvise/core.rb
+- lib/argvise/refinement.rb
 - lib/argvise/version.rb
-- rbi/lib/argvise.rbi
 homepage: https://github.com/2moe/argvise-gem
 licenses:
 - Apache-2.0
 metadata:
   homepage_uri: https://github.com/2moe/argvise-gem
+  documentation_uri: https://2moe.github.io/argvise-gem/
 rdoc_options: []
 require_paths:
 - lib

data/bin/build.rb

@@ -1,19 +0,0 @@
-#!/usr/bin/env ruby
-# typed: ignore
-# frozen_string_literal: true
-
-require 'pathname'
-
-Pathname(__dir__ || File.dirname(__FILE__))
-  .parent
-  .then { Dir.chdir(it) }
-
-proj = 'argvise'
-
-system <<~CMD
-  gem uninstall #{proj}
-  gem build #{proj}
-  gem install #{proj}
-CMD
-
-# gem push argvise-*.gem

data/bin/console.rb

@@ -1,66 +0,0 @@
-#!/usr/bin/env ruby
-# typed: ignore
-# frozen_string_literal: true
-
-# lib_path = File.expand_path('../lib', __dir__)
-# exec "irb -I #{lib_path} -r argvise"
-
-# require "bundler/setup"
-# require "argvise"
-require 'irb'
-require_relative '../lib/argvise'
-
-puts "Argvise: #{Argvise::VERSION}"
-
-def puts_division_line
-  puts
-  puts '-' * 80
-end
-
-raw_cmd = {
-  compiler: nil,
-  build: nil,
-  pack_type: 'tar+zstd',
-  push: true,
-  v: true,
-  f: 'p2',
-  tag: ['v0.0.1', 'beta'],
-  platform: 'wasi/wasm',
-  label: {
-    maintainer: 'user',
-    description: 'Demo'
-  },
-  "/path/to/dir": nil
-}
-
-puts 'GNU-style + kebab_case_flags(false)'
-raw_cmd
-  .then(&Argvise.new_proc)
-  .with_bsd_style(false)
-  .with_kebab_case_flags(false)
-  .build
-  .display
-
-puts_division_line
-# -----------
-
-puts 'GNU-style + kebab_case_flags(true)'
-raw_cmd
-  .to_argv
-  .display
-
-puts_division_line
-# -----------
-
-puts 'BSD-style + kebab_case_flags(true)'
-raw_cmd
-  .then(&Argvise.new_proc)
-  .with_bsd_style
-  .with_kebab_case_flags
-  .build
-  .display
-
-puts_division_line
-# -----------
-
-IRB.start

data/rbi/lib/argvise.rbi

@@ -1,37 +0,0 @@
-# rubocop:disable Style/Documentation, Lint/MissingCopEnableDirective
-# typed: true
-# frozen_string_literal: true
-
-class Argvise
-  class << self
-    sig do
-      params(
-        raw_cmd_hash: Hash,
-        opts: T.nilable(T::Hash[Symbol, T::Boolean])
-      ).returns(T::Array[String])
-    end
-    def build(raw_cmd_hash, opts: nil); end
-  end
-
-  sig do
-    params(
-      raw_cmd_hash: Hash,
-      opts: T.nilable(T::Hash[Symbol, T::Boolean])
-    ).void
-  end
-  def initialize(raw_cmd_hash, opts: nil); end
-
-  sig { params(value: T::Boolean).returns(T.self_type) }
-  def with_bsd_style(value = true); end # rubocop:disable Style/OptionalBooleanParameter
-
-  sig { params(value: T::Boolean).returns(T.self_type) }
-  def with_kebab_case_flags(value = true); end # rubocop:disable Style/OptionalBooleanParameter
-
-  sig { returns(T::Array[String]) }
-  def build; end
-end
-
-class ::Hash
-  sig { params(opts: T.nilable(Hash)).returns(T::Array[String]) }
-  def to_argv(opts = nil); end
-end