natives-catalog 0.2.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MGNiODNjNGQzM2M3MGZhNzM1OTRkNzI1ZjI2Mzk2ODAzMWIyNzdmMg==
+  data.tar.gz: !binary |-
+    MTM5OWQwZDQ0Yzc0MmNjNjJkZGJjNTZmMDVmNTNjNjc2YWY3ZTc4Nw==
+SHA512:
+  metadata.gz: !binary |-
+    M2M1MDM3Yjc4YTNlMTZmYjUxMzEzZTk1ODAyM2FhYjk5Yjk4MWIyMDRiZGFj
+    Yjc2N2EzMDk3ZDY4OTlmNDFjNzIwZGVmZTI4YjY1NTNlNGY4NTY4OWQxMmI1
+    OGFhOWRkYjE5OWI5NDNhZTFlYTc5NTYwZjBiNWI1MjQyNzI2M2Q=
+  data.tar.gz: !binary |-
+    ZDM2ZGVjMDc1OTE0MjdkOTQ2YWI0MGJhMDZkZDA0Y2EyYjk5YWIwY2UxYzg5
+    MTY5YWQwYWNjMTE4M2U2M2M3MjRhOGRjN2JiMWU3NjRmYWJjNDRmYmJhOGRh
+    NTYxOTUxOGRkOWNiOTU1ZTU5MmU3ZGE2YTFjNzZmY2FlODgxNTY=

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,16 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+gem "chef", '>= 11'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec"
+  gem "yard"
+  gem "rdoc"
+  gem "bundler"
+  gem "jeweler"
+  gem "debugger"
+  gem "simplecov"
+end

data/Gemfile.lock

