Parent

Object

Class/Module Index [+]

Quicksearch

ParseConfig

Note: A group is a set of parameters defined for a subpart of a config file

Constants

Version

Attributes

config_file[RW]
groups[RW]
params[RW]

Public Class Methods

new(config_file=nil) click to toggle source

Initialize the class with the path to the 'config_file' The class objects are dynamically generated by the name of the 'param' in the config file. Therefore, if the config file is 'param = value' then the itializer will eval "@param = value"

# File lib/parseconfig.rb, line 32
def initialize(config_file=nil)
  @config_file = config_file
  @params = {}
  @groups = []

  if(self.config_file)
    self.validate_config()
    self.import_config()
  end
end

Public Instance Methods

add(param_name, value) click to toggle source

This method adds an element to the config object (not the config file) By adding a Hash, you create a new group

# File lib/parseconfig.rb, line 133
def add(param_name, value)
  if value.class == Hash
    if self.params.has_key?(param_name)
      if self.params[param_name].class == Hash
        self.params[param_name].merge!(value)
      elsif self.params.has_key?(param_name)
        if self.params[param_name].class != value.class
          raise ArgumentError, "#{param_name} already exists, and is of different type!"
        end
      end
    else
      self.params[param_name] = value
    end
    if ! self.groups.include?(param_name)
      self.groups.push(param_name)
    end
  else
    self.params[param_name] = value
  end
end
add_to_group(group, param_name, value) click to toggle source

Add parameters to a group. Note that parameters with the same name could be placed in different groups

# File lib/parseconfig.rb, line 156
def add_to_group(group, param_name, value)
  if ! self.groups.include?(group)
    self.add(group, {})
  end
  self.params[group][param_name] = value
end
get_groups() click to toggle source

List available sub-groups of the config.

# File lib/parseconfig.rb, line 106
def get_groups()
  return self.groups
end
get_params() click to toggle source

This method returns all parameters/groups defined in a config file.

# File lib/parseconfig.rb, line 101
def get_params()
  return self.params.keys
end
get_value(param) click to toggle source

This method will provide the value held by the object "@param" where "@param" is actually the name of the param in the config file.

DEPRECATED - will be removed in future versions

# File lib/parseconfig.rb, line 96
def get_value(param)
  return self.params[param]
end
import_config() click to toggle source

Import data from the config to our config object.

# File lib/parseconfig.rb, line 53
def import_config()
  # The config is top down.. anything after a [group] gets added as part
  # of that group until a new [group] is found.  
  group = nil
  open(self.config_file).each do |line| 
    line.strip!
    unless (/^\#/.match(line))
      if(/\s*=\s*/.match(line))
        param, value = line.split(/\s*=\s*/, 2)  
        var_name = "#{param}".chomp.strip
        value = value.chomp.strip
        new_value = ''
        if (value)
          if value =~ /^['"](.*)['"]$/
            new_value = $1
          else
            new_value = value
          end
        else
          new_value = ''
        end 

        if group
          self.add_to_group(group, var_name, new_value)
        else
          self.add(var_name, new_value)
        end
        
      elsif(/^\[(.+)\]$/.match(line).to_a != [])
        group = /^\[(.+)\]$/.match(line).to_a[1]
        self.add(group, {})
        
      end
    end
  end   
end
nil_value(param) click to toggle source

This method will set the value of '@param' to nil (not in the config file, only in the app).

DEPRECATED - will be removed in future versions.

# File lib/parseconfig.rb, line 126
def nil_value(param)
  #self.instance_variable_set("@#{param}", nil)
  raise RuntimeError, "nil_value() is deprecated as of 0.5.1"
end
override_value(param, value) click to toggle source

This method is simple. Should you need to override a value dynamically, use override_value(param, value) where 'param' is the name of the paramater in the config file.

DEPRECATED - will be removed in future versions.

# File lib/parseconfig.rb, line 116
def override_value(param, value)
  #self.instance_variable_set("@#{param}", value)
  raise RuntimeError, "override_value() is deprecated as of 0.5.1"
end
validate_config() click to toggle source

Validate the config file, and contents

# File lib/parseconfig.rb, line 44
def validate_config()  
  if !File.readable?(self.config_file)
    raise Errno::EACCES, "#{self.config_file} is not readable" 
  end
  
  # FIX ME: need to validate contents/structure?
end
write(output_stream=STDOUT) click to toggle source

Writes out the config file to output_stream

# File lib/parseconfig.rb, line 164
def write(output_stream=STDOUT)
  self.params.each do |name,value| 
    if value.class.to_s != 'Hash'
      if value.scan(/\w+/).length > 1
        output_stream.puts "#{name} = \"#{value}\""
      else
        output_stream.puts "#{name} = #{value}"
      end
    end
  end
  output_stream.puts "\n"
  
  self.groups.each do |group|
    output_stream.puts "[#{group}]"
    self.params[group].each do |param, value| 
      if value.scan(/\w+/).length > 1
        output_stream.puts "#{param} = \"#{value}\""
      else
        output_stream.puts "#{param} = #{value}"
      end
    end
    output_stream.puts "\n"
  end
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.