http-protocol 0.10.0 → 0.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d7eb5677113a92a47997510c060e0105f2c10ee594216469f655b1c669f9972
-  data.tar.gz: d1e93786ffd93d16b9d0d7958af486d21d60c8c231ce9a6ee614606295bf8bfb
+  metadata.gz: 6d38445cd1c5486bace349b4df0776d4a65dce709ff478d2d24d315a01d73a19
+  data.tar.gz: d93043c98af222f1c9ec6bb7fe341c8c53ac6225512e18f7cc09d012c7b4f656
 SHA512:
-  metadata.gz: 92fddea1dabc6fdfd8e866a1fce397224f675f21ba4c113e294b1cd90d59fcd1c539fc96192fb0e733745fb62e41f8f6f2d2922dee2da028fd97e90ed3afff2b
-  data.tar.gz: 68be4ce7f96677418e2a366da3c72591ced7837b720700345395cebda9be07189aee71de2998eb439a288766864f80d60c2eb17532c87972d1b8175d1c2f67a3
+  metadata.gz: 99414ae8ac5f88258d17d2e3e963ad112e61c744d30b898db419876c8b28208c356d5b185a34b327740e7c92bd85569a547d4adbbe6eb02c6a08cd68abd4253e
+  data.tar.gz: 004dedb83a3d63d795e994b581bbacf417182518f845d7b593cb45b438c17ec2f7af8702104ea36c6f0009c94afffd1539b3157b7461053fe6edb1b05c196c12

data/examples/http1/request.rb

@@ -0,0 +1,38 @@
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
+
+require 'async'
+require 'async/io/stream'
+require 'async/http/url_endpoint'
+require 'http/protocol/http1/connection'
+require 'pry'
+
+Async.run do
+	endpoint = Async::HTTP::URLEndpoint.parse("https://www.google.com/search?q=kittens", alpn_protocols: ["http/1.1"])
+	
+	peer = endpoint.connect
+	
+	puts "Connected to #{peer} #{peer.remote_address.inspect}"
+	
+	# IO Buffering...
+	stream = Async::IO::Stream.new(peer)
+	client = HTTP::Protocol::HTTP1::Connection.new(stream)
+	
+	def client.read_line
+		@stream.read_until(HTTP::Protocol::HTTP1::Connection::CRLF) or raise EOFError
+	end
+	
+	puts "Writing request..."
+	client.write_request("www.google.com", "GET", "/search?q=kittens", "HTTP/1.1", [["Accept", "*/*"]])
+	client.write_body(nil)
+	
+	puts "Reading response..."
+	response = client.read_response("GET")
+	
+	puts "Got response: #{response.inspect}"
+	
+	puts "Closing client..."
+	client.close
+end
+
+puts "Exiting."

data/examples/http2/request.rb

@@ -0,0 +1,68 @@
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
+
+require 'async'
+require 'async/io/stream'
+require 'async/http/url_endpoint'
+require 'http/protocol/http2/client'
+require 'pry'
+
+Async.run do
+	endpoint = Async::HTTP::URLEndpoint.parse("https://www.google.com/search?q=kittens")
+	
+	peer = endpoint.connect
+	
+	puts "Connected to #{peer.inspect}"
+	
+	# IO Buffering...
+	stream = Async::IO::Stream.new(peer)
+	
+	framer = HTTP::Protocol::HTTP2::Framer.new(stream)
+	client = HTTP::Protocol::HTTP2::Client.new(framer)
+	
+	puts "Sending connection preface..."
+	client.send_connection_preface
+	
+	puts "Creating stream..."
+	stream = client.create_stream
+	
+	headers = [
+		[":scheme", endpoint.scheme],
+		[":method", "GET"],
+		[":authority", "www.google.com"],
+		[":path", endpoint.path],
+		["accept", "*/*"],
+	]
+	
+	puts "Sending request on stream id=#{stream.id} state=#{stream.state}..."
+	stream.send_headers(nil, headers, HTTP::Protocol::HTTP2::END_STREAM)
+	
+	puts "Waiting for response..."
+	$count = 0
+	
+	def stream.process_headers(frame)
+		headers = super
+		puts "Got response headers: #{headers} (#{frame.end_stream?})"
+	end
+	
+	def stream.receive_data(frame)
+		data = super
+		
+		$count += data.scan(/kittens/).count
+		
+		puts "Got response data: #{data.bytesize}"
+	end
+	
+	until stream.closed?
+		frame = client.read_frame
+	end
+	
+	puts "Got #{$count} kittens!"
+	
+	binding.pry
+	
+	puts "Closing client..."
+	client.close
+end
+
+puts "Exiting."

