parameterized_testing 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 14c8bc38363f24be990956aa7017b05592609391655de5a7381275f75119d007
+  data.tar.gz: 94039aceda855763d54907825e5f6e5b9dce67aff2a35f576f9ce0d515988e9b
+SHA512:
+  metadata.gz: 411ddb4b32aa80e42e7183267a9b0484b149f1cc5908eac3c1bba2d33bc346ecd57a44b2eb0dfb3e01b570d1e9113483b51d95ee04cc577cbba631f0bfe8bb2a
+  data.tar.gz: b49142f3ffe34ab8fffcea25cf5e8a8f5f22eab38a657949b6e9313e963ecdd64e812b5ce93d4cba59a313b1902f922966846437947b5422c8055547d37cf6ce

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 yubrot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,9 @@
+# ParameterizedTesting
+
+Parameterized testing utility.
+
+Basically, this gem is used through [`parameterized_testing-rspec`](https://github.com/yubrot/ruby_parameterized_testing/tree/main/gems/parameterized_testing-rspec), etc. See [the repository root documentation](https://github.com/yubrot/ruby_parameterized_testing).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/parameterized_testing/input.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module ParameterizedTesting
+  # `Input` represents a single test case for a parameterized test.
+  class Input
+    attr_reader :index, :location, :initializer
+
+    # @param index [Integer]
+    # @param location [Thread::Backtrace::Location]
+    # @param initializer [Proc]
+    def initialize(index:, location:, initializer:)
+      @index = index
+      @location = location
+      @initializer = initializer
+    end
+
+    # Gets a human-readable label string.
+    # @return [String]
+    def label
+      "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.
+    # In this context, all other method calls are ignored.
+    # @return [Array<Input>]
+    def self.collect(&)
+      inputs = []
+      Collector.new(inputs).instance_exec(&)
+      inputs
+    end
+
+    class Collector # :nodoc:
+      def initialize(inputs)
+        @inputs = inputs
+        @next_index = 0
+      end
+
+      def input(&initializer)
+        index = @next_index
+        @next_index += 1
+        location = caller_locations(1, 1).first
+        @inputs << Input.new(index:, location:, initializer:)
+      end
+
+      def method_missing(_name, ...)
+        # do nothing
+      end
+
+      def respond_to_missing?(_name, _include_private)
+        true
+      end
+    end
+  end
+end

data/lib/parameterized_testing/signature.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module ParameterizedTesting
+  # `Signature` represents the signature that each `Input` in the parameterized test must satisfy.
+  class Signature
+    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
+
+      @params = params
+    end
+
+    # @return [Symbol]
+    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
+    def map(value)
+      case value
+      when Array
+        return if value.size != params.size
+
+        params.zip(value).to_h
+      when Hash
+        return if value.size != params.size || params.any? { !value.key?(_1) }
+
+        value
+      end
+    end
+  end
+end

data/lib/parameterized_testing/version.rb

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

data/lib/parameterized_testing.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require_relative "parameterized_testing/version"
+require_relative "parameterized_testing/input"
+require_relative "parameterized_testing/signature"

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: parameterized_testing
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- yubrot
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-05-08 00:00:00.000000000 Z
+dependencies: []
+description: Parameterized testing utility
+email:
+- yubrot@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lib/parameterized_testing.rb
+- lib/parameterized_testing/input.rb
+- lib/parameterized_testing/signature.rb
+- lib/parameterized_testing/version.rb
+homepage: https://github.com/yubrot/ruby_parameterized_testing
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/yubrot/ruby_parameterized_testing
+  source_code_uri: https://github.com/yubrot/ruby_parameterized_testing
+  changelog_uri: https://github.com/yubrot/ruby_parameterized_testing/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.9
+signing_key:
+specification_version: 4
+summary: Parameterized testing utility
+test_files: []