kitchen-vra 3.3.4 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fafa7c0d38316e0caed88baf634bd75e30f096bfe9798edcd1a9e3d7a5c994ff
-  data.tar.gz: 7a50b7b1e4189297c2b739f4ea5eac816550b0097129709e2e99d4f53c1d870e
+  metadata.gz: c3ad4a4ab887a646b1856e8329bfa319f85c85adf5ab1d55785ed443e31ea623
+  data.tar.gz: b178306e4e6e20e88f27d1274913a6bf7c2be4ba9871fda69b8373938550783f
 SHA512:
-  metadata.gz: ad976260af42bb96af58b18b9cd3837f5eda92c0b98b8e86d29676e76862cb1d9c3d4c3dbd604fb09018415622a53f4796d1f79673b357215023dff53854076b
-  data.tar.gz: 0b9fb222821945220304a7d04bffea5b80f98adbf156d43aef3b09aa2d5f75e43619eae90793146984a11e99e07d1f9b9425752aa783f647351d6dca6f0426b1
+  metadata.gz: 4e2cbf243619ad72b38384a2520e7ccc68646e16c472e1356e088f00058ebf707e86aa558470dd75fb17b13a0742448ea1c822b73e1e38482340e1296b9a0686
+  data.tar.gz: 1a85f3b0bb3cbd9fa872a057225e0ab9494940830bbb68833b81968fc197b2e883bf32163022dbe83cb8eba5abce8212ba9467e8e5dd62c8462185a4236d92b6

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.3.4"
+  ".": "3.4.0"
 }

data/CHANGELOG.md