@@ -0,0 +1,120 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.5)
+    builder (3.2.2)
+    chef (11.6.2)
+      erubis (~> 2.7)
+      highline (~> 1.6, >= 1.6.9)
+      json (>= 1.4.4, <= 1.7.7)
+      mixlib-authentication (~> 1.3)
+      mixlib-cli (~> 1.3)
+      mixlib-config (~> 1.1, >= 1.1.2)
+      mixlib-log (~> 1.3)
+      mixlib-shellout (~> 1.1)
+      net-ssh (~> 2.6)
+      net-ssh-multi (~> 1.1.0)
+      ohai (>= 0.6.0, < 7.0.0)
+      rest-client (>= 1.0.4, < 1.7.0)
+      yajl-ruby (~> 1.1)
+    columnize (0.3.6)
+    debugger (1.6.1)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.2.0)
+      debugger-ruby_core_source (~> 1.2.3)
+    debugger-linecache (1.2.0)
+    debugger-ruby_core_source (1.2.3)
+    diff-lcs (1.2.4)
+    erubis (2.7.0)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.19)
+    httpauth (0.2.0)
+    ipaddress (0.8.0)
+    jeweler (1.8.8)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.7.7)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    mime-types (1.25)
+    mixlib-authentication (1.3.0)
+      mixlib-log
+    mixlib-cli (1.3.0)
+    mixlib-config (1.1.2)
+    mixlib-log (1.6.0)
+    mixlib-shellout (1.2.0)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    net-ssh (2.7.0)
+    net-ssh-gateway (1.2.0)
+      net-ssh (>= 2.6.5)
+    net-ssh-multi (1.1)
+      net-ssh (>= 2.1.4)
+      net-ssh-gateway (>= 0.99.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    ohai (6.18.0)
+      ipaddress
+      mixlib-cli
+      mixlib-config
+      mixlib-log
+      mixlib-shellout
+      systemu
+      yajl-ruby
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.5)
+    rspec-expectations (2.14.3)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.3)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    systemu (2.5.2)
+    yajl-ruby (1.1.0)
+    yard (0.8.7.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  chef (>= 11)
+  debugger
+  jeweler
+  rdoc
+  rspec
+  simplecov
+  yard

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Huiming Teo
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,19 @@
+# natives-catalog
+
+Description goes here.
+
+## Contributing to natives-catalog
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2013 Huiming Teo. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,41 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "natives-catalog"
+  gem.homepage = "http://github.com/teohm/natives-catalog"
+  gem.license = "MIT"
+  gem.summary = %Q{A catalog of native packages for ruby gems.}
+  gem.description = %Q{A catalog of native packages in different platforms required by ruby gems.}
+  gem.email = "teohuiming@gmail.com"
+  gem.authors = ["Huiming Teo"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:coverage) do |spec|
+  ENV['COVERAGE'] = 'true'
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/catalogs/rubygems.yaml

@@ -0,0 +1,11 @@
+rubygems:
+  capybara-webkit:
+    mac_os_x/macports:
+      default:
+        - qt4-mac-devel
+    mac_os_x/homebrew:
+      default:
+        - qt
+    ubuntu/apt:
+      default:
+        - libqtwebkit-dev

data/lib/natives/catalog.rb

@@ -0,0 +1,43 @@
+require 'natives/catalog/loader'
+require 'natives/catalog/selector'
+
+module Natives
+  class Catalog
+
+    CATALOG_PATH_IN_GEM = File.absolute_path(File.join(
+                            File.dirname(__FILE__), '..', '..', 'catalogs'))
+    CATALOG_PATH_IN_WORKING_DIR = File.absolute_path(File.join('.', 'natives-catalogs'))
+
+    CATALOG_PATHS = [
+      CATALOG_PATH_IN_GEM,
+      CATALOG_PATH_IN_WORKING_DIR
+    ].freeze
+
+    attr_reader :platform, :platform_version, :package_provider, :name
+
+    def initialize(catalog_name, platform, platform_version, package_provider)
+      reload
+
+      @name = catalog_name.to_s
+      @platform = platform.to_s
+      @platform_version = platform_version.to_s
+      @package_provider = package_provider.to_s
+    end
+
+    def reload
+      @catalogs = Loader.new.load_from_paths(CATALOG_PATHS)
+    end
+
+    def to_hash
+      @catalogs.fetch(self.name, {})
+    end
+
+    def native_packages_for(entry_name)
+      Array(
+        Selector.new(self.to_hash.fetch(entry_name, {})).
+          value_for(@platform, @platform_version, @package_provider)
+      )
+    end
+
+  end
+end

data/lib/natives/catalog/loader.rb

@@ -0,0 +1,30 @@
+require 'natives/catalog/merger'
+require 'yaml'
+
+module Natives
+  class Catalog
+    class Loader
+      def initialize(opts={})
+        @merger = opts.fetch(:merger, Merger.new)
+      end
+
+      def load_from_paths(paths)
+        master_hash = {}
+        Array(paths).each do |path|
+          yaml_files_in_path(path).sort.each do |file|
+            @merger.merge_catalog!(master_hash, load_yaml_file(file))
+          end
+        end
+        master_hash
+      end
+
+      def yaml_files_in_path(path)
+        Dir.glob(File.join(path, '*.{yml,yaml}'))
+      end
+
+      def load_yaml_file(filename)
+        YAML.load_file(filename)
+      end
+    end
+  end
+end

data/lib/natives/catalog/merger.rb

@@ -0,0 +1,26 @@
+require 'natives/catalog/validator'
+
+module Natives
+  class Catalog
+    class Merger
+      def initialize(opts={})
+        @validator = opts.fetch(:validator, Validator.new)
+      end
+
+      def merge_catalog!(master_hash, hash_to_merge)
+        @validator.ensure_valid_catalog_groups(master_hash)
+        @validator.ensure_valid_catalog_groups(hash_to_merge)
+
+        hash_to_merge.each do |group_name, entries|
+          if master_hash.key? group_name
+            master_hash[group_name].merge! entries
+          else
+            master_hash[group_name] = entries
+          end
+        end
+
+        master_hash
+      end
+    end
+  end
+end

data/lib/natives/catalog/selector.rb

@@ -0,0 +1,79 @@
+module Natives
+  class Catalog
+    class Selector
+      def initialize(platform_hash)
+        assert_valid_platform_hash(platform_hash)
+        @values = normalize_platform_hash(platform_hash)
+      end
+
+      def value_for(platform, platform_version, package_provider)
+        key = "#{platform.to_s}/#{package_provider.to_s}"
+        if @values.key?(key) && @values[key].key?(platform_version)
+          @values[key][platform_version]
+        elsif @values.key?(key) && @values[key].key?('default')
+          @values[key]['default']
+        elsif @values.key?('default')
+          @values['default']
+        else
+          nil
+        end
+      end
+
+      protected
+
+      def normalize_platform_hash(platform_hash)
+        normalized_hash = {}
+        platform_hash.each do |keys, value|
+          if keys.to_s == 'default'
+            normalized_hash['default'] = value
+          else
+            Array(keys).each do |key|
+              normalized_hash[key.to_s] = normalize_keys(value)
+            end
+          end
+        end
+        normalized_hash
+      end
+
+      def normalize_keys(hash)
+        normalized_hash = {}
+        hash.each do |keys, value|
+          Array(keys).each do |key|
+            normalized_hash[key.to_s] = value
+          end
+        end
+        normalized_hash
+      end
+
+      def assert_valid_platform_hash(platform_hash)
+        unless platform_hash.kind_of? Hash
+          raise ArgumentError, 'catalog entry should be a hash'
+        end
+
+        platform_hash.each do |platforms, value|
+          assert_valid_key_and_value(platforms, value)
+        end
+      end
+
+      def assert_valid_key_and_value(platforms, value)
+        return if platforms.to_s == 'default'
+
+        keys = platforms.kind_of?(Array) ? platforms : [platforms]
+        keys.each do |key|
+          if (%r{\A.+/.+\Z} =~ key.to_s) == nil && key.to_s != 'default'
+            msg = "Found an invalid key: #{key.inspect}. "
+            msg << "A valid key should be in this format: 'platform/package_provider'."
+            raise ArgumentError, msg
+          end
+        end
+
+        unless value.kind_of? Hash
+          msg = "Found an invalid value: #{value.inspect} "
+          msg << "for key: #{platforms.inspect}. The value should be a Hash."
+          raise ArgumentError, msg
+        end
+      end
+
+    end
+  end
+end

data/lib/natives/catalog/validator.rb

@@ -0,0 +1,18 @@
+module Natives
+  class Catalog
+    class Validator
+      def ensure_valid_catalog_groups(hash)
+        unless hash.kind_of? Hash
+          raise ArgumentError, 'catalog should be a Hash'
+        end
+
+        invalid_groups = hash.select {|key, value| !value.kind_of?(Hash) }
+        unless invalid_groups.empty?
+          group_names = invalid_groups.keys
+          raise ArgumentError,
+            "The following catalog group(s) should be a Hash: #{group_names.join(', ')}"
+        end
+      end
+    end
+  end
+end

data/natives-catalog.gemspec

@@ -0,0 +1,88 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+# stub: natives-catalog 0.2.0 ruby lib
+
+Gem::Specification.new do |s|
+  s.name = "natives-catalog"
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Huiming Teo"]
+  s.date = "2013-10-24"
+  s.description = "A catalog of native packages in different platforms required by ruby gems."
+  s.email = "teohuiming@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "catalogs/rubygems.yaml",
+    "lib/natives-catalog.rb",
+    "lib/natives/catalog.rb",
+    "lib/natives/catalog/loader.rb",
+    "lib/natives/catalog/merger.rb",
+    "lib/natives/catalog/selector.rb",
+    "lib/natives/catalog/validator.rb",
+    "natives-catalog.gemspec",
+    "spec/fixtures/dir_with_matching_files/invalid1.yml",
+    "spec/fixtures/dir_with_matching_files/not_matching.json",
+    "spec/fixtures/dir_with_matching_files/valid1.yaml",
+    "spec/fixtures/dir_with_matching_files/valid2.yml",
+    "spec/fixtures/dir_without_matching_file/not_matching.json",
+    "spec/natives/catalog/loader_spec.rb",
+    "spec/natives/catalog/merger_spec.rb",
+    "spec/natives/catalog/selector_spec.rb",
+    "spec/natives/catalog/validator_spec.rb",
+    "spec/natives/catalog_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = "http://github.com/teohm/natives-catalog"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.1.9"
+  s.summary = "A catalog of native packages for ruby gems."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<chef>, [">= 11"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<debugger>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<chef>, [">= 11"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<debugger>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<chef>, [">= 11"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<debugger>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/spec/fixtures/dir_with_matching_files/invalid1.yml

@@ -0,0 +1,9 @@
+rubygems:
+  invalid_line
+    ubuntu/apt:
+      default:
+        - imagemagick
+        - libmagick9-dev
+  curb:
+    default:
+      - curl

data/spec/fixtures/dir_with_matching_files/valid1.yaml

@@ -0,0 +1,21 @@
+rubygems:
+  capybara-webkit:
+    mac_os_x/macports:
+      default:
+        - qt4-mac-devel
+    mac_os_x/homebrew:
+      default:
+        - qt
+    ubuntu/apt:
+      default:
+        - libqtwebkit-dev
+      [10.04,10.04.1,10.04.2,10.04.3,10.04.4]:
+        - libqt4-dev
+  rmagick:
+    mac_os_x/homebrew:
+      default:
+        - imagemagick
+    ubuntu/apt:
+      default:
+        - imagemagick
+        - libmagick9-dev

data/spec/fixtures/dir_with_matching_files/valid2.yml

@@ -0,0 +1,9 @@
+rubygems:
+  rmagick:
+    ubuntu/apt:
+      default:
+        - imagemagick
+        - libmagick9-dev
+  curb:
+    default:
+      - curl

data/spec/natives/catalog/loader_spec.rb

@@ -0,0 +1,101 @@
+require 'spec_helper'
+require 'natives/catalog/loader'
+
+describe Natives::Catalog::Loader do
+  describe "#load_from_paths" do
+    let(:loader) { Natives::Catalog::Loader.new }
+
+    it "loads files in catalog paths, in the order of given paths and sorted filenames" do
+      files = {
+        '/to/path1' => ['/to/path1/file1.yaml'],
+        '/to/path2' => ['/to/path2/file2.yaml', '/to/path2/file1.yaml'],
+        '/to/path3' => ['/to/path3/file2.yaml', '/to/path3/file1.yaml', '/to/path3/file3.yaml']
+      }
+      catalog_hashes = {
+        '/to/path1/file1.yaml' => {"rubygems" => { "p" => "p1f1", "p1" => "p1f1", "p1f1" => "" } },
+        '/to/path2/file1.yaml' => {"rubygems" => { "p" => "p2f1", "p2" => "p2f1", "p2f1" => "" } },
+        '/to/path2/file2.yaml' => {"rubygems" => { "p" => "p2f2", "p2" => "p2f2", "p2f2" => "" } },
+        '/to/path3/file1.yaml' => {"rubygems" => { "p" => "p3f1", "p3" => "p3f1", "p3f1" => "" } },
+        '/to/path3/file2.yaml' => {"rubygems" => { "p" => "p3f2", "p3" => "p3f2", "p3f2" => "" } },
+        '/to/path3/file3.yaml' => {"rubygems" => { "p" => "p3f3", "p3" => "p3f3", "p3f3" => "" } }
+      }
+      loader.stub(:yaml_files_in_path) { |path| files[path] }
+      loader.stub(:load_yaml_file) {|file| catalog_hashes[file] }
+
+      given_catalog_paths = ['/to/path3', '/to/path1', '/to/path2']
+      expected_hash = {
+        "rubygems" => {
+          "p" => "p2f2",
+          "p1" => "p1f1",
+          "p2" => "p2f2",
+          "p3" => "p3f3",
+          "p1f1" => "",
+          "p2f1" => "",
+          "p2f2" => "",
+          "p3f1" => "",
+          "p3f2" => "",
+          "p3f3" => ""
+        }
+      }
+
+      actual_hash = loader.load_from_paths(given_catalog_paths)
+      expect(actual_hash).to include(expected_hash)
+    end
+
+  end
+
+  describe "#yaml_files_in_path" do
+    let(:loader) { Natives::Catalog::Loader.new }
+
+    it "returns a list of *.yml *.yaml filenames in the given path" do
+      path = File.join(RSpec.configuration.fixture_path, 'dir_with_matching_files')
+      filenames = loader.yaml_files_in_path(path)
+      expected_filenames = [
+        File.join(path, 'invalid1.yml'),
+        File.join(path, 'valid1.yaml'),
+        File.join(path, 'valid2.yml')
+      ]
+      expect(filenames.sort).to eq(expected_filenames.sort)
+    end
+
+    it "returns empty list if there is no matching file in the given path" do
+      path = File.join(RSpec.configuration.fixture_path, 'dir_without_matching_file')
+      filenames = loader.yaml_files_in_path(path)
+      expect(filenames).to eq([])
+    end
+
+    it "returns empty list if the given path does not exist" do
+      path = File.join(RSpec.configuration.fixture_path, 'dir_not_exists')
+      filenames = loader.yaml_files_in_path(path)
+      expect(filenames).to eq([])
+    end
+  end
+
+  describe "#load_yaml_file" do
+    let(:loader) { Natives::Catalog::Loader.new }
+
+    it "loads the given file as YAML" do
+      valid_file = File.join(RSpec.configuration.fixture_path,
+        'dir_with_matching_files', 'valid1.yaml')
+
+      hash = loader.load_yaml_file(valid_file)
+
+      expect(hash).to include("rubygems")
+    end
+
+    it "raises error when the given file contains invalid YAML" do
+      valid_file = File.join(RSpec.configuration.fixture_path,
+        'dir_with_matching_files', 'invalid1.yml')
+
+      expect {
+        loader.load_yaml_file(valid_file)
+      }.to raise_error
+    end
+
+    it "raises error when the given file does not exist" do
+      expect {
+        loader.load_yaml_file("file_not_exists.yaml")
+      }.to raise_error
+    end
+  end
+end

data/spec/natives/catalog/merger_spec.rb

@@ -0,0 +1,60 @@
+require 'spec_helper'
+require 'natives/catalog/merger'
+
+describe Natives::Catalog::Merger do
+
+  describe "#merge_catalog!" do
+    let(:merger) { Natives::Catalog::Merger.new }
+
+    it "validates both master_hash and hash_to_merge" do
+      master_hash = {}
+      hash_to_merge = {"rubygems" => {}}
+      validator = double("Natives::Catalog::Validator")
+      merger = Natives::Catalog::Merger.new(validator: validator)
+
+      validator.should_receive(:ensure_valid_catalog_groups).with(master_hash)
+      validator.should_receive(:ensure_valid_catalog_groups).with(hash_to_merge)
+
+      merger.merge_catalog!(master_hash, hash_to_merge)
+    end
+
+    it "returns master_hash" do
+      master_hash = {}
+      expect(merger.merge_catalog!(master_hash, {})).to equal(master_hash)
+    end
+
+    it "adds new catalog group into master_hash" do
+      master_hash = {}
+      hash_to_merge = {"rubygems" => {}}
+
+      merger.merge_catalog!(master_hash, hash_to_merge)
+
+      expect(master_hash).to include("rubygems" => {})
+    end
+
+    it "adds new entries into existing catalog group" do
+      master_hash = {"rubygems" => { "curb" => {} }}
+      hash_to_merge = {"rubygems" => { "nokogiri" => {} }}
+
+      merger.merge_catalog!(master_hash, hash_to_merge)
+
+      expect(master_hash).to include(
+        "rubygems" => {"curb" => {}, "nokogiri" => {}})
+    end
+
+    it "replaces existing entries in existing catalog group" do
+      master_hash = {"rubygems" => {
+                         "webkit-capybara" => {},
+                         "curb" => {} }}
+      hash_to_merge = {"rubygems" => {
+                         "curb" => {"foo" => "bar"}, "nokogiri" => {} }}
+
+      merger.merge_catalog!(master_hash, hash_to_merge)
+
+      expect(master_hash).to include(
+        "rubygems" => {
+          "webkit-capybara" => {},
+          "curb" => {"foo" => "bar"}, "nokogiri" => {}})
+    end
+  end
+end

data/spec/natives/catalog/selector_spec.rb

@@ -0,0 +1,124 @@
+require 'spec_helper'
+require 'natives/catalog/selector'
+
+describe Natives::Catalog::Selector do
+  describe "#new" do
+
+    describe "assert valid platform hash" do
+      it "raises error if platform hash is not a hash" do
+        expect {
+          Natives::Catalog::Selector.new(nil)
+        }.to raise_error(ArgumentError, "catalog entry should be a hash")
+      end
+
+      it "raises error when found an invalid string as hash key" do
+        expect {
+          Natives::Catalog::Selector.new({
+            "mac_os_x/homebrew" => {"default" => "value"},
+            "ubuntu" => {"default" => "value"},
+            "debian" => {"default" => "value"}
+          })
+        }.to raise_error ArgumentError, /Found an invalid key: "ubuntu"/
+      end
+
+      it "raises error when found an invalid array as hash key" do
+        expect {
+          Natives::Catalog::Selector.new({
+            ["fedora/yum", "redhat/yum"] => {"default" => "value"},
+            ["centos/yum", "oracle"] => {"default" => "value"},
+          })
+        }.to raise_error ArgumentError, /Found an invalid key: "oracle"/
+      end
+
+      it "raises error if platform hash's value is not a hash" do
+        expect {
+          Natives::Catalog::Selector.new({
+            "ubuntu/apt" => "value",
+            "mac_os_x/homebrew" => {"default" => "value"},
+          })
+        }.to raise_error ArgumentError, /Found an invalid value: "value"/
+      end
+
+      it "accepts default platform value" do
+        expect {
+          Natives::Catalog::Selector.new({
+            "default" => "value"
+          })
+        }.not_to raise_error
+      end
+    end
+
+    describe "normalize platform hash" do
+      class ProxySelector < Natives::Catalog::Selector
+        def normalized_values
+          @values
+        end
+      end
+
+      it "expand platform array" do
+        expect(ProxySelector.new({
+          "mac_os_x/homebrew" => {"default" => "value1"},
+          ["ubuntu/apt", "debian/apt"] => {"default" => "value2"}
+        }).normalized_values).to eq({
+          "mac_os_x/homebrew" => {"default" => "value1"},
+          "ubuntu/apt" => {"default" => "value2"},
+          "debian/apt" => {"default" => "value2"}
+        })
+      end
+
+      it "expand version array" do
+        expect(ProxySelector.new({
+          "mac_os_x/homebrew" => {
+            "default" => "value1",
+            ["v1", "v2"] => "value2"
+          }
+        }).normalized_values).to eq({
+          "mac_os_x/homebrew" => {
+            "default" => "value1",
+            "v1" => "value2",
+            "v2" => "value2"
+          }
+        })
+      end
+    end
+  end
+
+  describe "#value_for" do
+    it "returns the default value when the platform/package_provider doesn't match" do
+      expect(
+        Natives::Catalog::Selector.new({
+          "ubuntu/apt" => {"default" => "libcurl"},
+          "default" => "curl"
+        }).value_for('mac_os_x', '10.7.5', 'homebrew')
+      ).to eq('curl')
+    end
+
+    it "returns a value for a specific platform version" do
+      expect(
+        Natives::Catalog::Selector.new({
+          ["mac_os_x/homebrew", "mac_os_x/macports"] => {
+            "10.7.5" => "curl", "default" => "foo"},
+          "default" => "bar"
+        }).value_for('mac_os_x', '10.7.5', 'homebrew')
+      ).to eq('curl')
+    end
+
+    it "returns a platform-default value if the platform version doesn't match an explicit one" do
+      expect(
+        Natives::Catalog::Selector.new({
+          "mac_os_x/homebrew" => {
+            "10.7.5" => "curl", "default" => "foo"},
+          "default" => "bar"
+        }).value_for('mac_os_x', '10.8.0', 'homebrew')
+      ).to eq('foo')
+    end
+
+    it "returns nil if there is no default and no platforms match" do
+      expect(
+        Natives::Catalog::Selector.new({
+          ["mac_os_x/homebrew", "mac_os_x/macports"] => {"10.7.5" => "curl"}
+        }).value_for('mac_os_x', '10.8.0', 'homebrew')
+      ).to be_nil
+    end
+  end
+end

data/spec/natives/catalog/validator_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+require 'natives/catalog/validator'
+
+describe Natives::Catalog::Validator do
+
+  describe "#ensure_valid_catalog_groups" do
+    let(:validator) { Natives::Catalog::Validator.new }
+
+    it "ensures catalog groups is a hash" do
+      expect {
+        validator.ensure_valid_catalog_groups({"rubygems" => {} })
+      }.not_to raise_error
+    end
+
+    it "raises error if catalog groups is not a hash" do
+      expect {
+        validator.ensure_valid_catalog_groups([])
+      }.to raise_error ArgumentError
+    end
+
+    it "allows catalog groups to be empty" do
+      expect {
+        validator.ensure_valid_catalog_groups({})
+      }.not_to raise_error
+    end
+
+    it "ensures each catalog group's value is a hash" do
+      expect {
+        validator.ensure_valid_catalog_groups({"rubygems" => {"a" => "b"} })
+      }.not_to raise_error
+    end
+
+    it "raises error if any catalog group's value is not a hash" do
+      expect {
+        validator.ensure_valid_catalog_groups({
+          "rubygems" => {},
+          "npm" => nil,
+          "foo" => []
+        })
+      }.to raise_error(ArgumentError,
+          "The following catalog group(s) should be a Hash: npm, foo")
+    end
+  end
+end

data/spec/natives/catalog_spec.rb

@@ -0,0 +1,97 @@
+require 'spec_helper'
+require 'natives/catalog'
+
+describe Natives::Catalog do
+
+  describe "#new" do
+    it "loads catalogs" do
+      Natives::Catalog.any_instance.should_receive(:reload)
+      Natives::Catalog.new('rubygems', 'mac_os_x', '10.7.5', 'homebrew')
+    end
+
+    it "requires caller to provide platform and package provider details" do
+      catalog = Natives::Catalog.new('rubygems', 'mac_os_x', '10.7.5', 'homebrew')
+      expect(catalog.name).to eq('rubygems')
+      expect(catalog.platform).to eq('mac_os_x')
+      expect(catalog.platform_version).to eq('10.7.5')
+      expect(catalog.package_provider).to eq('homebrew')
+    end
+  end
+
+  describe "#reload" do
+    it "reloads catalogs from default catalog paths" do
+      Natives::Catalog::Loader.any_instance.
+        should_receive(:load_from_paths).
+        with(Natives::Catalog::CATALOG_PATHS).
+        and_return({
+          'rubygems' => {'foo' => {'key' => 'value'}},
+          'npm' => {'bar' => {'key' => 'value'}}
+        })
+
+      catalog = Natives::Catalog.new('rubygems',
+                                     'mac_os_x', '10.7.5', 'homebrew')
+
+      expect(catalog.to_hash).to eq({'foo' => {'key' => 'value'}})
+    end
+  end
+
+  describe "#to_hash" do
+    before do
+      Natives::Catalog::Loader.any_instance.
+        stub(:load_from_paths).
+        with(Natives::Catalog::CATALOG_PATHS).
+        and_return({
+          'rubygems' => {'foo' => {'key' => 'value'}},
+          'npm' => {'bar' => {'key' => 'value'}}
+        })
+    end
+
+    it "returns catalog hash of the specified catalog name" do
+      catalog = Natives::Catalog.new("npm", nil, nil, nil)
+      expect(catalog.to_hash).to eq({'bar' => {'key' => 'value'}})
+    end
+
+    it "returns empty hash if the sepcified catalog not found" do
+      catalog = Natives::Catalog.new("notfound", nil, nil, nil)
+      expect(catalog.to_hash).to eq({})
+    end
+  end
+
+  describe "#native_packages_for" do
+    before do
+      Natives::Catalog::Loader.any_instance.
+        stub(:load_from_paths).
+        with(Natives::Catalog::CATALOG_PATHS).
+        and_return({
+          'rubygems' => {
+            'nokogiri' => {
+              'ubuntu/apt' => {
+                '13.10' => 'value1',
+                'default' => 'value2'
+              }
+            }
+          },
+        })
+    end
+
+    it "returns native packages for the given catalog entry name" do
+      catalog = Natives::Catalog.new(:rubygems, 'ubuntu', '13.10', 'apt')
+      expect(catalog.native_packages_for('nokogiri')).to eq(['value1'])
+    end
+
+    it "returns empty list if the given catalog entry name does not exist" do
+      catalog = Natives::Catalog.new(:rubygems, 'ubuntu', '13.10', 'apt')
+      expect(catalog.native_packages_for('notfound')).to eq([])
+    end
+  end
+
+  describe "::CATALOG_PATHS" do
+    it "contains the default catalog paths" do
+      expect(Natives::Catalog::CATALOG_PATHS).to eq([
+        Natives::Catalog::CATALOG_PATH_IN_GEM,
+        Natives::Catalog::CATALOG_PATH_IN_WORKING_DIR
+      ])
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'natives-catalog'
+
+if ENV['COVERAGE']
+  require 'simplecov'
+  SimpleCov.start
+end
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.add_setting :fixture_path
+  config.fixture_path = File.join(File.dirname(__FILE__), 'fixtures')
+end

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification
+name: natives-catalog
+version: !ruby/object:Gem::Version
+  version: !binary |-
+    MC4yLjA=
+platform: ruby
+authors:
+- Huiming Teo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chef
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MTE=
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: !binary |-
+          MTE=
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  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
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A catalog of native packages in different platforms required by ruby
+  gems.
+email: teohuiming@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- catalogs/rubygems.yaml
+- lib/natives-catalog.rb
+- lib/natives/catalog.rb
+- lib/natives/catalog/loader.rb
+- lib/natives/catalog/merger.rb
+- lib/natives/catalog/selector.rb
+- lib/natives/catalog/validator.rb
+- natives-catalog.gemspec
+- spec/fixtures/dir_with_matching_files/invalid1.yml
+- spec/fixtures/dir_with_matching_files/not_matching.json
+- spec/fixtures/dir_with_matching_files/valid1.yaml
+- spec/fixtures/dir_with_matching_files/valid2.yml
+- spec/fixtures/dir_without_matching_file/not_matching.json
+- spec/natives/catalog/loader_spec.rb
+- spec/natives/catalog/merger_spec.rb
+- spec/natives/catalog/selector_spec.rb
+- spec/natives/catalog/validator_spec.rb
+- spec/natives/catalog_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/teohm/natives-catalog
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.9
+signing_key: 
+specification_version: 4
+summary: A catalog of native packages for ruby gems.
+test_files: []