reynard 0.0.7 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 464bcfde66e61c85b7dd949995fc3acd2db91048b80828bb4c8161c1bd5170d8
-  data.tar.gz: e219398e59d21c45e42ece44f1cadcbdb6c0ef4b5a5927cb627bafa249138b6a
+  metadata.gz: 95ca8eb7744c1550bfcf705a92d97331d9c558b08dec5f2369b166b285b38edc
+  data.tar.gz: a140a0dbe5f74c95f43d2aa785dd3c96a322eab2893b2d8a629abd3b9859724e
 SHA512:
-  metadata.gz: b3fb63f88b99b653541e92e948ba5e8cadb6edbbdb45bf6d939452d98663b7d40bf9782f5cb816665d847a0c807777e3604fef279430e30025e0228600c280e9
-  data.tar.gz: 616c0ad91e77e8d69fa66d48000079cfc530563f276e85c4bdca96a83f17e9a273a8f88ff5d8d2b5bef60160d1241263f30a83fb3be2ff065ef87974d997fadd
+  metadata.gz: 77148ca6897e1e7b0479348cfe536ff94afc5c1741b6fe59afea7940b442d7c46a71914868f572f3588b7d85d95f38446bd8d28885a22a032c91a86e71e3da28
+  data.tar.gz: eab59f1738c99af0f2c8fba6a4fb09f15a5a26f31f86de91125d9f299d2d50844060bd3c13db33b260f267a82e269175e0c69d2cdeb4f32d397e99bca74e9694

data/README.md

@@ -40,7 +40,7 @@ reynard.base_url('http://test.example.com/v1')
 You also have access to all servers in the specification so you can automatically select one however you want.
 
 ```ruby
-base_url = @reynard.servers.map(&:url).find do |url|
+base_url = reynard.servers.map(&:url).find do |url|
   /staging/.match(url)
 end
 reynard.base_url(base_url)
@@ -51,7 +51,7 @@ reynard.base_url(base_url)
 Assuming there is an operation called `employeeByUuid` you can it as shown below.
 
 ```ruby
-employee = reynard.
+response = reynard.
   operation('employeeByUuid').
   params(uuid: uuid).
   execute
@@ -60,12 +60,41 @@ employee = reynard.
 When an operation requires a body, you can add it as structured data.
 
 ```ruby
-employee = reynard.
+response = reynard.
   operation('createEmployee').
   body(name: 'Sam Seven').
   execute
 ```
 
+In case the response matches a response in the specification it will attempt to build an object using the specified schema.
+
+```ruby
+response.object.name #=> 'Sam Seven'
+```
+
+The response object shared much of its interface with `Net::HTTP::Response`.
+
+```ruby
+response.code #=> '200'
+response.content_type #=> 'application/json'
+response['Content-Type'] #=> 'application/json'
+response.body #=> '{"name":"Sam Seven"}'
+```
+
+## Mocking
+
+You can mock Reynard requests by changing the HTTP implementation. The class **must** implement a single `request` method that accepts an URI and net/http request object. It **must** return a net/http response object or an object with the exact same interface.
+
+```ruby
+Reynard.http = MyMock.new
+
+class MyMock
+  def request(uri, net_http_request)
+    Net::HTTPResponse::CODE_TO_OBJ['404'].new('HTTP/1.1', '200', 'OK')
+  end
+end
+```
+
 ## Copyright and other legal
 
 See LICENCE.

data/lib/reynard/context.rb

@@ -43,7 +43,7 @@ class Reynard
     end
 
     def execute
-      build_object(build_request.perform)
+      build_response(build_request.perform)
     end
 
     private
@@ -63,32 +63,12 @@ class Reynard
       Reynard::Http::Request.new(request_context: @request_context)
     end
 
-    def build_object(http_response)
-      media_type = @specification.media_type(
-        @request_context.operation.node,
-        http_response.code,
-        http_response.content_type
-      )
-      if media_type
-        build_object_with_media_type(http_response, media_type)
-      else
-        build_object_without_media_type(http_response)
-      end
-    end
-
-    def build_object_with_media_type(http_response, media_type)
-      ObjectBuilder.new(
-        media_type: media_type,
-        schema: @specification.schema(media_type.node),
+    def build_response(http_response)
+      Reynard::Http::Response.new(
+        specification: @specification,
+        request_context: @request_context,
         http_response: http_response
-      ).call
-    end
-
-    def build_object_without_media_type(http_response)
-      # Try to parse the response as JSON and give up otherwise.
-      OpenStruct.new(MultiJson.load(http_response.body))
-    rescue StandardError
-      http_response.body
+      )
     end
   end
 end

data/lib/reynard/http/request.rb

@@ -26,6 +26,12 @@ class Reynard
           build_http_get
         when 'post'
           build_http_post
+        when 'put'
+          build_http_put
+        when 'patch'
+          build_http_patch
+        when 'delete'
+          build_http_delete
         end
       end
 
@@ -38,6 +44,22 @@ class Reynard
         post.body = @request_context.body
         post
       end
+
+      def build_http_put
+        put = Net::HTTP::Put.new(uri, @request_context.headers)
+        put.body = @request_context.body
+        put
+      end
+
+      def build_http_patch
+        patch = Net::HTTP::Patch.new(uri, @request_context.headers)
+        patch.body = @request_context.body
+        patch
+      end
+
+      def build_http_delete
+        Net::HTTP::Delete.new(uri, @request_context.headers)
+      end
     end
   end
 end

data/lib/reynard/http/response.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+class Reynard
+  class Http
+    # Wraps an HTTP response and returns an object when it can find a definition for the response
+    # in the specification.
+    class Response
+      extend Forwardable
+      def_delegators :@http_response, :code, :content_type, :[], :body
+
+      def initialize(specification:, request_context:, http_response:)
+        @specification = specification
+        @request_context = request_context
+        @http_response = http_response
+      end
+
+      # Instantiates an object based on the schema that fits the response.
+      def object
+        return @object if defined?(@object)
+
+        @object = build_object
+      end
+
+      private
+
+      def build_object
+        media_type = @specification.media_type(
+          @request_context.operation.node,
+          @http_response.code,
+          @http_response.content_type
+        )
+        if media_type
+          build_object_with_media_type(media_type)
+        else
+          build_object_without_media_type
+        end
+      end
+
+      def build_object_with_media_type(media_type)
+        ObjectBuilder.new(
+          media_type: media_type,
+          schema: @specification.schema(media_type.node),
+          http_response: @http_response
+        ).call
+      end
+
+      def build_object_without_media_type
+        # Try to parse the response as JSON and give up otherwise.
+        OpenStruct.new(MultiJson.load(@http_response.body))
+      rescue StandardError
+        @http_response.body
+      end
+    end
+  end
+end

data/lib/reynard/http.rb

@@ -3,5 +3,6 @@
 class Reynard
   class Http
     autoload :Request, 'reynard/http/request'
+    autoload :Response, 'reynard/http/response'
   end
 end

data/lib/reynard/specification.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'rack'
+
 class Reynard
   # Wraps the YAML representation of an OpenAPI specification.
   class Specification
@@ -88,11 +90,20 @@ class Reynard
       false
     end
 
+    def self.normalize_model_name(name)
+      # 1. Unescape encoded characters to create an UTF-8 string
+      # 2. Replace all non-alphabetic characters with a space (not allowed in Ruby constant)
+      # 3. Camelcase
+      Rack::Utils.unescape_path(name)
+                 .gsub(/[^[:alpha:]]/, ' ')
+                 .gsub(/(\s+)([[:alpha:]])/) { Regexp.last_match(2).upcase }
+    end
+
     private
 
     def read
       File.open(@filename, encoding: 'UTF-8') do |file|
-        YAML.safe_load(file)
+        YAML.safe_load(file, aliases: true)
       end
     end
 
@@ -105,7 +116,7 @@ class Reynard
         next unless cursor.respond_to?(:key?) && cursor&.key?('$ref')
 
         # We currenly only supply references inside the document starting with #/.
-        path = cursor['$ref'][2..].split('/') + path
+        path = Rack::Utils.unescape_path(cursor['$ref'][2..]).split('/') + path
         cursor = data
       end
       cursor
@@ -113,16 +124,16 @@ class Reynard
 
     def schema_name(response)
       ref = response.dig('schema', '$ref')
-      ref&.split('/')&.last
+      return unless ref
+
+      self.class.normalize_model_name(ref&.split('/')&.last)
     end
 
     def item_schema_name(schema)
       ref = schema.dig('items', '$ref')
-      ref&.split('/')&.last
-    end
+      return unless ref
 
-    def object_name(_schema)
-      'Book'
+      self.class.normalize_model_name(ref&.split('/')&.last)
     end
   end
 end

data/lib/reynard/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Reynard
-  VERSION = '0.0.7'
+  VERSION = '0.2.0'
 end

data/lib/reynard.rb

@@ -34,6 +34,14 @@ class Reynard
     @specification = Specification.new(filename: filename)
   end
 
+  # Assign an object that follows Reynard's internal request interface to mock requests or use a
+  # different HTTP client.
+  class << self
+    attr_writer :http
+  end
+
+  # Returns Reynard's global request interface. This is a global object to allow persistent
+  # connections, caching, and other features that need a persistent object in the process.
   def self.http
     @http ||= begin
       http = Net::HTTP::Persistent.new(name: 'Reynard')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: reynard
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.2.0
 platform: ruby
 authors:
 - Manfred Stienstra
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-17 00:00:00.000000000 Z
+date: 2021-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -124,6 +124,7 @@ files:
 - lib/reynard/grouped_parameters.rb
 - lib/reynard/http.rb
 - lib/reynard/http/request.rb
+- lib/reynard/http/response.rb
 - lib/reynard/media_type.rb
 - lib/reynard/model.rb
 - lib/reynard/models.rb
@@ -139,7 +140,8 @@ files:
 homepage: https://github.com/Manfred/reynard
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths: