sarif-ruby 0.1.0

data/lib/sarif/conversion.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Sarif
+  # Describes how a converter transformed the output of a static analysis tool from the analysis tool's native output format into the SARIF format.
+  class Conversion
+    attr_accessor :tool, :invocation, :analysis_tool_log_files, :properties
+
+    def initialize(tool:, invocation: nil, analysis_tool_log_files: [], properties: nil)
+      @tool = tool
+      @invocation = invocation
+      @analysis_tool_log_files = analysis_tool_log_files
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["tool"] = @tool&.to_h
+      h["invocation"] = @invocation&.to_h unless @invocation.nil?
+      h["analysisToolLogFiles"] = @analysis_tool_log_files&.map(&:to_h) if @analysis_tool_log_files&.any?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        tool: Tool.from_hash(h["tool"]),
+        invocation: Invocation.from_hash(h["invocation"]),
+        analysis_tool_log_files: h["analysisToolLogFiles"]&.map { |v| ArtifactLocation.from_hash(v) } || [],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(Conversion)
+      @tool == other.tool && @invocation == other.invocation && @analysis_tool_log_files == other.analysis_tool_log_files && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@tool, @invocation, @analysis_tool_log_files, @properties].hash
+    end
+  end
+end

data/lib/sarif/edge.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Sarif
+  # Represents a directed edge in a graph.
+  class Edge
+    attr_accessor :id, :label, :source_node_id, :target_node_id, :properties
+
+    def initialize(id:, label: nil, source_node_id:, target_node_id:, properties: nil)
+      @id = id
+      @label = label
+      @source_node_id = source_node_id
+      @target_node_id = target_node_id
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["id"] = @id
+      h["label"] = @label&.to_h unless @label.nil?
+      h["sourceNodeId"] = @source_node_id
+      h["targetNodeId"] = @target_node_id
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        id: h["id"],
+        label: Message.from_hash(h["label"]),
+        source_node_id: h["sourceNodeId"],
+        target_node_id: h["targetNodeId"],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(Edge)
+      @id == other.id && @label == other.label && @source_node_id == other.source_node_id && @target_node_id == other.target_node_id && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@id, @label, @source_node_id, @target_node_id, @properties].hash
+    end
+  end
+end

data/lib/sarif/edge_traversal.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Sarif
+  # Represents the traversal of a single edge during a graph traversal.
+  class EdgeTraversal
+    attr_accessor :edge_id, :message, :final_state, :step_over_edge_count, :properties
+
+    def initialize(edge_id:, message: nil, final_state: nil, step_over_edge_count: nil, properties: nil)
+      @edge_id = edge_id
+      @message = message
+      @final_state = final_state
+      @step_over_edge_count = step_over_edge_count
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["edgeId"] = @edge_id
+      h["message"] = @message&.to_h unless @message.nil?
+      h["finalState"] = @final_state unless @final_state.nil?
+      h["stepOverEdgeCount"] = @step_over_edge_count unless @step_over_edge_count.nil?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        edge_id: h["edgeId"],
+        message: Message.from_hash(h["message"]),
+        final_state: h["finalState"],
+        step_over_edge_count: h["stepOverEdgeCount"],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(EdgeTraversal)
+      @edge_id == other.edge_id && @message == other.message && @final_state == other.final_state && @step_over_edge_count == other.step_over_edge_count && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@edge_id, @message, @final_state, @step_over_edge_count, @properties].hash
+    end
+  end
+end

