Module: CLI::UI::Widgets

Extended by:
T::Sig
Defined in:
lib/cli/ui/widgets.rb,
lib/cli/ui/widgets/base.rb,
lib/cli/ui/widgets/status.rb

Overview

Widgets are formatter objects with more custom implementations than the other features, which all center around formatting text with colours, etc.

If you want to extend CLI::UI with your own widgets, you may want to do something like this:

require('cli/ui')
class MyWidget < CLI::UI::Widgets::Base
  # ...
end
CLI::UI::Widgets.register('my-widget') { MyWidget }
puts(CLI::UI.fmt("{{@widget/my-widget:args}}"))

Defined Under Namespace

Classes: Base, InvalidWidgetArguments, InvalidWidgetHandle, Status

Constant Summary collapse

MAP = 
{}

Class Method Summary collapse

Methods included from T::Sig

sig

Class Method Details

.available ⇒ Object 


53
54
55
 
# File 'lib/cli/ui/widgets.rb', line 53

def self.available
  MAP.keys
end

.lookup(handle) ⇒ Object 


44
45
46
47
48
 
# File 'lib/cli/ui/widgets.rb', line 44

def self.lookup(handle)
  MAP.fetch(handle).call
rescue KeyError, NameError
  raise(InvalidWidgetHandle, handle)
end

.register(name, &cb) ⇒ Object 


28
29
30
 
# File 'lib/cli/ui/widgets.rb', line 28

def self.register(name, &cb)
  MAP[name] = cb
end