inspec-core 3.9.0 → 3.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6060db98285f1a0cdb5d521ad533a502a0481c57ad613baf2c0469d520966f23
-  data.tar.gz: 0ccdf80c41296d07328c5fd7bb172e75aca2e9c40acbef9813d7aa442be95c89
+  metadata.gz: 96ff01311bc29d2878ccaa989af9b586229a74cf6c4e22a5d15cccec333ab8b9
+  data.tar.gz: 727e2df3d8d54bbf57fa4cd91b6dbb2a2d45b8124ee2fa6aaff2e8e29ad8c5fe
 SHA512:
-  metadata.gz: 5199f204d872c74e1091021828b28f210ba2eb81d164af3365edcddb9ffe6bdb45b261fddb3109c27bd77ac5345cf009145e7c0606754a27530c594e2e511d63
-  data.tar.gz: e2c1e9ac924684a2dfb26665a88ee31fc66c6813c7aeb04bf6e312875c5efd69aea924da4e1bf43b27483adaaa1516c35711d8b69aa12c40b0853ac70c234e9a
+  metadata.gz: 158b57f8f27e24c0a4c3dd9f6f0db7701ed1deac01872d6832332bfc523eea695f8af4654bbabdc6e1fdf649eff3ea007f37417d3e5dda92bf097fb5d1fe0438
+  data.tar.gz: 994876c13c21a6a2230c945e2668515b75d5ac30202de624da721cb929e10fdcd96fb159a935e9119f0b92ed92ff75a8cf480a7937e5b159cc1dadd021eea719

data/lib/inspec.rb

@@ -20,6 +20,7 @@ require 'inspec/input_registry'
 require 'inspec/rspec_extensions'
 require 'inspec/globals'
 require 'inspec/impact'
+require 'inspec/utils/telemetry'
 
 require 'inspec/plugin/v2'
 require 'inspec/plugin/v1'

data/lib/inspec/base_cli.rb

@@ -107,8 +107,10 @@ module Inspec
       option :reporter, type: :array,
         banner: 'one two:/output/file/path',
         desc: 'Enable one or more output reporters: cli, documentation, html, progress, json, json-min, json-rspec, junit, yaml'
-      option :attrs, type: :array,
+      option :input_file, type: :array,
         desc: 'Load one or more input files, a YAML file with values for the profile to use'
+      option :attrs, type: :array,
+        desc: 'Legacy name for --input-file - deprecated.'
       option :create_lockfile, type: :boolean,
         desc: 'Write out a lockfile based on this execution (unless one already exists)'
       option :backend_cache, type: :boolean,

data/lib/inspec/objects/input.rb

@@ -23,8 +23,8 @@ module Inspec
 
         # output warn message if we are in a exec call
         Inspec::Log.warn(
-          "Attribute '#{@name}' does not have a value. "\
-          "Use --attrs to provide a value for '#{@name}' or specify a  "\
+          "Input '#{@name}' does not have a value. "\
+          "Use --input-file to provide a value for '#{@name}' or specify a  "\
           "value with `attribute('#{@name}', value: 'somevalue', ...)`.",
         ) if Inspec::BaseCLI.inspec_cli_command == :exec
       end

data/lib/inspec/runner.rb

@@ -151,10 +151,14 @@ module Inspec
 
     # determine all inputs before the execution, fetch data from secrets backend
     def load_inputs(options)
-      # TODO: - rename :attributes and :attrs - these are both user-visible
+      # TODO: - rename :attributes - it is user-visible
       options[:attributes] ||= {}
 
-      secrets_targets = options[:attrs]
+      if options.key?(:attrs)
+        Inspec.deprecate(:rename_attributes_to_inputs, 'Use --input-file on the command line instead of --attrs.')
+        options[:input_file] = options.delete(:attrs)
+      end
+      secrets_targets = options[:input_file]
       return options[:attributes] if secrets_targets.nil?
 
       secrets_targets.each do |target|

data/lib/inspec/utils/telemetry.rb

@@ -0,0 +1,3 @@
+require 'inspec/utils/telemetry/collector'
+require 'inspec/utils/telemetry/data_series'
+require 'inspec/utils/telemetry/global_methods'

data/lib/inspec/utils/telemetry/collector.rb