@@ -10,6 +10,19 @@
 * Docs: rewrite README for new users and split contributor docs ([#80](https://github.com/test-kitchen/kitchen-vra/pull/80)) ([d9ebc45](https://github.com/test-kitchen/kitchen-vra/commit/d9ebc45))
 * Standardize renovate config and remove dependabot ([#81](https://github.com/test-kitchen/kitchen-vra/pull/81)) ([be552bd](https://github.com/test-kitchen/kitchen-vra/commit/be552bd))
 
+## [3.4.0](https://github.com/test-kitchen/kitchen-vra/compare/v3.3.4...v3.4.0) (2026-08-24)
+
+
+### Features
+
+* implement the driver status hook ([#88](https://github.com/test-kitchen/kitchen-vra/issues/88)) ([933e254](https://github.com/test-kitchen/kitchen-vra/commit/933e25445d1a231490ef977cbbfd9644aa16022d))
+
+
+### Bug Fixes
+
+* constrain the test-kitchen dependency ([#86](https://github.com/test-kitchen/kitchen-vra/issues/86)) ([ac5f32d](https://github.com/test-kitchen/kitchen-vra/commit/ac5f32d1dd5eb132c91a3fda58ee41f778148245))
+* drop the unused rack runtime dependency ([#89](https://github.com/test-kitchen/kitchen-vra/issues/89)) ([b68f1fd](https://github.com/test-kitchen/kitchen-vra/commit/b68f1fdd4dfc6d1a0c37320f8b099b5d0ca19c8a))
+
 ## [3.3.4](https://github.com/test-kitchen/kitchen-vra/compare/v3.3.3...v3.3.4) (2026-08-23)
 
 

data/Gemfile

@@ -10,10 +10,6 @@ group :test do
   gem "webmock"
 end
 
-group :debug do
-  gem "pry"
-end
-
 group :docs do
   gem "yard"
 end

data/kitchen-vra.gemspec

@@ -20,9 +20,8 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 3.1"
 
-  spec.add_dependency "test-kitchen"
+  spec.add_dependency "test-kitchen", ">= 3.0", "< 5"
   spec.add_dependency "vmware-vra", "~> 3.0", ">= 3.2.0" # 3.0 required for vRA 8.x
   spec.add_dependency "highline"
-  spec.add_dependency "rack", ">= 1.6", "< 4.0"
   spec.add_dependency "ffi-yajl", ">= 2.2.3", "< 3.1.0"
 end

data/lib/kitchen/driver/vra.rb

@@ -25,6 +25,7 @@ require "base64" unless defined?(Base64)
 require "digest" unless defined?(Digest)
 require "fileutils" unless defined?(FileUtils)
 require "vra"
+require "time" unless defined?(Time.now.iso8601)
 require_relative "vra_version"
 
 module Kitchen
@@ -46,6 +47,11 @@ module Kitchen
       kitchen_driver_api_version 2
       plugin_version Kitchen::Driver::VRA_VERSION
 
+      # Deployment statuses vRA reports for a deployment that is up.
+      #
+      # @return [Array<String>]
+      LIVE_STATUSES = %w{CREATE_SUCCESSFUL}.freeze
+
       # Location of the credential cache, relative to the working directory.
       CREDENTIALS_CACHE_FILE = ".kitchen/cached_vra"
 
@@ -314,6 +320,41 @@ module Kitchen
         end
       end
 
+      # Reports what vRA currently thinks of the deployment.
+      #
+      # @param state [Hash] instance state naming the deployment
+      # @return [Hash] a Test Kitchen status hash, or the base implementation's
+      #   answer when there is no deployment or vRA does not know it
+      def status(state)
+        return super unless state[:deployment_id]
+
+        deployment = lookup_deployment(state[:deployment_id])
+        return super unless deployment
+
+        deployment_status = deployment.status.to_s
+        {
+          live: LIVE_STATUSES.include?(deployment_status),
+          state: deployment_status,
+          source: "driver",
+          resource_id: state[:deployment_id],
+          message: "vRA reports the deployment as #{deployment_status}",
+          checked_at: Time.now.utc.iso8601,
+        }
+      end
+
+      # Looks a deployment up without turning an unreachable vRA into a
+      # failure. A deployment that has already been destroyed answers with
+      # NotFound, which is a real answer rather than an error.
+      #
+      # @param deployment_id [String] the vRA deployment ID
+      # @return [Vra::Deployment, nil] the deployment, or nil when vRA does not
+      #   know it or cannot be reached
+      def lookup_deployment(deployment_id)
+        vra_client.deployments.by_id(deployment_id)
+      rescue ::StandardError
+        nil
+      end
+
       # Destroys the vRA deployment, if one exists.
       #
       # A deployment that vRA no longer knows about, or that offers no destroy

data/lib/kitchen/driver/vra_version.rb

@@ -23,6 +23,6 @@ module Kitchen
   # Test Kitchen's driver plugins.
   module Driver
     # The version of the kitchen-vra gem.
-    VRA_VERSION = "3.3.4"
+    VRA_VERSION = "3.4.0"
   end
 end

data/spec/vra_spec.rb

@@ -330,6 +330,64 @@ describe Kitchen::Driver::Vra do
     end
   end
 
+  describe "#status" do
+    let(:deployments) { double("deployments") }
+    let(:vra_client)  { double("vra_client", deployments: deployments) }
+
+    before { allow(driver).to receive(:vra_client).and_return(vra_client) }
+
+    it "reports an unknown status when state names no deployment" do
+      expect(driver.status({})).to include(live: nil, state: "unknown")
+    end
+
+    it "reports an unknown status when vRA has never heard of the deployment" do
+      allow(deployments).to receive(:by_id).with("gone")
+        .and_raise(Vra::Exception::NotFound.new("nope"))
+
+      expect(driver.status(deployment_id: "gone")).to include(state: "unknown")
+    end
+
+    it "reports a successfully created deployment as live" do
+      allow(deployments).to receive(:by_id).with("dep-1")
+        .and_return(double(status: "CREATE_SUCCESSFUL"))
+
+      expect(driver.status(deployment_id: "dep-1")).to include(
+        live: true, state: "CREATE_SUCCESSFUL", source: "driver",
+        resource_id: "dep-1"
+      )
+    end
+
+    it "stamps when the check happened" do
+      allow(deployments).to receive(:by_id)
+        .and_return(double(status: "CREATE_SUCCESSFUL"))
+
+      expect(driver.status(deployment_id: "dep-1")[:checked_at])
+        .to match(/\A\d{4}-\d{2}-\d{2}T/)
+    end
+
+    it "reports a deployment still building as not live" do
+      allow(deployments).to receive(:by_id)
+        .and_return(double(status: "CREATE_INPROGRESS"))
+
+      expect(driver.status(deployment_id: "dep-1"))
+        .to include(live: false, state: "CREATE_INPROGRESS")
+    end
+
+    it "names a failed deployment rather than reporting a bare false" do
+      allow(deployments).to receive(:by_id)
+        .and_return(double(status: "CREATE_FAILED"))
+
+      expect(driver.status(deployment_id: "dep-1"))
+        .to include(live: false, state: "CREATE_FAILED")
+    end
+
+    it "reports an unknown status when vRA cannot be reached" do
+      allow(deployments).to receive(:by_id).and_raise(StandardError.new("boom"))
+
+      expect(driver.status(deployment_id: "dep-1")).to include(state: "unknown")
+    end
+  end
+
   describe "#destroy" do
     let(:deployment_id)     { "8c1a833a-5844-4100-b58c-9cab3543c958" }
     let(:state)           { { deployment_id: deployment_id } }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kitchen-vra
 version: !ruby/object:Gem::Version
-  version: 3.3.4
+  version: 3.4.0
 platform: ruby
 authors:
 - Chef Community Tools Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-23 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-kitchen
@@ -16,14 +16,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
 - !ruby/object:Gem::Dependency
   name: vmware-vra
   requirement: !ruby/object:Gem::Requirement
@@ -58,26 +64,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: rack
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.6'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '1.6'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: ffi-yajl
   requirement: !ruby/object:Gem::Requirement