cucumber-messages 28.0.0 → 29.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83561ce7c21a97d9e3f569e6b19d448bd19b12f84b9447d963af0c261a3d36e7
-  data.tar.gz: fe8a2b825b2b6680fada29f1dae295459b954fceb53234f2595eb71827816922
+  metadata.gz: e66ca9fa18e868a89da334e0c63c7f709eebc78a0c5cb58ded617a1d80197ffd
+  data.tar.gz: 76aa8a3325cb9183f153ecce7014e93b0ab265c28133d8e068b003ed5a9fa1eb
 SHA512:
-  metadata.gz: 16752657de9be7e6743dfb23a3e478003067d56e99ce102adc1c62f10315c7d01fd373077fa74d6e37f447ae50bd3f09fc64e7b000398c2f768e0520e6539bb1
-  data.tar.gz: d157147e8cdbb4fd87c3c2a6cb7419a13cde70c52468015f1c0b33469ba13dce2cfd772ebe90fcd36b61b0ded4e3d2a88c0f619d9a8c1772c0301fd09ecfe1ed
+  metadata.gz: 5594499de746c826e6db6647a5076d8864d5e2daf677d138701fb8eea7c6bcd9b435a79d259efbc82c9f4389acaadfb80d9105c63cb7c95417e754bd8139c254
+  data.tar.gz: 1dfd7f54dc31dacc31fb5d9429c20fec41c2c42ec7e1fafe7200e0c05648b5670be90931023f75bd943bf66ba84ed127235fecc87b032b5ea6ddba110b636547

data/VERSION

@@ -1 +1 @@
-28.0.0
+29.0.0

data/lib/cucumber/messages/attachment.rb

@@ -7,53 +7,48 @@ module Cucumber
     # Represents the Attachment message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # //// Attachments (parse errors, execution errors, screenshots, links...)
+    # Attachments (parse errors, execution errors, screenshots, links...)
     #
-    # *
-    #  An attachment represents any kind of data associated with a line in a
-    #  [Source](#io.cucumber.messages.Source) file. It can be used for:
+    # An attachment represents any kind of data associated with a line in a
+    # [Source](#io.cucumber.messages.Source) file. It can be used for:
     #
-    #  * Syntax errors during parse time
-    #  * Screenshots captured and attached during execution
-    #  * Logs captured and attached during execution
+    # * Syntax errors during parse time
+    # * Screenshots captured and attached during execution
+    # * Logs captured and attached during execution
     #
-    #  It is not to be used for runtime errors raised/thrown during execution. This
-    #  is captured in `TestResult`.
+    # It is not to be used for runtime errors raised/thrown during execution. This
+    # is captured in `TestResult`.
     ##
     class Attachment < Message
       ##
-      # *
-      #  The body of the attachment. If `contentEncoding` is `IDENTITY`, the attachment
-      #  is simply the string. If it's `BASE64`, the string should be Base64 decoded to
-      #  obtain the attachment.
+      # The body of the attachment. If `contentEncoding` is `IDENTITY`, the attachment
+      # is simply the string. If it's `BASE64`, the string should be Base64 decoded to
+      # obtain the attachment.
       ##
       attr_reader :body
 
       ##
-      # *
-      #  Whether to interpret `body` "as-is" (IDENTITY) or if it needs to be Base64-decoded (BASE64).
+      # Whether to interpret `body` "as-is" (IDENTITY) or if it needs to be Base64-decoded (BASE64).
       #
-      #  Content encoding is *not* determined by the media type, but rather by the type
-      #  of the object being attached:
+      # Content encoding is *not* determined by the media type, but rather by the type
+      # of the object being attached:
       #
-      #  - string: IDENTITY
-      #  - byte array: BASE64
-      #  - stream: BASE64
+      # - string: IDENTITY
+      # - byte array: BASE64
+      # - stream: BASE64
       ##
       attr_reader :content_encoding
 
       ##
-      # *
-      #  Suggested file name of the attachment. (Provided by the user as an argument to `attach`)
+      # Suggested file name of the attachment. (Provided by the user as an argument to `attach`)
       ##
       attr_reader :file_name
 
       ##
