sdp 0.1.0

data/.document

@@ -0,0 +1,3 @@
+- 
+ChangeLog.*
+LICENSE.txt

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 @@
+--color
+--format documentation
+--tty

data/.yardopts

@@ -0,0 +1 @@
+--markup rdoc --title "sdp Documentation" --protected

data/ChangeLog.rdoc

@@ -0,0 +1,7 @@
+=== 0.1.0 / 2011-01-21
+
+* Initial release:
+  * Parses SDP text to SDP::Description objects
+  * Create SDP::Description objects from scratch
+* Not yet implemented:
+  * Parsing of media sections that contain fields other than "attribute"

data/Gemfile

@@ -0,0 +1,16 @@
+source :rubygems
+
+#gemspec
+gem 'parslet', '~> 1.0.0'
+
+group :development do
+  gem 'rake',     '~> 0.8.7'
+  gem 'ore-core',  '~> 0.1.0'
+  gem 'jeweler', '~> 1.5.0'
+  gem 'ore-tasks', '~> 0.3.0'
+  gem 'rspec', '~> 2.3.0'
+  gem 'yard', '~> 0.6.0'
+  gem 'infinity_test'
+  gem 'metric_fu'
+  gem 'code_statistics', '~> 0.2.13'
+end

data/Gemfile.lock

@@ -0,0 +1,111 @@
+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)
+    git (1.2.5)
+    haml (3.0.25)
+    hirb (0.3.6)
+    hoe (2.8.0)
+      rake (>= 0.8.7)
+    i18n (0.5.0)
+    infinity_test (1.0.2)
+      notifiers (>= 1.1.0)
+      watchr (>= 0.7)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    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)
+    ore-core (0.1.1)
+    ore-tasks (0.3.0)
+      ore-core (~> 0.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.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.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)
+    sexp_processor (3.0.5)
+    watchr (0.7)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  code_statistics (~> 0.2.13)
+  infinity_test
+  jeweler (~> 1.5.0)
+  metric_fu
+  ore-core (~> 0.1.0)
+  ore-tasks (~> 0.3.0)
+  parslet (~> 1.0.0)
+  rake (~> 0.8.7)
+  rspec (~> 2.3.0)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 sloveless
+
+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/README.rdoc

