inspec 1.0.0 → 1.1.0

data/docs/resources/os.md.erb

@@ -6,7 +6,7 @@ title: About the os Resource
 
 Use the `os` InSpec audit resource to test the platform on which the system is running.
 
-# Syntax
+## Syntax
 
 An `os` resource block declares the platform to be tested. The platform may specified via matcher or control block name. For example, using a matcher:
 
@@ -22,31 +22,31 @@ or using the block name:
 
 * `'platform_name'` (a string) or `:family_name` (a symbol) is one of `aix`, `bsd`, `darwin`, `debian`, `hpux`, `linux`, `redhat`, `solaris`, `suse`,  `unix`, or `windows`
 
-# Matchers
+## Matchers
 
 This InSpec audit resource has the following matchers:
 
-## be
+### be
 
 <%= partial "/shared/matcher_be" %>
 
-## cmp
+### cmp
 
 <%= partial "/shared/matcher_cmp" %>
 
-## eq
+### eq
 
 <%= partial "/shared/matcher_eq" %>
 
-## include
+### include
 
 <%= partial "/shared/matcher_include" %>
 
-## match
+### match
 
 <%= partial "/shared/matcher_match" %>
 
-# os.family? Helpers
+## os.family? Helpers
 
 The `os` audit resource includes a collection of helpers that enable more granular testing of platforms, platform names, architectures, and releases. Use any of the following platform-specific helpers to test for specific platforms:
 
@@ -94,7 +94,7 @@ Use the following helpers to test for operating system names, releases, and arch
        it { should eq 'foo' }
     end
 
-# os[:family] Symbols
+## os[:family] Symbols
 
 Use `os[:family]` to enable more granular testing of platforms, platform names, architectures, and releases. Use any of the following platform-specific symbols to test for specific platforms:
 
@@ -131,23 +131,23 @@ For example, both of the following tests should have the same result:
       end
     end
 
-# Examples
+## Examples
 
 The following examples show how to use this InSpec audit resource.
 
-## Test for RedHat
+### Test for RedHat
 
     describe os[:family] do
       it { should eq 'redhat' }
     end
 
-## Test for Ubuntu
+### Test for Ubuntu
 
     describe os[:family] do
       it { should eq 'debian' }
     end
 
-## Test for Microsoft Windows
+### Test for Microsoft Windows
 
     describe os[:family] do
       it { should eq 'windows' }

data/docs/resources/os_env.md.erb

@@ -6,7 +6,7 @@ title: About the os_env Resource
 
 Use the `os_env` InSpec audit resource to test the environment variables for the platform on which the system is running.
 
-# Syntax
+## Syntax
 
 A `os_env` resource block declares an environment variable, and then declares its value:
 
@@ -20,37 +20,37 @@ where
 * `matcher` is a valid matcher for this resource
 
 
-# Matchers
+## Matchers
 
 This InSpec audit resource has the following matchers:
 
-## be
+### be
 
 <%= partial "/shared/matcher_be" %>
 
-## cmp
+### cmp
 
 <%= partial "/shared/matcher_cmp" %>
 
-## content
+### content
 
 The `content` matcher return the value of the environment variable:
 
     its('content') { should eq '/usr/local/bin:/usr/local/sbin:/usr/sbin:/usr/bin:/sbin' }
 
-## eq
+### eq
 
 <%= partial "/shared/matcher_eq" %>
 
-## include
+### include
 
 <%= partial "/shared/matcher_include" %>
 
-## match
+### match
 
 <%= partial "/shared/matcher_match" %>
 
-## split
+### split
 
 The `split` splits the content with the `:` deliminator:
 
