protocol-websocket 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7a0f15089bc637ca5755d75a9cea1f219ad1b4903ad7d267f1faf26021bf050d
+  data.tar.gz: c1e73cce6d131bbb0ef398144c48b08ea6439c46268ff1c12ab1f12679b1c8aa
+SHA512:
+  metadata.gz: 0a2f6af33312ea2d00a13124422344a7dfbd1ba01077ffd8747ba8ab7125626bd6d2a8dfe69b28d29417f790dc247c49e87174bb4a74fe2b87919f27c54721f7
+  data.tar.gz: 52b56ed1c83b0fe0869fffa67a90ea01650020104eef81dce01ee151e911035df6c8b5df4a493fac36f76a6e1a9cd4a744cb046373e8139cd23ff9ebf34409d7

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--warnings
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+dist: xenial
+cache: bundler
+
+matrix:
+  include:
+    - rvm: 2.4
+    - rvm: 2.5
+    - rvm: 2.6
+    - rvm: 2.6
+      env: COVERAGE=PartialSummary,Coveralls
+    - rvm: truffleruby
+    - rvm: jruby-head
+      env: JRUBY_OPTS="--debug -X+O"
+    - rvm: ruby-head
+  allow_failures:
+    - rvm: truffleruby
+    - rvm: ruby-head
+    - rvm: jruby-head

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in protocol-websocket.gemspec
+gemspec

data/README.md