-      # *
-      #  The media type of the data. This can be any valid
-      #  [IANA Media Type](https://www.iana.org/assignments/media-types/media-types.xhtml)
-      #  as well as Cucumber-specific media types such as `text/x.cucumber.gherkin+plain`
-      #  and `text/x.cucumber.stacktrace+plain`
+      # The media type of the data. This can be any valid
+      # [IANA Media Type](https://www.iana.org/assignments/media-types/media-types.xhtml)
+      # as well as Cucumber-specific media types such as `text/x.cucumber.gherkin+plain`
+      # and `text/x.cucumber.stacktrace+plain`
       ##
       attr_reader :media_type
 
@@ -70,18 +65,17 @@ module Cucumber
       attr_reader :test_step_id
 
       ##
-      # *
-      #  A URL where the attachment can be retrieved. This field should not be set by Cucumber.
-      #  It should be set by a program that reads a message stream and does the following for
-      #  each Attachment message:
+      # A URL where the attachment can be retrieved. This field should not be set by Cucumber.
+      # It should be set by a program that reads a message stream and does the following for
+      # each Attachment message:
       #
-      #  - Writes the body (after base64 decoding if necessary) to a new file.
-      #  - Sets `body` and `contentEncoding` to `null`
-      #  - Writes out the new attachment message
+      # - Writes the body (after base64 decoding if necessary) to a new file.
+      # - Sets `body` and `contentEncoding` to `null`
+      # - Writes out the new attachment message
       #
-      #  This will result in a smaller message stream, which can improve performance and
-      #  reduce bandwidth of message consumers. It also makes it easier to process and download attachments
-      #  separately from reports.
+      # This will result in a smaller message stream, which can improve performance and
+      # reduce bandwidth of message consumers. It also makes it easier to process and download attachments
+      # separately from reports.
       ##
       attr_reader :url
 

data/lib/cucumber/messages/comment.rb

@@ -7,8 +7,7 @@ module Cucumber
     # Represents the Comment message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  A comment in a Gherkin document
+    # A comment in a Gherkin document
     ##
     class Comment < Message
       ##

data/lib/cucumber/messages/duration.rb

@@ -8,16 +8,16 @@ module Cucumber
     ##
     #
     # The structure is pretty close of the Timestamp one. For clarity, a second type
-    #  of message is used.
+    # of message is used.
     ##
     class Duration < Message
       attr_reader :seconds
 
       ##
       # Non-negative fractions of a second at nanosecond resolution. Negative
-      #  second values with fractions must still have non-negative nanos values
-      #  that count forward in time. Must be from 0 to 999,999,999
-      #  inclusive.
+      # second values with fractions must still have non-negative nanos values
+      # that count forward in time. Must be from 0 to 999,999,999
+      # inclusive.
       ##
       attr_reader :nanos
 

data/lib/cucumber/messages/envelope.rb

@@ -6,14 +6,6 @@ module Cucumber
     ##
     # Represents the Envelope message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
-    #
-    # When removing a field, replace it with reserved, rather than deleting the line.
-    #  When adding a field, add it to the end and increment the number by one.
-    #  See https://developers.google.com/protocol-buffers/docs/proto#updating for details
-    #
-    # *
-    #  All the messages that are passed between different components/processes are Envelope
-    #  messages.
     ##
     class Envelope < Message
       attr_reader :attachment
@@ -30,6 +22,8 @@ module Cucumber
 
       attr_reader :pickle
 
+      attr_reader :suggestion
+
       attr_reader :source
 
       attr_reader :step_definition
@@ -62,6 +56,7 @@ module Cucumber
         parameter_type: nil,
         parse_error: nil,
         pickle: nil,
+        suggestion: nil,
         source: nil,
         step_definition: nil,
         test_case: nil,
@@ -82,6 +77,7 @@ module Cucumber
         @parameter_type = parameter_type
         @parse_error = parse_error
         @pickle = pickle
+        @suggestion = suggestion
         @source = source
         @step_definition = step_definition
         @test_case = test_case
@@ -115,6 +111,7 @@ module Cucumber
           parameter_type: ParameterType.from_h(hash[:parameterType]),
           parse_error: ParseError.from_h(hash[:parseError]),
           pickle: Pickle.from_h(hash[:pickle]),
+          suggestion: Suggestion.from_h(hash[:suggestion]),
           source: Source.from_h(hash[:source]),
           step_definition: StepDefinition.from_h(hash[:stepDefinition]),
           test_case: TestCase.from_h(hash[:testCase]),

data/lib/cucumber/messages/feature_child.rb

@@ -7,8 +7,7 @@ module Cucumber
     # Represents the FeatureChild message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  A child node of a `Feature` node
+    # A child node of a `Feature` node
     ##
     class FeatureChild < Message
       attr_reader :rule

data/lib/cucumber/messages/gherkin_document.rb

@@ -7,19 +7,17 @@ module Cucumber
     # Represents the GherkinDocument message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  The [AST](https://en.wikipedia.org/wiki/Abstract_syntax_tree) of a Gherkin document.
-    #  Cucumber implementations should *not* depend on `GherkinDocument` or any of its
-    #  children for execution - use [Pickle](#io.cucumber.messages.Pickle) instead.
+    # The [AST](https://en.wikipedia.org/wiki/Abstract_syntax_tree) of a Gherkin document.
+    # Cucumber implementations should *not* depend on `GherkinDocument` or any of its
+    # children for execution - use [Pickle](#io.cucumber.messages.Pickle) instead.
     #
-    #  The only consumers of `GherkinDocument` should only be formatters that produce
-    #  "rich" output, resembling the original Gherkin document.
+    # The only consumers of `GherkinDocument` should only be formatters that produce
+    # "rich" output, resembling the original Gherkin document.
     ##
     class GherkinDocument < Message
       ##
-      # *
-      #  The [URI](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)
-      #  of the source, typically a file path relative to the root directory
+      # The [URI](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)
+      # of the source, typically a file path relative to the root directory
       ##
       attr_reader :uri
 

data/lib/cucumber/messages/git.rb

@@ -8,7 +8,7 @@ module Cucumber
     ##
     #
     # Information about Git, provided by the Build/CI server as environment
-    #  variables.
+    # variables.
     ##
     class Git < Message
       attr_reader :remote

data/lib/cucumber/messages/location.rb

@@ -7,8 +7,7 @@ module Cucumber
     # Represents the Location message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  Points to a line and a column in a text file
+    # Points to a line and a column in a text file
     ##
     class Location < Message
       attr_reader :line

data/lib/cucumber/messages/meta.rb

@@ -7,14 +7,12 @@ module Cucumber
     # Represents the Meta message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  This message contains meta information about the environment. Consumers can use
-    #  this for various purposes.
+    # This message contains meta information about the environment. Consumers can use
+    # this for various purposes.
     ##
     class Meta < Message
       ##
-      # *
-      #  The [SEMVER](https://semver.org/) version number of the protocol
+      # The [SEMVER](https://semver.org/) version number of the protocol
       ##
       attr_reader :protocol_version
 

data/lib/cucumber/messages/pickle.rb

@@ -7,24 +7,20 @@ module Cucumber
     # Represents the Pickle message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # //// Pickles
+    # A `Pickle` represents a template for a `TestCase`. It is typically derived
+    # from another format, such as [GherkinDocument](#io.cucumber.messages.GherkinDocument).
+    # In the future a `Pickle` may be derived from other formats such as Markdown or
+    # Excel files.
     #
-    # *
-    #  A `Pickle` represents a template for a `TestCase`. It is typically derived
-    #  from another format, such as [GherkinDocument](#io.cucumber.messages.GherkinDocument).
-    #  In the future a `Pickle` may be derived from other formats such as Markdown or
-    #  Excel files.
+    # By making `Pickle` the main data structure Cucumber uses for execution, the
+    # implementation of Cucumber itself becomes simpler, as it doesn't have to deal
+    # with the complex structure of a [GherkinDocument](#io.cucumber.messages.GherkinDocument).
     #
-    #  By making `Pickle` the main data structure Cucumber uses for execution, the
-    #  implementation of Cucumber itself becomes simpler, as it doesn't have to deal
-    #  with the complex structure of a [GherkinDocument](#io.cucumber.messages.GherkinDocument).
-    #
-    #  Each `PickleStep` of a `Pickle` is matched with a `StepDefinition` to create a `TestCase`
+    # Each `PickleStep` of a `Pickle` is matched with a `StepDefinition` to create a `TestCase`
     ##
     class Pickle < Message
       ##
-      # *
-      #  A unique id for the pickle
+      # A unique id for the pickle
       ##
       attr_reader :id
 
@@ -49,17 +45,15 @@ module Cucumber
       attr_reader :steps
 
       ##
-      # *
-      #  One or more tags. If this pickle is constructed from a Gherkin document,
-      #  It includes inherited tags from the `Feature` as well.
+      # One or more tags. If this pickle is constructed from a Gherkin document,
+      # It includes inherited tags from the `Feature` as well.
       ##
       attr_reader :tags
 
       ##
