ecomdev-chefspec 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9855c65317cdbad908e4b3ce31121b2d92df1ccc
-  data.tar.gz: 506884fda82363e731a0042082bf658dc99a5fc7
+  metadata.gz: ee3608b8e1aab45a9fa3e0aa5a56321e1347c6a6
+  data.tar.gz: a625c05596c7a54a438c6861a4bdb04957227fb0
 SHA512:
-  metadata.gz: a091b003633864e953be4c4e8cafa4fb823c408e1ed1527bbf74783d19558bf24d1383b1d33359f2d711c8eb583241be76c3bb5e8c9fa9878c0a6cd07e9412df
-  data.tar.gz: d00fa8ba662a776846225bde8657ee92183be41c3f4525f023c44bdf739d3d3a46b4a0a4d21175f18d2965ef4f4c02effe48024c07ab62025a81d1899b2b34fc
+  metadata.gz: 889c672f43c8afdfc5b61dc91b3235d415c5d038a27280c562ce772144ba8cbd6452ddc6464ed62ad2accf25db2cbda78e682e1743bb0f4d8ae7b17be0134eff
+  data.tar.gz: d4c0b510f3ab8fe4ab351658d8d55ea48d497fc9e6830225687542551f31ab5f6a1b97df8521a346133a340107e168aaa4b9e1ae2aa47f7d3ef567a5e2bf313e

data/.gitignore

