easytest 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 720ee750084f63381ed7032f4c66bcd045e10b6fe96e9a3680bd5347d8ccdaf8
-  data.tar.gz: 6b8b8c27ab380b898a2d52976ee3156e237041ff7d4f39006b9c3bd33c71b178
+  metadata.gz: e87217a9622ad5c57a2b97d64fc8e0a6cf32c264b53901644740b4727363d1bf
+  data.tar.gz: 5703988217fdf9bc1e0aad99c2c5609a6e159e80d546124f0108ba4414dc1638
 SHA512:
-  metadata.gz: 7faecdb6f83e99f7ddf0216f03bcc1cd0407f14bd9417e84a4887db2d99c0ef7aaed94a33c513b0c487766d0ee7d28363a2e4c4f705774e7ce8fda5ad0406e67
-  data.tar.gz: d33ea01dc76b139bba94125c4ca747cb07b2ac0c385bd96b27abbb1288e709ee2827d50bad957aad202c39eee2f21d16cb86f9b0b284b5ef804cdb145565ec38
+  metadata.gz: 98e353f726337a6d5b2b9aaad59a4bca8801f06885dc2e9f8f5c0dce6655e2d8e5ab178ede9f7d3b229e2e4f92b8896a5895454d211c8222570cf8e81ababea5
+  data.tar.gz: 88eff8410c841dffd3457beb20a3f78aaba46347ce724a680d9420f0e7831ce37d1ddcef9233a29758049a8b5e336f183781dc572b89531cd7472276984e5bb5

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.4.0
+
+- Add `skip` and `test` without block for todo.
+- Add `to_include` matcher.
+
 ## 0.3.1
 
 - Remove polyfill from `.sig` file.

data/README.md

