kitchen-bluebox 0.5.0 → 0.6.0

data/.tailor

@@ -0,0 +1,106 @@
+#------------------------------------------------------------------------------
+# Horizontal Whitespace
+#------------------------------------------------------------------------------
+# allow_hard_tabs         True to let hard tabs be considered a single space.
+#                         Default:      false
+#
+# allow_trailing_line_spaces
+#                         True to skip detecting extra spaces at the ends of
+#                         lines.
+#                         Default:      false
+#
+# indentation_spaces      The number of spaces to consider a proper indent.
+#                         Default:      2
+#
+# max_line_length         The maximum number of characters in a line before
+#                         tailor complains.
+#                         Default:      80
+# spaces_after_comma      Number of spaces to expect after a comma.
+#                         Default:      1
+#
+# spaces_before_comma     Number of spaces to expect before a comma.
+#                         Default:      0
+#
+# spaces_after_lbrace     The number of spaces to expect after an lbrace ('{').
+#                         Default:      1
+#
+# spaces_before_lbrace    The number of spaces to expect before an lbrace ('{').
+#                         Default:      1
+#
+# spaces_before_rbrace    The number of spaces to expect before an rbrace ('}').
+#                         Default:      1
+#
+# spaces_in_empty_braces  The number of spaces to expect between braces when
+#                         there's nothing in the braces (i.e. {}).
+#                         Default:      0
+#
+# spaces_after_lbracket   The number of spaces to expect after an
+#                         lbracket ('[').
+#                         Default:      0
+#
+# spaces_before_rbracket  The number of spaces to expect before an
+#                         rbracket (']').
+#                         Default:      0
+#
+# spaces_after_lparen     The number of spaces to expect after an
+#                         lparen ('(').
+#                         Default:      0
+#
+# spaces_before_rparen    The number of spaces to expect before an
+#                         rbracket (')').
+#                         Default:      0
+#
+#------------------------------------------------------------------------------
+# Naming
+#------------------------------------------------------------------------------
+# allow_camel_case_methods
+#                         Setting to true skips detection of camel-case method
+#                         names (i.e. def myMethod).
+#                         Default:      false
+#
+# allow_screaming_snake_case_classes
+#                         Setting to true skips detection of screaming
+#                         snake-case class names (i.e. My_Class).
+#                         Default:      false
+#
+#------------------------------------------------------------------------------
+# Vertical Whitespace
+#------------------------------------------------------------------------------
+# max_code_lines_in_class The number of lines of code in a class to allow before
+#                         tailor will warn you.
+#                         Default:      300
+#
+# max_code_lines_in_method
+#                         The number of lines of code in a method to allow
+#                         before tailor will warn you.
+#                         Default:      30
+#
+# trailing_newlines       The number of newlines that should be at the end of
+#                         the file.
+#                         Default:      1
+#
+Tailor.config do |config|
+  config.formatters "text"
+  config.file_set 'lib/**/*.rb' do |style|
+    style.allow_camel_case_methods false, level: :error
+    style.allow_hard_tabs false, level: :error
+    style.allow_screaming_snake_case_classes false, level: :error
+    style.allow_trailing_line_spaces false, level: :error
+    style.allow_invalid_ruby false, level: :warn
+    style.indentation_spaces 2, level: :error
+    style.max_code_lines_in_class 300, level: :error
+    style.max_code_lines_in_method 30, level: :error
+    style.max_line_length 80, level: :error
+    style.spaces_after_comma 1, level: :off
+    style.spaces_after_lbrace 1, level: :error
+    style.spaces_after_lbracket 0, level: :error
+    style.spaces_after_lparen 0, level: :error
+    style.spaces_before_comma 0, level: :error
+    style.spaces_before_lbrace 1, level: :off
+    style.spaces_before_rbrace 1, level: :error
+    style.spaces_before_rbracket 0, level: :error
+    style.spaces_before_rparen 0, level: :error
+    style.spaces_in_empty_braces 0, level: :error
+    style.trailing_newlines 1, level: :error
+  end
+end

data/CHANGELOG.md