@@ -1,3 +1,4 @@
+.idea/*
 *.gem
 *.rbc
 .bundle

data/README.md

@@ -29,6 +29,50 @@ Features:
     * Berkshelf or Librarian path if any of those was included before
     * `path/to/your/test/cookbooks`
     * `another/path/to/your/test/cookbooks`  
+    
+ * Allows to create platform based test cases by calling `platform(*filters)` method. Platform file is a json of such a structure:
+    
+   ```javascript
+   {
+       "os": {
+           "ubuntu": ["10.04", "12.04", "13.10", "14.04"],
+           "debian": ["6.0.5", "7.2", "7.4"],
+           "freebsd": "9.2",
+           "centos": ["5.8","6.4", "6.5"],
+           "redhat": ["5.6", "6.3", "6.4"],
+           "fedora": ["18", "19", "20"]
+       },
+       "family": {
+           "debian": ["ubuntu", "debian"],
+           "rhel": ["redhat", "centos"],
+           "fedora": ["fedora"],
+           "freebsd": ["freebsd"]
+       }
+   }
+   ```
+   
+    By default this file is read from such location spec/platform.json. You can override it by specifying `EcomDev::ChefSpec::Helpers::Platform.platform_path='path/to/dir'` and `EcomDev::ChefSpec::Helpers::Platform.platform_file='file.json'` or directly by calling `platform_load(file, path)` in your test case body
+    
+    When calling `platform` method you can pass a ruby block, so it will iterate over specified platforms:
+    
+    ```ruby
+    platform(:debian, :ubuntu) do |os, version|
+      context 'In scope of ' + os + ' ' + version do
+         it 'does crazy thing' do
+             # .. you test code
+         end
+      end
+    end
+    ```
+    
+     it will produce the following output:
+
+    ```
+    In scope of ubuntu 14.04
+       does crazy things
+    In scope of debian 7.4
+       does crazy things
+    ```
    
 
 ## Build Status

data/ecomdev-chefspec.gemspec

@@ -19,6 +19,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency 'chefspec', '~> 4.0'
+  spec.add_dependency 'json'
   spec.add_development_dependency "bundler", "~> 1.6"
   spec.add_development_dependency "rake"
 end

data/lib/ecomdev/chefspec/api/helpers/platform.rb

@@ -0,0 +1,20 @@
+module RSpec::Core::MemoizedHelpers::ClassMethods
+  def platform_load(file = nil, path = nil)
+    @platform = EcomDev::ChefSpec::Helpers::Platform.new(file, path)
+  end
+
+  def platform(*args)
+    if @platform.nil?
+      platform_load
+    end
+
+    platforms = @platform.filter(*args)
+    unless block_given?
+      return platforms
+    end
+
+    platforms.each do |platform|
+      yield platform[:os].to_s, platform[:version].to_s
+    end
+  end
+end

data/lib/ecomdev/chefspec/api/helpers/runner.rb

@@ -1,143 +1,7 @@
 module ChefSpec::API
   module EcomDevHelpersRunner
     def chef_run_proxy
-      RunnerProxy
-    end
-
-    class RunnerProxy
-      instance_methods.each { |m| undef_method m unless m =~ /(^instance_variable_get|^initialize|^__|^send$|^object_id$)/ }
-
-      def initialize(*args, &before_initialize)
-        @args = args
-        @constructor_block = before_initialize
-        @target = nil
-        @blocks = {
-            :before => {},
-            :block => {},
-            :after => {}
-        }
-      end
-
-      def options(options = {}, override = false)
-        if @args.length == 0
-          @args << options
-          return @args[0]
-        end
-        if override
-          @args[0] = options
-        else
-          @args[0] = options.merge(@args[0])
-        end
-        @args[0]
-      end
-
-      def before(method, instance_eval = true, &block)
-        define_proxy_block(method, :before, instance_eval, &block)
-      end
-
-      def after(method, instance_eval = true, &block)
-        define_proxy_block(method, :after, instance_eval, &block)
-      end
-
-      def block(method, instance_eval = true, &block)
-        define_proxy_block(method, :block, instance_eval, &block)
-      end
-
-      def proxy_blocks
-        @blocks
-      end
-
-      def runner
-        target
-      end
-
-      # Proxied chef runner
-      protected
-        def define_proxy_block(method, type, instance_eval = true, &block)
-          if block_given?
-            @blocks[type][method] ||= Array.new
-            @blocks[type][method] << {block: block, instance_eval: instance_eval}
-          end
-        end
-
-        def block_for?(method, type)
-          @blocks.key?(type) && @blocks[type].key?(method) && @blocks[type][method].is_a?(Array)
-        end
-
-        def invoke_blocks(method, type, *args, &block)
-          blocks_to_exec = []
-          if block_given?
-            blocks_to_exec << {block: block, instance_eval: false, caller_block: true}
-          end
-
-          if block_for?(method, type)
-            blocks_to_exec.push(@blocks[type][method]).flatten!
-          end
-
-          blocks_to_exec.each do |info|
-            if info[:instance_eval]
-              target.instance_exec(*args, &info[:block])
-            else
-              calling_args = args.clone
-              unless info.key?(:caller_block) && info[:caller_block]
-                calling_args.unshift(target)
-              end
-              info[:block].call(*calling_args)
-            end
-          end
-        end
-
-        def method_missing(name, *args, &block)
-          invoke_blocks(name, :before, *args)
-          result = target.send(name, *args) do |*block_args|
-            invoke_blocks(name, :block, *block_args, &block)
-          end
-          args.unshift(result)
-          invoke_blocks(name, :after, *args)
-          result
-        end
-
-        def target
-          unless @target.nil?
-            return @target
-          end
-          block_args = nil
-          @target = ChefSpec::Runner.new(*@args) do |*args|
-            block_args = args
-          end
-          invoke_blocks(:initialize, :block, *block_args, &@constructor_block)
-          @target
-        end
-
-        class << self
-          def instance(*args, &block)
-            proxy = self.new(*args, &block)
-            proxy_calls.each do |call|
-              proxy.send(call[:method], *call[:args], &call[:block])
-            end
-            reset
-            proxy
-          end
-
-          def reset
-            proxy_calls([])
-            self
-          end
-
-          def method_missing(method, *args, &block)
-            proxy_calls.push({method: method, args: args, block: block})
-            self
-          end
-
-          private
-            def proxy_calls(calls=nil)
-              @calls ||= []
-              unless calls.nil?
-                @calls = calls
-              end
-              @calls
-            end
-        end
+      EcomDev::ChefSpec::Helpers::RunnerProxy
     end
   end
 end

data/lib/ecomdev/chefspec/api/matchers/multiline_string.rb

@@ -1,38 +1,28 @@
 module ChefSpec::API
   module EcomDevMatcherMultilineString
 
-    module Matcher
-      extend self
-
-      def matcher(expected)
-        RSpec::Matchers::BuiltIn::Match.new(expected)
-      end
-
-      def regexp(match, before ='', after = '')
-        unless match.is_a?(Regexp)
-          match = ::Regexp.escape(match).tr_s('\\ ', '\\s')
-        else
-          match = match.source
-        end
-
-        ::Regexp.new(before + match + after, Regexp::MULTILINE)
-      end
-    end
-
     def start_line_with(match)
-      Matcher::matcher(Matcher::regexp(match, '^'))
+      EcomDev::ChefSpec::Helpers::StringMatcher.instance_eval do
+        matcher(regexp(match, '^'))
+      end
     end
 
     def end_line_with(match)
-      Matcher::matcher(Matcher::regexp(match, '', '$'))
+      EcomDev::ChefSpec::Helpers::StringMatcher.instance_eval do
+          matcher(regexp(match, '', '$'))
+      end
     end
 
     def contain_line(match)
-      Matcher::matcher(Matcher::regexp(match, '^.*', '.*$'))
+      EcomDev::ChefSpec::Helpers::StringMatcher.instance_eval do
+        matcher(regexp(match, '^.*', '.*$'))
+      end
     end
 
     def contain_full_line(match)
-      Matcher::matcher(Matcher::regexp(match, '^\s*', '\s*$'))
+      EcomDev::ChefSpec::Helpers::StringMatcher.instance_eval do
+        matcher(regexp(match, '^\s*', '\s*$'))
+      end
     end
   end
 end

data/lib/ecomdev/chefspec/api/stubs/file_system.rb

@@ -12,5 +12,4 @@ module ChefSpec::API::EcomDevStubsFileSystem
   def stub_file_read(file, content, *additional_args)
     EcomDev::ChefSpec::Stub::FileSystem.instance.file_read(file, content, *additional_args)
   end
-
 end

data/lib/ecomdev/chefspec/api.rb

@@ -4,4 +4,6 @@ require 'chefspec/api'
 require_relative 'api/stubs/include_recipe'
 require_relative 'api/stubs/file_system'
 require_relative 'api/matchers/multiline_string'
-require_relative 'api/helpers/runner'
+require_relative 'helpers'
+require_relative 'api/helpers/platform'
+require_relative 'api/helpers/runner'

data/lib/ecomdev/chefspec/helpers/platform.rb

@@ -0,0 +1,184 @@
+require 'pathname'
+require 'json'
+
+module EcomDev::ChefSpec::Helpers
+  class Platform
+    def initialize(file = nil, path = nil)
+      @os = {}
+      @family = {}
+
+      path ||= self.class.platform_path
+      file ||= self.class.platform_file
+
+      json_path = File.join(path, file)
+
+      if File.readable?(json_path)
+        load_json(File.read(json_path))
+      end
+    end
+
+    def load_json(json_str)
+      json = JSON.load(json_str)
+      if json.key?('os') && json['os'].is_a?(Hash)
+        json['os'].each_pair do |os, version|
+          @os[os.to_sym] ||= Array.new
+          unless version.is_a?(Array)
+            version = [version]
+          end
+          version.flatten.map {|v| v.to_s }.each do |v|
+            @os[os.to_sym] << v unless @os[os.to_sym].include?(v)
+          end
+        end
+      end
+
+      if json.key?('family') && json['family'].is_a?(Hash)
+        json['family'].each_pair do |family, os|
+          @family[family.to_sym] ||= Array.new
+          unless os.is_a?(Array)
+            os = [os]
+          end
+          os.flatten.map { |v| v.to_sym }.select { |v| @os.key?(v) }.each do |v|
+            @family[family.to_sym] << v unless @family[family.to_sym].include?(v)
+          end
+        end
+      end
+    end
+
+    # Returns list of available os versions filtered by conditions
+    #
+    # Each condition is treated as OR operation
+    # If no condition is specified all items are listed
+    # If TrueClass is supplied as one of the arguments it filters only last versions
+    #
+    def filter(*conditions)
+      latest = !conditions.select {|item| item === true }.empty?
+      filters = translate_conditions(conditions)
+      items = list(latest)
+      unless filters.empty?
+        items = items.select do |item|
+          !filters.select {|filter| match_filter(filter, item) }.empty?
+        end
+
+      end
+      items
+    end
+
+    def translate_conditions(conditions)
+      conditions.flatten!
+      previous_filter = previous_condition = nil
+      filters = []
+
+      reset_options = Proc.new do
+        previous_filter = previous_condition = nil
+      end
+
+      conditions.each do |condition|
+        unless condition.is_a?(Hash)
+          if is_version(condition) && is_os(previous_condition) && previous_filter
+            previous_filter[:version] ||= Array.new
+            previous_filter[:version] << condition.to_s
+          elsif is_os(condition)
+            previous_filter = {os: condition.to_sym}
+            filters << previous_filter
+          else
+            reset_options.call
+          end
+        else
+          reset_options.call
+          if condition.key?(:family)
+            condition[:family] = [condition[:family]] unless condition[:family].is_a?(Array)
+            condition[:family].select {|family| @family.key?(family) }.each do |family|
+              @family[family].each { |os| filters << {os: os} }
+            end
+          elsif condition.key?(:os)
+            condition[:version] ||= []
+            condition[:version] = [condition[:version]] if condition[:version].is_a?(String)
+            filters << condition
+          end
+        end
+      end
+      filters
+    end
+
+    # Returns `true` if provided value is a version string
+    # @param string [String, Symbol] value to check
+    # @return [TrueClass, FalseClass]
+    def is_version(string)
+      return false if string === false || string === true || string.nil?
+      string.to_s.match(/^\d+[\d\.a-zA-Z\-_~]*/)
+    end
+
+    # Returns `true` if provided value is a registered OS
+    # @param string [String, Symbol] value to check
+    # @return [TrueClass, FalseClass]
+    def is_os(string)
+      return false if string === false || string === true || string.nil?
+      @os.key?(string.to_sym)
+    end
+
+    # Returns true if item matches filter conditions
+    # @param filter [Hash{Symbol => String, Symbol}]
+    # @param item [Hash{Symbol => String, Symbol}]
+    # @return [true, false]
+    def match_filter(filter, item)
+      filter.each_pair do |key, value|
+        unless item.key?(key)
+          return false
+        end
+        unless value.is_a?(Array)
+          return false if value != item[key]
+        else
+          return true if value.empty?
+          return false unless value.include?(item[key])
+        end
+      end
+      true
+    end
+
+    # Mark as private internal methods
+    private :is_os, :is_version, :translate_conditions, :match_filter
+
+    # Returns list of available os versions
+    # @param [TrueClass, FalseClass] latest specify if would like to receive only latest
+    # @return [Array<Hash{Symbol => String, Symbol}>] list of os versions in view of hash
+    def list(latest = false)
+      result = []
+      @os.map do |os, versions|
+        unless latest
+          versions.each { |version| result << {os: os, version: version}}
+        else
+          result << {os: os, version: versions.last} if versions.length > 0
+        end
+      end
+      result
+    end
+
+    class << self
+      def platform_path
+        @platform_path ||= RSpec.configuration.default_path
+      end
+
+      def platform_path=(value)
+        unless value.nil?
+          value = Pathname.new value
+
+          if value.relative? && value.to_path[0] != '~'
+            value = Pathname.new File.join(RSpec.configuration.default_path, value.to_path)
+          end
+
+          value = value.to_path
+        end
+
+        @platform_path = value
+      end
+
+      def platform_file
+        @platform_file ||= 'platform.json'
+      end
+
+      def platform_file=(value)
+        @platform_file = value
+      end
+    end
+  end
+end

