async-rest 0.8.2 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d1256dc24f29fc1332acf1548cf62f8e2f4bf293e1ccf34f36f83683b518716
-  data.tar.gz: 2a463fee417542e3b29f63f4bf1b77e35ffc11d8402f426e15e5860d297a4c10
+  metadata.gz: b63889027214f114310b9fe8f9a2996f11c56e0f42a6b796312cec368de8c460
+  data.tar.gz: a054ae31432301990edc8399321dc1c678567770917afacb16f3d7ddb2ed12ec
 SHA512:
-  metadata.gz: eab724509c865977deec20a08f5ba15fadea3948a02d98f65795874dca94b7e966237b86e85780244b03e8d05cb63bfd18d025dc7092398830c48f8cfa7fee26
-  data.tar.gz: 9a1131bb6b4062c8db19c43c9c2e334dfe0465744dbc41c822125288c7fcb7b20558191902ae8439cdfc0950183b4fbb10b4a9349c6311060fdcc8650f6163fb
+  metadata.gz: 8952cfb675125f2349d71e3138211f63109ba793ff0a5062a7ecb11cf03a1379a04a6c8362ffb0605019a88a350b8bf5a0ebeaf9f281ad495d5d3567c1350d90
+  data.tar.gz: 86b0ba32227b6154ad13a2d43fff29d37608b670adc61c0fcc5e442077e20c21c8326959a58cd22fe8c566fcce02bf82ddceaf25e762fbdc2fca0e71f007daae

data/lib/async/rest/error.rb

@@ -22,5 +22,8 @@ module Async
 	module REST
 		class Error < StandardError
 		end
+		
+		class RequestFailure < Error
+		end
 	end
 end

data/lib/async/rest/representation.rb

@@ -24,9 +24,6 @@ require_relative 'wrapper/json'
 
 module Async
 	module REST
-		class RequestFailure < Error
-		end
-		
 		# REST components perform actions on a resource by using a representation to capture the current or intended state of that resource and transferring that representation between components. A representation is a sequence of bytes, plus representation metadata to describe those bytes. Other commonly used but less precise names for a representation include: document, file, and HTTP message entity, instance, or variant.
 		# 
 		# A representation consists of data, metadata describing the data, and, on occasion, metadata to describe the metadata (usually for the purpose of verifying message integrity). Metadata is in the form of name-value pairs, where the name corresponds to a standard that defines the value's structure and semantics. Response messages may include both representation metadata and resource metadata: information about the resource that is not specific to the supplied representation.
@@ -47,8 +44,12 @@ module Async
 				@value = value
 			end
 			
-			def with(**parameters)
-				self.class.new(@resource.with(parameters: parameters), wrapper: @wrapper)
+			def with(klass = self.class, **options)
+				klass.new(@resource.with(**options), wrapper: @wrapper)
+			end
+			
+			def [] **parameters
+				self.with(parameters: parameters)
 			end
 			
 			def close
@@ -87,22 +88,42 @@ module Async
 					@metadata = response.headers
 					@value = response.read
 				else
-					raise RequestFailure, "Could not fetch remote resource #{@resource}: #{response.status}!"
+					
 				end
 			end
 			
+			def value?
+				!@value.nil?
+			end
+			
 			def value
 				@value ||= value!
 			end
 			
 			def value= value
-				if @value = value
+				@value = self.assign(value)
+			end
+			
+			def call(value)
+				if value
 					self.post(value)
 				else
 					self.delete
 				end
 			end
 			
+			def assign(value)
+				response = self.call(value)
+				
+				response.read
+				
+				return @value
+			end
+			
+			def update
+				@value = assign(@value)
+			end
+			
 			def inspect
 				"\#<#{self.class} #{@resource.inspect}: value=#{@value.inspect}>"
 			end

data/lib/async/rest/version.rb

@@ -20,6 +20,6 @@
 
 module Async
 	module REST
-		VERSION = "0.8.2"
+		VERSION = "0.9.0"
 	end
 end

data/lib/async/rest/wrapper/generic.rb

@@ -0,0 +1,40 @@
+# Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Async
+	module REST
+		module Wrapper
+			class Generic
+				# @param payload [Object] a request payload to send.
+				# @param headers [Protocol::HTTP::Headers] the mutable HTTP headers for the request.
+				# @return [Body | nil] an optional request body based on the given payload.
+				def prepare_request(payload, headers)
+				end
+				
+				# @param request [Protocol::HTTP::Request] the request that was made.
+				# @param response [Protocol::HTTP::Response] the response that was received.
+				# @return [Object] some application specific representation of the response.
+				def process_response(request, response)
+					return response
+				end
+			end
+		end
+	end
+end

data/lib/async/rest/wrapper/json.rb

@@ -23,10 +23,12 @@ require 'json'
 require 'protocol/http/body/wrapper'
 require 'protocol/http/body/buffered'
 
+require_relative 'generic'
+
 module Async
 	module REST
 		module Wrapper
-			class JSON
+			class JSON < Generic
 				APPLICATION_JSON = "application/json".freeze
 				APPLICATION_JSON_STREAM = "application/json; boundary=NL".freeze
 				
@@ -53,25 +55,29 @@ module Async
 					end
 				end
 				
+				class Parser < HTTP::Body::Wrapper
+					def join
+						::JSON.parse(super, symbolize_names: true)
+					end
+				end
+				
+				def wrap_response(response)
+					if body = response.body
+						response.body = Parser.new(body)
+					end
+				end
+				
 				def process_response(request, response)
 					if content_type = response.headers['content-type']
 						if content_type.start_with? @content_type
-							if body = response.body
-								response.body = Parser.new(body)
-							end
+							wrap_response(response)
 						else
-							warn "Unknown content type: #{content_type}!"
+							raise Error, "Unknown content type: #{content_type}!"
 						end
 					end
 					
 					return response
 				end
-				
-				class Parser < HTTP::Body::Wrapper
-					def join
-						::JSON.parse(super, symbolize_names: true)
-					end
-				end
 			end
 		end
 	end

data/lib/async/rest/wrapper/url_encoded.rb

@@ -23,10 +23,12 @@ require 'json'
 require 'protocol/http/body/wrapper'
 require 'protocol/http/body/buffered'
 
+require_relative 'generic'
+
 module Async
 	module REST
 		module Wrapper
-			class URLEncoded
+			class URLEncoded < Generic
 				APPLICATION_FORM_URLENCODED = "application/x-www-form-urlencoded".freeze
 				
 				def initialize(content_type = APPLICATION_FORM_URLENCODED)
@@ -51,25 +53,29 @@ module Async
 					end
 				end
 				
+				class Parser < ::Protocol::HTTP::Body::Wrapper
+					def join
+						::Protocol::HTTP::URL.decode(super, symbolize_keys: true)
+					end
+				end
+				
+				def wrap_response(response)
+					if body = response.body
+						response.body = Parser.new(body)
+					end
+				end
+				
 				def process_response(request, response)
 					if content_type = response.headers['content-type']
 						if content_type.start_with? @content_type
-							if body = response.body
-								response.body = Parser.new(body)
-							end
+							wrap_response(response)
 						else
-							warn "Unknown content type: #{content_type}!"
+							raise Error, "Unknown content type: #{content_type}!"
 						end
 					end
 					
 					return response
 				end
-				
-				class Parser < ::Protocol::HTTP::Body::Wrapper
-					def join
-						::Protocol::HTTP::URL.decode(super, symbolize_keys: true)
-					end
-				end
 			end
 		end
 	end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: async-rest
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-31 00:00:00.000000000 Z
+date: 2019-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-http
@@ -129,6 +129,7 @@ files:
 - lib/async/rest/representation.rb
 - lib/async/rest/resource.rb
 - lib/async/rest/version.rb
+- lib/async/rest/wrapper/generic.rb
 - lib/async/rest/wrapper/json.rb
 - lib/async/rest/wrapper/url_encoded.rb
 homepage: https://github.com/socketry/async-rest