@@ -0,0 +1,17 @@
+## 0.6.0 / 2013-06-28
+
+### Bug fixes
+
+* Pull request [#2][]: Don't fail to destroy if the block no longer exists. ([@sandfish8][], [@blueboxjesse][])
+
+### Improvements
+
+* Write a README, damnit! ([@fnichol][])
+* Remove default port config as it is the new default in core. ([@fnichol][])
+
+
+<!--- The following link definition list is generated by PimpMyChangelog --->
+[#2]: https://github.com/blueboxgroup/kitchen-bluebox/issues/2
+[@blueboxjesse]: https://github.com/blueboxjesse
+[@fnichol]: https://github.com/fnichol
+[@sandfish8]: https://github.com/sandfish8

data/README.md

@@ -1,32 +1,179 @@
-# Kitchen::Driver::Bluebox
+# <a name="title"></a> Kitchen::Bluebox: A Test Kitchen Driver for Blue Box Blocks
 
-[![Build Status](https://secure.travis-ci.org/blueboxgroup/kitchen-bluebox.png)](https://travis-ci.org/blueboxgroup/kitchen-bluebox)
-[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/blueboxgroup/kitchen-bluebox)
+[![Gem Version](https://badge.fury.io/rb/blueboxgroup%2Fkitchen-bluebox.png)](http://badge.fury.io/rb/blueboxgroup%2Fkitchen-bluebox)
+[![Build Status](https://travis-ci.org/blueboxgroup/kitchen-bluebox.png?branch=master)](https://travis-ci.org/blueboxgroup/kitchen-bluebox)
+[![Code Climate](https://codeclimate.com/github/blueboxgroup/kitchen-bluebox.png)](https://codeclimate.com/github/blueboxgroup/kitchen-bluebox)
 
-TODO: Write a gem description
+A Test Kitchen Driver for Blue Box Blocks.
 
-## Installation
+This driver uses the [fog gem][fog_gem] to provision and destroy blocks
+instances. Use Blue Box's cloud for your infrastructure testing!
 
-Add this line to your application's Gemfile:
+## <a name="requirements"></a> Requirements
 
-    gem 'kitchen-bluebox'
+There are **no** external system requirements for this driver. However you
+will need access to a [Blue Box][bbg_site] account.
 
-And then execute:
+## <a name="installation"></a> Installation and Setup
 
-    $ bundle
+Please read the [Driver usage][driver_usage] page for more details.
 
-Or install it yourself as:
+## <a name="config"></a> Configuration
 
-    $ gem install kitchen-bluebox
+### <a name="config-bluebox-customer-id"></a> bluebox\_customer\_id
 
-## Usage
+**Required** The Blue Blue [customer id][blocks_docs] to use.
 
-TODO: Write usage instructions here
+The default is unset, or `nil`.
 
-## Contributing
+### <a name="config-bluebox-api-key"></a> bluebox\_api\_key
 
-1. Fork it
+**Required** The Blue Blue [api key][blocks_docs] to use.
+
+The default is unset, or `nil`.
+
+### <a name="config-flavor-id"></a> flavor\_id
+
+The blocks [product type][blocks_docs] (also known as size) to use.
+
+The default is `"94fd37a7-2606-47f7-84d5-9000deda52ae"`.
+
+### <a name="config-image-id"></a> image\_id
+
+The blocks [template id][blocks_docs] to use.
+
+The default is `"573b8e80-823f-4100-bc2c-51b7c60f633c"`.
+
+### <a name="config-location-id"></a> location\_id
+
+The blocks [location][blocks_docs] to use.
+
+The default is `"37c2bd9a-3e81-46c9-b6e2-db44a25cc675"`.
+
+### <a name="config-port"></a> port
+
+The SSH port number to be used when communicating with the instance.
+
+The default is `22`.
+
+### <a name="config-require-chef-omnibus"></a> require\_chef\_omnibus
+
+Determines whether or not a Chef [Omnibus package][chef_omnibus_dl] will be
+installed. There are several different behaviors available:
+
+* `true` - the latest release will be installed. Subsequent converges
+  will skip re-installing if chef is present.
+* `latest` - the latest release will be installed. Subsequent converges
+  will always re-install even if chef is present.
+* `<VERSION_STRING>` (ex: `10.24.0`) - the desired version string will
+  be passed the the install.sh script. Subsequent converges will skip if
+  the installed version and the desired version match.
+* `false` or `nil` - no chef is installed.
+
+The default value is unset, or `nil`.
+
+### <a name="config-ssh-key"></a> ssh\_key
+
+Path to the private SSH key used to connect to the instance.
+
+The default is unset, or `nil`.
+
+### <a name="config-sudo"></a> sudo
+
+Whether or not to prefix remote system commands such as installing and
+running Chef with `sudo`.
+
+The default is `true`.
+
+### <a name="config-username"></a> username
+
+The SSH username that will be used to communicate with the instance.
+
+The default is `"kitchen"`.
+
+## <a name="example"></a> Example
+
+The following could be used in a `.kitchen.yml` or in a `.kitchen.local.yml`
+to override default configuration.
+
+```yaml
+---
+driver_plugin: bluebox
+driver_config:
+  bluebox_customer_id: 123...
+  bluebox_api_key: abc...
+  location_id: def789...
+  ssh_public_key: /path/to/id_dsa.pub
+  ssh_key: /path/to/id_dsa
+  require_chef_omnibus: true
+
+platforms:
+- name: ubuntu-12.04
+  driver_config:
+    image_id: b137c423-bade-4b01-9d13-271eea552563
+- name: scientific-6.3
+  driver_config:
+    image_id: caaaca6b-fbe0-4e27-af2b-d100e46767bd
+
+suites:
+# ...
+```
+
+Both `.kitchen.yml` and `.kitchen.local.yml` files are pre-processed through
+ERB which can help to factor out secrets and credentials. For example:
+
+```yaml
+---
+driver_plugin: bluebox
+driver_config:
+  bluebox_customer_id: <%= ENV['BLUEBOX_CUSTOMER_ID'] %>
+  bluebox_api_key: <%= ENV['BLUEBOX_API_KEY'] %>
+  ssh_public_key: <%= File.expand_path('~/.ssh/id_dsa.pub') %>
+  ssh_key: <%= File.expand_path('~/.ssh/id_dsa') %>
+  require_chef_omnibus: true
+
+platforms:
+- name: ubuntu-12.04
+  driver_config:
+    image_id: b137c423-bade-4b01-9d13-271eea552563
+- name: scientific-6.3
+  driver_config:
+    image_id: caaaca6b-fbe0-4e27-af2b-d100e46767bd
+
+suites:
+# ...
+```
+
+## <a name="development"></a> Development
+
+* Source hosted at [GitHub][repo]
+* Report issues/questions/feature requests on [GitHub Issues][issues]
+
+Pull requests are very welcome! Make sure your patches are well tested.
+Ideally create a topic branch for every separate change you make. For
+example:
+
+1. Fork the repo
 2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
+
+## <a name="authors"></a> Authors
+
+Created and maintained by [Fletcher Nichol][author] (<fnichol@nichol.ca>)
+
+## <a name="license"></a> License
+
+Apache 2.0 (see [LICENSE][license])
+
+
+[author]:           https://github.com/fnichol
+[issues]:           https://github.com/blueboxgroup/kitchen-bluebox/issues
+[license]:          https://github.com/blueboxgroup/kitchen-bluebox/blob/master/LICENSE
+[repo]:             https://github.com/blueboxgroup/kitchen-bluebox
+[driver_usage]:     http://docs.kitchen-ci.org/drivers/usage
+[chef_omnibus_dl]:  http://www.opscode.com/chef/install/
+
+[bbg_site]:         https://bluebox.net/
+[blocks_docs]:      https://boxpanel.bluebox.net/public/the_vault/index.php/Blocks_API

data/Rakefile

@@ -3,7 +3,9 @@ require 'cane/rake_task'
 require 'tailor/rake_task'
 
 desc "Run cane to check quality metrics"
-Cane::RakeTask.new
+Cane::RakeTask.new do |cane|
+  cane.canefile = './.cane'
+end
 
 Tailor::RakeTask.new
 
@@ -13,4 +15,7 @@ task :stats do
   sh "countloc -r lib/kitchen"
 end
 
-task :default => [ :cane, :tailor, :stats ]
+desc "Run all quality tasks"
+task :quality => [:cane, :tailor, :stats]
+
+task :default => [:quality]

data/lib/kitchen/driver/bluebox.rb

@@ -34,7 +34,6 @@ module Kitchen
       default_config :image_id,     '573b8e80-823f-4100-bc2c-51b7c60f633c'
       default_config :location_id,  '37c2bd9a-3e81-46c9-b6e2-db44a25cc675'
       default_config :username,     'kitchen'
-      default_config :port,         '22'
 
       required_config :bluebox_customer_id
       required_config :bluebox_api_key
@@ -55,9 +54,9 @@ module Kitchen
         return if state[:block_id].nil?
 
         connection.destroy_block(state[:block_id])
-        info("Blocks instance <#{state[:block_id]}> destroyed.")
-        state.delete(:block_id)
-        state.delete(:hostname)
+        update_state_for_destroy(state)
+      rescue Fog::Compute::Bluebox::NotFound
+        update_state_for_destroy(state)
       rescue Fog::Errors::Error, Excon::Errors::Error => ex
         raise ActionFailed, ex.message
       end
@@ -89,6 +88,12 @@ module Kitchen
 
         connection.servers.create(opts)
       end
+
+      def update_state_for_destroy(state)
+        info("Blocks instance <#{state[:block_id]}> destroyed.")
+        state.delete(:block_id)
+        state.delete(:hostname)
+      end
     end
   end
 end

data/lib/kitchen/driver/bluebox_version.rb

@@ -20,6 +20,6 @@ module Kitchen
 
   module Driver
 
-    BLUEBOX_VERSION = "0.5.0"
+    BLUEBOX_VERSION = "0.6.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kitchen-bluebox
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-02 00:00:00.000000000 Z
+date: 2013-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-kitchen
@@ -131,7 +131,9 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .tailor
 - .travis.yml
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md
@@ -151,18 +153,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -2100783807985549325
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -2100783807985549325
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24