data/lib/ecomdev/chefspec/helpers/runner_proxy.rb

@@ -0,0 +1,137 @@
+module EcomDev::ChefSpec::Helpers
+  class RunnerProxy
+    instance_methods.each { |m| undef_method m unless m =~ /(^instance_variable_get|^initialize|^__|^send$|^object_id$)/ }
+
+    def initialize(*args, &before_initialize)
+      @args = args
+      @constructor_block = before_initialize
+      @target = nil
+      @blocks = {
+          :before => {},
+          :block => {},
+          :after => {}
+      }
+    end
+
+    def options(options = {}, override = false)
+      if @args.length == 0
+        @args << options
+        return @args[0]
+      end
+      if override
+        @args[0] = options
+      else
+        @args[0] = options.merge(@args[0])
+      end
+      @args[0]
+    end
+
+    def before(method, instance_eval = true, &block)
+      define_proxy_block(method, :before, instance_eval, &block)
+    end
+
+    def after(method, instance_eval = true, &block)
+      define_proxy_block(method, :after, instance_eval, &block)
+    end
+
+    def block(method, instance_eval = true, &block)
+      define_proxy_block(method, :block, instance_eval, &block)
+    end
+
+    def proxy_blocks
+      @blocks
+    end
+
+    def runner
+      target
+    end
+
+    # Proxied chef runner
+    protected
+    def define_proxy_block(method, type, instance_eval = true, &block)
+      if block_given?
+        @blocks[type][method] ||= Array.new
+        @blocks[type][method] << {block: block, instance_eval: instance_eval}
+      end
+    end
+
+    def block_for?(method, type)
+      @blocks.key?(type) && @blocks[type].key?(method) && @blocks[type][method].is_a?(Array)
+    end
+
+    def invoke_blocks(method, type, *args, &block)
+      blocks_to_exec = []
+      if block_given?
+        blocks_to_exec << {block: block, instance_eval: false, caller_block: true}
+      end
+
+      if block_for?(method, type)
+        blocks_to_exec.push(@blocks[type][method]).flatten!
+      end
+
+      blocks_to_exec.each do |info|
+        if info[:instance_eval]
+          target.instance_exec(*args, &info[:block])
+        else
+          calling_args = args.clone
+          unless info.key?(:caller_block) && info[:caller_block]
+            calling_args.unshift(target)
+          end
+          info[:block].call(*calling_args)
+        end
+      end
+    end
+
+    def method_missing(name, *args, &block)
+      invoke_blocks(name, :before, *args)
+      result = target.send(name, *args) do |*block_args|
+        invoke_blocks(name, :block, *block_args, &block)
+      end
+      args.unshift(result)
+      invoke_blocks(name, :after, *args)
+      result
+    end
+
+    def target
+      unless @target.nil?
+        return @target
+      end
+      block_args = nil
+      @target = ChefSpec::Runner.new(*@args) do |*args|
+        block_args = args
+      end
+      invoke_blocks(:initialize, :block, *block_args, &@constructor_block)
+      @target
+    end
+
+    class << self
+      def instance(*args, &block)
+        proxy = self.new(*args, &block)
+        proxy_calls.each do |call|
+          proxy.send(call[:method], *call[:args], &call[:block])
+        end
+        reset
+        proxy
+      end
+
+      def reset
+        proxy_calls([])
+        self
+      end
+
+      def method_missing(method, *args, &block)
+        proxy_calls.push({method: method, args: args, block: block})
+        self
+      end
+
+      private
+        def proxy_calls(calls=nil)
+          @calls ||= []
+          unless calls.nil?
+            @calls = calls
+          end
+          @calls
+        end
+    end
+  end
+end

data/lib/ecomdev/chefspec/helpers/string_matcher.rb

@@ -0,0 +1,19 @@
+module EcomDev::ChefSpec::Helpers
+  module StringMatcher
+    extend self
+
+    def matcher(expected)
+      RSpec::Matchers::BuiltIn::Match.new(expected)
+    end
+
+    def regexp(match, before ='', after = '')
+      unless match.is_a?(::Regexp)
+        match = ::Regexp.escape(match).tr_s('\\ ', '\\s')
+      else
+        match = match.source
+      end
+
+      ::Regexp.new(before + match + after, Regexp::MULTILINE)
+    end
+  end
+end

data/lib/ecomdev/chefspec/helpers.rb

@@ -0,0 +1,9 @@
+module EcomDev::ChefSpec::Helpers
+  def self.helper(helper)
+    File.join(File.dirname(__FILE__), 'helpers', helper)
+  end
+
+  autoload :RunnerProxy, helper('runner_proxy')
+  autoload :StringMatcher, helper('string_matcher')
+  autoload :Platform, helper('platform')
+end

data/lib/ecomdev/chefspec/resource/matcher/dsl.rb

@@ -13,7 +13,9 @@ module EcomDev
 
            def self.load(filename)
              dsl = new
-             dsl.instance_eval(File.read(filename), filename)
+             content = File.read(filename)
+             content.taint
+             dsl.instance_eval(content, filename)
              dsl
            end
         end

