assert 2.14.0 → 2.15.0

data/test/unit/runner_tests.rb

@@ -1,16 +1,30 @@
 require 'assert'
-require 'assert/suite'
-require 'assert/view/base'
 require 'assert/runner'
 
+require 'stringio'
+require 'assert/config_helpers'
+require 'assert/suite'
+require 'assert/view'
+
 class Assert::Runner
 
   class UnitTests < Assert::Context
     desc "Assert::Runner"
+    subject{ Assert::Runner }
+
+    should "include the config helpers" do
+      assert_includes Assert::ConfigHelpers, subject
+    end
+
+  end
+
+  class InitTests < UnitTests
+    desc "when init"
     setup do
       @config = Factory.modes_off_config
-      @suite  = Assert::Suite.new(@config)
-      @view   = Assert::View::Base.new(StringIO.new("", "w+"), @suite)
+      @config.suite Assert::Suite.new(@config)
+      @config.view  Assert::View::Base.new(@config, StringIO.new("", "w+"))
+
       @runner = Assert::Runner.new(@config)
     end
     subject { @runner }
@@ -23,7 +37,7 @@ class Assert::Runner
     end
 
     should "return an integer exit code" do
-      assert_equal 0, subject.run(@suite, @view)
+      assert_equal 0, subject.run
     end
 
   end

data/test/unit/suite_tests.rb

@@ -14,7 +14,8 @@ class Assert::Suite
     subject{ @suite }
 
     should have_accessors :config, :tests, :test_methods, :start_time, :end_time
-    should have_imeths :ordered_tests, :results, :ordered_results
+    should have_imeths :ordered_tests, :ordered_tests_by_run_time
+    should have_imeths :results, :ordered_results
     should have_imeths :run_time, :test_rate, :result_rate
     should have_imeths :count, :test_count, :result_count
     should have_imeths :setup, :startup, :teardown, :shutdown
@@ -57,7 +58,12 @@ class Assert::Suite
     end
 
     should "know its ordered tests" do
-      assert_equal subject.test_count, subject.ordered_tests.size
+      assert_equal subject.tests, subject.ordered_tests
+    end
+
+    should "know its tests ordered by run time" do
+      exp = subject.ordered_tests.sort{ |a, b| a.run_time <=> b.run_time }
+      assert_equal exp, subject.ordered_tests_by_run_time
     end
 
     should "know how many results it has" do
@@ -65,7 +71,7 @@ class Assert::Suite
     end
 
     should "know its ordered results" do
-      assert_equal subject.test_count, subject.ordered_tests.size
+      assert_equal subject.results, subject.ordered_results
     end
 
     should "know how many pass results it has" do
@@ -170,7 +176,7 @@ class Assert::Suite
   end
 
   class ContextInfoTests < UnitTests
-    desc "a suite's context info"
+    desc "ContextInfo"
     setup do
       @caller = caller
       @klass  = Assert::Context
@@ -179,6 +185,7 @@ class Assert::Suite
     subject{ @info }
 
     should have_readers :called_from, :klass, :file
+    should have_imeths :test_name
 
     should "set its klass on init" do
       assert_equal @klass, subject.klass
@@ -201,6 +208,18 @@ class Assert::Suite
       assert_nil info.file
     end
 
+    should "know how to build the contextual test name for a given name" do
+      desc = Factory.string
+      name = Factory.string
+
+      assert_equal name, subject.test_name(name)
+      assert_equal '',   subject.test_name('')
+      assert_equal '',   subject.test_name(nil)
+
+      Assert.stub(subject.klass, :description){ desc }
+      assert_equal "#{desc} #{name}", subject.test_name(name)
+    end
+
   end
 
 end

data/test/unit/test_tests.rb

@@ -3,68 +3,201 @@ require 'assert/test'
 
 require 'assert/config'
 require 'assert/file_line'
+require 'assert/result'
 
 class Assert::Test
 
   class UnitTests < Assert::Context
     desc "Assert::Test"
     setup do
-      @test_code = lambda{ assert(true) }
       @context_class = Factory.modes_off_context_class{ desc "context class" }
       @context_info  = Factory.context_info(@context_class)
-      @test = Factory.test("should do something amazing", @context_info, :code => @test_code)
+      @config        = Factory.modes_off_config
+      @test_code     = proc{ assert(true) }
+    end
+    subject{ Assert::Test }
+
+    should have_imeths :result_count_meth, :name_file_line_context_data
+    should have_imeths :for_block, :for_method
+
+    should "know the result count method name for a given type" do
+      type = Factory.string
+      exp = "#{type}_result_count".to_sym
+      assert_equal exp, subject.result_count_meth(type)
+    end
+
+    should "know how to build the name and file line given context" do
+      test_name = Factory.string
+      data = subject.name_file_line_context_data(@context_info, test_name)
+
+      exp = @context_info.test_name(test_name)
+      assert_equal exp, data[:name]
+
+      exp = @context_info.called_from
+      assert_equal exp, data[:file_line]
+    end
+
+    should "build tests for a block" do
+      name = Factory.string
+      test = subject.for_block(name, @context_info, @config, &@test_code)
+
+      exp = Assert::FileLine.parse(@context_info.called_from)
+      assert_equal exp, test.file_line
+
+      exp = @context_info.test_name(name)
+      assert_equal exp, test.name
+
+      assert_equal @context_info, test.context_info
+      assert_equal @config,       test.config
+      assert_equal @test_code,    test.code
+    end
+
+    should "build tests for a method" do
+      meth = 'a_test_method'
+      test = subject.for_method(meth, @context_info, @config)
+
+      exp = Assert::FileLine.parse(@context_info.called_from)
+      assert_equal exp, test.file_line
+
+      exp = @context_info.test_name(meth)
+      assert_equal exp, test.name
+
+      assert_equal @context_info, test.context_info
+      assert_equal @config,       test.config
+
+      assert_kind_of Proc, test.code
+      self.instance_eval(&test.code)
+      assert_true @a_test_method_called
+    end
+
+    def a_test_method
+      @a_test_method_called = true
+    end
+
+  end
+
+  class InitWithDataTests < UnitTests
+    desc "when init with data"
+    setup do
+      @file_line = Assert::FileLine.new(Factory.string, Factory.integer.to_s)
+      @meta_data = {
+        :file_line => @file_line.to_s,
+        :name      => Factory.string,
+        :output    => Factory.string,
+        :run_time  => Factory.float(1.0),
+      }
+      @meta_data[:total_result_count] = Factory.integer(100)
+      Assert::Result.types.keys.each do |type|
+        @meta_data[Assert::Test.result_count_meth(type)] = Factory.integer(100)
+      end
+      @run_data = {
+        :context_info => @context_info,
+        :config       => @config,
+        :code         => @test_code
+      }
+
+      @test = Assert::Test.new(@meta_data.merge(@run_data))
     end
     subject{ @test }
 
-    should have_readers :context_info, :config
-    should have_readers :name, :file_line, :code
-    should have_accessors :results, :output, :run_time
-    should have_imeths :context_class, :file, :line_number
-    should have_imeths :run, :result_count, :result_rate
-    should have_imeths *Assert::Result.types.keys.collect{ |k| "#{k}_results" }
+    should have_readers :file_line, :name, :output, :run_time, :total_result_count
+    should have_imeths *Assert::Result.types.keys.map{ |k| Assert::Test.result_count_meth(k) }
+    should have_readers :context_info, :config, :code, :results
+    should have_imeths :data, :context_class, :file, :line_number
+    should have_imeths :result_rate, :result_count, :capture_result, :run
+    should have_imeths *Assert::Result.types.keys.map{ |k| "#{k}_results" }
 
-    should "know its context class" do
-      assert_equal @context_class, subject.context_class
+    should "use any given attrs" do
+      assert_equal @file_line,             subject.file_line
+      assert_equal @meta_data[:name],      subject.name
+      assert_equal @meta_data[:output],    subject.output
+      assert_equal @meta_data[:run_time],  subject.run_time
+
+      assert_equal @meta_data[:total_result_count], subject.total_result_count
+
+      Assert::Result.types.keys.each do |type|
+        n = Assert::Test.result_count_meth(type)
+        assert_equal @meta_data[n], subject.send(n)
+      end
+
+      assert_equal @context_info, subject.context_info
+      assert_equal @config,       subject.config
+      assert_equal @test_code,    subject.code
+    end
+
+    should "default its attrs" do
+      test = Assert::Test.new
+
+      assert_equal Assert::FileLine.parse(''), test.file_line
+      assert_equal '', test.name
+      assert_equal '', test.output
+      assert_equal 0,  test.run_time
+      assert_equal 0,  test.total_result_count
+
+      Assert::Result.types.keys.each do |type|
+        assert_equal 0, test.send(Assert::Test.result_count_meth(type))
+      end
+
+      assert_nil test.context_info
+      assert_nil test.config
+      assert_nil test.code
     end
 
-    should "know its config" do
-      cust_config = Assert::Config.new
-      assert_equal cust_config, Factory.test(cust_config).config
+    should "have no results before running" do
+      assert_empty subject.results
     end
 
-    should "know its name, file line, file and number" do
-      exp = "context class should do something amazing"
-      assert_equal exp, subject.name
+    should "know its data hash" do
+      assert_equal @meta_data, subject.data
+    end
 
-      exp = Assert::FileLine.new(*@context_info.called_from.split(':'))
-      assert_equal exp, subject.file_line
+    should "know its context class" do
+      assert_equal @context_class, subject.context_class
+    end
 