-      # *
-      #  Points to the AST node locations of the pickle. The last one represents the unique
-      #  id of the pickle. A pickle constructed from `Examples` will have the first
-      #  id originating from the `Scenario` AST node, and the second from the `TableRow` AST node.
+      # Points to the AST node locations of the pickle. The last one represents the unique
+      # id of the pickle. A pickle constructed from `Examples` will have the first
+      # id originating from the `Scenario` AST node, and the second from the `TableRow` AST node.
       ##
       attr_reader :ast_node_ids
 

data/lib/cucumber/messages/pickle_step.rb

@@ -7,15 +7,14 @@ module Cucumber
     # Represents the PickleStep message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  An executable step
+    # An executable step
     ##
     class PickleStep < Message
       attr_reader :argument
 
       ##
       # References the IDs of the source of the step. For Gherkin, this can be
-      #  the ID of a Step, and possibly also the ID of a TableRow
+      # the ID of a Step, and possibly also the ID of a TableRow
       ##
       attr_reader :ast_node_ids
 

data/lib/cucumber/messages/pickle_tag.rb

@@ -7,8 +7,7 @@ module Cucumber
     # Represents the PickleTag message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  A tag
+    # A tag
     ##
     class PickleTag < Message
       attr_reader :name

data/lib/cucumber/messages/rule_child.rb

@@ -7,8 +7,7 @@ module Cucumber
     # Represents the RuleChild message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  A child node of a `Rule` node
+    # A child node of a `Rule` node
     ##
     class RuleChild < Message
       attr_reader :background

data/lib/cucumber/messages/snippet.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# The code was auto-generated by {this script}[https://github.com/cucumber/messages/blob/main/codegen/codegen.rb]
+module Cucumber
+  module Messages
+    ##
+    # Represents the Snippet message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    ##
+    class Snippet < Message
+      ##
+      # The programming language of the code.
+      #
+      # This must be formatted as an all lowercase identifier such that syntax highlighters like [Prism](https://prismjs.com/#supported-languages) or [Highlight.js](https://github.com/highlightjs/highlight.js/blob/main/SUPPORTED_LANGUAGES.md) can recognize it.
+      # For example: `cpp`, `cs`, `go`, `java`, `javascript`, `php`, `python`, `ruby`, `scala`.
+      ##
+      attr_reader :language
+
+      ##
+      # A snippet of code
+      ##
+      attr_reader :code
+
+      def initialize(
+        language: '',
+        code: ''
+      )
+        @language = language
+        @code = code
+        super()
+      end
+
+      ##
+      # Returns a new Snippet from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Snippet.from_h(some_hash) # => #<Cucumber::Messages::Snippet:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          language: hash[:language],
+          code: hash[:code]
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/source.rb

@@ -7,16 +7,12 @@ module Cucumber
     # Represents the Source message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # //// Source
-    #
-    # *
-    #  A source file, typically a Gherkin document or Java/Ruby/JavaScript source code
+    # A source file, typically a Gherkin document or Java/Ruby/JavaScript source code
     ##
     class Source < Message
       ##
-      # *
-      #  The [URI](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)
-      #  of the source, typically a file path relative to the root directory
+      # The [URI](https://en.wikipedia.org/wiki/Uniform_Resource_Identifier)
+      # of the source, typically a file path relative to the root directory
       ##
       attr_reader :uri
 
@@ -27,7 +23,7 @@ module Cucumber
 
       ##
       # The media type of the file. Can be used to specify custom types, such as
-      #  text/x.cucumber.gherkin+plain
+      # text/x.cucumber.gherkin+plain
       ##
       attr_reader :media_type
 

data/lib/cucumber/messages/source_reference.rb

@@ -7,9 +7,8 @@ module Cucumber
     # Represents the SourceReference message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  Points to a [Source](#io.cucumber.messages.Source) identified by `uri` and a
-    #  [Location](#io.cucumber.messages.Location) within that file.
+    # Points to a [Source](#io.cucumber.messages.Source) identified by `uri` and a
+    # [Location](#io.cucumber.messages.Location) within that file.
     ##
     class SourceReference < Message
       attr_reader :uri

data/lib/cucumber/messages/step_match_argument.rb

