async-http 0.40.3 → 0.41.0

data/lib/async/http/body/file.rb

@@ -1,98 +0,0 @@
-# Copyright, 2018, 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.
-
-require_relative 'readable'
-require 'async/io/stream'
-
-module Async
-	module HTTP
-		module Body
-			class File < Readable
-				BLOCK_SIZE = Async::IO::Stream::BLOCK_SIZE
-				MODE = ::File::RDONLY | ::File::BINARY
-				
-				def self.open(path, *args)
-					self.new(::File.open(path, MODE), *args)
-				end
-				
-				def initialize(file, range = nil, block_size: BLOCK_SIZE)
-					@file = file
-					
-					@block_size = block_size
-					
-					if range
-						@file.seek(range.min)
-						@offset = range.min
-						@length = @remaining = range.size
-					else
-						@offset = 0
-						@length = @remaining = @file.size
-					end
-				end
-				
-				def close(error = nil)
-					@file.close
-					@remaining = 0
-					
-					super
-				end
-				
-				attr :file
-				
-				attr :offset
-				attr :length
-				
-				def empty?
-					@remaining == 0
-				end
-				
-				def rewind
-					@file.seek(@offset)
-				end
-				
-				def read
-					if @remaining > 0
-						amount = [@remaining, @block_size].min
-						
-						if chunk = @file.read(amount)
-							@remaining -= chunk.bytesize
-							
-							return chunk
-						end
-					end
-				end
-				
-				def join
-					return "" if @remaining == 0
-					
-					buffer = @file.read(@remaining)
-					
-					@remaining = 0
-					
-					return buffer
-				end
-				
-				def inspect
-					"\#<#{self.class} file=#{@file.inspect} offset=#{@offset} remaining=#{@remaining}>"
-				end
-			end
-		end
-	end
-end

data/lib/async/http/body/fixed.rb

@@ -1,72 +0,0 @@
-# Copyright, 2018, 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.
-
-require_relative 'readable'
-
-module Async
-	module HTTP
-		module Body
-			class Fixed < Readable
-				def initialize(stream, length)
-					@stream = stream
-					@length = length
-					@remaining = length
-				end
-				
-				attr :length
-				attr :remaining
-				
-				def empty?
-					@remaining == 0
-				end
-				
-				def close(error = nil)
-					if @remaining != 0
-						@stream.close
-					end
-					
-					super
-				end
-				
-				def read
-					if @remaining > 0
-						if chunk = @stream.read_partial(@remaining)
-							@remaining -= chunk.bytesize
-							
-							return chunk
-						end
-					end
-				end
-				
-				def join
-					buffer = @stream.read(@remaining)
-					
-					@remaining = 0
-					
-					return buffer
-				end
-				
-				def inspect
-					"\#<#{self.class} length=#{@length} remaining=#{@remaining}>"
-				end
-			end
-		end
-	end
-end

data/lib/async/http/body/inflate.rb

@@ -1,59 +0,0 @@
-# Copyright, 2018, 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.
-
-require 'zlib'
-
-require_relative 'deflate'
-
-module Async
-	module HTTP
-		module Body
-			class Inflate < ZStream
-				def self.for(body, encoding = GZIP)
-					self.new(body, Zlib::Inflate.new(encoding))
-				end
-				
-				def read
-					return if @stream.finished?
-					
-					# The stream might have been closed while waiting for the chunk to come in.
-					if chunk = super
-						@input_length += chunk.bytesize
-						
-						# It's possible this triggers the stream to finish.
-						chunk = @stream.inflate(chunk)
-						
-						@output_length += chunk.bytesize
-					elsif !@stream.closed?
-						chunk = @stream.finish
-						
-						@output_length += chunk.bytesize
-					end
-					
-					if chunk.empty? and @stream.finished?
-						return nil
-					end
-					
-					return chunk
-				end
-			end
-		end
-	end
-end

data/lib/async/http/body/readable.rb

@@ -1,76 +0,0 @@
-# Copyright, 2018, 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.
-
-require 'async/io/buffer'
-
-module Async
-	module HTTP
-		module Body
-			# A generic base class for wrapping body instances. Typically you'd override `#read`.
-			class Readable
-				# The consumer can call stop to signal that the stream output has terminated.
-				def close(error = nil)
-				end
-				
-				# Will read return any data?
-				def empty?
-					false
-				end
-				
-				def length
-					nil
-				end
-				
-				# Read the next available chunk.
-				def read
-					nil
-				end
-				
-				# Read all remaining chunks into a buffered body and close the underlying input.
-				def finish
-					# Internally, this invokes `self.each` which then invokes `self.close`.
-					Buffered.for(self)
-				end
-				
-				# Enumerate all chunks until finished, then invoke `#close`.
-				def each
-					while chunk = self.read
-						yield chunk
-						# chunk.clear
-					end
-				ensure
-					self.close($!)
-				end
-				
-				# Read all remaining chunks into a single binary string using `#each`.
-				def join
-					buffer = IO::Buffer.new
-					
-					self.each do |chunk|
-						buffer << chunk
-						chunk.clear
-					end
-					
-					return buffer
-				end
-			end
-		end
-	end
-end

data/lib/async/http/body/reader.rb

@@ -1,83 +0,0 @@
-# Copyright, 2018, 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 HTTP
-		module Body
-			# General operations for interacting with a request or response body.
-			module Reader
-				# Read chunks from the body.
-				# @yield [String] read chunks from the body.
-				def each(&block)
-					if @body
-						@body.each(&block)
-						@body = nil
-					end
-				end
-				
-				# Reads the entire request/response body.
-				# @return [String] the entire body as a string.
-				def read
-					if @body
-						buffer = @body.join
-						@body = nil
-						
-						return buffer
-					end
-				end
-				
-				# Gracefully finish reading the body. This will buffer the remainder of the body.
-				# @return [Buffered] buffers the entire body.
-				def finish
-					if @body
-						body = @body.finish
-						@body = nil
-						
-						return body
-					end
-				end
-				
-				# Write the body of the response to the given file path.
-				def save(path, mode = ::File::WRONLY|::File::CREAT, *args)
-					if @body
-						::File.open(path, mode, *args) do |file|
-							self.each do |chunk|
-								file.write(chunk)
-							end
-						end
-					end
-				end
-				
-				# Close the connection as quickly as possible. Discards body. May close the underlying connection if necessary to terminate the stream.
-				def close(error = nil)
-					if @body
-						@body.close(error)
-						@body = nil
-					end
-				end
-				
-				# Whether there is a body?
-				def body?
-					@body and !@body.empty?
-				end
-			end
-		end
-	end
-end

data/lib/async/http/body/remainder.rb

@@ -1,56 +0,0 @@
-# Copyright, 2018, 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.
-
-require_relative 'readable'
-
-module Async
-	module HTTP
-		module Body
-			class Remainder < Readable
-				def initialize(stream)
-					@stream = stream
-				end
-				
-				def empty?
-					@stream.closed?
-				end
-				
-				def close(error = nil)
-					# We can't really do anything in this case except close the connection.
-					@stream.close
-					
-					super
-				end
-				
-				def read
-					@stream.read_partial
-				end
-				
-				def join
-					read
-				end
-				
-				def inspect
-					"\#<#{self.class} #{@stream.closed? ? 'closed' : 'open'}>"
-				end
-			end
-		end
-	end
-end