feedtools 0.2.10 → 0.2.11

data/CHANGELOG

@@ -1,3 +1,11 @@
+== FeedTools 0.2.11
+ * ruby -w shouldn't produce nearly as many warnings for feed_tools.rb anymore
+ * you can now force the open method to only pull from the cache
+ * the global cache_only option has been removed
+ * nows queries the cache after each redirection
+ * attribute dictionary stuff removed for being unnecessary and pythonic
+ * better file structure -- no more 5000 line files
+ * schema files are formatted better to keep them from looking wierd in rdoc
 == FeedTools 0.2.10
  * http error messages now sport a list of redirections to simplify debugging
  * automatic table creation removed

data/db/schema.mysql.sql

@@ -1,10 +1,11 @@
-CREATE TABLE `feeds` (
-  `id`              int(10) unsigned NOT NULL auto_increment,
-  `url`             varchar(255) default NULL,
-  `title`           varchar(255) default NULL,
-  `link`            varchar(255) default NULL,
-  `xml_data`        longtext default NULL,
-  `http_headers`    text default NULL,
-  `last_retrieved`  datetime default NULL,
-  PRIMARY KEY  (`id`)
-)
+-- Example MySQL schema
+  CREATE TABLE `feeds` (
+    `id`              int(10) unsigned NOT NULL auto_increment,
+    `url`             varchar(255) default NULL,
+    `title`           varchar(255) default NULL,
+    `link`            varchar(255) default NULL,
+    `xml_data`        longtext default NULL,
+    `http_headers`    text default NULL,
+    `last_retrieved`  datetime default NULL,
+    PRIMARY KEY  (`id`)
+  )

data/db/schema.postgresql.sql

@@ -1,9 +1,10 @@
-CREATE TABLE feeds (
-  id                SERIAL PRIMARY KEY NOT NULL,
-  url               varchar(255) default NULL,
-  title             varchar(255) default NULL,
-  link              varchar(255) default NULL,
-  xml_data          text default NULL,
-  http_headers      text default NULL,
-  last_retrieved    timestamp default NULL
-);
+-- Example PostgreSQL schema
+  CREATE TABLE feeds (
+    id                SERIAL PRIMARY KEY NOT NULL,
+    url               varchar(255) default NULL,
+    title             varchar(255) default NULL,
+    link              varchar(255) default NULL,
+    xml_data          text default NULL,
+    http_headers      text default NULL,
+    last_retrieved    timestamp default NULL
+  );

data/db/schema.sqlite.sql

@@ -1,9 +1,10 @@
-CREATE TABLE 'feeds' (
-  'id'              INTEGER PRIMARY KEY NOT NULL,
-  'url'             VARCHAR(255) DEFAULT NULL,
-  'title'           VARCHAR(255) DEFAULT NULL,
-  'link'            VARCHAR(255) DEFAULT NULL,
-  'xml_data'        TEXT DEFAULT NULL,
-  'http_headers'    TEXT DEFAULT NULL,
-  'last_retrieved'  DATETIME DEFAULT NULL
-);
+-- Example Sqlite schema
+  CREATE TABLE feeds (
+    id                INTEGER PRIMARY KEY NOT NULL,
+    url               VARCHAR(255) DEFAULT NULL,
+    title             VARCHAR(255) DEFAULT NULL,
+    link              VARCHAR(255) DEFAULT NULL,
+    xml_data          TEXT DEFAULT NULL,
+    http_headers      TEXT DEFAULT NULL,
+    last_retrieved    DATETIME DEFAULT NULL
+  );

data/lib/feed_tools.rb

@@ -32,7 +32,7 @@ FEED_TOOLS_ENV = ENV['FEED_TOOLS_ENV'] ||
                  ENV['RAILS_ENV'] ||
                  'production' # :nodoc:
 
-FEED_TOOLS_VERSION = "0.2.10"
+FEED_TOOLS_VERSION = "0.2.11"
 
 $:.unshift(File.dirname(__FILE__))
 $:.unshift(File.dirname(__FILE__) + "/feed_tools/vendor")
@@ -77,7 +77,9 @@ require 'yaml'
 require_gem('activerecord', '>= 1.10.1')
 require_gem('uuidtools', '>= 0.1.2')
 
-require 'database_feed_cache'
+require 'feed_tools/feed'
+require 'feed_tools/feed_item'
+require 'feed_tools/database_feed_cache'
 
 #= feed_tools.rb
 #
@@ -96,99 +98,17 @@ require 'database_feed_cache'
 #  => "43,37,28,23,11,3,1"
 module FeedTools
   
-  # Error raised when a feed cannot be retrieved    
-  class FeedAccessError < StandardError
-  end
-
-  # Quick method of enabling small classes to have their attributes
-  # accessible as a dictionary.  These methods should not be used whenever
-  # performance is going to be an issue.  They exist almost entirely for the
-  # purposes of aesthetics and/or debugging.
-  module AttributeDictionary
-    # Access the attributes as a dictionary.
-    def [](key)
-      return nil unless self.keys.include? key
-      return self.send(key)
-    end
-
-    # Access the attributes as a dictionary.
-    def []=(key, value)
-      pseudo_key = key
-      pseudo_key = key[0..-2] if key[-1..-1] == "?"
-      return nil unless self.method(pseudo_key + "=").arity == 1
-      local_keys = self.keys
-      unless local_keys.include?(key) || local_keys.include?(pseudo_key)
-        return nil
-      end
-      return self.send(pseudo_key + "=", value)      
-    end
-    
-    # Access the attributes as a dictionary.
-    def keys
-      key_methods = []
-      for key in self.methods
-        # Quick-n-dirty hack to speed things up and keep the list clean
-        if self.method(key).arity == 0 && key[-1..-1] != "=" &&
-            key[-1..-1] != "!" && key[0..1] != "__" &&
-            key[0..2] != "to_" && key[-5..-1] != "_node" &&
-            key != "cache_object" && key != "save" && key != "xml" &&
-            key != "xml_data" && key != "expired?" && key != "live?" &&
-            key != "feed"
-          superfluous_ancestors = self.class.ancestors
-          superfluous_ancestors = superfluous_ancestors[1..-1]
-          superfluous = false
-          for ancestor in superfluous_ancestors
-            if ancestor.instance_methods.include? key
-              superfluous = true
-              break              
-            end
-          end
-          next if superfluous
-          key_methods << key
-        end
-      end
-      return key_methods.sort
-    end
-    
-    # Access the attributes as a dictionary.
-    # Please note that this method may cause a nearly complete parse of a
-    # feed.  This will be very slow.
-    def values
-      return self.keys.map { |key| self[key] }
-    end
-    
-    # Access the attributes as a dictionary.
-    # Please note that this method may cause a complete parse of a feed.
-    # This will be very slow.
-    def to_hash
-      attribute_hash = {}
-      for key in keys
-        value = self[key]
-        if value.respond_to? :to_hash
-          value = value.to_hash
-        end
-        if value.respond_to? :to_ary
-          new_value = []
-          for item in value.to_ary
-            if item.respond_to? :to_hash
-              new_value << item.to_hash
-            else
-              new_value << item
-            end
-          end
-          value = new_value
-        end
-        attribute_hash[key] = value
-      end
-      return attribute_hash
-    end
-  end
-
+  @force_tidy_enabled = true
+  @tidy_enabled = false
   @feed_cache = DatabaseFeedCache
   @user_agent = "FeedTools/#{FEED_TOOLS_VERSION} " + 
     "+http://www.sporkmonger.com/projects/feedtools/"
   @no_content_string = "[no description]"
   
+  # Error raised when a feed cannot be retrieved    
+  class FeedAccessError < StandardError
+  end
+  
   # Returns the current caching mechanism.
   def FeedTools.feed_cache
     return @feed_cache
@@ -222,23 +142,7 @@ module FeedTools
     # ==================================================================
     @feed_cache = new_feed_cache
   end
-  
-  # Returns true if FeedTools should only retrieve from the cache and avoid
-  # pulling feeds from their remote location.
-  def FeedTools.cache_only?
-    @cache_only = false if @cache_only.nil?
-    return @cache_only
-  end
-  
-  # Sets whether or not FeedTools should retrieve feeds from remote locations
-  # or if it should rely on the cache only.
-  def FeedTools.cache_only=(new_cache_only)
-    if new_cache_only != true && new_cache_only != false
-      raise ArgumentError, "Must be either true or false."
-    end
-    @cache_only = new_cache_only
-  end
-  
+    
   # Returns true if FeedTools.feed_cache is not nil and a connection with
   # the cache has been successfully established.  Also returns false if an
   # error is raised while trying to determine the status of the cache.
@@ -649,3651 +553,6 @@ module FeedTools
     end
     return merged_feed
   end
-
-  class Feed
-    include REXML # :nodoc:
-    include AttributeDictionary
-    
-    # Represents a feed/feed item's category
-    class Category
-      include AttributeDictionary
-      
-      # The category term value
-      attr_accessor :term
-      # The categorization scheme
-      attr_accessor :scheme
-      # A human-readable description of the category
-      attr_accessor :label
-      
-      alias_method :value, :term
-      alias_method :category, :term
-      alias_method :domain, :scheme
-    end
-    
-    # Represents a feed/feed item's author
-    class Author
-      include AttributeDictionary
-
-      # The author's real name
-      attr_accessor :name
-      # The author's email address
-      attr_accessor :email
-      # The url of the author's homepage
-      attr_accessor :url
-      # The raw value of the author tag if present
-      attr_accessor :raw
-    end
-    
-    # Represents a feed's image
-    class Image
-      include AttributeDictionary
-
-      # The image's title
-      attr_accessor :title
-      # The image's description
-      attr_accessor :description
-      # The image's url
-      attr_accessor :url
-      # The url to link the image to
-      attr_accessor :link
-      # The width of the image
-      attr_accessor :width
-      # The height of the image
-      attr_accessor :height
-      # The style of the image
-      # Possible values are "icon", "image", or "image-wide"
-      attr_accessor :style
-    end
-
-    # Represents a feed's text input element.
-    # Be aware that this will be ignored for feed generation.  It's a
-    # pointless element that aggregators usually ignore and it doesn't have an
-    # equivalent in all feeds types.
-    class TextInput
-      include AttributeDictionary
-
-      # The label of the Submit button in the text input area.
-      attr_accessor :title
-      # The description explains the text input area.
-      attr_accessor :description
-      # The URL of the CGI script that processes text input requests.
-      attr_accessor :link
-      # The name of the text object in the text input area.
-      attr_accessor :name
-    end
-    
-    # Represents a feed's cloud.
-    # Be aware that this will be ignored for feed generation.
-    class Cloud
-      include AttributeDictionary
-
-      # The domain of the cloud.
-      attr_accessor :domain
-      # The path for the cloud.
-      attr_accessor :path
-      # The port the cloud is listening on.
-      attr_accessor :port
-      # The web services protocol the cloud uses.
-      # Possible values are either "xml-rpc" or "soap".
-      attr_accessor :protocol
-      # The procedure to use to request notification.
-      attr_accessor :register_procedure
-    end
-    
-    # Represents a simple hyperlink
-    class Link
-      include AttributeDictionary
-
-      # The url that is being linked to
-      attr_accessor :url
-      # The content of the hyperlink
-      attr_accessor :value
-      
-      alias_method :href, :url
-    end
-    
-    # Loads the feed specified by the url, pulling the data from the cache if it hasn't expired.
-    def Feed.open(url)
-      # clean up the url
-      url = FeedTools.normalize_url(url)
-
-      # create and load the new feed
-      feed = Feed.new
-      feed.url = url
-      feed.update!
-      return feed
-    end
-
-    # Loads the feed from the remote url if the feed has expired from the cache or cannot be
-    # retrieved from the cache for some reason.
-    def update!
-      if self.http_headers.nil? && !(self.cache_object.nil?) &&
-          !(self.cache_object.http_headers.nil?)
-        @http_headers = YAML.load(self.cache_object.http_headers)
-        @http_headers = {} unless @http_headers.kind_of? Hash
-      end
-      if FeedTools.cache_only? || self.expired? == false
-        @live = false
-      else
-        load_remote_feed!
-      end
-    end
-    
-    # Attempts to load the feed from the remote location.  Requires the url
-    # field to be set.  If an etag or the last_modified date has been set,
-    # attempts to use them to prevent unnecessary reloading of identical
-    # content.
-    def load_remote_feed!
-      @live = true
-      if self.http_headers.nil? && !(self.cache_object.nil?) &&
-          !(self.cache_object.http_headers.nil?)
-        @http_headers = YAML.load(self.cache_object.http_headers)
-      end
-      
-      if (self.url =~ /^feed:/) == 0
-        # Woah, Nelly, how'd that happen?  You should've already been
-        # corrected.  So let's fix that url.  And please,
-        # just use less crappy browsers instead of badly defined
-        # pseudo-protocol hacks.
-        self.url = FeedTools.normalize_url(self.url)
-      end
-      
-      # Find out what method we're going to be using to obtain this feed.
-      uri = URI.parse(self.url)
-      retrieval_method = "http"
-      case uri.scheme
-      when "http"
-        retrieval_method = "http"
-      when "ftp"
-        retrieval_method = "ftp"
-      when "file"
-        retrieval_method = "file"
-      when nil
-        raise FeedAccessError,
-          "No protocol was specified in the url."
-      else
-        raise FeedAccessError,
-          "Cannot retrieve feed using unrecognized protocol: " + uri.scheme
-      end
-      
-      # No need for http headers unless we're actually doing http
-      if retrieval_method == "http"
-        # Set up the appropriate http headers
-        headers = {}
-        unless self.http_headers.nil?
-          headers["If-None-Match"] =
-            self.http_headers['etag'] unless self.http_headers['etag'].nil?
-          headers["If-Modified-Since"] =
-            self.http_headers['last-modified'] unless
-            self.http_headers['last-modified'].nil?
-        end
-        headers["User-Agent"] =
-          FeedTools.user_agent unless FeedTools.user_agent.nil?
-
-        # The http feed access method
-        http_fetch = lambda do |feed_url, http_headers, redirect_limit,
-            response_chain, no_headers|
-          raise FeedAccessError, 'Redirect too deep' if redirect_limit == 0
-          feed_uri = nil
-          begin
-            feed_uri = URI.parse(feed_url)
-          rescue URI::InvalidURIError
-            # Uh, maybe try to fix it?
-            feed_uri = URI.parse(FeedTools.normalize_url(feed_url))
-          end
-
-          # Borrowed from open-uri:
-          # According to RFC2616 14.23, Host: request-header field should be
-          # set to an origin server.
-          # But net/http wrongly set a proxy server if an absolute URI is
-          # specified as a request URI.
-          # So override it here explicitly.
-          http_headers['Host'] = feed_uri.host
-          http_headers['Host'] += ":#{feed_uri.port}" if feed_uri.port
-          
-          Net::HTTP.start(feed_uri.host, (feed_uri.port or 80)) do |http|
-            final_uri = feed_uri.path 
-            final_uri += ('?' + feed_uri.query) if feed_uri.query
-            http_headers = {} if no_headers
-            response = http.request_get(final_uri, http_headers)
-
-            case response
-            when Net::HTTPSuccess
-              # We've reached the final destination, process all previous
-              # redirections, and see if we need to update the url.
-              for redirected_response in response_chain
-                if redirected_response.last.code.to_i == 301
-                  # Reset the cache object or we may get duplicate entries
-                  self.cache_object = nil
-                  self.url = redirected_response.last['location']
-                else
-                  # Jump out as soon as we hit anything that isn't a
-                  # permanently moved redirection.
-                  break
-                end
-              end
-              response
-            when Net::HTTPRedirection
-              if response.code.to_i == 304
-                response.error!
-              else
-                if response['location'].nil?
-                  raise FeedAccessError,
-                    "No location to redirect to supplied: " + response.code
-                end
-                response_chain << [feed_url, response]
-                new_location = response['location']
-                if response_chain.assoc(new_location) != nil
-                  raise FeedAccessError, "Redirection loop detected."
-                end
-                # TODO: deal with stupid people using relative urls
-                # in Location header
-                # =================================================
-                http_fetch.call(new_location, http_headers,
-                  redirect_limit - 1, response_chain, no_headers)
-              end
-            else
-              class << response
-                def response_chain
-                  return @response_chain
-                end
-              end
-              response.instance_variable_set("@response_chain",
-                response_chain)
-              response.error!
-            end
-          end
-        end
-        
-        begin
-          begin
-            @http_response = http_fetch.call(self.url, headers, 10, [], false)
-          rescue => error
-            if error.respond_to?(:response)
-              # You might not believe this, but...
-              #
-              # Under certain circumstances, web servers will try to block
-              # based on the User-Agent header.  This is *retarded*.  But
-              # we won't let their stupid error stop us!
-              #
-              # This is, of course, a quick-n-dirty hack.  But at least
-              # we get to blame other people's bad software and/or bad
-              # configuration files.
-              if error.response.code.to_i == 404 &&
-                  FeedTools.user_agent != nil
-                @http_response = http_fetch.call(self.url, {}, 10, [], true)
-                if @http_response != nil && @http_response.code.to_i == 200
-                  warn("The server appears to be blocking based on the " +
-                    "User-Agent header.  This is stupid, and you should " +
-                    "inform the webmaster of this.")
-                end
-              else
-                raise error
-              end
-            else
-              raise error
-            end
-          end
-          @http_headers = {}
-          self.http_response.each_header do |header|
-            self.http_headers[header.first.downcase] = header.last
-          end
-          self.last_retrieved = Time.now
-          self.xml_data = self.http_response.body
-        rescue FeedAccessError
-          @live = false
-          if self.xml_data.nil?
-            raise
-          end
-        rescue Timeout::Error
-          # if we time out, do nothing, it should fall back to the xml_data
-          # stored in the cache.
-          @live = false
-          if self.xml_data.nil?
-            raise
-          end
-        rescue Errno::ECONNRESET
-          # if the connection gets reset by peer, oh well, fall back to the
-          # xml_data stored in the cache
-          @live = false
-          if self.xml_data.nil?
-            raise
-          end
-        rescue => error
-          # heck, if anything at all bad happens, fall back to the xml_data
-          # stored in the cache.
-          
-          # If we can, get the HTTPResponse...
-          @http_response = nil
-          if error.respond_to?(:each_header)
-            @http_response = error
-          end
-          if error.respond_to?(:response) &&
-              error.response.respond_to?(:each_header)
-            @http_response = error.response
-          end
-          if @http_response != nil
-            @http_headers = {}
-            self.http_response.each_header do |header|
-              self.http_headers[header.first] = header.last
-            end
-            if self.http_response.code.to_i == 304
-              self.last_retrieved = Time.now
-            end
-          end
-          @live = false
-          if self.xml_data.nil?
-            if error.respond_to?(:response) &&
-                error.response.respond_to?(:response_chain)
-              redirects = error.response.response_chain.map do |pair|
-                pair.first
-              end
-              error.message << (" - Redirects: " + redirects.inspect)
-            end
-            raise error
-          end
-        end
-      elsif retrieval_method == "https"
-        # Not supported... yet
-      elsif retrieval_method == "ftp"
-        # Not supported... yet
-        # Technically, CDF feeds are supposed to be able to be accessed directly
-        # from an ftp server.  This is silly, but we'll humor Microsoft.
-        #
-        # Eventually.
-      elsif retrieval_method == "file"
-        # Now that we've gone to all that trouble to ensure the url begins
-        # with 'file://', strip the 'file://' off the front of the url.
-        file_name = self.url.gsub(/^file:\/\//, "")
-        begin
-          open(file_name) do |file|
-            @http_response = nil
-            @http_headers = {}
-            self.last_retrieved = Time.now
-            self.xml_data = file.read
-          end
-        rescue
-          @live = false
-          # In this case, pulling from the cache is probably not going
-          # to help at all, and the use should probably be immediately
-          # appraised of the problem.  Raise the exception.
-          raise
-        end
-      end
-      unless self.cache_object.nil?
-        begin
-          self.save
-        rescue
-        end
-      end
-    end
-        
-    # Returns the relevant information from an http request.
-    def http_response
-      return @http_response
-    end
-
-    # Returns a hash of the http headers from the response.
-    def http_headers
-      return @http_headers
-    end
-    
-    # Returns the feed's raw xml data.
-    def xml_data
-      if @xml_data.nil?
-        unless self.cache_object.nil?
-          @xml_data = self.cache_object.xml_data
-        end
-      end
-      return @xml_data
-    end
-    
-    # Sets the feed's xml data.
-    def xml_data=(new_xml_data)
-      @xml_data = new_xml_data
-      unless self.cache_object.nil?
-        self.cache_object.xml_data = new_xml_data
-      end
-    end
-    
-    # Returns a REXML Document of the xml_data
-    def xml
-      if @xml_doc.nil?
-        begin
-          # TODO: :ignore_whitespace_nodes => :all
-          # Add that?
-          # ======================================
-          @xml_doc = Document.new(xml_data)
-        rescue
-          # Something failed, attempt to repair the xml with htree.
-          @xml_doc = HTree.parse(xml_data).to_rexml
-        end
-      end
-      return @xml_doc
-    end
-    
-    # Returns the first node within the channel_node that matches the xpath query.
-    def find_node(xpath)
-      return XPath.first(channel_node, xpath)
-    end
-    
-    # Returns all nodes within the channel_node that match the xpath query.
-    def find_all_nodes(xpath)
-      return XPath.match(channel_node, xpath)
-    end
-    
-    # Returns the root node of the feed.
-    def root_node
-      if @root_node.nil?
-        # TODO: Fix this so that added content at the end of the file doesn't
-        # break this stuff.
-        # E.g.: http://smogzer.tripod.com/smog.rdf
-        # ===================================================================
-        @root_node = xml.root
-      end
-      return @root_node
-    end
-    
-    # Returns the channel node of the feed.
-    def channel_node
-      if @channel_node.nil? && root_node != nil
-        @channel_node = XPath.first(root_node, "channel")
-        if @channel_node == nil
-          @channel_node = XPath.first(root_node, "CHANNEL")
-        end
-        if @channel_node == nil
-          @channel_node = XPath.first(root_node, "feedinfo")
-        end
-        if @channel_node == nil
-          @channel_node = root_node
-        end
-      end
-      return @channel_node
-    end
-    
-    # The cache object that handles the feed persistence.
-    def cache_object
-      unless FeedTools.feed_cache.nil?
-        if @cache_object.nil?
-          begin
-            if @id != nil
-              @cache_object = FeedTools.feed_cache.find_by_id(@id)
-            elsif @url != nil
-              @cache_object = FeedTools.feed_cache.find_by_url(@url)
-            end
-            if @cache_object.nil?
-              @cache_object = FeedTools.feed_cache.new
-            end
-          rescue
-          end      
-        end
-      end
-      return @cache_object
-    end
-    
-    # Sets the cache object for this feed.
-    #
-    # This can be any object, but it must accept the following messages:
-    # url
-    # url=
-    # title
-    # title=
-    # link
-    # link=
-    # xml_data
-    # xml_data=
-    # etag
-    # etag=
-    # last_modified
-    # last_modified=
-    # save
-    def cache_object=(new_cache_object)
-      @cache_object = new_cache_object
-    end
-    
-    # Returns the type of feed
-    # Possible values:
-    # "rss", "atom", "cdf", "!okay/news"
-    def feed_type
-      if @feed_type.nil?
-        case self.root_node.name.downcase
-        when "feed"
-          @feed_type = "atom"
-        when "rdf:rdf"
-          @feed_type = "rss"
-        when "rdf"
-          @feed_type = "rss"
-        when "rss"
-          @feed_type = "rss"
-        when "channel"
-          @feed_type = "cdf"
-        end
-      end
-      return @feed_type
-    end
-    
-    # Sets the default feed type
-    def feed_type=(new_feed_type)
-      @feed_type = new_feed_type
-    end
-    
-    # Returns the version number of the feed type.
-    # Intentionally does not differentiate between the Netscape and Userland
-    # versions of RSS 0.91.
-    def feed_version
-      if @feed_version.nil?
-        version = nil
-        begin
-          version = XPath.first(root_node, "@version").to_s.strip.to_f
-        rescue
-        end
-        version = nil if version == 0.0
-        default_namespace = XPath.first(root_node, "@xmlns").to_s.strip
-        case self.feed_type
-        when "atom"
-          if default_namespace == "http://www.w3.org/2005/Atom"
-            @feed_version = 1.0
-          elsif version != nil
-            @feed_version = version
-          elsif default_namespace == "http://purl.org/atom/ns#"
-            @feed_version = 0.3
-          end
-        when "rss"
-          if default_namespace == "http://my.netscape.com/rdf/simple/0.9/"
-            @feed_version = 0.9
-          elsif default_namespace == "http://purl.org/rss/1.0/"
-            @feed_version = 1.0
-          elsif default_namespace == "http://purl.org/net/rss1.1#"
-            @feed_version = 1.1
-          elsif version != nil
-            case version
-            when 2.1
-              @feed_version = 2.0
-            when 2.01
-              @feed_version = 2.0
-            else
-              @feed_version = version
-            end
-          end
-        when "cdf"
-          @feed_version = 0.4
-        when "!okay/news"
-          @feed_version = nil
-        end
-      end
-      return @feed_version
-    end
-
-    # Sets the default feed version
-    def feed_version=(new_feed_version)
-      @feed_version = new_feed_version
-    end
-
-    # Returns the feed's unique id
-    def id
-      if @id.nil?
-        unless channel_node.nil?
-          @id = XPath.first(channel_node, "id/text()").to_s
-          if @id == ""
-            @id = XPath.first(channel_node, "guid/text()").to_s
-          end
-        end
-        unless root_node.nil?
-          if @id == "" || @id.nil?
-            @id = XPath.first(root_node, "id/text()").to_s
-          end
-          if @id == ""
-            @id = XPath.first(root_node, "guid/text()").to_s
-          end
-        end
-        @id = nil if @id == ""
-      end
-      return @id
-    end
-    
-    # Sets the feed's unique id
-    def id=(new_id)
-      @id = new_id
-    end
-    
-    # Returns the feed url.
-    def url
-      if @url.nil? && self.xml_data != nil
-        @url = XPath.first(channel_node, "link[@rel='self']/@href").to_s
-        @url = nil if @url == ""
-      end
-      return @url
-    end
-    
-    # Sets the feed url and prepares the cache_object if necessary.
-    def url=(new_url)
-      @url = FeedTools.normalize_url(new_url)
-      self.cache_object.url = new_url unless self.cache_object.nil?
-    end
-    
-    # Returns the feed title
-    def title
-      if @title.nil?
-        unless channel_node.nil?
-          repair_entities = false
-          title_node = XPath.first(channel_node, "title")
-          if title_node.nil?
-            title_node = XPath.first(channel_node, "dc:title")
-          end
-          if title_node.nil?
-            title_node = XPath.first(channel_node, "TITLE")
-          end
-        end
-        if title_node.nil?
-          return nil
-        end
-        if XPath.first(title_node, "@type").to_s == "xhtml" || 
-            XPath.first(title_node, "@mode").to_s == "xhtml" ||
-            XPath.first(title_node, "@type").to_s == "xml" || 
-            XPath.first(title_node, "@mode").to_s == "xml" ||
-            XPath.first(title_node, "@type").to_s == "application/xhtml+xml"
-          @title = title_node.inner_xml
-        elsif XPath.first(title_node, "@type").to_s == "escaped" ||
-            XPath.first(title_node, "@mode").to_s == "escaped"
-          @title = FeedTools.unescape_entities(
-            XPath.first(title_node, "text()").to_s)
-        else
-          @title = title_node.inner_xml
-          repair_entities = true
-        end
-        unless @title.nil?
-          @title = FeedTools.sanitize_html(@title, :strip)
-          @title = FeedTools.unescape_entities(@title) if repair_entities
-          @title = FeedTools.tidy_html(@title)
-        end
-        @title.gsub!(/\n/, " ")
-        @title.strip!
-        @title = nil if @title == ""
-        self.cache_object.title = @title unless self.cache_object.nil?
-      end
-      return @title
-    end
-    
-    # Sets the feed title
-    def title=(new_title)
-      @title = new_title
-      self.cache_object.title = new_title unless self.cache_object.nil?
-    end
-
-    # Returns the feed description
-    def description
-      if @description.nil?
-        unless channel_node.nil?
-          repair_entities = false
-          description_node = XPath.first(channel_node, "description")
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "tagline")
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "subtitle")
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "summary")
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "abstract")
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "ABSTRACT")
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "info")
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "content:encoded")
-            @bozo = true unless description_node.nil?
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "content")
-            @bozo = true unless description_node.nil?
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "xhtml:body")
-            @bozo = true unless description_node.nil?
-          end
-          if description_node.nil?
-            description_node = XPath.first(channel_node, "body")
-            @bozo = true unless description_node.nil?
-          end
-        end
-        if description_node.nil?
-          return nil
-        end
-        unless description_node.nil?
-          if XPath.first(description_node, "@encoding").to_s != ""
-            @description =
-              "[Embedded data objects are not currently supported.]"
-          elsif XPath.first(description_node, "@type").to_s == "xhtml" || 
-              XPath.first(description_node, "@mode").to_s == "xhtml" ||
-              XPath.first(description_node, "@type").to_s == "xml" || 
-              XPath.first(description_node, "@mode").to_s == "xml" ||
-              XPath.first(description_node, "@type").to_s ==
-                "application/xhtml+xml"
-            @description = description_node.inner_xml
-          elsif XPath.first(description_node, "@type").to_s == "escaped" ||
-              XPath.first(description_node, "@mode").to_s == "escaped"
-            @description = FeedTools.unescape_entities(
-              description_node.inner_xml)
-          else
-            @description = description_node.inner_xml
-            repair_entities = true
-          end
-        end
-        if @description == ""
-          @description = self.itunes_summary
-          @description = "" if @description.nil?
-        end
-        if @description == ""
-          @description = self.itunes_subtitle
-          @description = "" if @description.nil?
-        end
-
-        unless @description.nil?
-          @description = FeedTools.sanitize_html(@description, :strip)
-          @description = FeedTools.unescape_entities(@description) if repair_entities
-          @description = FeedTools.tidy_html(@description)
-        end
-
-        @description = @description.strip unless @description.nil?
-        @description = nil if @description == ""
-      end
-      return @description
-    end
-
-    # Sets the feed description
-    def description=(new_description)
-      @description = new_description
-    end
-
-    # Returns the contents of the itunes:summary element
-    def itunes_summary
-      if @itunes_summary.nil?
-        unless channel_node.nil?
-          @itunes_summary = FeedTools.unescape_entities(XPath.first(channel_node,
-            "itunes:summary/text()").to_s)
-        end
-        unless root_node.nil?
-          if @itunes_summary == "" || @itunes_summary.nil?
-            @itunes_summary = FeedTools.unescape_entities(XPath.first(root_node,
-              "itunes:summary/text()").to_s)
-          end
-        end
-        if @itunes_summary == ""
-          @itunes_summary = nil
-        end
-        @itunes_summary =
-          FeedTools.sanitize_html(@itunes_summary) unless @itunes_summary.nil?
-      end
-      return @itunes_summary
-    end
-
-    # Sets the contents of the itunes:summary element
-    def itunes_summary=(new_itunes_summary)
-      @itunes_summary = new_itunes_summary
-    end
-
-    # Returns the contents of the itunes:subtitle element
-    def itunes_subtitle
-      if @itunes_subtitle.nil?
-        unless channel_node.nil?
-          @itunes_subtitle = FeedTools.unescape_entities(XPath.first(channel_node,
-            "itunes:subtitle/text()").to_s)
-        end
-        unless root_node.nil?
-          if @itunes_subtitle == "" || @itunes_subtitle.nil?
-            @itunes_subtitle = FeedTools.unescape_entities(XPath.first(root_node,
-              "itunes:subtitle/text()").to_s)
-          end
-        end
-        if @itunes_subtitle == ""
-          @itunes_subtitle = nil
-        end
-        unless @itunes_subtitle.nil?
-          @itunes_subtitle = FeedTools.sanitize_html(@itunes_subtitle)
-        end
-      end
-      return @itunes_subtitle
-    end
-
-    # Sets the contents of the itunes:subtitle element
-    def itunes_subtitle=(new_itunes_subtitle)
-      @itunes_subtitle = new_itunes_subtitle
-    end
-
-    # Returns the feed link
-    def link
-      if @link.nil?
-        unless channel_node.nil?
-          # get the feed link from the xml document
-          @link = XPath.first(channel_node, "link[@rel='alternate' @type='text/html']/@href").to_s
-          if @link == ""
-            @link = XPath.first(channel_node, "link[@rel='alternate']/@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(channel_node, "link/@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(channel_node, "link/text()").to_s
-          end
-          if @link == ""
-            @link = XPath.first(channel_node, "@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(channel_node, "@HREF").to_s
-          end
-          if @link == ""
-            @link = XPath.first(channel_node, "a/@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(channel_node, "A/@HREF").to_s
-          end
-        end
-        if @link == "" || @link.nil?
-          if FeedTools.is_uri? self.guid
-            @link = self.guid
-          end
-        end
-        if @link == "" && channel_node != nil
-          # Technically, we shouldn't use the base attribute for this, but if the href attribute
-          # is missing, it's already a given that we're looking at a messed up CDF file.  We can
-          # always pray it's correct.
-          @link = XPath.first(channel_node, "@base").to_s
-        end
-        @link = FeedTools.normalize_url(@link)
-        unless self.cache_object.nil?
-          self.cache_object.link = @link
-        end
-      end
-      return @link
-    end
-
-    # Sets the feed link
-    def link=(new_link)
-      @link = new_link
-      unless self.cache_object.nil?
-        self.cache_object.link = new_link
-      end
-    end
-
-    # Returns the url to the icon file for this feed.
-    #
-    # This method uses the url from the link field in order to avoid grabbing
-    # the favicon for services like feedburner.
-    def icon
-      if @icon.nil?
-        icon_node = XPath.first(channel_node, "link[@rel='icon']")
-        if icon_node.nil?
-          icon_node = XPath.first(channel_node, "link[@rel='shortcut icon']")
-        end
-        if icon_node.nil?
-          icon_node = XPath.first(channel_node, "link[@type='image/x-icon']")
-        end
-        if icon_node.nil?
-          icon_node = XPath.first(channel_node, "icon")
-        end
-        if icon_node.nil?
-          icon_node = XPath.first(channel_node, "logo[@style='icon']")
-        end
-        if icon_node.nil?
-          icon_node = XPath.first(channel_node, "LOGO[@STYLE='ICON']")
-        end
-        unless icon_node.nil?
-          @icon = FeedTools.unescape_entities(
-            XPath.first(icon_node, "@href").to_s)
-          if @icon == ""
-            @icon = FeedTools.unescape_entities(
-              XPath.first(icon_node, "text()").to_s)
-            unless FeedTools.is_uri? @icon
-              @icon = ""
-            end
-          end
-          if @icon == "" && self.link != nil && self.link != ""
-            link_uri = URI.parse(FeedTools.normalize_url(self.link))
-            @icon =
-              link_uri.scheme + "://" + link_uri.host + "/favicon.ico"
-          end
-          @icon = nil if @icon == ""
-        end
-      end
-      return @icon
-    end
-
-    # Returns the feed author
-    def author
-      if @author.nil?
-        @author = FeedTools::Feed::Author.new
-        unless channel_node.nil?
-          author_node = XPath.first(channel_node, "author")
-          if author_node.nil?
-            author_node = XPath.first(channel_node, "managingEditor")
-          end
-          if author_node.nil?
-            author_node = XPath.first(channel_node, "dc:author")
-          end
-          if author_node.nil?
-            author_node = XPath.first(channel_node, "dc:creator")
-          end
-          if author_node.nil?
-            author_node = XPath.first(channel_node, "atom:author")
-          end
-        end
-        unless author_node.nil?
-          @author.raw = FeedTools.unescape_entities(
-            XPath.first(author_node, "text()").to_s)
-          @author.raw = nil if @author.raw == ""
-          unless @author.raw.nil?
-            raw_scan = @author.raw.scan(
-              /(.*)\((\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\)/i)
-            if raw_scan.nil? || raw_scan.size == 0
-              raw_scan = @author.raw.scan(
-                /(\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\s*\((.*)\)/i)
-              author_raw_pair = raw_scan.first.reverse unless raw_scan.size == 0
-            else
-              author_raw_pair = raw_scan.first
-            end
-            if raw_scan.nil? || raw_scan.size == 0
-              email_scan = @author.raw.scan(
-                /\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b/i)
-              if email_scan != nil && email_scan.size > 0
-                @author.email = email_scan.first.strip
-              end
-            end
-            unless author_raw_pair.nil? || author_raw_pair.size == 0
-              @author.name = author_raw_pair.first.strip
-              @author.email = author_raw_pair.last.strip
-            else
-              unless @author.raw.include?("@")
-                # We can be reasonably sure we are looking at something
-                # that the creator didn't intend to contain an email address if
-                # it got through the preceeding regexes and it doesn't
-                # contain the tell-tale '@' symbol.
-                @author.name = @author.raw
-              end
-            end
-          end
-          @author.name = "" if @author.name.nil?
-          if @author.name == ""
-            @author.name = FeedTools.unescape_entities(
-              XPath.first(author_node, "name/text()").to_s)
-          end
-          if @author.name == ""
-            @author.name = FeedTools.unescape_entities(
-              XPath.first(author_node, "@name").to_s)
-          end
-          if @author.email == ""
-            @author.email = FeedTools.unescape_entities(
-              XPath.first(author_node, "email/text()").to_s)
-          end
-          if @author.email == ""
-            @author.email = FeedTools.unescape_entities(
-              XPath.first(author_node, "@email").to_s)
-          end
-          if @author.url == ""
-            @author.url = FeedTools.unescape_entities(
-              XPath.first(author_node, "url/text()").to_s)
-          end
-          if @author.url == ""
-            @author.url = FeedTools.unescape_entities(
-              XPath.first(author_node, "@url").to_s)
-          end
-          @author.name = nil if @author.name == ""
-          @author.raw = nil if @author.raw == ""
-          @author.email = nil if @author.email == ""
-          @author.url = nil if @author.url == ""
-        end
-        # Fallback on the itunes module if we didn't find an author name
-        begin
-          @author.name = self.itunes_author if @author.name.nil?
-        rescue
-          @author.name = nil
-        end
-      end
-      return @author
-    end
-
-    # Sets the feed author
-    def author=(new_author)
-      if new_author.respond_to?(:name) &&
-          new_author.respond_to?(:email) &&
-          new_author.respond_to?(:url)
-        # It's a complete author object, just set it.
-        @author = new_author
-      else
-        # We're not looking at an author object, this is probably a string,
-        # default to setting the author's name.
-        if @author.nil?
-          @author = FeedTools::Feed::Author.new
-        end
-        @author.name = new_author
-      end
-    end
-
-    # Returns the feed publisher
-    def publisher
-      if @publisher.nil?
-        @publisher = FeedTools::Feed::Author.new
-
-        # Set the author name
-        @publisher.raw = FeedTools.unescape_entities(
-          XPath.first(channel_node, "dc:publisher/text()").to_s)
-        if @publisher.raw == ""
-          @publisher.raw = FeedTools.unescape_entities(
-            XPath.first(channel_node, "webMaster/text()").to_s)
-        end
-        unless @publisher.raw == ""
-          raw_scan = @publisher.raw.scan(
-            /(.*)\((\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\)/i)
-          if raw_scan.nil? || raw_scan.size == 0
-            raw_scan = @publisher.raw.scan(
-              /(\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\s*\((.*)\)/i)
-            unless raw_scan.size == 0
-              publisher_raw_pair = raw_scan.first.reverse
-            end
-          else
-            publisher_raw_pair = raw_scan.first
-          end
-          if raw_scan.nil? || raw_scan.size == 0
-            email_scan = @publisher.raw.scan(
-              /\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b/i)
-            if email_scan != nil && email_scan.size > 0
-              @publisher.email = email_scan.first.strip
-            end
-          end
-          unless publisher_raw_pair.nil? || publisher_raw_pair.size == 0
-            @publisher.name = publisher_raw_pair.first.strip
-            @publisher.email = publisher_raw_pair.last.strip
-          else
-            unless @publisher.raw.include?("@")
-              # We can be reasonably sure we are looking at something
-              # that the creator didn't intend to contain an email address if
-              # it got through the preceeding regexes and it doesn't
-              # contain the tell-tale '@' symbol.
-              @publisher.name = @publisher.raw
-            end
-          end
-        end
-
-        @publisher.name = nil if @publisher.name == ""
-        @publisher.raw = nil if @publisher.raw == ""
-        @publisher.email = nil if @publisher.email == ""
-        @publisher.url = nil if @publisher.url == ""
-      end
-      return @publisher
-    end
-
-    # Sets the feed publisher
-    def publisher=(new_publisher)
-      if new_publisher.respond_to?(:name) &&
-          new_publisher.respond_to?(:email) &&
-          new_publisher.respond_to?(:url)
-        # It's a complete Author object, just set it.
-        @publisher = new_publisher
-      else
-        # We're not looking at an Author object, this is probably a string,
-        # default to setting the publisher's name.
-        if @publisher.nil?
-          @publisher = FeedTools::Feed::Author.new
-        end
-        @publisher.name = new_publisher
-      end
-    end
-    
-    # Returns the contents of the itunes:author element
-    #
-    # Returns any incorrectly placed channel-level itunes:author
-    # elements.  They're actually amazingly common.  People don't read specs.
-    # There is no setter for this, since this is a "bozo" attribute.
-    def itunes_author
-      if @itunes_author.nil?
-        @itunes_author = FeedTools.unescape_entities(XPath.first(channel_node,
-          "itunes:author/text()").to_s)
-        @itunes_author = nil if @itunes_author == ""
-        @bozo = true unless @itunes_author.nil? 
-      end
-      return @itunes_author
-    end
-
-    # Returns the feed item time
-    def time
-      if @time.nil?
-        unless channel_node.nil?
-          time_string = XPath.first(channel_node, "pubDate/text()").to_s
-          if time_string == ""
-            time_string = XPath.first(channel_node, "dc:date/text()").to_s
-          end
-          if time_string == ""
-            time_string = XPath.first(channel_node, "issued/text()").to_s
-          end
-          if time_string == ""
-            time_string = XPath.first(channel_node, "updated/text()").to_s
-          end
-          if time_string == ""
-            time_string = XPath.first(channel_node, "time/text()").to_s
-          end
-        end
-        begin
-          if time_string != nil && time_string != ""
-            @time = Time.parse(time_string) rescue self.succ_time
-          elsif time_string == nil
-            @time = self.succ_time
-          end
-          if @time == nil
-            @time = Time.now
-          end
-        rescue
-          @time = Time.now
-        end
-      end
-      return @time
-    end
-    
-    # Sets the feed item time
-    def time=(new_time)
-      @time = new_time
-    end
-    
-    # Returns 1 second after the previous item's time.
-    def succ_time #:nodoc:
-      begin
-        if feed.nil?
-          return nil
-        end
-        feed.items
-        unsorted_items = feed.instance_variable_get("@items")
-        item_index = unsorted_items.index(self)
-        if item_index.nil?
-          return nil
-        end
-        if item_index <= 0
-          return Time.now
-        end
-        previous_item = unsorted_items[item_index - 1]
-        return previous_item.time.succ
-      rescue
-        return nil
-      end
-    end
-    private :succ_time
-
-    # Returns the feed item updated time
-    def updated
-      if @updated.nil?
-        unless channel_node.nil?
-          updated_string = XPath.first(channel_node, "updated/text()").to_s
-          if updated_string == ""
-            updated_string = XPath.first(channel_node, "modified/text()").to_s
-          end
-        end
-        if updated_string != nil && updated_string != ""
-          @updated = Time.parse(updated_string) rescue nil
-        else
-          @updated = nil
-        end
-      end
-      return @updated
-    end
-    
-    # Sets the feed item updated time
-    def updated=(new_updated)
-      @updated = new_updated
-    end
-
-    # Returns the feed item issued time
-    def issued
-      if @issued.nil?
-        unless channel_node.nil?
-          issued_string = XPath.first(channel_node, "issued/text()").to_s
-          if issued_string == ""
-            issued_string = XPath.first(channel_node, "pubDate/text()").to_s
-          end
-          if issued_string == ""
-            issued_string = XPath.first(channel_node, "dc:date/text()").to_s
-          end
-          if issued_string == ""
-            issued_string = XPath.first(channel_node, "published/text()").to_s
-          end
-        end
-        if issued_string != nil && issued_string != ""
-          @issued = Time.parse(issued_string) rescue nil
-        else
-          @issued = nil
-        end
-      end
-      return @issued
-    end
-    
-    # Sets the feed item issued time
-    def issued=(new_issued)
-      @issued = new_issued
-    end
-
-    # Returns the feed item published time
-    def published
-      if @published.nil?
-        unless channel_node.nil?
-          published_string = XPath.first(channel_node, "published/text()").to_s
-          if published_string == ""
-            published_string = XPath.first(channel_node, "pubDate/text()").to_s
-          end
-          if published_string == ""
-            published_string = XPath.first(channel_node, "dc:date/text()").to_s
-          end
-          if published_string == ""
-            published_string = XPath.first(channel_node, "issued/text()").to_s
-          end
-        end
-        if published_string != nil && published_string != ""
-          @published = Time.parse(published_string) rescue nil
-        else
-          @published = nil
-        end
-      end
-      return @published
-    end
-    
-    # Sets the feed item published time
-    def published=(new_published)
-      @published = new_published
-    end
-
-    # Returns a list of the feed's categories
-    def categories
-      if @categories.nil?
-        @categories = []
-        category_nodes = XPath.match(channel_node, "category")
-        if category_nodes.nil? || category_nodes.empty?
-          category_nodes = XPath.match(channel_node, "dc:subject")
-        end
-        unless category_nodes.nil?
-          for category_node in category_nodes
-            category = FeedTools::Feed::Category.new
-            category.term = XPath.first(category_node, "@term").to_s
-            if category.term == ""
-              category.term = XPath.first(category_node, "text()").to_s
-            end
-            category.term.strip! unless category.term.nil?
-            category.term = nil if category.term == ""
-            category.label = XPath.first(category_node, "@label").to_s
-            category.label.strip! unless category.label.nil?
-            category.label = nil if category.label == ""
-            category.scheme = XPath.first(category_node, "@scheme").to_s
-            if category.scheme == ""
-              category.scheme = XPath.first(category_node, "@domain").to_s
-            end
-            category.scheme.strip! unless category.scheme.nil?
-            category.scheme = nil if category.scheme == ""
-            @categories << category
-          end
-        end
-      end
-      return @categories
-    end
-    
-    # Returns a list of the feed's images
-    def images
-      if @images.nil?
-        @images = []
-        unless channel_node.nil?
-          image_nodes = XPath.match(channel_node, "image")
-          if image_nodes.nil? || image_nodes.empty?
-            image_nodes = XPath.match(channel_node, "link")
-          end
-          if image_nodes.nil? || image_nodes.empty?
-            image_nodes = XPath.match(channel_node, "logo")
-          end
-          if image_nodes.nil? || image_nodes.empty?
-            image_nodes = XPath.match(channel_node, "LOGO")
-          end
-          unless image_nodes.nil?
-            for image_node in image_nodes
-              image = FeedTools::Feed::Image.new
-              image.url = XPath.first(image_node, "url/text()").to_s
-              if image.url == ""
-                image.url = XPath.first(image_node, "@rdf:resource").to_s
-              end
-              if image.url == "" && (image_node.name == "logo" ||
-                  (image_node.attributes['type'] =~ /^image/) == 0)
-                image.url = XPath.first(image_node, "@href").to_s
-              end
-              if image.url == "" && image_node.name == "LOGO"
-                image.url = XPath.first(image_node, "@HREF").to_s
-              end
-              image.url.strip! unless image.url.nil?
-              image.url = nil if image.url == ""
-              image.title = XPath.first(image_node, "title/text()").to_s
-              image.title.strip! unless image.title.nil?
-              image.title = nil if image.title == ""
-              image.description =
-                XPath.first(image_node, "description/text()").to_s
-              image.description.strip! unless image.description.nil?
-              image.description = nil if image.description == ""
-              image.link = XPath.first(image_node, "link/text()").to_s
-              image.link.strip! unless image.link.nil?
-              image.link = nil if image.link == ""
-              image.height = XPath.first(image_node, "height/text()").to_s.to_i
-              image.height = nil if image.height <= 0
-              image.width = XPath.first(image_node, "width/text()").to_s.to_i
-              image.width = nil if image.width <= 0
-              image.style = XPath.first(image_node, "@style").to_s.downcase
-              if image.style == ""
-                image.style = XPath.first(image_node, "@STYLE").to_s.downcase
-              end
-              image.style.strip! unless image.style.nil?
-              image.style = nil if image.style == ""
-              @images << image
-            end
-          end
-        end
-      end
-      return @images
-    end
-    
-    # Returns the feed's text input field
-    def text_input
-      if @text_input.nil?
-        @text_input = FeedTools::Feed::TextInput.new
-        text_input_node = XPath.first(channel_node, "textInput")
-        unless text_input_node.nil?
-          @text_input.title =
-            XPath.first(text_input_node, "title/text()").to_s
-          @text_input.title = nil if @text_input.title == ""
-          @text_input.description =
-            XPath.first(text_input_node, "description/text()").to_s
-          @text_input.description = nil if @text_input.description == ""
-          @text_input.link =
-            XPath.first(text_input_node, "link/text()").to_s
-          @text_input.link = nil if @text_input.link == ""
-          @text_input.name =
-            XPath.first(text_input_node, "name/text()").to_s
-          @text_input.name = nil if @text_input.name == ""
-        end
-      end
-      return @text_input
-    end
-        
-    # Returns the feed's copyright information
-    def copyright
-      if @copyright.nil?
-        unless channel_node.nil?
-          @copyright = XPath.first(channel_node, "copyright/text()").to_s
-          if @copyright == ""
-            @copyright = XPath.first(channel_node, "rights/text()").to_s
-          end
-          if @copyright == ""
-            @copyright = XPath.first(channel_node, "dc:rights/text()").to_s
-          end
-          if @copyright == ""
-            @copyright = XPath.first(channel_node, "copyrights/text()").to_s
-          end
-          @copyright = FeedTools.sanitize_html(@copyright, :strip)
-          @copyright = nil if @copyright == ""
-        end
-      end
-      return @copyright
-    end
-
-    # Sets the feed's copyright information
-    def copyright=(new_copyright)
-      @copyright = new_copyright
-    end
-
-    # Returns the number of seconds before the feed should expire
-    def time_to_live
-      if @time_to_live.nil?
-        unless channel_node.nil?
-          # get the feed time to live from the xml document
-          update_frequency = XPath.first(channel_node, "syn:updateFrequency/text()").to_s
-          if update_frequency != ""
-            update_period = XPath.first(channel_node, "syn:updatePeriod/text()").to_s
-            if update_period == "daily"
-              @time_to_live = update_frequency.to_i.day
-            elsif update_period == "weekly"
-              @time_to_live = update_frequency.to_i.week
-            elsif update_period == "monthly"
-              @time_to_live = update_frequency.to_i.month
-            elsif update_period == "yearly"
-              @time_to_live = update_frequency.to_i.year
-            else
-              # hourly
-              @time_to_live = update_frequency.to_i.hour
-            end
-          end
-          if @time_to_live.nil?
-            # usually expressed in minutes
-            update_frequency = XPath.first(channel_node, "ttl/text()").to_s
-            if update_frequency != ""
-              update_span = XPath.first(channel_node, "ttl/@span").to_s
-              if update_span == "seconds"
-                @time_to_live = update_frequency.to_i
-              elsif update_span == "minutes"
-                @time_to_live = update_frequency.to_i.minute
-              elsif update_span == "hours"
-                @time_to_live = update_frequency.to_i.hour
-              elsif update_span == "days"
-                @time_to_live = update_frequency.to_i.day
-              elsif update_span == "weeks"
-                @time_to_live = update_frequency.to_i.week
-              elsif update_span == "months"
-                @time_to_live = update_frequency.to_i.month
-              elsif update_span == "years"
-                @time_to_live = update_frequency.to_i.year
-              elsif update_frequency.to_i >= 3000
-                # Normally, this should default to minutes, but realistically,
-                # if they meant minutes, you're rarely going to see a value higher
-                # than 120.  If we see >= 3000, we're either dealing with a stupid
-                # pseudo-spec that decided to use seconds, or we're looking at
-                # someone who only has weekly updated content.  Worst case, we
-                # misreport the time, and we update too often.  Best case, we
-                # avoid accidentally updating the feed only once a year.  In the
-                # interests of being pragmatic, and since the problem we avoid
-                # is a far greater one than the one we cause, just run the check
-                # and hope no one actually gets hurt.
-                @time_to_live = update_frequency.to_i
-              else
-                @time_to_live = update_frequency.to_i.minute
-              end
-            end
-          end
-          if @time_to_live.nil?
-            @time_to_live = 0
-            update_frequency_days =
-              XPath.first(channel_node, "schedule/intervaltime/@days").to_s
-            update_frequency_hours =
-              XPath.first(channel_node, "schedule/intervaltime/@hour").to_s
-            update_frequency_minutes =
-              XPath.first(channel_node, "schedule/intervaltime/@min").to_s
-            update_frequency_seconds =
-              XPath.first(channel_node, "schedule/intervaltime/@sec").to_s
-            if update_frequency_days != ""
-              @time_to_live = @time_to_live + update_frequency_days.to_i.day
-            end
-            if update_frequency_hours != ""
-              @time_to_live = @time_to_live + update_frequency_hours.to_i.hour
-            end
-            if update_frequency_minutes != ""
-              @time_to_live = @time_to_live + update_frequency_minutes.to_i.minute
-            end
-            if update_frequency_seconds != ""
-              @time_to_live = @time_to_live + update_frequency_seconds.to_i
-            end
-            if @time_to_live == 0
-              @time_to_live = 1.hour
-            end
-          end
-        end
-      end
-      if @time_to_live.nil? || @time_to_live == 0
-        # Default to one hour
-        @time_to_live = 1.hour
-      end
-      @time_to_live = @time_to_live.round
-      return @time_to_live
-    end
-
-    # Sets the feed time to live
-    def time_to_live=(new_time_to_live)
-      @time_to_live = new_time_to_live.round
-      @time_to_live = 1.hour if @time_to_live < 1.hour
-    end
-
-    # Returns the feed's cloud
-    def cloud
-      if @cloud.nil?
-        @cloud = FeedTools::Feed::Cloud.new
-        @cloud.domain = XPath.first(channel_node, "cloud/@domain").to_s
-        @cloud.port = XPath.first(channel_node, "cloud/@port").to_s
-        @cloud.path = XPath.first(channel_node, "cloud/@path").to_s
-        @cloud.register_procedure =
-          XPath.first(channel_node, "cloud/@registerProcedure").to_s
-        @cloud.protocol =
-          XPath.first(channel_node, "cloud/@protocol").to_s.downcase
-        @cloud.domain = nil if @cloud.domain == ""
-        @cloud.port = nil if @cloud.port == ""
-        @cloud.port = @cloud.port.to_i unless @cloud.port.nil?
-        @cloud.port = nil if @cloud.port == 0
-        @cloud.path = nil if @cloud.path == ""
-        @cloud.register_procedure = nil if @cloud.register_procedure == ""
-        @cloud.protocol = nil if @cloud.protocol == ""
-      end
-      return @cloud
-    end
-    
-    # Sets the feed's cloud
-    def cloud=(new_cloud)
-      @cloud = new_cloud
-    end
-    
-    # Returns the feed generator
-    def generator
-      if @generator.nil?
-        @generator = XPath.first(channel_node, "generator/text()").to_s
-        @generator = FeedTools.strip_html(@generator)
-        @generator = nil if @generator == ""
-      end
-      return @generator
-    end
-
-    # Sets the feed generator
-    def generator=(new_generator)
-      @generator = new_generator
-    end
-
-    # Returns the feed docs
-    def docs
-      if @docs.nil?
-        @docs = XPath.first(channel_node, "docs/text()").to_s
-        @docs = FeedTools.strip_html(@docs)
-        @docs = nil if @docs == ""
-      end
-      return @docs
-    end
-
-    # Sets the feed docs
-    def docs=(new_docs)
-      @docs = new_docs
-    end
-
-    # Returns the feed language
-    def language
-      if @language.nil?
-        unless channel_node.nil?
-          @language = XPath.first(channel_node, "language/text()").to_s
-          if @language == ""
-            @language = XPath.first(channel_node, "dc:language/text()").to_s
-          end
-          if @language == ""
-            @language = XPath.first(channel_node, "xml:lang/text()").to_s
-          end
-          if @language == ""
-            @language = XPath.first(root_node, "xml:lang/text()").to_s
-          end
-        end
-        if @language == "" || @language.nil?
-          @language = "en-us"
-        end
-        @language = @language.downcase
-        @language = nil if @language == ""
-      end
-      return @language
-    end
-
-    # Sets the feed language
-    def language=(new_language)
-      @language = new_language
-    end
-    
-    # Returns true if this feed contains explicit material.
-    def explicit?
-      if @explicit.nil?
-        if XPath.first(channel_node,
-              "media:adult/text()").to_s.downcase == "true" ||
-            XPath.first(channel_node,
-              "itunes:explicit/text()").to_s.downcase == "yes" ||
-            XPath.first(channel_node,
-              "itunes:explicit/text()").to_s.downcase == "true"
-          @explicit = true
-        else
-          @explicit = false
-        end
-      end
-      return @explicit
-    end
-
-    # Sets whether or not the feed contains explicit material
-    def explicit=(new_explicit)
-      @explicit = (new_explicit ? true : false)
-    end
-    
-    # Returns the feed items
-    def items
-      if @items.nil?
-        unless root_node.nil?
-          raw_items = XPath.match(root_node, "item")
-          if raw_items == nil || raw_items == []
-            raw_items = XPath.match(channel_node, "item")
-          end
-          if raw_items == nil || raw_items == []
-            raw_items = XPath.match(channel_node, "ITEM")
-          end
-          if raw_items == nil || raw_items == []
-            raw_items = XPath.match(root_node, "ITEM")
-          end
-          if raw_items == nil || raw_items == []
-            raw_items = XPath.match(channel_node, "entry")
-          end
-          if raw_items == nil || raw_items == []
-            raw_items = XPath.match(root_node, "entry")
-          end
-        end
-
-        # create the individual feed items
-        @items = []
-        if raw_items != nil
-          for item_node in raw_items
-            new_item = FeedItem.new
-            new_item.xml_data = item_node.to_s
-            new_item.feed = self
-            @items << new_item
-          end
-        end
-      end
-      
-      # Sort the items
-      @items = @items.sort do |a,b|
-        (b.time or Time.mktime(1970)) <=> (a.time or Time.mktime(1970))
-      end
-      return @items
-    end
-    
-    # The time that the feed was last requested from the remote server.  Nil if it has
-    # never been pulled, or if it was created from scratch.
-    def last_retrieved
-      unless self.cache_object.nil?
-        @last_retrieved = self.cache_object.last_retrieved
-      end
-      return @last_retrieved
-    end
-    
-    # Sets the time that the feed was last updated.
-    def last_retrieved=(new_last_retrieved)
-      @last_retrieved = new_last_retrieved
-      unless self.cache_object.nil?
-        self.cache_object.last_retrieved = new_last_retrieved
-      end
-    end
-    
-    # True if this feed contains audio content enclosures
-    def podcast?
-      podcast = false
-      self.items.each do |item|
-        item.enclosures.each do |enclosure|
-          podcast = true if enclosure.audio?
-        end
-      end
-      return podcast
-    end
-
-    # True if this feed contains video content enclosures
-    def vidlog?
-      vidlog = false
-      self.items.each do |item|
-        item.enclosures.each do |enclosure|
-          vidlog = true if enclosure.video?
-        end
-      end
-      return vidlog
-    end
-    
-    # True if this feed is malformed somehow
-    def bozo?
-      if @bozo.nil?
-        @bozo = false
-      end
-      return @bozo
-    end
-    
-    # True if the feed was not last retrieved from the cache.
-    def live?
-      return @live
-    end
-    
-    # True if the feed has expired and must be reacquired from the remote server.
-    def expired?
-      return self.last_retrieved == nil || (self.last_retrieved + self.time_to_live.hour) < Time.now
-    end
-    
-    # Forces this feed to expire.
-    def expire!
-      self.last_retrieved = Time.mktime(1970)
-      self.save
-    end
-
-    # A hook method that is called during the feed generation process.  Overriding this method
-    # will enable additional content to be inserted into the feed.
-    def build_xml_hook(feed_type, version, xml_builder)
-      return nil
-    end
-
-    # Generates xml based on the content of the feed
-    def build_xml(feed_type=(self.feed_type or "rss"), version=nil,
-        xml_builder=Builder::XmlMarkup.new(:indent => 2))
-      if feed_type == "rss" && (version == nil || version == 0.0)
-        version = 1.0
-      elsif feed_type == "atom" && (version == nil || version == 0.0)
-        version = 0.3
-      end
-      if feed_type == "rss" && (version == 0.9 || version == 1.0 ||
-          version == 1.1)
-        # RDF-based rss format
-        return xml_builder.tag!("rdf:RDF",
-            "xmlns" => "http://purl.org/rss/1.0/",
-            "xmlns:rdf" => "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
-            "xmlns:dc" => "http://purl.org/dc/elements/1.1/",
-            "xmlns:syn" => "http://purl.org/rss/1.0/modules/syndication/",
-            "xmlns:taxo" => "http://purl.org/rss/1.0/modules/taxonomy/",
-            "xmlns:itunes" => "http://www.itunes.com/DTDs/Podcast-1.0.dtd",
-            "xmlns:media" => "http://search.yahoo.com/mrss") do
-          channel_attributes = {}
-          unless self.link.nil?
-            channel_attributes["rdf:about"] = CGI.escapeHTML(self.link)
-          end
-          xml_builder.channel(channel_attributes) do
-            unless title.nil? || title == ""
-              xml_builder.title(title)
-            else
-              xml_builder.title
-            end
-            unless link.nil? || link == ""
-              xml_builder.link(link)
-            else
-              xml_builder.link
-            end
-            unless images.nil? || images.empty?
-              xml_builder.image("rdf:resource" => CGI.escapeHTML(
-                images.first.url))
-            end
-            unless description.nil? || description == ""
-              xml_builder.description(description)
-            else
-              xml_builder.description
-            end
-            unless language.nil? || language == ""
-              xml_builder.tag!("dc:language", language)
-            end
-            xml_builder.tag!("syn:updatePeriod", "hourly")
-            xml_builder.tag!("syn:updateFrequency", (time_to_live / 1.hour).to_s)
-            xml_builder.tag!("syn:updateBase", Time.mktime(1970).iso8601)
-            xml_builder.items do
-              xml_builder.tag!("rdf:Seq") do
-                unless items.nil?
-                  for item in items
-                    if item.link.nil?
-                      raise "Cannot generate an rdf-based feed with a nil item link field."
-                    end
-                    xml_builder.tag!("rdf:li", "rdf:resource" => CGI.escapeHTML(item.link))
-                  end
-                end
-              end
-            end
-            build_xml_hook(feed_type, version, xml_builder)
-          end
-          unless images.nil? || images.empty?
-            best_image = nil
-            for image in self.images
-              if image.link != nil
-                best_image = image
-                break
-              end
-            end
-            best_image = images.first if best_image.nil?
-            xml_builder.image("rdf:about" => CGI.escapeHTML(best_image.url)) do
-              if best_image.title != nil && best_image.title != ""
-                xml_builder.title(best_image.title)
-              elsif self.title != nil && self.title != ""
-                xml_builder.title(self.title)
-              else
-                xml_builder.title
-              end
-              unless best_image.url.nil? || best_image.url == ""
-                xml_builder.url(best_image.url)
-              end
-              if best_image.link != nil && best_image.link != ""
-                xml_builder.link(best_image.link)
-              elsif self.link != nil && self.link != ""
-                xml_builder.link(self.link)
-              else
-                xml_builder.link
-              end
-            end
-          end
-          unless items.nil?
-            for item in items
-              item.build_xml(feed_type, version, xml_builder)
-            end
-          end
-        end
-      elsif feed_type == "rss"
-        # normal rss format
-        return xml_builder.rss("version" => "2.0",
-            "xmlns:rdf" => "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
-            "xmlns:dc" => "http://purl.org/dc/elements/1.1/",
-            "xmlns:taxo" => "http://purl.org/rss/1.0/modules/taxonomy/",
-            "xmlns:trackback" =>
-              "http://madskills.com/public/xml/rss/module/trackback/",
-            "xmlns:itunes" => "http://www.itunes.com/DTDs/Podcast-1.0.dtd",
-            "xmlns:media" => "http://search.yahoo.com/mrss") do
-          xml_builder.channel do
-            unless title.nil? || title == ""
-              xml_builder.title(title)
-            end
-            unless link.nil? || link == ""
-              xml_builder.link(link)
-            end
-            unless description.nil? || description == ""
-              xml_builder.description(description)
-            end
-            xml_builder.ttl((time_to_live / 1.minute).to_s)
-            xml_builder.generator(
-              "http://www.sporkmonger.com/projects/feedtools")
-            build_xml_hook(feed_type, version, xml_builder)
-            unless items.nil?
-              for item in items
-                item.build_xml(feed_type, version, xml_builder)
-              end
-            end
-          end
-        end
-      elsif feed_type == "atom" && version == 0.3
-        # normal atom format
-        return xml_builder.feed("xmlns" => "http://purl.org/atom/ns#",
-            "version" => version,
-            "xml:lang" => language) do
-          unless title.nil? || title == ""
-            xml_builder.title(title,
-                "mode" => "escaped",
-                "type" => "text/html")
-          end
-          xml_builder.author do
-            unless self.author.nil? || self.author.name.nil?
-              xml_builder.name(self.author.name)
-            else
-              xml_builder.name("n/a")
-            end
-            unless self.author.nil? || self.author.email.nil?
-              xml_builder.email(self.author.email)
-            end
-            unless self.author.nil? || self.author.url.nil?
-              xml_builder.url(self.author.url)
-            end
-          end
-          unless link.nil? || link == ""
-            xml_builder.link("href" => link,
-                "rel" => "alternate",
-                "type" => "text/html",
-                "title" => title)
-          end
-          unless description.nil? || description == ""
-            xml_builder.tagline(description,
-                "mode" => "escaped",
-                "type" => "text/html")
-          end
-          xml_builder.generator("FeedTools",
-              "url" => "http://www.sporkmonger.com/projects/feedtools")
-          build_xml_hook(feed_type, version, xml_builder)
-          unless items.nil?
-            for item in items
-              item.build_xml(feed_type, version, xml_builder)
-            end
-          end
-        end
-      elsif feed_type == "atom" && version == 1.0
-        # normal atom format
-        return xml_builder.feed("xmlns" => "http://www.w3.org/2005/Atom",
-            "xml:lang" => language) do
-          unless title.nil? || title == ""
-            xml_builder.title(title,
-                "type" => "html")
-          end
-          xml_builder.author do
-            unless self.author.nil? || self.author.name.nil?
-              xml_builder.name(self.author.name)
-            else
-              xml_builder.name("n/a")
-            end
-            unless self.author.nil? || self.author.email.nil?
-              xml_builder.email(self.author.email)
-            end
-            unless self.author.nil? || self.author.url.nil?
-              xml_builder.url(self.author.url)
-            end
-          end
-          unless self.url.nil? || self.url == ""
-            xml_builder.link("href" => self.url,
-                "rel" => "self",
-                "type" => "application/atom+xml")
-          end
-          unless self.link.nil? || self.link == ""
-            xml_builder.link("href" => self.link,
-                "rel" => "alternate",
-                "type" => "text/html",
-                "title" => self.title)
-          end
-          unless description.nil? || description == ""
-            xml_builder.subtitle(description,
-                "type" => "html")
-          else
-            xml_builder.subtitle(FeedTools.no_content_string,
-                "type" => "html")
-          end
-          if self.updated != nil
-            xml_builder.updated(self.updated.iso8601)
-          elsif self.time != nil
-            # Not technically correct, but a heck of a lot better
-            # than the Time.now fall-back.
-            xml_builder.updated(self.time.iso8601)
-          else
-            xml_builder.updated(Time.now.iso8601)
-          end
-          unless self.published.nil?
-            xml_builder.published(self.published.iso8601)            
-          end
-          xml_builder.generator("FeedTools - " +
-            "http://www.sporkmonger.com/projects/feedtools")
-          if self.id != nil
-            unless FeedTools.is_uri? self.id
-              if self.link != nil
-                xml_builder.id(FeedTools.build_urn_uri(self.link))
-              else
-                raise "The unique id must be a valid URI."
-              end
-            else
-              xml_builder.id(self.id)
-            end
-          elsif self.link != nil
-            xml_builder.id(FeedTools.build_urn_uri(self.link))
-          else
-            raise "Cannot build feed, missing feed unique id."
-          end
-          build_xml_hook(feed_type, version, xml_builder)
-          unless items.nil?
-            for item in items
-              item.build_xml(feed_type, version, xml_builder)
-            end
-          end
-        end
-      end
-    end
-
-    # Persists the current feed state to the cache.
-    def save
-      if FeedTools.feed_cache.nil?
-        raise "Caching is currently disabled.  Cannot save to cache."
-      elsif self.url.nil?
-        raise "The url field must be set to save to the cache."
-      elsif self.xml_data.nil?
-        raise "The xml_data field must be set to save to the cache."
-      elsif self.cache_object.nil?
-        raise "The cache_object is currently nil.  Cannot save to cache."
-      else
-        self.cache_object.url = self.url
-        self.cache_object.title = self.title
-        self.cache_object.link = self.link
-        self.cache_object.xml_data = self.xml_data
-        unless self.http_response.nil?
-          self.cache_object.http_headers = self.http_headers.to_yaml
-        end
-        self.cache_object.last_retrieved = self.last_retrieved
-        self.cache_object.save
-      end
-    end
-    
-    alias_method :tagline, :description
-    alias_method :tagline=, :description=
-    alias_method :subtitle, :description
-    alias_method :subtitle=, :description=
-    alias_method :abstract, :description
-    alias_method :abstract=, :description=
-    alias_method :content, :description
-    alias_method :content=, :description=
-    alias_method :ttl, :time_to_live
-    alias_method :ttl=, :time_to_live=
-    alias_method :guid, :id
-    alias_method :guid=, :id=
-    alias_method :entries, :items
-    
-    # passes missing methods to the cache_object
-    def method_missing(msg, *params)
-      if self.cache_object.nil?
-        raise NoMethodError, "Invalid method #{msg.to_s}"
-      end
-      return self.cache_object.send(msg, params)
-    end
-
-    # passes missing methods to the FeedTools.feed_cache
-    def Feed.method_missing(msg, *params)
-      if FeedTools.feed_cache.nil?
-        raise NoMethodError, "Invalid method Feed.#{msg.to_s}"
-      end
-      result = FeedTools.feed_cache.send(msg, params)
-      if result.kind_of? FeedTools.feed_cache
-        result = Feed.open(result.url)
-      end
-      return result
-    end
-    
-    # Returns a simple representation of the feed object's state.
-    def inspect
-      return "#<FeedTools::Feed:0x#{self.object_id.to_s(16)} URL:#{self.url}>"
-    end
-  end
-  
-  class FeedItem
-    include REXML
-    include AttributeDictionary
-    
-    # This class stores information about a feed item's file enclosures.
-    class Enclosure
-      include AttributeDictionary
-      
-      # The url for the enclosure
-      attr_accessor :url
-      # The MIME type of the file referenced by the enclosure
-      attr_accessor :type
-      # The size of the file referenced by the enclosure
-      attr_accessor :file_size
-      # The total play time of the file referenced by the enclosure
-      attr_accessor :duration
-      # The height in pixels of the enclosed media
-      attr_accessor :height
-      # The width in pixels of the enclosed media
-      attr_accessor :width
-      # The bitrate of the enclosed media
-      attr_accessor :bitrate
-      # The framerate of the enclosed media
-      attr_accessor :framerate
-      # The thumbnail for this enclosure
-      attr_accessor :thumbnail
-      # The categories for this enclosure
-      attr_accessor :categories
-      # A hash of the enclosed file
-      attr_accessor :hash
-      # A website containing some kind of media player instead of a direct
-      # link to the media file.
-      attr_accessor :player
-      # A list of credits for the enclosed media
-      attr_accessor :credits
-      # A text rendition of the enclosed media
-      attr_accessor :text
-      # A list of alternate version of the enclosed media file
-      attr_accessor :versions
-      # The default version of the enclosed media file
-      attr_accessor :default_version
-      
-      # Returns true if this is the default enclosure
-      def is_default?
-        return @is_default
-      end
-      
-      # Sets whether this is the default enclosure for the media group
-      def is_default=(new_is_default)
-        @is_default = new_is_default
-      end
-        
-      # Returns true if the enclosure contains explicit material
-      def explicit?
-        return @explicit
-      end
-      
-      # Sets the explicit attribute on the enclosure
-      def explicit=(new_explicit)
-        @explicit = new_explicit
-      end
-      
-      # Determines if the object is a sample, or the full version of the
-      # object, or if it is a stream.
-      # Possible values are 'sample', 'full', 'nonstop'.
-      def expression
-        return @expression
-      end
-      
-      # Sets the expression attribute on the enclosure.
-      # Allowed values are 'sample', 'full', 'nonstop'.
-      def expression=(new_expression)
-        unless ['sample', 'full', 'nonstop'].include? new_expression.downcase
-          raise ArgumentError,
-            "Permitted values are 'sample', 'full', 'nonstop'."
-        end
-        @expression = new_expression.downcase
-      end
-      
-      # Returns true if this enclosure contains audio content
-      def audio?
-        unless self.type.nil?
-          return true if (self.type =~ /^audio/) != nil
-        end
-        # TODO: create a more complete list
-        # =================================
-        audio_extensions = ['mp3', 'm4a', 'm4p', 'wav', 'ogg', 'wma']
-        audio_extensions.each do |extension|
-          if (url =~ /#{extension}$/) != nil
-            return true
-          end
-        end
-        return false
-      end
-
-      # Returns true if this enclosure contains video content
-      def video?
-        unless self.type.nil?
-          return true if (self.type =~ /^video/) != nil
-          return true if self.type == "image/mov"
-        end
-        # TODO: create a more complete list
-        # =================================
-        video_extensions = ['mov', 'mp4', 'avi', 'wmv', 'asf']
-        video_extensions.each do |extension|
-          if (url =~ /#{extension}$/) != nil
-            return true
-          end
-        end
-        return false
-      end
-      
-      alias_method :link, :url
-      alias_method :link=, :url=
-    end
-    
-    # TODO: Make these actual classes instead of structs
-    # ==================================================
-    EnclosureHash = Struct.new( "EnclosureHash", :hash, :type )
-    EnclosurePlayer = Struct.new( "EnclosurePlayer", :url, :height, :width )
-    EnclosureCredit = Struct.new( "EnclosureCredit", :name, :role )
-    EnclosureThumbnail = Struct.new( "EnclosureThumbnail", :url, :height,
-      :width )
-
-    # Returns the parent feed of this feed item
-    def feed
-      return @feed
-    end
-    
-    # Sets the parent feed of this feed item
-    def feed=(new_feed)
-      @feed = new_feed
-    end
-
-    # Returns the feed item's raw xml data.
-    def xml_data
-      return @xml_data
-    end
-
-    # Sets the feed item's xml data.
-    def xml_data=(new_xml_data)
-      @xml_data = new_xml_data
-    end
-
-    # Returns a REXML Document of the xml_data
-    def xml
-      if @xml_doc.nil?
-        # TODO: :ignore_whitespace_nodes => :all
-        # Add that?
-        # ======================================
-        @xml_doc = Document.new(xml_data)
-      end
-      return @xml_doc
-    end
-
-    # Returns the first node within the root_node that matches the xpath query.
-    def find_node(xpath)
-      return XPath.first(root_node, xpath)
-    end
-
-    # Returns all nodes within the root_node that match the xpath query.
-    def find_all_nodes(xpath)
-      return XPath.match(root_node, xpath)
-    end
-
-    # Returns the root node of the feed item.
-    def root_node
-      if @root_node.nil?
-        @root_node = xml.root
-      end
-      return @root_node
-    end
-
-    # Returns the feed items's unique id
-    def id
-      if @id.nil?
-        unless root_node.nil?
-          @id = XPath.first(root_node, "id/text()").to_s
-          if @id == ""
-            @id = XPath.first(root_node, "guid/text()").to_s
-          end
-        end
-        @id = nil if @id == ""
-      end
-      return @id
-    end
-
-    # Sets the feed item's unique id
-    def id=(new_id)
-      @id = new_id
-    end
-
-    # Returns the feed item title
-    def title
-      if @title.nil?
-        unless root_node.nil?
-          repair_entities = false
-          title_node = XPath.first(root_node, "title")
-          if title_node.nil?
-            title_node = XPath.first(root_node, "dc:title")
-          end
-          if title_node.nil?
-            title_node = XPath.first(root_node, "TITLE")
-          end
-        end
-        if title_node.nil?
-          return nil
-        end
-        if XPath.first(title_node, "@type").to_s == "xhtml" || 
-            XPath.first(title_node, "@mode").to_s == "xhtml" ||
-            XPath.first(title_node, "@type").to_s == "xml" || 
-            XPath.first(title_node, "@mode").to_s == "xml" ||
-            XPath.first(title_node, "@type").to_s == "application/xhtml+xml"
-          @title = title_node.inner_xml
-        elsif XPath.first(title_node, "@type").to_s == "escaped" ||
-            XPath.first(title_node, "@mode").to_s == "escaped"
-          @title = FeedTools.unescape_entities(
-            XPath.first(title_node, "text()").to_s)
-        else
-          @title = title_node.inner_xml
-          repair_entities = true
-        end
-        unless @title.nil?
-          @title = FeedTools.sanitize_html(@title, :strip)
-          @title = FeedTools.unescape_entities(@title) if repair_entities
-          @title = FeedTools.tidy_html(@title)
-        end
-        if @title != ""
-          # Some blogging tools include the number of comments in a post
-          # in the title... this is supremely ugly, and breaks any
-          # applications which expect the title to be static, so we're
-          # gonna strip them out.
-          #
-          # If for some incredibly wierd reason you need the actual
-          # unstripped title, just use find_node("title/text()").to_s
-          @title = @title.strip.gsub(/\[\d*\]$/, "").strip
-        end
-        @title.gsub!(/\n/, " ")
-        @title.strip!
-        @title = nil if @title == ""
-      end
-      return @title
-    end
-    
-    # Sets the feed item title
-    def title=(new_title)
-      @title = new_title
-    end
-
-    # Returns the feed item description
-    def description
-      if @description.nil?
-        unless root_node.nil?
-          repair_entities = false
-          description_node = XPath.first(root_node, "content:encoded")
-          if description_node.nil?
-            description_node = XPath.first(root_node, "content")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "fullitem")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "xhtml:body")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "body")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "description")
-          end          
-          if description_node.nil?
-            description_node = XPath.first(root_node, "tagline")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "subtitle")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "summary")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "abstract")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "ABSTRACT")
-          end
-          if description_node.nil?
-            description_node = XPath.first(root_node, "info")
-            @bozo = true unless description_node.nil?
-          end
-        end
-        if description_node.nil?
-          return nil
-        end
-        unless description_node.nil?
-          if XPath.first(description_node, "@encoding").to_s != ""
-            @description =
-              "[Embedded data objects are not currently supported.]"
-          elsif XPath.first(description_node, "@type").to_s == "xhtml" || 
-              XPath.first(description_node, "@mode").to_s == "xhtml" ||
-              XPath.first(description_node, "@type").to_s == "xml" || 
-              XPath.first(description_node, "@mode").to_s == "xml" ||
-              XPath.first(description_node, "@type").to_s ==
-                "application/xhtml+xml"
-            @description = description_node.inner_xml
-          elsif XPath.first(description_node, "@type").to_s == "escaped" ||
-              XPath.first(description_node, "@mode").to_s == "escaped"
-            @description = FeedTools.unescape_entities(
-              description_node.inner_xml)
-          else
-            @description = description_node.inner_xml
-            repair_entities = true
-          end
-        end
-        if @description == ""
-          @description = self.itunes_summary
-          @description = "" if @description.nil?
-        end
-        if @description == ""
-          @description = self.itunes_subtitle
-          @description = "" if @description.nil?
-        end
-
-        unless @description.nil?
-          @description = FeedTools.sanitize_html(@description, :strip)
-          @description = FeedTools.unescape_entities(@description) if repair_entities
-          @description = FeedTools.tidy_html(@description)
-        end
-
-        @description = @description.strip unless @description.nil?
-        @description = nil if @description == ""
-      end
-      return @description
-    end
-
-    # Sets the feed item description
-    def description=(new_description)
-      @description = new_description
-    end
-    
-    # Returns the contents of the itunes:summary element
-    def itunes_summary
-      if @itunes_summary.nil?
-        @itunes_summary = FeedTools.unescape_entities(XPath.first(root_node,
-          "itunes:summary/text()").to_s)
-        if @itunes_summary == ""
-          @itunes_summary = nil
-        end
-        unless @itunes_summary.nil?
-          @itunes_summary = FeedTools.sanitize_html(@itunes_summary)
-        end
-      end
-      return @itunes_summary
-    end
-
-    # Sets the contents of the itunes:summary element
-    def itunes_summary=(new_itunes_summary)
-      @itunes_summary = new_itunes_summary
-    end
-
-    # Returns the contents of the itunes:subtitle element
-    def itunes_subtitle
-      if @itunes_subtitle.nil?
-        @itunes_subtitle = FeedTools.unescape_entities(XPath.first(root_node,
-          "itunes:subtitle/text()").to_s)
-        if @itunes_subtitle == ""
-          @itunes_subtitle = nil
-        end
-        unless @itunes_subtitle.nil?
-          @itunes_subtitle = FeedTools.sanitize_html(@itunes_subtitle)
-        end
-      end
-      return @itunes_subtitle
-    end
-
-    # Sets the contents of the itunes:subtitle element
-    def itunes_subtitle=(new_itunes_subtitle)
-      @itunes_subtitle = new_itunes_subtitle
-    end
-
-    # Returns the contents of the media:text element
-    def media_text
-      if @media_text.nil?
-        @media_text = FeedTools.unescape_entities(XPath.first(root_node,
-          "itunes:subtitle/text()").to_s)
-        if @media_text == ""
-          @media_text = nil
-        end
-        unless @media_text.nil?
-          @media_text = FeedTools.sanitize_html(@media_text)
-        end
-      end
-      return @media_text
-    end
-
-    # Sets the contents of the media:text element
-    def media_text=(new_media_text)
-      @media_text = new_media_text
-    end
-
-    # Returns the feed item link
-    def link
-      if @link.nil?
-        unless root_node.nil?
-          @link = XPath.first(root_node, "link[@rel='alternate']/@href").to_s
-          if @link == ""
-            @link = XPath.first(root_node, "link/@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "link/text()").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "@rdf:about").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "guid[@isPermaLink='true']/text()").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "a/@href").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "@HREF").to_s
-          end
-          if @link == ""
-            @link = XPath.first(root_node, "A/@HREF").to_s
-          end
-        end
-        if @link == "" || @link.nil?
-          if FeedTools.is_uri? self.guid
-            @link = self.guid
-          end
-        end
-        if @link != ""
-          @link = FeedTools.unescape_entities(@link)
-        end
-# TODO: Actually implement proper relative url resolving instead of this crap
-# ===========================================================================
-# 
-#        if @link != "" && (@link =~ /http:\/\//) != 0 && (@link =~ /https:\/\//) != 0
-#          if (feed.base[-1..-1] == "/" && @link[0..0] == "/")
-#            @link = @link[1..-1]
-#          end
-#          # prepend the base to the link since they seem to have used a relative path
-#          @link = feed.base + @link
-#        end
-        @link = FeedTools.normalize_url(@link)
-      end
-      return @link
-    end
-    
-    # Sets the feed item link
-    def link=(new_link)
-      @link = new_link
-    end
-        
-    # Returns a list of the feed item's categories
-    def categories
-      if @categories.nil?
-        @categories = []
-        category_nodes = XPath.match(root_node, "category")
-        if category_nodes.nil? || category_nodes.empty?
-          category_nodes = XPath.match(root_node, "dc:subject")
-        end
-        unless category_nodes.nil?
-          for category_node in category_nodes
-            category = FeedTools::Feed::Category.new
-            category.term = XPath.first(category_node, "@term").to_s
-            if category.term == ""
-              category.term = XPath.first(category_node, "text()").to_s
-            end
-            category.term.strip! unless category.term.nil?
-            category.term = nil if category.term == ""
-            category.label = XPath.first(category_node, "@label").to_s
-            category.label.strip! unless category.label.nil?
-            category.label = nil if category.label == ""
-            category.scheme = XPath.first(category_node, "@scheme").to_s
-            if category.scheme == ""
-              category.scheme = XPath.first(category_node, "@domain").to_s
-            end
-            category.scheme.strip! unless category.scheme.nil?
-            category.scheme = nil if category.scheme == ""
-            @categories << category
-          end
-        end
-      end
-      return @categories
-    end
-    
-    # Returns a list of the feed items's images
-    def images
-      if @images.nil?
-        @images = []
-        image_nodes = XPath.match(root_node, "link")
-        if image_nodes.nil? || image_nodes.empty?
-          image_nodes = XPath.match(root_node, "logo")
-        end
-        if image_nodes.nil? || image_nodes.empty?
-          image_nodes = XPath.match(root_node, "LOGO")
-        end
-        if image_nodes.nil? || image_nodes.empty?
-          image_nodes = XPath.match(root_node, "image")
-        end
-        unless image_nodes.nil?
-          for image_node in image_nodes
-            image = FeedTools::Feed::Image.new
-            image.url = XPath.first(image_node, "url/text()").to_s
-            if image.url != ""
-              self.feed.bozo = true
-            end
-            if image.url == ""
-              image.url = XPath.first(image_node, "@rdf:resource").to_s
-            end
-            if image.url == "" && (image_node.name == "logo" ||
-                (image_node.attributes['type'] =~ /^image/) == 0)
-              image.url = XPath.first(image_node, "@href").to_s
-            end
-            if image.url == "" && image_node.name == "LOGO"
-              image.url = XPath.first(image_node, "@HREF").to_s
-            end
-            image.url.strip! unless image.url.nil?
-            image.url = nil if image.url == ""
-            image.title = XPath.first(image_node, "title/text()").to_s
-            image.title.strip! unless image.title.nil?
-            image.title = nil if image.title == ""
-            image.description =
-              XPath.first(image_node, "description/text()").to_s
-            image.description.strip! unless image.description.nil?
-            image.description = nil if image.description == ""
-            image.link = XPath.first(image_node, "link/text()").to_s
-            image.link.strip! unless image.link.nil?
-            image.link = nil if image.link == ""
-            image.height = XPath.first(image_node, "height/text()").to_s.to_i
-            image.height = nil if image.height <= 0
-            image.width = XPath.first(image_node, "width/text()").to_s.to_i
-            image.width = nil if image.width <= 0
-            image.style = XPath.first(image_node, "@style").to_s.downcase
-            if image.style == ""
-              image.style = XPath.first(image_node, "@STYLE").to_s.downcase
-            end
-            image.style.strip! unless image.style.nil?
-            image.style = nil if image.style == ""
-            @images << image
-          end
-        end
-      end
-      return @images
-    end
-    
-    # Returns the feed item itunes image link
-    #
-    # If it's not present, falls back to the normal image link.
-    # Technically, the itunes spec says that the image needs to be
-    # square and larger than 300x300, but hey, if there's an image
-    # to be had, it's better than none at all.
-    def itunes_image_link
-      if @itunes_image_link.nil?
-        # get the feed item itunes image link from the xml document
-        @itunes_image_link = XPath.first(root_node, "itunes:image/@href").to_s
-        if @itunes_image_link == ""
-          @itunes_image_link = XPath.first(root_node, "itunes:link[@rel='image']/@href").to_s
-        end
-        @itunes_image_link = FeedTools.normalize_url(@itunes_image_link)
-      end
-      return @itunes_image_link
-    end
-
-    # Sets the feed item itunes image link
-    def itunes_image_link=(new_itunes_image_link)
-      @itunes_image_link = new_itunes_image_link
-    end
-    
-    # Returns the feed item media thumbnail link
-    #
-    # If it's not present, falls back to the normal image link.
-    def media_thumbnail_link
-      if @media_thumbnail_link.nil?
-        # get the feed item itunes image link from the xml document
-        @media_thumbnail_link = XPath.first(root_node, "media:thumbnail/@url").to_s
-        @media_thumbnail_link = FeedTools.normalize_url(@media_thumbnail_link)
-      end
-      return @media_thumbnail_link
-    end
-
-    # Sets the feed item media thumbnail url
-    def media_thumbnail_link=(new_media_thumbnail_link)
-      @media_thumbnail_link = new_media_thumbnail_link
-    end
-
-    # Returns the feed item's copyright information
-    def copyright
-      if @copyright.nil?
-        unless root_node.nil?
-          @copyright = XPath.first(root_node, "dc:rights/text()").to_s
-          if @copyright == ""
-            @copyright = XPath.first(root_node, "rights/text()").to_s
-          end
-          if @copyright == ""
-            @copyright = XPath.first(root_node, "copyright/text()").to_s
-          end
-          if @copyright == ""
-            @copyright = XPath.first(root_node, "copyrights/text()").to_s
-          end
-          @copyright = FeedTools.sanitize_html(@copyright, :strip)
-          @copyright = nil if @copyright == ""
-        end
-      end
-      return @copyright
-    end
-
-    # Sets the feed item's copyright information
-    def copyright=(new_copyright)
-      @copyright = new_copyright
-    end
-
-    # Returns all feed item enclosures
-    def enclosures
-      if @enclosures.nil?
-        @enclosures = []
-        
-        # First, load up all the different possible sources of enclosures
-        rss_enclosures = XPath.match(root_node, "enclosure")
-        atom_enclosures = XPath.match(root_node, "link[@rel='enclosure']")
-        media_content_enclosures = XPath.match(root_node, "media:content")
-        media_group_enclosures = XPath.match(root_node, "media:group")
-        
-        # Parse RSS-type enclosures.  Thanks to a few buggy enclosures implementations,
-        # sometimes these also manage to show up in atom files.
-        for enclosure_node in rss_enclosures
-          enclosure = Enclosure.new
-          enclosure.url = FeedTools.unescape_entities(enclosure_node.attributes["url"].to_s)
-          enclosure.type = enclosure_node.attributes["type"].to_s
-          enclosure.file_size = enclosure_node.attributes["length"].to_i
-          enclosure.credits = []
-          enclosure.explicit = false
-          @enclosures << enclosure
-        end
-        
-        # Parse atom-type enclosures.  If there are repeats of the same enclosure object,
-        # we merge the two together.
-        for enclosure_node in atom_enclosures
-          enclosure_url = FeedTools.unescape_entities(enclosure_node.attributes["href"].to_s)
-          enclosure = nil
-          new_enclosure = false
-          for existing_enclosure in @enclosures
-            if existing_enclosure.url == enclosure_url
-              enclosure = existing_enclosure
-              break
-            end
-          end
-          if enclosure.nil?
-            new_enclosure = true
-            enclosure = Enclosure.new
-          end
-          enclosure.url = enclosure_url
-          enclosure.type = enclosure_node.attributes["type"].to_s
-          enclosure.file_size = enclosure_node.attributes["length"].to_i
-          enclosure.credits = []
-          enclosure.explicit = false
-          if new_enclosure
-            @enclosures << enclosure
-          end
-        end
-
-        # Creates an anonymous method to parse content objects from the media module.  We
-        # do this to avoid excessive duplication of code since we have to do identical
-        # processing for content objects within group objects.
-        parse_media_content = lambda do |media_content_nodes|
-          affected_enclosures = []
-          for enclosure_node in media_content_nodes
-            enclosure_url = FeedTools.unescape_entities(enclosure_node.attributes["url"].to_s)
-            enclosure = nil
-            new_enclosure = false
-            for existing_enclosure in @enclosures
-              if existing_enclosure.url == enclosure_url
-                enclosure = existing_enclosure
-                break
-              end
-            end
-            if enclosure.nil?
-              new_enclosure = true
-              enclosure = Enclosure.new
-            end
-            enclosure.url = enclosure_url
-            enclosure.type = enclosure_node.attributes["type"].to_s
-            enclosure.file_size = enclosure_node.attributes["fileSize"].to_i
-            enclosure.duration = enclosure_node.attributes["duration"].to_s
-            enclosure.height = enclosure_node.attributes["height"].to_i
-            enclosure.width = enclosure_node.attributes["width"].to_i
-            enclosure.bitrate = enclosure_node.attributes["bitrate"].to_i
-            enclosure.framerate = enclosure_node.attributes["framerate"].to_i
-            enclosure.expression = enclosure_node.attributes["expression"].to_s
-            enclosure.is_default =
-              (enclosure_node.attributes["isDefault"].to_s.downcase == "true")
-            if XPath.first(enclosure_node, "media:thumbnail/@url").to_s != ""
-              enclosure.thumbnail = EnclosureThumbnail.new(
-                FeedTools.unescape_entities(XPath.first(enclosure_node, "media:thumbnail/@url").to_s),
-                FeedTools.unescape_entities(XPath.first(enclosure_node, "media:thumbnail/@height").to_s),
-                FeedTools.unescape_entities(XPath.first(enclosure_node, "media:thumbnail/@width").to_s)
-              )
-              if enclosure.thumbnail.height == ""
-                enclosure.thumbnail.height = nil
-              end
-              if enclosure.thumbnail.width == ""
-                enclosure.thumbnail.width = nil
-              end
-            end
-            enclosure.categories = []
-            for category in XPath.match(enclosure_node, "media:category")
-              enclosure.categories << FeedTools::Feed::Category.new
-              enclosure.categories.last.term =
-                FeedTools.unescape_entities(category.text)
-              enclosure.categories.last.scheme =
-                FeedTools.unescape_entities(category.attributes["scheme"].to_s)
-              enclosure.categories.last.label =
-                FeedTools.unescape_entities(category.attributes["label"].to_s)
-              if enclosure.categories.last.scheme == ""
-                enclosure.categories.last.scheme = nil
-              end
-              if enclosure.categories.last.label == ""
-                enclosure.categories.last.label = nil
-              end
-            end
-            if XPath.first(enclosure_node, "media:hash/text()").to_s != ""
-              enclosure.hash = EnclosureHash.new(
-                FeedTools.sanitize_html(FeedTools.unescape_entities(XPath.first(
-                  enclosure_node, "media:hash/text()").to_s), :strip),
-                "md5"
-              )
-            end
-            if XPath.first(enclosure_node, "media:player/@url").to_s != ""
-              enclosure.player = EnclosurePlayer.new(
-                FeedTools.unescape_entities(XPath.first(enclosure_node, "media:player/@url").to_s),
-                FeedTools.unescape_entities(XPath.first(enclosure_node, "media:player/@height").to_s),
-                FeedTools.unescape_entities(XPath.first(enclosure_node, "media:player/@width").to_s)
-              )
-              if enclosure.player.height == ""
-                enclosure.player.height = nil
-              end
-              if enclosure.player.width == ""
-                enclosure.player.width = nil
-              end
-            end
-            enclosure.credits = []
-            for credit in XPath.match(enclosure_node, "media:credit")
-              enclosure.credits << EnclosureCredit.new(
-                FeedTools.unescape_entities(credit.text),
-                FeedTools.unescape_entities(credit.attributes["role"].to_s.downcase)
-              )
-              if enclosure.credits.last.role == ""
-                enclosure.credits.last.role = nil
-              end
-            end
-            enclosure.explicit = (XPath.first(enclosure_node,
-              "media:adult/text()").to_s.downcase == "true")
-            if XPath.first(enclosure_node, "media:text/text()").to_s != ""
-              enclosure.text = FeedTools.unescape_entities(XPath.first(enclosure_node,
-                "media:text/text()").to_s)
-            end
-            affected_enclosures << enclosure
-            if new_enclosure
-              @enclosures << enclosure
-            end
-          end
-          affected_enclosures
-        end
-        
-        # Parse the independant content objects.
-        parse_media_content.call(media_content_enclosures)
-        
-        media_groups = []
-        
-        # Parse the group objects.
-        for media_group in media_group_enclosures
-          group_media_content_enclosures =
-            XPath.match(media_group, "media:content")
-          
-          # Parse the content objects within the group objects.
-          affected_enclosures =
-            parse_media_content.call(group_media_content_enclosures)
-          
-          # Now make sure that content objects inherit certain properties from
-          # the group objects.
-          for enclosure in affected_enclosures
-            if enclosure.thumbnail.nil? &&
-                XPath.first(media_group, "media:thumbnail/@url").to_s != ""
-              enclosure.thumbnail = EnclosureThumbnail.new(
-                FeedTools.unescape_entities(
-                  XPath.first(media_group, "media:thumbnail/@url").to_s),
-                FeedTools.unescape_entities(
-                  XPath.first(media_group, "media:thumbnail/@height").to_s),
-                FeedTools.unescape_entities(
-                  XPath.first(media_group, "media:thumbnail/@width").to_s)
-              )
-              if enclosure.thumbnail.height == ""
-                enclosure.thumbnail.height = nil
-              end
-              if enclosure.thumbnail.width == ""
-                enclosure.thumbnail.width = nil
-              end
-            end
-            if (enclosure.categories.nil? || enclosure.categories.size == 0)
-              enclosure.categories = []
-              for category in XPath.match(media_group, "media:category")
-                enclosure.categories << FeedTools::Feed::Category.new
-                enclosure.categories.last.term =
-                  FeedTools.unescape_entities(category.text)
-                enclosure.categories.last.scheme =
-                  FeedTools.unescape_entities(category.attributes["scheme"].to_s)
-                enclosure.categories.last.label =
-                  FeedTools.unescape_entities(category.attributes["label"].to_s)
-                if enclosure.categories.last.scheme == ""
-                  enclosure.categories.last.scheme = nil
-                end
-                if enclosure.categories.last.label == ""
-                  enclosure.categories.last.label = nil
-                end
-              end
-            end
-            if enclosure.hash.nil? &&
-                XPath.first(media_group, "media:hash/text()").to_s != ""
-              enclosure.hash = EnclosureHash.new(
-                FeedTools.unescape_entities(XPath.first(media_group, "media:hash/text()").to_s),
-                "md5"
-              )
-            end
-            if enclosure.player.nil? &&
-                XPath.first(media_group, "media:player/@url").to_s != ""
-              enclosure.player = EnclosurePlayer.new(
-                FeedTools.unescape_entities(XPath.first(media_group, "media:player/@url").to_s),
-                FeedTools.unescape_entities(XPath.first(media_group, "media:player/@height").to_s),
-                FeedTools.unescape_entities(XPath.first(media_group, "media:player/@width").to_s)
-              )
-              if enclosure.player.height == ""
-                enclosure.player.height = nil
-              end
-              if enclosure.player.width == ""
-                enclosure.player.width = nil
-              end
-            end
-            if enclosure.credits.nil? || enclosure.credits.size == 0
-              enclosure.credits = []
-              for credit in XPath.match(media_group, "media:credit")
-                enclosure.credits << EnclosureCredit.new(
-                  FeedTools.unescape_entities(credit.text),
-                  FeedTools.unescape_entities(credit.attributes["role"].to_s.downcase)
-                )
-                if enclosure.credits.last.role == ""
-                  enclosure.credits.last.role = nil
-                end
-              end
-            end
-            if enclosure.explicit?.nil?
-              enclosure.explicit = (XPath.first(media_group,
-                "media:adult/text()").to_s.downcase == "true") ? true : false
-            end
-            if enclosure.text.nil? &&
-                XPath.first(media_group, "media:text/text()").to_s != ""
-              enclosure.text = FeedTools.sanitize_html(FeedTools.unescape_entities(
-                XPath.first(media_group, "media:text/text()").to_s), :strip)
-            end
-          end
-          
-          # Keep track of the media groups
-          media_groups << affected_enclosures
-        end
-        
-        # Now we need to inherit any relevant item level information.
-        if self.explicit?
-          for enclosure in @enclosures
-            enclosure.explicit = true
-          end
-        end
-        
-        # Add all the itunes categories
-        for itunes_category in XPath.match(root_node, "itunes:category")
-          genre = "Podcasts"
-          category = itunes_category.attributes["text"].to_s
-          subcategory = XPath.first(itunes_category, "itunes:category/@text").to_s
-          category_path = genre
-          if category != ""
-            category_path << "/" + category
-          end
-          if subcategory != ""
-            category_path << "/" + subcategory
-          end          
-          for enclosure in @enclosures
-            if enclosure.categories.nil?
-              enclosure.categories = []
-            end
-            enclosure.categories << EnclosureCategory.new(
-              FeedTools.unescape_entities(category_path),
-              FeedTools.unescape_entities("http://www.apple.com/itunes/store/"),
-              FeedTools.unescape_entities("iTunes Music Store Categories")
-            )
-          end
-        end
-
-        for enclosure in @enclosures
-          # Clean up any of those attributes that incorrectly have ""
-          # or 0 as their values        
-          if enclosure.type == ""
-            enclosure.type = nil
-          end
-          if enclosure.file_size == 0
-            enclosure.file_size = nil
-          end
-          if enclosure.duration == 0
-            enclosure.duration = nil
-          end
-          if enclosure.height == 0
-            enclosure.height = nil
-          end
-          if enclosure.width == 0
-            enclosure.width = nil
-          end
-          if enclosure.bitrate == 0
-            enclosure.bitrate = nil
-          end
-          if enclosure.framerate == 0
-            enclosure.framerate = nil
-          end
-          if enclosure.expression == "" || enclosure.expression.nil?
-            enclosure.expression = "full"
-          end
-
-          # If an enclosure is missing the text field, fall back on the itunes:summary field
-          if enclosure.text.nil? || enclosure.text = ""
-            enclosure.text = self.itunes_summary
-          end
-
-          # Make sure we don't have duplicate categories
-          unless enclosure.categories.nil?
-            enclosure.categories.uniq!
-          end
-        end
-        
-        # And finally, now things get complicated.  This is where we make
-        # sure that the enclosures method only returns either default
-        # enclosures or enclosures with only one version.  Any enclosures
-        # that are wrapped in a media:group will be placed in the appropriate
-        # versions field.
-        affected_enclosure_urls = []
-        for media_group in media_groups
-          affected_enclosure_urls =
-            affected_enclosure_urls | (media_group.map do |enclosure|
-              enclosure.url
-            end)
-        end
-        @enclosures.delete_if do |enclosure|
-          (affected_enclosure_urls.include? enclosure.url)
-        end
-        for media_group in media_groups
-          default_enclosure = nil
-          for enclosure in media_group
-            if enclosure.is_default?
-              default_enclosure = enclosure
-            end
-          end
-          for enclosure in media_group
-            enclosure.default_version = default_enclosure
-            enclosure.versions = media_group.clone
-            enclosure.versions.delete(enclosure)
-          end
-          @enclosures << default_enclosure
-        end
-      end
-
-      # If we have a single enclosure, it's safe to inherit the itunes:duration field
-      # if it's missing.
-      if @enclosures.size == 1
-        if @enclosures.first.duration.nil? || @enclosures.first.duration == 0
-          @enclosures.first.duration = self.itunes_duration
-        end
-      end
-
-      return @enclosures
-    end
-    
-    def enclosures=(new_enclosures)
-      @enclosures = new_enclosures
-    end
-    
-    # Returns the feed item author
-    def author
-      if @author.nil?
-        @author = FeedTools::Feed::Author.new
-        unless root_node.nil?
-          author_node = XPath.first(root_node, "author")
-          if author_node.nil?
-            author_node = XPath.first(root_node, "managingEditor")
-          end
-          if author_node.nil?
-            author_node = XPath.first(root_node, "dc:author")
-          end
-          if author_node.nil?
-            author_node = XPath.first(root_node, "dc:creator")
-          end
-          if author_node.nil?
-            author_node = XPath.first(root_node, "atom:author")
-          end
-        end
-        unless author_node.nil?
-          @author.raw = FeedTools.unescape_entities(
-            XPath.first(author_node, "text()").to_s)
-          @author.raw = nil if @author.raw == ""
-          unless @author.raw.nil?
-            raw_scan = @author.raw.scan(
-              /(.*)\((\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\)/i)
-            if raw_scan.nil? || raw_scan.size == 0
-              raw_scan = @author.raw.scan(
-                /(\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\s*\((.*)\)/i)
-              author_raw_pair = raw_scan.first.reverse unless raw_scan.size == 0
-            else
-              author_raw_pair = raw_scan.first
-            end
-            if raw_scan.nil? || raw_scan.size == 0
-              email_scan = @author.raw.scan(
-                /\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b/i)
-              if email_scan != nil && email_scan.size > 0
-                @author.email = email_scan.first.strip
-              end
-            end
-            unless author_raw_pair.nil? || author_raw_pair.size == 0
-              @author.name = author_raw_pair.first.strip
-              @author.email = author_raw_pair.last.strip
-            else
-              unless @author.raw.include?("@")
-                # We can be reasonably sure we are looking at something
-                # that the creator didn't intend to contain an email address if
-                # it got through the preceeding regexes and it doesn't
-                # contain the tell-tale '@' symbol.
-                @author.name = @author.raw
-              end
-            end
-          end
-          @author.name = "" if @author.name.nil?
-          if @author.name == ""
-            @author.name = FeedTools.unescape_entities(
-              XPath.first(author_node, "name/text()").to_s)
-          end
-          if @author.name == ""
-            @author.name = FeedTools.unescape_entities(
-              XPath.first(author_node, "@name").to_s)
-          end
-          if @author.email == ""
-            @author.email = FeedTools.unescape_entities(
-              XPath.first(author_node, "email/text()").to_s)
-          end
-          if @author.email == ""
-            @author.email = FeedTools.unescape_entities(
-              XPath.first(author_node, "@email").to_s)
-          end
-          if @author.url == ""
-            @author.url = FeedTools.unescape_entities(
-              XPath.first(author_node, "url/text()").to_s)
-          end
-          if @author.url == ""
-            @author.url = FeedTools.unescape_entities(
-              XPath.first(author_node, "@url").to_s)
-          end
-          @author.name = nil if @author.name == ""
-          @author.raw = nil if @author.raw == ""
-          @author.email = nil if @author.email == ""
-          @author.url = nil if @author.url == ""
-        end
-        # Fallback on the itunes module if we didn't find an author name
-        begin
-          @author.name = self.itunes_author if @author.name.nil?
-        rescue
-          @author.name = nil
-        end
-      end
-      return @author
-    end
-    
-    # Sets the feed item author
-    def author=(new_author)
-      if new_author.respond_to?(:name) &&
-          new_author.respond_to?(:email) &&
-          new_author.respond_to?(:url)
-        # It's a complete author object, just set it.
-        @author = new_author
-      else
-        # We're not looking at an author object, this is probably a string,
-        # default to setting the author's name.
-        if @author.nil?
-          @author = FeedTools::Feed::Author.new
-        end
-        @author.name = new_author
-      end
-    end
-    
-    # Returns the feed publisher
-    def publisher
-      if @publisher.nil?
-        @publisher = FeedTools::Feed::Author.new
-
-        # Set the author name
-        @publisher.raw = FeedTools.unescape_entities(
-          XPath.first(root_node, "dc:publisher/text()").to_s)
-        if @publisher.raw == ""
-          @publisher.raw = FeedTools.unescape_entities(
-            XPath.first(root_node, "webMaster/text()").to_s)
-        end
-        unless @publisher.raw == ""
-          raw_scan = @publisher.raw.scan(
-            /(.*)\((\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\)/i)
-          if raw_scan.nil? || raw_scan.size == 0
-            raw_scan = @publisher.raw.scan(
-              /(\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b)\s*\((.*)\)/i)
-            unless raw_scan.size == 0
-              publisher_raw_pair = raw_scan.first.reverse
-            end
-          else
-            publisher_raw_pair = raw_scan.first
-          end
-          if raw_scan.nil? || raw_scan.size == 0
-            email_scan = @publisher.raw.scan(
-              /\b[A-Z0-9._%-\+]+@[A-Z0-9._%-]+\.[A-Z]{2,4}\b/i)
-            if email_scan != nil && email_scan.size > 0
-              @publisher.email = email_scan.first.strip
-            end
-          end
-          unless publisher_raw_pair.nil? || publisher_raw_pair.size == 0
-            @publisher.name = publisher_raw_pair.first.strip
-            @publisher.email = publisher_raw_pair.last.strip
-          else
-            unless @publisher.raw.include?("@")
-              # We can be reasonably sure we are looking at something
-              # that the creator didn't intend to contain an email address if
-              # it got through the preceeding regexes and it doesn't
-              # contain the tell-tale '@' symbol.
-              @publisher.name = @publisher.raw
-            end
-          end
-        end
-
-        @publisher.name = nil if @publisher.name == ""
-        @publisher.raw = nil if @publisher.raw == ""
-        @publisher.email = nil if @publisher.email == ""
-        @publisher.url = nil if @publisher.url == ""
-      end
-      return @publisher
-    end
-
-    # Sets the feed publisher
-    def publisher=(new_publisher)
-      if new_publisher.respond_to?(:name) &&
-          new_publisher.respond_to?(:email) &&
-          new_publisher.respond_to?(:url)
-        # It's a complete Author object, just set it.
-        @publisher = new_publisher
-      else
-        # We're not looking at an Author object, this is probably a string,
-        # default to setting the publisher's name.
-        if @publisher.nil?
-          @publisher = FeedTools::Feed::Author.new
-        end
-        @publisher.name = new_publisher
-      end
-    end
-    
-    # Returns the contents of the itunes:author element
-    #
-    # This inherits from any incorrectly placed channel-level itunes:author
-    # elements.  They're actually amazingly common.  People don't read specs.
-    def itunes_author
-      if @itunes_author.nil?
-        @itunes_author = FeedTools.unescape_entities(XPath.first(root_node,
-          "itunes:author/text()").to_s)
-        @itunes_author = feed.itunes_author if @itunes_author == ""
-        @itunes_author = nil if @itunes_author == ""
-      end
-      return @itunes_author
-    end
-
-    # Sets the contents of the itunes:author element
-    def itunes_author=(new_itunes_author)
-      @itunes_author = new_itunes_author
-    end        
-        
-    # Returns the number of seconds that the associated media runs for
-    def itunes_duration
-      if @itunes_duration.nil?
-        raw_duration = FeedTools.unescape_entities(XPath.first(root_node,
-          "itunes:duration/text()").to_s)
-        if raw_duration != ""
-          hms = raw_duration.split(":").map { |x| x.to_i }
-          if hms.size == 3
-            @itunes_duration = hms[0].hour + hms[1].minute + hms[2]
-          elsif hms.size == 2
-            @itunes_duration = hms[0].minute + hms[1]
-          elsif hms.size == 1
-            @itunes_duration = hms[0]
-          end
-        end
-      end
-      return @itunes_duration
-    end
-    
-    # Sets the number of seconds that the associate media runs for
-    def itunes_duration=(new_itunes_duration)
-      @itunes_duration = new_itunes_duration
-    end
-    
-    # Returns the feed item time
-    def time
-      if @time.nil?
-        unless root_node.nil?
-          time_string = XPath.first(root_node, "pubDate/text()").to_s
-          if time_string == ""
-            time_string = XPath.first(root_node, "dc:date/text()").to_s
-          end
-          if time_string == ""
-            time_string = XPath.first(root_node, "issued/text()").to_s
-          end
-          if time_string == ""
-            time_string = XPath.first(root_node, "updated/text()").to_s
-          end
-          if time_string == ""
-            time_string = XPath.first(root_node, "time/text()").to_s
-          end
-        end
-        if time_string != nil && time_string != ""
-          @time = Time.parse(time_string) rescue Time.now
-        elsif time_string == nil
-          @time = Time.now
-        end
-      end
-      return @time
-    end
-    
-    # Sets the feed item time
-    def time=(new_time)
-      @time = new_time
-    end
-
-    # Returns the feed item updated time
-    def updated
-      if @updated.nil?
-        unless root_node.nil?
-          updated_string = XPath.first(root_node, "updated/text()").to_s
-          if updated_string == ""
-            updated_string = XPath.first(root_node, "modified/text()").to_s
-          end
-        end
-        if updated_string != nil && updated_string != ""
-          @updated = Time.parse(updated_string) rescue nil
-        else
-          @updated = nil
-        end
-      end
-      return @updated
-    end
-    
-    # Sets the feed item updated time
-    def updated=(new_updated)
-      @updated = new_updated
-    end
-
-    # Returns the feed item issued time
-    def issued
-      if @issued.nil?
-        unless root_node.nil?
-          issued_string = XPath.first(root_node, "issued/text()").to_s
-          if issued_string == ""
-            issued_string = XPath.first(root_node, "published/text()").to_s
-          end
-          if issued_string == ""
-            issued_string = XPath.first(root_node, "pubDate/text()").to_s
-          end
-          if issued_string == ""
-            issued_string = XPath.first(root_node, "dc:date/text()").to_s
-          end
-        end
-        if issued_string != nil && issued_string != ""
-          @issued = Time.parse(issued_string) rescue nil
-        else
-          @issued = nil
-        end
-      end
-      return @issued
-    end
-    
-    # Sets the feed item issued time
-    def issued=(new_issued)
-      @issued = new_issued
-    end
-        
-    # Returns the url for posting comments
-    def comments
-      if @comments.nil?
-        @comments = FeedTools.normalize_url(
-          XPath.first(root_node, "comments/text()").to_s)
-        @comments = nil if @comments == ""
-      end
-      return @comments
-    end
-    
-    # Sets the url for posting comments
-    def comments=(new_comments)
-      @comments = new_comments
-    end
-    
-    # The source that this post was based on
-    def source
-      if @source.nil?
-        @source = FeedTools::Feed::Link.new
-        @source.url = XPath.first(root_node, "source/@url").to_s
-        @source.url = nil if @source.url == ""
-        @source.value = XPath.first(root_node, "source/text()").to_s
-        @source.value = nil if @source.value == ""
-      end
-      return @source
-    end
-        
-    # Returns the feed item tags
-    def tags
-      # TODO: support the rel="tag" microformat
-      # =======================================
-      if @tags.nil?
-        @tags = []
-        if @tags.nil? || @tags.size == 0
-          @tags = []
-          tag_list = XPath.match(root_node, "dc:subject/rdf:Bag/rdf:li/text()")
-          if tag_list.size > 1
-            for tag in tag_list
-              @tags << tag.to_s.downcase.strip
-            end
-          end
-        end
-        if @tags.nil? || @tags.size == 0
-          # messy effort to find ourselves some tags, mainly for del.icio.us
-          @tags = []
-          rdf_bag = XPath.match(root_node, "taxo:topics/rdf:Bag/rdf:li")
-          if rdf_bag != nil && rdf_bag.size > 0
-            for tag_node in rdf_bag
-              begin
-                tag_url = XPath.first(root_node, "@resource").to_s
-                tag_match = tag_url.scan(/\/(tag|tags)\/(\w+)/)
-                if tag_match.size > 0
-                  @tags << tag_match.first.last.downcase.strip
-                end
-              rescue
-              end
-            end
-          end
-        end
-        if @tags.nil? || @tags.size == 0
-          @tags = []
-          tag_list = XPath.match(root_node, "category/text()")
-          for tag in tag_list
-            @tags << tag.to_s.downcase.strip
-          end
-        end
-        if @tags.nil? || @tags.size == 0
-          @tags = []
-          tag_list = XPath.match(root_node, "dc:subject/text()")
-          for tag in tag_list
-            @tags << tag.to_s.downcase.strip
-          end
-        end
-        if @tags.nil? || @tags.size == 0
-          begin
-            @tags = XPath.first(root_node, "itunes:keywords/text()").to_s.downcase.split(" ")
-          rescue
-            @tags = []
-          end
-        end
-        if @tags.nil?
-          @tags = []
-        end
-        @tags.uniq!
-      end
-      return @tags
-    end
-    
-    # Sets the feed item tags
-    def tags=(new_tags)
-      @tags = new_tags
-    end
-    
-    # Returns true if this feed item contains explicit material.  If the whole
-    # feed has been marked as explicit, this will return true even if the item
-    # isn't explicitly marked as explicit.
-    def explicit?
-      if @explicit.nil?
-        if XPath.first(root_node,
-              "media:adult/text()").to_s.downcase == "true" ||
-            XPath.first(root_node,
-              "itunes:explicit/text()").to_s.downcase == "yes" ||
-            XPath.first(root_node,
-              "itunes:explicit/text()").to_s.downcase == "true" ||
-            feed.explicit?
-          @explicit = true
-        else
-          @explicit = false
-        end
-      end
-      return @explicit
-    end
-
-    # Sets whether or not the feed contains explicit material
-    def explicit=(new_explicit)
-      @explicit = (new_explicit ? true : false)
-    end
-    
-    # A hook method that is called during the feed generation process.  Overriding this method
-    # will enable additional content to be inserted into the feed.
-    def build_xml_hook(feed_type, version, xml_builder)
-      return nil
-    end
-
-    # Generates xml based on the content of the feed item
-    def build_xml(feed_type=(self.feed.feed_type or "rss"), version=nil,
-        xml_builder=Builder::XmlMarkup.new(:indent => 2))
-      if feed_type == "rss" && (version == nil || version == 0.0)
-        version = 1.0
-      elsif feed_type == "atom" && (version == nil || version == 0.0)
-        version = 0.3
-      end
-      if feed_type == "rss" && (version == 0.9 || version == 1.0 || version == 1.1)
-        # RDF-based rss format
-        if link.nil?
-          raise "Cannot generate an rdf-based feed item with a nil link field."
-        end
-        return xml_builder.item("rdf:about" => CGI.escapeHTML(link)) do
-          unless title.nil? || title == ""
-            xml_builder.title(title)
-          else
-            xml_builder.title
-          end
-          unless link.nil? || link == ""
-            xml_builder.link(link)
-          else
-            xml_builder.link
-          end
-          unless description.nil? || description == ""
-            xml_builder.description(description)
-          else
-            xml_builder.description
-          end
-          unless time.nil?
-            xml_builder.tag!("dc:date", time.iso8601)            
-          end
-          unless tags.nil? || tags.size == 0
-            xml_builder.tag!("taxo:topics") do
-              xml_builder.tag!("rdf:Bag") do
-                for tag in tags
-                  xml_builder.tag!("rdf:li", tag)
-                end
-              end
-            end
-            xml_builder.tag!("itunes:keywords", tags.join(" "))
-          end
-          build_xml_hook(feed_type, version, xml_builder)
-        end
-      elsif feed_type == "rss"
-        # normal rss format
-        return xml_builder.item do
-          unless title.nil? || title == ""
-            xml_builder.title(title)
-          end
-          unless link.nil? || link == ""
-            xml_builder.link(link)
-          end
-          unless description.nil? || description == ""
-            xml_builder.description(description)
-          end
-          unless time.nil?
-            xml_builder.pubDate(time.rfc822)            
-          end
-          unless tags.nil? || tags.size == 0
-            xml_builder.tag!("taxo:topics") do
-              xml_builder.tag!("rdf:Bag") do
-                for tag in tags
-                  xml_builder.tag!("rdf:li", tag)
-                end
-              end
-            end
-            xml_builder.tag!("itunes:keywords", tags.join(" "))
-          end
-          build_xml_hook(feed_type, version, xml_builder)
-        end
-      elsif feed_type == "atom" && version == 0.3
-        # normal atom format
-        return xml_builder.entry("xmlns" => "http://purl.org/atom/ns#") do
-          unless title.nil? || title == ""
-            xml_builder.title(title,
-                "mode" => "escaped",
-                "type" => "text/html")
-          end
-          xml_builder.author do
-            unless self.author.nil? || self.author.name.nil?
-              xml_builder.name(self.author.name)
-            else
-              xml_builder.name("n/a")
-            end
-            unless self.author.nil? || self.author.email.nil?
-              xml_builder.email(self.author.email)
-            end
-            unless self.author.nil? || self.author.url.nil?
-              xml_builder.url(self.author.url)
-            end
-          end
-          unless link.nil? || link == ""
-            xml_builder.link("href" => link,
-                "rel" => "alternate",
-                "type" => "text/html",
-                "title" => title)
-          end
-          unless description.nil? || description == ""
-            xml_builder.content(description,
-                "mode" => "escaped",
-                "type" => "text/html")            
-          end
-          unless time.nil?
-            xml_builder.issued(time.iso8601)            
-          end
-          unless tags.nil? || tags.size == 0
-            for tag in tags
-              xml_builder.category(tag)
-            end
-          end
-          build_xml_hook(feed_type, version, xml_builder)
-        end
-      elsif feed_type == "atom" && version == 1.0
-        # normal atom format
-        return xml_builder.entry("xmlns" => "http://www.w3.org/2005/Atom") do
-          unless title.nil? || title == ""
-            xml_builder.title(title,
-                "type" => "html")
-          end
-          xml_builder.author do
-            unless self.author.nil? || self.author.name.nil?
-              xml_builder.name(self.author.name)
-            else
-              xml_builder.name("n/a")
-            end
-            unless self.author.nil? || self.author.email.nil?
-              xml_builder.email(self.author.email)
-            end
-            unless self.author.nil? || self.author.url.nil?
-              xml_builder.url(self.author.url)
-            end
-          end
-          unless link.nil? || link == ""
-            xml_builder.link("href" => link,
-                "rel" => "alternate",
-                "type" => "text/html",
-                "title" => title)
-          end
-          unless description.nil? || description == ""
-            xml_builder.content(description,
-                "type" => "html")
-          else
-            xml_builder.content(FeedTools.no_content_string,
-                "type" => "html")
-          end
-          if self.updated != nil
-            xml_builder.updated(self.updated.iso8601)
-          elsif self.time != nil
-            # Not technically correct, but a heck of a lot better
-            # than the Time.now fall-back.
-            xml_builder.updated(self.time.iso8601)
-          else
-            xml_builder.updated(Time.now.iso8601)
-          end
-          unless self.published.nil?
-            xml_builder.published(self.published.iso8601)            
-          end
-          if self.id != nil
-            unless FeedTools.is_uri? self.id
-              if self.time != nil && self.link != nil
-                xml_builder.id(FeedTools.build_tag_uri(self.link, self.time))
-              elsif self.link != nil
-                xml_builder.id(FeedTools.build_urn_uuid_uri(self.link))
-              else
-                raise "The unique id must be a URI. " +
-                  "(Attempted to generate id, but failed.)"
-              end
-            else
-              xml_builder.id(self.id)
-            end
-          elsif self.time != nil && self.link != nil
-            xml_builder.id(FeedTools.build_tag_uri(self.link, self.time))
-          else
-            raise "Cannot build feed, missing feed unique id."
-          end
-          unless self.tags.nil? || self.tags.size == 0
-            for tag in self.tags
-              xml_builder.category("term" => tag)
-            end
-          end
-          build_xml_hook(feed_type, version, xml_builder)
-        end
-      end
-    end
-    
-    alias_method :tagline, :description
-    alias_method :tagline=, :description=
-    alias_method :subtitle, :description
-    alias_method :subtitle=, :description=
-    alias_method :summary, :description
-    alias_method :summary=, :description=
-    alias_method :abstract, :description
-    alias_method :abstract=, :description=
-    alias_method :content, :description
-    alias_method :content=, :description=
-    alias_method :guid, :id
-    alias_method :guid=, :id=
-    alias_method :published, :issued
-    alias_method :published=, :issued=
-    
-    # Returns a simple representation of the feed item object's state.
-    def inspect
-      return "#<FeedTools::FeedItem:0x#{self.object_id.to_s(16)} " +
-        "LINK:#{self.link}>"
-    end
-  end
 end
 
 module REXML # :nodoc: