knife-cloud 1.2.1 → 1.2.3

data/lib/test/templates/windows-shell.erb

@@ -1,6 +1,6 @@
 @rem
-@rem Author:: Seth Chisamore (<schisamo@opscode.com>)
-@rem Copyright:: Copyright (c) 2011 Opscode, Inc.
+@rem Author:: Seth Chisamore (<schisamo@chef.io>)
+@rem Copyright:: Copyright (c) 2011-2016 Chef Software, Inc.
 @rem License:: Apache License, Version 2.0
 @rem
 @rem Licensed under the Apache License, Version 2.0 (the "License");

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: knife-cloud
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.2.3
 platform: ruby
 authors:
 - Kaustubh Deorukhkar
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-24 00:00:00.000000000 Z
+date: 2018-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: knife-windows
@@ -17,28 +17,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.14
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.5.14
-- !ruby/object:Gem::Dependency
-  name: chef
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.10.10
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.10.10
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: mixlib-shellout
   requirement: !ruby/object:Gem::Requirement
@@ -54,108 +40,27 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec-core
-  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: rspec-expectations
-  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: rspec-mocks
-  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: rspec_junit_formatter
-  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: fog
+  name: excon
   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: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '0.50'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.50'
 description: knife-cloud plugin
 email:
 - dev@chef.io
 executables: []
 extensions: []
-extra_rdoc_files:
-- README.md
-- LICENSE
+extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
-- CHANGELOG.md
-- CONTRIBUTING.md
-- Gemfile
 - LICENSE
-- README.md
-- Rakefile
-- ci.gemfile
-- knife-cloud.gemspec
 - lib/chef/knife/cloud/chefbootstrap/bootstrap_distribution.rb
 - lib/chef/knife/cloud/chefbootstrap/bootstrap_options.rb
 - lib/chef/knife/cloud/chefbootstrap/bootstrap_protocol.rb
@@ -191,28 +96,6 @@ files:
 - lib/test/templates/chef-full-chef-zero.erb
 - lib/test/templates/windows-chef-client-msi.erb
 - lib/test/templates/windows-shell.erb
-- spec/resource_spec_helper.rb
-- spec/server_command_common_spec_helper.rb
-- spec/spec_helper.rb
-- spec/support/shared_examples_for_command.rb
-- spec/support/shared_examples_for_servercreatecommand.rb
-- spec/support/shared_examples_for_serverdeletecommand.rb
-- spec/support/shared_examples_for_service.rb
-- spec/unit/bootstrap_protocol_spec.rb
-- spec/unit/bootstrapper_spec.rb
-- spec/unit/cloud_command_spec.rb
-- spec/unit/command_spec.rb
-- spec/unit/fog_service_spec.rb
-- spec/unit/list_resource_command_spec.rb
-- spec/unit/server_create_command_spec.rb
-- spec/unit/server_delete_command_spec.rb
-- spec/unit/server_list_command_spec.rb
-- spec/unit/server_show_command_spec.rb
-- spec/unit/service_spec.rb
-- spec/unit/ssh_bootstrap_protocol_spec.rb
-- spec/unit/unix_distribution_spec.rb
-- spec/unit/windows_distribution_spec.rb
-- spec/unit/winrm_bootstrap_protocol_spec.rb
 homepage: https://github.com/chef/knife-cloud
 licenses: []
 metadata: {}
@@ -220,12 +103,11 @@ post_install_message:
 rdoc_options: []
 require_paths:
 - lib
-- spec
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -233,30 +115,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: knife-cloud plugin
-test_files:
-- spec/resource_spec_helper.rb
-- spec/server_command_common_spec_helper.rb
-- spec/spec_helper.rb
-- spec/support/shared_examples_for_command.rb
-- spec/support/shared_examples_for_servercreatecommand.rb
-- spec/support/shared_examples_for_serverdeletecommand.rb
-- spec/support/shared_examples_for_service.rb
-- spec/unit/bootstrap_protocol_spec.rb
-- spec/unit/bootstrapper_spec.rb
-- spec/unit/cloud_command_spec.rb
-- spec/unit/command_spec.rb
-- spec/unit/fog_service_spec.rb
-- spec/unit/list_resource_command_spec.rb
-- spec/unit/server_create_command_spec.rb
-- spec/unit/server_delete_command_spec.rb
-- spec/unit/server_list_command_spec.rb
-- spec/unit/server_show_command_spec.rb
-- spec/unit/service_spec.rb
-- spec/unit/ssh_bootstrap_protocol_spec.rb
-- spec/unit/unix_distribution_spec.rb
-- spec/unit/windows_distribution_spec.rb
-- spec/unit/winrm_bootstrap_protocol_spec.rb
+test_files: []

