ruby-terraform 1.9.0.pre.2 → 1.9.0.pre.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c65ee46422f0dfadfbddbb77d95c836b4bf154b4b720d5dedfb3976c34db5e9a
-  data.tar.gz: 3e09a684d61a20306e41c9449e7b4d806537c51c375af3c32bee699a73ca419d
+  metadata.gz: 7f785dd368c756138288d8ac5be5cce139b42549e9e33b705a88b9618671df3b
+  data.tar.gz: 5cf820a332f2b6db7c8edd708e3b018c9979775cd3edc22efa58fefe9c0721e4
 SHA512:
-  metadata.gz: 602291f0a8415196453a5301134d3ad734b593863d8621aa1d036adaba87e98ea44cfd1ea147ba2d34480c13cfa0be4e17416ea85e8d38befe0ef38eceae42bc
-  data.tar.gz: 37b5f4580722669fa1d723c12c83beefb6d727b89bb5300fc6f2f5910a460c9370fd99cb6176d64b11a1851e8107d9d4aa9bba8f6cbd02de0952df88a4ee662a
+  metadata.gz: 22029c8ebc37a74fee4c70bff57f027aedec45937b6a2272e3444f0d840f879167d46ec98cc3353617c75a417eba1e4ea7d867d58161b68ff3b31aeaed06e9ba
+  data.tar.gz: b5dd1103942436aa721155e3dbffb01e509fe9d31f9908d9f6fc1e43c3b547ff2c640889b2569822769dc7f32967f27360c58824dc09a028fbe8a2257938448c

data/Gemfile.lock

@@ -1,56 +1,62 @@
 PATH
   remote: .
   specs:
-    ruby-terraform (1.9.0.pre.2)
+    ruby-terraform (1.9.0.pre.3)
       immutable-struct (~> 2.4)
       lino (>= 4.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.3.4)
+    activesupport (7.2.3.1)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
-      minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
-    ast (2.4.2)
-    base64 (0.2.0)
-    bigdecimal (3.1.8)
+      logger (>= 1.4.2)
+      minitest (>= 5.1, < 6)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    benchmark (0.5.0)
+    bigdecimal (4.0.1)
     childprocess (5.0.0)
     coderay (1.1.3)
     colored2 (3.1.2)
-    concurrent-ruby (1.3.3)
-    connection_pool (2.4.1)
-    diff-lcs (1.5.1)
+    concurrent-ruby (1.3.6)
+    connection_pool (2.5.5)
+    diff-lcs (1.6.2)
     docile (1.4.0)
-    drb (2.2.1)
+    drb (2.2.3)
     excon (0.111.0)
-    faker (3.4.2)
+    faker (3.6.1)
       i18n (>= 1.8.11, < 2)
-    faraday (2.10.0)
-      faraday-net_http (>= 2.0, < 3.2)
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
       logger
-    faraday-net_http (3.1.0)
-      net-http
-    ffi (1.17.0)
-    ffi (1.17.0-arm64-darwin)
-    ffi (1.17.0-x86_64-darwin)
-    ffi (1.17.0-x86_64-linux)
-    formatador (1.1.0)
-    gem-release (2.2.2)
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    ffi (1.17.3)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    formatador (1.2.3)
+      reline
+    gem-release (2.2.4)
     git (1.19.1)
       addressable (~> 2.8)
       rchardet (~> 1.8)
-    guard (2.18.1)
+    guard (2.20.1)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
+      logger (~> 1.6)
       lumberjack (>= 1.0.12, < 2.0)
       nenv (~> 0.1)
       notiffany (~> 0.0)
@@ -64,26 +70,28 @@ GEM
       rspec (>= 2.99.0, < 4.0)
     hamster (3.0.0)
       concurrent-ruby (~> 1.0)
-    i18n (1.14.5)
+    i18n (1.14.8)
       concurrent-ruby (~> 1.0)
-    immutable-struct (2.4.1)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
+    immutable-struct (2.5.0)
+    io-console (0.8.2)
+    json (2.19.2)
+    language_server-protocol (3.17.0.5)
     lino (4.1.0)
       childprocess (~> 5.0.0)
       hamster (~> 3.0)
       open4 (~> 1.3)