+    should "file line and number" do
       assert_equal subject.file_line.file, subject.file
       assert_equal subject.file_line.line, subject.line_number
     end
 
-    should "get its code from any passed opt, falling back on any given block" do
-      assert_equal @test_code, subject.code
+    should "know its result rate" do
+      count = Factory.integer(100)
+      time  = Factory.float(1.0) + 1.0
 
-      given_block = Proc.new{ assert(false) }
-      assert_equal given_block, Factory.test(&given_block).code
+      Assert.stub(subject, :result_count){ count }
+      Assert.stub(subject, :run_time){ time }
+      exp = count / time
+      assert_equal exp, subject.result_rate
 
-      assert_kind_of Proc, Factory.test.code
-    end
+      Assert.stub(subject, :run_time){ 0 }
+      assert_equal 0.0, subject.result_rate
 
-    should "have zero results before running" do
-      assert_equal 0, subject.result_count
+      Assert.stub(subject, :run_time){ 0.0 }
+      assert_equal 0.0, subject.result_rate
     end
 
-    should "have a zero run time and result rate by default" do
-      assert_equal 0, subject.run_time
-      assert_equal 0, subject.result_rate
+    should "know its result counts" do
+      assert_equal subject.total_result_count, subject.result_count
+
+      Assert::Result.types.keys.each do |type|
+        exp = subject.send(Assert::Test.result_count_meth(type))
+        assert_equal exp, subject.result_count(type)
+      end
     end
 
-    should "have a non-zero run time and result rate after it is run" do
-      subject.run
-      assert_not_equal 0, subject.run_time
-      assert_not_equal 0, subject.result_rate
+    should "capture results" do
+      result           = Factory.pass_result
+      prev_total_count = subject.total_result_count
+      prev_pass_count  = subject.pass_result_count
+      callback_result  = nil
+      callback         = proc{ |r| callback_result = r}
+
+      subject.capture_result(result, callback)
+
+      assert_equal result,               subject.results.last
+      assert_equal prev_total_count + 1, subject.total_result_count
+      assert_equal prev_pass_count  + 1, subject.pass_result_count
+      assert_equal result,               callback_result
     end
 
     should "have a custom inspect that only shows limited attributes" do
@@ -307,6 +440,7 @@ class Assert::Test
                 "std out from the teardown\n"
       assert_equal(exp_out, @test.output)
     end
+
   end
 
 end

data/test/unit/view_helpers_tests.rb

