easytest 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e87217a9622ad5c57a2b97d64fc8e0a6cf32c264b53901644740b4727363d1bf
-  data.tar.gz: 5703988217fdf9bc1e0aad99c2c5609a6e159e80d546124f0108ba4414dc1638
+  metadata.gz: b72dfc70d7a8d0661cc8db8f80722598819cd167ff8eaeceeb15804088df94f0
+  data.tar.gz: 9e3fa802e2efb674630998420f726c32a24021b9eb5bac8df77696ed9e3aeb23
 SHA512:
-  metadata.gz: 98e353f726337a6d5b2b9aaad59a4bca8801f06885dc2e9f8f5c0dce6655e2d8e5ab178ede9f7d3b229e2e4f92b8896a5895454d211c8222570cf8e81ababea5
-  data.tar.gz: 88eff8410c841dffd3457beb20a3f78aaba46347ce724a680d9420f0e7831ce37d1ddcef9233a29758049a8b5e336f183781dc572b89531cd7472276984e5bb5
+  metadata.gz: 956aa6d38ccbbca19cde275ecd821453c8858ff7ce2652528233a480563304ec71c0c1ace5337904a0895287a26aa088e0bd5a5622d602a43e89bd82e402078c
+  data.tar.gz: ab7b14d3296cf0b37c517ff61f57b5b46b5697c9fd01af278f2fb1ca44ebe11b6f085a14565f8094ea41660a5eebfc7ef123b5d1b542ddfd6281ceef2a4a48e5

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.5.0
+
+- [Breaking] Rename `to_not_raise` to `to_raise_nothing`.
+- Add `to_match` matcher.
+- Add `only` to run only any cases.
+
 ## 0.4.0
 
 - Add `skip` and `test` without block for todo.

data/README.md

@@ -75,19 +75,32 @@ The test now passes! 🎉
 
 ### Skip
 
-If you want to skip a case, you can change `test` to `skip`:
+If you want to skip any cases, you can change `test` to `skip`:
 
 ```diff
 -test "addition" do
 +skip "addition" do
-   expect(1 + 2).to_eq 2
- end
 ```
 
+Skipped cases will be reported as "skipped".
+
+### Only
+
+If you want to run only any cases, you can use `test` to `only`:
+
+```diff
+-test "addition" do
++only "addition" do
+```
+
+Only cases with `only` will be run, and other cases will be skipped.
+
 ### To-do
 
-If you want to write a to-do case, you can use `test` without a block:
+If you want to write to-do cases, you can use `test` without a block:
 
 ```ruby
 test "addition"
 ```
+
+To-do cases will be reported as "todo".

data/lib/easytest/case.rb

@@ -4,27 +4,30 @@ module Easytest
     attr_reader :file
     attr_reader :block
     attr_reader :skipped
+    attr_reader :only
+
     alias skipped? skipped
+    alias only? only
 
-    def initialize(name:, file:, skipped: false, &block)
+    def initialize(name:, file:, skipped: false, only: false, &block)
       @name = name
       @file = file
       @block = block
       @skipped = skipped
+      @only = only
     end
 
     def todo?
       block.nil?
     end
 
-    def run
-      if todo?
-        return [:todo, Reporter.new(name).report_todo]
-      end
+    def skip!
+      @skipped = true
+    end
 
-      if skipped?
-        return [:skipped, Reporter.new(name).report_skip]
-      end
+    def run
+      return [:todo, Reporter.new(name).report_todo] if todo?
+      return [:skipped, Reporter.new(name).report_skip] if skipped?
 
       block.call
       [:passed, nil]

data/lib/easytest/dsl.rb

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

data/lib/easytest/expectation.rb

@@ -41,18 +41,22 @@ module Easytest
       Matcher::Include.new(actual: actual, expected: expected, negate: negate).match!
     end
 
+    def to_match(expected)
+      Matcher::Match.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?
+      raise FatalError, "`not.to_raise` can cause a false positive, so use `to_raise_nothing` instead" if negate?
       raise FatalError, "`to_raise` requires a Class, String, or Regexp" unless [Class, String, Regexp].any? { expected.is_a? _1 }
 
       Matcher::Raise.new(actual: block, expected: expected, negate: negate).match!
     end
 
-    def to_not_raise
-      raise FatalError, "`to_not_raise` requires a block like `expect { ... }.to_not_raise`" unless block
+    def to_raise_nothing
+      raise FatalError, "`to_raise_nothing` requires a block like `expect { ... }.to_raise_nothing`" unless block
 
-      Matcher::NotRaise.new(actual: block).match!
+      Matcher::RaiseNothing.new(actual: block).match!
     end
 
     private

data/lib/easytest/matcher/match.rb

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

data/lib/easytest/matcher/{not_raise.rb → raise_nothing.rb}

@@ -1,6 +1,6 @@
 module Easytest
   module Matcher
-    class NotRaise < Base
+    class RaiseNothing < Base
       def initialize(actual:)
         super(actual: actual, expected: nil)
       end
@@ -20,7 +20,7 @@ module Easytest
       end
 
       def message
-        "not raise"
+        "raise nothing"
       end
     end
   end

data/lib/easytest/runner.rb

@@ -17,13 +17,19 @@ module Easytest
     end
 
     def run
-      cases_by_file = cases.group_by { |c| c.file }
-      cases_by_file.each do |file, cases|
+      include_only_case = cases.any?(&:only?)
+
+      cases.group_by(&:file).each do |file, cases_per_file|
         self.file_count += 1
 
         reports = []
 
-        cases.each do |c|
+
+        cases_per_file.each do |c|
+          if include_only_case && !c.only?
+            c.skip!
+          end
+
           result, report = c.run
 
           case result
@@ -123,7 +129,9 @@ module Easytest
       end
 
       list << Rainbow("#{passed_count} passed").green.bright
-      list << "#{total_count} total #{Rainbow("(#{file_count} files)").dimgray}"
+
+      files_text = "#{file_count} #{Utils.pluralize("file", file_count)}"
+      list << "#{total_count} total #{Rainbow("(#{files_text})").dimgray}"
 
       list.join(", ")
     end

data/lib/easytest/utils.rb

@@ -10,5 +10,15 @@ module Easytest
       # https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
       "\e]8;;file://#{path}\e\\#{Rainbow(dir).dimgray}#{base}\e]8;;\e\\"
     end
+
+    def raise_if_no_test_name(name, method:)
+      if name.nil? || name.empty?
+        raise FatalError.new("`#{method}` requires a name")
+      end
+    end
+
+    def pluralize(singular, count)
+      count == 1 ? singular : "#{singular}s"
+    end
   end
 end

data/lib/easytest/version.rb

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

data/lib/easytest.rb

@@ -20,9 +20,10 @@ 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/match"
 require_relative "easytest/matcher/nil"
-require_relative "easytest/matcher/not_raise"
 require_relative "easytest/matcher/raise"
+require_relative "easytest/matcher/raise_nothing"
 require_relative "easytest/matcher/true"
 
 module Easytest

data/sig/easytest.rbs

@@ -11,20 +11,20 @@ module Easytest
     alias to_equal to_eq
 
     def to_be: (untyped expected) -> untyped
-
     def to_be_nil: () -> void
+    def to_be_false: () -> void
+    def to_be_true: () -> void
 
     def to_be_a: (Class expected) -> void
     def to_be_kind_of: (Class expected) -> void
     def to_be_instance_of: (Class expected) -> void
 
-    def to_be_false: () -> void
-    def to_be_true: () -> void
-
     def to_include: (untyped expected) -> void
 
+    def to_match: (untyped expected) -> void
+
     def to_raise: ((Class | String | Regexp) expected) -> void
-    def to_not_raise: () -> void
+    def to_raise_nothing: () -> void
   end
 end
 
@@ -34,6 +34,8 @@ module Kernel
 
   def skip: (String name) { () -> void } -> void
 
+  def only: (String name) { () -> void } -> void
+
   def expect: (untyped actual) -> Easytest::Expectation
             | { () -> void } -> Easytest::Expectation
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: easytest
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Masafumi Koba
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-10-06 00:00:00.000000000 Z
+date: 2022-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rainbow
@@ -50,9 +50,10 @@ files:
 - lib/easytest/matcher/include.rb
 - lib/easytest/matcher/instance_of.rb
 - lib/easytest/matcher/kind_of.rb
+- lib/easytest/matcher/match.rb
 - lib/easytest/matcher/nil.rb
-- lib/easytest/matcher/not_raise.rb
 - lib/easytest/matcher/raise.rb
+- lib/easytest/matcher/raise_nothing.rb
 - lib/easytest/matcher/true.rb
 - lib/easytest/reporter.rb
 - lib/easytest/runner.rb