scorpio 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 510fd6b2b4dc5e78a4d11c08dcb7fc53901b308a4eef0b53d3d7317aabdd265f
-  data.tar.gz: d2c92b80c26f24f5f98540c456b2177d74bc13e5a2e5f461a531525631afff96
+  metadata.gz: ebea8c54d7cec0fb3572cffc6f2992882d6fd7a82739abf6656a96d095d523a7
+  data.tar.gz: a76428a2b3c8cfd00f0a3f9f639795bdcb3ac770bd97813bf4a44336158ec753
 SHA512:
-  metadata.gz: 52561bf683728001d750987ae8eb8df5356b75db3c0e1b734182a3af69227c4db6e4699d94b1a8f820802b5c5d804c9d73eebf49ea05991c309ef6b20d9ce8ff
-  data.tar.gz: 8144a386a93d397193ea952965d3de6bf398739a4b2c20a2e8dfcbd716f9721a3eae9949f5714695ce83e338353c8152954e1bee130af198973a41f7edb9e854
+  metadata.gz: f10e3c1ff2bdcfb1d3f5c8459f411508dadcd9a8f0531b1e770a5370011b4946790b6d248baace076fc99f52c0dcafcda0d7e16113ee185ae09baf9515e24f18
+  data.tar.gz: ed13200947e100a9ecb6d9ea38ed57abd1649b16144652ee9ef772a74d253416514fdee186666469009a7abb41f247af809bdc4c29ba66e374d225c9a8bd58da

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+# v0.4.3
+- misc
+
 # v0.4.2
 - improve documentation
 - misc bugfixes

data/README.md