-    listen (3.9.0)
+    lint_roller (1.1.0)
+    listen (3.10.0)
+      logger
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    logger (1.6.0)
-    lumberjack (1.2.10)
+    logger (1.7.0)
+    lumberjack (1.4.2)
     method_source (1.1.0)
-    minitest (5.24.1)
-    mutex_m (0.2.0)
+    minitest (5.27.0)
     nenv (0.3.0)
-    net-http (0.4.1)
-      uri
+    net-http (0.9.1)
+      uri (>= 0.11.1)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
@@ -92,17 +100,19 @@ GEM
       faraday (>= 1, < 3)
       sawyer (~> 0.9)
     open4 (1.3.4)
-    parallel (1.25.1)
-    parser (3.3.4.0)
+    parallel (1.27.0)
+    parser (3.3.10.1)
       ast (~> 2.4.1)
       racc
-    pry (0.14.2)
+    prism (1.9.0)
+    pry (0.16.0)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (6.0.1)
-    racc (1.8.0)
+      reline (>= 0.6.0)
+    public_suffix (6.0.2)
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.2.1)
+    rake (13.4.2)
     rake_circle_ci (0.13.0)
       colored2 (~> 3.1)
       excon (~> 0.72)
@@ -136,39 +146,42 @@ GEM
     rb-inotify (0.11.1)
       ffi (~> 1.0)
     rchardet (1.8.0)
-    regexp_parser (2.9.2)
-    rexml (3.3.2)
-      strscan
-    rspec (3.13.0)
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.0)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.1)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.1)
+    rspec-mocks (3.13.7)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.1)
-    rubocop (1.65.0)
+    rspec-support (3.13.7)
+    rubocop (1.84.2)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.4, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.3)
-      parser (>= 3.3.1.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (3.0.3)
-      rubocop (~> 1.61)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.9.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.81)
     ruby-progressbar (1.13.0)
     ruby_git_crypt (0.1.0)
       immutable-struct (~> 2.4)
@@ -178,6 +191,7 @@ GEM
     sawyer (0.9.2)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
+    securerandom (0.4.1)
     shellany (0.0.1)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -186,13 +200,14 @@ GEM
     simplecov-html (0.12.3)
     simplecov_json_formatter (0.1.4)
     sshkey (2.0.0)
-    strscan (3.1.0)
-    thor (1.3.1)
+    thor (1.5.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.5.0)
-    uri (0.13.0)
-    yard (0.9.36)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    yard (0.9.43)
 
 PLATFORMS
   arm64-darwin-21

data/README.md

@@ -29,7 +29,7 @@ require 'ruby-terraform'
 
 ### Supported versions and commands
 
-`RubyTerraform` supports all commands and options up to Terraform 0.15, except
+`RubyTerraform` supports all commands and options up to Terraform 1.5.7, except
 `terraform console`, `terraform test` and `terraform version`.
 
 ### Getting started

data/Rakefile

@@ -135,7 +135,7 @@ namespace :documentation do
 
     sh('git', 'commit',
        '-a',
-       '-m', "Generate latest documentation#{skip_ci ? ' [ci skip]' : ''}")
+       '-m', "Generate latest documentation#{' [ci skip]' if skip_ci}")
   end
 
   desc 'Update documentation'