@@ -0,0 +1,210 @@
+require 'assert'
+require 'assert/view_helpers'
+
+require 'assert/config'
+require 'assert/config_helpers'
+require 'assert/result'
+
+module Assert::ViewHelpers
+
+  class UnitTests < Assert::Context
+    desc "Assert::ViewHelpers"
+    setup do
+      test_opt_val = @test_opt_val = Factory.string
+      @helpers_class = Class.new do
+        include Assert::ViewHelpers
+
+        option 'test_opt', test_opt_val
+
+        def config
+          # use the assert config since it has tests, contexts, etc
+          # also maybe use a fresh config that is empty
+          @config ||= [Assert.config, Assert::Config.new].choice
+        end
+      end
+    end
+    subject{ @helpers_class }
+
+    should have_imeths :option
+
+    should "include the config helpers" do
+      assert_includes Assert::ConfigHelpers, subject
+    end
+
+    should "write option values" do
+      helpers = @helpers_class.new
+      assert_equal @test_opt_val, helpers.test_opt
+
+      new_val = Factory.integer
+      helpers.test_opt new_val
+      assert_equal new_val, helpers.test_opt
+
+      other_val = Factory.integer
+      helpers.test_opt new_val, other_val
+      assert_equal [new_val, other_val], helpers.test_opt
+    end
+
+  end
+
+  class InitTests < UnitTests
+    desc "when init"
+    setup do
+      @helpers = @helpers_class.new
+    end
+    subject{ @helpers }
+
+    should have_imeths :test_run_time, :test_result_rate
+    should have_imeths :result_details_for, :matched_result_details_for
+    should have_imeths :show_result_details?, :captured_output
+    should have_imeths :test_count_statement, :result_count_statement
+    should have_imeths :to_sentence
+    should have_imeths :all_pass_result_summary_msg, :result_summary_msg
+    should have_imeths :results_summary_sentence
+
+    should "know a test's formatted run time and result rate" do
+      test   = Factory.test
+      format = '%.6f'
+
+      exp = format % test.run_time
+      assert_equal exp, subject.test_run_time(test, format)
+      assert_equal exp, subject.test_run_time(test)
+
+      exp = format % test.result_rate
+      assert_equal exp, subject.test_result_rate(test, format)
+      assert_equal exp, subject.test_result_rate(test)
+    end
+
+    # note: not formally testing the result details for methods as the views
+    # will break if these are broken.
+
+    should "know whether to show result details" do
+      assert_false subject.show_result_details?(Factory.pass_result)
+
+      assert_true subject.show_result_details?(Factory.fail_result)
+      assert_true subject.show_result_details?(Factory.error_result)
+
+      skip_res, ignore_res = Factory.skip_result, Factory.ignore_result
+      assert_true subject.show_result_details?(skip_res)
+      assert_true subject.show_result_details?(ignore_res)
+
+      Assert.stub(skip_res,   :message){ nil}
+      Assert.stub(ignore_res, :message){ nil}
+      assert_false subject.show_result_details?(skip_res)
+      assert_false subject.show_result_details?(ignore_res)
+    end
+
+    should "know how to build captured output" do
+      output = Factory.string
+      exp = "--- stdout ---\n"\
+            "#{output}"\
+            "--------------"
+      assert_equal exp, subject.captured_output(output)
+    end
+
+    should "know its test count and result count statements" do
+      exp = "#{subject.count(:tests)} test#{'s' if subject.count(:tests) != 1}"
+      assert_equal exp, subject.test_count_statement
+
+      exp = "#{subject.count(:results)} result#{'s' if subject.count(:results) != 1}"
+      assert_equal exp, subject.result_count_statement
+    end
+
+    should "know how to build a sentence from a list of items" do
+      items = 1.times.map{ Factory.string }
+      assert_equal items.first, subject.to_sentence(items)
+
+      items = 2.times.map{ Factory.string }
+      assert_equal items.join(' and '), subject.to_sentence(items)
+
+      items = (Factory.integer(3)+2).times.map{ Factory.string }
+      exp = [items[0..-2].join(", "), items.last].join(", and ")
+      assert_equal exp, subject.to_sentence(items)
+    end
+
+    should "know its all pass result summary message" do
+      Assert.stub(subject, :count).with(:results){ 0 }
+      assert_equal "uhh...", subject.all_pass_result_summary_msg
+
+      Assert.stub(subject, :count).with(:results){ 1 }
+      assert_equal "pass", subject.all_pass_result_summary_msg
+
+      Assert.stub(subject, :count).with(:results){ Factory.integer(10)+1 }
+      assert_equal "all pass", subject.all_pass_result_summary_msg
+    end
+
+    should "know its result summary msg" do
+      res_type = :pass
+      Assert.stub(subject, :all_pass?){ true }
+      exp = subject.all_pass_result_summary_msg
+      assert_equal exp, subject.result_summary_msg(res_type)
+
+      Assert.stub(subject, :all_pass?){ false }
+      res_type = [:pass, :ignore, :fail, :skip, :error].choice
+      exp = "#{subject.count(res_type)} #{res_type.to_s}"
+      assert_equal exp, subject.result_summary_msg(res_type)
+    end
+
+    should "know its results summary sentence" do
+      items = subject.ocurring_result_types.map do |result_sym|
+        subject.result_summary_msg(result_sym)
+      end
+      exp = subject.to_sentence(items)
+      assert_equal exp, subject.results_summary_sentence
+
+      block = proc{ |summary, result| "#{summary}--#{result}" }
+      items = subject.ocurring_result_types.map do |result_sym|
+        block.call(subject.result_summary_msg(result_sym), result_sym)
+      end
+      exp = subject.to_sentence(items)
+      assert_equal exp, subject.results_summary_sentence(&block)
+    end
+
+  end
+
+  class AnsiTests < UnitTests
+    desc "Ansi"
+    subject{ Ansi }
+
+    should have_imeths :code_for
+
+    should "know its codes" do
+      assert_not_empty subject::CODES
+    end
+
+    should "map its code style names to ansi code strings" do
+      styles = Factory.integer(3).times.map{ subject::CODES.keys.choice }
+      exp = styles.map{ |n| "\e[#{subject::CODES[n]}m" }.join('')
+      assert_equal exp, subject.code_for(*styles)
+
+      styles = Factory.integer(3).times.map{ Factory.string }
+      assert_equal '', subject.code_for(*styles)
+
+      styles = []
+      assert_equal '', subject.code_for(*styles)
+    end
+
+  end
+
+  class ResultDetailsTests < UnitTests
+    desc "ResultDetails"
+    setup do
+      @result = Factory.string
+      @test   = Factory.test
+      @index  = Factory.integer
+
+      @details = ResultDetails.new(@result, @test, @index)
+    end
+    subject{ @details }
+
+    should have_readers :result, :test_index, :test, :output
+
+    should "know its attrs" do
+      assert_equal @result,      subject.result
+      assert_equal @test,        subject.test
+      assert_equal @index,       subject.test_index
+      assert_equal @test.output, subject.output
+    end
+
+  end
+
+end