rtsp 0.0.1.alpha → 0.1.0

data/spec/rtsp/response_spec.rb

@@ -1,62 +1,77 @@
-require File.dirname(__FILE__) + '/../spec_helper'
+require_relative '../spec_helper'
 require 'rtsp/response'
 
-OPTIONS_RESPONSE = %Q{ RTSP/1.0 200 OK\r\n
-CSeq: 1\r\n
-Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
-Public: OPTIONS, DESCRIBE, SETUP, TEARDOWN, PLAY, PAUSE\r\n
-}
+describe RTSP::Response do
+  describe "#initialize" do
+    it "expects a non-nil string on" do
+      lambda { RTSP::Response.new(nil) }.should raise_exception RTSP::Error
+    end
 
-DESCRIBE_RESPONSE = %Q{ RTSP/1.0 200 OK\r\n
-Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )\r\n
-Cseq: 1\r\n
-Cache-Control: no-cache\r\n
-Content-length: 406\r\n
-Date: Sun, 23 Jan 2011 00:36:45 GMT\r\n
-Expires: Sun, 23 Jan 2011 00:36:45 GMT\r\n
-Content-Type: application/sdp\r\n
-x-Accept-Retransmit: our-retransmit\r\n
-x-Accept-Dynamic-Rate: 1\r\n
-Content-Base: rtsp://64.202.98.91:554/gs.sdp/\r\n
-\r\n\r\n
-v=0
-o=- 545877020 467920391 IN IP4 127.0.0.1
-s=Groove Salad from SomaFM [aacPlus]
-i=Downtempo Ambient Groove
-c=IN IP4 0.0.0.0
-t=0 0
-a=x-qt-text-cmt:Orban Opticodec-PC
-a=x-qt-text-nam:Groove Salad from SomaFM [aacPlus]
-a=x-qt-text-inf:Downtempo Ambient Groove
-a=control:*
-m=audio 0 RTP/AVP 96
-b=AS:48
-a=rtpmap:96 MP4A-LATM/44100/2
-a=fmtp:96 cpresent=0;config=400027200000
-a=control:trackID=1
-}
+    it "expects a non-empty string on" do
+      lambda { RTSP::Response.new("") }.should raise_exception RTSP::Error
+    end
+  end
 
-SETUP_RESPONSE = %Q{ RTSP/1.0 200 OK\r\n
-CSeq: 1\r\n
-Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
-Transport: RTP/AVP;unicast;destination=10.221.222.186;source=10.221.222.235;client_port=9000-9001;server_port=6700-6701\r\n
-Session: 118\r\n
-}
+  describe "#parse_head" do
+    it "raises when RTSP version is corrupted" do
+      response = RTSP::Response.new OPTIONS_RESPONSE
+      lambda { response.parse_head "RTSP/ 200 OK\r\n" }.should raise_error RTSP::Error
+    end
 
-PLAY_RESPONSE = %Q{ RTSP/1.0 200 OK\r\n
-CSeq: 1\r\n
-Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
-Range: npt=0.000-\r\n
-Session: 118\r\n
-RTP-Info: url=rtsp://10.221.222.235/stream1/track1;seq=17320;rtptime=400880602\r\n
-}
+    it "raises when the response code is corrupted" do
+      response = RTSP::Response.new OPTIONS_RESPONSE
+      lambda { response.parse_head "RTSP/1.0 2 OK\r\n" }.should raise_error RTSP::Error
+    end
 
-TEARDOWN_RESPONSE = %Q{ RTSP/1.0 200 OK\r\n
-CSeq: 1\r\n
-Date: Fri, Jan 28 2011 01:14:47 GMT\r\n
-}
+    it "raises when the response message is corrupted" do
+      response = RTSP::Response.new OPTIONS_RESPONSE
+      lambda { response.parse_head "RTSP/1.0 200 \r\n" }.should raise_error RTSP::Error
+    end
+  end
+
+  describe "#parse_body" do
+    it "returns an SDP::Description when @content_type is 'application/sdp" do
+      response = RTSP::Response.new DESCRIBE_RESPONSE
+      sdp = SDP::Description.new
+      sdp.username = "me"
+      sdp.id = 12345
+      sdp.version = 12345
+      sdp.network_type = "IN"
+      sdp.address_type = "IP4"
+      body = response.parse_body sdp.to_s
+      body.class.should == SDP::Description
+    end
+
+    it "returns the text that was passed to it but with line feeds removed" do
+      response = RTSP::Response.new OPTIONS_RESPONSE
+      string = "hi\r\nguys\r\n\r\n"
+      body = response.parse_body string
+      body.class.should == String
+      body.should == string
+    end
+  end
+
+  describe "#to_s" do
+    it "returns the text that was passed in" do
+      response = RTSP::Response.new OPTIONS_RESPONSE
+      response.to_s.should == OPTIONS_RESPONSE
+    end
+  end
+
+  describe "#inspect" do
+    before do
+      @response = RTSP::Response.new OPTIONS_RESPONSE
+    end
+
+    it "contains the class name and object ID first" do
+      @response.inspect.should match /^#<RTSP::Response:\d+/
+    end
+
+    it "begins with <# and ends with >" do
+      @response.inspect.should match /^#<.*>$/
+    end
+  end
 