@@ -0,0 +1,141 @@
+= sdp
+
+* {Homepage}[http://rubygems.org/gems/sdp]
+* {Documentation}[http://rubydoc.info/gems/sdp]
+* {Email}[steve.loveless at gmail.com]
+
+== Description
+
+SDP is used by a number of protocols for describing multimedia sessions; protocols
+include SIP (Session Initiation Protocol), SAP (Session Announcement Protocol),
+and RTSP (Real Time Streaming Protocol).
+
+This gem has two purposes:
+1. To use as a client to parse SDP descriptions into useful objects
+2. To allow for creating an SDP description from scratch
+
+Since SDP descriptions contain a lot of useful data pieces, but due to the
+design of SDP descriptions, not only is it tough to know what's what when
+you visually look at that description, but it's tough to extract out the piece of
+data that you need to work with (ex. session ID).  The SDP.#parse method takes
+a description and parses it in to a Hash-like SDP::Description object, which has
+accessor methods (that mimic the RFC 4566 document) for easily getting and setting
+values.
+
+Similarly, since it's difficult to remember all the ins and outs of building
+an SDP description string that meets the requirements of RFC 4566, the
+SDP::Description class has a #to_s method that takes the fields that you've
+populated (from using the accessors) and turns those in to a string that's suitable
+to use for an SDP description.
+
+== Features
+
+* Parse an SDP description from String to Ruby object
+* Create new SDP description
+
+== Examples
+
+=== Creating an SDP description
+
+  require 'sdp/description'
+  
+  sdp = SDP::Description.new
+  sdp.inspect       # => {:session_section=>{
+                    #       :time_zones=>[], :attributes=>[], :protocol_version=>0
+                    #      },
+                    #     :media_sections=>[]
+                    #    } 
+  sdp.to_s          # => "v=0\no=     \ns=\nc=  \nt= \n\n" 
+  sdp.username = "elvis"
+  sdp.media_sections << { :media => "video", :port => 9000, :format => 0, :protocol => "RTP/AVP", :attributes => [{ :attribute => "recvonly" }] }
+  sdp.media_sections << { :media => "audio", :port => 9100, :format => 33, :protocol => "RTP/AVP", :attributes => [{ :attribute => "rtpmap", :value => "99 h263-1998/90000" }] }
+  
+  # Fields are stored in a Hash, where the session information goes in :session_section,
+  # and each media section goes in an Array at :media_sections:
+  sdp.inspect     # => {:session_section=>{:time_zones=>[], :attributes=>[], :protocol_version=>0, :username=>"elvis"}, :media_sections=>[{:media=>"video", :port=>9000, :format=>0, :protocol=>"RTP/AVP", :attributes=>[{:attribute=>"recvonly"}]}, {:media=>"audio", :port=>9100, :format=>33, :protocol=>"RTP/AVP", :attributes=>[{:attribute=>"rtpmap", :value=>"99 h263-1998/90000"}]}]} 
+  sdp.valid?      # => false (Require fields haven't yet been given)
+  sdp.id = 1
+  sdp.version = 123
+  sdp.network_type = :IN
+  sdp.address_type = :IP4
+  sdp.name = " "
+  sdp.start_time = 1
+  sdp.stop_time = 10
+  sdp.unicast_address = "127.0.0.1"
+  sdp.valid?      # => true
+  sdp.to_s        # => "v=0\no=elvis 1 123 IN IP4 127.0.0.1\ns= \nc=IN IP4 \nt=1 10\nm=video 9000 RTP/AVP 0\na=recvonlym=audio 9100 RTP/AVP 33\na=rtpmap:99 h263-1998/90000\n"
+  
+
+=== Parsing an SDP description
+
+  sdp_string = <<-EOF
+  v=0
+  o=jdoe 2890844526 2890842807 IN IP4 10.47.16.5
+  s=SDP Seminar
+  i=A Seminar on the session description protocol
+  u=http://www.example.com/seminars/sdp.pdf
+  e=j.doe@example.com (Jane Doe)
+  p=+1 617 555-6011
+  c=IN IP4 224.2.17.12/127
+  b=CT:1000
+  t=2873397496 2873404696
+  r=604800 3600 0 90000
+  z=2882844526 -1h
+  k=clear:password
+  a=recvonly
+  a=type:test
+  m=audio 49170 RTP/AVP 0
+  m=video 51372 RTP/AVP 99
+  a=rtpmap:99 h263-1998/90000
+  EOF
+  
+  session = SDP.parse sdp_string
+  
+  session.class               # => SDP::Description
+  session.protocol_version    # => 0
+  session.media_sections      # => [{:media=>"audio", :port=>"49170", :protocol=>"RTP/AVP", :format=>"0", :attributes=>""}, {:media=>"video", :port=>"51372", :protocol=>"RTP/AVP", :format=>"99", :attributes=>[{:attribute=>"rtpmap", :value=>"99 h263-1998/90000"}]}] 
+  session.username            # => "jdoe"
+  session.id                  # => "2890844526"
+  session.version             # => "2890842807"
+  session.network_type        # => "IN"
+  session.address_type        # => "IP4"
+  session.unicast_address     # => "10.47.16.5"
+  session.name                # => "SDP Seminar"
+  session.information         # => "A Seminar on the session description protocol"
+  session.uri                 # => "http://www.example.com/seminars/sdp.pdf"
+  session.email_address       # => "j.doe@example.com (Jane Doe)"
+  session.connection_address  # => "224.2.17.12/127"
+  session.start_time          # => 2873397496
+  session.stop_time           # => 2873404696
+  session.attributes          # => [{:attribute=>"recvonly"}, {:attribute=>"type", :value=>"test"}] 
+  
+  # Put it back to a string...
+  session.to_s        # => "v=0\r\n
+                      #     o=elvis 2890844526 2890842807 IN IP4 10.47.16.5\r\n
+                      #     s=SDP Seminar\r\n
+                      #     i=A Seminar on the session description protocol\r\n
+                      #     u=http://www.example.com/seminars/sdp.pdf\r\n
+                      #     e=j.doe@example.com (Jane Doe)\r\n
+                      #     c=IN IP4 224.2.17.12/127\r\n
+                      #     t=2873397496 2873404696\r\n
+                      #     a=recvonly\r\n
+                      #     m=audio 49170 RTP/AVP 0\r\n
+                      #     m=video\r\n"
+                      #     a=rtpmap:99 h263-1998/90000\r\n"
+
+== Requirements
+
+* Rubies (tested, at least):
+  * 1.8.7
+  * 1.9.1
+  * 1.9.2
+
+== Install
+
+  $ gem install sdp
+
+== Copyright
+
+Copyright (c) 2011 Steve Loveless
+
+See LICENSE.txt for details.

data/Rakefile

@@ -0,0 +1,39 @@
+require 'rubygems'
+
+begin
+  require 'bundler'
+rescue LoadError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `gem install bundler` to install Bundler."
+  exit e.status_code
+end
+
+begin
+  Bundler.setup(:development)
+rescue Bundler::BundlerError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `bundle install` to install missing gems."
+  exit e.status_code
+end
+
+require 'rake'
+
+require 'ore/specification'
+require 'jeweler'
+Jeweler::Tasks.new(Ore::Specification.new)
+
+require 'ore/tasks'
+Ore::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.ruby_opts = "-w"
+  t.rspec_opts = ['--format', 'documentation', '--color']
+end
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new  
+
+# Load all extra rake tasks
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].each { |ext| load ext }

data/features/sdp_create.feature

@@ -0,0 +1,15 @@
+Feature: Programmatically create an SDP file
+  As a utility using SDP to describe a multimedia session
+  I want to be able to turn Ruby code in to an SDP description,
+    as specified in RFC 4566
+  So that I can use Ruby to describe the multimedia session
+
+  Scenario: Create an SDP file from a Ruby object
+    Given I know what the SDP file should look like
+    When I build the Ruby object with the appropriate fields
+    Then the resulting file should look like the intended description
+
+  Scenario: Create a basic SDP object
+    Given I create an SDP object with no parameters
+    When I convert it to a String
+    Then it should have :version set to 0

data/features/sdp_get.feature

@@ -0,0 +1,35 @@
+Feature: Get SDP file fields and marshall into Ruby data types
+  As an RTSP consumer
+  I want to be able to be able to read SDP files into Ruby data types
+  So that it's easy to determine how to work with the RTSP stream
+  
+  Scenario: Parse the RFC 4566 example
+    Given the RFC 4566 SDP example in a file
+    When I parse the file
+    Then the <value> for <field> is accessible via the SDP object
+      | field             | value             |
+      | protocol_version  | 0                 |
+      | username          | jdoe              |
+      | id                | 2890844526        |
+      | version           | 2890842807        |
+      | network_type      | IN                |
+      | address_type      | IP4               |
+      | unicast_address   | 10.47.16.5        |
+      | name              | SDP Seminar       |
+      | information       | A Seminar on the session description protocol |
+      | uri               | http://www.example.com/seminars/sdp.pdf |
+      | email_address     | j.doe@example.com (Jane Doe)            |
+      | connection_address | 224.2.17.12/127  |
+      | start_time        | 2873397496        |
+      | stop_time         | 2873404696        |
+      | attributes        | recvonly          |
+#      | m[0][1] | 49170               |
+#      | m[0][2] | "RTP/AVP"           |
+#      | m[0][3] | 0                   |
+#      | m[1][1] | 51372               |
+#      | m[1][2] | "RTP/AVP"           |
+#      | m[1][3] | 99                  |
+#      | a[1][1] | 99        |
+#      | a[1][2] | "h263-1998" |
+#      | a[1][3] | 90000     |
+

data/features/step_definitions/sdp_create_steps.rb

@@ -0,0 +1,46 @@
+require 'sdp/description'
+
+Given /^I know what the SDP file should look like$/ do
+  @example_sdp_file = File.read(File.dirname(__FILE__) + "/../support/sdp_file.txt")
+end
+
+When /^I build the Ruby object with the appropriate fields$/ do
+  @session = SDP::Description.new
+  @session.protocol_version = 0
+  @session.username = "jdoe"
+  @session.id = 2890844526
+  @session.version = 2890842807
+  @session.network_type = :IN
+  @session.address_type = :IP4
+  @session.unicast_address = "10.47.16.5"
+  @session.name = "SDP Seminar"
+  @session.information = "A Seminar on the session description protocol"
+  @session.uri = "http://www.example.com/seminars/sdp.pdf"
+  @session.email_address = "j.doe@example.com (Jane Doe)"
+  @session.connection_address = "224.2.17.12/127"
+  @session.start_time = 2873397496
+  @session.stop_time = 2873404696
+  @session.attributes << { :attribute => "recvonly" }
+  @session.media_sections << 
+    { :media => "audio", :port => 49170, :protocol => "RTP/AVP", :format => 0 }
+  @session.media_sections << 
+    { :media => "video", :port => 51372, :protocol => "RTP/AVP", :format => 99,
+      :attributes => [{ :attribute => "rtpmap", :value => "99 h263-1998/90000" }]
+    }
+end
+
+Then /^the resulting file should look like the intended description$/ do
+  @session.to_s.should == @example_sdp_file
+end
+
+Given /^I create an SDP object with no parameters$/ do
+  @session = SDP::Description.new
+end
+
+When /^I convert it to a String$/ do
+  @sdp_string = @session.to_s
+end
+
+Then /^it should have :version set to (\d+)$/ do |value|
+  @sdp_string.should match /v=#{value}/
+end

data/features/step_definitions/sdp_get_steps.rb

@@ -0,0 +1,23 @@
+Given /^the RFC 4566 SDP example in a file$/ do
+  @sdp_file = File.open(File.dirname(__FILE__) + '/../support/sdp_file.txt', 'r').read
+end
+
+When /^I parse the file$/ do
+  @sdp = SDP.parse @sdp_file
+end
+
+Then /^the <value> for <field> is accessible via the SDP object$/ do |table|
+  # table is a Cucumber::Ast::Table
+  table.hashes.each do |sdp_field|
+    field_type = sdp_field["field"].to_sym
+    value = sdp_field["value"]
+
+    actual_value = @sdp.send(field_type)
+
+    if field_type == :attributes
+      actual_value.first[:attribute].should == value
+    else
+      actual_value.to_s.should == value
+    end
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,3 @@
+$:.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'sdp'
+require 'sdp/description'

data/features/support/sdp_file.txt

@@ -0,0 +1,12 @@
+v=0
+o=jdoe 2890844526 2890842807 IN IP4 10.47.16.5
+s=SDP Seminar
+i=A Seminar on the session description protocol
+u=http://www.example.com/seminars/sdp.pdf
+e=j.doe@example.com (Jane Doe)
+c=IN IP4 224.2.17.12/127
+t=2873397496 2873404696
+a=recvonly
+m=audio 49170 RTP/AVP 0
+m=video 51372 RTP/AVP 99
+a=rtpmap:99 h263-1998/90000

data/gemspec.yml

@@ -0,0 +1,15 @@
+name: sdp
+summary: "Parse and create SDP (Session Description Protocol) text based on RFC4566."
+description: "This gem allows for parsing SDP (Session Description Protocol) information in to a Ruby object, making it easy to read and work with that data.  It also allows for easily creating SDP objects that can be converted to text using #to_s."
+license: MIT
+authors: sloveless
+email: steve.loveless@gmail.com
+homepage: http://rubygems.org/gems/sdp
+has_yard: true
+
+dependencies:
+  parslet: ~> 1.0.0
+
+development_dependencies:
+  bundler: ~> 1.0.0
+  yard: ~> 0.6.0

data/lib/sdp/description.rb

@@ -0,0 +1,172 @@
+require 'erb'
+
+class SDP
+  PROTOCOL_VERSION = 0
+
+  # Represents an SDP description as defined in RFC 4566.  This class allows
+  # for creating an object so you can, in turn, create a String that
+  # represents an SDP description.  The String, then can be used by
+  # other protocols that depend on an SDP description.
+  #
+  # SDP::Description objects are initialized empty (i.e. no fields are
+  # defined), putting the onus on you to add fields in the proper order.
+  # After building the description up, call #to_s to render it.  This
+  # will render the String with fields in order that they were added
+  # to the object, so be sure to add them according to spec!
+  class Description < Hash
+    class << self
+
+      # Class macro to access the different fields that make up the
+      # description.
+      #
+      # @param [Symbol] field_type
+      def field(field_type)
+        define_read_field_method(field_type)
+        define_write_field_method(field_type)
+      end
+
+      # Creates read accessor for the field type.  This simply reads
+      # the correct Hash value and returns that.
+      #
+      # @param [Symbol] field_type
+      # @return [] Returns whatever type the value is that's stored
+      # in the Hash key.
+      def define_read_field_method(field_type)
+        define_method field_type do
+          if field_type == :media_sections
+            self[:media_sections]
+          else
+            self[:session_section][field_type]
+          end
+        end
+      end
+
+      # Creates write accessor for the field type.  This simply writes
+      # the correct Hash value and returns that.
+      #
+      # @param [Symbol] field_type
+      def define_write_field_method(field_type)
+        case field_type
+        when :media_sections
+          define_method ":media_sections<<" do |value|
+            self[:media_sections] << value
+          end
+        when :time_zones || :attributes
+          define_method "#{field_type}<<" do |value|
+            self[:session_section][field_type] << value
+          end
+        else
+          define_method "#{field_type}=" do |value|
+            self[:session_section][field_type] = value
+          end
+        end
+      end
+    end
+
+    FIELDS = [
+      :protocol_version,
+      :username,
+      :id,
+      :version,
+      :network_type,
+      :address_type,
+      :unicast_address,
+      :name,
+      :information,
+      :uri,
+      :email_address,
+      :phone_number,
+      :connection_address,
+      :bandwidth_type,
+      :bandwidth,
+      :start_time,
+      :stop_time,
+      :repeat_interval,
+      :active_duration,
+      :offsets_from_start_time,
+      :time_zones,
+      :encryption_method,
+      :encryption_key,
+      :attributes,
+      :media_sections
+      ]
+
+    FIELDS.each do |field_type|
+      field field_type
+    end
+
+    # @param [Hash] session_as_hash Pass this in to use these values instead
+    # of building your own from scratch.
+    def initialize(session_as_hash=nil)
+      if session_as_hash.nil?
+        self[:session_section] = {}
+        self[:session_section][:time_zones] = []
+        self[:session_section][:attributes] = []
+        self[:media_sections] = []
+
+        self.send :protocol_version=, SDP::PROTOCOL_VERSION
+      else
+        begin
+          unless validate_init_value(session_as_hash)
+            self.replace session_as_hash
+          end
+        rescue SDP::RuntimeError => ex
+          puts ex.message
+          raise
+        end
+      end
+
+      super
+    end
+
+    # Turns the current SDP::Description object into the SDP description,
+    # ready to be used.
+    #
+    # @return [String] The SDP description.
+    def to_s
+      template = File.read(File.dirname(__FILE__) + "/session_template.erb")
+
+      sdp = ERB.new(template, 0, "%<>")
+      sdp.result(get_binding)
+    end
+
+    # Checks to see if the fields set in the current object will yield an SDP
+    # description that meets the RFC 4566 spec.
+    #
+    # @return [Boolean] true if the object will meet spec; false if not.
+    def valid?
+      return false unless protocol_version && username && id && version &&
+        network_type && address_type && unicast_address && name &&
+        start_time && stop_time && !media_sections.empty?
+
+      true
+    end
+
+    #--------------------------------------------------------------------------
+    # PRIVATES!
+    private
+
+    # @return [Binding] Values for this object for ERB to use.
+    def get_binding
+      binding
+    end
+
+    # @raise [SDP::RuntimeError] If not given a Hash.
+    def validate_init_value value
+      unless value.class == Hash
+        message = "Must pass a Hash in on initialize.  You passed in a #{value.class}."
+        raise SDP::RuntimeError, message
+      end
+
+      bad_keys = []
+      value.each_key do |key|
+        bad_keys << key unless (FIELDS.include?(key) || key == :session_section)
+      end
+
+      unless bad_keys.empty?
+        message = "Invalid key value passed in on initialize: #{bad_keys}"
+        raise SDP::RuntimeError, message
+      end
+    end
+  end
+end