Class: Puppet::Interface::ActionBuilder

Inherits:
Object
  • Object
show all
Defined in:
lib/puppet/interface/action_builder.rb

Overview

This class is used to build actions. When an action is defined with Puppet::Interface::ActionManager#action the block is evaluated within the context of a new instance of this class.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#actionPuppet::Interface::Action (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

The action under construction


10
11
12
# File 'lib/puppet/interface/action_builder.rb', line 10

def action
  @action
end

Class Method Details

.build(face, name, &block) ⇒ Puppet::Interface::Action

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Builds a new action.


15
16
17
18
# File 'lib/puppet/interface/action_builder.rb', line 15

def self.build(face, name, &block)
  raise "Action #{name.inspect} must specify a block" unless block
  new(face, name, &block).action
end

Instance Method Details

#default(value = true) ⇒ void

This method returns an undefined value.

Set this as the default action for the face.


111
112
113
# File 'lib/puppet/interface/action_builder.rb', line 111

def default(value = true)
  @action.default = !!value
end

#deprecatevoid

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

This method returns an undefined value.

Deprecates the action


24
25
26
# File 'lib/puppet/interface/action_builder.rb', line 24

def deprecate
  @action.deprecate
end

#display_global_options(*args) ⇒ Object Also known as: display_global_option

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


116
117
118
# File 'lib/puppet/interface/action_builder.rb', line 116

def display_global_options(*args)
  @action.add_display_global_options args
end

#option(*declaration, &block) ⇒ Object

Declare that this action can take a specific option, and provide the code to do so. One or more strings are given, in the style of OptionParser (see example). These strings are parsed to derive a name for the option. Any `-` characters within the option name (ie excluding the initial `-` or `–` for an option) will be translated to `_`.The first long option will be used as the name, and the rest are retained as aliases. The original form of the option is used when invoking the face, the translated form is used internally.

When the action is invoked the value of the option is available in a hash passed to the when_invoked block, using the option name in symbol form as the hash key.

The block to this method is used to set attributes for the option (see OptionBuilder).

Examples:

Say hi

action :say_hi do
  option "-u USER", "--user-name USER" do
    summary "Who to say hi to"
  end

  when_invoked do |options|
    "Hi, #{options[:user_name]}"
  end
end

102
103
104
105
# File 'lib/puppet/interface/action_builder.rb', line 102

def option(*declaration, &block)
  option = Puppet::Interface::OptionBuilder.build(@action, *declaration, &block)
  @action.add_option(option)
end

#render_as(value = nil) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Sets the default rendering format


123
124
125
126
127
128
129
130
131
132
133
134
135
136
# File 'lib/puppet/interface/action_builder.rb', line 123

def render_as(value = nil)
  if value.nil?
    #TRANSLATORS 'render_as' is a method name and should not be translated
    raise ArgumentError, _("You must give a rendering format to render_as")
  end

  formats = Puppet::Network::FormatHandler.formats
  unless formats.include? value
    raise ArgumentError, _("%{value} is not a valid rendering format: %{formats_list}") %
        { value: value.inspect, formats_list: formats.sort.join(", ")}
  end

  @action.render_as = value
end

#when_invoked({|options| ... }) ⇒ void #when_invoked({|arg1, arg2, options| ... }) ⇒ void

This method returns an undefined value.

Sets what the action does when it is invoked. This takes a block which will be called when the action is invoked. The action will accept arguments based on the arity of the block. It should always take at least one argument for options. Options will be the last argument.

Overloads:

  • #when_invoked({|options| ... }) ⇒ void

    An action with no arguments

  • #when_invoked({|arg1, arg2, options| ... }) ⇒ void

    An action with two arguments


45
46
47
# File 'lib/puppet/interface/action_builder.rb', line 45

def when_invoked(&block)
  @action.when_invoked = block
end

#when_rendering(type = nil, &block) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

TODO:

this needs more

Sets a block to be run at the rendering stage, for a specific rendering type (eg JSON, YAML, console), after the block for when_invoked gets run. This manipulates the value returned by the action. It makes it possible to work around limitations in the underlying object returned, and should be avoided in favor of returning a more capable object.


58
59
60
61
62
63
64
65
66
67
68
# File 'lib/puppet/interface/action_builder.rb', line 58

def when_rendering(type = nil, &block)
  if type.nil? then           # the default error message sucks --daniel 2011-04-18
    #TRANSLATORS 'when_rendering' is a method name and should not be translated
    raise ArgumentError, _('You must give a rendering format to when_rendering')
  end
  if block.nil? then
    #TRANSLATORS 'when_rendering' is a method name and should not be translated
    raise ArgumentError, _('You must give a block to when_rendering')
  end
  @action.set_rendering_method_for(type, block)
end