cucumber-messages 20.0.0 → 21.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3990dc466da3ed1fcfd89df413422c86fda8183a766ae660e0c8f25e72a4795
-  data.tar.gz: 24308f5d7fc28df143bc0ab232ed8a9658220a4f844cde337c556b26375d61f6
+  metadata.gz: c69e3b13529cf0bf35e26e7c08b6edd544368fa2958c7565fc93760a512cce6a
+  data.tar.gz: 46d25f56f43f92aa3df93dd3d6f6809aedf59c404797dcb86fb07a4b0a347d83
 SHA512:
-  metadata.gz: 0f8686679d4ab24f6c5c4c868d4e9d59dcdcde0743855b0332a2bdcd5374a447a85bdffec1630eb1eca37c18c10b624e6aa4243047810fe2dc26dcc6bd7625c2
-  data.tar.gz: 3a67338f63c2fa966258f8265cad066502b663bd88b0b845e1232e04894f299b4022a449c848d6419b2a939b628fc990d82a2faa586955fb53b2adc00d9c9f55
+  metadata.gz: d21bb9cde318b627dad651e94b78c832dc330d23039f37928e269d5cb28716bb92a0f0ebf09d708f7583de98c70f508951059966cb2bfe8cac968403e1abcced
+  data.tar.gz: da96eb9001e92baee65f450cdabe648e399f1bb5d406fb68650f12b0a9a00e68f5b21b12c13d6b01de12544d0984895fed7f2c2d10178266e48b93ee5ef457c7

data/VERSION

@@ -1 +1 @@
-20.0.0
+21.0.0

data/lib/cucumber/messages.deserializers.rb

@@ -88,6 +88,26 @@ module Cucumber
       end
     end
 
+    class Exception
+
+      ##
+      # Returns a new Exception from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Exception.from_h(some_hash) # => #<Cucumber::Messages::Exception:0x... ...>
+      #
+
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        self.new(
+          type: hash[:type],
+          message: hash[:message],
+        )
+      end
+    end
+
     class GherkinDocument
 
       ##
@@ -1054,6 +1074,7 @@ module Cucumber
           message: hash[:message],
           success: hash[:success],
           timestamp: Timestamp.from_h(hash[:timestamp]),
+          exception: Exception.from_h(hash[:exception]),
         )
       end
     end
@@ -1116,6 +1137,7 @@ module Cucumber
           duration: Duration.from_h(hash[:duration]),
           message: hash[:message],
           status: hash[:status],
+          exception: Exception.from_h(hash[:exception]),
         )
       end
     end

data/lib/cucumber/messages.dtos.rb

@@ -223,6 +223,34 @@ module Cucumber
     end
 
 
+    ##
+    # Represents the Exception message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    #
+    # A simplified representation of an exception
+    #
+
+    class Exception < ::Cucumber::Messages::Message
+
+      ##
+      # The type of the exception that caused this result. E.g. "Error" or "org.opentest4j.AssertionFailedError"
+
+      attr_reader :type
+
+      ##
+      # The message of exception that caused this result. E.g. expected: <"a"> but was: <"b">
+
+      attr_reader :message
+
+      def initialize(
+        type: '',
+        message: nil
+      )
+        @type = type
+        @message = message
+      end
+    end
+
+
     ##
     # Represents the GherkinDocument message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     #
@@ -1726,16 +1754,12 @@ module Cucumber
     class TestRunFinished < ::Cucumber::Messages::Message
 
       ##
-      # Error message. Can be a stack trace from a failed `BeforeAll` or `AfterAll`.
-      #  If there are undefined parameter types, the message is simply
-      #  "The following parameter type(s() are not defined: xxx, yyy".
-      #  The independent `UndefinedParameterType` messages can be used to generate
-      #  snippets for those parameter types.
+      # An informative message about the test run. Typically additional information about failure, but not necessarily.
 
       attr_reader :message
 
       ##
-      # success = StrictModeEnabled ? (failed_count == 0 && ambiguous_count == 0 && undefined_count == 0 && pending_count == 0) : (failed_count == 0 && ambiguous_count == 0)
+      # A test run is successful if all steps are either passed or skipped, all before/after hooks passed and no other exceptions where thrown.
 
       attr_reader :success
 
@@ -1744,14 +1768,21 @@ module Cucumber
 
       attr_reader :timestamp
 
+      ##
+      # Any exception thrown during the test run, if any. Does not include exceptions thrown while executing steps.
+
+      attr_reader :exception
+
       def initialize(
         message: nil,
         success: false,
-        timestamp: Timestamp.new
+        timestamp: Timestamp.new,
+        exception: nil
       )
         @message = message
         @success = success
         @timestamp = timestamp
+        @exception = exception
       end
     end
 
@@ -1814,18 +1845,28 @@ module Cucumber
 
       attr_reader :duration
 
+      ##
+      # An arbitrary bit of information that explains this result. This can be a stack trace of anything else.
+
       attr_reader :message
 
       attr_reader :status
 
+      ##
+      # Exception thrown while executing this step, if any.
+
+      attr_reader :exception
+
       def initialize(
         duration: Duration.new,
         message: nil,
-        status: TestStepResultStatus::UNKNOWN
+        status: TestStepResultStatus::UNKNOWN,
+        exception: nil
       )
         @duration = duration
         @message = message
         @status = status
+        @exception = exception
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cucumber-messages
 version: !ruby/object:Gem::Version
-  version: 20.0.0
+  version: 21.0.0
 platform: ruby
 authors:
 - Aslak Hellesøy
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-11-14 00:00:00.000000000 Z
+date: 2022-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber-compatibility-kit
@@ -127,7 +127,7 @@ requirements: []
 rubygems_version: 3.2.22
 signing_key: 
 specification_version: 4
-summary: cucumber-messages-20.0.0
+summary: cucumber-messages-21.0.0
 test_files:
 - spec/capture_warnings.rb
 - spec/cucumber/messages/acceptance_spec.rb