class Fluent::Config::Element

Attributes

arg[RW]
corresponding_proxies[RW]
elements[RW]
name[RW]
unused[RW]
unused_in[RW]
v1_config[RW]

Public Class Methods

new(name, arg, attrs, elements, unused = nil) click to toggle source
Calls superclass method
# File lib/fluent/config/element.rb, line 23
def initialize(name, arg, attrs, elements, unused = nil)
  @name = name
  @arg = arg
  @elements = elements
  super()
  attrs.each { |k, v|
    self[k] = v
  }
  @unused = unused || attrs.keys
  @v1_config = false
  @corresponding_proxies = [] # some plugins use flat parameters, e.g. in_http doesn't provide <format> section for parser.
  @unused_in = false # if this element is not used in plugins, correspoing plugin name and parent element name is set, e.g. [source, plugin class].
end
unescape_parameter(v) click to toggle source
# File lib/fluent/config/element.rb, line 147
def self.unescape_parameter(v)
  result = ''
  v.each_char { |c| result << LiteralParser.unescape_char(c) }
  result
end

Public Instance Methods

+(o) click to toggle source
# File lib/fluent/config/element.rb, line 60
def +(o)
  e = Element.new(@name.dup, @arg.dup, o.merge(self), @elements + o.elements, (@unused + o.unused).uniq)
  e.v1_config = @v1_config
  e
end
==(o) click to toggle source

This method assumes o is an Element object. Should return false for nil or other object

# File lib/fluent/config/element.rb, line 52
def ==(o)
  self.name == o.name && self.arg == o.arg &&
    self.keys.size == o.keys.size &&
    self.keys.reduce(true){|r, k| r && self[k] == o[k] } &&
    self.elements.size == o.elements.size &&
    [self.elements, o.elements].transpose.reduce(true){|r, e| r && e[0] == e[1] }
end
[](key) click to toggle source
Calls superclass method
# File lib/fluent/config/element.rb, line 84
def [](key)
  @unused_in = false # ditto
  @unused.delete(key)
  super
end
add_element(name, arg='') click to toggle source
# File lib/fluent/config/element.rb, line 39
def add_element(name, arg='')
  e = Element.new(name, arg, {}, [])
  e.v1_config = @v1_config
  @elements << e
  e
end
check_not_fetched(&block) click to toggle source
# File lib/fluent/config/element.rb, line 90
def check_not_fetched(&block)
  each_key { |key|
    if @unused.include?(key)
      block.call(key, self)
    end
  }
  @elements.each { |e|
    e.check_not_fetched(&block)
  }
end
each_element(*names, &block) click to toggle source
# File lib/fluent/config/element.rb, line 66
def each_element(*names, &block)
  if names.empty?
    @elements.each(&block)
  else
    @elements.each { |e|
      if names.include?(e.name)
        block.yield(e)
      end
    }
  end
end
has_key?(key) click to toggle source
Calls superclass method
# File lib/fluent/config/element.rb, line 78
def has_key?(key)
  @unused_in = false # some sections, e.g. <store> in copy, is not defined by config_section so clear unused flag for better warning message in chgeck_not_fetched.
  @unused.delete(key)
  super
end
inspect() click to toggle source
Calls superclass method
# File lib/fluent/config/element.rb, line 46
def inspect
  attrs = super
  "name:#{@name}, arg:#{@arg}, " + attrs + ", " + @elements.inspect
end
secret_param?(key) click to toggle source
# File lib/fluent/config/element.rb, line 133
def secret_param?(key)
  return false if @corresponding_proxies.empty?

  param_key = key.to_sym
  @corresponding_proxies.each { |proxy|
    block, opts = proxy.params[param_key]
    if opts && opts.has_key?(:secret)
      return opts[:secret]
    end
  }

  false
end
to_masked_element() click to toggle source
# File lib/fluent/config/element.rb, line 124
def to_masked_element
  new_elems = @elements.map { |e| e.to_masked_element }
  new_elem = Element.new(@name, @arg, {}, new_elems, @unused)
  each_pair { |k, v|
    new_elem[k] = secret_param?(k) ? 'xxxxxx' : v
  }
  new_elem
end
to_s(nest = 0) click to toggle source
# File lib/fluent/config/element.rb, line 101
def to_s(nest = 0)
  indent = "  " * nest
  nindent = "  " * (nest + 1)
  out = ""
  if @arg.empty?
    out << "#{indent}<#{@name}>\n"
  else
    out << "#{indent}<#{@name} #{@arg}>\n"
  end
  each_pair { |k, v|
    if secret_param?(k)
      out << "#{nindent}#{k} xxxxxx\n"
    else
      out << "#{nindent}#{k} #{v}\n"
    end
  }
  @elements.each { |e|
    out << e.to_s(nest + 1)
  }
  out << "#{indent}</#{@name}>\n"
  out
end