-describe RTSP::Response do
   context "options" do
     before do
       @response = RTSP::Response.new OPTIONS_RESPONSE
@@ -94,14 +109,14 @@ describe RTSP::Response do
 
     it "returns all header fields" do
       @response.server.should == "DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )"
-      @response.cseq.should == "1"
+      @response.cseq.should == 1
       @response.cache_control.should == "no-cache"
-      @response.content_length.should == "406"
+      @response.content_length.should == 406
       @response.date.should == "Sun, 23 Jan 2011 00:36:45 GMT"
       @response.expires.should == "Sun, 23 Jan 2011 00:36:45 GMT"
       @response.content_type.should == "application/sdp"
       @response.x_accept_retransmit.should == "our-retransmit"
-      @response.x_accept_dynamic_rate.should == "1"
+      @response.x_accept_dynamic_rate.should == 1
       @response.content_base.should == "rtsp://64.202.98.91:554/gs.sdp/"
     end
 
@@ -135,7 +150,7 @@ describe RTSP::Response do
     end
 
     it "returns the session" do
-      @response.session.should == '118'
+      @response.session.should == 118
     end
   end
 
@@ -161,7 +176,7 @@ describe RTSP::Response do
     end
 
     it "returns the session" do
-      @response.session.should == '118'
+      @response.session.should == 118
     end
 
     it "returns the rtp_info" do
@@ -186,4 +201,75 @@ describe RTSP::Response do
       @response.date.should == 'Fri, Jan 28 2011 01:14:47 GMT'
     end
   end
-end
+
+  context "#parse_head" do
+    before do
+      @response = RTSP::Response.new OPTIONS_RESPONSE
+    end
+
+    it "extracts the RTSP version from the header" do
+      @response.rtsp_version.should == "1.0"
+    end
+
+    it "extracts the response code from the header as a Fixnum" do
+      @response.code.is_a?(Fixnum).should be_true
+      @response.code.should == 200
+    end
+
+    it "extracts the response message from the header" do
+      @response.message.should == "OK"
+    end
+
+    it "returns empty value string when header has no value" do
+      response = RTSP::Response.new NO_CSEQ_VALUE_RESPONSE
+      response.parse_head NO_CSEQ_VALUE_RESPONSE
+      response.instance_variable_get(:@cseq).should == ""
+    end
+  end
+
+  describe "#split_head_and_body_from" do
+    it "splits responses with headers and no body" do
+      response = RTSP::Response.new OPTIONS_RESPONSE
+      head_and_body = response.split_head_and_body_from OPTIONS_RESPONSE
+      head_and_body.first.should == %Q{RTSP/1.0 200 OK\r\n
+CSeq: 1\r\n
+Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
+Public: OPTIONS, DESCRIBE, SETUP, TEARDOWN, PLAY, PAUSE\r\n
+}
+    end
+
+    it "splits responses with headers and body" do
+      response = RTSP::Response.new DESCRIBE_RESPONSE
+      head_and_body = response.split_head_and_body_from DESCRIBE_RESPONSE
+      head_and_body.first.should == %{RTSP/1.0 200 OK\r\n
+Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )\r\n
+Cseq: 1\r\n
+Cache-Control: no-cache\r\n
+Content-length: 406\r\n
+Date: Sun, 23 Jan 2011 00:36:45 GMT\r\n
+Expires: Sun, 23 Jan 2011 00:36:45 GMT\r\n
+Content-Type: application/sdp\r\n
+x-Accept-Retransmit: our-retransmit\r\n
+x-Accept-Dynamic-Rate: 1\r\n
+Content-Base: rtsp://64.202.98.91:554/gs.sdp/\r\n
+}
+      head_and_body.last.should == %{
+v=0
+o=- 545877020 467920391 IN IP4 127.0.0.1
+s=Groove Salad from SomaFM [aacPlus]
+i=Downtempo Ambient Groove
+c=IN IP4 0.0.0.0
+t=0 0
+a=x-qt-text-cmt:Orban Opticodec-PC
+a=x-qt-text-nam:Groove Salad from SomaFM [aacPlus]
+a=x-qt-text-inf:Downtempo Ambient Groove
+a=control:*
+m=audio 0 RTP/AVP 96
+b=AS:48
+a=rtpmap:96 MP4A-LATM/44100/2
+a=fmtp:96 cpresent=0;config=400027200000
+a=control:trackID=1
+}
+    end
+  end
+end

