inspec 0.16.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 243a577f37796094ac8a136876c11d14ded819c2
-  data.tar.gz: 7a95c3d207666f7d91c7ccb10316432d1ba70dd6
+  metadata.gz: 5487adad33ddb0d68d7115f3b5855862ac2269f4
+  data.tar.gz: 856ab3b28b9a5d5ffb3bbed9983095553be1c1e5
 SHA512:
-  metadata.gz: 4d66e309baed6ba892f9b5fc4c03f488afc7886dc67c88bcf4a9d97e32e2a5cdbbb4e475e792e3f6d4199ea034177fd8a3698063a0d8b4d36d60b626eecfa993
-  data.tar.gz: 03d6a852e3d9e3d629e1e1d44555973ea69f66d78d630ebd80bbdcddcff6035a96a03416a58c02fcc757cbc01f838ef36e6b44ef17a41692204d6120d17426e8
+  metadata.gz: 4ff5484ae1c3be74b1380f5521eb8bfb925c94fc0b8cf9bb68baaa9a6b998c6b54875d65b9b1b0c12fe68d7db16794c6b0a113d222d4c6a09c3ceb3536c78445
+  data.tar.gz: 65619588022d504d018a3f25e8cd05adf53305b641143b1175e3a78c8e7aae27212c2a29bd51b78bd36e16a7d42a09ae2520eb4e753672a8e70c5b32dbb8ca96

data/CHANGELOG.md

@@ -1,7 +1,20 @@
 # Change Log
 
