cucumber-messages 22.0.0 → 27.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bc766d1b3813a86b29e6616ac619ef081524af03bc0b0ca13ee43030a7f58b8
-  data.tar.gz: 8c59570b04a951846405534ad80f8ff06d93db4bb00ae719d005446e13724fc2
+  metadata.gz: 7df1a72a47d98cbc019ee52d52f81d32f6af01171359de6cdfbc70493ac9ea69
+  data.tar.gz: af04b94178bbb35139f79d8ea9cd5ced4fe9e791b8c4d282988c5a14f7bed20c
 SHA512:
-  metadata.gz: 6e65adff9ca721a531a29d11a82ddd7a229fb67aca4aec3defa97e08265bd8f64798b8c989c570e8bed2be8a79db51864fbc4040216681879d70b7915ce0e0b5
-  data.tar.gz: 3a052b3971dbc65aadad22cb7d9a6a903ab9b8fbe2558722e9cbefd558ed5761d23c8859df15dac0219a13dd6ed205c5f1fdd061273c6adf8b93e0157cb55529
+  metadata.gz: d7a247adaa729f4405dc675d304beed0cf9002a9b0437f0ef19946524169bccd5931ac4df1cdfd14f041bf15b59ecf0753d3fe304c0a17d71ad8a74af4eb4759
+  data.tar.gz: 81918251fa112bfc2819b709bb6905dc108a1af42249cf147e4cef211ff44037febbb3a9238ce04ae1bed1ef7a0adc6aa5b039fe9a48422ccfccaa0bb0076604

data/LICENSE

@@ -1,6 +1,6 @@
-The MIT License (MIT)
+MIT License
 
-Copyright (c) Cucumber Ltd
+Copyright (c) 2018 Cucumber Ltd and contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,2 +1,3 @@
 # Cucumber Messages for Ruby (JSON schema)
 
+See main [README](../README.md)

data/VERSION

@@ -1 +1 @@
-22.0.0
+27.2.0

data/lib/cucumber/messages/attachment.rb