data/spec/rtsp/transport_parser_spec.rb

@@ -0,0 +1,54 @@
+require_relative '../spec_helper'
+require 'rtsp/transport_parser'
+
+describe RTSP::TransportParser do
+  before do
+    @parser = RTSP::TransportParser.new
+  end
+
+  describe "a basic Transport header" do
+    before do
+      transport = "RTP/AVP;unicast;client_port=9000-9001"
+      @result = @parser.parse transport
+    end
+
+    it "extracts the protocol" do
+      @result[:streaming_protocol].should == 'RTP'
+    end
+
+    it "extracts the profile" do
+      @result[:profile].should == 'AVP'
+    end
+
+    it "extracts the broadcast type" do
+      @result[:broadcast_type].should == 'unicast'
+    end
+
+    it "extracts the client RTP port" do
+      @result[:client_port][:rtp].should == '9000'
+    end
+
+    it "extracts the client RTCP port" do
+      @result[:client_port][:rtcp].should == '9001'
+    end
+  end
+
+  describe "a TCP binary interleaved Transport header" do
+    before do
+      transport = "RTP/AVP/TCP;unicast;interleaved=0-1"
+      @result = @parser.parse transport
+    end
+
+    it "extracts the lower transport type" do
+      @result[:transport_protocol].should == 'TCP'
+    end
+
+    it "extracts the interleaved RTP channel" do
+      @result[:interleaved][:rtp_channel].should == '0'
+    end
+
+    it "extracts the interleaved RTCP channel" do
+      @result[:interleaved][:rtcp_channel].should == '1'
+    end
+  end
+end

data/spec/rtsp_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/spec_helper.rb'
+require_relative 'spec_helper'
 
 describe Kernel do
   def self.get_requires
@@ -21,7 +21,7 @@ describe RTSP do
     RTSP.const_defined?('VERSION').should be_true
   end
 
-  it "should have a WWW constant" do
-    RTSP.const_defined?('WWW').should be_true
+  it "has version 0.1.0" do
+    RTSP::VERSION.should == '0.1.0'
   end
 end

data/spec/spec_helper.rb

@@ -1,11 +1,70 @@
-begin
-  require 'rspec'
-rescue LoadError
-  require 'rubygems' unless ENV['NO_RUBYGEMS']
-  gem 'rspec'
-  require 'rspec'
+require 'simplecov'
+
+SimpleCov.start do
+  add_filter "/spec/"
 end
 
+require 'rspec'
 $:.unshift(File.dirname(__FILE__) + '/../lib')
 require 'rtsp'
-require 'rspec'
+
+OPTIONS_RESPONSE = %Q{RTSP/1.0 200 OK\r\n
+CSeq: 1\r\n
+Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
+Public: OPTIONS, DESCRIBE, SETUP, TEARDOWN, PLAY, PAUSE\r\n
+}
+
+DESCRIBE_RESPONSE = %{RTSP/1.0 200 OK\r\n
+Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )\r\n
+Cseq: 1\r\n
+Cache-Control: no-cache\r\n
+Content-length: 406\r\n
+Date: Sun, 23 Jan 2011 00:36:45 GMT\r\n
+Expires: Sun, 23 Jan 2011 00:36:45 GMT\r\n
+Content-Type: application/sdp\r\n
+x-Accept-Retransmit: our-retransmit\r\n
+x-Accept-Dynamic-Rate: 1\r\n
+Content-Base: rtsp://64.202.98.91:554/gs.sdp/\r\n
+\r\n\r\n
+v=0
+o=- 545877020 467920391 IN IP4 127.0.0.1
+s=Groove Salad from SomaFM [aacPlus]
+i=Downtempo Ambient Groove
+c=IN IP4 0.0.0.0
+t=0 0
+a=x-qt-text-cmt:Orban Opticodec-PC
+a=x-qt-text-nam:Groove Salad from SomaFM [aacPlus]
+a=x-qt-text-inf:Downtempo Ambient Groove
+a=control:*
+m=audio 0 RTP/AVP 96
+b=AS:48
+a=rtpmap:96 MP4A-LATM/44100/2
+a=fmtp:96 cpresent=0;config=400027200000
+a=control:trackID=1
+}
+
+SETUP_RESPONSE = %Q{RTSP/1.0 200 OK\r\n
+CSeq: 1\r\n
+Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
+Transport: RTP/AVP;unicast;destination=10.221.222.186;source=10.221.222.235;client_port=9000-9001;server_port=6700-6701\r\n
+Session: 118\r\n
+\r\n}
+
+PLAY_RESPONSE = %Q{RTSP/1.0 200 OK\r\n
+CSeq: 1\r\n
+Date: Fri, Jan 28 2011 01:14:42 GMT\r\n
+Range: npt=0.000-\r\n
+Session: 118\r\n
+RTP-Info: url=rtsp://10.221.222.235/stream1/track1;seq=17320;rtptime=400880602\r\n
+\r\n}
+
+TEARDOWN_RESPONSE = %Q{RTSP/1.0 200 OK\r\n
+CSeq: 1\r\n
+Date: Fri, Jan 28 2011 01:14:47 GMT\r\n
+\r\n}
+
+NO_CSEQ_VALUE_RESPONSE = %Q{ RTSP/1.0 460 Only Aggregate Option Allowed\r\n
+Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )\r\n
+Cseq: \r\n
+Connection: Close\r\n
+\r\n}

