tracing-matchers 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7b267634453368b953b1c360b97c757a78dea84b
-  data.tar.gz: 3ca899031fbfa05514868c595911074e3d9fc556
+  metadata.gz: 453bdb76b19f9217b2e1ef3149f1f787b6bee188
+  data.tar.gz: 951d8e59a64ae2ed9f01f18e427b051c901e5d36
 SHA512:
-  metadata.gz: 8ec28d560afdac35daf3eeabcd2a59410af45d967a88b6d615ec1ee00d7a7b05f98f4a613cc3d3e1c95f9fb7cab676fe5aa869998148a7884fe9759d664c51b8
-  data.tar.gz: 45c633fa61aa88201de235a5469384015cd249a51c6b88c4ca8ed967606a68bbcd532a0d0ae7313428acd7c5309797997135212df4058def6ff689471b1d34cd
+  metadata.gz: 76455d6e26271679fa9f5c5ece791be45063a329f44a969f9d7e7f7768ca6f1c57099640f178013d29304649fbb52ce0b02184861f8a526cb39350de74a672de
+  data.tar.gz: 8d2a86f4590c50b52b759f79da0920bd3ed1ea5064384d1422081b94f9c687d7acd4a9a0f9d2e3ee70d796a50d66d16de39116be00a03b5957e88342ce4c4f80

data/README.md

@@ -36,6 +36,7 @@ expect(tracer).to have_span(optional operation_name)
                   .with_log(optional fields)
                   .with_baggage(optional baggage to match)
                   .child_of(operation_name or span or context)
+                  .following_after(operation_name or span)
 
 expect(span).to have_tag
 expect(span).to have_tags
@@ -45,6 +46,7 @@ expect(span).to have_baggage
 expect(span).to have_baggage_item
 expect(span).to have_parent
 expect(span).to be_child_of
+expect(span).to follow_after(String|Span)
 ```
 
 Detailed documentation and usage examples can be found in [matchers.rb](https://github.com/iaintshine/ruby-tracing-matchers/blob/master/lib/tracing/matchers.rb) file.

data/lib/tracing/matchers/have_span.rb

@@ -41,6 +41,12 @@ module Tracing
       end
       alias :with_parent :child_of
 
+      def follow_after(previous)
+        @predicates << Tracing::Matchers::Span::FollowAfter.new(previous)
+        self
+      end
+      alias :following_after :follow_after
+
       # @return [Boolean]
       def matches?(tracer)
         @subject = tracer

data/lib/tracing/matchers/span/follow_after.rb

@@ -0,0 +1,72 @@
+module Tracing
+  module Matchers
+    module Span
+      # @private
+      class FollowAfter
+        include Test::TypeCheck
+
+        def initialize(previous)
+          NotNull! previous
+          @expected = previous
+        end
+
+        # @return [Boolean]
+        def matches?(span)
+          @tracer = span.tracer
+          @subject = span
+
+          return false unless expected_index && subject_index
+          expected_index < subject_index
+        end
+
+        # @return [String]
+        def description
+          "follow after #{expected_message}"
+        end
+
+        # @return [String]
+        def failure_message
+          "expected #{subject_message} to follow after #{expected_message}"
+        end
+        alias :failure_message_for_should :failure_message
+
+        # @return [String]
+        def failure_message_when_negated
+          "did not expected #{subject_message} to follow after #{expected_message}"
+        end
+        alias :failure_message_for_should_not :failure_message_when_negated
+
+        private
+
+        def expected_index
+          @tracer.spans.find_index(expected_span)
+        end
+
+        def subject_index
+          @tracer.spans.find_index(@subject)
+        end
+
+        def expected_span
+          case
+          when @expected.respond_to?(:context) then @expected
+          when @expected.is_a?(String)
+            @tracer.spans.find { |span| span.operation_name == @expected }
+          else @expected
+          end
+        end
+
+        def expected_message
+          case
+          when @expected.respond_to?(:context) then "the span with operation name \"#{@expected.operation_name}\""
+          when @expected.is_a?(String) then "a span with operation name \"#{@expected}\""
+          else nil
+          end
+        end
+
+        def subject_message
+          "a span with operation name \"#{@subject.operation_name}\""
+        end
+      end
+    end
+  end
+end

data/lib/tracing/matchers/span_matchers.rb

@@ -2,6 +2,7 @@ require "tracing/matchers/span/have_tag"
 require "tracing/matchers/span/have_log"
 require "tracing/matchers/span/have_baggage"
 require "tracing/matchers/span/be_child_of"
+require "tracing/matchers/span/follow_after"
 
 module Tracing
   module Matchers
@@ -68,5 +69,18 @@ module Tracing
       Tracing::Matchers::Span::BeChildOf.new(parent)
     end
     alias :have_parent :be_child_of
+
+    # The `follow_after` matcher tests that the span follows after some other span.
+    # @example
+    #
+    #   # Passes if span follows after spcific span
+    #   expect(span).to be_child_of("previous operation")
+    #   expect(span).to be_child_of(previous_span)
+    #
+    # @param [String, Span] previous expected span to follow after
+    # @return [FollowAfter]
+    def follow_after(previous)
+      Tracing::Matchers::Span::FollowAfter.new(previous)
+    end
   end
 end

data/lib/tracing/matchers/version.rb

@@ -1,5 +1,5 @@
 module Tracing
   module Matchers
-    VERSION = "1.0.1"
+    VERSION = "1.1.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tracing-matchers
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - iaintshine
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-08-30 00:00:00.000000000 Z
+date: 2017-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-tracer
@@ -89,6 +89,7 @@ files:
 - lib/tracing/matchers/have_spans.rb
 - lib/tracing/matchers/have_traces.rb
 - lib/tracing/matchers/span/be_child_of.rb
+- lib/tracing/matchers/span/follow_after.rb
 - lib/tracing/matchers/span/have_baggage.rb
 - lib/tracing/matchers/span/have_log.rb
 - lib/tracing/matchers/span/have_tag.rb