-## [0.16.0](https://github.com/chef/inspec/tree/0.16.0) (2016-03-19)
-[Full Changelog](https://github.com/chef/inspec/compare/v0.15.0...0.16.0)
+## [0.16.1](https://github.com/chef/inspec/tree/0.16.1) (2016-03-22)
+[Full Changelog](https://github.com/chef/inspec/compare/v0.16.0...0.16.1)
+
+**Implemented enhancements:**
+
+- undefined method `addresses' for Port [\#555](https://github.com/chef/inspec/issues/555)
+- add `wmi` resource [\#560](https://github.com/chef/inspec/pull/560) ([chris-rock](https://github.com/chris-rock))
+- Add `vbscript` resource [\#559](https://github.com/chef/inspec/pull/559) ([chris-rock](https://github.com/chris-rock))
+
+**Merged pull requests:**
+
+- add support for addresses in port resource [\#558](https://github.com/chef/inspec/pull/558) ([chris-rock](https://github.com/chris-rock))
+
+## [v0.16.0](https://github.com/chef/inspec/tree/v0.16.0) (2016-03-19)
+[Full Changelog](https://github.com/chef/inspec/compare/v0.15.0...v0.16.0)
 
 **Implemented enhancements:**
 
@@ -17,6 +30,7 @@
 
 **Fixed bugs:**
 
+- Unable to Handle Spaced Windows File Paths [\#469](https://github.com/chef/inspec/issues/469)
 - fix inspec shell and continuously test it [\#556](https://github.com/chef/inspec/pull/556) ([arlimus](https://github.com/arlimus))
 - bugfix: prevent duplicate loading of library files [\#547](https://github.com/chef/inspec/pull/547) ([arlimus](https://github.com/arlimus))
 - fix detect + add output option to archive command [\#546](https://github.com/chef/inspec/pull/546) ([arlimus](https://github.com/arlimus))
@@ -30,6 +44,7 @@
 
 **Merged pull requests:**
 
+- 0.16.0 [\#557](https://github.com/chef/inspec/pull/557) ([arlimus](https://github.com/arlimus))
 - mock fetcher [\#550](https://github.com/chef/inspec/pull/550) ([arlimus](https://github.com/arlimus))
 - testing: add inspec exec tests with json formatter [\#549](https://github.com/chef/inspec/pull/549) ([arlimus](https://github.com/arlimus))
 - dont generate pretty json by default [\#548](https://github.com/chef/inspec/pull/548) ([arlimus](https://github.com/arlimus))

data/lib/inspec/resource.rb

@@ -96,8 +96,10 @@ require 'resources/service'
 require 'resources/shadow'
 require 'resources/ssh_conf'
 require 'resources/user'
+require 'resources/vbscript'
 require 'resources/windows_feature'
 require 'resources/xinetd'
+require 'resources/wmi'
 require 'resources/yum'
 
 # file formats, depend on json implementation

data/lib/inspec/version.rb

@@ -3,5 +3,5 @@
 # author: Christoph Hartmann
 
 module Inspec
-  VERSION = '0.16.0'.freeze
+  VERSION = '0.16.1'.freeze
 end

data/lib/resources/json.rb

@@ -2,6 +2,8 @@
 # author: Christoph Hartmann
 # author: Dominik Richter
 
+require 'utils/object_traversal'
+
 module Inspec::Resources
   class JsonConfig < Inspec.resource(1)
     name 'json'
@@ -12,6 +14,8 @@ module Inspec::Resources
       end
     "
 
+    include ObjectTraverser
+
     # make params readable
     attr_reader :params
 
@@ -59,26 +63,5 @@ module Inspec::Resources
     def to_s
       "Json #{@path}"
     end
-
-    private
-
-    def extract_value(keys, value)
-      key = keys.shift
-      return nil if key.nil?
-
-      # if value is an array, iterate over each child
-      if value.is_a?(Array)
-        value = value.map { |i|
-          extract_value([key], i)
-        }
-      else
-        value = value[key.to_s].nil? ? nil : value[key.to_s]
-      end
-
-      # if there are no more keys, just return the value
-      return value if keys.first.nil?
-      # if there are more keys, extract more
-      extract_value(keys.clone, value)
-    end
   end
 end

data/lib/resources/port.rb

@@ -66,6 +66,11 @@ module Inspec::Resources
       res.size > 0 ? res : nil
     end
 
+    def addresses
+      res = info.map { |x| x[:address] }.uniq.compact
+      res.size > 0 ? res : nil
+    end
+
     def pids
       res = info.map { |x| x[:pid] }.uniq.compact
       res.size > 0 ? res : nil

data/lib/resources/vbscript.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+# author: Christoph Hartmann
+# author: Dominik Richter
+
+module Inspec::Resources
+  # This resource allows users to run vbscript on windows machines. We decided
+  # not to use scriptcontrol, due to the fact that it works on 32 bit systems only:
+  # $script = new-object -comobject MSScriptControl.ScriptControl
+  # $script.language = "vbscript"
+  # $script.ExecuteStatement($Cmd)
+  #
+  # For that reason, we call csript.exe directy with the script. Vbscript is
+  # embedded in Powershell to ease the file transfer and reuse powershell
+  # encodedCommand since train does not allow file upload yet.
+  #
+  # We run cscript with /nologo option to get the expected output only with the
+  # version information.
+  #
+  # Since Windows does not delete tmp files automatically, we remove the VBScript
+  # after we executed it
+  # @see https://msdn.microsoft.com/en-us/library/aa364991.aspx
+  class VBScript < PowershellScript
+    name 'vbscript'
+    desc ''
+    example "
+      script = <<-EOH
+        # you vbscript
+      EOH
+
+      describe vbscript(script) do
+        its('stdout') { should eq 'output' }
+      end
+    "
+
+    def initialize(vbscript)
+      return skip_resource 'The `vbscript` resource is not supported on your OS yet.' unless inspec.os.windows?
+
+      cmd = <<-EOH
+$vbscript = @"
+#{vbscript}
+"@
+$filename = [System.IO.Path]::GetTempFileName() + ".vbs"
+New-Item $filename -type file -force -value $vbscript | Out-Null
+cscript.exe /nologo $filename
+Remove-Item $filename | Out-Null
+EOH
+      super(cmd)
+    end
+
+    def to_s
+      'Windows VBScript'
+    end
+  end
+end

data/lib/resources/wmi.rb

@@ -0,0 +1,75 @@
+# encoding: utf-8
+# author: Christoph Hartmann
+# author: Dominik Richter
+
+require 'utils/object_traversal'
+
+module Inspec::Resources
+  # This resource simplifies the access to wmi
+  # on CLI you would use:
+  # WMIC /NAMESPACE:\\root\rsop\computer PATH RSOP_SecuritySettingNumeric WHERE "KeyName = 'MinimumPasswordAge' And precedence=1" GET Setting
+  # We use Get-WmiObject via Powershell to retrieve all values.
+  class WMI < Inspec.resource(1)
+    name 'wmi'
+    desc 'request wmi information'
+    example "
+      describe wmi('RSOP_SecuritySettingNumeric', {
+        namespace: 'root\\rsop\\computer',
+        filter: 'KeyName = \'MinimumPasswordAge\' And precedence=1'
+      }) do
+         its('Setting') { should eq true }
+      end
+    "
+
+    include ObjectTraverser
+    attr_accessor :content
+
+    def initialize(wmiclass, opts = {})
+      # verify that this resource is only supported on Windows
+      return skip_resource 'The `windows_feature` resource is not supported on your OS.' unless inspec.os.windows?
+
+      @wmiclass = wmiclass
+      @wminamespace = opts[:namespace]
+      @wmifilter = opts[:filter]
+    end
+
+    # returns nil, if not existant or value
+    def method_missing(*keys)
+      # catch behavior of rspec its implementation
+      # @see https://github.com/rspec/rspec-its/blob/master/lib/rspec/its.rb#L110
+      keys.shift if keys.is_a?(Array) && keys[0] == :[]
+
+      # map all symbols to strings
+      keys = keys.map(&:to_s) if keys.is_a?(Array)
+
+      value(keys)
+    end
+
+    def value(key)
+      extract_value(key, info)
+    end
+
+    def info
+      return @content if defined?(@content)
+      @content = {}
+
+      # we should abort execution, if wmi class is not given or wmi resource is
+      # executed on a non-windows system
+      return @content if @wmiclass.nil?
+
+      # optional params
+      cmd_namespace = "-namespace #{@wminamespace}" unless @wminamespace.nil?
+      cmd_filter = "-filter \"#{@wmifilter}\"" unless @wmifilter.nil?
+
+      # run wmi command
+      cmd = inspec.command("Get-WmiObject -class #{@wmiclass} #{cmd_namespace} #{cmd_filter} | ConvertTo-Json")
+      @content = JSON.parse(cmd.stdout)
+    rescue JSON::ParserError => _e
+      @content
+    end
+
+    def to_s
+      "WMI #{@wmiclass} where #{@wmifilter}"
+    end
+  end
+end

data/lib/utils/hash_map.rb

@@ -0,0 +1,37 @@
+# encoding: utf-8
+# author: Dominik Richter
+# author: Christoph Hartmann
+
+class HashMap
+  class << self
+    def [](hash, *keys)
+      return hash if keys.empty? || hash.nil?
+      key = keys.shift
+      if hash.is_a?(Array)
+        map = hash.map { |i| [i, key] }
+      else
+        map = hash[key]
+      end
+      [map, *keys]
+    rescue NoMethodError => _
+      nil
+    end
+  end
+end
+
+class StringMap
+  class << self
+    def [](hash, *keys)
+      return hash if keys.empty? || hash.nil?
+      key = keys.shift
+      if hash.is_a?(Array)
+        map = hash.map { |i| [i, key] }
+      else
+        map = hash[key]
+      end
+      [map, *keys]
+    rescue NoMethodError => _
+      nil
+    end
+  end
+end

data/lib/utils/object_traversal.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+# author: Dominik Richter
+# author: Christoph Hartmann
+module ObjectTraverser
+  def extract_value(keys, value)
+    key = keys.shift
+    return nil if key.nil? || value.nil?
+
+    # if value is an array, iterate over each child
+    if value.is_a?(Array)
+      value = value.map { |i|
+        extract_value([key], i)
+      }
+    else
+      value = value[key.to_s].nil? ? nil : value[key.to_s]
+    end
+
+    # if there are no more keys, just return the value
+    return value if keys.first.nil?
+    # if there are more keys, extract more
+    extract_value(keys.clone, value)
+  end
+end

data/test/helper.rb

@@ -237,6 +237,8 @@ class MockLoader
       'netstat -an -f inet -f inet6' => cmd.call('s11-netstat-an-finet-finet6'),
       # xinetd configuration
       'find /etc/xinetd.d -type f' => cmd.call('find-xinetd.d'),
+      # wmi test
+      "Get-WmiObject -class win32_service  -filter \"name like '%winrm%'\" | ConvertTo-Json" => cmd.call('get-wmiobject'),
     }
 
     @backend

data/test/integration/default/port_spec.rb

@@ -17,5 +17,7 @@ end
 if os.linux?
   describe port(22) do
     its('processes') { should include 'sshd' }
+    its('protocols') { should include 'tcp' }
+    its('addresses') {should include '0.0.0.0'}
   end
 end

data/test/integration/default/powershell_spec.rb

@@ -3,11 +3,29 @@ script = <<-EOH
   Write-Output 'hello'
 EOH
 
+# Write-Output comes with a newline
 describe powershell(script) do
-  its('stdout') { should eq 'hello' }
+  its('stdout') { should eq "hello\r\n" }
+  its('stderr') { should eq '' }
 end
 
-# legacy test
+# legacy test with `script` resource
 describe script(script) do
+  its('stdout') { should eq "hello\r\n" }
+  its('stderr') { should eq '' }
+end
+
+# -NoNewLine only works in powershell 5
+# @see https://blogs.technet.microsoft.com/heyscriptingguy/2015/08/07/the-powershell-5-nonewline-parameter/
+describe powershell("'hello' | Write-Host -NoNewLine") do
   its('stdout') { should eq 'hello' }
+  its('stderr') { should eq '' }
+end
+
+# test stderr
+describe powershell("Write-Error \"error\"") do
+  its('stdout') { should eq '' }
+  # this is an xml error for now, if the script is run via WinRM
+  # @see https://github.com/WinRb/WinRM/issues/106
+  # its('stderr') { should eq 'error' }
 end

data/test/integration/default/vbscript_spec.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+# script that may have multiple lines
+vbscript = <<-EOH
+  WScript.Echo "hello"
+EOH
+
+describe vbscript(vbscript) do
+  its('stdout') { should eq "hello\r\n" }
+end
+
+# ensure that we do not require a newline
+describe vbscript("Wscript.Stdout.Write \"hello\"") do
+  its('stdout') { should eq 'hello' }
+end

data/test/integration/default/wmi_spec.rb

@@ -0,0 +1,26 @@
+# encoding: utf-8
+
+# Get-WmiObject win32_service
+# Get-WmiObject -class win32_service
+# returns an array of service objects
+describe wmi('win32_service') do
+  its(['Path','ClassName']) { should include 'Win32_Service' }
+  its('DisplayName') { should include 'Windows Remote Management (WS-Management)'}
+end
+
+# Use win32_service with filter
+# this returns a single service object
+describe wmi('win32_service', {
+  filter: "name like '%winrm%'"
+}) do
+  its(['Path','ClassName']) { should eq 'Win32_Service' }
+  its('DisplayName') { should eq 'Windows Remote Management (WS-Management)'}
+end
+
+# TODO: this works on domain controllers only
+describe wmi('RSOP_SecuritySettingNumeric', {
+  namespace: 'root\\rsop\\computer',
+  filter: 'KeyName = \'MinimumPasswordAge\' And precedence=1'
+}) do
+   its('Setting') { should eq 1 }
+end

data/test/unit/mock/cmd/get-wmiobject

@@ -0,0 +1,10 @@
+{
+    "Path":  {
+                 "ClassName":  "Win32_Service"
+             },
+    "Caption":  "Windows Remote Management (WS-Management)",
+    "CreationClassName":  "Win32_Service",
+    "DisplayName":  "Windows Remote Management (WS-Management)",
+    "Name":  "WinRM",
+    "PathName":  "C:\\Windows\\System32\\svchost.exe -k NetworkService"
+}

data/test/unit/resources/port_test.rb

@@ -12,6 +12,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.protocols).must_equal %w{ tcp tcp6 }
     _(resource.pids).must_equal [1]
     _(resource.processes).must_equal ['sshd']
+    _(resource.addresses).must_equal ["0.0.0.0", "::"]
   end
 
   it 'verify UDP port on Ubuntu 14.04' do
@@ -20,6 +21,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.protocols).must_equal %w{ udp }
     _(resource.pids).must_equal [545]
     _(resource.processes).must_equal ['rpcbind']
+    _(resource.addresses).must_equal ["0.0.0.0"]
   end
 
   it 'verify port on MacOs x' do
@@ -27,6 +29,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.listening?).must_equal true
     _(resource.protocols).must_equal ['tcp']
     _(resource.processes).must_equal ['VBoxHeadl']
+    _(resource.addresses).must_equal ["127.0.0.1"]
   end
 
   it 'verify port on Windows' do
@@ -34,6 +37,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.listening?).must_equal true
     _(resource.protocols).must_equal ['tcp']
     _(resource.processes).must_equal nil
+    _(resource.addresses).must_equal ["::", "192.168.10.157"]
   end
 
   it 'verify port on FreeBSD' do
@@ -42,6 +46,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.protocols).must_equal %w{ tcp6 tcp }
     _(resource.pids).must_equal [668]
     _(resource.processes).must_equal ['sshd']
+    _(resource.addresses).must_equal ["0:0:0:0:0:0:0:0", "0.0.0.0"]
   end
 
   it 'verify port on wrlinux' do
@@ -49,6 +54,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.listening?).must_equal true
     _(resource.protocols).must_equal %w{ tcp tcp6 }
     _(resource.processes).must_equal ['sshd']
+    _(resource.addresses).must_equal ["0.0.0.0", "::"]
   end
 
   it 'verify running on undefined' do
@@ -57,6 +63,7 @@ describe 'Inspec::Resources::Port' do
     _(resource.protocols).must_equal nil
     _(resource.pids).must_equal nil
     _(resource.processes).must_equal nil
+    _(resource.addresses).must_equal nil
   end
 
   it 'verify port and interface on Ubuntu 14.04' do
@@ -65,20 +72,24 @@ describe 'Inspec::Resources::Port' do
     _(resource.protocols).must_equal %w{ tcp }
     _(resource.pids).must_equal [1]
     _(resource.processes).must_equal ['sshd']
+    _(resource.addresses).must_equal ["0.0.0.0"]
   end
 
   it 'verify not listening port on interface on Ubuntu 14.04' do
     resource = MockLoader.new(:ubuntu1404).load_resource('port', '127.0.0.1', 22)
     _(resource.listening?).must_equal false
+    _(resource.addresses).must_equal nil
   end
 
   it 'verify port on Solaris 10' do
     resource = MockLoader.new(:solaris10).load_resource('port', 22)
     _(resource.listening?).must_equal true
+    _(resource.addresses).must_equal ["0.0.0.0"]
   end
 
   it 'verify port on Solaris 11' do
     resource = MockLoader.new(:solaris11).load_resource('port', 22)
     _(resource.listening?).must_equal true
+    _(resource.addresses).must_equal ["0.0.0.0"]
   end
 end

data/test/unit/resources/powershell_test.rb

@@ -5,7 +5,7 @@
 require 'helper'
 require 'inspec/resource'
 
-describe 'Inspec::Resources::Script' do
+describe 'Inspec::Resources::Powershell' do
 
   ps1_script = <<-EOH
     # call help for get command

data/test/unit/resources/vbscript_test.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+# author: Christoph Hartmann
+# author: Dominik Richter
+
+require 'helper'
+require 'inspec/resource'
+
+describe 'Inspec::Resources::VbScript' do
+
+  vb_script = <<-EOH
+    WScript.Echo "hello vbscript"
+  EOH
+
+  it 'check if `vbscript` for windows is properly generated ' do
+    resource = MockLoader.new(:windows).load_resource('vbscript', vb_script)
+    _(resource.command).must_equal 'powershell -encodedCommand JABQAHIAbwBnAHIAZQBzAHMAUAByAGUAZgBlAHIAZQBuAGMAZQA9ACcAUwBpAGwAZQBuAHQAbAB5AEMAbwBuAHQAaQBuAHUAZQAnADsAJAB2AGIAcwBjAHIAaQBwAHQAIAA9ACAAQAAiAAoAIAAgACAAIABXAFMAYwByAGkAcAB0AC4ARQBjAGgAbwAgACIAaABlAGwAbABvACAAdgBiAHMAYwByAGkAcAB0ACIACgAKACIAQAAKACQAZgBpAGwAZQBuAGEAbQBlACAAPQAgAFsAUwB5AHMAdABlAG0ALgBJAE8ALgBQAGEAdABoAF0AOgA6AEcAZQB0AFQAZQBtAHAARgBpAGwAZQBOAGEAbQBlACgAKQAgACsAIAAiAC4AdgBiAHMAIgAKAE4AZQB3AC0ASQB0AGUAbQAgACQAZgBpAGwAZQBuAGEAbQBlACAALQB0AHkAcABlACAAZgBpAGwAZQAgAC0AZgBvAHIAYwBlACAALQB2AGEAbAB1AGUAIAAkAHYAYgBzAGMAcgBpAHAAdAAgAHwAIABPAHUAdAAtAE4AdQBsAGwACgBjAHMAYwByAGkAcAB0AC4AZQB4AGUAIAAvAG4AbwBsAG8AZwBvACAAJABmAGkAbABlAG4AYQBtAGUACgBSAGUAbQBvAHYAZQAtAEkAdABlAG0AIAAkAGYAaQBsAGUAbgBhAG0AZQAgAHwAIABPAHUAdAAtAE4AdQBsAGwACgA='
+  end
+end

data/test/unit/resources/wmi_test.rb

@@ -0,0 +1,45 @@
+# encoding: utf-8
+# author: Christoph Hartmann
+# author: Dominik Richter
+
+require 'helper'
+require 'inspec/resource'
+
+describe 'Inspec::Resources::WMI' do
+
+  # Check the following as unit test
+  # describe wmi('win32_service', {
+  #   filter: "name like '%winrm%'"
+  # }) do
+  #   its(['Path','ClassName']) { should eq 'Win32_Service' }
+  #   its('DisplayName') { should eq 'Windows Remote Management (WS-Management)'}
+  # end
+
+  # windows
+  it 'verify wmi parsing on windows' do
+    resource = MockLoader.new(:windows).load_resource('wmi', 'win32_service', { filter: "name like '%winrm%'" })
+    _(resource.send('DisplayName')).must_equal 'Windows Remote Management (WS-Management)'
+    _(resource.send('method_missing', 'Path', 'ClassName')).must_equal 'Win32_Service'
+  end
+
+  # ubuntu 14.04 with upstart
+  it 'fail wmi on ubuntu' do
+    resource = MockLoader.new(:ubuntu1404).load_resource('wmi', 'win32_service', { filter: "name like '%winrm%'" })
+    _(resource.send('DisplayName')).must_equal nil
+    _(resource.send('method_missing', 'Path', 'ClassName')).must_equal nil
+  end
+
+  # centos 7 with systemd
+  it 'fail wmi on centos' do
+    resource = MockLoader.new(:centos7).load_resource('wmi', 'win32_service', { filter: "name like '%winrm%'" })
+    _(resource.send('DisplayName')).must_equal nil
+    _(resource.send('method_missing', 'Path', 'ClassName')).must_equal nil
+  end
+
+  # unknown OS
+  it 'fail wmi on unknown os' do
+    resource = MockLoader.new(:undefined).load_resource('wmi', 'win32_service', { filter: "name like '%winrm%'" })
+    _(resource.send('DisplayName')).must_equal nil
+    _(resource.send('method_missing', 'Path', 'ClassName')).must_equal nil
+  end
+end

data/test/unit/utils/hash_map_test.rb

@@ -0,0 +1,63 @@
+# encoding: utf-8
+# author: Dominik Richter
+# author: Christoph Hartmann
+
+require 'helper'
+require 'utils/hash_map'
+
+describe HashMap do
+  describe '#get_value' do
+    it 'returns the source value if no keys are given' do
+      x = rand
+      HashMap[x].must_equal x
+    end
+
+    it 'retrieves a key from a map' do
+      x = { a: rand }
+      HashMap[x, :a].must_equal x[:a]
+    end
+
+    it 'returns nil if the key doesnt exist' do
+      x = { a: rand }
+      HashMap[x, :b].must_be :nil?
+    end
+
+    it 'can extract a nil key' do
+      x = { nil => rand }
+      HashMap[x, nil].must_equal x[nil]
+    end
+
+    it 'extracts multiple keys' do
+      y = rand
+      x = { a: { b: { c: y }}}
+      HashMap[x, :a, :b, :c].must_equal y
+    end
+
+    it 'returns nil if a key in a list doesnt exist' do
+      x = { a: { b: { c: rand }}}
+      HashMap[x, :d, :b, :c].must_be :nil?
+    end
+
+    it 'retrieves exact keys by string' do
+      x = { a: rand }
+      HashMap[x, :a].must_equal x[:a]
+      HashMap[x, 'a'].must_be :nil?
+    end
+
+    it 'retrieves exact keys by string' do
+      x = { 'a' => rand }
+      HashMap[x, 'a'].must_equal x['a']
+      HashMap[x, :a].must_be :nil?
+    end
+
+    it 'con retrieve string keys' do
+      x = { 'a' => rand }
+      HashMap.extract_keys(x, ['a'], string_keys: true).must_equal x['a']
+      HashMap.extract_keys(x, [:a], string_keys: true).must_equal x['a']
+    end
+  end
+
+  describe 'as an instance' do
+    
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inspec
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.16.1
 platform: ruby
 authors:
 - Dominik Richter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-19 00:00:00.000000000 Z
+date: 2016-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: r-train
@@ -315,7 +315,9 @@ files:
 - lib/resources/shadow.rb
 - lib/resources/ssh_conf.rb
 - lib/resources/user.rb
+- lib/resources/vbscript.rb
 - lib/resources/windows_feature.rb
+- lib/resources/wmi.rb
 - lib/resources/xinetd.rb
 - lib/resources/yaml.rb
 - lib/resources/yum.rb
@@ -327,8 +329,10 @@ files:
 - lib/utils/filter_array.rb
 - lib/utils/find_files.rb
 - lib/utils/hash.rb
+- lib/utils/hash_map.rb
 - lib/utils/json_log.rb
 - lib/utils/modulator.rb
+- lib/utils/object_traversal.rb
 - lib/utils/parser.rb
 - lib/utils/plugin_registry.rb
 - lib/utils/simpleconfig.rb
@@ -382,6 +386,8 @@ files:
 - test/integration/default/secpol_spec.rb
 - test/integration/default/service_spec.rb
 - test/integration/default/user_spec.rb
+- test/integration/default/vbscript_spec.rb
+- test/integration/default/wmi_spec.rb
 - test/integration/default/yaml_spec.rb
 - test/resource/command_test.rb
 - test/resource/dsl_test.rb
@@ -426,6 +432,7 @@ files:
 - test/unit/mock/cmd/get-package-ruby
 - test/unit/mock/cmd/get-service-dhcp
 - test/unit/mock/cmd/get-windows-feature
+- test/unit/mock/cmd/get-wmiobject
 - test/unit/mock/cmd/getent-hosts-example.com
 - test/unit/mock/cmd/getent-passwd-jfolmer
 - test/unit/mock/cmd/getent-passwd-root
@@ -547,7 +554,9 @@ files:
 - test/unit/resources/shadow_test.rb
 - test/unit/resources/ssh_conf_test.rb
 - test/unit/resources/user_test.rb
+- test/unit/resources/vbscript_test.rb
 - test/unit/resources/windows_feature.rb
+- test/unit/resources/wmi_test.rb
 - test/unit/resources/xinetd_test.rb
 - test/unit/resources/yaml_test.rb
 - test/unit/resources/yum_test.rb
@@ -556,6 +565,7 @@ files:
 - test/unit/source_readers/inspec_test.rb
 - test/unit/utils/filter_array_test.rb
 - test/unit/utils/find_files_test.rb
+- test/unit/utils/hash_map_test.rb
 - test/unit/utils/passwd_parser_test.rb
 - test/unit/utils/simpleconfig_test.rb
 - test/unit/utils/solaris_netstat_parser.rb
@@ -633,6 +643,8 @@ test_files:
 - test/integration/default/secpol_spec.rb
 - test/integration/default/service_spec.rb
 - test/integration/default/user_spec.rb
+- test/integration/default/vbscript_spec.rb
+- test/integration/default/wmi_spec.rb
 - test/integration/default/yaml_spec.rb
 - test/resource/command_test.rb
 - test/resource/dsl_test.rb
@@ -677,6 +689,7 @@ test_files:
 - test/unit/mock/cmd/get-package-ruby
 - test/unit/mock/cmd/get-service-dhcp
 - test/unit/mock/cmd/get-windows-feature
+- test/unit/mock/cmd/get-wmiobject
 - test/unit/mock/cmd/getent-hosts-example.com
 - test/unit/mock/cmd/getent-passwd-jfolmer
 - test/unit/mock/cmd/getent-passwd-root
@@ -798,7 +811,9 @@ test_files:
 - test/unit/resources/shadow_test.rb
 - test/unit/resources/ssh_conf_test.rb
 - test/unit/resources/user_test.rb
+- test/unit/resources/vbscript_test.rb
 - test/unit/resources/windows_feature.rb
+- test/unit/resources/wmi_test.rb
 - test/unit/resources/xinetd_test.rb
 - test/unit/resources/yaml_test.rb
 - test/unit/resources/yum_test.rb
@@ -807,6 +822,7 @@ test_files:
 - test/unit/source_readers/inspec_test.rb
 - test/unit/utils/filter_array_test.rb
 - test/unit/utils/find_files_test.rb
+- test/unit/utils/hash_map_test.rb
 - test/unit/utils/passwd_parser_test.rb
 - test/unit/utils/simpleconfig_test.rb
 - test/unit/utils/solaris_netstat_parser.rb