rubynpr 0.0.1

data/History.txt

@@ -0,0 +1,4 @@
+=== 0.0.1 / 2008-10-26
+
+* Initial release of ruby-npr...!
+

data/Manifest.txt

@@ -0,0 +1,58 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/rubynpr
+lib/rubynpr/audio.rb
+lib/rubynpr/byline.rb
+lib/rubynpr/client.rb
+lib/rubynpr/content.rb
+lib/rubynpr/exception.rb
+lib/rubynpr/image.rb
+lib/rubynpr/item.rb
+lib/rubynpr/list.rb
+lib/rubynpr/message.rb
+lib/rubynpr/organization.rb
+lib/rubynpr/parent.rb
+lib/rubynpr/product.rb
+lib/rubynpr/pull_quote.rb
+lib/rubynpr/related_link.rb
+lib/rubynpr/result_parser.rb
+lib/rubynpr/show.rb
+lib/rubynpr/story.rb
+lib/rubynpr/subcategory.rb
+lib/rubynpr.rb
+test/audio_test.rb
+test/byline_test.rb
+test/client_test.rb
+test/fixtures.rb
+test/fixtures/audio.yml
+test/fixtures/byline.yml
+test/fixtures/client.yml
+test/fixtures/image.yml
+test/fixtures/item.yml
+test/fixtures/list.yml
+test/fixtures/list_text.xml
+test/fixtures/organization.yml
+test/fixtures/parent.yml
+test/fixtures/product.yml
+test/fixtures/pullquote.yml
+test/fixtures/relatedlink.yml
+test/fixtures/show.yml
+test/fixtures/stories.yml
+test/fixtures/story.yml
+test/fixtures/subcategory.yml
+test/image_test.rb
+test/item_test.rb
+test/list_test.rb
+test/organization_test.rb
+test/parent_test.rb
+test/product_test.rb
+test/pullquote_test.rb
+test/related_link_test.rb
+test/show_test.rb
+test/story_list_test.rb
+test/story_test.rb
+test/subcategory_test.rb
+test/test_helper.rb
+test/test_rubynpr.rb

data/README.txt

