inspec 1.51.15 → 1.51.18

data/lib/resources/bash.rb

@@ -1,36 +1,36 @@
-# encoding: utf-8
-# author: Dominik Richter
-# author: Christoph Hartmann
-
-require 'utils/command_wrapper'
-require 'resources/command'
-
-module Inspec::Resources
-  class Bash < Cmd
-    name 'bash'
-    desc 'Run a command or script in BASH.'
-    example "
-      describe bash('ls -al /') do
-        its('stdout') { should match /bin/ }
-        its('stderr') { should eq '' }
-        its('exit_status') { should eq 0 }
-      end
-
-      # Specify the path of the executable:
-      bash('...', path: '/bin/bash')
-
-      # Specify arguments (defaults to -c)
-      bash('...', args: '-x -c')
-    "
-
-    def initialize(command, options = {})
-      @raw_command = command
-      options[:shell] = 'bash' if options.is_a?(Hash)
-      super(CommandWrapper.wrap(command, options))
-    end
-
-    def to_s
-      "Bash command #{@raw_command}"
-    end
-  end
-end
+# encoding: utf-8
+# author: Dominik Richter
+# author: Christoph Hartmann
+
+require 'utils/command_wrapper'
+require 'resources/command'
+
+module Inspec::Resources
+  class Bash < Cmd
+    name 'bash'
+    desc 'Run a command or script in BASH.'
+    example "
+      describe bash('ls -al /') do
+        its('stdout') { should match /bin/ }
+        its('stderr') { should eq '' }
+        its('exit_status') { should eq 0 }
+      end
+
+      # Specify the path of the executable:
+      bash('...', path: '/bin/bash')
+
+      # Specify arguments (defaults to -c)
+      bash('...', args: '-x -c')
+    "
+
+    def initialize(command, options = {})
+      @raw_command = command
+      options[:shell] = 'bash' if options.is_a?(Hash)
+      super(CommandWrapper.wrap(command, options))
+    end
+
+    def to_s
+      "Bash command #{@raw_command}"
+    end
+  end
+end

data/lib/resources/bond.rb

@@ -1,69 +1,69 @@
-# encoding: utf-8
-# author: Christoph Hartmann
-# author: Dominik Richter
-
-require 'resources/file'
-
-module Inspec::Resources
-  class Bond < FileResource
-    name 'bond'
-    desc 'Use the bond InSpec audit resource to test a logical, bonded network interface (i.e. "two or more network interfaces aggregated into a single, logical network interface"). On Linux platforms, any value in the /proc/net/bonding directory may be tested.'
-    example "
-      describe bond('bond0') do
-        it { should exist }
-      end
-    "
-
-    def initialize(bond)
-      @bond = bond
-      @path = "/proc/net/bonding/#{bond}"
-      @file = inspec.file(@path)
-      @content = nil
-      @params = {}
-      @loaded = false
-    end
-
-    def read_content
-      # parse the file
-      @content = @file.content
-      @params = SimpleConfig.new(
-        @file.content,
-        assignment_regex: /^\s*([^:]*?)\s*:\s*(.*?)\s*$/,
-        multiple_values: true,
-      ).params if @file.exist?
-      @loaded = true
-      @content
-    end
-
-    # ensures the content is loaded before we return the params
-    def params
-      read_content if @loaded == false
-      @params
-    end
-
-    def content
-      read_content if @loaded == false
-      @content
-    end
-
-    def exist?
-      @file.exist?
-    end
-
-    def has_interface?(interface)
-      params['Slave Interface'].include?(interface)
-    end
-
-    def interfaces
-      params['Slave Interface']
-    end
-
-    def mode
-      params['Bonding Mode'].first
-    end
-
-    def to_s
-      "Bond #{@bond}"
-    end
-  end
-end
+# encoding: utf-8
+# author: Christoph Hartmann
+# author: Dominik Richter
+
+require 'resources/file'
+
+module Inspec::Resources
+  class Bond < FileResource
+    name 'bond'
+    desc 'Use the bond InSpec audit resource to test a logical, bonded network interface (i.e. "two or more network interfaces aggregated into a single, logical network interface"). On Linux platforms, any value in the /proc/net/bonding directory may be tested.'
+    example "
+      describe bond('bond0') do
+        it { should exist }
+      end
+    "
+
+    def initialize(bond)
+      @bond = bond
+      @path = "/proc/net/bonding/#{bond}"
+      @file = inspec.file(@path)
+      @content = nil
+      @params = {}
+      @loaded = false
+    end
+
+    def read_content
+      # parse the file
+      @content = @file.content
+      @params = SimpleConfig.new(
+        @file.content,
+        assignment_regex: /^\s*([^:]*?)\s*:\s*(.*?)\s*$/,
+        multiple_values: true,
+      ).params if @file.exist?
+      @loaded = true
+      @content
+    end
+
+    # ensures the content is loaded before we return the params
+    def params
+      read_content if @loaded == false
+      @params
+    end
+
+    def content
+      read_content if @loaded == false
+      @content
+    end
+
+    def exist?
+      @file.exist?
+    end
+
+    def has_interface?(interface)
+      params['Slave Interface'].include?(interface)
+    end
+
+    def interfaces
+      params['Slave Interface']
+    end
+
+    def mode
+      params['Bonding Mode'].first
+    end
+
+    def to_s
+      "Bond #{@bond}"
+    end
+  end
+end

data/lib/resources/bridge.rb

@@ -1,123 +1,123 @@
-# encoding: utf-8
-# author: Christoph Hartmann
-# author: Dominik Richter
-
-# Usage:
-# describe bridge('br0') do
-#   it { should exist }
-#   it { should have_interface 'eth0' }
-# end
-
-module Inspec::Resources
-  class Bridge < Inspec.resource(1)
-    name 'bridge'
-    desc 'Use the bridge InSpec audit resource to test basic network bridge properties, such as name, if an interface is defined, and the associations for any defined interface.'
-    example "
-      describe bridge 'br0' do
-        it { should exist }
-        it { should have_interface 'eth0' }
-      end
-    "
-
-    def initialize(bridge_name)
-      @bridge_name = bridge_name
-
-      @bridge_provider = nil
-      if inspec.os.linux?
-        @bridge_provider = LinuxBridge.new(inspec)
-      elsif inspec.os.windows?
-        @bridge_provider = WindowsBridge.new(inspec)
-      else
-        return skip_resource 'The `bridge` resource is not supported on your OS yet.'
-      end
-    end
-
-    def exists?
-      !bridge_info.nil? && !bridge_info[:name].nil?
-    end
-
-    def has_interface?(interface)
-      return skip_resource 'The `bridge` resource does not provide interface detection for Windows yet' if inspec.os.windows?
-      bridge_info.nil? ? false : bridge_info[:interfaces].include?(interface)
-    end
-
-    def interfaces
-      bridge_info.nil? ? nil : bridge_info[:interfaces]
-    end
-
-    def to_s
-      "Bridge #{@bridge_name}"
-    end
-
-    private
-
-    def bridge_info
-      return @cache if defined?(@cache)
-      @cache = @bridge_provider.bridge_info(@bridge_name) if !@bridge_provider.nil?
-    end
-  end
-
-  class BridgeDetection
-    attr_reader :inspec
-    def initialize(inspec)
-      @inspec = inspec
-    end
-  end
-
-  # Linux Bridge
-  # If /sys/class/net/{interface}/bridge exists then it must be a bridge
-  # /sys/class/net/{interface}/brif contains the network interfaces
-  # @see http://www.tldp.org/HOWTO/BRIDGE-STP-HOWTO/set-up-the-bridge.html
-  # @see http://unix.stackexchange.com/questions/40560/how-to-know-if-a-network-interface-is-tap-tun-bridge-or-physical
-  class LinuxBridge < BridgeDetection
-    def bridge_info(bridge_name)
-      # read bridge information
-      bridge = inspec.file("/sys/class/net/#{bridge_name}/bridge").directory?
-      return nil unless bridge
-
-      # load interface names
-      interfaces = inspec.command("ls -1 /sys/class/net/#{bridge_name}/brif/")
-      interfaces = interfaces.stdout.chomp.split("\n")
-      {
-        name: bridge_name,
-        interfaces: interfaces,
-      }
-    end
-  end
-
-  # Windows Bridge
-  # select netadapter by adapter binding for windows
-  # Get-NetAdapterBinding -ComponentID ms_bridge | Get-NetAdapter
-  # @see https://technet.microsoft.com/en-us/library/jj130921(v=wps.630).aspx
-  # RegKeys: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4D36E972-E325-11CE-BFC1-08002BE10318}
-  class WindowsBridge < BridgeDetection
-    def bridge_info(bridge_name)
-      # find all bridge adapters
-      cmd = inspec.command('Get-NetAdapterBinding -ComponentID ms_bridge | Get-NetAdapter | Select-Object -Property Name, InterfaceDescription | ConvertTo-Json')
-
-      # filter network interface
-      begin
-        bridges = JSON.parse(cmd.stdout)
-      rescue JSON::ParserError => _e
-        return nil
-      end
-
-      # ensure we have an array of groups
-      bridges = [bridges] if !bridges.is_a?(Array)
-
-      # select the requested interface
-      bridges = bridges.each_with_object([]) do |adapter, adapter_collection|
-        # map object
-        info = {
-          name: adapter['Name'],
-          interfaces: nil,
-        }
-        adapter_collection.push(info) if info[:name].casecmp(bridge_name) == 0
-      end
-
-      return nil if bridges.empty?
-      warn "[Possible Error] detected multiple bridges interfaces with the name #{bridge_name}" if bridges.size > 1
-      bridges[0]
-    end
-  end
-end
+# encoding: utf-8
+# author: Christoph Hartmann
+# author: Dominik Richter
+
+# Usage:
+# describe bridge('br0') do
+#   it { should exist }
+#   it { should have_interface 'eth0' }
+# end
+
+module Inspec::Resources
+  class Bridge < Inspec.resource(1)
+    name 'bridge'
+    desc 'Use the bridge InSpec audit resource to test basic network bridge properties, such as name, if an interface is defined, and the associations for any defined interface.'
+    example "
+      describe bridge 'br0' do
+        it { should exist }
+        it { should have_interface 'eth0' }
+      end
+    "
+
+    def initialize(bridge_name)
+      @bridge_name = bridge_name
+
+      @bridge_provider = nil
+      if inspec.os.linux?
+        @bridge_provider = LinuxBridge.new(inspec)
+      elsif inspec.os.windows?
+        @bridge_provider = WindowsBridge.new(inspec)
+      else
+        return skip_resource 'The `bridge` resource is not supported on your OS yet.'
+      end
+    end
+
+    def exists?
+      !bridge_info.nil? && !bridge_info[:name].nil?
+    end
+
+    def has_interface?(interface)
+      return skip_resource 'The `bridge` resource does not provide interface detection for Windows yet' if inspec.os.windows?
+      bridge_info.nil? ? false : bridge_info[:interfaces].include?(interface)
+    end
+
+    def interfaces
+      bridge_info.nil? ? nil : bridge_info[:interfaces]
+    end
+
+    def to_s
+      "Bridge #{@bridge_name}"
+    end
+
+    private
+
+    def bridge_info
+      return @cache if defined?(@cache)
+      @cache = @bridge_provider.bridge_info(@bridge_name) if !@bridge_provider.nil?
+    end
+  end
+
+  class BridgeDetection
+    attr_reader :inspec
+    def initialize(inspec)
+      @inspec = inspec
+    end
+  end
+
+  # Linux Bridge
+  # If /sys/class/net/{interface}/bridge exists then it must be a bridge
+  # /sys/class/net/{interface}/brif contains the network interfaces
+  # @see http://www.tldp.org/HOWTO/BRIDGE-STP-HOWTO/set-up-the-bridge.html
+  # @see http://unix.stackexchange.com/questions/40560/how-to-know-if-a-network-interface-is-tap-tun-bridge-or-physical
+  class LinuxBridge < BridgeDetection
+    def bridge_info(bridge_name)
+      # read bridge information
+      bridge = inspec.file("/sys/class/net/#{bridge_name}/bridge").directory?
+      return nil unless bridge
+
+      # load interface names
+      interfaces = inspec.command("ls -1 /sys/class/net/#{bridge_name}/brif/")
+      interfaces = interfaces.stdout.chomp.split("\n")
+      {
+        name: bridge_name,
+        interfaces: interfaces,
+      }
+    end
+  end
+
+  # Windows Bridge
+  # select netadapter by adapter binding for windows
+  # Get-NetAdapterBinding -ComponentID ms_bridge | Get-NetAdapter
+  # @see https://technet.microsoft.com/en-us/library/jj130921(v=wps.630).aspx
+  # RegKeys: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Class\{4D36E972-E325-11CE-BFC1-08002BE10318}
+  class WindowsBridge < BridgeDetection
+    def bridge_info(bridge_name)
+      # find all bridge adapters
+      cmd = inspec.command('Get-NetAdapterBinding -ComponentID ms_bridge | Get-NetAdapter | Select-Object -Property Name, InterfaceDescription | ConvertTo-Json')
+
+      # filter network interface
+      begin
+        bridges = JSON.parse(cmd.stdout)
+      rescue JSON::ParserError => _e
+        return nil
+      end
+
+      # ensure we have an array of groups
+      bridges = [bridges] if !bridges.is_a?(Array)
+
+      # select the requested interface
+      bridges = bridges.each_with_object([]) do |adapter, adapter_collection|
+        # map object
+        info = {
+          name: adapter['Name'],
+          interfaces: nil,
+        }
+        adapter_collection.push(info) if info[:name].casecmp(bridge_name) == 0
+      end
+
+      return nil if bridges.empty?
+      warn "[Possible Error] detected multiple bridges interfaces with the name #{bridge_name}" if bridges.size > 1
+      bridges[0]
+    end
+  end
+end