@@ -3,13 +3,13 @@
 [![Build Status](https://travis-ci.org/notEthan/scorpio.svg?branch=master)](https://travis-ci.org/notEthan/scorpio)
 [![Coverage Status](https://coveralls.io/repos/github/notEthan/scorpio/badge.svg)](https://coveralls.io/github/notEthan/scorpio)
 
-Scorpio is a library that helps you, as a client, consume an HTTP service described by an OpenAPI document. You provide the OpenAPI specification, a little bit of configuration, and Scorpio will take that and dynamically generate an interface for you to call the service's operations and interact with its resources as an ORM.
+Scorpio is a library that helps you, as a client, consume an HTTP service described by an OpenAPI document. You provide the OpenAPI description document, a little bit of configuration, and Scorpio will take that and dynamically generate an interface for you to call the service's operations and interact with its resources as an ORM.
 
 Note: The canonical location of this README is on [RubyDoc](http://rubydoc.info/gems/scorpio/). When viewed on [Github](https://github.com/notEthan/scorpio/), it may be inconsistent with the latest released gem, and Yardoc links will not work.
 
 ## Background
 
-To start with, you need an OpenAPI (formerly known as Swagger) document describing a service you will be consuming. v2 and v3 are both supported.[^1] This document can be written by hand or sometimes generated from other existing sources. The creation of an OpenAPI document specifying your service is outside the scope of Scorpio. Here are several resources on OpenAPI:
+To start with, you need an OpenAPI (formerly known as Swagger) document describing a service you will be consuming. v2 and v3 are both supported.[^1] This document can be written by hand or sometimes generated from other existing sources. The creation of an OpenAPI document describing your service is outside the scope of Scorpio. Here are several resources on OpenAPI:
 
 - [OpenAPI Specification at Wikipedia](https://en.wikipedia.org/wiki/OpenAPI_Specification)
 - [OpenAPI Initiative](https://www.openapis.org/) is the official web site for OpenAPI
@@ -26,7 +26,7 @@ Once you have the OpenAPI document describing the service you will consume, you
 
 Let's dive into some code, shall we? If you have learned about OpenAPI, you likely learned using the example of the Pet Store service. This README will use the same service. Its documentation is at http://petstore.swagger.io/.
 
-Using the specification, we can start interacting with the pet store with very little code. Here is that code, with explanations of each part in the comments.
+Using the OpenAPI document, we can start interacting with the pet store with very little code. Here is that code, with explanations of each part in the comments.
 
 ```ruby
 require 'scorpio'
@@ -195,13 +195,13 @@ Its API is described in `test/blog.openapi.yml`, defining the Article resource,
 
 ## Scorpio::ResourceBase
 
-Scorpio::ResourceBase is the main class used in abstracting on OpenAPI document. Scorpio::ResourceBase aims to represent RESTful resources in ruby classes with as little code as possible, given a service with a properly constructed OpenAPI specification.
+Scorpio::ResourceBase is the main class used in abstracting on OpenAPI document. Scorpio::ResourceBase aims to represent RESTful resources in ruby classes with as little code as possible, given a service with a properly constructed OpenAPI document.
 
 A class which subclasses Scorpio::ResourceBase directly (such as PetStore::Resource above) should generally represent the whole API - you set the openapi_document and other configuration on this class. As such, it is generally not instantiated. Its subclasses, representing resources with a tag or with schema definitions in the OpenAPI document, are what you mostly instantiate and interact with.
 
 A model representing a resource needs to be configured, minimally, with:
 
-- the OpenAPI specification for the REST API
+- the OpenAPI document for the REST API
 - the schemas that represent instances of the model, if any
 
 If the resource has HTTP operations associated with it (most, but not all resources will):
@@ -210,7 +210,7 @@ If the resource has HTTP operations associated with it (most, but not all resour
 
 When these are set, Scorpio::ResourceBase looks through the API description and dynamically sets up methods for the model:
 
-- accessors for properties of the model defined as properties of schemas representing the resource in the specification
+- accessors for properties of the model defined as properties of schemas representing the resource in the description document
 - API method calls on the model class and, where appropriate, on the model instance
 
 ## Scorpio::Ur
@@ -250,7 +250,7 @@ end
 
 ## Other
 
-The detailed, machine-interpretable description of an API provided by a properly-constructed OpenAPI specification opens up numerous possibilities to automate aspects of clients and services to an API. These are planned to be implemented in Scorpio:
+The detailed, machine-interpretable description of an API provided by a properly-constructed OpenAPI document opens up numerous possibilities to automate aspects of clients and services to an API. These are planned to be implemented in Scorpio:
 
 - constructing test objects in a manner similar to FactoryBot, allowing you to write tests that depend on a service without having to interact with an actual running instance of that service to run your tests
 - rack middleware to test that outgoing HTTP responses are conformant to their response schemas

data/Rakefile

@@ -7,4 +7,4 @@ Rake::TestTask.new(:test) do |t|
 end
 
 require 'wwtd/tasks'
-task 'default' => 'wwtd'
+task 'default' => 'wwtd:local'

data/lib/scorpio/google_api_document.rb

@@ -1,6 +1,6 @@
 module Scorpio
   module Google
-    discovery_rest_description_doc = JSI::JSON::Node.new_by_type(::JSON.parse(Scorpio.root.join('documents/www.googleapis.com/discovery/v1/apis/discovery/v1/rest').read), [])
+    discovery_rest_description_doc = JSI::JSON::Node.new_doc(::JSON.parse(Scorpio.root.join('documents/www.googleapis.com/discovery/v1/apis/discovery/v1/rest').read))
 
     discovery_metaschema = discovery_rest_description_doc['schemas']['JsonSchema']
     rest_description_schema = JSI.class_for_schema(discovery_metaschema).new(discovery_rest_description_doc['schemas']['RestDescription'])
@@ -18,7 +18,7 @@ module Scorpio
     # google does a weird thing where it defines a schema with a $ref property where a json-schema is to be used in the document (method request and response fields), instead of just setting the schema to be the json-schema schema. we'll share a module across those schema classes that really represent schemas. is this confusingly meta enough?
     module SchemaLike
       def to_openapi
-        dup_doc = ::JSON.parse(::JSON.generate(instance.content))
+        dup_doc = JSI::Typelike.as_json(self)
         # openapi does not want an id field on schemas
         dup_doc.delete('id')
         if dup_doc['properties'].is_a?(Hash)
@@ -40,12 +40,12 @@ module Scorpio
 
     class RestDescription
       def to_openapi_document(options = {})
-        Scorpio::OpenAPI::V2::Document.new(to_openapi_hash(options))
+        Scorpio::OpenAPI::Document.from_instance(to_openapi_hash(options))
       end
 
       def to_openapi_hash(options = {})
         # we will be modifying the api document (RestDescription). clone self and modify that one.
-        ad = self.class.new(::JSON.parse(::JSON.generate(instance.document)))
+        ad = self.class.new(JSI::Typelike.as_json(instance))
         ad_methods = []
         if ad['methods']
           ad_methods += ad['methods'].map do |mn, m|
@@ -200,23 +200,7 @@ module Scorpio
             end.call(openapi)
           end
         end
-        # check we haven't got anything that shouldn't go in a openapi document
-        openapi = JSI::Util.ycomb do |rec|
-          proc do |object|
-            object = object.to_openapi if object.respond_to?(:to_openapi)
-            if object.respond_to?(:to_hash)
-              object.map { |k, v| {rec.call(k) => rec.call(v)} }.inject({}, &:update)
-            elsif object.respond_to?(:to_ary)
-              object.map(&rec)
-            elsif object.is_a?(Symbol)
-              object.to_s
-            elsif [String, TrueClass, FalseClass, NilClass, Numeric].any? { |c| object.is_a?(c) }
-              object
-            else
-              raise(TypeError, "bad (not jsonifiable) object: #{object.pretty_inspect}")
-            end
-          end
-        end.call(openapi)
+        JSI::Typelike.as_json(openapi)
       end
     end
   end

data/lib/scorpio/openapi.rb

@@ -1,7 +1,9 @@
 module Scorpio
   module OpenAPI
-    # an error in the semantics of this openapi document. for example, an Operation with
-    # two body parameters (in v2, not possible in v3) is a semantic error.
+    # an error in the semantics of an openapi document. for example, an Operation with
+    # two body parameters (in v2, not possible in v3) is a SemanticError. an Operation
+    # with more than one parameter with the same 'name' and 'in' properties would also be
+    # a SemanticError.
     #
     # an instance of a SemanticError may or may not correspond to a validation error of
     # an OpenAPI document against the OpenAPI schema.

data/lib/scorpio/openapi/document.rb

@@ -1,7 +1,7 @@
 module Scorpio
   module OpenAPI
     # A document that defines or describes an API.
-    # An OpenAPI definition uses and conforms to the OpenAPI Specification.
+    # An OpenAPI description document uses and conforms to the OpenAPI Specification.
     #
     # Scorpio::OpenAPI::Document is a module common to V2 and V3 documents.
     module Document

data/lib/scorpio/resource_base.rb

@@ -257,7 +257,7 @@ module Scorpio
       end
 
       def call_operation(operation, call_params: nil, model_attributes: nil)
-        call_params = JSI.stringify_symbol_keys(call_params) if call_params.is_a?(Hash)
+        call_params = JSI.stringify_symbol_keys(call_params) if call_params.respond_to?(:to_hash)
         model_attributes = JSI.stringify_symbol_keys(model_attributes || {})
 
         request = Scorpio::Request.new(operation)
@@ -312,7 +312,7 @@ module Scorpio
           # TODO deal with model_attributes / call_params better in nested whatever
           if call_params.nil?
             request.body_object = request_body_for_schema(model_attributes, operation.request_schema)
-          elsif call_params.is_a?(Hash)
+          elsif call_params.respond_to?(:to_hash)
             body = request_body_for_schema(model_attributes.merge(call_params), operation.request_schema)
             request.body_object = body.merge(call_params) # TODO
           else
@@ -323,7 +323,7 @@ module Scorpio
             if METHODS_WITH_BODIES.any? { |m| m.to_s == operation.http_method.downcase.to_s }
               request.body_object = other_params
             else
-              if other_params.is_a?(Hash)
+              if other_params.respond_to?(:to_hash)
                 # TODO pay more attention to 'parameters' api method attribute
                 request.query_params = other_params
               else
@@ -354,12 +354,12 @@ module Scorpio
         elsif object.is_a?(JSI::JSON::Node)
           request_body_for_schema(object.content, schema)
         else
-          if object.is_a?(Hash)
+          if object.respond_to?(:to_hash)
             object.map do |key, value|
               if schema
                 if schema['type'] == 'object'
                   # TODO code dup with response_object_to_instances
-                  if schema['properties'].respond_to?(:to_hash) && schema['properties'][key]
+                  if schema['properties'].respond_to?(:to_hash) && schema['properties'].key?(key)
                     subschema = schema['properties'][key]
                     include_pair = true
                   else
@@ -397,7 +397,7 @@ module Scorpio
                 {}
               end
             end.inject({}, &:update)
-          elsif object.is_a?(Array) || object.is_a?(Set)
+          elsif object.respond_to?(:to_ary) || object.is_a?(Set)
             object.map do |el|
               if schema
                 if schema['type'] == 'array'

data/lib/scorpio/version.rb

@@ -1,3 +1,3 @@
 module Scorpio
-  VERSION = "0.4.2"
+  VERSION = "0.4.3"
 end

data/scorpio.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |spec|
   spec.name          = "scorpio"
   spec.version       = Scorpio::VERSION
   spec.authors       = ["Ethan"]
-  spec.email         = ["ethan@unth"]
+  spec.email         = ["ethan@unth.net"]
 
   spec.summary       = 'Scorpio REST client'
   spec.description   = 'ORM style REST client'
@@ -20,8 +20,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "jsi", "~> 0.0.3"
-  spec.add_dependency "ur", "~> 0.0.2"
+  spec.add_dependency "jsi", "~> 0.1.0"
+  spec.add_dependency "ur", "~> 0.0.3"
   spec.add_dependency "faraday"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "minitest", "~> 5.0"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: scorpio
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Ethan
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-11 00:00:00.000000000 Z
+date: 2019-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jsi
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.3
+        version: 0.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.3
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: ur
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.0.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.0.3
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -250,7 +250,7 @@ dependencies:
         version: '0'
 description: ORM style REST client
 email:
-- ethan@unth
+- ethan@unth.net
 executables: []
 extensions: []
 extra_rdoc_files: []