data/lib/ecomdev/chefspec/version.rb

@@ -1,6 +1,6 @@
 
 module EcomDev
   module ChefSpec
-    VERSION = '0.1.2'
+    VERSION = '0.1.3'
   end
 end

data/lib/ecomdev/chefspec.rb

@@ -2,5 +2,6 @@ require 'chefspec' unless defined?(ChefSpec) # Require chef spec only if it is n
 
 require_relative 'chefspec/version'
 require_relative 'chefspec/configuration'
+require_relative 'chefspec/helpers'
 require_relative 'chefspec/resource/matcher'
 require_relative 'chefspec/api'

data/spec/unit/api/helpers/platform_spec.rb

@@ -0,0 +1,35 @@
+describe 'extends to base example group' do
+  platform_load('platforms.json', File.dirname(__FILE__))
+
+  platform(true) do |name, version|
+    context 'In scope of ' + name + ' ' + version + ' ' do
+      it 'does crazy things' do
+        expect(true).to eq(true)
+      end
+    end
+  end
+
+  platform(:ubuntu, :debian) do |name, version|
+    context 'In filtered scope of ' + name + ' ' + version + ' ' do
+      it 'does another crazy things' do
+        expect(true).to eq(true)
+      end
+    end
+  end
+
+  platform(family: [:debian]) do |name, version|
+    context 'In family filtered scope of ' + name + ' ' + version + ' ' do
+      it 'does another crazy things' do
+        expect(true).to eq(true)
+      end
+    end
+  end
+
+  platform({family: [:debian]}, true) do |name, version|
+    context 'In family filtered scope of latest ' + name + '' do
+      it 'does another crazy things on version ' + version do
+        expect(true).to eq(true)
+      end
+    end
+  end
+end

