RubyGems - sprsquish-blather - Versions diffs - 0.1 → 0.2.3 - Mend

sprsquish-blather 0.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (73) hide show

data/LICENSE +2 -0
data/README.rdoc +100 -0
data/Rakefile +110 -0
data/examples/drb_client.rb +5 -0
data/examples/echo.rb +18 -0
data/ext/extconf.rb +65 -0
data/ext/push_parser.c +231 -0
data/lib/blather/client.rb +219 -44
data/lib/blather/{core/sugar.rb → core_ext/active_support.rb} +25 -13
data/lib/blather/core_ext/libxml.rb +28 -0
data/lib/blather/errors/sasl_error.rb +87 -0
data/lib/blather/errors/stanza_error.rb +262 -0
data/lib/blather/errors/stream_error.rb +253 -0
data/lib/blather/errors.rb +48 -0
data/lib/blather/{core/jid.rb → jid.rb} +15 -26
data/lib/blather/{core/roster.rb → roster.rb} +22 -0
data/lib/blather/{core/roster_item.rb → roster_item.rb} +39 -8
data/lib/blather/stanza/iq/disco.rb +11 -0
data/lib/blather/stanza/iq/discos/disco_info.rb +86 -0
data/lib/blather/stanza/iq/discos/disco_items.rb +61 -0
data/lib/blather/stanza/iq/query.rb +51 -0
data/lib/blather/stanza/iq/roster.rb +90 -0
data/lib/blather/stanza/iq.rb +38 -0
data/lib/blather/stanza/message.rb +58 -0
data/lib/blather/stanza/presence/status.rb +78 -0
data/lib/blather/stanza/presence/subscription.rb +72 -0
data/lib/blather/stanza/presence.rb +45 -0
data/lib/blather/stanza.rb +101 -0
data/lib/blather/stream/client.rb +26 -0
data/lib/blather/stream/component.rb +34 -0
data/lib/blather/stream/parser.rb +70 -0
data/lib/blather/stream/resource.rb +48 -0
data/lib/blather/stream/sasl.rb +173 -0
data/lib/blather/stream/session.rb +36 -0
data/lib/blather/stream/stream_handler.rb +39 -0
data/lib/blather/stream/tls.rb +33 -0
data/lib/blather/stream.rb +249 -0
data/lib/blather/xmpp_node.rb +199 -0
data/lib/blather.rb +40 -41
data/spec/blather/core_ext/libxml_spec.rb +58 -0
data/spec/blather/errors/sasl_error_spec.rb +56 -0
data/spec/blather/errors/stanza_error_spec.rb +148 -0
data/spec/blather/errors/stream_error_spec.rb +114 -0
data/spec/blather/errors_spec.rb +40 -0
data/spec/blather/{core/jid_spec.rb → jid_spec.rb} +9 -1
data/spec/blather/{core/roster_item_spec.rb → roster_item_spec.rb} +6 -1
data/spec/blather/{core/roster_spec.rb → roster_spec.rb} +16 -6
data/spec/blather/stanza/iq/discos/disco_info_spec.rb +207 -0
data/spec/blather/stanza/iq/discos/disco_items_spec.rb +136 -0
data/spec/blather/stanza/iq/query_spec.rb +34 -0
data/spec/blather/stanza/iq/roster_spec.rb +123 -0
data/spec/blather/stanza/iq_spec.rb +40 -0
data/spec/blather/stanza/message_spec.rb +52 -0
data/spec/blather/stanza/presence/status_spec.rb +102 -0
data/spec/blather/stanza/presence/subscription_spec.rb +85 -0
data/spec/blather/stanza/presence_spec.rb +53 -0
data/spec/blather/{core/stanza_spec.rb → stanza_spec.rb} +14 -2
data/spec/blather/stream/client_spec.rb +787 -0
data/spec/blather/stream/component_spec.rb +86 -0
data/spec/blather/{core/xmpp_node_spec.rb → xmpp_node_spec.rb} +76 -23
data/spec/build_safe.rb +20 -0
data/spec/spec_helper.rb +7 -17
metadata +79 -59
data/CHANGELOG +0 -1
data/blather.gemspec +0 -73
data/lib/blather/callback.rb +0 -24
data/lib/blather/core/errors.rb +0 -24
data/lib/blather/core/stanza.rb +0 -90
data/lib/blather/core/stream.rb +0 -179
data/lib/blather/core/xmpp_node.rb +0 -95
data/lib/blather/extensions/last_activity.rb +0 -57
data/lib/blather/extensions/version.rb +0 -85
data/spec/blather/core/stream_spec.rb +0 -263

