websocket 1.0.0

data/lib/websocket/version.rb

@@ -0,0 +1,3 @@
+module WebSocket
+  VERSION = '1.0.0'
+end

data/spec/frame/incoming_03_spec.rb

@@ -0,0 +1,117 @@
+require 'spec_helper'
+
+describe 'Incoming frame draft 03' do
+  let(:version) { 3 }
+  let(:frame) { WebSocket::Frame::Incoming.new(:version => version, :data => encoded_text) }
+  let(:encoded_text) { nil }
+  let(:decoded_text) { nil }
+  let(:frame_type) { nil }
+  let(:error) { nil }
+  subject { frame }
+
+  it_should_behave_like 'valid_incoming_frame'
+
+  context "should properly decode close frame" do
+    let(:encoded_text) { "\x01\x05" + decoded_text }
+    let(:frame_type) { :close }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode ping frame" do
+    let(:encoded_text) { "\x02\x05" + decoded_text }
+    let(:frame_type) { :ping }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode pong frame" do
+    let(:encoded_text) { "\x03\x05" + decoded_text }
+    let(:frame_type) { :pong }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame" do
+    let(:encoded_text) { "\x04\x05" + decoded_text }
+    let(:decoded_text) { "Hello" }
+    let(:frame_type) { :text }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame with continuation" do
+    let(:encoded_text) { "\x84\x03Hel\x00\x02lo" }
+    let(:frame_type)   { :text }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame in between of continuation" do
+    let(:encoded_text) { "\x84\x03Hel\x03\x03abc\x00\x02lo" }
+    let(:frame_type)   { [:pong, :text] }
+    let(:decoded_text) { ["abc", "Hello"] }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should not return unfinished more frame" do
+    let(:encoded_text) { "\x84\x03Hel\x03\x03abc" }
+    let(:frame_type)   { :pong }
+    let(:decoded_text) { "abc" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 256 bytes binary frame" do
+    let(:encoded_text) { "\x05\x7E\x01\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 256 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 64KiB binary frame" do
+    let(:encoded_text) { "\x05\x7F\x00\x00\x00\x00\x00\x01\x00\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 65536 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should wait with incomplete frame" do
+    let(:encoded_text) { "\x04\x06Hello" }
+    let(:decoded_text) { nil }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with invalid opcode" do
+    let(:encoded_text) { "\x09\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unknown_opcode }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with too long frame" do
+    let(:encoded_text) { "\x04\x7F" + "a" * WebSocket::Frame::Handler::Base::MAX_FRAME_SIZE }
+    let(:decoded_text) { nil }
+    let(:error) { :frame_too_long }
+
+    it_should_behave_like('valid_incoming_frame') unless RUBY_PLATFORM == "java"
+  end
+
+  context "should raise error with continuation frame without more frame earlier" do
+    let(:encoded_text) { "\x00\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unexpected_continuation_frame }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+end

data/spec/frame/incoming_04_spec.rb

@@ -0,0 +1,117 @@
+require 'spec_helper'
+
+describe 'Incoming frame draft 04' do
+  let(:version) { 4 }
+  let(:frame) { WebSocket::Frame::Incoming.new(:version => version, :data => encoded_text) }
+  let(:encoded_text) { nil }
+  let(:decoded_text) { nil }
+  let(:frame_type) { nil }
+  let(:error) { nil }
+  subject { frame }
+
+  it_should_behave_like 'valid_incoming_frame'
+
+  context "should properly decode close frame" do
+    let(:encoded_text) { "\x81\x05" + decoded_text }
+    let(:frame_type) { :close }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode ping frame" do
+    let(:encoded_text) { "\x82\x05" + decoded_text }
+    let(:frame_type) { :ping }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode pong frame" do
+    let(:encoded_text) { "\x83\x05" + decoded_text }
+    let(:frame_type) { :pong }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame" do
+    let(:encoded_text) { "\x84\x05" + decoded_text }
+    let(:decoded_text) { "Hello" }
+    let(:frame_type) { :text }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame with continuation" do
+    let(:encoded_text) { "\x04\x03Hel\x80\x02lo" }
+    let(:frame_type)   { :text }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame in between of continuation" do
+    let(:encoded_text) { "\x04\x03Hel\x83\x03abc\x80\x02lo" }
+    let(:frame_type)   { [:pong, :text] }
+    let(:decoded_text) { ["abc", "Hello"] }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should not return unfinished more frame" do
+    let(:encoded_text) { "\x04\x03Hel\x83\x03abc" }
+    let(:frame_type)   { :pong }
+    let(:decoded_text) { "abc" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 256 bytes binary frame" do
+    let(:encoded_text) { "\x85\x7E\x01\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 256 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 64KiB binary frame" do
+    let(:encoded_text) { "\x85\x7F\x00\x00\x00\x00\x00\x01\x00\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 65536 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should wait with incomplete frame" do
+    let(:encoded_text) { "\x84\x06Hello" }
+    let(:decoded_text) { nil }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with invalid opcode" do
+    let(:encoded_text) { "\x89\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unknown_opcode }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with too long frame" do
+    let(:encoded_text) { "\x84\x7F" + "a" * WebSocket::Frame::Handler::Base::MAX_FRAME_SIZE }
+    let(:decoded_text) { nil }
+    let(:error) { :frame_too_long }
+
+    it_should_behave_like('valid_incoming_frame') unless RUBY_PLATFORM == "java"
+  end
+
+  context "should raise error with continuation frame without more frame earlier" do
+    let(:encoded_text) { "\x80\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unexpected_continuation_frame }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+end

data/spec/frame/incoming_05_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+describe 'Incoming frame draft 05' do
+  let(:version) { 5 }
+  let(:frame) { WebSocket::Frame::Incoming.new(:version => version, :data => encoded_text) }
+  let(:encoded_text) { nil }
+  let(:decoded_text) { nil }
+  let(:frame_type) { nil }
+  let(:error) { nil }
+  subject { frame }
+
+  it_should_behave_like 'valid_incoming_frame'
+
+  context "should properly decode close frame" do
+    let(:encoded_text) { "\x81\x05" + decoded_text }
+    let(:frame_type) { :close }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode ping frame" do
+    let(:encoded_text) { "\x82\x05" + decoded_text }
+    let(:frame_type) { :ping }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode pong frame" do
+    let(:encoded_text) { "\x83\x05" + decoded_text }
+    let(:frame_type) { :pong }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame" do
+    let(:encoded_text) { "\x84\x05" + decoded_text }
+    let(:decoded_text) { "Hello" }
+    let(:frame_type) { :text }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode masked text frame" do
+    let(:encoded_text) { "\x84\x85\x37\xfa\x21\x3d\x7f\x9f\x4d\x51\x58" }
+    let(:decoded_text) { "Hello" }
+    let(:frame_type) { :text }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame with continuation" do
+    let(:encoded_text) { "\x04\x03Hel\x80\x02lo" }
+    let(:frame_type)   { :text }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode masked text frame with continuation" do
+    let(:encoded_text) { "\x04\x83\x37\xfa\x21\x3d\x7f\x9f\x4d\x80\x82\x37\xfa\x21\x3d\x5b\x95" }
+    let(:frame_type)   { :text }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame in between of continuation" do
+    let(:encoded_text) { "\x04\x03Hel\x83\x03abc\x80\x02lo" }
+    let(:frame_type)   { [:pong, :text] }
+    let(:decoded_text) { ["abc", "Hello"] }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should not return unfinished more frame" do
+    let(:encoded_text) { "\x04\x03Hel\x83\x03abc" }
+    let(:frame_type)   { :pong }
+    let(:decoded_text) { "abc" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 256 bytes binary frame" do
+    let(:encoded_text) { "\x85\x7E\x01\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 256 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 64KiB binary frame" do
+    let(:encoded_text) { "\x85\x7F\x00\x00\x00\x00\x00\x01\x00\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 65536 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should wait with incomplete frame" do
+    let(:encoded_text) { "\x84\x06Hello" }
+    let(:decoded_text) { nil }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with invalid opcode" do
+    let(:encoded_text) { "\x89\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unknown_opcode }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with too long frame" do
+    let(:encoded_text) { "\x84\x7F" + "a" * WebSocket::Frame::Handler::Base::MAX_FRAME_SIZE }
+    let(:decoded_text) { nil }
+    let(:error) { :frame_too_long }
+
+    it_should_behave_like('valid_incoming_frame') unless RUBY_PLATFORM == "java"
+  end
+
+  context "should raise error with continuation frame without more frame earlier" do
+    let(:encoded_text) { "\x80\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unexpected_continuation_frame }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+end

data/spec/frame/incoming_07_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+describe 'Incoming frame draft 07' do
+  let(:version) { 7 }
+  let(:frame) { WebSocket::Frame::Incoming.new(:version => version, :data => encoded_text) }
+  let(:encoded_text) { nil }
+  let(:decoded_text) { nil }
+  let(:frame_type) { nil }
+  let(:error) { nil }
+  subject { frame }
+
+  it_should_behave_like 'valid_incoming_frame'
+
+  context "should properly decode close frame" do
+    let(:encoded_text) { "\x88\x05" + decoded_text }
+    let(:frame_type) { :close }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode ping frame" do
+    let(:encoded_text) { "\x89\x05" + decoded_text }
+    let(:frame_type) { :ping }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode pong frame" do
+    let(:encoded_text) { "\x8a\x05" + decoded_text }
+    let(:frame_type) { :pong }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame" do
+    let(:encoded_text) { "\x81\x05\x48\x65\x6c\x6c\x6f" }
+    let(:decoded_text) { "Hello" }
+    let(:frame_type) { :text }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode masked text frame" do
+    let(:encoded_text) { "\x81\x85\x37\xfa\x21\x3d\x7f\x9f\x4d\x51\x58" }
+    let(:decoded_text) { "Hello" }
+    let(:frame_type) { :text }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame with continuation" do
+    let(:encoded_text) { "\x01\x03Hel\x80\x02lo" }
+    let(:frame_type)   { :text }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode masked text frame with continuation" do
+    let(:encoded_text) { "\x01\x83\x37\xfa\x21\x3d\x7f\x9f\x4d\x80\x82\x37\xfa\x21\x3d\x5b\x95" }
+    let(:frame_type)   { :text }
+    let(:decoded_text) { "Hello" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode text frame in between of continuation" do
+    let(:encoded_text) { "\x01\x03Hel\x8a\x03abc\x80\x02lo" }
+    let(:frame_type)   { [:pong, :text] }
+    let(:decoded_text) { ["abc", "Hello"] }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should not return unfinished more frame" do
+    let(:encoded_text) { "\x01\x03Hel\x8a\x03abc" }
+    let(:frame_type)   { :pong }
+    let(:decoded_text) { "abc" }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 256 bytes binary frame" do
+    let(:encoded_text) { "\x82\x7E\x01\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 256 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should properly decode 64KiB binary frame" do
+    let(:encoded_text) { "\x82\x7F\x00\x00\x00\x00\x00\x01\x00\x00" + decoded_text }
+    let(:frame_type) { :binary }
+    let(:decoded_text) { "a" * 65536 }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should wait with incomplete frame" do
+    let(:encoded_text) { "\x81\x06Hello" }
+    let(:decoded_text) { nil }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with invalid opcode" do
+    let(:encoded_text) { "\x85\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unknown_opcode }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+  context "should raise error with too long frame" do
+    let(:encoded_text) { "\x81\x7F" + "a" * WebSocket::Frame::Handler::Base::MAX_FRAME_SIZE }
+    let(:decoded_text) { nil }
+    let(:error) { :frame_too_long }
+
+    it_should_behave_like('valid_incoming_frame') unless RUBY_PLATFORM == "java"
+  end
+
+  context "should raise error with continuation frame without more frame earlier" do
+    let(:encoded_text) { "\x80\x05Hello" }
+    let(:decoded_text) { nil }
+    let(:error) { :unexpected_continuation_frame }
+
+    it_should_behave_like 'valid_incoming_frame'
+  end
+
+end