@@ -157,7 +157,7 @@ RakeCircleCI.define_project_tasks(
   t.environment_variables = {
     ENCRYPTION_PASSPHRASE:
         File.read('config/secrets/ci/encryption.passphrase')
-            .chomp
+        .chomp
   }
   t.checkout_keys = []
   t.ssh_keys = [

data/lib/ruby_terraform/commands/test.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+require_relative '../options/global'
+
+module RubyTerraform
+  module Commands
+    # Wraps the +terraform test+ command which executes automated integration
+    # tests defined in +.tftest.hcl+ files.
+    #
+    # Terraform discovers test files in the configured test directory (by
+    # default +tests+) and in the root module, then runs each +run+ block in
+    # turn, reporting on the outcome of the assertions.
+    #
+    # For options accepted on construction, see {#initialize}.
+    #
+    # When executing an instance of {Test} via {#execute}, the following
+    # options are supported:
+    #
+    # * +:chdir+: the path of a working directory to switch to before executing
+    #   the given subcommand.
+    # * +:cloud_run+: if set, executes the tests remotely using the given
+    #   Terraform Cloud/Enterprise module source address rather than running
+    #   them locally.
+    # * +:filter+: restrict which test files are executed; if both +:filter+
+    #   and +:filters+ are provided, all filters will be passed to terraform.
+    # * +:filters+: an array of test file paths to restrict which test files
+    #   are executed; if both +:filter+ and +:filters+ are provided, all
+    #   filters will be passed to terraform.
+    # * +:json+: whether or not to produce output in a machine-readable JSON
+    #   format; defaults to +false+.
+    # * +:no_color+: whether or not the output from the command should be in
+    #   color; defaults to +false+.
+    # * +:test_directory+: the directory containing test files; defaults to
+    #   +"tests"+.
+    # * +:vars+: a map of variables to be passed to the terraform configuration.
+    # * +:var_file+: the path to a terraform var file; if both +:var_file+ and
+    #   +:var_files+ are provided, all var files will be passed to terraform.
+    # * +:var_files+: an array of paths to terraform var files; if both
+    #   +:var_file+ and +:var_files+ are provided, all var files will be passed
+    #   to terraform.
+    # * +:verbose+: when +true+, print the plan or state for each test run
+    #   block as it executes; defaults to +false+.
+    #
+    # The {#execute} method accepts an optional second parameter which is a map
+    # of invocation options. Currently, the only supported option is
+    # +:environment+ which is a map of environment variables to expose during
+    # invocation of the command.
+    #
+    # @example Basic Invocation
+    #   RubyTerraform::Commands::Test.new.execute(
+    #     filters: ['tests/network.tftest.hcl'],
+    #     verbose: true)
+    #
+    class Test < Base
+      include RubyTerraform::Options::Global
+
+      # @!visibility private
+      def subcommands
+        %w[test]
+      end
+
+      # @!visibility private
+      def options
+        %w[
+          -cloud-run
+          -filter
+          -json
+          -no-color
+          -test-directory
+          -var
+          -var-file
+          -verbose
+        ] + super
+      end
+
+      # @!visibility private
+      def parameter_defaults(_parameters)
+        { vars: {}, var_files: [], filters: [] }
+      end
+    end
+  end
+end

data/lib/ruby_terraform/commands.rb

@@ -26,6 +26,7 @@ require_relative 'commands/state_replace_provider'
 require_relative 'commands/state_remove'
 require_relative 'commands/state_show'
 require_relative 'commands/taint'
+require_relative 'commands/test'
 require_relative 'commands/untaint'
 require_relative 'commands/validate'
 require_relative 'commands/workspace_delete'

data/lib/ruby_terraform/models/list.rb

@@ -29,7 +29,7 @@ module RubyTerraform
         :repeated_permutation, :repeated_combination,
         :product, :take, :take_while, :drop, :drop_while,
         :bsearch, :bsearch_index, :any?, :all?, :none?, :one?, :dig, :sum,
-        :deconstruct, :append, :prepend, :shuffle!, :shuffle, :sample, :pack
+        :deconstruct, :prepend, :shuffle!, :shuffle, :sample, :pack
       )
 
       def initialize(value, sensitive: false)

data/lib/ruby_terraform/models/plan.rb

@@ -32,7 +32,7 @@ module RubyTerraform
       def resource_changes
         (@content[:resource_changes] || [])
           .map do |resource_change|
-          ResourceChange.new(resource_change)
+            ResourceChange.new(resource_change)
         end
       end
 
@@ -47,7 +47,7 @@ module RubyTerraform
       def output_changes
         (@content[:output_changes] || [])
           .map do |output_name, output_change|
-          OutputChange.new(output_name, output_change)
+            OutputChange.new(output_name, output_change)
         end
       end
 

data/lib/ruby_terraform/options/definitions.rb

@@ -22,7 +22,7 @@ module RubyTerraform
         end,
 
         # string repeatable options
-        %w[-var-file -target -platform -plugin-dir -replace].map do |o|
+        %w[-var-file -target -platform -plugin-dir -replace -filter].map do |o|
           definition(
             name: o, option_type: :standard, value_type: :string,
             repeatable: true
@@ -68,6 +68,7 @@ module RubyTerraform
           -reconfigure
           -recursive
           -update
+          -verbose
         ].map do |o|
           definition(name: o, option_type: :flag, value_type: :boolean)
         end,
@@ -76,6 +77,7 @@ module RubyTerraform
         %w[
           -backup
           -backup-out
+          -cloud-run
           -from-module
           -fs-mirror
           -id
@@ -88,6 +90,7 @@ module RubyTerraform
           -provider
           -state
           -state-out
+          -test-directory
           -type
         ].map do |o|
           definition(name: o, option_type: :standard, value_type: :string)

data/lib/ruby_terraform/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyTerraform
-  VERSION = '1.9.0.pre.2'
+  VERSION = '1.9.0.pre.3'
 end

data/lib/ruby_terraform.rb

@@ -1316,6 +1316,56 @@ module RubyTerraform
            parameters, invocation_options)
     end
 
