rtsp 0.0.1.alpha

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/.infinity_test

@@ -0,0 +1,4 @@
+infinity_test do
+  use :rubies => %w(1.8.7 1.9.1 1.9.2), :test_framework => :rspec
+  notifications :growl
+end

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--tty

data/Gemfile

@@ -0,0 +1,12 @@
+source :rubygems
+
+gem 'sdp', '~> 0.2.0'
+
+group :development do
+  gem "rspec", '~> 2.4.0'
+  gem "hoe-yard", :require => "hoe/yard"
+  gem 'yard', '~> 0.6.0'
+  gem 'infinity_test'
+  gem 'metric_fu'
+  gem 'code_statistics', '~> 0.2.13'
+end

data/Gemfile.lock

@@ -0,0 +1,104 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    Saikuro (1.1.0)
+    abstract (1.0.0)
+    activesupport (3.0.3)
+    arrayfields (4.7.4)
+    blankslate (2.1.2.3)
+    chronic (0.2.3)
+      hoe (>= 1.2.1)
+    churn (0.0.13)
+      chronic (>= 0.2.3)
+      hirb
+      json_pure
+      main
+      ruby_parser (~> 2.0.4)
+      sexp_processor (~> 3.0.3)
+    code_statistics (0.2.13)
+    colored (1.2)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    fattr (2.2.0)
+    flay (1.4.1)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    flog (2.5.0)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    haml (3.0.25)
+    hirb (0.3.6)
+    hoe (2.8.0)
+      rake (>= 0.8.7)
+    hoe-yard (0.1.2)
+      yard (>= 0.2.3.1)
+    i18n (0.5.0)
+    infinity_test (1.0.2)
+      notifiers (>= 1.1.0)
+      watchr (>= 0.7)
+    json_pure (1.4.6)
+    main (4.4.0)
+      arrayfields (>= 4.7.4)
+      fattr (>= 2.1.0)
+    metric_fu (2.0.1)
+      Saikuro (>= 1.1.0)
+      activesupport (>= 2.0.0)
+      chronic (~> 0.2.3)
+      churn (>= 0.0.7)
+      flay (>= 1.2.1)
+      flog (>= 2.2.0)
+      rails_best_practices (>= 0.3.16)
+      rcov (>= 0.8.3.3)
+      reek (>= 1.2.6)
+      roodi (>= 2.1.0)
+    notifiers (1.1.0)
+    parslet (1.0.1)
+      blankslate (~> 2.1.2.3)
+    rails_best_practices (0.6.5)
+      activesupport
+      colored (~> 1.2)
+      erubis (~> 2.6.6)
+      haml (~> 3.0.18)
+      i18n
+      ruby-progressbar (~> 0.0.9)
+      ruby_parser (~> 2.0.4)
+    rake (0.8.7)
+    rcov (0.9.9)
+    reek (1.2.8)
+      ruby2ruby (~> 1.2)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    roodi (2.1.0)
+      ruby_parser
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+    ruby-progressbar (0.0.9)
+    ruby2ruby (1.2.5)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby_parser (2.0.5)
+      sexp_processor (~> 3.0)
+    sdp (0.2.0)
+      parslet (~> 1.0.0)
+    sexp_processor (3.0.5)
+    watchr (0.7)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  code_statistics (~> 0.2.13)
+  hoe-yard
+  infinity_test
+  metric_fu
+  rspec (~> 2.4.0)
+  sdp (~> 0.2.0)
+  yard (~> 0.6.0)

data/History.txt

@@ -0,0 +1,4 @@
+h3. 0.0.1 / 2010-12-15
+
+* Happy birthday! 
+

data/Manifest.txt

@@ -0,0 +1,26 @@
+.autotest
+.infinity_test
+.rspec
+Gemfile
+Gemfile.lock
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+bin/rtsp
+features/step_definitions/stream_steps.rb
+features/stream.feature
+features/support/common.rb
+features/support/env.rb
+features/support/world.rb
+lib/rtsp.rb
+lib/rtsp/client.rb
+lib/rtsp/request_messages.rb
+lib/rtsp/response.rb
+lib/rtsp/status_code.rb
+spec/.rspec
+spec/rtsp/client_spec.rb
+spec/rtsp/response_spec.rb
+spec/rtsp_spec.rb
+spec/spec_helper.rb

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+Thanks for installing rtsp.  We hope you get some good streaming out of it!
+
+Take a look at the README to help get you started.
+
+NOTE: This is only an alpha version!!  It is not well tested and doesn't have
+much error handling built in yet.

data/README.rdoc

