parameterized_testing 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ae68ed889f8978f18434df681d55770938eca2ec6a68622daddcc623c110d0d
-  data.tar.gz: be9768a8b3c3faaead709c2de45eea17aed72d8d5c56aca9e849ef1fb7d3e23f
+  metadata.gz: 1338c0068efe487efdfbebcd74a333b124ade9f650b32bb95bbafb89c58cd902
+  data.tar.gz: 7767f2a41cbe53eeffc2f20a28930eb323c13b7d7366c4ce10a37d64d66daf13
 SHA512:
-  metadata.gz: d0aa5bae0c96de4f2e184ccf9e62f1df1b0aee661ad030aa72caa1814cad1fb1066a262e706e29d300c3e9350b2b6ec92c7cf19bb72eabd70bc0c5fca373ac59
-  data.tar.gz: 2a091aa7e143f39ace374a1b1ce8c881284577449cda9737edd960b7763be98d4ce3534a3a66bc5eaa43dcc8aa4bd728dff6505d89ab7286baa654e1d23cc230
+  metadata.gz: 4c54e9ebf7945ffd4b721ff71085dbe25e2059e8424fb68d0c5b5786006a1f437769a467fa3409f8355784659e5e92fdf7add45d0f0b321ef7c773e73e052db0
+  data.tar.gz: 6e78907450a1555e590e19758c2387f1ca9ee5927133dd0c1f4002bbd5eddc15095c542a7c154dc45ae138b1bee92270025e87dc4283ff40c31c4cad40d3e754

data/lib/parameterized_testing/input.rb

@@ -1,13 +1,15 @@
 # frozen_string_literal: true
 
 module ParameterizedTesting
-  # `Input` represents a single test case for a parameterized test.
+  # {Input} represents a single test case for a parameterized test.
   class Input
-    attr_reader :index, :location, :initializer
+    # @return [Integer] index of the input
+    attr_reader :index
+    # @return [Thread::Backtrace::Location] the location of the <code>input { ... }</code> block
+    attr_reader :location
+    # @return [Proc] the block to compute the value of this input
+    attr_reader :initializer
 
-    # @param index [Integer]
-    # @param location [Thread::Backtrace::Location]
-    # @param initializer [Proc]
     def initialize(index:, location:, initializer:)
       @index = index
       @location = location
@@ -20,9 +22,9 @@ module ParameterizedTesting
       "input[#{index}] at line #{location.lineno}"
     end
 
-    # Collects all `input { ... }` in a block.
-    # It is important to notice that `#parameterized` collects inputs by actually `instance_exec`uting
-    # the block in a dedicated context in order to get the line number of input.
+    # Collects all <code>input { ... }</code> in a block.
+    # It is important to notice that this method collects inputs by actually <code>#instance_exec</code>uting
+    # the block in a dedicated context, in order to get the line number of input.
     # In this context, all other method calls are ignored.
     # @return [Array<Input>]
     def self.collect(&)
@@ -52,5 +54,6 @@ module ParameterizedTesting
         true
       end
     end
+    private_constant :Collector
   end
 end

data/lib/parameterized_testing/signature.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 module ParameterizedTesting
-  # `Signature` represents the signature that each `Input` in the parameterized test must satisfy.
+  # {Signature} represents the signature that each {Input} in the parameterized test must satisfy.
   class Signature
+    # @return [Array<Symbol>] names of the parameters
     attr_reader :params
 
-    # @param params [Array<Symbol>]
     def initialize(*params)
       raise ArgumentError, "parameter name must be a symbol" if params.any? { !_1.is_a?(Symbol) }
       raise ArgumentError, "parameter names must be unique" if params.uniq.size != params.size
@@ -13,13 +13,15 @@ module ParameterizedTesting
       @params = params
     end
 
-    # @return [Symbol]
+    # @return [Symbol] a symbol for temporary variables that are unique for each signature
     def temporary_variable_name
       @temporary_variable_name ||= :"_input_#{params.join("_")}"
     end
 
-    # @param value [Object]
-    # @return [Hash<Symbol, Object>, nil] Mapping of parameters and values, or `nil` if mapping fails
+    # Compute the mapping between parameters and values, or <code>nil</code> if map fails.
+    # @param value [Object] An array with the same number of elements as the number of parameters,
+    #   or a hash with each parameter name as a key. For other objects, map will fail.
+    # @return [Hash{Symbol => Object}, nil]
     def map(value)
       case value
       when Array

data/lib/parameterized_testing/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ParameterizedTesting
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parameterized_testing
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - yubrot
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-08 00:00:00.000000000 Z
+date: 2024-05-10 00:00:00.000000000 Z
 dependencies: []
 description: Parameterized testing utility
 email: