Spec-Zone.ru › Ruby 2.5

класс OptionParser::Switch

Родитель:
Объект

Класс отдельного переключателя. Не важен для пользователя.

Внутри Switch определены несколько классов, производных от Switch: NoArgument, RequiredArgument и т.д.

Атрибуты

arg[R]
block[R]
conv[R]
desc[R]
long[R]
pattern[R]
short[R]

Общедоступные методы класса

guess(arg) Показать исходный код
# File lib/optparse.rb, line 484
def self.guess(arg)
  case arg
  when ""
    t = self
  when /\A=?\[/
    t = Switch::OptionalArgument
  when /\A\s+\[/
    t = Switch::PlacedArgument
  else
    t = Switch::RequiredArgument
  end
  self >= t or incompatible_argument_styles(arg, t)
  t
end

Предполагает стиль аргумента из arg. Возвращает соответствующий класс OptionParser::Switch (OptionalArgument и т.д.).

incompatible_argument_styles(arg, t) Показать исходный код
# File lib/optparse.rb, line 499
def self.incompatible_argument_styles(arg, t)
  raise(ArgumentError, "#{arg}: incompatible argument styles\n  #{self}, #{t}",
        ParseError.filter_backtrace(caller(2)))
end
new(pattern = nil, conv = nil, short = nil, long = nil, arg = nil, desc = ([] if short or long), block = Proc.new) Показать исходный код
# File lib/optparse.rb, line 508
def initialize(pattern = nil, conv = nil,
               short = nil, long = nil, arg = nil,
               desc = ([] if short or long), block = Proc.new)
  raise if Array === pattern
  @pattern, @conv, @short, @long, @arg, @desc, @block =
    pattern, conv, short, long, arg, desc, block
end
pattern() Показать исходный код
# File lib/optparse.rb, line 504
def self.pattern
  NilClass
end

Общедоступные методы экземпляра

summarize(sdone = [], ldone = [], width = 1, max = width - 1, indent = "") { |indent| ... } Показать исходный код
# File lib/optparse.rb, line 567
def summarize(sdone = [], ldone = [], width = 1, max = width - 1, indent = "")
  sopts, lopts = [], [], nil
  @short.each {|s| sdone.fetch(s) {sopts << s}; sdone[s] = true} if @short
  @long.each {|s| ldone.fetch(s) {lopts << s}; ldone[s] = true} if @long
  return if sopts.empty? and lopts.empty? # completely hidden

  left = [sopts.join(', ')]
  right = desc.dup

  while s = lopts.shift
    l = left[-1].length + s.length
    l += arg.length if left.size == 1 && arg
    l < max or sopts.empty? or left << ''
    left[-1] << (left[-1].empty? ? ' ' * 4 : ', ') << s
  end

  if arg
    left[0] << (left[1] ? arg.sub(/\A(\[?)=/, '\1') + ',' : arg)
  end
  mlen = left.collect {|ss| ss.length}.max.to_i
  while mlen > width and l = left.shift
    mlen = left.collect {|ss| ss.length}.max.to_i if l.length == mlen
    if l.length < width and (r = right[0]) and !r.empty?
      l = l.to_s.ljust(width) + ' ' + r
      right.shift
    end
    yield(indent + l)
  end

  while begin l = left.shift; r = right.shift; l or r end
    l = l.to_s.ljust(width) + ' ' + r if r and !r.empty?
    yield(indent + l)
  end

  self
end

Создает текстовый свод. Каждая строка свода передаётся в блок (без новой строки).

sdone

Хэш, уже сгруппированные короткие стили опций.

ldone

Хэш, уже сгруппированные длинные стили опций.

width

Ширина левой части (часть с опциями). Другими словами, правая часть (часть с описанием) начинается после width столбцов.

max

Максимальная ширина левой части -> опции заполняются в max столбцах.

indent

Строка-префикс для отступа всех строк свода.

switch_name() Показать исходный код
# File lib/optparse.rb, line 619
def switch_name
  (long.first || short.first).sub(/\A-+(?:\[no-\])?/, '')
end

Основное имя переключателя.

Приватные методы экземпляра

conv_arg(arg, val = []) Показать исходный код
# File lib/optparse.rb, line 545
def conv_arg(arg, val = [])
  if conv
    val = conv.call(*val)
  else
    val = proc {|v| v}.call(*val)
  end
  return arg, block, val
end

Разбирает аргумент, преобразует и возвращает arg, block и результат преобразования. В случае полуошибки вызывается блок вместо повышения исключения.

parse_arg(arg) { |InvalidArgument, arg| ... } Показать исходный код
# File lib/optparse.rb, line 520
def parse_arg(arg)
  pattern or return nil, [arg]
  unless m = pattern.match(arg)
    yield(InvalidArgument, arg)
    return arg, []
  end
  if String === m
    m = [s = m]
  else
    m = m.to_a
    s = m[0]
    return nil, m unless String === s
  end
  raise InvalidArgument, arg unless arg.rindex(s, 0)
  return nil, m if s.length == arg.length
  yield(InvalidArgument, arg) # didn't match whole arg
  return arg[s.length..-1], m
end

Разбирает arg и возвращает остаток arg и сопоставленную часть аргумента.

Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API