data/lib/sarif/exception.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Sarif
+  # Describes a runtime exception encountered during the execution of an analysis tool.
+  class Exception
+    attr_accessor :kind, :message, :stack, :inner_exceptions, :properties
+
+    def initialize(kind: nil, message: nil, stack: nil, inner_exceptions: [], properties: nil)
+      @kind = kind
+      @message = message
+      @stack = stack
+      @inner_exceptions = inner_exceptions
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["kind"] = @kind unless @kind.nil?
+      h["message"] = @message unless @message.nil?
+      h["stack"] = @stack&.to_h unless @stack.nil?
+      h["innerExceptions"] = @inner_exceptions&.map(&:to_h) if @inner_exceptions&.any?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        kind: h["kind"],
+        message: h["message"],
+        stack: Stack.from_hash(h["stack"]),
+        inner_exceptions: h["innerExceptions"]&.map { |v| Exception.from_hash(v) } || [],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(Exception)
+      @kind == other.kind && @message == other.message && @stack == other.stack && @inner_exceptions == other.inner_exceptions && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@kind, @message, @stack, @inner_exceptions, @properties].hash
+    end
+  end
+end

data/lib/sarif/external_properties.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Sarif
+  # The top-level element of an external property file.
+  class ExternalProperties
+    attr_accessor :schema, :version, :guid, :run_guid, :conversion, :graphs, :externalized_properties, :artifacts, :invocations, :logical_locations, :thread_flow_locations, :results, :taxonomies, :driver, :extensions, :policies, :translations, :addresses, :web_requests, :web_responses, :properties
+
+    def initialize(schema: nil, version: nil, guid: nil, run_guid: nil, conversion: nil, graphs: [], externalized_properties: nil, artifacts: nil, invocations: [], logical_locations: [], thread_flow_locations: [], results: [], taxonomies: [], driver: nil, extensions: [], policies: [], translations: [], addresses: [], web_requests: [], web_responses: [], properties: nil)
+      @schema = schema
+      @version = version
+      @guid = guid
+      @run_guid = run_guid
+      @conversion = conversion
+      @graphs = graphs
+      @externalized_properties = externalized_properties
+      @artifacts = artifacts
+      @invocations = invocations
+      @logical_locations = logical_locations
+      @thread_flow_locations = thread_flow_locations
+      @results = results
+      @taxonomies = taxonomies
+      @driver = driver
+      @extensions = extensions
+      @policies = policies
+      @translations = translations
+      @addresses = addresses
+      @web_requests = web_requests
+      @web_responses = web_responses
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["schema"] = @schema unless @schema.nil?
+      h["version"] = @version&.to_s unless @version.nil?
+      h["guid"] = @guid unless @guid.nil?
+      h["runGuid"] = @run_guid unless @run_guid.nil?
+      h["conversion"] = @conversion&.to_h unless @conversion.nil?
+      h["graphs"] = @graphs&.map(&:to_h) if @graphs&.any?
+      h["externalizedProperties"] = @externalized_properties unless @externalized_properties.nil?
+      h["artifacts"] = @artifacts&.map(&:to_h) if @artifacts&.any?
+      h["invocations"] = @invocations&.map(&:to_h) if @invocations&.any?
+      h["logicalLocations"] = @logical_locations&.map(&:to_h) if @logical_locations&.any?
+      h["threadFlowLocations"] = @thread_flow_locations&.map(&:to_h) if @thread_flow_locations&.any?
+      h["results"] = @results&.map(&:to_h) if @results&.any?
+      h["taxonomies"] = @taxonomies&.map(&:to_h) if @taxonomies&.any?
+      h["driver"] = @driver&.to_h unless @driver.nil?
+      h["extensions"] = @extensions&.map(&:to_h) if @extensions&.any?
+      h["policies"] = @policies&.map(&:to_h) if @policies&.any?
+      h["translations"] = @translations&.map(&:to_h) if @translations&.any?
+      h["addresses"] = @addresses&.map(&:to_h) if @addresses&.any?
+      h["webRequests"] = @web_requests&.map(&:to_h) if @web_requests&.any?
+      h["webResponses"] = @web_responses&.map(&:to_h) if @web_responses&.any?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        schema: h["schema"],
+        version: h["version"],
+        guid: h["guid"],
+        run_guid: h["runGuid"],
+        conversion: Conversion.from_hash(h["conversion"]),
+        graphs: h["graphs"]&.map { |v| Graph.from_hash(v) } || [],
+        externalized_properties: h["externalizedProperties"],
+        artifacts: h["artifacts"]&.map { |v| Artifact.from_hash(v) },
+        invocations: h["invocations"]&.map { |v| Invocation.from_hash(v) } || [],
+        logical_locations: h["logicalLocations"]&.map { |v| LogicalLocation.from_hash(v) } || [],
+        thread_flow_locations: h["threadFlowLocations"]&.map { |v| ThreadFlowLocation.from_hash(v) } || [],
+        results: h["results"]&.map { |v| Result.from_hash(v) } || [],
+        taxonomies: h["taxonomies"]&.map { |v| ToolComponent.from_hash(v) } || [],
+        driver: ToolComponent.from_hash(h["driver"]),
+        extensions: h["extensions"]&.map { |v| ToolComponent.from_hash(v) } || [],
+        policies: h["policies"]&.map { |v| ToolComponent.from_hash(v) } || [],
+        translations: h["translations"]&.map { |v| ToolComponent.from_hash(v) } || [],
+        addresses: h["addresses"]&.map { |v| Address.from_hash(v) } || [],
+        web_requests: h["webRequests"]&.map { |v| WebRequest.from_hash(v) } || [],
+        web_responses: h["webResponses"]&.map { |v| WebResponse.from_hash(v) } || [],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(ExternalProperties)
+      @schema == other.schema && @version == other.version && @guid == other.guid && @run_guid == other.run_guid && @conversion == other.conversion && @graphs == other.graphs && @externalized_properties == other.externalized_properties && @artifacts == other.artifacts && @invocations == other.invocations && @logical_locations == other.logical_locations && @thread_flow_locations == other.thread_flow_locations && @results == other.results && @taxonomies == other.taxonomies && @driver == other.driver && @extensions == other.extensions && @policies == other.policies && @translations == other.translations && @addresses == other.addresses && @web_requests == other.web_requests && @web_responses == other.web_responses && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@schema, @version, @guid, @run_guid, @conversion, @graphs, @externalized_properties, @artifacts, @invocations, @logical_locations, @thread_flow_locations, @results, @taxonomies, @driver, @extensions, @policies, @translations, @addresses, @web_requests, @web_responses, @properties].hash
+    end
+  end
+end