data/spec/blather/stream/client_spec.rb ADDED Viewed

@@ -0,0 +1,787 @@
+require File.join(File.dirname(__FILE__), *%w[.. .. spec_helper])
+describe 'Blather::Stream::Client' do
+  class MockServer; end
+  module ServerMock
+    def receive_data(data)
+      @server ||= MockServer.new
+      @server.receive_data data, self
+    end
+  end
+  def mocked_server(times = nil, &block)
+    @client ||= mock()
+    @client.stubs(:stopped) unless @client.respond_to?(:stopped)
+    @client.stubs(:jid=) unless @client.respond_to?(:jid=)
+    MockServer.any_instance.expects(:receive_data).send(*(times ? [:times, times] : [:at_least, 1])).with &block
+    EventMachine::run {
+      # Mocked server
+      EventMachine::start_server '127.0.0.1', 12345, ServerMock
+      # Stream connection
+      EM.connect('127.0.0.1', 12345, Stream::Client, @client, @jid || JID.new('n@d/r'), 'pass') { |c| @stream = c }
+    }
+  end
+  it 'can be started' do
+    client = mock()
+    params = [client, 'n@d/r', 'pass', 'host', 1234]
+    EM.expects(:connect).with do |*parms|
+      parms[0] == 'host'  &&
+      parms[1] == 1234    &&
+      parms[3] == client  &&
+      parms[5] == 'pass'  &&
+      parms[4] == JID.new('n@d/r')
+    end
+    Stream::Client.start *(params)
+  end
+  it 'can figure out the host to use based on the jid' do
+    client = mock()
+    params = [client, 'n@d/r', 'pass', 'd', 5222]
+    EM.expects(:connect).with do |*parms|
+      parms[0] == 'd'     &&
+      parms[1] == 5222    &&
+      parms[3] == client  &&
+      parms[5] == 'pass'  &&
+      parms[4] == JID.new('n@d/r')
+    end
+    Stream::Client.start client, 'n@d/r', 'pass'
+  end
+  it 'starts the stream once the connection is complete' do
+    mocked_server(1) { |val, _| EM.stop; val.must_match(/stream:stream/) }
+  end
+  it 'sends stanzas to the client when the stream is ready' do
+    @client = mock()
+    @client.expects(:call).with do |n|
+      EM.stop
+      n.kind_of?(Stanza::Message) && @stream.ready?.must_equal(true)
+    end
+    mocked_server(1) do |val, server|
+      val.must_match(/stream:stream/)
+      server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+      server.send_data "<message to='a@b/c' from='d@e/f' type='chat' xml:lang='en'><body>Message!</body></message>"
+    end
+  end
+  it 'puts itself in the stopped state and calls @client.stopped when stopped' do
+    @client = mock()
+    @client.expects(:stopped).at_least_once
+    started = false
+    mocked_server(2) do |val, server|
+      if !started
+        started = true
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      else
+        EM.stop
+        @stream.stopped?.must_equal false
+        @stream.unbind
+        @stream.stopped?.must_equal true
+      end
+    end
+  end
+  it 'will be in the negotiating state during feature negotiations' do
+    state = nil
+    @client = mock()
+    @client.stubs(:stream_started)
+    @client.expects(:call).with do |n|
+      EM.stop
+      state.must_equal(:negotiated) && @stream.negotiating?.must_equal(false)
+    end
+    mocked_server(2) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+        server.send_data "<stream:features><session xmlns='urn:ietf:params:xml:ns:xmpp-session' /></stream:features>"
+        true
+      when :started
+        state = :negotiated
+        @stream.negotiating?.must_equal(true)
+        server.send_data "<iq from='d' type='result' id='#{val[/id="([^"]+)"/,1]}' />"
+        server.send_data "<message to='a@b/c' from='d@e/f' type='chat' xml:lang='en'><body>Message!</body></message>"
+        true
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'stops when sent </stream:stream>' do
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0' xml:lang='en'>"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :stopped
+        server.send_data '</stream:stream>'
+        @stream.stopped?.must_equal false
+      when :stopped
+        EM.stop
+        @stream.stopped?.must_equal true
+        val.must_equal '</stream:stream>'
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'sends client an error on stream:error' do
+    @client = mock()
+    @client.expects(:call).with do |v|
+      v.must_be_instance_of(StreamError::Conflict)
+      v.text.must_equal 'Already signed in'
+      v.to_s.must_equal "Stream Error (conflict): #{v.text}"
+    end
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0'>"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :stopped
+        server.send_data "<stream:error><conflict xmlns='urn:ietf:params:xml:ns:xmpp-streams' />"
+        server.send_data "<text xmlns='urn:ietf:params:xml:ns:xmpp-streams'>Already signed in</text></stream:error>"
+      when :stopped
+        EM.stop
+        val.must_equal "</stream:stream>"
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'starts TLS when asked' do
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :tls
+        @stream.expects(:start_tls)
+        server.send_data "<proceed xmlns='urn:ietf:params:xml:ns:xmpp-tls'/>"
+        val.must_match(/starttls/)
+      when :tls
+        EM.stop
+        true
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will fail if TLS negotiation fails' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with { |v| v.must_be_kind_of TLSFailure }
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :tls
+        @stream.expects(:start_tls).never
+        server.send_data "<failure xmlns='urn:ietf:params:xml:ns:xmpp-tls'/></stream:stream>"
+        val.must_match(/starttls/)
+      when :tls
+        EM.stop
+        val.must_equal "</stream:stream>"
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will fail if a bad node comes through TLS negotiations' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with do |v|
+      v.must_be_kind_of UnknownResponse
+      v.node.element_name.must_equal 'foo-bar'
+    end
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><starttls xmlns='urn:ietf:params:xml:ns:xmpp-tls' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :tls
+        @stream.expects(:start_tls).never
+        server.send_data "<foo-bar xmlns='urn:ietf:params:xml:ns:xmpp-tls'/></stream:stream>"
+        val.must_match(/starttls/)
+      when :tls
+        EM.stop
+        val.must_equal "</stream:stream>"
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'connects via SASL MD5 when asked' do
+    Time.any_instance.stubs(:to_f).returns(1.1)
+    state = nil
+    mocked_server(5) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>DIGEST-MD5</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :auth_sent
+        server.send_data "<challenge xmlns='urn:ietf:params:xml:ns:xmpp-sasl'>cmVhbG09InNvbWVyZWFsbSIsbm9uY2U9Ik9BNk1HOXRFUUdtMmhoIixxb3A9ImF1dGgiLGNoYXJzZXQ9dXRmLTgsYWxnb3JpdGhtPW1kNS1zZXNzCg==</challenge>"
+        val.must_match(/auth.*DIGEST\-MD5/)
+      when :auth_sent
+        state = :response1_sent
+        server.send_data "<challenge xmlns='urn:ietf:params:xml:ns:xmpp-sasl'>cnNwYXV0aD1lYTQwZjYwMzM1YzQyN2I1NTI3Yjg0ZGJhYmNkZmZmZAo=</challenge>"
+        val.must_equal('<response xmlns="urn:ietf:params:xml:ns:xmpp-sasl">bm9uY2U9Ik9BNk1HOXRFUUdtMmhoIixjaGFyc2V0PXV0Zi04LHVzZXJuYW1lPSJuIixyZWFsbT0ic29tZXJlYWxtIixjbm9uY2U9Ijc3N2Q0NWJiYmNkZjUwZDQ5YzQyYzcwYWQ3YWNmNWZlIixuYz0wMDAwMDAwMSxxb3A9YXV0aCxkaWdlc3QtdXJpPSJ4bXBwL2QiLHJlc3BvbnNlPTZiNTlhY2Q1ZWJmZjhjZTA0NTYzMGFiMDU2Zjg3MTdm</response>')
+      when :response1_sent
+        state = :response2_sent
+        server.send_data "<success xmlns='urn:ietf:params:xml:ns:xmpp-sasl' />"
+        val.must_match(%r{<response xmlns="urn:ietf:params:xml:ns:xmpp-sasl"\s?/>})
+      when :response2_sent
+        EM.stop
+        state = :complete
+        val.must_match(/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will connect via SSL PLAIN when asked' do
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>PLAIN</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :auth_sent
+        server.send_data "<success xmlns='urn:ietf:params:xml:ns:xmpp-sasl' />"
+        val.must_equal('<auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="PLAIN">bkBkAG4AcGFzcw==</auth>')
+      when :auth_sent
+        EM.stop
+        state = :complete
+        val.must_match(/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will connect via SSL ANONYMOUS when asked' do
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>ANONYMOUS</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :auth_sent
+        server.send_data "<success xmlns='urn:ietf:params:xml:ns:xmpp-sasl' />"
+        val.must_equal('<auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="ANONYMOUS">bg==</auth>')
+      when :auth_sent
+        EM.stop
+        state = :complete
+        val.must_match(/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'tried each possible mechanism until it fails completely' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with do |n|
+      n.must_be_kind_of(SASLError)
+      n.must_be_instance_of SASLError::NotAuthorized
+    end
+    mocked_server(5) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>DIGEST-MD5</mechanism><mechanism>PLAIN</mechanism><mechanism>ANONYMOUS</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :failed_md5
+        server.send_data "<failure xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><not-authorized /></failure>"
+        val.must_match(/mechanism="DIGEST-MD5"/)
+      when :failed_md5
+        state = :failed_plain
+        server.send_data "<failure xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><not-authorized /></failure>"
+        val.must_match(/mechanism="PLAIN"/)
+      when :failed_plain
+        state = :failed_anon
+        server.send_data "<failure xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><not-authorized /></failure>"
+        val.must_match(/mechanism="ANONYMOUS"/)
+      when :failed_anon
+        EM.stop
+        state = :complete
+        val.must_match(/\/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'tries each mechanism until it succeeds' do
+    state = nil
+    mocked_server(4) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>DIGEST-MD5</mechanism><mechanism>PLAIN</mechanism><mechanism>ANONYMOUS</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :failed_md5
+        server.send_data "<failure xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><not-authorized /></failure>"
+        val.must_match(/mechanism="DIGEST-MD5"/)
+      when :failed_md5
+        state = :plain_sent
+        server.send_data "<success xmlns='urn:ietf:params:xml:ns:xmpp-sasl' />"
+        val.must_match(/mechanism="PLAIN"/)
+      when :plain_sent
+        EM.stop
+        val.must_match(/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'sends client an error when an unknown mechanism is sent' do
+    @client = mock()
+    @client.expects(:call).with { |v| v.must_be_kind_of(Stream::SASL::UnknownMechanism) }
+    started = false
+    mocked_server(2) do |val, server|
+      if !started
+        started = true
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+        server.send_data "<stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>UNKNOWN</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      else
+        EM.stop
+        val.must_match(/failure(.*)invalid\-mechanism/)
+      end
+    end
+  end
+  %w[ aborted
+      incorrect-encoding
+      invalid-authzid
+      invalid-mechanism
+      mechanism-too-weak
+      not-authorized
+      temporary-auth-failure
+  ].each do |error_type|
+    it "fails on #{error_type}" do
+      @client = mock()
+      @client.expects(:call).with do |n|
+        n.must_be_instance_of SASLError.class_from_registration(error_type)
+      end
+      state = nil
+      mocked_server(3) do |val, server|
+        case state
+        when nil
+          state = :started
+          server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>PLAIN</mechanism></mechanisms></stream:features>"
+          val.must_match(/stream:stream/)
+        when :started
+          state = :auth_sent
+          server.send_data "<failure xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><#{error_type} /></failure>"
+          val.must_equal('<auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="PLAIN">bkBkAG4AcGFzcw==</auth>')
+        when :auth_sent
+          EM.stop
+          state = :complete
+          val.must_match(/\/stream:stream/)
+        else
+          EM.stop
+          false
+        end
+      end
+    end
+  end
+  it 'fails when an unkown node comes through during SASL negotiation' do
+    @client = mock()
+    @client.expects(:call).with do |n|
+      n.must_be_instance_of UnknownResponse
+      n.node.element_name.must_equal 'foo-bar'
+    end
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><mechanisms xmlns='urn:ietf:params:xml:ns:xmpp-sasl'><mechanism>PLAIN</mechanism></mechanisms></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :auth_sent
+        server.send_data "<foo-bar />"
+        val.must_equal('<auth xmlns="urn:ietf:params:xml:ns:xmpp-sasl" mechanism="PLAIN">bkBkAG4AcGFzcw==</auth>')
+      when :auth_sent
+        EM.stop
+        state = :complete
+        val.must_match(/\/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will bind to a resource set by the server' do
+    state = nil
+    class Client; attr_accessor :jid; end
+    @client = Client.new
+    @jid = JID.new('n@d')
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :complete
+        val =~ %r{<iq[^>]+id="([^"]+)"}
+        server.send_data "<iq type='result' id='#{$1}'><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind'><jid>#{@jid}/server_resource</jid></bind></iq>"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(%r{<bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"\s?/>})
+      when :complete
+        EM.stop
+        @client.jid.must_equal JID.new('n@d/server_resource')
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will bind to a resource set by the client' do
+    state = nil
+    class Client; attr_accessor :jid; end
+    @client = Client.new
+    @jid = JID.new('n@d/r')
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :complete
+        val =~ %r{<iq[^>]+id="([^"]+)"}
+        server.send_data "<iq type='result' id='#{$1}'><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind'><jid>#{@jid}</jid></bind></iq>"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(%r{<bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"><resource>r</resource></bind>})
+      when :complete
+        EM.stop
+        @client.jid.must_equal JID.new('n@d/r')
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will return an error if resource binding errors out' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with do |n|
+      n.must_be_instance_of StanzaError::BadRequest
+    end
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :complete
+        val =~ %r{<iq[^>]+id="([^"]+)"}
+        server.send_data "<iq type='error' id='#{$1}'><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind'><resource>r</resource></bind><error type='modify'><bad-request xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/></error></iq>"
+        val.must_match(%r{<bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"><resource>r</resource></bind>})
+      when :complete
+        EM.stop
+        val.must_match(/\/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will return an error if an unkown node comes through during resouce binding' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with do |n|
+      n.must_be_instance_of UnknownResponse
+      n.node.element_name.must_equal 'foo-bar'
+    end
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'><stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :complete
+        val =~ %r{<iq[^>]+id="([^"]+)"}
+        server.send_data "<foo-bar />"
+        val.must_match(%r{<bind xmlns="urn:ietf:params:xml:ns:xmpp-bind"><resource>r</resource></bind>})
+      when :complete
+        EM.stop
+        val.must_match(/\/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will establish a session if requested' do
+    state = nil
+    @client = mock()
+    @client.expects(:stream_started)
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+        server.send_data "<stream:features><session xmlns='urn:ietf:params:xml:ns:xmpp-session' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :completed
+        server.send_data "<iq from='d' type='result' id='#{val[/id="([^"]+)"/,1]}' />"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(%r{<iq id="[^"]+" type="set" to="d"><session xmlns="urn:ietf:params:xml:ns:xmpp-session"\s?/></iq>})
+      when :completed
+        EM.stop
+        true
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will return an error if session establishment errors out' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with do |n|
+      n.must_be_instance_of StanzaError::InternalServerError
+    end
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+        server.send_data "<stream:features><session xmlns='urn:ietf:params:xml:ns:xmpp-session' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :completed
+        server.send_data "<iq from='d' type='error' id='#{val[/id="([^"]+)"/,1]}'><session xmlns='urn:ietf:params:xml:ns:xmpp-session'/><error type='wait'><internal-server-error xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/></error></iq>"
+        val.must_match(%r{<iq id="[^"]+" type="set" to="d"><session xmlns="urn:ietf:params:xml:ns:xmpp-session"\s?/></iq>})
+      when :completed
+        EM.stop
+        val.must_match(/\/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'will return an error if an unknown node come through during session establishment' do
+    state = nil
+    @client = mock()
+    @client.expects(:call).with do |n|
+      n.must_be_instance_of UnknownResponse
+      n.node.element_name.must_equal 'foo-bar'
+    end
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams'>"
+        server.send_data "<stream:features><session xmlns='urn:ietf:params:xml:ns:xmpp-session' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :completed
+        server.send_data '<foo-bar />'
+        val.must_match(%r{<iq id="[^"]+" type="set" to="d"><session xmlns="urn:ietf:params:xml:ns:xmpp-session"\s?/></iq>})
+      when :completed
+        EM.stop
+        val.must_match(/\/stream:stream/)
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+  it 'sends client an error on parse error' do
+    @client = mock()
+    @client.expects(:call).with do |v|
+      v.must_be_kind_of ParseError
+      v.message.must_match(/generate\-parse\-error/)
+    end
+    state = nil
+    mocked_server(3) do |val, server|
+      case state
+      when nil
+        state = :started
+        server.send_data "<?xml version='1.0'?><stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' version='1.0'>"
+        server.send_data "<stream:features><bind xmlns='urn:ietf:params:xml:ns:xmpp-bind' /></stream:features>"
+        val.must_match(/stream:stream/)
+      when :started
+        state = :parse_error
+        server.send_data "</generate-parse-error>"
+      when :parse_error
+        EM.stop
+        val.must_equal "</stream:stream>"
+      else
+        EM.stop
+        false
+      end
+    end
+  end
+end