fauxhai 6.9.1 → 6.10.0

data/README.md

@@ -1,196 +0,0 @@
-# Fauxhai
-
-[![Build Status Master](https://travis-ci.org/chefspec/fauxhai.svg?branch=master)](https://travis-ci.org/chefspec/fauxhai) [![Gem Version](https://badge.fury.io/rb/fauxhai.svg)](https://badge.fury.io/rb/fauxhai)
-
-Fauxhai is a gem for mocking out [ohai](https://github.com/chef/ohai) data in your chef testing. Fauxhai is community supported, so we need **your help** to populate our dataset. Here's an example for testing my "awesome_cookbook" on Ubuntu 16.04:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.mock(platform: 'ubuntu', version: '16.04')
-  end
-
-  it 'should install awesome' do
-    @runner = ChefSpec::ChefRunner.new.converge('tmpreaper::default')
-    @runner.should install_package 'awesome'
-  end
-end
-```
-
-Alternatively, you can pull "real" Ohai data from an existing server:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.fetch(host: 'server01.example.com')
-  end
-
-  it 'should install awesome' do
-    @runner = ChefSpec::ChefRunner.new.converge('tmpreaper::default')
-    @runner.should install_package 'awesome'
-  end
-end
-```
-
-## Important Note
-
-Fauxhai ships with a command line tool - `fauxhai`. This is **not** the same as Fauxhai.mock. Running `fauxhai` on a machine effectively runs `ohai`, but then sanitizes the data, removing/replacing things like:
-
-- users
-- ssh keys
-- usernames in paths
-- sensitive system information
-
-`fauxhai` should only be used by developers wishing to submit a new json file.
-
-## Platform and Versions
-
-For a complete list of platforms and versions available for mocking via Fauxhai see [PLATFORMS.MD](https://github.com/chefspec/fauxhai/blob/master/PLATFORMS.md) in this repository.
-
-## Usage
-
-Fauxhai provides a bunch of default attributes so that you don't need to mock out your entire infrastructure to write a simple test. That being said, not all configurations will suit your needs. Because of that, Fauxhai provides two ways to configure your mocks:
-
-### Overriding
-
-`Fauxhai.mock` will also accept a block with override attributes that are merged with all the default attributes. For example, the default Ubuntu 12.04 mock uses `Ruby 1.9.3`. Maybe your system is using `ree`, and you want to verify that the cookbooks work with that data as well:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.mock(platform: 'ubuntu', version: '12.04') do |node|
-      node['languages']['ruby']['version'] = 'ree'
-    end
-  end
-
-  it 'should install awesome' do
-    @runner = ChefSpec::ChefRunner.new.converge('tmpreaper::default')
-    @runner.should install_package 'awesome'
-  end
-end
-```
-
-The `node` block variable allows you to set any Ohai attribute on the mock that you want. This provides an easy way to manage your environments. If you find that you are overriding attributes like OS or platform, you should see the section on Contributing.
-
-### Fetching
-
-Alternatively, if you do not want to mock the data, Fauxhai provides a `fetch` mechanism for collecting "real" Ohai data from a remote server or local file. Maybe you want to test against the fully-replicated environment for a front-facing server in your pool. Just pass in the `url` option instead of a `platform`:
-
-The `fetch` method supports all the same options as the Net-SSH command, such as `:user`, `:password`, `:key_file`, etc.
-
-The `fetch` method will cache the JSON file in a temporary path on your local machine. Similar to gems like VCR, this allows Fauxhai to use the cached copy, making your test suite run faster. You can optionally force a cache miss by passing the `:force_cache_miss => true` option to the `fetch` initializer. **Because this is real data, there may be a security concern. Secure your laptop accordingly.**
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.fetch(host: 'server01.example.com')
-  end
-
-  it 'should install awesome' do
-    @runner = ChefSpec::ChefRunner.new.converge('tmpreaper::default')
-    @runner.should install_package 'awesome'
-  end
-end
-```
-
-This will ssh into the machine (you must have authorization to run `sudo ohai` on that machine), download a copy of the Ohai output, and optionally cache that data inside the test directory (speeding up future tests).
-
-### Overriding + Fetching
-
-As you might expect, you can combine overriding and fetching like so:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.fetch(host: 'server01.example.com') do |node|
-      node['languages']['ruby']['version'] = 'ree'
-    end
-  end
-
-  it 'should install awesome' do
-    @runner = ChefSpec::ChefRunner.new.converge('tmpreaper::default')
-    @runner.should install_package 'awesome'
-  end
-end
-```
-
-### Fixturing
-
-If you want to use Fauxhai as "fixture" data, you can store real JSON in your project and use the `:path` option:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.mock(path: 'fixtures/my_node.json')
-  end
-end
-```
-
-### Overriding + Fixturing
-
-You can also change specific attributes in your fixture:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.mock(path: 'fixtures/my_node.json') do |node|
-      node['languages']['ruby']['version'] = 'ree'
-    end
-  end
-end
-```
-
-### Disabling Fetching from Github
-
-On environments that does not have access to the internet, you can disable fetching Fauxhai data from GitHub as follow:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  before do
-    Fauxhai.mock(platform: 'ubuntu', version: '12.04', github_fetching: false)
-  end
-end
-```
-
-## Testing Multiple Versions
-
-It's a common use case to test multiple version of the same operating system. Here's a simple example to get your started. This is more rspec-related that Fauxhai related, but here ya go:
-
-```ruby
-require 'chefspec'
-
-describe 'awesome_cookbook::default' do
-  ['14.04', '16.04'].each do |version|
-    context "on Ubuntu #{version}" do
-      before do
-        Fauxhai.mock(platform: 'ubuntu', version: version)
-      end
-
-      it 'should install awesome' do
-        @runner = ChefSpec::ChefRunner.new.converge('tmpreaper::default')
-        @runner.should install_package 'awesome'
-      end
-    end
-  end
-end
-```
-
-## Contributing
-
-See [CONTRIBUTING.md](https://github.com/chefspec/fauxhai/blob/master/CONTRIBUTING.md).

data/fauxhai.gemspec

@@ -1,29 +0,0 @@
-lib = File.expand_path('../lib', __FILE__)
-$:.unshift(lib) unless $:.include?(lib)
-require 'fauxhai/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = 'fauxhai'
-  spec.version       = Fauxhai::VERSION
-  spec.authors       = ['Seth Vargo']
-  spec.email         = ['sethvargo@gmail.com']
-  spec.description   = 'Easily mock out ohai data'
-  spec.summary       = 'Fauxhai provides an easy way to mock out your ohai data for testing with chefspec!'
-  spec.homepage      = 'https://github.com/chefspec/fauxhai'
-  spec.license       = 'MIT'
-
-  spec.required_ruby_version = '>= 2.2.2'
-
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(\..*|Gemfile|Rakefile|CONTRIBUTING.md|PLATFORMS.md|examples|spec)}) }
-  spec.executables   = spec.files.grep(%r{^bin/}).map { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec)/})
-  spec.require_paths = ['lib']
-
-  spec.add_runtime_dependency 'net-ssh'
-
-  spec.add_development_dependency 'chef', '>= 12.0'
-  spec.add_development_dependency 'ohai', '>= 8.5'
-  spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec', '~> 3.7'
-  spec.add_development_dependency 'rspec-its', '~> 1.2'
-end