kitchen-terraform 3.1.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bed93c8d3edcaa9b632a77af795ef201b1fb3f38851ad1f7b64bccaf0a562e8
-  data.tar.gz: 1276013ec6e8e44701db466c2f1fec4160040c55d2fdeade8b5c9819b3c1dc96
+  metadata.gz: 7e4f5a91dd079948f39c823124a9abaa9373c1d75f820ab1361e35fdb2ad9a9a
+  data.tar.gz: c3b49fd224514f162064c83f3efa27eab7682822f667dc6fe7f79968b9e1e2e6
 SHA512:
-  metadata.gz: 85a1e4484b097b067041df44ef7a6e1d90ea57734df2e3f0ab45cb07d8a035da4405013ed76fa1928dafc7a65ac27a20877dfee8f933d6ecefd21db1dfbacc92
-  data.tar.gz: 4cbcc7946c975250266fa0dd725a1d8b7e3880929ccb592e30ae1ad1dea79859846c96914cdfd152098319f6024acf69bf6e48bc4cbc1e5d24e053f2c97dce07
+  metadata.gz: 4a0e0ddc1f49f69dbf5718892b6eeb665860a9381a0854862a9cd65a8ddccf0de4f30f602861a8dd9a909f6f6617d6569e7fa3d8a65864b1c9e65f250414bdd2
+  data.tar.gz: ff50fc286e891f70a7fdca14a826a2be0dc0638c64a3b00f5f69af632a10d8d0bad4053d7524e073f969ba44e800d4da5f61639723efdb3879c94a0e3f3cad3f

data/README.md

@@ -58,31 +58,18 @@ Each version of Kitchen-Terraform is published as a
 [Ruby gem][ruby-gems-what-is] to [RubyGems.org][kitchen-terraform-gem]
 which makes them readily available for installation on a system.
 
-#### RubyGems
-
-To install a version of Kitchen-Terraform using the default Ruby package
-manager, RubyGems, run a command like the following example.
-
-> Installing Kitchen-Terraform with RubyGems
-
-```sh
-gem install kitchen-terraform --version 3.1.0
-```
-
-More information can be found in the
-[RubyGems: Installing Gems][rubygems-installing-gems] article.
-
 #### Bundler
 
-[Bundler][bundler] can also be used to manage versions of
-Kitchen-Terraform on the system in a manner that is easily reproducible
-on other systems.
+[Bundler][bundler] should be used to manage versions of
+Kitchen-Terraform on the system. Using Bundler provides easily
+reproducible Ruby gem installations that can be shared with other
+systems.
 
 First, create a `Gemfile` with contents like the following example. The
 pessimistic pinning of the version is recommended to benefit from
 the semantic versioning of the Ruby gem.
 
-> Defining Kitchen-Terraform as a dependency for Bundler
+> Defining Kitchen-Terraform as a dependency for Bundler in a Gemfile
 
 ```ruby
 source "https://rubygems.org/" do
@@ -101,9 +88,31 @@ Second, run the following command.
 bundle install
 ```
 
+The preceding command will create a `Gemfile.lock` comprising a list
+of the resolved Ruby gem dependencies.
+
 More information can be found in the
 [Bundler: In Depth][bundler-in-depth] article.
 
+#### RubyGems
+
+RubyGems, the default Ruby package manager, can also be used to install
+a version of Kitchen-Terraform by running a command like the following
+example.
+
+> Installing Kitchen-Terraform with RubyGems
+
+```sh
+gem install kitchen-terraform --version 3.1.0
+```
+
+This approach is not recommended as it requires more effort to install
+the gem in a manner that is reproducible and free of dependency
+conflicts.
+
+More information can be found in the
+[RubyGems: Installing Gems][rubygems-installing-gems] article.
+
 ## Usage
 
 ### Configuration
@@ -127,17 +136,28 @@ More information can be found in the
 
 ### Example
 
-Assume there is a system which has Kitchen-Terraform and
-[Docker][docker] installed.
+This example demonstrates how to test a simple Terraform configuration
+which utilizes the [Docker provider][docker-provider].
+
+The test system is assumed to be running Ubuntu 17.04.
+
+Kitchen-Terraform and its dependencies are assumed to have been
+installed on the test system as described in the
+[Installation](#installation) section.
+
+The [Docker Community Editiion][docker-community-edition] is assumed to
+have been installed on the test system.
 
-Assume the working directory on said system a hierarchy like the
-following examples.
+The working directory on the test system is assumed to contain a
+hierarchy of files comprising the following blocks.
 
 > Directory hierarchy
 
 ```
 .
 ├── .kitchen.yml
+├── Gemfile
+├── Gemfile.lock
 ├── main.tf
 └── test
     └── integration
@@ -147,7 +167,7 @@ following examples.
             └── inspec.yml
 ```
 
-> ./.kitchen.yml
+> ./.kitchen.yml (Test Kitchen configuration)
 
 ```yaml
 driver:
@@ -233,7 +253,7 @@ and verify that the container is running Ubuntu.
 > Verifying with Kitchen-Terraform
 
 ```sh
-$ kitchen test
+$ bundle exec kitchen test
 -----> Starting Kitchen...
 ...
 $$$$$$ Running command `terraform init...`
@@ -334,6 +354,8 @@ Kitchen-Terraform is distributed under the [Apache License][license].
 [contributing-document]: https://github.com/newcontext-oss/kitchen-terraform/blob/master/CONTRIBUTING.md
 [developing-document]: https://github.com/newcontext-oss/kitchen-terraform/blob/master/DEVELOPING.md
 [docker]: https://www.docker.com/
+[docker-community-edition]: https://store.docker.com/editions/community/docker-ce-server-ubuntu
+[docker-provider]: https://www.terraform.io/docs/providers/docker/index.html
 [gem-downloads-total-shield]: https://img.shields.io/gem/dt/kitchen-terraform.svg?style=plastic
 [gem-downloads-version-shield]: https://img.shields.io/gem/dtv/kitchen-terraform.svg?style=plastic
 [gem-version-shield]: https://img.shields.io/gem/v/kitchen-terraform.svg?style=plastic

data/lib/kitchen/terraform/version.rb

@@ -17,4 +17,4 @@
 require "kitchen/terraform"
 
 # The version of the kitchen-terraform gem.
-::Kitchen::Terraform::VERSION = "3.1.0".freeze
+::Kitchen::Terraform::VERSION = "3.2.0".freeze

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kitchen-terraform
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.2.0
 platform: ruby
 authors:
 - Aaron Lane
@@ -55,7 +55,7 @@ cert_chain:
   XjOfZudLs1zJ8ZNOuwj6KkGJ9J3XHd9hM95MtBEWlxAfYdCuW1+v7zCTfbieBEba
   UIyyldg4TuVcuRs8uKJyempT0hqx2DniseBWw3nvtgom3A==
   -----END CERTIFICATE-----
-date: 2018-01-08 00:00:00.000000000 Z
+date: 2018-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -477,7 +477,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.2'
   - - "<"
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -486,7 +486,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements:
 - Terraform >= 0.10.2, < 0.12.0
 rubyforge_project: 
-rubygems_version: 2.7.4
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Test Kitchen plugins for testing Terraform configuration