@@ -0,0 +1,74 @@
+= rtsp_client
+
+* https://github.com/turboladen/rtsp
+
+== DESCRIPTION:
+
+This library intends to follow the RTSP RFC document (2326) to allow for working
+with RTSP servers.  At this point, it's up to you to parse the data from a play
+call, but we'll get there.  ...eventually.
+
+For more information
+
+RTSP: http://www.ietf.org/rfc/rfc2326.txt
+
+SDP: http://tools.ietf.org/html/rfc4566
+
+== FEATURES/PROBLEMS:
+
+* RTSP client
+* Currently, only unicast
+
+== SYNOPSIS:
+
+The uber-quick get started:
+
+  rtsp_client = RTSP::Client.new "192.168.1.10"
+  rtsp_client.setup :port => 8554
+  rtsp_client.play
+  rtsp_client.teardown
+
+== REQUIREMENTS:
+
+* Ruby
+  * 1.8.7
+  * 1.9.1
+  * 1.9.2
+
+== INSTALL:
+
+* (sudo) gem install rtsp
+
+== DEVELOPERS:
+
+After checking out the source, run:
+
+  $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the RDoc.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2010 FIX
+
+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,57 @@
+require 'rubygems' if RUBY_VERSION < "1.9.0"
+require 'hoe'
+require 'hoe/yard'
+require 'yard'
+require 'newgem/tasks'
+require 'bundler/setup'
+require File.expand_path(File.dirname(__FILE__)) + '/lib/rtsp'
+
+Hoe.plugin :newgem
+Hoe.plugin :yard
+Hoe.plugin :cucumberfeatures
+Hoe.plugins.delete :rubyforge
+
+# Gets the description from the README file
+def get_descr_from_readme
+  paragraph_count = 0
+
+  File.readlines('README.rdoc', '').each do |paragraph|
+    paragraph_count += 1
+
+    return paragraph if paragraph_count == 2
+  end
+end
+
+# The main Gemspec definition
+Hoe.spec 'rtsp' do
+  self.summary        = 'Library to allow RTSP streaming from RTSP-enabled devices.'
+  self.developer('Steve Loveless & Mike Kirby', 'steve.loveless@gmail.com, mkirby@gmail.com')
+  self.post_install_message = File.readlines 'PostInstall.txt'
+  self.version        = RTSP::VERSION
+  self.url            = RTSP::WWW
+  self.description    = get_descr_from_readme
+  self.readme_file    = 'README.rdoc'
+  self.history_file   = 'History.txt'
+  self.rspec_options  += ['--color', '--format', 'documentation']
+  self.extra_deps     += [
+      ['sdp', '~>0.2.0']
+  ]
+  self.extra_dev_deps += [
+      ['rspec', ">=2.0.1"],
+      ['yard', '>=0.6.4'],
+      ['cucumber'],
+      ['hoe-yard', '>=0.1.2']
+  ]
+
+  self.test_globs = 'spec/*.rb'
+
+  # Extra Yard options
+  self.yard_title = "#{self.name} Documentation (#{self.version})"
+  self.yard_opts += ['--output-dir', 'doc']
+  self.yard_opts += ['--private']
+  self.yard_opts += ['--protected']
+  self.yard_opts += ['--verbose']
+  self.yard_opts += ['--files', 
+      [self.history_file, 'Manifest.txt', self.readme_file]
+  ]
+end

data/bin/rtsp

@@ -0,0 +1,121 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'tempfile'
+require 'optparse'
+
+$:.unshift File.expand_path(File.dirname(__FILE__) + '/../lib/')
+require 'rtsp/client'
+
+options = {}
+
+optparse = OptionParser.new do |opts|
+  opts.banner = "Usage: #{__FILE__} [options] url"
+
+  options[:debug] = false
+  opts.on('-d', '--debug', "Turn on debug logging. (not hooked up!)") do
+    options[:debug] = true
+  end
+
+  opts.on('--show-tracks', "Show available tracks from the given URL.") do |url|
+    rtsp_client = RTSP::Client.new(url)
+    puts rtsp_client.stream_tracks
+  end
+
+  opts.on('-h', '--help', "You're looking at it.") do
+    puts opts
+    exit
+  end
+end
+
+optparse.parse!
+
+# Allows for running an RTSP client
+url = ARGV.first || "rtsp://64.202.98.91:554/sa.sdp"
+
+rtsp_client = RTSP::Client.new(url)
+response = rtsp_client.options
+puts "code:           #{response.code}"
+puts "message:        #{response.message}"
+#puts "server:         #{response.server}"
+puts "cseq:           #{response.cseq}"
+puts "public:         #{response.public}"
+
+response = rtsp_client.describe
+puts "code:           #{response.code}"
+puts "message:        #{response.message}"
+puts "server:         #{response.server}" if response.respond_to? "server"
+puts "cseq:           #{response.cseq}"
+puts "cache_control:  #{response.cache_control}" if response.respond_to? "cache_control"
+puts "content_length: #{response.content_length}"
+puts "date:           #{response.date}"
+puts "expires:        #{response.expires}" if response.respond_to? "expires"
+puts "content_type:   #{response.content_type}"
+puts "content_base:   #{response.content_base}"
+
+# content_base is the base URI for any track to work with
+track = URI.parse response.content_base
+puts rtsp_client.aggregate_control_track
+puts rtsp_client.media_control_tracks
+
+# Add the first media_control_track to the URI
+puts track.path += rtsp_client.media_control_tracks.first 
+puts track.to_s
+
+# Replace the client's list of tracks with the available track
+rtsp_client.stream_tracks[0] = track.to_s
+response = rtsp_client.setup(:destination => 'unicast')
+puts "code:           #{response.code}"
+puts "message:        #{response.message}" 
+puts "server:         #{response.server}" if response.respond_to? "server"
+puts "cseq:           #{response.cseq}"
+puts "session:        #{response.session}"
+puts "transport:      #{response.transport}"
+session = response.session
+transport_info = response.transport
+
+if response.message == "OK"
+  r = rtsp_client.play(:session => session)
+  puts "code:           #{r.code}"
+  puts "message:        #{r.message}"
+  puts "server:         #{r.server}" if response.respond_to? "server"
+  puts "cseq:           #{r.cseq}"
+  puts "session:        #{r.session}"
+  puts "range:          #{r.range}"
+  puts "rtp_info:       #{r.rtp_info}"
+  cseq = r.cseq
+  sleep 5
+  #rtsp_client.pause({ :session => session, :sequence => cseq })
+  r2 = rtsp_client.teardown
+  puts "code:           #{r2.code}"
+  puts "message:        #{r2.message}"
+  puts "server:         #{r2.server}" if r2.respond_to? "server"
+  puts "cseq:           #{r2.cseq}"
+  puts "connection:     #{r2.connection}" if r2.respond_to? "connection"
+end
+exit
+
+#rtsp_client = RTSP::Client.new "192.168.10.219"
+#rtsp_client.setup :port => 8554
+
+socket = UDPSocket.new
+socket.bind "0.0.0.0", 8554
+streamed_file = Tempfile.new "spectra_hd_streamed_file"
+
+begin
+  Timeout::timeout(5) do
+    while data = socket.recvfrom(102400).first
+      puts "data size = #{data.size}"
+      streamed_file.write data
+    end
+  end
+rescue Timeout::Error
+  # blah
+end
+
+socket.close
+rtsp_client.teardown
+
+require 'fileutils'
+FileUtils.cp(streamed_file, "/Users/sloveless/Desktop/")
+streamed_file.close