@@ -7,19 +7,17 @@ module Cucumber
     # Represents the StepMatchArgument message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  Represents a single argument extracted from a step match and passed to a step definition.
-    #  This is used for the following purposes:
-    #  - Construct an argument to pass to a step definition (possibly through a parameter type transform)
-    #  - Highlight the matched parameter in rich formatters such as the HTML formatter
+    # Represents a single argument extracted from a step match and passed to a step definition.
+    # This is used for the following purposes:
+    # - Construct an argument to pass to a step definition (possibly through a parameter type transform)
+    # - Highlight the matched parameter in rich formatters such as the HTML formatter
     #
-    #  This message closely matches the `Argument` class in the `cucumber-expressions` library.
+    # This message closely matches the `Argument` class in the `cucumber-expressions` library.
     ##
     class StepMatchArgument < Message
       ##
-      # *
-      #  Represents the outermost capture group of an argument. This message closely matches the
-      #  `Group` class in the `cucumber-expressions` library.
+      # Represents the outermost capture group of an argument. This message closely matches the
+      # `Group` class in the `cucumber-expressions` library.
       ##
       attr_reader :group
 

data/lib/cucumber/messages/suggestion.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# The code was auto-generated by {this script}[https://github.com/cucumber/messages/blob/main/codegen/codegen.rb]
+module Cucumber
+  module Messages
+    ##
+    # Represents the Suggestion message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    #
+    # A suggested fragment of code to implement an undefined step
+    ##
+    class Suggestion < Message
+      ##
+      # A unique id for this suggestion
+      ##
+      attr_reader :id
+
+      ##
+      # The ID of the `PickleStep` this `Suggestion` was created for.
+      ##
+      attr_reader :pickle_step_id
+
+      ##
+      # A collection of code snippets that could implement the undefined step
+      ##
+      attr_reader :snippets
+
+      def initialize(
+        id: '',
+        pickle_step_id: '',
+        snippets: []
+      )
+        @id = id
+        @pickle_step_id = pickle_step_id
+        @snippets = snippets
+        super()
+      end
+
+      ##
+      # Returns a new Suggestion from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Suggestion.from_h(some_hash) # => #<Cucumber::Messages::Suggestion:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          id: hash[:id],
+          pickle_step_id: hash[:pickleStepId],
+          snippets: hash[:snippets]&.map { |item| Snippet.from_h(item) }
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/tag.rb

@@ -7,8 +7,7 @@ module Cucumber
     # Represents the Tag message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  A tag
+    # A tag
     ##
     class Tag < Message
       ##

data/lib/cucumber/messages/test_case.rb

@@ -7,10 +7,7 @@ module Cucumber
     # Represents the TestCase message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # //// TestCases
-    #
-    # *
-    #  A `TestCase` contains a sequence of `TestStep`s.
+    # A `TestCase` contains a sequence of `TestStep`s.
     ##
     class TestCase < Message
       attr_reader :id

data/lib/cucumber/messages/test_case_started.rb

@@ -9,16 +9,14 @@ module Cucumber
     ##
     class TestCaseStarted < Message
       ##
-      # *
-      #  The first attempt should have value 0, and for each retry the value
-      #  should increase by 1.
+      # The first attempt should have value 0, and for each retry the value
+      # should increase by 1.
       ##
       attr_reader :attempt
 
       ##
-      # *
-      #  Because a `TestCase` can be run multiple times (in case of a retry),
-      #  we use this field to group messages relating to the same attempt.
+      # Because a `TestCase` can be run multiple times (in case of a retry),
+      # we use this field to group messages relating to the same attempt.
       ##
       attr_reader :id
 

data/lib/cucumber/messages/test_run_hook_started.rb

@@ -23,17 +23,24 @@ module Cucumber
       ##
       attr_reader :hook_id
 
+      ##
+      # An identifier for the worker process running this hook, if parallel workers are in use. The identifier will be unique per worker, but no particular format is defined - it could be an index, uuid, machine name etc - and as such should be assumed that it's not human readable.
+      ##
+      attr_reader :worker_id
+
       attr_reader :timestamp
 
       def initialize(
         id: '',
         test_run_started_id: '',
         hook_id: '',
+        worker_id: nil,
         timestamp: Timestamp.new
       )
         @id = id
         @test_run_started_id = test_run_started_id
         @hook_id = hook_id
+        @worker_id = worker_id
         @timestamp = timestamp
         super()
       end