@@ -0,0 +1,60 @@
+require 'inspec/utils/telemetry/data_series'
+require 'singleton'
+
+module Inspec::Telemetry
+  # A Singleton collection of data series objects.
+  class Collector
+    include Singleton
+
+    def initialize
+      @data_series = []
+      @enabled = true
+    end
+
+    # Add a data series to the collection.
+    # @return [True]
+    def add_data_series(data_series)
+      @data_series << data_series
+    end
+
+    # Is the Telemetry system enabled or disabled?
+    # Always true until we add configuration parsing.
+    # @return [True, False]
+    def telemetry_enabled?
+      @enabled
+    end
+
+    # A way to disable the telemetry system.
+    # @return [True]
+    def disable_telemetry
+      @enabled = false
+    end
+
+    # The entire data series collection.
+    # @return [Array]
+    def list_data_series
+      @data_series
+    end
+
+    # Finds the data series object with the specified name and returns it.
+    # If it does not exist then creates a new data series with that name
+    # and returns it.
+    # @return [Inspec::Telemetry::DataSeries]
+    def find_or_create_data_series(name)
+      ds = @data_series.select { |data_series| data_series.name.eql?(name) }
+      if ds.empty?
+        new_data_series = Inspec::Telemetry::DataSeries.new(name)
+        @data_series << new_data_series
+        new_data_series
+      else
+        ds.first
+      end
+    end
+
+    # Blanks the contents of the data series collection.
+    # @return [True]
+    def reset
+      @data_series = []
+    end
+  end
+end

data/lib/inspec/utils/telemetry/data_series.rb

@@ -0,0 +1,42 @@
+require 'json'
+
+# A minimal Dataseries Object
+# Stores the name of the data series and an array of data.
+# Stored data should be a object that supports #to_s
+module Inspec::Telemetry
+  class DataSeries
+    def initialize(name)
+      @name = name
+      @enabled = true
+      @data ||= []
+    end
+
+    attr_reader :data, :name
+
+    # This needs to also be set by configuration.
+    def enabled?
+      @enabled
+    end
+
+    def disable
+      @enabled = false
+    end
+
+    def <<(appending_data)
+      data << appending_data
+    end
+
+    alias push <<
+
+    def to_h
+      {
+        name: @name,
+        data: @data,
+      }
+    end
+
+    def to_json
+      to_h.to_json
+    end
+  end
+end

data/lib/inspec/utils/telemetry/global_methods.rb

@@ -0,0 +1,21 @@
+require 'inspec/utils/telemetry'
+
+module Inspec
+  # A Global method to add a data series object to the Telemetry Collection.
+  # `data_series_name`s are unique, so `:dependency_group` will always return
+  # the same object.
+  # `data_point` is optional, you may also supply a block with several data points.
+  # All data points should allow #to_s
+  def self.record_telemetry_data(data_series_name, data_point = nil)
+    coll = Inspec::Telemetry::Collector.instance
+    return unless coll.telemetry_enabled?
+    ds = coll.find_or_create_data_series(data_series_name)
+    return unless ds.enabled?
+
+    if block_given?
+      ds << yield
+    else
+      ds << data_point
+    end
+  end
+end

data/lib/inspec/version.rb

@@ -4,5 +4,5 @@
 # author: Christoph Hartmann
 
 module Inspec
-  VERSION = '3.9.0'
+  VERSION = '3.9.3'
 end

data/lib/resources/crontab.rb

@@ -41,6 +41,7 @@ module Inspec::Resources
         @user = opts.fetch(:user, nil)
         @path = opts.fetch(:path, nil)
         raise Inspec::Exceptions::ResourceFailed, 'A user or path must be supplied.' if @user.nil? && @path.nil?
+        raise Inspec::Exceptions::ResourceFailed, 'Either user or path must be supplied, not both!' if !@user.nil? && !@path.nil?
       else
         @user = opts
         @path = nil
@@ -49,7 +50,12 @@ module Inspec::Resources
     end
 
     def read_crontab
-      ct = is_system_crontab? ? inspec.file(@path).content : inspec.command(crontab_cmd).stdout
+      if is_system_crontab?
+        raise Inspec::Exceptions::ResourceFailed, "Supplied crontab path '#{@path}' must exist!" if !inspec.file(@path).exist?
+        ct = inspec.file(@path).content
+      else
+        ct = inspec.command(crontab_cmd).stdout
+      end
       ct.lines.map { |l| parse_crontab_line(l) }.compact
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inspec-core
 version: !ruby/object:Gem::Version
-  version: 3.9.0
+  version: 3.9.3
 platform: ruby
 authors:
 - Dominik Richter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-01 00:00:00.000000000 Z
+date: 2019-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: train-core
@@ -468,6 +468,10 @@ files:
 - lib/inspec/shell_detector.rb
 - lib/inspec/source_reader.rb
 - lib/inspec/ui.rb
+- lib/inspec/utils/telemetry.rb
+- lib/inspec/utils/telemetry/collector.rb
+- lib/inspec/utils/telemetry/data_series.rb
+- lib/inspec/utils/telemetry/global_methods.rb
 - lib/inspec/version.rb
 - lib/matchers/matchers.rb
 - lib/plugins/README.md