data/.gitignore

@@ -1,33 +0,0 @@
-.autotest
-coverage
-.DS_Store
-pkg
-*/tags
-*~
-
-# you should check in your Gemfile.lock in applications, and not in gems
-Gemfile.lock
-Gemfile.local
-
-# Do not check in the .bundle directory, or any of the files inside it. Those files are specific to each particular machine, and are used to persist installation options between runs of the bundle install command.
-.bundle
-
-# ignore some common Bundler 'binstubs' directory names
-# http://gembundler.com/man/bundle-exec.1.html
-b/
-binstubs/
-
-# RVM and RBENV ruby version files
-.rbenv-version
-.rvmrc
-
-# Documentation
-_site/*
-.yardoc/
-doc/
-
-*.gem
-pkg/*
-
-#keys
-*.pem

data/.travis.yml

@@ -1,6 +0,0 @@
-rvm:
-  - 2.0.0
-
-gemfile: ci.gemfile
-
-script: bundle exec rake spec

data/CHANGELOG.md

@@ -1,133 +0,0 @@
-# Change Log
-
-## [v1.2.1](https://github.com/chef/knife-cloud/tree/v1.2.1) (2016-02-24)
-
-[Full Changelog](https://github.com/chef/knife-cloud/compare/v1.2.0...v1.2.1)
-
-**Merged pull requests:**
-
-- Passing bootstrap\_ip\_address as an array object instead of string [\#101](https://github.com/chef/knife-cloud/pull/101) ([NimishaS](https://github.com/NimishaS))
-- Added new knife windows options [\#98](https://github.com/chef/knife-cloud/pull/98) ([siddheshwar-more](https://github.com/siddheshwar-more))
-
-## [v1.2.0](https://github.com/chef/knife-cloud/tree/v1.2.0) (2015-07-18)
-[Full Changelog](https://github.com/chef/knife-cloud/compare/v1.2.0.rc.0...v1.2.0)
-
-**Closed issues:**
-
-- both -F json ad --format json does not work  [\#91](https://github.com/chef/knife-cloud/issues/91)
-
-**Merged pull requests:**
-
-- Adding support for floating ip commands [\#96](https://github.com/chef/knife-cloud/pull/96) ([Vasu1105](https://github.com/Vasu1105))
-
-## [v1.2.0.rc.0](https://github.com/chef/knife-cloud/tree/v1.2.0.rc.0) (2015-06-25)
-[Full Changelog](https://github.com/chef/knife-cloud/compare/v1.1.0...v1.2.0.rc.0)
-
-**Merged pull requests:**
-
-- Show result in the format provided by user in -F or --format option [\#93](https://github.com/chef/knife-cloud/pull/93) ([NimishaS](https://github.com/NimishaS))
-
-## [v1.1.0](https://github.com/chef/knife-cloud/tree/v1.1.0) (2015-06-18)
-[Full Changelog](https://github.com/chef/knife-cloud/compare/v1.1.0.rc.0...v1.1.0)
-
-**Merged pull requests:**
-
-- bumped the version for a full release [\#92](https://github.com/chef/knife-cloud/pull/92) ([jjasghar](https://github.com/jjasghar))
-
-## [v1.1.0.rc.0](https://github.com/chef/knife-cloud/tree/v1.1.0.rc.0) (2015-06-10)
-[Full Changelog](https://github.com/chef/knife-cloud/compare/1.0.1...v1.1.0.rc.0)
-
-**Closed issues:**
-
-- Unable to create server w/ v1.0 [\#82](https://github.com/chef/knife-cloud/issues/82)
-
-**Merged pull requests:**
-
-- Updated an RC version [\#90](https://github.com/chef/knife-cloud/pull/90) ([jjasghar](https://github.com/jjasghar))
-- Updated the readme [\#89](https://github.com/chef/knife-cloud/pull/89) ([jjasghar](https://github.com/jjasghar))
-- the chef\_version is broken [\#88](https://github.com/chef/knife-cloud/pull/88) ([jjasghar](https://github.com/jjasghar))
-- Looks like you doubled up some code [\#87](https://github.com/chef/knife-cloud/pull/87) ([jjasghar](https://github.com/jjasghar))
-- Update knife-cloud to have all the new bootstrap options of Chef 12 [\#85](https://github.com/chef/knife-cloud/pull/85) ([NimishaS](https://github.com/NimishaS))
-- remove 'em-winrm' gem dependency [\#83](https://github.com/chef/knife-cloud/pull/83) ([prabhu-das](https://github.com/prabhu-das))
-
-## [1.0.1](https://github.com/chef/knife-cloud/tree/1.0.1) (2014-09-19)
-[Full Changelog](https://github.com/chef/knife-cloud/compare/1.0.0...1.0.1)
-
-**Closed issues:**
-
-- floating-ips seem to throw an error with knife-openstack [\#78](https://github.com/chef/knife-cloud/issues/78)
-- -i and -x no longer work with ssh [\#74](https://github.com/chef/knife-cloud/issues/74)
-
-**Merged pull requests:**
-
-- Limit hostnames to 15 characters \(for windows\) [\#81](https://github.com/chef/knife-cloud/pull/81) ([hh](https://github.com/hh))
-
-## [1.0.0](https://github.com/chef/knife-cloud/tree/1.0.0) (2014-08-11)
-[Full Changelog](https://github.com/chef/knife-cloud/compare/1.0.0.rc.0...1.0.0)
-
-**Merged pull requests:**
-
-- Release knife-cloud 1.0.0 [\#80](https://github.com/chef/knife-cloud/pull/80) ([adamedx](https://github.com/adamedx))
-- \[knife-cloud\] Change Fog to dev dependency [\#79](https://github.com/chef/knife-cloud/pull/79) ([siddheshwar-more](https://github.com/siddheshwar-more))
-
-## [1.0.0.rc.0](https://github.com/chef/knife-cloud/tree/1.0.0.rc.0) (2014-07-27)
-**Closed issues:**
-
-- -a for floating IPs is broken with knife-openstack [\#76](https://github.com/chef/knife-cloud/issues/76)
-
-**Merged pull requests:**
-
-- Release candidate knife-cloud 1.0.0.rc.0 [\#77](https://github.com/chef/knife-cloud/pull/77) ([adamedx](https://github.com/adamedx))
-- \[knife-cloud\] Common short options in ssh & winrm \(SSH override winrm config\) [\#75](https://github.com/chef/knife-cloud/pull/75) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- \[knife-cloud\] Add missing bootstrap options to knife-cloud [\#73](https://github.com/chef/knife-cloud/pull/73) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- Added changes for template-file option [\#72](https://github.com/chef/knife-cloud/pull/72) ([kaustubh-d](https://github.com/kaustubh-d))
-- knife-ec2 master to knife-ec2 knife-cloud sync [\#71](https://github.com/chef/knife-cloud/pull/71) ([prabhu-das](https://github.com/prabhu-das))
-- Specify name or id for image and flavor in server create [\#70](https://github.com/chef/knife-cloud/pull/70) ([kaustubh-d](https://github.com/kaustubh-d))
-- \[knife-cloud\] Fixes for rspec deprecated warnings [\#69](https://github.com/chef/knife-cloud/pull/69) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- Sorting list outputs by sort\_by\_field with case insensitive sort. [\#68](https://github.com/chef/knife-cloud/pull/68) ([prabhu-das](https://github.com/prabhu-das))
-- \[knife-cloud\] KNIFE-477: Delete server by name if instance\_id isn't found [\#67](https://github.com/chef/knife-cloud/pull/67) ([ameyavarade](https://github.com/ameyavarade))
-- Changes for enabling network list [\#66](https://github.com/chef/knife-cloud/pull/66) ([prabhu-das](https://github.com/prabhu-das))
-- Refactored redundant code. [\#65](https://github.com/chef/knife-cloud/pull/65) ([ameyavarade](https://github.com/ameyavarade))
-- Fixed code and spec for Excon error [\#64](https://github.com/chef/knife-cloud/pull/64) ([prabhu-das](https://github.com/prabhu-das))
-- Remove extraneous use of active-support for the better good [\#63](https://github.com/chef/knife-cloud/pull/63) ([btm](https://github.com/btm))
-- Rebase integration tests [\#61](https://github.com/chef/knife-cloud/pull/61) ([muktaa](https://github.com/muktaa))
-- OC-10611 implementation for custom\_arguments passed to Fog [\#57](https://github.com/chef/knife-cloud/pull/57) ([prabhu-das](https://github.com/prabhu-das))
-- Updated test windows template to latest knife windows \( -V 0.5.14\) template. [\#56](https://github.com/chef/knife-cloud/pull/56) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- OC-11210 EC2 refactored code has ambiguity in the name of short-option for Gateway & Groups [\#54](https://github.com/chef/knife-cloud/pull/54) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- OC-11204 - Exception handling and abstraction [\#53](https://github.com/chef/knife-cloud/pull/53) ([kaustubh-d](https://github.com/kaustubh-d))
-- OC-11140 nested values support [\#51](https://github.com/chef/knife-cloud/pull/51) ([prabhu-das](https://github.com/prabhu-das))
-- OC-10823 knife-ec2 server create and bootstrap windows instance using ssh [\#48](https://github.com/chef/knife-cloud/pull/48) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- Handle fog errors in knife-cloud [\#47](https://github.com/chef/knife-cloud/pull/47) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- Updated code to reflect server name for both openstack and ec2 when --ch... [\#46](https://github.com/chef/knife-cloud/pull/46) ([prabhu-das](https://github.com/prabhu-das))
-- OC-10520 knife-cloud should add data summary methods [\#43](https://github.com/chef/knife-cloud/pull/43) ([ameyavarade](https://github.com/ameyavarade))
-- OC-9950 Support common options of knife bootstrap in knife cloud [\#42](https://github.com/chef/knife-cloud/pull/42) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- OC-9596: Succesfully run the integration tests on jenkins for knife-openstack\(based on knife-cloud\) [\#41](https://github.com/chef/knife-cloud/pull/41) ([adamedx](https://github.com/adamedx))
-- OC-9430: Knife cloud should support endpoint config and cli option [\#40](https://github.com/chef/knife-cloud/pull/40) ([adamedx](https://github.com/adamedx))
-- Let knife-windows find the template based on distro supplied. [\#38](https://github.com/chef/knife-cloud/pull/38) ([chirag-jog](https://github.com/chirag-jog))
-- Updated rspec tests for server list, create command [\#36](https://github.com/chef/knife-cloud/pull/36) ([adamedx](https://github.com/adamedx))
-- Updated rspec tests for server list, create command [\#35](https://github.com/chef/knife-cloud/pull/35) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- OC-9613: os\_image\_type should be inferred from bootstrap protocol if not specified to knife cloud [\#34](https://github.com/chef/knife-cloud/pull/34) ([adamedx](https://github.com/adamedx))
-- OC-9533 knife CLOUD server list needs to expose Chef data \(node names, attributes\) [\#33](https://github.com/chef/knife-cloud/pull/33) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- OC-9207: OC-9390: Dynamic Fog gem versioning, Exit code handling [\#31](https://github.com/chef/knife-cloud/pull/31) ([adamedx](https://github.com/adamedx))
-- OC 9450 - Auto generate chef node name when not input by user [\#30](https://github.com/chef/knife-cloud/pull/30) ([muktaa](https://github.com/muktaa))
-- OC-8965: Provide CLI option to delete server on bootstrap failure [\#28](https://github.com/chef/knife-cloud/pull/28) ([adamedx](https://github.com/adamedx))
-- OC-9368 Image\_os\_type option should be compulsory in knife-openstack. [\#26](https://github.com/chef/knife-cloud/pull/26) ([siddheshwar-more](https://github.com/siddheshwar-more))
-- Sprint 86: Merge Gem dependencies, Travis support [\#24](https://github.com/chef/knife-cloud/pull/24) ([adamedx](https://github.com/adamedx))
-- oc 8965 delete server when bootstrap fails [\#23](https://github.com/chef/knife-cloud/pull/23) ([muktaa](https://github.com/muktaa))
-- 9107 knife cloud travis [\#22](https://github.com/chef/knife-cloud/pull/22) ([muktaa](https://github.com/muktaa))
-- Windows bootstrap support + correct gem dependency for knife-windows [\#20](https://github.com/chef/knife-cloud/pull/20) ([muktaa](https://github.com/muktaa))
-- Windows bootstrap support + correct gem dependency for knife-windows [\#18](https://github.com/chef/knife-cloud/pull/18) ([muktaa](https://github.com/muktaa))
-- OC-8572: Knife cloud openstack create with bootstrap Windows [\#16](https://github.com/chef/knife-cloud/pull/16) ([adamedx](https://github.com/adamedx))
-- OC-8822: Knife cloud openstack server list command [\#15](https://github.com/chef/knife-cloud/pull/15) ([adamedx](https://github.com/adamedx))
-- Resource Listing changes \(OC 8822, 8824, 8825, 8826\) [\#13](https://github.com/chef/knife-cloud/pull/13) ([muktaa](https://github.com/muktaa))
-- Add notices to sources [\#12](https://github.com/chef/knife-cloud/pull/12) ([adamedx](https://github.com/adamedx))
-- First working version of knife-cloud \(merged and rebased\) [\#10](https://github.com/chef/knife-cloud/pull/10) ([chirag-jog](https://github.com/chirag-jog))
-- Knife cloud plugin [\#9](https://github.com/chef/knife-cloud/pull/9) ([muktaa](https://github.com/muktaa))
-- OC-8310: Base framework library for knife plug-in tests [\#8](https://github.com/chef/knife-cloud/pull/8) ([adamedx](https://github.com/adamedx))
-- OC-8427: OC-8426: OC-8425: OC-8428: Unit tests for knife-cloud [\#7](https://github.com/chef/knife-cloud/pull/7) ([adamedx](https://github.com/adamedx))
-- OC-8312: Knife-cloud gem skeleton [\#6](https://github.com/chef/knife-cloud/pull/6) ([adamedx](https://github.com/adamedx))
-- OC-8312 Knife-cloud gem skeleton [\#3](https://github.com/chef/knife-cloud/pull/3) ([kaustubh-d](https://github.com/kaustubh-d))
-
-
-
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

data/CONTRIBUTING.md

@@ -1,5 +0,0 @@
-# Contributing to knife-cloud
-
-We are glad you want to contribute to knife-cloud. Please see contribution guidelines for
-[Chef](http://wiki.opscode.com/display/chef/How+to+Contribute) for information on contributing to this project.
-

data/Gemfile

@@ -1,9 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in knife-cloud.gemspec
-gemspec
-
-group :development do
-  gem 'rake'
-  gem 'knife-windows'
-end

data/README.md

@@ -1,421 +0,0 @@
-# Knife Cloud
-
-[![Build Status](https://travis-ci.org/chef/knife-cloud.svg?branch=master)](https://travis-ci.org/chef/knife-cloud)
-[![Code Climate](http://img.shields.io/codeclimate/github/opscode/knife-cloud.svg)][codeclimate]
-
-[codeclimate]: https://codeclimate.com/github/chef/knife-cloud
-
-## Description
-
-`knife-cloud` is a library for implementing knife plugins that integrate cloud
-infrastructure with Chef. For more information about knife and Chef visit https://chef.io/chef.
-
-## Purpose
-
-The knife-cloud library has been designed to integrate the common tasks of all knife plugins. As a developer of a knife plugin, you will not have to worry about writing generic code in your plugin, eg: the Chef bootstrap code or SSH / WinRM connection code.
-
-## Installation
-
-This library is distributed as a Ruby Gem. To install it, run:
-
-    $ gem install knife-cloud
-    $ # OR
-    $ chef exec gem install knife-cloud
-
-Depending on your system's configuration, you may need to run this command with root privileges.
-Alternatively, you can build the gem from the knife-cloud source code.
-
-	$ git clone https://github.com/chef/knife-cloud
-	$ cd knife-cloud
-	$ rake gem
-	$ gem install knife-cloud-x.y.z.gem
-
-## Writing your custom plugin
-
-General documentation of how to develop a knife plugin can be found in
-[Chef documentation](http://docs.chef.io/plugin_knife_custom.html). Use of
-the `knife-cloud` gem to implement the plugin automates many aspects of the
-process.
-
-Here is an example of how `knife-cloud` can be used. First, create a new ruby project, say knife-myplugin. Add the knife-cloud gem to its gemspec.
-
-Sample gemspec:
-
-	# -*- encoding: utf-8 -*-
-	$:.push File.expand_path("../lib", __FILE__)
-	require "knife-myplugin/version"
-
-	Gem::Specification.new do |s|
-	  s.name        = "knife-myplugin"
-	  s.version     = Knife::Myplugin::VERSION
-	  s.platform    = Gem::Platform::RUBY
-	  s.has_rdoc = true
-	  s.extra_rdoc_files = ["README.md", "LICENSE" ]
-	  s.authors     = ["RockingSoul"]
-	  s.email       = ["rocking.soul@dreamworld.com"]
-	  s.homepage    = "https://github.com/dreamworld/knife-myplugin"
-	  s.summary     = %q{TODO}
-	  s.description = %q{TODO}
-
-	  s.files         = `git ls-files`.split("\n")
-	  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-	  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-	  s.require_paths = ["lib"]
-
-	  s.add_dependency "knife-cloud"
-
-	  %w(rspec-core rspec-expectations rspec-mocks rspec_junit_formatter).each { |gem| s.add_development_dependency gem }
-	end
-
-Sample Gemfile:
-
-	source "https://rubygems.org"
-
-	# Specify your gem's dependencies in knife-<yourcloud>.gemspec
-	gemspec
-
-	group :development do
-	  gem 'rspec', '>= 2.7.0'
-	  gem 'guard-rspec'
-	  gem 'rspec_junit_formatter'
-	  gem 'rake'
-	  gem 'mixlib-shellout'
-	end
-
-### Code structure
-
-Create a new ruby project, say knife-myplugin. Its code structure will look like:
-
-	lib
-		chef
-			knife
-				cloud
-					myplugin_service.rb
-					myplugin_service_options.rb
-					myplugin_server_create_options.rb
-				myplugin_server_create.rb
-				myplugin_server_delete.rb
-				myplugin_server_list.rb
-				myplugin_flavor_list.rb
-
-### Service
-
-- myplugin_service.rb
-
-Knife-cloud has a wrapper written for the Fog service. It can be used in your plugin as mentioned in the steps below. If ruby Fog does not have support for your cloud provider, you will have to write your own Service class analogous to the Chef::Knife::Cloud::FogService class which is defined in knife-cloud.
-* Add a dependency on the desired version of the `Fog` gem to your plugin's gemspec.
-* Implement your Service class which should inherit from the FogService class.
-
-Example Code:
-
-	require 'chef/knife/cloud/fog/service'
-	class Chef
-	  class Knife
-		class Cloud
-		  class MypluginService < FogService
-
-			def initialize(options = {})
-				# TODO - Add cloud specific auth params to be passed to fog connection. See knife-openstack for real life example.
-				super(options.merge({
-                              :auth_params => {
-                                :my_provider => 'MyPlugin',
-                                :my_name => 'demo_name',
-								:my_password => 'demo_password'
-                }}))
-			end
-
-		  end
-		end
-	  end
-	end
-
-#### Service Options
-
-- myplugin_service_options.rb
-
-This inherits all the options provided by Fog. You will have to add any cloud specific auth options.
-
-Example Code:
-
-	require 'chef/knife/cloud/fog/options'
-	class Chef
-	  class Knife
-		class Cloud
-		  module MypluginServiceOptions
-
-		   def self.included(includer)
-			  includer.class_eval do
-				include FogOptions
-
-				# TODO - define your cloud specific auth options.
-				# Example:
-				# Myplugin Connection params.
-				# option :azure_username,
-				#  :short => "-A USERNAME",
-				#  :long => "--myplugin-username KEY",
-				#  :description => "Your Myplugin Username",
-				#  :proc => Proc.new { |key| Chef::Config[:knife][:myplugin_username] = key }
-			  end
-			end
-		  end
-		end
-	  end
-	end
-
-### Server Create Command
-
-- myplugin_server_create.rb
-
-This class will inherit from the Chef::Knife::Cloud::ServerCreateCommand class.
-
-	require 'chef/knife/cloud/server/create_command'
-	require 'chef/knife/myplugin_helpers'
-	require 'chef/knife/cloud/myplugin_server_create_options'
-	require 'chef/knife/cloud/myplugin_service'
-	require 'chef/knife/cloud/myplugin_service_options'
-	require 'chef/knife/cloud/exceptions'
-
-	class Chef
-	  class Knife
-		class Cloud
-		  class MypluginServerCreate < ServerCreateCommand
-			include MypluginHelpers
-			include MypluginServerCreateOptions
-			include MypluginServiceOptions
-
-			banner "knife myplugin server create (options)"
-
-		  end
-		end
-	  end
-	end
-
-##### Override the methods below for plugin specific execution
-- before_exec_command
-
-- after_exec_command
-
-- before_bootstrap
-
-- validate_params!
-
-##### Code Example
-
-Following is the code template for the above methods
-
-		def before_exec_command
-            # setup the create options
-            # TODO - update this section to define the server_def that should be passed to fog for creating VM. This will be specific to your cloud.
-            # Example:
-            @create_options = {
-              :server_def => {
-                # servers require a name, knife-cloud generates the chef_node_name
-                :name => config[:chef_node_name],
-                :image_ref => locate_config_value(:image),
-                :flavor_ref => locate_config_value(:flavor),
-                #...
-              },
-              :server_create_timeout => locate_config_value(:server_create_timeout)
-            }
-
-            @create_options[:server_def].merge!({:user_data => locate_config_value(:user_data)}) if locate_config_value(:user_data)
-
-            Chef::Log.debug("Create server params - server_def = #{@create_options[:server_def]}")
-
-            # TODO - Update the columns info with the keys and callbacks required as per fog object returned for your cloud. Framework looks for 'key' on your image object hash returned by fog. If you need the values to be formatted or if your value is another object that needs to be looked up use value_callback.
-            # Example:
-            @columns_with_info = [
-              {:label => 'Instance ID', :key => 'id'},
-              {:label => 'Name', :key => 'name'},
-              {:label => 'Public IP', :key => 'addresses', :value_callback => method(:primary_public_ip_address)},
-              {:label => 'Private IP', :key => 'addresses', :value_callback => method(:primary_private_ip_address)},
-              {:label => 'Flavor', :key => 'flavor', :value_callback => method(:get_id)},
-              {:label => 'Image', :key => 'image', :value_callback => method(:get_id)},
-              {:label => 'Keypair', :key => 'key_name'},
-              {:label => 'State', :key => 'state'}
-            ]
-            super
-        end
-
-        def get_id(value)
-          value['id']
-        end
-
-        # Setup the floating ip after server creation.
-        def after_exec_command
-          # Any action you want to perform post VM creation in your cloud.
-          # Example say assigning floating IP to the newly created VM.
-          # Make calls to "service" object if you need any information for cloud, example service.connection.addresses
-          # Make call to "server" object if you want set properties on newly created VM, example server.associate_address(floating_address)
-
-          super
-        end
-
-        def before_bootstrap
-          super
-          # TODO - Set the IP address that should be used for connection with the newly created VM. This IP address is used for bootstrapping the VM and should be accessible from knife workstation.
-
-          # your logic goes here to set bootstrap_ip_address...
-
-          Chef::Log.debug("Bootstrap IP Address: #{bootstrap_ip_address}")
-          if bootstrap_ip_address.nil?
-            error_message = "No IP address available for bootstrapping."
-            ui.error(error_message)
-            raise CloudExceptions::BootstrapError, error_message
-          end
-          config[:bootstrap_ip_address] = bootstrap_ip_address
-        end
-
-        def validate_params!
-          super
-          errors = []
-
-          # TODO - Add your validation here for any create server parameters and populate errors [] with error message strings.
-
-          # errors << "your error message" if some_param_undefined
-
-          error_message = ""
-          raise CloudExceptions::ValidationError, error_message if errors.each{|e| ui.error(e); error_message = "#{error_message} #{e}."}.any?
-        end
-
-### Server Delete Command
-
-- myplugin_server_delete.rb
-
-You may just need to create your MypluginServerDelete class here. Unless your plugin has some very specific delete server case, you can leave the code just like shown in the example below:
-
-	require 'chef/knife/cloud/server/delete_options'
-	require 'chef/knife/cloud/server/delete_command'
-	require 'chef/knife/cloud/myplugin_service'
-	require 'chef/knife/cloud/myplugin_service_options'
-	require 'chef/knife/myplugin_helpers'
-
-	class Chef
-	  class Knife
-		class Cloud
-		  class MypluginServerDelete < ServerDeleteCommand
-			include ServerDeleteOptions
-			include MypluginServiceOptions
-			include MypluginHelpers
-
-			banner "knife myplugin server delete INSTANCEID [INSTANCEID] (options)"
-
-		  end
-		end
-	  end
-	end
-
-### Server List Command
-
-- myplugin_server_list.rb
-
-Your class MypluginServerList should inherit from Chef::Knife::Cloud::ServerListCommand class.
-
-Example -
-	require 'chef/knife/cloud/server/list_command'
-	require 'chef/knife/myplugin_helpers'
-	require 'chef/knife/cloud/myplugin_service_options'
-	require 'chef/knife/cloud/server/list_options'
-
-	class Chef
-	  class Knife
-		class Cloud
-		  class MypluginServerList < ServerListCommand
-			include MypluginHelpers
-			include MypluginServiceOptions
-			include ServerListOptions
-
-			banner "knife myplugin server list (options)"
-
-			def before_exec_command
-			  # TODO - Update the columns info with the keys and callbacks required as per fog object returned for your cloud. Framework looks for 'key' on your server object hash returned by fog. If you need the values to be formatted or if your value is another object that needs to be looked up use value_callback.
-
-			  @columns_with_info = [
-				{:label => 'Instance ID', :key => 'id'},
-				{:label => 'Name', :key => 'name'},
-				{:label => 'Public IP', :key => 'addresses', :value_callback => method(:your_callback)},
-				#...
-			  ]
-			  super
-			end
-
-			# TODO - callback example, this gets a object/value returned by server.addresses
-			def your_callback (addresses)
-			  #...
-			end
-
-		  end
-		end
-	  end
-	end
-
-### Flavor List Command
-
-- myplugin_flavor_list.rb
-
-For all other list commands other than the server-list, they must inherit from the Chef::Knife::Cloud::ResourceListCommand class.
-
-Example -
-
-	require 'chef/knife/cloud/list_resource_command'
-	require 'chef/knife/myplugin_helpers'
-	require 'chef/knife/cloud/myplugin_service_options'
-
-	class Chef
-	  class Knife
-		class Cloud
-		  class MypluginFlavorList < ResourceListCommand
-			include MypluginHelpers
-			include MypluginServiceOptions
-
-			banner "knife myplugin flavor list (options)"
-
-			def before_exec_command
-			  # Set columns_with_info map
-			  # TODO - Update the columns info with the keys and callbacks required as per fog object returned for your cloud. Framework looks for 'key' on your flavor object hash returned by fog. If you need the values to be formatted or if your value is another object that needs to be looked up use value_callback.
-			  # Example:
-			  @columns_with_info = [
-				{:label => 'ID', :key => 'id'},
-				{:label => 'Name', :key => 'name'},
-				{:label => 'Virtual CPUs', :key => 'vcpus'},
-				{:label => 'RAM', :key => 'ram', :value_callback => method(:ram_in_mb)},
-				{:label => 'Disk', :key => 'disk', :value_callback => method(:disk_in_gb)}
-			  ]
-			end
-
-			def query_resource
-			  @service.list_resource_configurations
-			end
-
-			# TODO - This is just for example
-			def ram_in_mb(ram)
-			  "#{ram} MB"
-			end
-
-			# TODO - This is just for example
-			def disk_in_gb(disk)
-			  "#{disk} GB"
-			end
-
-		  end
-		end
-	  end
-	end
-
-## License
-
-Copyright:: Copyright (c) 2014-2015 Chef Software, Inc.
-
-License:: Apache License, Version 2.0
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.