minitest-tagz 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 79b82c59731bb66b312c83e52de074ba6e9c09ab
-  data.tar.gz: 08d75b5c1fdebde4f370e700356dfd215e92936c
+  metadata.gz: ae273911ca71a1549e9a3d7b8878559cf51035d2
+  data.tar.gz: 9b0e9c6a9e336d7aca78a884622dcfaf1be5dda2
 SHA512:
-  metadata.gz: 480bc3751e1bdf1e4c89fe32f3831373bf329ed2aecaa90df6568999836ad45f5edffbc7f6e2392fe44dba78239d8cb22954cb761db01d4c100b156d60aa2824
-  data.tar.gz: 441ec6724c581f2c5c3652b130a6a81fd972dde66163bacdf655dceae2a4e37226d8c2589e967142e723a440fcabe80f3638a00dcf929b59459af6c562983d08
+  metadata.gz: 413b067f5f444b4a38ae58a1c69130beb7c8b2949547de989d04ae2e88f2184091155d74de282638d86a3dfb08d712c75ab9d11c85fef6cffff1e809a9f24c92
+  data.tar.gz: 219c6782f038990ad77bcabbfb630d1d266114b328f9d0e40951c27472c75cab4514322a50325276512c69846c9068e3d30251722bc77b6425a8641bb5b33014

data/README.md

@@ -89,6 +89,13 @@ class MySpec < Minitest::Spec
 end
 ```
 
+You can also use the `run_all_if_no_match` option to do something like always have a `:focus` tag on-demand:
+
+```rb
+Minitest::Tagz.choose_tags(*ENV['TAGS'].split(','), run_all_if_no_match: true) if ENV['TAGS']
+```
+
+
 ## Debugging
 
 You can save a reference to the tagger and watch the internal state machine:

data/lib/minitest/tagz.rb

@@ -3,13 +3,14 @@ require 'state_machine'
 
 module Minitest
   module Tagz
+    # The strategy for patching the Minitest run time
     module MinitestRunnerStrategy
       class << self
         def serialize(owner, test_name)
           "#{owner} >> #{test_name}"
         end
 
-        module Patch
+        module RunnableMethodsFilter
           def runnable_methods
             all_runnables = super
             if Tagz.chosen_tags && Tagz.chosen_tags.any?
@@ -25,8 +26,31 @@ module Minitest
           end
         end
 
+        module RunPatch
+          def run(*args)
+            # Check for no match and don't filter runnable methods if there would be no match
+            if Tagz.run_all_if_no_match?
+              run_map = Runnable.runnables.reduce({}) {|memo, r| memo[r] = r.runnable_methods; memo}
+              should_skip_filter = run_map.all? do |ctxt, methods| 
+                methods.all? do |m|
+                  serialized = MinitestRunnerStrategy.serialize(ctxt, m)
+                  tags = MinitestRunnerStrategy.tag_map[serialized]
+                  tags.nil? || tags.empty?
+                end
+              end
+              if should_skip_filter
+                puts "Couldn't find any runnables with the given tag, running all runnables"
+                return super 
+              end
+            end
+
+            ::Minitest::Test.singleton_class.prepend(RunnableMethodsFilter)
+            super
+          end
+        end
+
         def patch
-          ::Minitest::Test.singleton_class.prepend(Patch)
+          ::Minitest.singleton_class.prepend(RunPatch)
         end
 
         def tag_map
@@ -35,15 +59,22 @@ module Minitest
       end
     end
 
+    # Patch the Minitest runtime to hook into Tagz
     MinitestRunnerStrategy.patch
+
+    # Alias
     RunnerStrategy = MinitestRunnerStrategy
 
+    # Was more useful when I was trying to add
+    # shoulda-context support
     module BaseMixin
       def tag(*tags)
         Tagz.declare_tag_assignment(self, tags)
       end
     end
 
+    # Was more useful when I was trying to add
+    # shoulda-context support
     class TaggerFactory
       def self.create_tagger(owner, pending_tags)
         patchers = [MinitestPatcher]
@@ -51,6 +82,9 @@ module Minitest
       end
     end
 
+    # Represents the individual instance of a `tag` call
+    # It is essentially a state machine that works with the
+    # patcher to patch and unpatch Minitest properly
     class Tagger
       state_machine :state, initial: :awaiting_tag_declaration do
         after_transition any => :awaiting_test_definition, do: :patch_test_definitions
@@ -95,6 +129,7 @@ module Minitest
       end
     end
 
+    # Patches Minitest to track tags
     module MinitestPatcher
       ::Minitest::Test.extend(Tagz::BaseMixin)
 
@@ -153,14 +188,19 @@ module Minitest
       end
     end
 
+    # Main extensions to Minitest
     class << self
-      attr_accessor :chosen_tags
+      attr_accessor :chosen_tags, :run_all_if_no_match
+
+      alias :run_all_if_no_match? :run_all_if_no_match
 
       # Create a master TagSet that you wish to test. You only
       # want to run tests with tags in this set
       # @param [Enumerable<Symbol>] tags - a list of tags you want to test
-      def choose_tags(*tags)
+      # @param [Boolean] run_all_if_no_match - will run all tests if no tests are found with the tag
+      def choose_tags(*tags, run_all_if_no_match: false)
         @chosen_tags = tags.map(&:to_sym)
+        @run_all_if_no_match = run_all_if_no_match
       end
 
       def declare_tag_assignment(owner, pending_tags)

data/lib/minitest/tagz/version.rb

@@ -1,5 +1,5 @@
 module Minitest
   module Tagz
-    VERSION = "1.0.1"
+    VERSION = "1.1.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: minitest-tagz
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Josh Bodah
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-09 00:00:00.000000000 Z
+date: 2015-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest