class Samovar::Split

Represents a split point in the command-line arguments.

A ‘Split` parser divides the argument list at a marker (typically `–`), allowing you to separate arguments meant for your command from those passed to another tool.

Attributes

default [R]

The default value if no split is present.

@attribute [Object]

description [R]

A description of the split for help output.

@attribute [String]

key [R]

The name of the attribute to store the values after the split.

@attribute [Symbol]

marker [R]

The marker that indicates the split point.

@attribute [String]

required [R]

Whether the split is required.

@attribute [Boolean]

Public Class Methods

new (key, description, marker: "--", default: nil, required: false)

Source

# File vendor/bundle/ruby/3.4.0/gems/samovar-2.4.1/lib/samovar/split.rb, line 18
def initialize(key, description, marker: "--", default: nil, required: false)
        @key = key
        @description = description
        @marker = marker
        @default = default
        @required = required
end

Initialize a new split parser.

@parameter key [Symbol] The name of the attribute to store the values after the split. @parameter description [String] A description of the split for help output. @parameter marker [String] The marker that indicates the split point. @parameter default [Object] The default value if no split is present. @parameter required [Boolean] Whether the split is required.

Public Instance Methods

parse (input, parent = nil, default = nil)

Source

# File vendor/bundle/ruby/3.4.0/gems/samovar-2.4.1/lib/samovar/split.rb, line 79
def parse(input, parent = nil, default = nil)
        if offset = input.index(@marker)
                input.pop(input.size - offset).tap(&:shift)
        elsif default ||= @default
                return default
        elsif @required
                raise MissingValueError.new(parent, @key)
        end
end

Parse arguments after the split marker.

@parameter input [Array(String)] The command-line arguments. @parameter parent [Command | Nil] The parent command. @parameter default [Object | Nil] An override for the default value. @returns [Array(String) | Object | Nil] The arguments after the split, or the default if no split.

to_a ()

Source

# File vendor/bundle/ruby/3.4.0/gems/samovar-2.4.1/lib/samovar/split.rb, line 61
def to_a
        usage = [to_s, @description]
        
        if @default
                usage << "(default: #{@default.inspect})"
        elsif @required
                usage << "(required)"
        end
        
        return usage
end

Generate an array representation for usage output.

@returns [Array] The usage array.

to_s ()

Source

# File vendor/bundle/ruby/3.4.0/gems/samovar-2.4.1/lib/samovar/split.rb, line 54
def to_s
        "#{@marker} <#{@key}...>"
end

Generate a string representation for usage output.

@returns [String] The usage string.