data/lib/sarif/external_property_file_reference.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Sarif
+  # Contains information that enables a SARIF consumer to locate the external property file that contains the value of an externalized property associated with the run.
+  class ExternalPropertyFileReference
+    attr_accessor :location, :guid, :item_count, :properties
+
+    def initialize(location: nil, guid: nil, item_count: -1, properties: nil)
+      @location = location
+      @guid = guid
+      @item_count = item_count
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["location"] = @location&.to_h unless @location.nil?
+      h["guid"] = @guid unless @guid.nil?
+      h["itemCount"] = @item_count if @item_count && @item_count != -1
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        location: ArtifactLocation.from_hash(h["location"]),
+        guid: h["guid"],
+        item_count: h["itemCount"] || -1,
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(ExternalPropertyFileReference)
+      @location == other.location && @guid == other.guid && @item_count == other.item_count && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@location, @guid, @item_count, @properties].hash
+    end
+  end
+end

data/lib/sarif/external_property_file_references.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Sarif
+  # References to external property files that should be inlined with the content of a root log file.
+  class ExternalPropertyFileReferences
+    attr_accessor :conversion, :graphs, :externalized_properties, :artifacts, :invocations, :logical_locations, :thread_flow_locations, :results, :taxonomies, :addresses, :driver, :extensions, :policies, :translations, :web_requests, :web_responses, :properties
+
+    def initialize(conversion: nil, graphs: [], externalized_properties: nil, artifacts: [], invocations: [], logical_locations: [], thread_flow_locations: [], results: [], taxonomies: [], addresses: [], driver: nil, extensions: [], policies: [], translations: [], web_requests: [], web_responses: [], properties: nil)
+      @conversion = conversion
+      @graphs = graphs
+      @externalized_properties = externalized_properties
+      @artifacts = artifacts
+      @invocations = invocations
+      @logical_locations = logical_locations
+      @thread_flow_locations = thread_flow_locations
+      @results = results
+      @taxonomies = taxonomies
+      @addresses = addresses
+      @driver = driver
+      @extensions = extensions
+      @policies = policies
+      @translations = translations
+      @web_requests = web_requests
+      @web_responses = web_responses
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["conversion"] = @conversion&.to_h unless @conversion.nil?
+      h["graphs"] = @graphs&.map(&:to_h) if @graphs&.any?
+      h["externalizedProperties"] = @externalized_properties&.to_h unless @externalized_properties.nil?
+      h["artifacts"] = @artifacts&.map(&:to_h) if @artifacts&.any?
+      h["invocations"] = @invocations&.map(&:to_h) if @invocations&.any?
+      h["logicalLocations"] = @logical_locations&.map(&:to_h) if @logical_locations&.any?
+      h["threadFlowLocations"] = @thread_flow_locations&.map(&:to_h) if @thread_flow_locations&.any?
+      h["results"] = @results&.map(&:to_h) if @results&.any?
+      h["taxonomies"] = @taxonomies&.map(&:to_h) if @taxonomies&.any?
+      h["addresses"] = @addresses&.map(&:to_h) if @addresses&.any?
+      h["driver"] = @driver&.to_h unless @driver.nil?
+      h["extensions"] = @extensions&.map(&:to_h) if @extensions&.any?
+      h["policies"] = @policies&.map(&:to_h) if @policies&.any?
+      h["translations"] = @translations&.map(&:to_h) if @translations&.any?
+      h["webRequests"] = @web_requests&.map(&:to_h) if @web_requests&.any?
+      h["webResponses"] = @web_responses&.map(&:to_h) if @web_responses&.any?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        conversion: ExternalPropertyFileReference.from_hash(h["conversion"]),
+        graphs: h["graphs"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        externalized_properties: ExternalPropertyFileReference.from_hash(h["externalizedProperties"]),
+        artifacts: h["artifacts"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        invocations: h["invocations"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        logical_locations: h["logicalLocations"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        thread_flow_locations: h["threadFlowLocations"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        results: h["results"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        taxonomies: h["taxonomies"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        addresses: h["addresses"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        driver: ExternalPropertyFileReference.from_hash(h["driver"]),
+        extensions: h["extensions"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        policies: h["policies"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        translations: h["translations"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        web_requests: h["webRequests"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        web_responses: h["webResponses"]&.map { |v| ExternalPropertyFileReference.from_hash(v) } || [],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(ExternalPropertyFileReferences)
+      @conversion == other.conversion && @graphs == other.graphs && @externalized_properties == other.externalized_properties && @artifacts == other.artifacts && @invocations == other.invocations && @logical_locations == other.logical_locations && @thread_flow_locations == other.thread_flow_locations && @results == other.results && @taxonomies == other.taxonomies && @addresses == other.addresses && @driver == other.driver && @extensions == other.extensions && @policies == other.policies && @translations == other.translations && @web_requests == other.web_requests && @web_responses == other.web_responses && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@conversion, @graphs, @externalized_properties, @artifacts, @invocations, @logical_locations, @thread_flow_locations, @results, @taxonomies, @addresses, @driver, @extensions, @policies, @translations, @web_requests, @web_responses, @properties].hash
+    end
+  end
+end

data/lib/sarif/fix.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Sarif
+  # A proposed fix for the problem represented by a result object. A fix specifies a set of artifacts to modify. For each artifact, it specifies a set of bytes to remove, and provides a set of new bytes to replace them.
+  class Fix
+    attr_accessor :description, :artifact_changes, :properties
+
+    def initialize(description: nil, artifact_changes:, properties: nil)
+      @description = description
+      @artifact_changes = artifact_changes
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["description"] = @description&.to_h unless @description.nil?
+      h["artifactChanges"] = @artifact_changes&.map(&:to_h)
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        description: Message.from_hash(h["description"]),
+        artifact_changes: h["artifactChanges"]&.map { |v| ArtifactChange.from_hash(v) },
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(Fix)
+      @description == other.description && @artifact_changes == other.artifact_changes && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@description, @artifact_changes, @properties].hash
+    end
+  end
+end

data/lib/sarif/graph.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Sarif
+  # A network of nodes and directed edges that describes some aspect of the structure of the code (for example, a call graph).
+  class Graph
+    attr_accessor :description, :nodes, :edges, :properties
+
+    def initialize(description: nil, nodes: [], edges: [], properties: nil)
+      @description = description
+      @nodes = nodes
+      @edges = edges
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["description"] = @description&.to_h unless @description.nil?
+      h["nodes"] = @nodes&.map(&:to_h) if @nodes&.any?
+      h["edges"] = @edges&.map(&:to_h) if @edges&.any?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        description: Message.from_hash(h["description"]),
+        nodes: h["nodes"]&.map { |v| Node.from_hash(v) } || [],
+        edges: h["edges"]&.map { |v| Edge.from_hash(v) } || [],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(Graph)
+      @description == other.description && @nodes == other.nodes && @edges == other.edges && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@description, @nodes, @edges, @properties].hash
+    end
+  end
+end

data/lib/sarif/graph_traversal.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Sarif
+  # Represents a path through a graph.
+  class GraphTraversal
+    attr_accessor :run_graph_index, :result_graph_index, :description, :initial_state, :immutable_state, :edge_traversals, :properties
+
+    def initialize(run_graph_index: -1, result_graph_index: -1, description: nil, initial_state: nil, immutable_state: nil, edge_traversals: [], properties: nil)
+      @run_graph_index = run_graph_index
+      @result_graph_index = result_graph_index
+      @description = description
+      @initial_state = initial_state
+      @immutable_state = immutable_state
+      @edge_traversals = edge_traversals
+      @properties = properties
+    end
+
+    def to_h
+      h = {}
+      h["runGraphIndex"] = @run_graph_index if @run_graph_index && @run_graph_index != -1
+      h["resultGraphIndex"] = @result_graph_index if @result_graph_index && @result_graph_index != -1
+      h["description"] = @description&.to_h unless @description.nil?
+      h["initialState"] = @initial_state unless @initial_state.nil?
+      h["immutableState"] = @immutable_state unless @immutable_state.nil?
+      h["edgeTraversals"] = @edge_traversals&.map(&:to_h) if @edge_traversals&.any?
+      h["properties"] = @properties unless @properties.nil?
+      h
+    end
+
+    def to_json(pretty: false)
+      pretty ? JSON.pretty_generate(to_h) : JSON.generate(to_h)
+    end
+
+    def self.from_hash(h)
+      return nil if h.nil?
+      new(
+        run_graph_index: h["runGraphIndex"] || -1,
+        result_graph_index: h["resultGraphIndex"] || -1,
+        description: Message.from_hash(h["description"]),
+        initial_state: h["initialState"],
+        immutable_state: h["immutableState"],
+        edge_traversals: h["edgeTraversals"]&.map { |v| EdgeTraversal.from_hash(v) } || [],
+        properties: h["properties"]
+      )
+    end
+
+    def ==(other)
+      return false unless other.is_a?(GraphTraversal)
+      @run_graph_index == other.run_graph_index && @result_graph_index == other.result_graph_index && @description == other.description && @initial_state == other.initial_state && @immutable_state == other.immutable_state && @edge_traversals == other.edge_traversals && @properties == other.properties
+    end
+
+    alias eql? ==
+
+    def hash
+      [@run_graph_index, @result_graph_index, @description, @initial_state, @immutable_state, @edge_traversals, @properties].hash
+    end
+  end
+end