+    # Invokes the +terraform test+ command which executes integration tests
+    # defined in +.tftest.hcl+ files.
+    #
+    # Terraform discovers test files in the configured test directory (by
+    # default +tests+) and in the root module, then runs each +run+ block in
+    # turn, reporting on the outcome of the assertions.
+    #
+    # @param parameters The parameters used to invoke the command
+    # @option parameters [String] :chdir The path of a working directory to
+    #   switch to before executing the given subcommand.
+    # @option parameters [String] :cloud_run If set, executes the tests
+    #   remotely using the given Terraform Cloud/Enterprise module source
+    #   address rather than running them locally.
+    # @option parameters [String] :filter Restrict which test files are
+    #   executed; if both +:filter+ and +:filters+ are provided, all filters
+    #   will be passed to terraform.
+    # @option parameters [Array<String>] :filters An array of test file paths
+    #   to restrict which test files are executed; if both +:filter+ and
+    #   +:filters+ are provided, all filters will be passed to terraform.
+    # @option parameters [Boolean] :json (false) Whether or not to produce
+    #   output in a machine-readable JSON format.
+    # @option parameters [Boolean] :no_color (false) Whether or not the output
+    #   from the command should be in color.
+    # @option parameters [String] :test_directory The directory containing
+    #   test files; defaults to +"tests"+.
+    # @option parameters [Hash<String, Object>] :vars A map of variables to
+    #   be passed to the terraform configuration.
+    # @option parameters [String] :var_file The path to a terraform var file;
+    #   if both +:var_file+ and +:var_files+ are provided, all var files will
+    #   be passed to terraform.
+    # @option parameters [Array<String>] :var_files An array of paths to
+    #   terraform var files; if both +:var_file+ and +:var_files+ are
+    #   provided, all var files will be passed to terraform.
+    # @option parameters [Boolean] :verbose (false) When +true+, prints the
+    #   plan or state for each test run block as it executes.
+    # @param [Hash<String, Object>] invocation_options Additional options
+    #   controlling the invocation of the command.
+    # @option invocation_options [Hash<String, String>] :environment A map
+    #   of environment variables to expose at command invocation time.
+    #
+    # @example Basic Invocation
+    #   RubyTerraform.test(
+    #     filters: ['tests/network.tftest.hcl'],
+    #     verbose: true)
+    #
+    def test(parameters = {}, invocation_options = {})
+      exec(RubyTerraform::Commands::Test,
+           parameters, invocation_options)
+    end
+
     # Invokes the +terraform untaint+ command which removes the 'tainted' state
     # from a resource instance.
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-terraform
 version: !ruby/object:Gem::Version
-  version: 1.9.0.pre.2
+  version: 1.9.0.pre.3
 platform: ruby
 authors:
 - InfraBlocks Maintainers
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-26 00:00:00.000000000 Z
+date: 2026-05-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: immutable-struct
@@ -336,6 +336,7 @@ files:
 - lib/ruby_terraform/commands/state_replace_provider.rb
 - lib/ruby_terraform/commands/state_show.rb
 - lib/ruby_terraform/commands/taint.rb
+- lib/ruby_terraform/commands/test.rb
 - lib/ruby_terraform/commands/untaint.rb
 - lib/ruby_terraform/commands/validate.rb
 - lib/ruby_terraform/commands/workspace_delete.rb
@@ -383,7 +384,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'false'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -398,8 +399,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.3.7
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: A simple Ruby wrapper for invoking Terraform commands.
 test_files: []