@@ -52,6 +59,7 @@ module Cucumber
           id: hash[:id],
           test_run_started_id: hash[:testRunStartedId],
           hook_id: hash[:hookId],
+          worker_id: hash[:workerId],
           timestamp: Timestamp.from_h(hash[:timestamp])
         )
       end

data/lib/cucumber/messages/test_step.rb

@@ -7,9 +7,11 @@ module Cucumber
     # Represents the TestStep message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
     ##
     #
-    # *
-    #  A `TestStep` is derived from either a `PickleStep`
-    #  combined with a `StepDefinition`, or from a `Hook`.
+    # A `TestStep` is derived from either a `PickleStep` combined with a `StepDefinition`, or from a `Hook`.
+    #
+    # When derived from a PickleStep:
+    #  * For `UNDEFINED` steps `stepDefinitionIds` and `stepMatchArgumentsLists` will be empty.
+    #  * For `AMBIGUOUS` steps, there will be multiple entries in `stepDefinitionIds` and `stepMatchArgumentsLists`. The first entry in the stepMatchArgumentsLists holds the list of arguments for the first matching step definition, the second entry for the second, etc
     ##
     class TestStep < Message
       ##
@@ -25,14 +27,16 @@ module Cucumber
       attr_reader :pickle_step_id
 
       ##
-      # Pointer to all the matching `StepDefinition`s (if derived from a `PickleStep`)
-      #  Each element represents a matching step definition. A size of 0 means `UNDEFINED`,
-      #  and a size of 2+ means `AMBIGUOUS`
+      # Pointer to all the matching `StepDefinition`s (if derived from a `PickleStep`).
+      #
+      # Each element represents a matching step definition.
       ##
       attr_reader :step_definition_ids
 
       ##
       # A list of list of StepMatchArgument (if derived from a `PickleStep`).
+      #
+      # Each element represents the arguments for a matching step definition.
       ##
       attr_reader :step_match_arguments_lists
 

data/lib/cucumber/messages/test_step_result.rb

@@ -11,7 +11,7 @@ module Cucumber
       attr_reader :duration
 
       ##
-      # An arbitrary bit of information that explains this result. This can be a stack trace of anything else.
+      # An arbitrary bit of information that explains this result. If there was an exception, this should include a stringified representation of it including type, message and stack trace (the exact format will vary by platform).
       ##
       attr_reader :message
 

data/lib/cucumber/messages/timestamp.rb

@@ -10,16 +10,16 @@ module Cucumber
     class Timestamp < Message
       ##
       # Represents seconds of UTC time since Unix epoch
-      #  1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
-      #  9999-12-31T23:59:59Z inclusive.
+      # 1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+      # 9999-12-31T23:59:59Z inclusive.
       ##
       attr_reader :seconds
 
       ##
       # Non-negative fractions of a second at nanosecond resolution. Negative
-      #  second values with fractions must still have non-negative nanos values
-      #  that count forward in time. Must be from 0 to 999,999,999
-      #  inclusive.
+      # second values with fractions must still have non-negative nanos values
+      # that count forward in time. Must be from 0 to 999,999,999
+      # inclusive.
       ##
       attr_reader :nanos
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cucumber-messages
 version: !ruby/object:Gem::Version
-  version: 28.0.0
+  version: 29.0.0
 platform: ruby
 authors:
 - Aslak Hellesøy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-07 00:00:00.000000000 Z
+date: 2025-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cucumber-compatibility-kit
@@ -161,6 +161,7 @@ files:
 - lib/cucumber/messages/rule.rb
 - lib/cucumber/messages/rule_child.rb
 - lib/cucumber/messages/scenario.rb
+- lib/cucumber/messages/snippet.rb
 - lib/cucumber/messages/source.rb
 - lib/cucumber/messages/source_media_type.rb
 - lib/cucumber/messages/source_reference.rb
@@ -171,6 +172,7 @@ files:
 - lib/cucumber/messages/step_keyword_type.rb
 - lib/cucumber/messages/step_match_argument.rb
 - lib/cucumber/messages/step_match_arguments_list.rb
+- lib/cucumber/messages/suggestion.rb
 - lib/cucumber/messages/table_cell.rb
 - lib/cucumber/messages/table_row.rb
 - lib/cucumber/messages/tag.rb
@@ -216,5 +218,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: cucumber-messages-28.0.0
+summary: cucumber-messages-29.0.0
 test_files: []