openapi3_parser 0.1.0

data/lib/openapi3_parser/node_factory/object/node_builder.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node_factory/object/validator"
+require "openapi3_parser/error"
+
+module Openapi3Parser
+  module NodeFactory
+    module Object
+      class NodeBuilder
+        def initialize(input, factory)
+          @input = input
+          @factory = factory
+        end
+
+        def data
+          check_required_fields
+          check_unexpected_fields
+          check_fields_valid
+          data = input.each_with_object({}) do |(key, value), memo|
+            memo[key] = value.respond_to?(:node) ? value.node : value
+          end
+          apply_defaults(data)
+        end
+
+        private
+
+        attr_reader :input, :factory
+
+        def context
+          factory.context
+        end
+
+        def check_required_fields
+          fields = Validator.missing_required_fields(input, factory)
+          return if fields.empty?
+          raise Openapi3Parser::Error,
+                "Missing required fields for "\
+                  "#{context.stringify_namespace}: #{fields.join(', ')}"
+        end
+
+        def check_unexpected_fields
+          fields = Validator.unexpected_fields(input, factory)
+          return if fields.empty?
+          raise Openapi3Parser::Error,
+                "Unexpected fields for #{context.stringify_namespace}: "\
+                  "#{fields.join(', ')}"
+        end
+
+        def check_fields_valid
+          factory.field_configs.each do |name, field_config|
+            check_type_error(name, field_config)
+            check_validation_errors(name, field_config)
+          end
+        end
+
+        def check_type_error(name, field_config)
+          field_context = context.next_namespace(name)
+          error = field_config.input_type_error(input[name], factory)
+
+          return unless error
+          raise Openapi3Parser::Error,
+                "Invalid type for "\
+                  "#{field_context.stringify_namespace}: #{error}"
+        end
+
+        def check_validation_errors(name, field_config)
+          field_context = context.next_namespace(name)
+          errors = field_config.validation_errors(input[name], factory)
+
+          return unless errors.any?
+          raise Openapi3Parser::Error,
+                "Invalid field for #{field_context.stringify_namespace}: "\
+                "#{errors.join(', ')}"
+        end
+
+        def apply_defaults(data)
+          configs = factory.field_configs
+          configs.each_with_object(data) do |(name, field_config), _memo|
+            data[name] = field_config.default(factory) if data[name].nil?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openapi3_parser/node_factory/object/validator.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node_factory"
+require "openapi3_parser/validation/error"
+
+module Openapi3Parser
+  module NodeFactory
+    module Object
+      class Validator
+        def self.missing_required_fields(input, factory)
+          configs = factory.field_configs
+          configs.each_with_object([]) do |(name, field_config), memo|
+            memo << name if field_config.required?(factory) && input[name].nil?
+          end
+        end
+
+        def self.unexpected_fields(input, factory)
+          unexpected_keys = input.keys - factory.field_configs.keys
+          if factory.allowed_extensions?
+            unexpected_keys.reject { |k| k =~ NodeFactory::EXTENSION_REGEX }
+          else
+            unexpected_keys
+          end
+        end
+
+        def initialize(input, factory)
+          @input = input
+          @factory = factory
+        end
+
+        def errors
+          [
+            missing_required_fields_error,
+            unexpected_fields_error,
+            invalid_field_errors
+          ].flatten.compact
+        end
+
+        private
+
+        attr_reader :input, :factory
+
+        def context
+          factory.context
+        end
+
+        def missing_required_fields_error
+          fields = self.class.missing_required_fields(input, factory)
+          return unless fields.any?
+          Validation::Error.new(
+            context.namespace,
+            "Missing required fields: #{fields.join(', ')}"
+          )
+        end
+
+        def unexpected_fields_error
+          fields = self.class.unexpected_fields(input, factory)
+          return unless fields.any?
+          Validation::Error.new(
+            context.namespace,
+            "Unexpected fields: #{fields.join(', ')}"
+          )
+        end
+
+        def invalid_field_errors
+          factory.field_configs.inject([]) do |memo, (name, field_config)|
+            memo + field_errors(name, field_config)
+          end
+        end
+
+        def field_errors(name, field_config)
+          field = input[name]
+          return [] if field.nil?
+          return field.errors.to_a if field.respond_to?(:errors)
+          type_error = build_type_error(name, field_config)
+          return [type_error] if type_error
+          build_validation_errors(name, field_config)
+        end
+
+        def build_type_error(name, field_config)
+          type_error = field_config.input_type_error(input[name], factory)
+          return unless type_error
+          Validation::Error.new(
+            context.next_namespace(name),
+            "Invalid type: #{type_error}"
+          )
+        end
+
+        def build_validation_errors(name, field_config)
+          field_config.validation_errors(
+            input[name], factory
+          ).map do |error|
+            Validation::Error.new(
+              context.next_namespace(name),
+              "Invalid field: #{error}"
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/openapi3_parser/node_factory/optional_reference.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node_factories/reference"
+
+module Openapi3Parser
+  module NodeFactory
+    class OptionalReference
+      def initialize(factory)
+        @factory = factory
+      end
+
+      def call(context)
+        reference = context.input.is_a?(Hash) && context.input["$ref"]
+        return NodeFactories::Reference.new(context, self) if reference
+        factory.new(context)
+      end
+
+      private
+
+      attr_reader :factory
+    end
+  end
+end

data/lib/openapi3_parser/nodes/array.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/map"
+
+module Openapi3Parser
+  module Nodes
+    class Array
+      include Enumerable
+
+      attr_reader :node_data, :node_context
+
+      def initialize(data, context)
+        @node_data = data
+        @node_context = context
+      end
+
+      def [](value)
+        node_data[value]
+      end
+
+      def each(&block)
+        node_data.each(&block)
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/callback.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/map"
+
+module Openapi3Parser
+  module Nodes
+    class Callback
+      include Node::Map
+    end
+  end
+end

data/lib/openapi3_parser/nodes/components.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class Components
+      include Node::Object
+
+      def schemas
+        node_data["schemas"]
+      end
+
+      def responses
+        node_data["responses"]
+      end
+
+      def parameters
+        node_data["parameters"]
+      end
+
+      def examples
+        node_data["examples"]
+      end
+
+      def request_bodies
+        node_data["requestBodies"]
+      end
+
+      def headers
+        node_data["headers"]
+      end
+
+      def security_schemes
+        node_data["securitySchemes"]
+      end
+
+      def links
+        node_data["links"]
+      end
+
+      def callbacks
+        node_data["callbacks"]
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/contact.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class Contact
+      include Node::Object
+
+      def name
+        data["name"]
+      end
+
+      def url
+        data["url"]
+      end
+
+      def email
+        data["email"]
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/discriminator.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class Discriminator
+      include Node::Object
+
+      def property_name
+        node_data["propertyName"]
+      end
+
+      def mapping
+        node_data["mapping"]
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/encoding.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class Encoding
+      include Node::Object
+
+      def content_type
+        node_data["contentType"]
+      end
+
+      def headers
+        node_data["headers"]
+      end
+
+      def style
+        node_data["style"]
+      end
+
+      def explode?
+        node_data["explode"]
+      end
+
+      def allow_reserved?
+        node_data["allowReserved"]
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/example.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class Example
+      include Node::Object
+
+      def summary
+        node_data["summary"]
+      end
+
+      def description
+        node_data["description"]
+      end
+
+      def value
+        node_data["value"]
+      end
+
+      def external_value
+        node_data["externalValue"]
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/external_documentation.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class ExternalDocumentation
+      include Node::Object
+
+      def description
+        node_data["description"]
+      end
+
+      def url
+        node_data["url"]
+      end
+    end
+  end
+end

data/lib/openapi3_parser/nodes/header.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+require "openapi3_parser/nodes/parameter/parameter_like"
+
+module Openapi3Parser
+  module Nodes
+    class Header
+      include Node::Object
+      include Parameter::ParameterLike
+    end
+  end
+end

data/lib/openapi3_parser/nodes/info.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "openapi3_parser/node/object"
+
+module Openapi3Parser
+  module Nodes
+    class Info
+      include Node::Object
+
+      def title
+        node_data["title"]
+      end
+
+      def description
+        node_data["description"]
+      end
+
+      def terms_of_service
+        node_data["termsOfService"]
+      end
+
+      def contact
+        node_data["contact"]
+      end
+
+      def license
+        node_data["license"]
+      end
+
+      def version
+        node_data["version"]
+      end
+    end
+  end
+end