data/features/step_definitions/stream_steps.rb

@@ -0,0 +1,50 @@
+Given /^an RTSP server at "([^"]*)" and port (\d+)$/ do |ip_address, port|
+  @rtp_port = port
+  @client = RTSP::Client.new ip_address
+  @client.setup :port => @rtp_port.to_i
+end
+
+Given /^an RTSP server at "([^"]*)" and port (\d+) and URL "([^"]*)"$/ do |ip_address, port, path|
+  uri = "rtsp://#{ip_address}:#{port}#{path}"
+  @rtp_port = port
+  @client = RTSP::Client.new uri
+  #@client.setup( { :port => @rtp_port.to_i, :stream_path => path })
+  @client.setup( { :port => @rtp_port.to_i })
+end
+
+When /^I play a stream from that server$/ do
+  @play_result = lambda { @client.play }
+end
+
+Then /^I should not receive any errors$/ do
+  @play_result.should_not raise_error
+end
+
+Then /^I should receive data on the same port$/ do
+  socket = UDPSocket.new
+  socket.bind("0.0.0.0", @rtp_port)
+
+  begin
+    status = Timeout::timeout(5) do
+      while data = socket.recvfrom(102400)[0]
+        puts "marker size:#{data.size}"
+        puts "data: #{data}" if data =~ /\r\n/
+      end
+    end
+
+    data.should_not be_nil
+  rescue Timeout::Error
+    # Blind rescue
+  ensure
+    socket.close
+    @client.teardown
+  end
+end
+
+Given /^I know what the describe response looks like$/ do
+  @response_text = DESCRIBE_RESPONSE
+end
+
+When /^I ask the server to describe$/ do
+  puts @client.describe
+end

data/features/stream.feature

@@ -0,0 +1,17 @@
+Feature: Stream from an RTSP server
+  As an RTSP consumer
+  I want to be able to pull an RTSP stream from a server
+  So that I can view its contents
+  
+  @wip
+  Scenario: Play
+    Given an RTSP server at "10.221.222.235" and port 9010 and URL ""
+    When I play a stream from that server
+    Then I should not receive any errors
+    And I should receive data on the same port
+
+  Scenario: Describe
+    Given I know what the describe response looks like
+    When I ask the server to describe
+    Then I should not receive any errors
+    And I should receive data on the same port

data/features/support/common.rb

@@ -0,0 +1 @@
+

data/features/support/env.rb

@@ -0,0 +1,37 @@
+require 'rubygems'
+require 'socket'
+require 'timeout'
+
+$:.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'rtsp/client'
+
+
+DESCRIBE_RESPONSE = <<-RESP
+RTSP/1.0 200 OK
+Server: DSS/5.5 (Build/489.7; Platform/Linux; Release/Darwin; )
+Cseq: 1
+Cache-Control: no-cache
+Content-length: 406
+Date: Sun, 23 Jan 2011 00:36:45 GMT
+Expires: Sun, 23 Jan 2011 00:36:45 GMT
+Content-Type: application/sdp
+x-Accept-Retransmit: our-retransmit
+x-Accept-Dynamic-Rate: 1
+Content-Base: rtsp://64.202.98.91:554/gs.sdp/
+
+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
+RESP

data/features/support/world.rb

@@ -0,0 +1 @@
+