@@ -0,0 +1,64 @@
+# Protocol::WebSocket
+
+Provides a low-level implementation of the WebSocket protocol according to [RFC6455](https://tools.ietf.org/html/rfc6455). It only implements the latest stable version (13).
+
+[![Build Status](https://secure.travis-ci.com/socketry/protocol-websocket.svg)](http://travis-ci.com/socketry/protocol-websocket)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'protocol-websocket'
+```
+
+And then execute:
+
+	$ bundle
+
+Or install it yourself as:
+
+	$ gem install protocol-websocket
+
+## Usage
+
+Here is a basic WebSocket client:
+
+```ruby
+stream = # connect to remote system
+framer = Protocol::WebSocket::Framer.new(stream)
+
+frame = framer.read_frame
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+Released under the MIT license.
+
+Copyright, 2019, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).  
+
+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.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/protocol/websocket.rb

@@ -0,0 +1,22 @@
+# 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.
+
+require_relative 'websocket/version'
+require_relative 'websocket/framer'

data/lib/protocol/websocket/digest.rb

@@ -0,0 +1,31 @@
+# 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.
+
+require 'digest/sha1'
+
+module Protocol
+	module WebSocket
+		GUID = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11"
+		
+		def self.accept_digest(key)
+			Digest::SHA1.base64digest(key + GUID)
+		end
+	end
+end

data/lib/protocol/websocket/error.rb

@@ -0,0 +1,31 @@
+# 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.
+
+require 'protocol/http/error'
+
+module Protocol
+	module WebSocket
+		class BadRequest < HTTP::BadRequest
+		end
+		
+		class ProtocolError < HTTP::ProtocolError
+		end
+	end
+end

data/lib/protocol/websocket/frame.rb

@@ -0,0 +1,204 @@
+# 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.
+
+require_relative 'error'
+
+module Protocol
+	module WebSocket
+		class Frame
+			include Comparable
+			
+			# Opcodes
+			CONTINUATION = 0x0
+			TEXT = 0x1
+			BINARY = 0x2
+			CLOSE = 0x8
+			PING = 0x9
+			PONG = 0xA
+			
+			# @param length [Integer] the length of the payload, or nil if the header has not been read yet.
+			def initialize(fin = true, opcode = 0, mask = nil, payload = nil)
+				@fin = fin
+				@opcode = opcode
+				@mask = mask
+				@length = payload&.bytesize
+				@payload = payload
+			end
+			
+			def self.read(stream)
+				frame = self.new
+				
+				if frame.read(stream)
+					return frame
+				end
+			rescue EOFError
+				return nil
+			end
+			
+			def <=> other
+				to_ary <=> other.to_ary
+			end
+			
+			def to_ary
+				[@fin, @opcode, @mask, @length, @payload]
+			end
+			
+			def control?
+				@opcode & 0x8
+			end
+			
+			def continued?
+				@fin == false
+			end
+			
+			# The generic frame header uses the following binary representation:
+			#
+			#  0                   1                   2                   3
+			#  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+			# +-+-+-+-+-------+-+-------------+-------------------------------+
+			# |F|R|R|R| opcode|M| Payload len |    Extended payload length    |
+			# |I|S|S|S|  (4)  |A|     (7)     |             (16/64)           |
+			# |N|V|V|V|       |S|             |   (if payload len==126/127)   |
+			# | |1|2|3|       |K|             |                               |
+			# +-+-+-+-+-------+-+-------------+ - - - - - - - - - - - - - - - +
+			# |     Extended payload length continued, if payload len == 127  |
+			# + - - - - - - - - - - - - - - - +-------------------------------+
+			# |                               |Masking-key, if MASK set to 1  |
+			# +-------------------------------+-------------------------------+
+			# | Masking-key (continued)       |          Payload Data         |
+			# +-------------------------------- - - - - - - - - - - - - - - - +
+			# :                     Payload Data continued ...                :
+			# + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
+			# |                     Payload Data continued ...                |
+			# +---------------------------------------------------------------+
+			
+			attr_accessor :fin
+			attr_accessor :opcode
+			attr_accessor :mask
+			attr_accessor :length
+			attr_accessor :payload
+			
+			def unpack
+				@payload
+			end
+			
+			def pack(payload)
+				@payload = payload
+				@length = payload.bytesize
+				
+				if @length.bit_length > 64
+					raise ProtocolError, "Frame length #{@length} bigger than allowed 64-bit field!"
+				end
+			end
+			
+			def read(stream)
+				buffer = stream.read(2) or raise EOFError
+				first, second = buffer.unpack("CC")
+				
+				@fin = (first & 0b1000_0000 != 0)
+				# rsv = byte & 0b0111_0000
+				@opcode = first & 0b0000_1111
+				
+				@mask = (second & 0b1000_0000 != 0)
+				@length = second & 0b0111_1111
+				
+				if @length == 126
+					buffer = stream.read(2) or raise EOFError
+					@length = buffer.unpack('n').first
+				elsif @length == 127
+					buffer = stream.read(4) or raise EOFError
+					@length = buffer.unpack('Q>').first
+				end
+				
+				if @mask
+					@mask = stream.read(4) or raise EOFError
+					@payload = read_mask(@mask, @length, stream)
+				else
+					@mask = nil
+					@payload = stream.read(@length) or raise EOFError
+				end
+				
+				if @payload&.bytesize != @length
+					raise ProtocolError, "Invalid payload size: #{@length} != #{@payload.bytesize}!"
+				end
+				
+				return true
+			end
+			
+			def write(stream)
+				buffer = String.new.b
+				
+				if @payload&.bytesize != @length
+					raise ProtocolError, "Invalid payload size: #{@length} != #{@payload.bytesize}!"
+				end
+				
+				if @mask and @mask.bytesize != 4
+					raise ProtocolError, "Invalid mask length!"
+				end
+				
+				if length <= 125
+					short_length = length
+				elsif length.bit_length <= 16
+					short_length = 126
+				else
+					short_length = 127
+				end
+				
+				buffer << [
+					(@fin ? 0b1000_0000 : 0) | @opcode,
+					(@mask ? 0b1000_0000 : 0) | short_length,
+				].pack('CC')
+				
+				if short_length == 126
+					buffer << [@length].pack('n')
+				elsif short_length == 127
+					buffer << [@length].pack('Q>')
+				end
+				
+				if @mask
+					buffer << @mask
+					write_mask(@mask, @payload, buffer)
+					stream.write(buffer)
+				else
+					stream.write(buffer)
+					stream.write(@payload)
+				end
+			end
+			
+			private
+			
+			def read_mask(mask, length, stream)
+				data = stream.read(length) or raise EOFError
+				
+				for i in 0...data.bytesize do
+					data.setbyte(i, data.getbyte(i) ^ mask.getbyte(i % 4))
+				end
+				
+				return data
+			end
+			
+			def write_mask(mask, data, buffer)
+				for i in 0...data.bytesize do
+					buffer << (data.getbyte(i) ^ mask.getbyte(i % 4))
+				end
+			end
+		end
+	end
+end

data/lib/protocol/websocket/framer.rb

@@ -0,0 +1,54 @@
+# 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.
+
+require_relative 'frame'
+
+module Protocol
+	module WebSocket
+		class Framer
+			def initialize(stream)
+				@stream = stream
+			end
+			
+			def close
+				@stream.close
+			end
+			
+			def flush
+				@stream.flush
+			end
+			
+			def read_frame
+				Frame.read(@stream)
+			end
+			
+			def read_message
+				
+			end
+			
+			def write_message(opcode, payload)
+			end
+			
+			def write_frame(frame)
+				frame.write(@stream)
+			end
+		end
+	end
+end

data/lib/protocol/websocket/version.rb

@@ -0,0 +1,25 @@
+# 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 Protocol
+	module WebSocket
+		VERSION = "0.1.0"
+	end
+end

data/protocol-websocket.gemspec

@@ -0,0 +1,27 @@
+
+require_relative "lib/protocol/websocket/version"
+
+Gem::Specification.new do |spec|
+	spec.name          = "protocol-websocket"
+	spec.version       = Protocol::WebSocket::VERSION
+	spec.authors       = ["Samuel Williams"]
+	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
+	
+	spec.summary       = "A low level implementation of the WebSocket protocol."
+	spec.homepage      = "https://github.com/socketry/protocol-websocket"
+	spec.license       = "MIT"
+	
+	spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+		`git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+	end
+	
+	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+	spec.require_paths = ["lib"]
+	
+	spec.add_dependency "protocol-http"
+	
+	spec.add_development_dependency "covered"
+	spec.add_development_dependency "bundler"
+	spec.add_development_dependency "rake", "~> 10.0"
+	spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: protocol-websocket
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: protocol-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: covered
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- samuel.williams@oriontransfer.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- lib/protocol/websocket.rb
+- lib/protocol/websocket/digest.rb
+- lib/protocol/websocket/error.rb
+- lib/protocol/websocket/frame.rb
+- lib/protocol/websocket/framer.rb
+- lib/protocol/websocket/version.rb
+- protocol-websocket.gemspec
+homepage: https://github.com/socketry/protocol-websocket
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.2
+signing_key: 
+specification_version: 4
+summary: A low level implementation of the WebSocket protocol.
+test_files: []