# class Puppet::Rails::Resource

### Public Class Methods

rails_resource_initial_args(resource) click to toggle source

Determine the basic details on the resource.

    # File lib/puppet/rails/resource.rb, line 28
    def self.rails_resource_initial_args(resource)
      result = [:type, :title, :line].inject({}) do |hash, param|
        # 'type' isn't a valid column name, so we have to use another name.
        to = (param == :type) ? :restype : param
        if value = resource.send(param)
          hash[to] = value
        end
        hash
      end

      # We always want a value here, regardless of what the resource has,
      # so we break it out separately.
      result[:exported] = resource.exported || false

      result
    end

tags() click to toggle source

    # File lib/puppet/rails/resource.rb, line 23
    def self.tags
      @tags
    end

### Public Instance Methods

[](param) click to toggle source
Calls superclass method

    # File lib/puppet/rails/resource.rb, line 86
    def [](param)
      super || parameter(param)
    end

add_param_to_list(param) click to toggle source

    # File lib/puppet/rails/resource.rb, line 70
    def add_param_to_list(param)
      params_list << param
    end

add_resource_tag(tag) click to toggle source

    # File lib/puppet/rails/resource.rb, line 45
    def add_resource_tag(tag)
      pt = Puppet::Rails::PuppetTag.accumulate_by_name(tag)
      resource_tags.build(:puppet_tag => pt)
    end

add_tag_to_list(tag) click to toggle source

    # File lib/puppet/rails/resource.rb, line 82
    def add_tag_to_list(tag)
      tags_list << tag
    end

file() click to toggle source

    # File lib/puppet/rails/resource.rb, line 50
    def file
      (f = self.source_file) ? f.filename : nil
    end

file=(file) click to toggle source

    # File lib/puppet/rails/resource.rb, line 54
    def file=(file)
      self.source_file = Puppet::Rails::SourceFile.find_or_create_by_filename(file)
    end

merge_attributes(resource) click to toggle source

    # File lib/puppet/rails/resource.rb, line 98
    def merge_attributes(resource)
      args = self.class.rails_resource_initial_args(resource)
      args.each do |param, value|
        self[param] = value unless resource[param] == value
      end

      # Handle file specially
      self.file = resource.file if (resource.file and  (!resource.file or self.file != resource.file))
    end

merge_parameters(resource) click to toggle source

    # File lib/puppet/rails/resource.rb, line 108
    def merge_parameters(resource)
      catalog_params = {}
      resource.each do |param, value|
        catalog_params[param.to_s] = value
      end

      db_params = {}

      deletions = []
      params_list.each do |value|
        # First remove any parameters our catalog resource doesn't have at all.
        deletions << value['id'] and next unless catalog_params.include?(value['name'])

        # Now store them for later testing.
        db_params[value['name']] ||= []
        db_params[value['name']] << value
      end

      # Now get rid of any parameters whose value list is different.
      # This might be extra work in cases where an array has added or lost
      # a single value, but in the most common case (a single value has changed)
      # this makes sense.
      db_params.each do |name, value_hashes|
        values = value_hashes.collect { |v| v['value'] }

        value_hashes.each { |v| deletions << v['id'] } unless value_compare(catalog_params[name], values)
      end

      # Perform our deletions.
      Puppet::Rails::ParamValue.delete(deletions) unless deletions.empty?

      # Lastly, add any new parameters.
      catalog_params.each do |name, value|
        next if db_params.include?(name) && ! db_params[name].find{ |val| deletions.include?( val["id"] ) }
        values = value.is_a?(Array) ? value : [value]

        values.each do |v|
          param_values.build(:value => serialize_value(v), :line => resource.line, :param_name => Puppet::Rails::ParamName.accumulate_by_name(name))
        end
      end
    end

merge_parser_resource(resource) click to toggle source