data/examples/http2/requests.rb

@@ -0,0 +1,57 @@
+
+$LOAD_PATH.unshift File.expand_path("../../lib", __dir__)
+
+require 'async'
+require 'async/io/stream'
+require 'async/http/url_endpoint'
+require 'http/protocol/http2/client'
+require 'pry'
+
+queries = ["apple", "orange", "teapot", "async"]
+
+Async.run do
+	endpoint = Async::HTTP::URLEndpoint.parse("https://www.google.com")
+	
+	peer = endpoint.connect
+	stream = Async::IO::Stream.new(peer)
+	framer = HTTP::Protocol::HTTP2::Framer.new(stream)
+	client = HTTP::Protocol::HTTP2::Client.new(framer)
+	
+	puts "Sending connection preface..."
+	client.send_connection_preface
+	
+	puts "Creating stream..."
+	streams = queries.collect do |keyword|
+		client.create_stream.tap do |stream|
+			headers = [
+				[":scheme", endpoint.scheme],
+				[":method", "GET"],
+				[":authority", "www.google.com"],
+				[":path", "/search?q=#{keyword}"],
+				["accept", "*/*"],
+			]
+			
+			puts "Sending request on stream id=#{stream.id} state=#{stream.state}..."
+			stream.send_headers(nil, headers, HTTP::Protocol::HTTP2::END_STREAM)
+		
+			def stream.process_headers(frame)
+				headers = super
+				puts "Stream #{self.id}: Got response headers: #{headers} (#{frame.end_stream?})"
+			end
+			
+			def stream.receive_data(frame)
+				data = super
+				puts "Stream #{self.id}: Got response data: #{data.bytesize}"
+			end
+		end
+	end
+	
+	until streams.all?{|stream| stream.closed?}
+		frame = client.read_frame
+	end
+	
+	puts "Closing client..."
+	client.close
+end
+
+puts "Exiting."

data/lib/http/protocol/cgi.rb

@@ -0,0 +1,44 @@
+# 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 HTTP
+	module Protocol
+		# CGI keys (https://tools.ietf.org/html/rfc3875#section-4.1)
+		module CGI
+			AUTH_TYPE = "AUTH_TYPE".freeze
+			CONTENT_LENGTH = "CONTENT_LENGTH".freeze
+			CONTENT_TYPE = "CONTENT_TYPE".freeze
+			GATEWAY_INTERFACE = "GATEWAY_INTERFACE".freeze
+			PATH_INFO = "PATH_INFO".freeze
+			PATH_TRANSLATED = "PATH_TRANSLATED".freeze
+			QUERY_STRING = "QUERY_STRING".freeze
+			REMOTE_ADDR = "REMOTE_ADDR".freeze
+			REMOTE_HOST = "REMOTE_HOST".freeze
+			REMOTE_IDENT = "REMOTE_IDENT".freeze
+			REMOTE_USER = "REMOTE_USER".freeze
+			REQUEST_METHOD = "REQUEST_METHOD".freeze
+			SCRIPT_NAME = "SCRIPT_NAME".freeze
+			SERVER_NAME = "SERVER_NAME".freeze
+			SERVER_PORT = "SERVER_PORT".freeze
+			SERVER_PROTOCOL = "SERVER_PROTOCOL".freeze
+			SERVER_SOFTWARE = "SERVER_SOFTWARE".freeze
+		end
+	end
+end