data/spec/unit/api/helpers/platforms.json

@@ -0,0 +1,16 @@
+{
+    "os": {
+        "ubuntu": ["10.04", "12.04", "13.10", "14.04"],
+        "debian": ["6.0.5", "7.2", "7.4"],
+        "freebsd": ["9.2"],
+        "centos": ["5.8","6.4", "6.5"],
+        "redhat": ["5.6", "6.3", "6.4"],
+        "fedora": ["18", "19", "20"]
+    },
+    "family": {
+        "debian": ["ubuntu", "debian"],
+        "rhel": ["redhat", "centos"],
+        "fedora": ["fedora"],
+        "freebsd": ["freebsd"]
+    }
+}

data/spec/unit/api/helpers/runner_spec.rb

@@ -1,6 +1,6 @@
 
 describe ChefSpec::API::EcomDevHelpersRunner do
   it 'returns a chef runner proxy class' do
-    expect(chef_run_proxy).to eq(described_class::RunnerProxy)
+    expect(chef_run_proxy).to eq(EcomDev::ChefSpec::Helpers::RunnerProxy)
   end
 end

data/spec/unit/helpers/platform_spec.rb

@@ -0,0 +1,193 @@
+describe EcomDev::ChefSpec::Helpers::Platform do
+  before (:each) do
+    described_class.platform_path = nil
+    described_class.platform_file = nil
+  end
+
+  let (:json_data) { '{"os": {"ubuntu": [14.01, 12.04], "debian": 6, "freebsd": 3.4}, "family": {"debian": ["ubuntu", "debian", "unknown"], "freebsd": ["freebsd"]}}' }
+  let (:os) { {ubuntu: %w(14.01 12.04), debian: %w(6), freebsd: %w(3.4)} }
+  let (:family) { {debian: [:ubuntu, :debian], freebsd: [:freebsd]}}
+
+  describe '#platform_path' do
+    it 'equals to rspec directory by default' do
+      expect(described_class.platform_path).to eq(RSpec.configuration.default_path)
+    end
+
+    it 'makes possible to read from default path' do
+      expect(File.directory?(described_class.platform_path)).to eq(true)
+    end
+  end
+
+  describe '#platform_path=' do
+    it 'sets platform path to relative path within specs directory' do
+      described_class.platform_path = 'relative'
+      expect(described_class.platform_path).to eq(File.join(RSpec.configuration.default_path, 'relative'))
+    end
+
+    it 'sets platform path to absolute path if absolute path value is specified' do
+      described_class.platform_path = '~/chefspec'
+      expect(described_class.platform_path).to eq('~/chefspec')
+    end
+  end
+
+  describe '#platform_file' do
+    it 'equals to platform.json by default' do
+      expect(described_class.platform_file).to eq('platform.json')
+    end
+  end
+
+  describe '#platform_file=' do
+    it 'equals to platform.json by default' do
+      described_class.platform_file = 'custom.json'
+      expect(described_class.platform_file).to eq('custom.json')
+    end
+  end
+
+  describe '#initialize' do
+    it 'loads platform list from JSON file' do
+      expect(described_class).to receive(:platform_file).and_return('custom.json')
+      expect(described_class).to receive(:platform_path).and_return('/custom/files')
+
+      expect(File).to receive(:readable?).with(File.join('/custom/files', 'custom.json')).and_return(true)
+      expect(File).to receive(:read).with(File.join('/custom/files', 'custom.json'))
+                      .and_return(json_data)
+      expect_any_instance_of(described_class).to receive(:load_json).with(json_data)
+      described_class.new
+    end
+
+    it 'loads platform list from JSON file specified in arguments' do
+      expect(described_class).not_to receive(:platform_file)
+      expect(described_class).to receive(:platform_path).and_return('/custom/files')
+
+      expect(File).to receive(:readable?).with(File.join('/custom/files', 'custom.json')).and_return(true)
+      expect(File).to receive(:read).with(File.join('/custom/files', 'custom.json'))
+                      .and_return(json_data)
+      expect_any_instance_of(described_class).to receive(:load_json).with(json_data)
+      described_class.new('custom.json')
+    end
+
+    it 'loads platform list from JSON file that is specified in arguments with path' do
+      expect(described_class).not_to receive(:platform_file)
+      expect(described_class).not_to receive(:platform_path)
+
+      expect(File).to receive(:readable?).with(File.join('/custom/files', 'custom.json')).and_return(true)
+      expect(File).to receive(:read).with(File.join('/custom/files', 'custom.json'))
+                      .and_return(json_data)
+      expect_any_instance_of(described_class).to receive(:load_json).with(json_data)
+      described_class.new('custom.json', '/custom/files')
+    end
+
+    it 'does not load any json file, if file is not readable' do
+      expect(described_class).to receive(:platform_file).and_return('custom.json')
+      expect(described_class).to receive(:platform_path).and_return('/custom/files')
+
+      expect(File).to receive(:readable?).with(File.join('/custom/files', 'custom.json')).and_return(false)
+      expect_any_instance_of(described_class).not_to receive(:load_json)
+      described_class.new
+    end
+  end
+
+  describe '#load_json' do
+    it 'loads json structure into os and family properties' do
+      platform = described_class.new
+
+      expect(platform.instance_variable_get(:@os)).to be_instance_of(Hash).and be_empty
+      expect(platform.instance_variable_get(:@family)).to be_instance_of(Hash).and be_empty
+
+      platform.load_json(json_data)
+
+      expect(platform.instance_variable_get(:@os)).to eq(os)
+      expect(platform.instance_variable_get(:@family)).to eq(family)
+    end
+  end
+
+  describe '#filter' do
+    it 'it filters by os names in string' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.filter('ubuntu', :debian)).to eq([{os: :ubuntu, version: '14.01'},
+                                                        {os: :ubuntu, version: '12.04'},
+                                                        {os: :debian, version: '6'}])
+
+
+    end
+
+    it 'it filters by os name and version' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.filter('debian', '6')).to eq([os: :debian, version: '6'])
+    end
+
+    it 'it filters by os version hash' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.filter(:os => :debian, :version => '6')).to eq([{os: :debian, version: '6'}])
+    end
+
+    it 'accepts multiple hashes' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.filter(
+                 {:os => :debian, :version => '6'},
+                 {:os => :freebsd}
+             )).to eq([{os: :debian, version: '6'}, {os: :freebsd, version: '3.4'}])
+    end
+
+    it 'accepts multiple string symbol conditions' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.filter(:debian, '6', 'freebsd')).to eq([{os: :debian, version: '6'}, {os: :freebsd, version: '3.4'}])
+    end
+
+
+    it 'it filters by os family' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.filter(:family => :debian)).to eq([{os: :ubuntu, version: '14.01'},
+                                                         {os: :ubuntu, version: '12.04'},
+                                                         {os: :debian, version: '6'}])
+
+      expect(platform.filter(:family => [:debian, :freebsd])).to eq([{os: :ubuntu, version: '14.01'},
+                                                                     {os: :ubuntu, version: '12.04'},
+                                                                     {os: :debian, version: '6'},
+                                                                     {os: :freebsd, version: '3.4'}])
+    end
+  end
+
+  describe '#list' do
+    it 'it lists all os systems' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      expect(platform.list).to eq([{os: :ubuntu, version: '14.01'},
+                                   {os: :ubuntu, version: '12.04'},
+                                   {os: :debian, version: '6'},
+                                   {os: :freebsd, version: '3.4'}])
+
+    end
+
+    it 'it lists only latest os versions' do
+      platform = described_class.new
+      platform.instance_variable_set(:@os, os)
+      platform.instance_variable_set(:@family, family)
+
+      # NOTE: it should return last item of array, not latest version by number
+      expect(platform.list(true)).to eq([{os: :ubuntu, version: '12.04'},
+                                         {os: :debian, version: '6'},
+                                         {os: :freebsd, version: '3.4'}])
+    end
+  end
+end

data/spec/unit/{api/helpers/runner/proxy_spec.rb → helpers/runner_proxy_spec.rb}

@@ -1,5 +1,5 @@
 
-describe ChefSpec::API::EcomDevHelpersRunner::RunnerProxy do
+describe EcomDev::ChefSpec::Helpers::RunnerProxy do
   it 'does not create any method unless method of runner is executed' do
     runner_proxy = described_class.new
     expect(runner_proxy.instance_variable_get('@target')).to be_nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ecomdev-chefspec
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Ivan Chepurnyi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-21 00:00:00.000000000 Z
+date: 2014-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chefspec
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -71,11 +85,16 @@ files:
 - lib/ecomdev-chefspec.rb
 - lib/ecomdev/chefspec.rb
 - lib/ecomdev/chefspec/api.rb
+- lib/ecomdev/chefspec/api/helpers/platform.rb
 - lib/ecomdev/chefspec/api/helpers/runner.rb
 - lib/ecomdev/chefspec/api/matchers/multiline_string.rb
 - lib/ecomdev/chefspec/api/stubs/file_system.rb
 - lib/ecomdev/chefspec/api/stubs/include_recipe.rb
 - lib/ecomdev/chefspec/configuration.rb
+- lib/ecomdev/chefspec/helpers.rb
+- lib/ecomdev/chefspec/helpers/platform.rb
+- lib/ecomdev/chefspec/helpers/runner_proxy.rb
+- lib/ecomdev/chefspec/helpers/string_matcher.rb
 - lib/ecomdev/chefspec/resource/matcher.rb
 - lib/ecomdev/chefspec/resource/matcher/dsl.rb
 - lib/ecomdev/chefspec/resource/matcher/helper.rb
