vagrant_spec 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ca4398378f23816a6be2fe1363277f81fccc9865
-  data.tar.gz: 0c79917845abf21b33eb88bbb0c1120b9bc040ec
+  metadata.gz: 7441764a1c3043878ae5e5c6b523eb83322b7038
+  data.tar.gz: 936ce47d1326d77b1fdcfb9eeba5004622cd59e1
 SHA512:
-  metadata.gz: c0abf6618ed12096ad017c1e944a5036e2738af0b1b69f5c81fb4e769d6503c0c8c5b891b11e9daf7a09c440d3fd710821bb3e5eccc176bc8aaf62503cb73c1d
-  data.tar.gz: de929a10c837c340ed464cb0536a870b6295424af94a22a27041e06c9c74b32c60f87236b40ca77e59fdbdf836948ed4f559ce924d58d73c1a16072e83b8153c
+  metadata.gz: 3d56eef6bd74a8280e379980001b51c48d4b8d2dd1e81ab40964e99b04d62d11c3bd98386bffdb24dfc4cb6c2c9300b04c43085851ca79b9710eef6c73e5e61e
+  data.tar.gz: 123fb1ea1e3de655835d54b4b3db19208dbdeeab7f3571009327027d46805a3801125ff97915d829eb87df300a35d435f2967758edcce135e36f84fc00cecee8

data/.gitignore

@@ -1,6 +1,7 @@
 .vagrant
 Gemfile.lock
 vagrantspec_inventory
+.vagrantspec_machine_data
 serverspec/spec_helper.rb
 coverage
 pkg

data/CHANGELOG.md

@@ -1,7 +1,15 @@
 # Change Log
 