@@ -0,0 +1,53 @@
+Ruby-NPR
+  by Tiffani Bell (tiffani@thinkpositif.com)
+  http://the.commentari.at
+
+== How do I install?
+
+<tt>sudo gem i ruby-npr</tt>
+
+== How do I get started?
+
+<tt>@client = NPR::Client.new(:api_key => 'your NPR API key')</tt>
+
+Pass a new Client instance your NPR API key which you can get here[http://www.npr.org/api/index].
+
+== Accessing Stories
+
+Use the Client#query method to find content by accessing stories directly or via lists of
+stories from specific NPR topics.
+
+<tt>@client.query(:id => 95965641)</tt>
+
+Client#query always requires the <tt>:id</tt> option and in this particular case, this accesses
+a story directly.  The Story is accessible from <tt>@client.results.list[0]</tt>.
+
+Client#query accepts a single ID value (for either a story or a topic), as above, or a list of IDs in the form of an array.
+
+See Client#query for more details.
+
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2008 Tiffani Bell <tiffani@thinkpositif.com>
+
+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,16 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/rubynpr.rb'
+
+Hoe.new('rubynpr', RubyNPR::VERSION) do |p|
+  p.rubyforge_name = 'rubynpr'
+  p.summary = "A Ruby wrapper for the NPR API"
+  p.developer('Tiffani Ashley Bell', 'tiffani@thinkpositif.com')
+  p.url = "http://rubynpr.rubyforge.org"
+  p.extra_deps = %w( hpricot )
+  p.test_globs = 'test/*.rb'
+end
+
+# vim: syntax=Ruby

data/lib/rubynpr/audio.rb

@@ -0,0 +1,43 @@
+module NPR
+  #
+  # Audio represents all the available audio that is packaged with a particular story.  Audio
+  # features the following attributes: 
+  # * <tt>id</tt>: the unique ID for the audio
+  # * <tt>duration</tt>: the duration in seconds of the audio
+  # * <tt>title</tt>: the title of the audio piece
+  # * <tt>formats</tt>: audio pieces come in three different formats: MP3, Windows Media, and Real Audio. Audio
+  #   of the different formats can be accessed by a hash like so: <tt>audio.formats[:mp3]</tt>. Hash options are
+  #   <tt>:mp3</tt>, <tt>:wm</tt>, <tt>:rm</tt>, and <tt>:ram</tt>. <tt>:ram</tt> is more likely to show up with older stories.
+  # 
+  class Audio < Content
+    FORMATS = [:mp3, :wm, :rm, :ram]
+    
+    attr_accessor :id, :duration, :type, :title, :formats, :rights_holder, :mp3_rights
+     
+    private
+    def new_from_nprml(audio_nprml)
+      return nil if audio_nprml.nil?
+      
+      @id, @type = audio_nprml[:id], audio_nprml[:type]
+      @title, @duration = audio_nprml.at('title').html, audio_nprml.at('duration').html
+      @rights_holder = audio_nprml.at('rightsHolder').html
+      
+      process_audio_formats(audio_nprml.at('format'))
+      
+      if audio_nprml.at('mp3')
+        @mp3_rights = audio_nprml.at('mp3')[:rights]
+      end
+    end
+    
+    def process_audio_formats(format_nprml)
+      return nil if format_nprml.empty?
+      
+      @formats = {}
+      FORMATS.each do |format|
+        unless format_nprml.at(format.to_s).nil?
+          @formats[format] = format_nprml.at(format.to_s).html
+        end
+      end
+    end
+  end
+end

data/lib/rubynpr/byline.rb

@@ -0,0 +1,20 @@
+module NPR
+  # Byline represents a listing of the author(s) of an NPR story.  From a byline, you have
+  # access to:
+  # 
+  # * <tt>id</tt> - unique ID of the byline
+  # * <tt>name</tt> - the author's name
+  # * <tt>person</tt> - the NPR ID of the author
+  # * <tt>links</tt> - links to all content from a particular author
+  # 
+  class Byline < Content
+    attr_accessor :id, :name, :person, :links
+
+    private
+    def new_from_nprml(byline_nprml)
+      return nil if byline_nprml.empty?
+      @id = byline_nprml[:id]
+      @name, @person = byline_nprml.at('name').html, byline_nprml.at('name')[:personId]
+    end
+  end
+end

data/lib/rubynpr/client.rb

@@ -0,0 +1,192 @@
+
+module NPR
+  # Client handles the connection to NPR.  Create an instance of Client and use Client#query or Client#list to pull
+  # content from NPR.
+  # 
+  class Client
+    API_HOST = 'api.npr.org'
+    API_OUTPUT_FORMATS = [:nprml, :rss, :media_rss, :json, :html]
+    API_INPUT_QUERY_OPTIONS = [:id, :date, :start_date, :end_date, :org_id, :search_term, 
+                               :search_type, :num_results, :fields]
+    
+    attr_accessor :results, :api_key, :warnings
+    
+    # Creates an NPR API client session.  Set the <tt>:api_key</tt> value to include the NPR API key.  This
+    # can also be set later using the <tt>api_key method</tt>.  To get started, make sure you have an API key from NPR. You 
+    # can get an API key here: http://www.npr.org/api/index.  Then:
+    # 
+    # <tt>client = NPR::Client.new(:api_key => 'your NPR api key')</tt>
+    # 
+    # If a query is attempted using a client whose <tt>api_key</tt> hasn't been set, an InvalidAPIKey exception will be raised.
+    # 
+    def initialize(options = {})
+      @api_key = options[:api_key]
+    end
+  
+    # Sends queries to NPR.  <tt>query</tt> has a bunch of options for building a query.  Options include:
+    # * <tt>:id</tt> - returns stories that belong to the given IDs or stories belonging to a given topic ID.  Accepts either a single ID value, 
+    #   an array of IDs, or an object representing a topic.
+    # * <tt>:date</tt> - returns stories with the exact date requested.  If <tt>:date</tt> to <tt>:current</tt>, one of two things can happen. If
+    #   one of the parameters is a program, setting <tt>:date</tt> to <tt>:current</tt> will return stories from the last complete episode of the
+    #   given program.  If none of the <tt>:id</tt> parameters is a program, setting <tt>:date</tt> to <tt>:current</tt> will just return stories from today.
+    #   <em>Note:</em> Any dates used will be converted to follow the big-endian <tt>YYYY-MM-DD</tt> format as part of the URI as required by NPR
+    # * <tt>:start_date</tt> - returns stories published on or after the given date. Takes time as either a UTC or local Time object.
+    # * <tt>:end_date</tt> - returns stories published on or before the given date. Same as <tt>:start_date</tt> - takes time as either a 
+    #   UTC or local Time object.
+    # * <tt>:org_id</tt> - returns stories that are provided by the given organization.
+    # * <tt>:search_term</tt> - returns stories that are considered to be matches on the given search term.
+    # * <tt>:search_type</tt> - used with <tt>:search_term</tt> to help NPR determine which fields it should search.  If <tt>:search_type</tt> isn't
+    #   specified, NPR will search the full content of the story.  Otherwise, use <tt>:main</tt> to search only the <tt>title</tt> and
+    #   <tt>teaser</tt> fields on stories.
+    # * <tt>:num_results</tt> - determines the number of stories that will be returned.  The NPR API caps the number of stories that can
+    #   be returned at 20.  If the <tt>:num_results</tt> is greater than the maximum, the API will return the maximum.
+    # * <tt>:start</tt> - used to paginate through a large result set.  Use with <tt>:num_results</tt> to return something lesser than the maximum
+    #   number of remaining results (20).
+    # * <tt>:fields</tt> - used to specify which attributes to return on stories.  Use a single value or an array of any of the following values:
+    #   * <tt>:title</tt>
+    #   * <tt>:teaser</tt>
+    #   * <tt>:storyDate</tt>
+    #   * <tt>:show</tt>
+    #   * <tt>:byline</tt>
+    #   * <tt>:text</tt>
+    #   * <tt>:audio</tt>
+    #   * <tt>:image</tt>
+    #   * <tt>:textWithHtml</tt>
+    #   * <tt>:pullquote</tt>
+    #   * <tt>:relatedLink</tt>
+    #   * <tt>:album</tt>
+    #   * <tt>:product</tt>
+    #   * <tt>:parent</tt>
+    #   * <tt>:artist</tt> - if the story is about an album, this will return all associated artists
+    #   * <tt>:summary</tt> - a way of accessing certain fields including <tt>title</tt>, <tt>subtitle</tt>, <tt>shortTitle</tt>, <tt>teaser</tt>,
+    #     <tt>mini_teaser</tt>, <tt>slug</tt>, <tt>thumbnail</tt>, <tt>toenail</tt>, <tt>story_date</tt>, <tt>publication_date</tt>,
+    #     <tt>last_modified</tt>, <tt>keywords</tt>, and <tt>priority_keywords</tt>.
+    #   * <tt>:titles</tt> - returns all titles associated with a story, e.g., <tt>title</tt>, <tt>subtitle</tt>, <tt>shortTitle</tt>, and <tt>slug</tt>.
+    #   * <tt>:teasers</tt> - returns all teasers associated with a story, e.g., <tt>teaser</tt> and <tt>mini_teaser</tt>.
+    #   * <tt>:dates</tt> - returns all dates associated with a story, e.g., <tt>story_date</tt>, <tt>publication_date</tt>, and <tt>last_modifed</tt>.
+    # 
+    # ==== Examples
+    # <tt>client.query(:id => 95937183)</tt><br />
+    # <tt>client.query(:id => [95937183, 95691841, 95683592])</tt><br />
+    # <tt>client.query(:id => 1031, :search_term => 'polio')</tt><br />
+    # <tt>client.query(:id => 1017, :search_term => 'Alan Greenspan', :search_type => :main)</tt><br />
+    # <tt>client.query(:id => some_topic, :num_results => 3, :start_date => Time.utc(2008, 10, 3))</tt> where <tt>some_topic</tt> is an object
+    # representing a topic as pulled from the results of a Client#list query.
+    # 
+    def query(options = {})
+      if @api_key.nil?
+        raise InvalidAPIKey.new(NPRException::INVALID_API_KEY, 'An API key has not been specified for this NPR client.')
+      elsif !options.include?(:id) && !options.include?(:search_term)
+        raise InvalidQueryOptions.new(nil, 'An :id must be specified with every request.')
+      end
+      
+      options.merge!(:type => :query) unless options[:type] == :list
+      path = assemble_path(options)
+      request(path)
+    end
+
+    # Accesses the different kinds of lists available via the NPR API.  NPR provides access to topics, music genres, programs, bios,
+    # music artists, columns, and series via the API.  This method takes the lone <tt>:id</tt> hash to specify which list to access.
+    # The <tt>:id</tt> parameter only accepts one value.  The available list values to pass with <tt>:id</tt> are 
+    # available at http://www.npr.org/api/mappingCodes.php.
+    # 
+    # The results of these queries are returned as a List where List#list holds Item elements that represent the topics returned.  A query like
+    # <tt>all_topics = client.list(:id => '3002')</tt> will return all the topics NPR has.  <tt>some_topic = all_topics.list[3]</tt> is an Item
+    # representing a topic. Later, this <tt>some_topic</tt> object can be used to generate queries with Client#query: 
+    # <tt>story_results = client.query(:id => some_topic, :num_results => 3)</tt>.
+    # 
+    # ==== Example
+    # <tt>client.list(:id => 3002)</tt>
+    # 
+    def list(options = {})
+      query(options.merge(:type => :list))
+    end
+  
+    private
+    def assemble_path(options = {})
+      return unless [:list, :query].include?(options[:type])
+      path = "/#{ options[:type].to_s }?#{ process_query_options(options) }"
+      path += "&format=#{ options[:format] }" if API_OUTPUT_FORMATS.include?(options[:format])
+      path += "&apiKey=#{ @api_key }"
+    end
+    
+    def npr_date(date)
+      date.strftime("%Y-%m-%d")
+    end
+    
+    def process_query_options(options = {})
+      return if options.empty?
+      query_string = ""
+      options.each do |key, value|
+        next unless API_INPUT_QUERY_OPTIONS.include?(key)
+        query_string += '&' unless query_string.empty?
+        query_string += case key
+                      when :id
+                        id_s = "id="
+                        id_s += if    value.kind_of?(Array): options[:id].join(',')
+                                elsif value.kind_of?(Item): value.id
+                                else  value.to_s
+                                end
+                      when :date && options[:date] == :current
+                        'date=current'
+                      when :start_date
+                        "startDate=#{ npr_date(value) }"
+                      when :end_date
+                        "endDate=#{ npr_date(value) }"
+                      when :org_id
+                        "orgId=#{ options[:org_id] }"
+                      when :search_term
+                        "searchTerm=#{ options[:search_term] }"
+                      when :search_type
+                        "searchType=#{ options[:search_type].to_s }"
+                      when :num_results
+                        "numResults=#{ value }"
+                      when :fields
+                        fields = "fields="
+                        fields += if   value.kind_of?(Array): options[:fields].join(',')
+                                  else value.to_s
+                                  end
+                      else "#{ key }=#{ value }"
+                      end
+                    end
+      query_string
+    end
+     
+    def process_client_errors(response)
+      error_result = Hpricot.XML(response).at("message[@level='error']") || Hpricot.XML(response).at("errorResponse[@error='true']")
+      return if error_result.nil?
+      
+      error_msg = if error_result.at('text')
+                    error_result.at('text').html
+                  elsif error_result.at('message')
+                    error_result.at('message').html
+                  end
+      
+      case error_result[:id]
+      when NPRException::SYSTEM_ISSUES
+        raise NPRSystemIssues.new(error_result[:id], error_msg)
+      when NPRException::INVALID_API_KEY
+        raise InvalidAPIKey.new(error_result[:id], error_msg)
+      when NPRException::DEACTIVATED_API_KEY
+        raise DeactivatedAPIKey.new(error_result[:id], error_msg)
+      when nil && error_msg == 'The requested list could not be found.'
+        raise InvalidList.new(nil, error_msg)
+      end
+    end
+    
+    def process_result_warnings(warning_results)
+      return if warning_results.empty?
+      @warnings = warning_results.collect { |warning| Warning.new(warning[:id], warning.at('text').html, warning) }
+    end
+    
+    def request(path)
+      connection = Net::HTTP.new(API_HOST)
+      headers, response = connection.get(path)
+        
+      process_client_errors(response)
+      process_result_warnings(Hpricot.XML(response).search("message[@level='warning']"))
+        
+      @results = NPR::ResultParser.new.parse(response)
+    end
+  end
+end

data/lib/rubynpr/content.rb

@@ -0,0 +1,17 @@
+module NPR
+  # Content is the parent of all the content returned from an NPR query. Mainly in place
+  # to assist later in dealing with content returned using different formats.  The intention
+  # is to have it become the starting point (obviously with the presence of initialize) for
+  # dealing with NPR results in such a way that if somebody was previously dealing with raw
+  # JSON for instance, they could throw it over to this and it would return Ruby objects to work
+  # with. 'tis forthcoming.
+  # 
+  class Content
+    def initialize(markup, format = :nprml)
+      case format
+      when :nprml
+        new_from_nprml(markup)
+      end
+    end
+  end
+end

data/lib/rubynpr/exception.rb

@@ -0,0 +1,34 @@
+module NPR
+  class NPRException < StandardError
+    SYSTEM_ISSUES = '101'
+    INVALID_API_KEY = '310'
+    DEACTIVATED_API_KEY = '311' 
+    
+    attr_accessor :code, :message
+    
+    def initialize(code, message)
+      @code, @message = code, message
+    end
+    
+    def to_s
+      "#{ @code }: #{ @message }"
+    end
+  end
+  
+  # Raised when NPR is experiencing issues
+  class NPRSystemIssues < NPRException; end
+  
+  # Raised when the API key passed in with the request is invalid
+  class InvalidAPIKey < NPRException; end
+  
+  # Raised when the API key passed in with the request has been deactivated
+  class DeactivatedAPIKey < NPRException; end
+  
+  # Raised when a list is requested that doesn't exist
+  class InvalidList < NPRException; end
+  
+  # Raised when query is not formed with the proper options, i.e. a missing <tt>:id</tt>, etc.
+  class InvalidQueryOptions < NPRException; end
+end
+  
+  

data/lib/rubynpr/image.rb

@@ -0,0 +1,34 @@
+module NPR
+  # Some NPR stories include images.  Images have as attributes:
+  # 
+  # * <tt>id<tt> - a unique NPR identifier
+  # * <tt>type</tt> - TBD
+  # * <tt>caption</tt>
+  # * <tt>width</tt> - the width of the image in pixels
+  # * <tt>src</tt> - the source URL for the image
+  # * <tt>border</tt> - indicates if an image has a border
+  # * <tt>title</tt>
+  # * <tt>link</tt> - the URL to which the image links
+  # * <tt>producer</tt> - source who will receive credit for the image
+  # * <tt>provider</tt> - the owner or provider of the image, which may be independent of the producer
+  # * <tt>copyright</tt> - copyright year
+  # 
+  class Image < Content
+    attr_accessor :id, :type, :width, :src, :border, :title, :link, :producer,
+                  :copyright, :caption, :provider
+    
+    alias_method :source, :src
+    
+    private
+    def new_from_nprml(image_nprml)
+      @id, @type = image_nprml[:id], image_nprml[:type]
+      @title = image_nprml.at('title').html
+      @src = image_nprml[:src]
+      @caption = image_nprml.at('caption').html
+      @producer = image_nprml.at('producer').html
+      @copyright = image_nprml.at('copyright').html
+      @border = image_nprml[:hasBorder]
+      @link = image_nprml.at('link')[:url]
+    end
+  end
+end

data/lib/rubynpr/item.rb

@@ -0,0 +1,25 @@
+module NPR
+  # Topics accessed via the API are packaged as items with the following attributes:
+  # 
+  # * <tt>id</tt> - the topic ID
+  # * <tt>number</tt> - item number
+  # * <tt>type</tt> - what kind of content the topic represents, i.e. biography, a column, etc.
+  # * <tt>slug</tt> - short item descriptor
+  # * <tt>additional_info</tt> - extra info/summary about the target
+  # * <tt>title</tt> - the name of the topic
+  # 
+  class Item < Content
+    attr_accessor :id, :number, :type, :slug, :additional_info, :title, :slug
+    
+    alias_method :info, :additional_info
+    
+    private
+    def new_from_nprml(item_nprml)
+      @id, @number = item_nprml[:id], item_nprml[:num]
+      @type = item_nprml[:type]
+      @slug = item_nprml.at('slug').html
+      @title = item_nprml.at('title').html
+      @additional_info = item_nprml.at('additionalInfo').html.strip
+    end
+  end
+end

data/lib/rubynpr/list.rb

@@ -0,0 +1,47 @@
+module NPR
+  class TopicList < Content
+    attr_accessor :id, :type_id, :title, :list, :has_subcategories, :subcategories
+    
+    private
+    def new_from_nprml(list_nprml)
+      @title = list_nprml.at('title').html
+      @id, @type_id = list_nprml[:id], list_nprml[:typeid]
+      
+      if list_nprml.search('subcategory').empty?
+        @has_subcategories = false
+        @list = NPR.process_elements('item', list_nprml)
+      else
+        @has_subcategories = true
+        @subcategories = NPR.process_elements('subcategory', list_nprml)
+      end
+    end
+  end
+  
+  # StoryList contains a listing of all the stories returned for a particular query performed through either
+  # NPR::Client#query or NPR::Client#list.
+  class StoryList < Content
+    attr_accessor :id, :title, :list, :teaser, :mini_teaser
+    
+    def stories
+      @list
+    end
+    
+    private
+    def new_from_nprml(story_list_nprml)
+      @title = story_list_nprml.at('title').html
+      @teaser = Hpricot.XML(story_list_nprml.at('teaser').html).innerText
+      @mini_teaser = Hpricot.XML(story_list_nprml.at('miniTeaser').html).innerText
+      @list = NPR.process_elements('story', story_list_nprml)
+    end
+  end
+  
+  # I REALLY want to move this into Content.
+  def self.process_elements(element, nprml)
+    return nil if !['story', 'item', 'subcategory'].include?(element)
+    list = []
+    nprml.search(element).each do |e|
+      list << NPR.const_get(element.capitalize).new(e)
+    end
+    list
+  end
+end

data/lib/rubynpr/message.rb

@@ -0,0 +1,15 @@
+module NPR
+  class Message
+    attr_accessor :body, :message_id, :raw_message
+    
+    def initialize(message_id, body, raw_message)
+      @body, @message_id, @raw_message = body, message_id, raw_message
+    end
+    
+    def to_s
+      "#{ self.class } (#{ message_id }): #{ @body }"
+    end
+  end
+  
+  class Warning < Message; end
+end

data/lib/rubynpr/organization.rb

@@ -0,0 +1,22 @@
+module NPR
+  # Organization represents an owner organization of a story.  Includes:
+  # 
+  # * <tt>id</tt> - unique ID of the organization to which a story belongs
+  # * <tt>name</tt> - the name of the organization
+  # * <tt>website</tt> - URL for the organization's website
+  # * <tt>abbr</tt> - an organization's NPR abbreviation
+  # 
+  # ==== Example
+  # <tt>some_story.organization.name</tt>
+  # 
+  class Organization < Content
+    attr_accessor :id, :name, :website, :abbr
+    
+    private
+    def new_from_nprml(org_nprml)
+      return nil if org_nprml.nil?
+      @id, @name = org_nprml[:orgId], org_nprml.at('name').html
+      @website, @abbr = org_nprml.at('website').html, org_nprml[:orgAbbr]
+    end
+  end
+end

data/lib/rubynpr/parent.rb

@@ -0,0 +1,24 @@
+
+module NPR
+  # Parent represents the parent topics to which a story belongs.  Parents have:
+  # 
+  # * <tt>id</tt> - a unique NPR ID for the Parent
+  # * <tt>title</tt> - the title of the parent topic
+  # * <tt>link</tt> - a hash containing the API URI for a parent and the normal web URI
+  # * <tt>type</tt> - usually a topic, series, or column
+  # 
+  class Parent < Content
+    attr_accessor :id, :type, :title, :link
+  
+    private
+    def new_from_nprml(parent_nprml)
+      return nil if parent_nprml.empty?  
+      @id, @type = parent_nprml[:id], parent_nprml[:type]
+      @title = parent_nprml.at('title').html
+      
+      link_nprml = parent_nprml.search('link')
+      @link = {  :html => link_nprml[0].html,
+                 :api  => link_nprml[1].html }
+    end
+  end
+end

data/lib/rubynpr/product.rb

@@ -0,0 +1,32 @@
+module NPR
+  # Product represents any products associated with a Story. A lot of stories have
+  # books attached as products.  Product isn't officially documented in the NPR API 
+  # documentation, thus the comments here are based on observations. Products have the 
+  # following attributes:
+  # 
+  # * <tt>id</tt> - the unique ID for the Product within NPR
+  # * <tt>type</tt> - what kind of Product this is, i.e., book, etc
+  # * <tt>author</tt> - a book's author
+  # * <tt>upc</tt> - the UPC code for a Product
+  # * <tt>publisher</tt> - the publisher of a book
+  # * <tt>year</tt> - the year the book or Product was introduced/published
+  # * <tt>link</tt> - a hash linking to the product for sale on a vendor's website. Use <tt>link[:uri]</tt>
+  #  to access the URI for the product and <tt>link[:vendor]</tt> to access the vendor.
+  # 
+  class Product < Content
+    attr_accessor :id, :type, :title, :author, :upc, :publisher, :year, :link
+    
+    private
+    def new_from_nprml(product_nprml)
+      @id = product_nprml[:id]
+      @type = product_nprml[:type]
+      @title = product_nprml.at('title').html
+      @author = product_nprml.at('author').html
+      @publisher = product_nprml.at('publisher').html
+      @year = product_nprml.at('publishYear').html
+      @upc = product_nprml.at('upc').html
+      @link = { :vendor => product_nprml.at('purchaseLink')[:vendor],
+                :uri    => product_nprml.at('purchaseLink').html }
+    end
+  end
+end

data/lib/rubynpr/pull_quote.rb

@@ -0,0 +1,12 @@
+module NPR
+  class PullQuote < Content
+    attr_accessor :id, :text, :person, :date
+    
+    private
+    def new_from_nprml(pullquote_nprml)
+      return nil if pullquote_nprml.empty?
+      @id, @person = pullquote_nprml[:id], pullquote_nprml.at('person').html
+      @text = Hpricot.XML(pullquote_nprml.at('text').html).innerText
+    end
+  end
+end