@@ -83,12 +102,15 @@ files:
 - lib/ecomdev/chefspec/stub/include_recipe.rb
 - lib/ecomdev/chefspec/version.rb
 - spec/spec_helper.rb
-- spec/unit/api/helpers/runner/proxy_spec.rb
+- spec/unit/api/helpers/platform_spec.rb
+- spec/unit/api/helpers/platforms.json
 - spec/unit/api/helpers/runner_spec.rb
 - spec/unit/api/matchers/multiline_string_spec.rb
 - spec/unit/api/stubs/file_system_spec.rb
 - spec/unit/api/stubs/include_recipe_spec.rb
 - spec/unit/configuration_spec.rb
+- spec/unit/helpers/platform_spec.rb
+- spec/unit/helpers/runner_proxy_spec.rb
 - spec/unit/matcher/dsl_spec.rb
 - spec/unit/matcher/helper_spec.rb
 - spec/unit/matcher_spec.rb
@@ -120,12 +142,15 @@ specification_version: 4
 summary: A collection of helpers for chef spec, to make easier writing recipe specs
 test_files:
 - spec/spec_helper.rb
-- spec/unit/api/helpers/runner/proxy_spec.rb
+- spec/unit/api/helpers/platform_spec.rb
+- spec/unit/api/helpers/platforms.json
 - spec/unit/api/helpers/runner_spec.rb
 - spec/unit/api/matchers/multiline_string_spec.rb
 - spec/unit/api/stubs/file_system_spec.rb
 - spec/unit/api/stubs/include_recipe_spec.rb
 - spec/unit/configuration_spec.rb
+- spec/unit/helpers/platform_spec.rb
+- spec/unit/helpers/runner_proxy_spec.rb
 - spec/unit/matcher/dsl_spec.rb
 - spec/unit/matcher/helper_spec.rb
 - spec/unit/matcher_spec.rb