-## [0.0.2](https://github.com/miroswan/vagrant_spec/tree/0.0.2) (2016-08-06)
-[Full Changelog](https://github.com/miroswan/vagrant_spec/compare/v0.0.1...0.0.2)
+## [v0.0.3](https://github.com/miroswan/vagrant_spec/tree/v0.0.3) (2016-08-09)
+[Full Changelog](https://github.com/miroswan/vagrant_spec/compare/v0.0.2...v0.0.3)
+
+**Merged pull requests:**
+
+- Prepping for a v0.0.3 release [\#6](https://github.com/miroswan/vagrant_spec/pull/6) ([miroswan](https://github.com/miroswan))
+- Feature/machine data [\#5](https://github.com/miroswan/vagrant_spec/pull/5) ([miroswan](https://github.com/miroswan))
+
+## [v0.0.2](https://github.com/miroswan/vagrant_spec/tree/v0.0.2) (2016-08-06)
+[Full Changelog](https://github.com/miroswan/vagrant_spec/compare/v0.0.1...v0.0.2)
 
 **Closed issues:**
 

data/README.md

@@ -1,18 +1,24 @@
 # vagrant_spec
 
+[![Gem Version](https://badge.fury.io/rb/vagrant_spec.svg)](https://badge.fury.io/rb/vagrant_spec)
 [![Build Status](https://travis-ci.org/miroswan/vagrant_spec.svg?branch=master)](https://travis-ci.org/miroswan/vagrant_spec) 
 [![Coverage Status](https://coveralls.io/repos/github/miroswan/vagrant_spec/badge.svg?branch=master)](https://coveralls.io/github/miroswan/vagrant_spec?branch=master)
 
+
 Vagrant Spec is a Vagrant plugin that makes integration testing for deployments
 to clustered systems a breeze. It also separates the build and deployment steps
-to clearly delineate pipeline tasks. 
+to clearly separate pipeline tasks. 
+
+## Installation
+
+```vagrant plugin install vagrant_spec```
 
 ## Why not use TestKitchen or vagrant-serverspec?
 
 * Test Kitchen is an excellent integration testing system developed by Chef.
 However, it is designed to provision, test, and destroy each system one at a
 time. The directory structure it expects makes sharing tests across nodes 
-difficult to manager. This is undesireable for testing clustered or 
+difficult to manage. This is undesireable for testing clustered or 
 distributed systems. vagrant-serverspec has similar pitfalls. 
 
 * vagrant_spec allows you to leverage your deployment tools just like you would
@@ -66,7 +72,14 @@ defaults to serverspec.
 You can specify as many groups as you need. You can match nodes by regular 
 expression or explicitly provide an array of node names. This will generate 
 an vagrantspec_inventory based on your active nodes. You use this file for 
-running ansible playbooks against your Vagrant instances. 
+running ansible playbooks against your Vagrant instances. Use this configuration
+directive if you use ansible for orchestration. 
+
+* config.spec.generate_machine_data: a boolean. If true, the init sub-command
+will generate a json file at .vagrantspec_machine_data containing relevant
+ssh information for each of your nodes. This can be helpful when leveraging
+orchestration tooling aside from ansible. You can use this data to direct your
+orchestration to your local instances. The default is set to true. 
 
 * config.spec.test_plan: an array of hashes. nodes can either be a regular 
 expression object that matches your desired nodes or an explicit array of 
@@ -140,7 +153,15 @@ rspec ./serverspec/fail_spec.rb:4 # Thing that fails dumb_service totally fails
 1
 ```
 
+## Testing Resources
+
+* [ServerSpec](http://serverspec.org/)
+* [RSpec](http://rspec.info/)
+* [RSpec Best Practices](http://betterspecs.org/)
+
 ## Development
 
 * Fork the development branch
+* ```pip install ansible```
+* ```bundle install```
 * ```bundle exec rake test```

data/lib/vagrant_spec/command/init.rb

@@ -2,6 +2,7 @@
 
 require 'vagrant_spec/ansible_inventory'
 require 'vagrant_spec/spec_helper'
+require 'vagrant_spec/machine_data'
 require 'vagrant_spec/config'
 
 module VagrantSpec
@@ -15,12 +16,17 @@ module VagrantSpec
 
       DEFAULTS = VagrantSpec::Config::DEFAULTS
 
-      attr_accessor :config, :directory, :ansible_inventory
+      attr_accessor :config
+      attr_accessor :directory
+      attr_accessor :ansible_inventory
+      attr_accessor :generate_machine_data
+
       def initialize(argv, env)
         super
-        @config            = VagrantSpec::Config.load env
-        @directory         = @config.spec.directory
-        @ansible_inventory = @config.spec.ansible_inventory
+        @config                = VagrantSpec::Config.load env
+        @directory             = @config.spec.directory
+        @ansible_inventory     = @config.spec.ansible_inventory
+        @generate_machine_data = @config.spec.generate_machine_data
       end
 
       def execute
@@ -29,14 +35,18 @@ module VagrantSpec
         unless @ansible_inventory == DEFAULTS['ansible_inventory']
           VagrantSpec::AnsibleInventory.new(@env).generate
         end
+        if @generate_machine_data == DEFAULTS['generate_machine_data']
+          VagrantSpec::MachineData.new(@env).generate
+        end
       end
 
       def parse_opts
         opts = OptionParser.new do |o|
-          o.banner = "\nCreates the serverspec/spec_helper.rb file for testing"
+          o.banner = "\nInit: Initializes state configuration"
           o.separator ''
           o.separator 'Usage: vagrant spec init'
           o.separator ''
+          o.separator IO.read(File.join(template_dir, 'init_help'))
         end
         parse_options(opts)
       end

data/lib/vagrant_spec/command/test.rb

@@ -1,6 +1,7 @@
 # encoding: UTF-8
 
 require 'vagrant_spec/test_plan'
+require 'vagrant_spec/utils'
 
 module VagrantSpec
   module Command
@@ -9,6 +10,7 @@ module VagrantSpec
     # argv
     # env [Vagrant::Environment]
     class Test < Vagrant.plugin(2, :command)
+      include VagrantSpec::Utils
       def initialize(argv, env)
         super
       end
@@ -20,10 +22,11 @@ module VagrantSpec
 
       def parse_opts
         opts = OptionParser.new do |o|
-          o.banner = "\nRun the tests configured in the Vagrantfile"
+          o.banner = "\nTest: Run the tests configured in the Vagrantfile"
           o.separator ''
           o.separator 'Usage: vagrant spec test'
           o.separator ''
+          o.separator IO.read(File.join(template_dir, 'test_help'))
         end
         parse_options(opts)
       end

data/lib/vagrant_spec/config/base.rb

@@ -11,11 +11,13 @@ module VagrantSpec
       attr_accessor :directory
       attr_accessor :ansible_inventory
       attr_accessor :test_plan
+      attr_accessor :generate_machine_data
 
       def initialize
-        @directory         = UNSET_VALUE
-        @ansible_inventory = UNSET_VALUE
-        @test_plan         = UNSET_VALUE
+        @directory             = UNSET_VALUE
+        @ansible_inventory     = UNSET_VALUE
+        @test_plan             = UNSET_VALUE
+        @generate_machine_data = UNSET_VALUE
       end
 
       def final_directory
@@ -32,10 +34,17 @@ module VagrantSpec
         @test_plan = DEFAULTS['test_plan'] if @test_plan == UNSET_VALUE
       end
 
+      def final_generate_machine_data
+        if @generate_machine_data == UNSET_VALUE
+          @generate_machine_data = DEFAULTS['generate_machine_data']
+        end
+      end
+
       def finalize!
         final_directory
         final_ansible_inventory
         final_test_plan
+        final_generate_machine_data
       end
     end
   end

data/lib/vagrant_spec/config.rb

@@ -6,9 +6,10 @@ module VagrantSpec
     autoload :Base, 'vagrant_spec/config/base'
 
     DEFAULTS = {
-      'directory'         => 'serverspec',
-      'ansible_inventory' => {},
-      'test_plan'         => []
+      'directory'             => 'serverspec',
+      'ansible_inventory'     => {},
+      'test_plan'             => [],
+      'generate_machine_data' => true
     }.freeze
 
     class << self

data/lib/vagrant_spec/machine_data.rb

@@ -0,0 +1,34 @@
+# encoding: UTF-8
+
+require 'json'
+require 'vagrant_spec/machine_finder'
+
+module VagrantSpec
+  # Handle machine data generation
+  class MachineData
+    attr_accessor :env, :m_finder, :data
+    def initialize(env)
+      @env      = env
+      @m_finder = VagrantSpec::MachineFinder.new(@env)
+      @data     = []
+    end
+
+    def generate
+      populate_data
+      IO.write('.vagrantspec_machine_data', JSON.pretty_generate(@data))
+    end
+
+    def populate_data
+      @m_finder.machines do |m|
+        private_key = m.ssh_info[:private_key_path][0]
+        @data << {
+          name:        m.name,
+          host:        m.ssh_info[:host],
+          port:        m.ssh_info[:port],
+          username:    m.ssh_info[:username],
+          private_key: private_key
+        }
+      end
+    end
+  end
+end

data/lib/vagrant_spec/machine_finder.rb

@@ -20,6 +20,13 @@ module VagrantSpec
       nil
     end
 
+    # Yield active machines
+    #
+    # yield [Vagrant::Machine]
+    def machines
+      @env.active_machines.each { |m| yield @env.machine(*m) }
+    end
+
     # reg [Regexp]
     #
     # return [Array<Vagrant::Machine>]

data/lib/vagrant_spec/templates/init_help

@@ -0,0 +1,16 @@
+The init subcommand initializes state-based configuration for vagrant_spec. 
+
+It creates a spec_helper.rb file under the configured serverspec directory. This 
+file is used to setup serverspec backend configuration and ease serverspec 
+testing. 
+
+If config.spec.ansible_inventory configuration directive is used within the 
+Vagrantfile, then init will generate a test inventory file 
+vagrantspec_inventory. This file can be used for ansible orchestration against 
+the vagrant instances. 
+
+By default, init will generate a json file containing machine data for each 
+vagrant instance at .vagrantspec_machine_data. This file can be used by
+orchestration tooling outside of ansible to map events to vagrant nodes. The
+config.spec.generate_machine_data configuration parameter controls the 
+generation of this file. 

data/lib/vagrant_spec/templates/spec_helper.erb

@@ -16,4 +16,4 @@ options[:keys]     = ENV['VAGRANT_KEY']
 options[:port]     = ENV['VAGRANT_PORT']
 
 set :host,        host
-set :ssh_options, options
+set :ssh_options, options

data/lib/vagrant_spec/templates/test_help

@@ -0,0 +1,21 @@
+The test subcommand will execute the serverspec tests configured in the 
+Vagrantfile under the config.spec.test_plan directive. This directive accepts
+an array of hashes. For example:
+
+config.spec.test_plan = [
+  {
+    'nodes' => /nginx/,
+    'flags' => '--format documentation --pattern serverspec/nginx*'
+  },
+  {
+    'nodes' => %w(app1 app2),
+    'flags' => '--format documentation --pattern serverspec/app*'
+  }
+]
+
+Each hash have two required keys: nodes and flags. The nodes key accepts a 
+regular expression object matching the names of the vagrant machines defined in 
+the Vagrantfile. Alternatively, you can explicility pass an array of node names. 
+The flags key accepts a string of command line arguments to pass to rspec. Any
+of the acceptable rspec options and parameters are leagle.  
+

data/lib/vagrant_spec/version.rb

@@ -2,5 +2,5 @@
 
 # Requisite version info
 module VagrantSpec
-  VERSION = '0.0.2'.freeze
+  VERSION = '0.0.3'.freeze
 end

data/scripts/poor_mans_smoke_test.sh

@@ -13,6 +13,7 @@ bundle exec vagrant spec init -h
 bundle exec vagrant spec test -h
 bundle exec vagrant spec no_command -h
 rm -f serverspec/spec_helper.rb
+rm -f .vagrantspec_machine_data
 bundle exec vagrant up
 bundle exec vagrant spec init
 ansible-playbook site.yml -i vagrantspec_inventory

data/spec/unit/vagrant_spec_test/command_spec/init_spec.rb

@@ -15,8 +15,13 @@ describe VagrantSpec::Command::Init do
     double(VagrantSpec::AnsibleInventory)
   end
 
+  let(:mock_machine_data) do
+    double(VagrantSpec::MachineData)
+  end
+
   before do
     allow(mock_spec).to receive(:ansible_inventory) { { 'all' => /node/ } }
+    allow(mock_spec).to receive(:generate_machine_data)
   end
 
   subject { VagrantSpec::Command::Init.new([], iso_env) }
@@ -29,8 +34,10 @@ describe VagrantSpec::Command::Init do
     proc do
       allow_any_instance_of(VagrantSpec::SpecHelper).to       receive(:generate)
       allow_any_instance_of(VagrantSpec::AnsibleInventory).to receive(:generate)
-      allow(mock_spec_helper).to receive(:generate)
+      allow_any_instance_of(VagrantSpec::MachineData).to      receive(:generate)
+      allow(mock_spec_helper).to       receive(:generate)
       allow(mock_ansible_inventory).to receive(:generate)
+      allow(mock_machine_data).to      receive(:generate)
     end
   end
 
@@ -46,12 +53,11 @@ describe VagrantSpec::Command::Init do
     def execute_protection_proc
       proc do
         allow(subject).to receive(:parse_opts) { 'not_nil' }
-        allow(VagrantSpec::SpecHelper).to receive(:new) do
-          mock_spec_helper
-        end
+        allow(VagrantSpec::SpecHelper).to receive(:new) { mock_spec_helper }
         allow(VagrantSpec::AnsibleInventory).to receive(:new) do
           mock_ansible_inventory
         end
+        allow(VagrantSpec::MachineData).to receive(:new) { mock_machine_data }
         execute_proc.call
       end
     end
@@ -77,6 +83,24 @@ describe VagrantSpec::Command::Init do
         subject.execute
       end
     end
+
+    context 'and when @generate_machine_data is true' do
+      it '#execute generates a .vagrantspec_machine_data file' do
+        execute_protection_proc.call
+        subject.generate_machine_data = true
+        expect(mock_machine_data).to receive(:generate)
+        subject.execute
+      end
+    end
+
+    context 'and when @generate_machine_data is false' do
+      it '#execute does not generate a .vagrantspec_machine_data file' do
+        execute_protection_proc.call
+        subject.generate_machine_data = false
+        expect(mock_machine_data).not_to receive(:generate)
+        subject.execute
+      end
+    end
   end
 
   it '#parse_opts calls parse_options' do

data/spec/unit/vagrant_spec_test/machine_data_spec.rb

@@ -0,0 +1,51 @@
+# encoding: UTF-8
+
+require 'spec_helper'
+require 'vagrant_spec/machine_data'
+
+describe VagrantSpec::MachineData do
+  include_context  'unit'
+  include_examples 'shared_mocks'
+
+  let(:mock_machine_ssh_config) do
+    {
+      host:             '127.0.0.1',
+      port:             '2222',
+      username:         'vagrant',
+      private_key_path: %w(mock_key)
+    }
+  end
+
+  let(:mock_data) do
+    {
+      name:        'default',
+      host:        '127.0.0.1',
+      port:        '2222',
+      username:    'vagrant',
+      private_key: 'mock_key'
+    }
+  end
+
+  before do
+    allow(mock_node).to receive(:name) { 'default' }
+    allow(mock_node).to receive(:ssh_info) { mock_machine_ssh_config }
+  end
+
+  subject { VagrantSpec::MachineData.new(iso_env) }
+
+  it '#generate create the .vagrantspec_machine_data file' do
+    allow(subject).to receive(:populate_data)
+    allow(IO).to receive(:write)
+      .with('.vagrantspec_machine_data', JSON.pretty_generate(subject.data))
+    expect(IO).to receive(:write)
+      .with('.vagrantspec_machine_data', JSON.pretty_generate(subject.data))
+    subject.generate
+  end
+
+  it '#populate_data stores json data' do
+    allow(subject.m_finder).to receive(:machines).and_yield(mock_node)
+    allow(mock_node).to receive(:ssh_info) { mock_machine_ssh_config }
+    expect(subject.data).to receive(:<<).with(mock_data)
+    subject.populate_data
+  end
+end

data/vagrant_spec.gemspec

@@ -6,6 +6,7 @@ Gem::Specification.new do |s|
   s.name        = 'vagrant_spec'
   s.version     = VagrantSpec::VERSION
   s.platform    = Gem::Platform::RUBY
+  s.licenses    = %w(Apache2)
   s.authors     = %w(Demitri Swan)
   s.email       = %w(demitriswan@gmail.com)
   s.homepage    = 'http://github.com/miroswan/vagrant_spec'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vagrant_spec
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Demitri
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-06 00:00:00.000000000 Z
+date: 2016-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: serverspec
@@ -124,9 +124,12 @@ files:
 - lib/vagrant_spec/command/test.rb
 - lib/vagrant_spec/config.rb
 - lib/vagrant_spec/config/base.rb
+- lib/vagrant_spec/machine_data.rb
 - lib/vagrant_spec/machine_finder.rb
 - lib/vagrant_spec/spec_helper.rb
+- lib/vagrant_spec/templates/init_help
 - lib/vagrant_spec/templates/spec_helper.erb
+- lib/vagrant_spec/templates/test_help
 - lib/vagrant_spec/templates/vagrantspec_inventory.erb
 - lib/vagrant_spec/test_plan.rb
 - lib/vagrant_spec/utils.rb
@@ -143,13 +146,15 @@ files:
 - spec/unit/vagrant_spec_test/command_spec/test_spec.rb
 - spec/unit/vagrant_spec_test/config_spec.rb
 - spec/unit/vagrant_spec_test/config_spec/base_spec.rb
+- spec/unit/vagrant_spec_test/machine_data_spec.rb
 - spec/unit/vagrant_spec_test/machine_finder_spec.rb
 - spec/unit/vagrant_spec_test/spec_helper_spec.rb
 - spec/unit/vagrant_spec_test/test_plan_spec.rb
 - spec/unit/vagrant_spec_test/utils_spec.rb
 - vagrant_spec.gemspec
 homepage: http://github.com/miroswan/vagrant_spec
-licenses: []
+licenses:
+- Apache2
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -180,6 +185,7 @@ test_files:
 - spec/unit/vagrant_spec_test/command_spec/test_spec.rb
 - spec/unit/vagrant_spec_test/config_spec.rb
 - spec/unit/vagrant_spec_test/config_spec/base_spec.rb
+- spec/unit/vagrant_spec_test/machine_data_spec.rb
 - spec/unit/vagrant_spec_test/machine_finder_spec.rb
 - spec/unit/vagrant_spec_test/spec_helper_spec.rb
 - spec/unit/vagrant_spec_test/test_plan_spec.rb