@@ -0,0 +1,131 @@
+# 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 Attachment message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    #
+    # //// 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:
+    #
+    #  * 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`.
+    ##
+    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.
+      ##
+      attr_reader :body
+
+      ##
+      # *
+      #  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:
+      #
+      #  - 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`)
+      ##
+      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`
+      ##
+      attr_reader :media_type
+
+      attr_reader :source
+
+      attr_reader :test_case_started_id
+
+      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:
+      #
+      #  - 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.
+      ##
+      attr_reader :url
+
+      attr_reader :test_run_started_id
+
+      def initialize(
+        body: '',
+        content_encoding: AttachmentContentEncoding::IDENTITY,
+        file_name: nil,
+        media_type: '',
+        source: nil,
+        test_case_started_id: nil,
+        test_step_id: nil,
+        url: nil,
+        test_run_started_id: nil
+      )
+        @body = body
+        @content_encoding = content_encoding
+        @file_name = file_name
+        @media_type = media_type
+        @source = source
+        @test_case_started_id = test_case_started_id
+        @test_step_id = test_step_id
+        @url = url
+        @test_run_started_id = test_run_started_id
+        super()
+      end
+
+      ##
+      # Returns a new Attachment from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Attachment.from_h(some_hash) # => #<Cucumber::Messages::Attachment:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          body: hash[:body],
+          content_encoding: hash[:contentEncoding],
+          file_name: hash[:fileName],
+          media_type: hash[:mediaType],
+          source: Source.from_h(hash[:source]),
+          test_case_started_id: hash[:testCaseStartedId],
+          test_step_id: hash[:testStepId],
+          url: hash[:url],
+          test_run_started_id: hash[:testRunStartedId]
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/attachment_content_encoding.rb

@@ -0,0 +1,11 @@
+# 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
+    class AttachmentContentEncoding
+      IDENTITY = 'IDENTITY'
+      BASE64 = 'BASE64'
+    end
+  end
+end

data/lib/cucumber/messages/background.rb

@@ -0,0 +1,64 @@
+# 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 Background message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    ##
+    class Background < Message
+      ##
+      # The location of the `Background` keyword
+      ##
+      attr_reader :location
+
+      attr_reader :keyword
+
+      attr_reader :name
+
+      attr_reader :description
+
+      attr_reader :steps
+
+      attr_reader :id
+
+      def initialize(
+        location: Location.new,
+        keyword: '',
+        name: '',
+        description: '',
+        steps: [],
+        id: ''
+      )
+        @location = location
+        @keyword = keyword
+        @name = name
+        @description = description
+        @steps = steps
+        @id = id
+        super()
+      end
+
+      ##
+      # Returns a new Background from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Background.from_h(some_hash) # => #<Cucumber::Messages::Background:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          location: Location.from_h(hash[:location]),
+          keyword: hash[:keyword],
+          name: hash[:name],
+          description: hash[:description],
+          steps: hash[:steps]&.map { |item| Step.from_h(item) },
+          id: hash[:id]
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/ci.rb

@@ -0,0 +1,62 @@
+# 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 Ci message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    #
+    # CI environment
+    ##
+    class Ci < Message
+      ##
+      # Name of the CI product, e.g. "Jenkins", "CircleCI" etc.
+      ##
+      attr_reader :name
+
+      ##
+      # Link to the build
+      ##
+      attr_reader :url
+
+      ##
+      # The build number. Some CI servers use non-numeric build numbers, which is why this is a string
+      ##
+      attr_reader :build_number
+
+      attr_reader :git
+
+      def initialize(
+        name: '',
+        url: nil,
+        build_number: nil,
+        git: nil
+      )
+        @name = name
+        @url = url
+        @build_number = build_number
+        @git = git
+        super()
+      end
+
+      ##
+      # Returns a new Ci from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Ci.from_h(some_hash) # => #<Cucumber::Messages::Ci:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          name: hash[:name],
+          url: hash[:url],
+          build_number: hash[:buildNumber],
+          git: Git.from_h(hash[:git])
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/comment.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 Comment message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    #
+    # *
+    #  A comment in a Gherkin document
+    ##
+    class Comment < Message
+      ##
+      # The location of the comment
+      ##
+      attr_reader :location
+
+      ##
+      # The text of the comment
+      ##
+      attr_reader :text
+
+      def initialize(
+        location: Location.new,
+        text: ''
+      )
+        @location = location
+        @text = text
+        super()
+      end
+
+      ##
+      # Returns a new Comment from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Comment.from_h(some_hash) # => #<Cucumber::Messages::Comment:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          location: Location.from_h(hash[:location]),
+          text: hash[:text]
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/data_table.rb

@@ -0,0 +1,41 @@
+# 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 DataTable message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    ##
+    class DataTable < Message
+      attr_reader :location
+
+      attr_reader :rows
+
+      def initialize(
+        location: Location.new,
+        rows: []
+      )
+        @location = location
+        @rows = rows
+        super()
+      end
+
+      ##
+      # Returns a new DataTable from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::DataTable.from_h(some_hash) # => #<Cucumber::Messages::DataTable:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          location: Location.from_h(hash[:location]),
+          rows: hash[:rows]&.map { |item| TableRow.from_h(item) }
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/doc_string.rb

@@ -0,0 +1,51 @@
+# 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 DocString message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    ##
+    class DocString < Message
+      attr_reader :location
+
+      attr_reader :media_type
+
+      attr_reader :content
+
+      attr_reader :delimiter
+
+      def initialize(
+        location: Location.new,
+        media_type: nil,
+        content: '',
+        delimiter: ''
+      )
+        @location = location
+        @media_type = media_type
+        @content = content
+        @delimiter = delimiter
+        super()
+      end
+
+      ##
+      # Returns a new DocString from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::DocString.from_h(some_hash) # => #<Cucumber::Messages::DocString:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          location: Location.from_h(hash[:location]),
+          media_type: hash[:mediaType],
+          content: hash[:content],
+          delimiter: hash[:delimiter]
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/duration.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 Duration message in Cucumber's {message protocol}[https://github.com/cucumber/messages].
+    ##
+    #
+    # The structure is pretty close of the Timestamp one. For clarity, a second type
+    #  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.
+      ##
+      attr_reader :nanos
+
+      def initialize(
+        seconds: 0,
+        nanos: 0
+      )
+        @seconds = seconds
+        @nanos = nanos
+        super()
+      end
+
+      ##
+      # Returns a new Duration from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Duration.from_h(some_hash) # => #<Cucumber::Messages::Duration:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          seconds: hash[:seconds],
+          nanos: hash[:nanos]
+        )
+      end
+    end
+  end
+end

data/lib/cucumber/messages/envelope.rb

@@ -0,0 +1,134 @@
+# 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 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
+
+      attr_reader :gherkin_document
+
+      attr_reader :hook
+
+      attr_reader :meta
+
+      attr_reader :parameter_type
+
+      attr_reader :parse_error
+
+      attr_reader :pickle
+
+      attr_reader :source
+
+      attr_reader :step_definition
+
+      attr_reader :test_case
+
+      attr_reader :test_case_finished
+
+      attr_reader :test_case_started
+
+      attr_reader :test_run_finished
+
+      attr_reader :test_run_started
+
+      attr_reader :test_step_finished
+
+      attr_reader :test_step_started
+
+      attr_reader :test_run_hook_started
+
+      attr_reader :test_run_hook_finished
+
+      attr_reader :undefined_parameter_type
+
+      def initialize(
+        attachment: nil,
+        gherkin_document: nil,
+        hook: nil,
+        meta: nil,
+        parameter_type: nil,
+        parse_error: nil,
+        pickle: nil,
+        source: nil,
+        step_definition: nil,
+        test_case: nil,
+        test_case_finished: nil,
+        test_case_started: nil,
+        test_run_finished: nil,
+        test_run_started: nil,
+        test_step_finished: nil,
+        test_step_started: nil,
+        test_run_hook_started: nil,
+        test_run_hook_finished: nil,
+        undefined_parameter_type: nil
+      )
+        @attachment = attachment
+        @gherkin_document = gherkin_document
+        @hook = hook
+        @meta = meta
+        @parameter_type = parameter_type
+        @parse_error = parse_error
+        @pickle = pickle
+        @source = source
+        @step_definition = step_definition
+        @test_case = test_case
+        @test_case_finished = test_case_finished
+        @test_case_started = test_case_started
+        @test_run_finished = test_run_finished
+        @test_run_started = test_run_started
+        @test_step_finished = test_step_finished
+        @test_step_started = test_step_started
+        @test_run_hook_started = test_run_hook_started
+        @test_run_hook_finished = test_run_hook_finished
+        @undefined_parameter_type = undefined_parameter_type
+        super()
+      end
+
+      ##
+      # Returns a new Envelope from the given hash.
+      # If the hash keys are camelCased, they are properly assigned to the
+      # corresponding snake_cased attributes.
+      #
+      #   Cucumber::Messages::Envelope.from_h(some_hash) # => #<Cucumber::Messages::Envelope:0x... ...>
+      ##
+      def self.from_h(hash)
+        return nil if hash.nil?
+
+        new(
+          attachment: Attachment.from_h(hash[:attachment]),
+          gherkin_document: GherkinDocument.from_h(hash[:gherkinDocument]),
+          hook: Hook.from_h(hash[:hook]),
+          meta: Meta.from_h(hash[:meta]),
+          parameter_type: ParameterType.from_h(hash[:parameterType]),
+          parse_error: ParseError.from_h(hash[:parseError]),
+          pickle: Pickle.from_h(hash[:pickle]),
+          source: Source.from_h(hash[:source]),
+          step_definition: StepDefinition.from_h(hash[:stepDefinition]),
+          test_case: TestCase.from_h(hash[:testCase]),
+          test_case_finished: TestCaseFinished.from_h(hash[:testCaseFinished]),
+          test_case_started: TestCaseStarted.from_h(hash[:testCaseStarted]),
+          test_run_finished: TestRunFinished.from_h(hash[:testRunFinished]),
+          test_run_started: TestRunStarted.from_h(hash[:testRunStarted]),
+          test_step_finished: TestStepFinished.from_h(hash[:testStepFinished]),
+          test_step_started: TestStepStarted.from_h(hash[:testStepStarted]),
+          test_run_hook_started: TestRunHookStarted.from_h(hash[:testRunHookStarted]),
+          test_run_hook_finished: TestRunHookFinished.from_h(hash[:testRunHookFinished]),
+          undefined_parameter_type: UndefinedParameterType.from_h(hash[:undefinedParameterType])
+        )
+      end
+    end
+  end
+end