cucumber-messages 16.0.1 → 17.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5dc7353136f14ca646f8548de717c06e42a44fe7fed631fbfc56be51b5c82b7f
-  data.tar.gz: c654cce5e60eb55e7099af06d20ef3dae13f041fba5168f31a2cd53e437b42cd
+  metadata.gz: '0845ecc513db604a2e3e94faeacfc5be6dc389772cbc589f654396dbd6ebfc6d'
+  data.tar.gz: 6de9d6ee8b182754da2cbf05da993e14ecffe3616058ee2e5760d203eb3b2392
 SHA512:
-  metadata.gz: 9319a4c524c81b9ae89d5d0972015bb44b38039d54f4b7bc6a2387a90c2db6c200c8ff02e15a048d88ee117569c004992ff784ad2379241b22b4cde05d3f3c12
-  data.tar.gz: 3109430754f68352da28323be284797bd9f7a5e131cec07e0e0034f2cf1fd00c23cf1dbe8d93ee07024eafeace3dc3ff0553a7f6cce951749d94d35152e6f26a
+  metadata.gz: 73e9d3f8e508a2737fa2bb291e868e5cedb4156f464407f503fb4fb3361ccc35136d7c2abb68465242d8ea15a14f1f9815675382a5c83d50f75ad2d286f769ba
+  data.tar.gz: a9609a5f6b91f13d2d00a8efe0a24bdee9f4a7cad2b5ba457001339955c698c267318758b9f8276e1b4dded1fd9a517b095d28e2801e5e9ac060b5c571bd6c01

data/README.md

@@ -1,2 +1,2 @@
-# Cucumber Messages for Ruby (Protocol Buffers)
+# Cucumber Messages for Ruby (JSON schema)
 

data/VERSION

@@ -1 +1 @@
-16.0.1
+17.1.1

data/lib/cucumber/messages/message/deserialization.rb

@@ -0,0 +1,39 @@
+require 'cucumber/messages/message/utils'
+require 'json'
+
+module Cucumber
+  module Messages
+    class Message
+      include Cucumber::Messages::Message::Utils
+
+      module Deserialization
+        def self.included(other)
+          other.extend(ClassMethods)
+        end
+
+        module ClassMethods
+
+          ##
+          # Returns a new Message - or messages into an array - deserialized from the given json document.
+          # CamelCased keys are properly converted to snake_cased attributes in the process
+          #
+          #   Cucumber::Messages::Duration.from_json('{"seconds":1,"nanos":42}')               # => #<Cucumber::Messages::Duration:0x00007efda134c290 @seconds=1, @nanos=42>
+          #   Cucumber::Messages::PickleTag.from_json('{"name":"foo","astNodeId":"abc-def"}')  # => #<Cucumber::Messages::PickleTag:0x00007efda138cdb8 @name="foo", @ast_node_id="abc-def">
+          #
+          # It is recursive so embedded messages are also processed.
+          #
+          #   json_string = { location: { line: 2 }, text: "comment" }.to_json
+          #   Cucumber::Messages::Comment.from_json(json_string)  # => #<Cucumber::Messages::Comment:0x00007efda6abf888 @location=#<Cucumber::Messages::Location:0x00007efda6abf978 @line=2, @column=nil>, @text="comment">
+          #
+          #   json_string = { uri: 'file:///...', comments: [{text: 'text comment'}, {text: 'another comment'}]}.to_json
+          #   Cucumber::Messages::GherkinDocument.from_json(json_string)  # => #<Cucumber::Messages::GherkinDocument:0x00007efda11e6a90 ... @comments=[#<Cucumber::Messages::Comment:0x00007efda11e6e50 ..., #<Cucumber::Messages::Comment:0x00007efda11e6b58 ...>]>
+          #
+
+          def from_json(json_string)
+            from_h(JSON.parse(json_string, { symbolize_names: true }))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cucumber/messages/message/serialization.rb

