Module: Test::Unit::Data::ClassMethods (Ruby 2.7.5)
Description: Module : Test::Unit::Data::ClassMethods - Ruby 2.7.5

### Home Classes Methods

### In Files

- test-unit-3.3.4/lib/test/unit/data.rb

### Namespace

- CLASS Test::Unit::Data::ClassMethods::Loader

### Methods

- #data
- #load_data

### Class/Module Index

Quicksearch

- Object
- Test
- Test::Unit
- Test::Unit::AssertionFailedError
- Test::Unit::Assertions
- Test::Unit::Assertions::AssertExceptionHelper
- Test::Unit::Assertions::AssertExceptionHelper::WrappedException
- Test::Unit::Assertions::AssertionMessage
- Test::Unit::Assertions::AssertionMessage::ArrayInspector
- Test::Unit::Assertions::AssertionMessage::DelayedLiteral
- Test::Unit::Assertions::AssertionMessage::HashInspector
- Test::Unit::Assertions::AssertionMessage::Inspector
- Test::Unit::Assertions::AssertionMessage::Literal
- Test::Unit::Assertions::AssertionMessage::MaybeContainer
- Test::Unit::Assertions::AssertionMessage::NumericInspector
- Test::Unit::Assertions::AssertionMessage::Template
- Test::Unit::Assertions::ThrowTagExtractor
- Test::Unit::Attribute
- Test::Unit::Attribute::BaseClassMethods
- Test::Unit::Attribute::ClassMethods
- Test::Unit::Attribute::StringifyKeyHash
- Test::Unit::AttributeMatcher
- Test::Unit::AutoRunner
- Test::Unit::AutoRunner::StopOnFailureListener
- Test::Unit::AutoRunnerLoader
- Test::Unit::CodeSnippetFetcher
- Test::Unit::Collector
- Test::Unit::Collector::Descendant
- Test::Unit::Collector::Dir
- Test::Unit::Collector::Load
- Test::Unit::Collector::ObjectSpace
- Test::Unit::Collector::XML
- Test::Unit::Collector::XML::Listener
- Test::Unit::Color
- Test::Unit::Color::Error
- Test::Unit::Color::ParseError
- Test::Unit::ColorScheme
- Test::Unit::Data
- Test::Unit::Data::ClassMethods
- Test::Unit::Data::ClassMethods::Loader
- Test::Unit::DataSets
- Test::Unit::Diff
- Test::Unit::Diff::Differ
- Test::Unit::Diff::ReadableDiffer
- Test::Unit::Diff::SequenceMatcher
- Test::Unit::Diff::UTF8Line
- Test::Unit::Diff::UnifiedDiffer
- Test::Unit::Error
- Test::Unit::ErrorHandler
- Test::Unit::ExceptionHandler
- Test::Unit::ExceptionHandler::ClassMethods
- Test::Unit::Failure
- Test::Unit::FailureHandler
- Test::Unit::FaultLocationDetector
- Test::Unit::Fixture
- Test::Unit::Fixture::ClassMethods
- Test::Unit::Fixture::Fixture
- Test::Unit::Fixture::HookPoint
- Test::Unit::MixColor
- Test::Unit::Notification
- Test::Unit::NotificationHandler
- Test::Unit::NotifiedError
- Test::Unit::NullResultContainerInitializer
- Test::Unit::Omission
- Test::Unit::OmissionHandler
- Test::Unit::OmittedError
- Test::Unit::PendedError
- Test::Unit::Pending
- Test::Unit::PendingHandler
- Test::Unit::Priority
- Test::Unit::Priority::Checker
- Test::Unit::Priority::ClassMethods
- Test::Unit::TestCase
- Test::Unit::TestCase::InternalData
- Test::Unit::TestCaseNotificationSupport
- Test::Unit::TestCaseOmissionSupport
- Test::Unit::TestCasePendingSupport
- Test::Unit::TestResult
- Test::Unit::TestResultErrorSupport
- Test::Unit::TestResultFailureSupport
- Test::Unit::TestResultNotificationSupport
- Test::Unit::TestResultOmissionSupport
- Test::Unit::TestResultPendingSupport
- Test::Unit::TestSuite
- Test::Unit::UI
- Test::Unit::UI::Console
- Test::Unit::UI::Console::ColorizedReadableDiffer
- Test::Unit::UI::Console::OutputLevel
- Test::Unit::UI::Console::TestRunner
- Test::Unit::UI::Emacs
- Test::Unit::UI::Emacs::TestRunner
- Test::Unit::UI::TestRunner
- Test::Unit::UI::TestRunnerMediator
- Test::Unit::UI::TestRunnerUtilities
- Test::Unit::UI::XML
- Test::Unit::UI::XML::TestRunner
- Test::Unit::Util
- Test::Unit::Util::BacktraceFilter
- Test::Unit::Util::MethodOwnerFinder
- Test::Unit::Util::Observable
- Test::Unit::Util::Output
- Test::Unit::Util::ProcWrapper

No matching classes.

# Test::Unit::Data::ClassMethods

### Public Instance Methods

data(*arguments, &block) click to toggle source

This method provides Data-Driven-Test functionality.

Define test data in the test code.

@overload data(label, data, options={})

    @param [String] label specify test case name.
    @param data specify test data.
    @param [Hash] options specify options.
    @option options [Boolean] :keep whether or not to use
      this data in the following test methods

    @example data(label, data)
      data("empty string", [true, ""])
      data("plain string", [false, "hello"])
      def test_empty?(data)
        expected, target = data
        assert_equal(expected, target.empty?)
      end

@overload data(variable, patterns, options={})

    @param [Symbol] variable specify test pattern variable name.
    @param [Array] patterns specify test patterns for the variable.
    @param [Hash] options specify options.
    @option options [Boolean] :keep whether or not to use
      this data in the following test methods
    @option options [Object] :group the test pattern group.
      Test matrix is generated for each test pattern group separately.

    @example data(variable, patterns)
      data(:x, [1, 2, 3])
      data(:y, ["a", "b"])
      def test_patterns(data)
        # 3 * 2 times executed
        # 3: the number of patterns of :x
        # 2: the number of patterns of :y
        p data
          # => {:x => 1, :y => "a"}
          # => {:x => 1, :y => "b"}
          # => {:x => 2, :y => "a"}
          # => {:x => 2, :y => "b"}
          # => {:x => 3, :y => "a"}
          # => {:x => 3, :y => "b"}
      end

    Generates test matrix from variable and patterns pairs.

@overload data(data_set, options={})

    @param [Hash] data_set specify test data as a Hash that
      key is test label and value is test data.
    @param [Hash] options specify options.
    @option options [Boolean] :keep whether or not to use
      this data in the following test methods

    @example data(data_set)
      data("empty string" => [true, ""],
           "plain string" => [false, "hello"])
      def test_empty?(data)
        expected, target = data
        assert_equal(expected, target.empty?)
      end

@overload data(options={}, &block)

    @param [Hash] options specify options.
    @option options [Boolean] :keep whether or not to use
      this data in the following test methods
    @yieldreturn [Hash<String, Object>] return test data set
      as a Hash that key is test label and value is test data.

    @example data(&block)
      data do
        data_set = {}
        data_set["empty string"] = [true, ""]
        data_set["plain string"] = [false, "hello"]
        data_set
      end
      def test_empty?(data)
        expected, target = data
        assert_equal(expected, target.empty?)
      end

@overload data(options={}, &block)

    @param [Hash] options specify options.
    @option options [Boolean] :keep whether or not to use
      this data in the following test methods
    @yieldreturn [Array<Symbol, Array>] return test data set
      as an Array of variable and patterns.

    @example data(&block)
      data do
        patterns = 3.times.to_a
        [:x, patterns]
      end
      data do
        patterns = []
        character = "a"
        2.times.each do
          patterns << character
          character = character.succ
        end
        [:y, patterns]
      end
      def test_patterns(data)
        # 3 * 2 times executed
        # 3: the number of patterns of :x
        # 2: the number of patterns of :y
        p data
          # => {:x => 0, :y => "a"}
          # => {:x => 0, :y => "b"}
          # => {:x => 1, :y => "a"}
          # => {:x => 1, :y => "b"}
          # => {:x => 2, :y => "a"}
          # => {:x => 2, :y => "b"}
      end

    Generates test matrix from variable and patterns pairs.

                   # File test-unit-3.3.4/lib/test/unit/data.rb, line 129
    def data(*arguments, &block)
      options = nil
      n_arguments = arguments.size
      case n_arguments
      when 0
        raise ArgumentError, "no block is given" unless block_given?
        data_set = block
      when 1
        if block_given?
          data_set = block
          options = arguments[1]
        else
          data_set = arguments[0]
        end
      when 2
        case arguments[0]
        when String
          data_set = {arguments[0] => arguments[1]}
        when Hash
          data_set = arguments[0]
          options = arguments[1]
        else
          variable = arguments[0]
          patterns = arguments[1]
          data_set = [variable, patterns]
        end
      when 3
        case arguments[0]
        when String
          data_set = {arguments[0] => arguments[1]}
          options = arguments[2]
        else
          variable = arguments[0]
          patterns = arguments[1]
          data_set = [variable, patterns]
          options = arguments[2]
        end
      else
        message = "wrong number arguments(#{n_arguments} for 0..3)"
        raise ArgumentError, message
      end
      options ||= {}
      data_sets = current_attribute(:data)[:value] || DataSets.new
      data_sets.add(data_set, options)
      if options[:keep]
        keep_hook = lambda do |attr|
          attr.merge(value: attr[:value].keep)
        end
        options = options.merge(keep_hook: keep_hook)
      end
      attribute(:data, data_sets, options)
    end

load_data(file_name) click to toggle source

This method provides Data-Driven-Test functionality.

Load test data from the file. This is shorthand to load test data from file. If you want to load complex file, you can use {#data} with block.

@param [String] file_name full path to test data file.

    File format is automatically detected from filename extension.

@raise [ArgumentError] if `file_name` is not supported file format. @see `Loader#load`

@example Load data from CSV file

    load_data("/path/to/test-data.csv")
    def test_empty?(data)
      assert_equal(data["expected"], data["target"].empty?)
    end

                   # File test-unit-3.3.4/lib/test/unit/data.rb, line 199
    def load_data(file_name)
      loader = Loader.new(self)
      loader.load(file_name)
    end