@@ -42,7 +42,7 @@ Then, run `easytest`:
 ```console
 $ easytest
  FAIL  test/addition_test.rb
-  ● addition  (should equal)
+  ✕ addition  (should equal)
 
     Expected: 2
     Received: 3
@@ -73,4 +73,21 @@ $ easytest
 
 The test now passes! 🎉
 
-For more, try `easytest --help`.
+### Skip
+
+If you want to skip a case, you can change `test` to `skip`:
+
+```diff
+-test "addition" do
++skip "addition" do
+   expect(1 + 2).to_eq 2
+ end
+```
+
+### To-do
+
+If you want to write a to-do case, you can use `test` without a block:
+
+```ruby
+test "addition"
+```

data/lib/easytest/case.rb

@@ -3,35 +3,34 @@ module Easytest
     attr_reader :name
     attr_reader :file
     attr_reader :block
-    attr_accessor :report
+    attr_reader :skipped
+    alias skipped? skipped
 
-    def initialize(name:, file:, &block)
+    def initialize(name:, file:, skipped: false, &block)
       @name = name
       @file = file
       @block = block
-      @report = nil
+      @skipped = skipped
     end
 
-    def run
-      block.call
-      true
-    rescue MatchError, FatalError => error
-      loc = find_location(error) or raise
-
-      self.report = Reporter.new(
-        name: name,
-        error: error,
-        file: loc.absolute_path,
-        location: loc.to_s,
-      ).report or raise
-
-      false
+    def todo?
+      block.nil?
     end
 
-    private
+    def run
+      if todo?
+        return [:todo, Reporter.new(name).report_todo]
+      end
+
+      if skipped?
+        return [:skipped, Reporter.new(name).report_skip]
+      end
 
-    def find_location(error)
-      error.backtrace_locations.find { |loc| loc.path.end_with?("_test.rb") }
+      block.call
+      [:passed, nil]
+    rescue MatchError, FatalError => error
+      report = Reporter.new(name).report_error(error) or raise error
+      [:failed, report]
     end
   end
 end

data/lib/easytest/cli.rb

@@ -66,7 +66,7 @@ module Easytest
     def help(parser)
       <<~MSG
         #{Rainbow("USAGE").bright}
-          #{parser.program_name} [options] [...<file, directory, or pattern>]
+          #{parser.program_name} [options] [<file, directory, or pattern>...]
 
         #{Rainbow("OPTIONS").bright}
           --help      Show help

data/lib/easytest/dsl.rb

@@ -2,10 +2,19 @@ module Easytest
   module DSL
     refine Kernel do
       def test(name, &block)
+        raise FatalError, "`test` requires a name" if name.nil? || name.empty?
+
         file = caller_locations(1, 1).first.absolute_path
         Easytest.add_case Case.new(name: name, file: file, &block)
       end
 
+      def skip(name, &block)
+        raise FatalError, "`skip` requires a name" if name.nil? || name.empty?
+
+        file = caller_locations(1, 1).first.absolute_path
+        Easytest.add_case Case.new(name: name, file: file, skipped: true, &block)
+      end
+
       def expect(actual = nil, &block)
         Expectation.new(actual, &block)
       end

data/lib/easytest/expectation.rb

@@ -37,6 +37,10 @@ module Easytest
       Matcher::InstanceOf.new(actual: actual, expected: expected, negate: negate).match!
     end
 
+    def to_include(expected)
+      Matcher::Include.new(actual: actual, expected: expected, negate: negate).match!
+    end
+
     def to_raise(expected)
       raise FatalError, "`to_raise` requires a block like `expect { ... }.to_raise`" unless block
       raise FatalError, "`not.to_raise` can cause a false positive, so use `to_not_raise` instead" if negate?

data/lib/easytest/matcher/include.rb

@@ -0,0 +1,13 @@
+module Easytest
+  module Matcher
+    class Include < Base
+      def match?
+        actual.include? expected
+      end
+
+      def message
+        "include"
+      end
+    end
+  end
+end

data/lib/easytest/reporter.rb

@@ -1,47 +1,65 @@
 module Easytest
   class Reporter
     attr_reader :name
-    attr_reader :error
-    attr_reader :file
-    attr_reader :location
 
-    def initialize(name:, error:, file:, location:)
+    def initialize(name)
       @name = name
-      @error = error
-      @file = file
-      @location = location
     end
 
-    def report
+    def report_error(error)
       case error
       when MatchError
-        report_match_error
+        report_match_error(error)
       when FatalError
-        report_fatal_error
+        report_fatal_error(error)
       end
     end
 
+    def report_skip
+      Rainbow("⚠ skipped \"#{name}\"").yellow
+    end
+
+    def report_todo
+      Rainbow("✎ todo \"#{name}\"").magenta
+    end
+
     private
 
-    def report_match_error
+    def report_match_error(error)
+      loc = find_location(error)
+
       <<~MSG
-        #{Rainbow("● #{name}").red.bright}  #{Rainbow("(#{error.message})").dimgray}
+        #{Rainbow("✕ #{name}").red.bright}  #{Rainbow("(#{error.message})").dimgray}
 
           #{Rainbow("Expected: #{error.expected.inspect}").green}
           #{Rainbow("Received: #{error.actual.inspect}").red}
 
-          #{Rainbow("# #{location}").dimgray}
+          #{Rainbow(format_location(loc)).dimgray}
       MSG
     end
 
-    def report_fatal_error
+    def report_fatal_error(error)
+      loc = find_location(error)
+
       <<~MSG
-        #{Rainbow("● #{name}").red.bright}
+        #{Rainbow("✕ #{name}").red.bright}
 
           #{Rainbow(error.message).red}
 
-          #{Rainbow("# #{location}").dimgray}
+          #{Rainbow(format_location(loc)).dimgray}
       MSG
     end
+
+    def find_location(error)
+      location = error.backtrace_locations.find do |loc|
+        loc.path.end_with?("_test.rb")
+      end
+      location or raise "Not found test location from #{error.inspect}"
+    end
+
+    def format_location(location)
+      path = Pathname(location.absolute_path).relative_path_from(Dir.pwd)
+      "# #{path}:#{location.lineno}:in `#{location.label}'"
+    end
   end
 end

data/lib/easytest/runner.rb

@@ -3,12 +3,16 @@ module Easytest
     attr_reader :start_time
     attr_accessor :passed_count
     attr_accessor :failed_count
+    attr_accessor :skipped_count
+    attr_accessor :todo_count
     attr_accessor :file_count
 
     def initialize(start_time: Time.now)
       @start_time = start_time
       @passed_count = 0
       @failed_count = 0
+      @skipped_count = 0
+      @todo_count = 0
       @file_count = 0
     end
 