data/lib/http/protocol/http2/client.rb

@@ -28,7 +28,7 @@ module HTTP
 					super(framer, 1)
 				end
 				
-				def send_connection_preface(settings = nil)
+				def send_connection_preface(settings = [])
 					if @state == :new
 						@framer.write_connection_preface
 						

data/lib/http/protocol/http2/frame.rb

@@ -163,7 +163,7 @@ module HTTP
 					read_header(stream) unless @length
 					
 					if @length > maximum_frame_size
-						raise FrameSizeError, "Frame length #{@length} exceeds maximum frame size #{maximum_frame_size}!"
+						raise FrameSizeError, "#{self.class} (type=#{@type}) frame length #{@length} exceeds maximum frame size #{maximum_frame_size}!"
 					end
 					
 					read_payload(stream)

data/lib/http/protocol/http2/framer.rb

@@ -97,6 +97,8 @@ module HTTP
 					frame.write(@stream)
 					
 					@stream.flush
+					
+					return frame
 				end
 				
 				def read_header

data/lib/http/protocol/http2/server.rb

@@ -28,7 +28,7 @@ module HTTP
 					super(framer, 2)
 				end
 				
-				def read_connection_preface(settings)
+				def read_connection_preface(settings = [])
 					if @state == :new
 						@framer.read_connection_preface
 						

data/lib/http/protocol/http2/settings_frame.rb

@@ -84,7 +84,7 @@ module HTTP
 					@enable_push = 1
 					@maximum_concurrent_streams = 0xFFFFFFFF
 					@initial_window_size = 0xFFFF # 2**16 - 1
-					@maximum_frame_size = 0x3FFF # 2**14 - 1
+					@maximum_frame_size = 0x4000 # 2**14
 					@maximum_header_list_size = 0xFFFFFFFF
 				end
 				

data/lib/http/protocol/methods.rb

@@ -0,0 +1,39 @@
+# 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 HTTP
+	module Protocol
+		# HTTP method verbs
+		module Methods
+			GET = 'GET'.freeze
+			POST = 'POST'.freeze
+			PUT = 'PUT'.freeze
+			PATCH = 'PATCH'.freeze
+			DELETE = 'DELETE'.freeze
+			HEAD = 'HEAD'.freeze
+			OPTIONS = 'OPTIONS'.freeze
+			LINK = 'LINK'.freeze
+			UNLINK = 'UNLINK'.freeze
+			TRACE = 'TRACE'.freeze
+			
+			# Use Methods.constants to get all constants.
+		end
+	end
+end

data/lib/http/protocol/version.rb

@@ -20,6 +20,6 @@
 
 module HTTP
 	module Protocol
-		VERSION = "0.10.0"
+		VERSION = "0.10.1"
 	end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: http-protocol
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.10.1
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-10 00:00:00.000000000 Z
+date: 2018-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http-hpack
@@ -79,8 +79,12 @@ files:
 - Gemfile
 - README.md
 - Rakefile
+- examples/http1/request.rb
+- examples/http2/request.rb
+- examples/http2/requests.rb
 - http-protocol.gemspec
 - lib/http/protocol.rb
+- lib/http/protocol/cgi.rb
 - lib/http/protocol/error.rb
 - lib/http/protocol/headers.rb
 - lib/http/protocol/http1/connection.rb
@@ -102,6 +106,7 @@ files:
 - lib/http/protocol/http2/settings_frame.rb
 - lib/http/protocol/http2/stream.rb
 - lib/http/protocol/http2/window_update_frame.rb
+- lib/http/protocol/methods.rb
 - lib/http/protocol/reference.rb
 - lib/http/protocol/version.rb
 homepage: https://github.com/socketry/http-protocol