Make sure this resource is equivalent to the provided Parser resource.

    # File lib/puppet/rails/resource.rb, line 91
    def merge_parser_resource(resource)
      accumulate_benchmark("Individual resource merger", :attributes) { merge_attributes(resource) }
      accumulate_benchmark("Individual resource merger", :parameters) { merge_parameters(resource) }
      accumulate_benchmark("Individual resource merger", :tags) { merge_tags(resource) }
      save
    end

merge_tags(resource) click to toggle source

Make sure the tag list is correct.

    # File lib/puppet/rails/resource.rb, line 151
    def merge_tags(resource)
      in_db = []
      deletions = []
      resource_tags = resource.tags
      tags_list.each do |tag|
        deletions << tag['id'] and next unless resource_tags.include?(tag['name'])
        in_db << tag['name']
      end
      Puppet::Rails::ResourceTag.delete(deletions) unless deletions.empty?

      (resource_tags - in_db).each do |tag|
        add_resource_tag(tag)
      end
    end

name() click to toggle source

    # File lib/puppet/rails/resource.rb, line 172
    def name
      ref
    end

parameter(param) click to toggle source

    # File lib/puppet/rails/resource.rb, line 176
    def parameter(param)
      if pn = param_names.find_by_name(param)
        return (pv = param_values.find(:first, :conditions => [ 'param_name_id = ?', pn])) ? pv.value : nil
      end
    end

params_list() click to toggle source

    # File lib/puppet/rails/resource.rb, line 62
    def params_list
      @params_list ||= []
    end

params_list=(params) click to toggle source

    # File lib/puppet/rails/resource.rb, line 66
    def params_list=(params)
      @params_list = params
    end

ref(dummy_argument=:work_arround_for_ruby_GC_bug) click to toggle source

    # File lib/puppet/rails/resource.rb, line 182
    def ref(dummy_argument=:work_arround_for_ruby_GC_bug)
      "#{self[:restype].split("::").collect { |s| s.capitalize }.join("::")}[#{self.title}]"
    end

tags_list() click to toggle source

    # File lib/puppet/rails/resource.rb, line 74
    def tags_list
      @tags_list ||= []
    end

tags_list=(tags) click to toggle source

    # File lib/puppet/rails/resource.rb, line 78
    def tags_list=(tags)
      @tags_list = tags
    end

title() click to toggle source

    # File lib/puppet/rails/resource.rb, line 58
    def title
      unserialize_value(self[:title])
    end

to_hash() click to toggle source

Returns a hash of parameter names and values, no ActiveRecord instances.

    # File lib/puppet/rails/resource.rb, line 187
    def to_hash
      Puppet::Rails::ParamValue.find_all_params_from_resource(self).inject({}) do |hash, value|
        hash[value['name']] ||= []
        hash[value['name']] << value.value
        hash
      end
    end

to_resource(scope) click to toggle source

Convert our object to a resource. Do not retain whether the object is exported, though, since that would cause it to get stripped from the configuration.

    # File lib/puppet/rails/resource.rb, line 198
    def to_resource(scope)
      hash = self.attributes
      hash["type"] = hash["restype"]
      hash.delete("restype")

      # FIXME At some point, we're going to want to retain this information
      # for logging and auditing.
      hash.delete("host_id")
      hash.delete("updated_at")
      hash.delete("source_file_id")
      hash.delete("created_at")
      hash.delete("id")
      hash.each do |p, v|
        hash.delete(p) if v.nil?
      end
      hash[:scope] = scope
      hash[:source] = scope.source
      hash[:parameters] = []
      names = []
      self.param_names.each do |pname|
        # We can get the same name multiple times because of how the
        # db layout works.
        next if names.include?(pname.name)
        names << pname.name
        hash[:parameters] << pname.to_resourceparam(self, scope.source)
      end
      obj = Puppet::Parser::Resource.new(hash.delete("type"), hash.delete("title"), hash)

      # Store the ID, so we can check if we're re-collecting the same resource.
      obj.collector_id = self.id

      obj
    end

value_compare(v,db_value) click to toggle source

    # File lib/puppet/rails/resource.rb, line 166
    def value_compare(v,db_value)
      v = [v] unless v.is_a?(Array)

      v == db_value
    end