@@ -0,0 +1,73 @@
+require 'cucumber/messages/message/utils'
+require 'json'
+
+module Cucumber
+  module Messages
+    class Message
+      include Cucumber::Messages::Message::Utils
+
+      module Serialization
+
+        ##
+        # Returns a new Hash formed from the message attributes
+        # If +camelize:+ keyword parameter is set to true, then keys will be camelized
+        # If +reject_nil_values:+ keyword parameter is set to true, resulting hash won't include nil values
+        #
+        #   Cucumber::Messages::Duration.new(seconds: 1, nanos: 42).to_h                                 # => { seconds: 1, nanos: 42 }
+        #   Cucumber::Messages::PickleTag.new(name: 'foo', ast_node_id: 'abc-def').to_h(camelize: true)  # => { name: 'foo', astNodeId: 'abc-def' }
+        #   Cucumber::Messages::PickleTag.new(name: 'foo', ast_node_id: nil).to_h(reject_nil_values: true)  # => { name: 'foo' }
+        #
+        # It is recursive so embedded messages are also processed
+        #
+        #   location = Cucumber::Messages::Location.new(line: 2)
+        #   Cucumber::Messages::Comment.new(location: location, text: 'comment').to_h  # => { location: { line: 2, :column: nil }, text: "comment" }
+        #
+
+        def to_h(camelize: false, reject_nil_values: false)
+          resulting_hash = self.instance_variables.map do |variable_name|
+            h_key = variable_name[1..-1]
+            h_key = Cucumber::Messages::Message.camelize(h_key) if camelize
+
+            h_value = prepare_value(
+              self.instance_variable_get(variable_name),
+              camelize: camelize,
+              reject_nil_values: reject_nil_values
+            )
+
+            [ h_key.to_sym, h_value ]
+          end.to_h
+
+          resulting_hash.reject! { |_, value| value.nil? } if reject_nil_values
+          resulting_hash
+        end
+
+        ##
+        # Generates a JSON document from the message.
+        # Keys are camelized during the process. Null values are not part of the json document.
+        #
+        #   Cucumber::Messages::Duration.new(seconds: 1, nanos: 42).to_json                 # => '{"seconds":1,"nanos":42}'
+        #   Cucumber::Messages::PickleTag.new(name: 'foo', ast_node_id: 'abc-def').to_json  # => '{"name":"foo","astNodeId":"abc-def"}'
+        #   Cucumber::Messages::PickleTag.new(name: 'foo', ast_node_id: nil).to_json        # => '{"name":"foo"}'
+        #
+        # As #to_h, the method is recursive
+        #
+        #   location = Cucumber::Messages::Location.new(line: 2)
+        #   Cucumber::Messages::Comment.new(location: location, text: 'comment').to_json     # => '{"location":{"line":2,"column":null},"text":"comment"}'
+        #
+
+        def to_json
+          to_h(camelize: true, reject_nil_values: true).to_json
+        end
+
+        private
+
+        def prepare_value(value, camelize:, reject_nil_values:)
+          return value.to_h(camelize: camelize, reject_nil_values: reject_nil_values) if value.is_a?(Cucumber::Messages::Message)
+          return value.map { |v| prepare_value(v, camelize: camelize, reject_nil_values: reject_nil_values) } if value.is_a?(Array)
+
+          value
+        end
+      end
+    end
+  end
+end

data/lib/cucumber/messages/message/utils.rb

@@ -0,0 +1,46 @@
+module Cucumber
+  module Messages
+    class Message
+      module Utils
+        def self.included(other)
+          other.extend(ClassMethods)
+        end
+
+        module ClassMethods
+
+          ##
+          # Makes an underscored, lowercase form from the expression in the string.
+          #
+          #   underscore('GherkinDocument')         # => "gherkin_document"
+          #
+          # This is a simplified version of the Ruby on Rails implementation
+          # https://github.com/rails/rails/blob/v6.1.3.2/activesupport/lib/active_support/inflector/methods.rb#L92
+
+          def underscore(term)
+            return term unless /[A-Z-]/.match?(term)
+
+            word = term.gsub(/([A-Z\d]+)([A-Z][a-z])/, '\1_\2')
+            word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+            word.tr!("-", "_")
+            word.downcase!
+            word
+          end
+
+          ##
+          # Converts strings to UpperCamelCase.
+          #
+          #   camelize('gherkin_document')                # => "GherkinDocument"
+          #
+          # This is a simplified version of the Ruby on Rails implementation
+          # https://github.com/rails/rails/blob/v6.1.3.2/activesupport/lib/active_support/inflector/methods.rb#L69
+
+          def camelize(term)
+            camelized = term.to_s
+            camelized.gsub!(/(?:_|(\/))([a-z\d]*)/i) { "#{$1}#{$2.capitalize}" }
+            camelized
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cucumber/messages/message.rb

@@ -0,0 +1,11 @@
+require 'cucumber/messages/message/deserialization'
+require 'cucumber/messages/message/serialization'
+
+module Cucumber
+  module Messages
+    class Message
+      include Cucumber::Messages::Message::Deserialization
+      include Cucumber::Messages::Message::Serialization
+    end
+  end
+end

data/lib/cucumber/messages/ndjson_to_message_enumerator.rb

@@ -1,4 +1,4 @@
-require 'json'
+require 'cucumber/messages.deserializers'
 
 module Cucumber
   module Messages
@@ -8,7 +8,7 @@ module Cucumber
           io.each_line do |line|
             next if line.strip.empty?
             begin
-              m = JSON.parse(line)
+              m = Envelope.from_json(line)
             rescue => e
               raise "Not JSON: #{line.strip}"
             end

data/lib/cucumber/messages/time_conversion.rb

@@ -19,7 +19,7 @@ module Cucumber
         nanos = second_modulus * NANOSECONDS_PER_SECOND
         {
           'seconds' => seconds,
-          'nanos' => nanos
+          'nanos' => nanos.to_i
         }
       end