@@ -64,18 +64,18 @@ Use `-1` to test for cases where there is a trailing colon (`:`), such as `dir1:
 
     its('split') { should include ('-1') }
 
-# Examples
+## Examples
 
 The following examples show how to use this InSpec audit resource.
 
-## Test the PATH environment variable
+### Test the PATH environment variable
 
     describe os_env('PATH') do
       its('split') { should_not include('') }
       its('split') { should_not include('.') }
     end
 
-## Test Habitat environment variables
+### Test Habitat environment variables
 
 Habitat uses the `os_env` resource to test environment variables. The environment variables are first defined in a whitespace array, after which each environment variable is tested:
 

data/docs/resources/package.md.erb

@@ -7,7 +7,7 @@ title: About the package Resource
 Use the `package` InSpec audit resource to test if the named package and/or package version is installed on the system.
 
 
-# Syntax
+## Syntax
 
 A `package` resource block declares a package and (optionally) a package version:
 
@@ -20,60 +20,60 @@ where
 * `('name')` must specify the name of a package, such as `'nginx'`
 * `be_installed` is a valid matcher for this resource
 
-# Matchers
+## Matchers
 
 This InSpec audit resource has the following matchers:
 
-## be
+### be
 
 <%= partial "/shared/matcher_be" %>
 
-## be_installed
+### be_installed
 
 The `be_installed` matcher tests if the named package is installed on the system:
 
     it { should be_installed }
 
-## cmp
+### cmp
 
 <%= partial "/shared/matcher_cmp" %>
 
-## eq
+### eq
 
 <%= partial "/shared/matcher_eq" %>
 
-## include
+### include
 
 <%= partial "/shared/matcher_include" %>
 
-## match
+### match
 
 <%= partial "/shared/matcher_match" %>
 
-## version
+### version
 
 The `version` matcher tests if the named package version is on the system:
 
     its('version') { should eq '1.2.3' }
 
-# Examples
+## Examples
 
 The following examples show how to use this InSpec audit resource.
 
-## Test if nginx version 1.9.5 is installed
+### Test if nginx version 1.9.5 is installed
 
     describe package('nginx') do
       it { should be_installed }
       its('version') { should eq 1.9.5 }
     end
 
-## Test that a package is not installed
+### Test that a package is not installed
 
     describe package('some_package') do
       it { should_not be_installed }
     end
 
-## Test if telnet is installed
+### Test if telnet is installed
 
     describe package('telnetd') do
       it { should_not be_installed }
@@ -83,7 +83,7 @@ The following examples show how to use this InSpec audit resource.
       its('telnet') { should eq nil }
     end
 
-## Test if ClamAV (an antivirus engine) is installed and running
+### Test if ClamAV (an antivirus engine) is installed and running
 
     describe package('clamav') do
       it { should be_installed }
@@ -96,7 +96,7 @@ The following examples show how to use this InSpec audit resource.
       it { should_not be_running }
     end
 
-## Verify if Memcached is installed, enabled, and running
+### Verify if Memcached is installed, enabled, and running
 
 Memcached is an in-memory key-value store that helps improve the performance of database-driven websites and can be installed, maintained, and tested using the `memcached` cookbook (maintained by Chef). The following example is from the `memcached` cookbook and shows how to use a combination of the `package`, `service`, and `port` InSpec audit resources to test if Memcached is installed, enabled, and running:
 

data/docs/resources/parse_config.md.erb

@@ -6,7 +6,7 @@ title: About the parse_config Resource
 
 Use the `parse_config` InSpec audit resource to test arbitrary configuration files.
 
-# Syntax
+## Syntax
 
 A `parse_config` resource block declares the location of the configuration setting to be tested, and then what value is to be tested. Because this resource relies on arbitrary configuration files, the test itself is often arbitrary and relies on custom Ruby code:
 
@@ -35,11 +35,11 @@ where each test
 * May run a command to `stdout`, and then run the test against that output
 * May use options to define how configuration data is to be parsed
 
-# Matchers
+## Matchers
 
 This InSpec audit resource has the following matchers:
 
-## assignment_re
+### assignment_re
 
 Use `assignment_re` to test a key value using a regular expression:
 
@@ -49,29 +49,29 @@ may be tested using the following regular expression, which determines assignmen
 
     assignment_re: /^\s*([^=]*?)\s*=\s*(.*?)\s*$/
 
-## be
+### be
 
 <%= partial "/shared/matcher_be" %>
 
-## cmp
+### cmp
 
 <%= partial "/shared/matcher_cmp" %>
 
-## comment_char
+### comment_char
 
 Use `comment_char` to test for comments in a configuration file:
 
     comment_char: '#'
 
-## eq
+### eq
 
 <%= partial "/shared/matcher_eq" %>
 
-## include
+### include
 
 <%= partial "/shared/matcher_include" %>
 
-## key_vals
+### key_vals
 
 Use `key_vals` to test how many values a key contains:
 
@@ -81,11 +81,11 @@ contains three values. To test that value to ensure it only contains one, use:
 
     key_vals: 1
 
-## match
+### match
 
 <%= partial "/shared/matcher_match" %>
 
-## multiple_values
+### multiple_values
 
 Use `multiple_values` if the source file uses the same key multiple times. All values will be aggregated in an array:
 
@@ -105,7 +105,7 @@ To use plain key value mapping, use `multiple_values: false`:
     params['key'] = 'b'
     params['key2'] = 'c'
 
-## standalone_comments
+### standalone_comments
 
 Use `standalone_comments` to parse comments as a line, otherwise inline comments are allowed:
 
@@ -117,6 +117,6 @@ Use `standalone_comments: false`, to parse the following:
     'key = value # comment'
     params['key'] = 'value'
 
-# Examples
+## Examples
 
 None.

data/docs/resources/parse_config_file.md.erb

@@ -6,7 +6,7 @@ title: About the parse_config_file Resource
 
 Use the `parse_config_file` InSpec audit resource to test arbitrary configuration files. It works in the same way as `parse_config`. Instead of using a command output, this resource works with files.
 
-# Syntax
+## Syntax
 
 A `parse_config_file` InSpec audit resource block declares the location of the configuration file to be tested, and then which settings in that file are to be tested.
 
@@ -32,7 +32,7 @@ where each test
 * May run a command to `stdout`, and then run the test against that output
 * May use options to define how configuration data is to be parsed
 
-# Options
+## Options
 
 This resource supports the following options for parsing configuration data. Use them in an `options` block stated outside of (and immediately before) the actual test:
 
@@ -44,11 +44,11 @@ This resource supports the following options for parsing configuration data. Use
       its('setting') { should eq 1 }
     end
 
-# Matchers
+## Matchers
 
 This InSpec audit resource has the following matchers:
 
-## assignment_re
+### assignment_re
 
 Use `assignment_re` to test a key value using a regular expression:
 
@@ -58,29 +58,29 @@ may be tested using the following regular expression, which determines assignmen
 
     assignment_re: /^\s*([^=]*?)\s*=\s*(.*?)\s*$/
 
-## be
+### be
 
 <%= partial "/shared/matcher_be" %>
 
-## cmp
+### cmp
 
 <%= partial "/shared/matcher_cmp" %>
 
-## comment_char
+### comment_char
 
 Use `comment_char` to test for comments in a configuration file:
 
     comment_char: '#'
 
-## eq
+### eq
 
 <%= partial "/shared/matcher_eq" %>
 
-## include
+### include
 
 <%= partial "/shared/matcher_include" %>
 
-## key_vals
+### key_vals
 
 Use `key_vals` to test how many values a key contains:
 
@@ -90,11 +90,11 @@ contains three values. To test that value to ensure it only contains one, use:
 
     key_vals: 1
 
-## match
+### match
 
 <%= partial "/shared/matcher_match" %>
 
-## multiple_values
+### multiple_values
 
 Use `multiple_values` if the source file uses the same key multiple times. All values will be aggregated in an array:
 
@@ -114,7 +114,7 @@ To use plain key value mapping, use `multiple_values: false`:
     params['key'] = 'b'
     params['key2'] = 'c'
 
-## standalone_comments
+### standalone_comments
 
 Use `standalone_comments` to parse comments as a line, otherwise inline comments are allowed:
 
@@ -126,18 +126,24 @@ Use `standalone_comments: false`, to parse the following:
     'key = value # comment'
     params['key'] = 'value'
 
-# Examples
+## Examples
 
 The following examples show how to use this InSpec audit resource.
 
-## Test a configuration setting
+### Test a configuration setting
 
     describe parse_config_file('/path/to/file.conf') do
      its('PARAM_X') { should eq 'Y' }
     end
 
-## Use options, and then test a configuration setting
+### Use options, and then test a configuration setting
 
     describe parse_config_file('/path/to/file.conf', { multiple_values: true }) do
      its('PARAM_X') { should include 'Y' }
     end
+
+## Test a file with an ini-like structure (such as a yum.conf)
+
+    describe parse_config_file('/path/to/yum.conf') do
+     its('main') { should include('gpgcheck' => '1') }
+    end