@@ -16,26 +20,49 @@ module Easytest
       cases_by_file = cases.group_by { |c| c.file }
       cases_by_file.each do |file, cases|
         self.file_count += 1
+
         reports = []
 
         cases.each do |c|
-          passed = c.run
+          result, report = c.run
 
-          if passed
+          case result
+          when :passed
             self.passed_count += 1
-          else
+          when :failed
             self.failed_count += 1
-            reports << c.report.gsub(/^/, "  ")
+          when :skipped
+            self.skipped_count += 1
+          when :todo
+            self.todo_count += 1
+          else
+            raise "Unknown result: #{result.inspect}"
           end
+
+          reports << [result, report] if report
         end
 
         link = Utils.terminal_hyperlink(file)
-        if reports.empty?
+
+        if reports.none? { |result, _| result == :failed }
           puts "#{Rainbow(" PASS ").bright.bg(:green)} #{link}"
         else
           puts "#{Rainbow(" FAIL ").bright.bg(:red)} #{link}"
-          reports.each { |report| puts report ; puts "" }
         end
+
+        reports
+          .sort_by do |result, _|
+            case result
+            when :skipped, :todo
+              0
+            else
+              1
+            end
+          end
+          .each do |result, report|
+            puts report.gsub(/^/, "  ").gsub(/^\s+$/, "")
+            puts "" if result == :failed
+          end
       end
 
       if no_tests?
@@ -65,7 +92,7 @@ module Easytest
     private
 
     def total_count
-      passed_count + failed_count
+      passed_count + failed_count + skipped_count + todo_count
     end
 
     def all_passed?
@@ -81,16 +108,24 @@ module Easytest
     end
 
     def summary
-      summary = ""
+      list = []
 
-      if failed_count == 0
-        summary << Rainbow("#{passed_count} passed").green.bright
-      else
-        summary << Rainbow("#{failed_count} failed").red.bright
-        summary << ", #{Rainbow("#{passed_count} passed").green.bright}"
+      if failed_count > 0
+        list << Rainbow("#{failed_count} failed").red.bright
+      end
+
+      if skipped_count > 0
+        list << Rainbow("#{skipped_count} skipped").yellow.bright
       end
 
-      summary << ", #{total_count} total #{Rainbow("(#{file_count} files)").dimgray}"
+      if todo_count > 0
+        list << Rainbow("#{todo_count} todo").magenta.bright
+      end
+
+      list << Rainbow("#{passed_count} passed").green.bright
+      list << "#{total_count} total #{Rainbow("(#{file_count} files)").dimgray}"
+
+      list.join(", ")
     end
   end
 end

data/lib/easytest/version.rb

@@ -1,3 +1,3 @@
 module Easytest
-  VERSION = "0.3.1"
+  VERSION = "0.4.0"
 end

data/lib/easytest.rb

@@ -17,6 +17,7 @@ require_relative "easytest/matcher/be"
 require_relative "easytest/matcher/be_a"
 require_relative "easytest/matcher/equal"
 require_relative "easytest/matcher/false"
+require_relative "easytest/matcher/include"
 require_relative "easytest/matcher/instance_of"
 require_relative "easytest/matcher/kind_of"
 require_relative "easytest/matcher/nil"

data/sig/easytest.rbs

@@ -21,12 +21,19 @@ module Easytest
     def to_be_false: () -> void
     def to_be_true: () -> void
 
+    def to_include: (untyped expected) -> void
+
     def to_raise: ((Class | String | Regexp) expected) -> void
     def to_not_raise: () -> void
   end
 end
 
 module Kernel
+  # TODO: Can we avoid `RBS::DuplicatedMethodDefinitionError` "::Kernel#test has duplicated definitions"?
+  # def test: (String name) ?{ () -> void } -> void
+
+  def skip: (String name) { () -> void } -> void
+
   def expect: (untyped actual) -> Easytest::Expectation
             | { () -> void } -> Easytest::Expectation
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: easytest
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Masafumi Koba
@@ -47,6 +47,7 @@ files:
 - lib/easytest/matcher/be_a.rb
 - lib/easytest/matcher/equal.rb
 - lib/easytest/matcher/false.rb
+- lib/easytest/matcher/include.rb
 - lib/easytest/matcher/instance_of.rb
 - lib/easytest/matcher/kind_of.rb
 - lib/easytest/matcher/nil.rb