data/spec/support/fake_rtsp_server.rb

@@ -0,0 +1,123 @@
+require 'time'
+
+class FakeRTSPServer
+  def initialize(*args)
+  end
+
+  def send(*args)
+    message = args.first
+    message =~ /^(\w+) .+CSeq: (\S+)/m
+    @message_type = $1.downcase
+    @cseq = $2
+    @session = 1234567890
+  end
+
+  def recvfrom(size)
+    response = eval @message_type
+    [response]
+  end
+
+  def options
+    message = "RTSP/1.0 200 OK\r\n"
+    message << "CSeq: #{@cseq}\r\n"
+    message << "Date: #{Time.now.httpdate}\r\n"
+    message << "Public: DESCRIBE, SETUP, TEARDOWN, PLAY, PAUSE\r\n"
+    message << "\r\n"
+  end
+
+  def describe
+    message = "RTSP/1.0 200 OK\r\n"
+    message << "CSeq: #{@cseq}\r\n"
+    message << "Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )\r\n"
+    message << "Cache-Control: no-cache\r\n"
+    message << "Content-length: 380\r\n"
+    message << "Date: Tue, 15 Mar 2011 01:28:57 GMT\r\n"
+    message << "Expires: Tue, 15 Mar 2011 01:28:57 GMT\r\n"
+    message << "Content-Type: application/sdp\r\n"
+    message << "x-Accept-Retransmit: our-retransmit\r\n"
+    message << "x-Accept-Dynamic-Rate: 1\r\n"
+    message << "Content-Base: rtsp://64.202.98.91:554/sa.sdp/\r\n"
+    message << "\r\n"
+    message << "v=\r\n"
+    message << "o=- 1905836198 1274535354 IN IP4 127.0.0.1\r\n"
+    message << "s=Secret Agent from SomaFM\r\n"
+    message << "i=Downtempo Spy Lounge\r\n"
+    message << "c=IN IP4 0.0.0.0\r\n"
+    message << "t=0 0\r\n"
+    message << "a=x-qt-text-cmt:Orban Opticodec-PC\r\n"
+    message << "a=x-qt-text-nam:Secret Agent from SomaFM\r\n"
+    message << "a=x-qt-text-inf:Downtempo Spy Lounge\r\n"
+    message << "a=control:*\r\n"
+    message << "m=audio 0 RTP/AVP 96\r\n"
+    message << "b=AS:40\r\n"
+    message << "a=rtpmap:96 MP4A-LATM/44100/2\r\n"
+    message << "a=fmtp:96 cpresent=0;config=400027200000\r\n"
+    message << "a=control:trackID=1\r\n"
+    message << "\r\n"
+  end
+
+  def announce
+    message = "RTSP/1.0 200 OK\r\n"
+    message << "CSeq: #{@cseq}\r\n"
+    message << "\r\n"
+  end
+
+  def setup
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+Date: #{Time.now.httpdate}\r
+Transport: RTP/AVP;unicast;destination=10.221.222.186;source=10.221.222.235;client_port=9000-9001;server_port=6700-6701\r
+Session: #{@session}\r
+\r\n}
+  end
+
+  def play
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+Date: #{Time.now.httpdate}\r
+Range: npt=0.000-\r
+Session: #{@session}\r
+RTP-Info: url=rtsp://10.221.222.235/stream1/track1;seq=17320;rtptime=400880602\r
+\r\n}
+  end
+
+  def pause
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+Date: #{Time.now.httpdate}\r
+\r\n}
+  end
+
+  def teardown
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )\r
+Session: #{@session}\r
+Connection: Close\r
+\r\n}
+  end
+
+  def get_parameter
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+Content-Length: 8\r
+\r
+response\r
+\r\n}
+  end
+
+  def set_parameter
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+Content-Length: 8\r
+    \r
+response\r
+    \r\n}
+  end
+
+  def record
+    %Q{RTSP/1.0 200 OK\r
+CSeq: #{@cseq}\r
+\r\n}
+  end
+end