inspec/lib/resources/parse_config.rb
Lynn Frank 2857d07151 Fixes resource examples
The opening and closing mechanic varied between all the various
resources. This changes them all to use a HEREDOC with a tilde
to remove leading whitespace. This removes the need for the
special method to trim the `#print_example` method from shell.

Signed-off-by: Franklin Webber <franklin.webber@gmail.com>
2019-03-19 11:25:41 -05:00

112 lines
2.9 KiB
Ruby

# encoding: utf-8
# copyright: 2015, Vulcano Security GmbH
# Usage example:
#
# audit = command('/sbin/auditctl -l').stdout
# options = {
# assignment_regex: /^\s*([^:]*?)\s*:\s*(.*?)\s*$/,
# multiple_values: true
# }
# describe parse_config(audit, options ) do
require 'utils/file_reader'
module Inspec::Resources
class PConfig < Inspec.resource(1)
name 'parse_config'
supports platform: 'unix'
supports platform: 'windows'
desc 'Use the parse_config InSpec audit resource to test arbitrary configuration files.'
example <<~EXAMPLE
output = command('some-command').stdout
describe parse_config(output, { data_config_option: value } ) do
its('setting') { should eq 1 }
end
output2 = command('curl http://127.0.0.1/php_status').stdout
# php status is in format 'key : value', and we do not allow for multiple values
options2 = {
assignment_regex: /^\s*([^:]*?)\s*:\s*(.*?)\s*$/,
multiple_values: false
}
describe parse_config(output2, options2) do
its('pool') { should eq 'www'}
its('process manager') { should eq process_manager }
end
# getting specific key from the output above, convert it to integer and then compare
# make sure 'listen queue' is below 100
describe parse_config(output2, options2 ).params['listen queue'].to_i do
it { should be < 100 }
end
EXAMPLE
include FileReader
attr_reader :content
def initialize(content = nil, useropts = nil)
@opts = {}
@opts = useropts.dup unless useropts.nil?
@files_contents = {}
@content = content
read_params unless @content.nil?
end
def method_missing(name)
read_params[name.to_s]
end
def params(*opts)
opts.inject(read_params) do |res, nxt|
res.respond_to?(:key) ? res[nxt] : nil
end
end
def to_s
"Parse Config #{@conf_path}"
end
private
def parse_file(conf_path)
@conf_path = conf_path
@content = read_file(conf_path).to_s
read_params
end
def read_file(path)
@files_contents[path] ||= read_file_content(path)
end
def read_params
@params ||= if content.nil?
{}
else
SimpleConfig.new(content, @opts).params
end
end
end
class PConfigFile < PConfig
name 'parse_config_file'
desc 'Use the parse_config_file InSpec resource to test arbitrary configuration files. It works identically to parse_config. Instead of using a command output, this resource works with files.'
example <<~EXAMPLE
describe parse_config_file('/path/to/file') do
its('setting') { should eq 1 }
end
EXAMPLE
def initialize(path, opts = nil)
super(nil, opts)
parse_file(path)
end
def to_s
"Parse Config File #{@conf_path}"
end
end
end