rfeedparser 0.9.8 → 0.9.9

data/lib/rfeedparser/feedparserdict.rb

@@ -0,0 +1,93 @@
+#!/usr/bin/ruby
+module FeedParserUtilities
+  class FeedParserDict < Hash 
+=begin
+     The naming of a certain common attribute (such as, "When was the last
+     time this feed was updated?") can have many different names depending
+     on the type of feed we are handling. This class allows us to satisfy
+     the expectations of both the developer who has prior knowledge of the
+     feed type as well as the developer who wants a consistent application
+     interface.
+
+     @@keymap is a Hash that contains information on what a certain
+     attribute names "really are" in each kind of feed. It does this by
+     providing a common name that will map to any feed type in the keys,
+     with possible "correct" attributes in the its values. the #[] and #[]=
+     methods check with keymaps to see what attribute the developer "really
+     means" if they've asked for one which happens to be in @@keymap's keys.
+=end
+    @@keymap = {'channel' => 'feed',
+	      'items' => 'entries',
+	      'guid' => 'id',
+	      'date' => 'updated',
+	      'date_parsed' => 'updated_parsed',
+	      'description' => ['subtitle', 'summary'],
+	      'url' => ['href'],
+	      'modified' => 'updated',
+	      'modified_parsed' => 'updated_parsed',
+	      'issued' => 'published',
+	      'issued_parsed' => 'published_parsed',
+	      'copyright' => 'rights',
+	      'copyright_detail' => 'rights_detail',
+	      'tagline' => 'subtitle',
+	      'tagline_detail' => 'subtitle_detail'}
+
+    def entries # Apparently, Hash has an entries method!  That blew a good 3 hours or more of my time
+      return self['entries']
+    end
+
+    # We could include the [] rewrite in new using Hash.new's fancy pants block thing
+    # but we'd still have to overwrite []= and such. 
+    # I'm going to make it easy to turn lists of pairs into FeedParserDicts's though.
+    def initialize(pairs=nil)
+      if pairs.class == Array and pairs[0].class == Array and pairs[0].length == 2
+	pairs.each do |l| 
+	  k,v = l
+	  self[k] = v
+	end
+      elsif pairs.class == Hash
+	self.merge!(pairs) 
+      end
+    end
+
+    def [](key)
+      if key == 'category'
+	return self['tags'][0]['term']
+      end
+      if key == 'categories'
+	return self['tags'].collect{|tag| [tag['scheme'],tag['term']]}
+      end
+      realkey = @@keymap[key] || key 
+      if realkey.class == Array
+	realkey.each{ |key| return self[key] if has_key?key }
+      end
+      # Note that the original key is preferred over the realkey we (might 
+      # have) found in @@keymap
+      if has_key?(key)
+	return super(key)
+      end
+      return super(realkey)
+    end
+
+    def []=(key,value)
+      if @@keymap.key?key
+	key = @@keymap[key]
+	if key.class == Array
+	  key = key[0]
+	end
+      end
+      super(key,value)
+    end
+
+    def method_missing(msym, *args)
+      methodname = msym.to_s
+      if methodname[-1] == '='
+	return self[methodname[0..-2]] = args[0]
+      elsif methodname[-1] != '!' and methodname[-1] != '?' and methodname[0] != "_" # FIXME implement with private?
+	return self[methodname]
+      else
+	raise NoMethodError, "whoops, we don't know about the attribute or method called `#{methodname}' for #{self}:#{self.class}"
+      end
+    end 
+  end
+end

data/lib/rfeedparser/forgiving_uri.rb

@@ -0,0 +1,93 @@
+#!/usr/bin/ruby
+
+module URI
+  # NOTE I wish I didn't have to open this module up,but I cannot find a 
+  # better way of accessing all of the instance methods of the URI module. I \
+  # may just be an idiot.
+  def self.split(uri)
+    case uri
+    when ''
+      # null uri
+
+    when ABS_URI
+      scheme, opaque, userinfo, host, port, 
+	registry, path, query, fragment = $~[1..-1]
+
+      # URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]
+
+      # absoluteURI   = scheme ":" ( hier_part | opaque_part )
+      # hier_part     = ( net_path | abs_path ) [ "?" query ]
+      # opaque_part   = uric_no_slash *uric
+
+      # abs_path      = "/"  path_segments
+      # net_path      = "//" authority [ abs_path ]
+
+      # authority     = server | reg_name
+      # server        = [ [ userinfo "@" ] hostport ]
+
+      if !scheme
+	raise InvalidURIError, 
+	  "bad URI(absolute but no scheme): #{uri}"
+      end
+      if !opaque && (!path && (!host && !registry))
+	raise InvalidURIError,
+	  "bad URI(absolute but no path): #{uri}" 
+      end
+
+    when REL_URI
+      scheme = nil
+      opaque = nil
+
+      userinfo, host, port, registry, 
+	rel_segment, abs_path, query, fragment = $~[1..-1]
+      if rel_segment && abs_path
+	path = rel_segment + abs_path
+      elsif rel_segment
+	path = rel_segment
+      elsif abs_path
+	path = abs_path
+      end
+
+      # URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]
+
+      # relativeURI   = ( net_path | abs_path | rel_path ) [ "?" query ]
+
+      # net_path      = "//" authority [ abs_path ]
+      # abs_path      = "/"  path_segments
+      # rel_path      = rel_segment [ abs_path ]
+
+      # authority     = server | reg_name
+      # server        = [ [ userinfo "@" ] hostport ]
+
+    else
+      #	NOTE this is the only part of the code that differs from the "clean" 
+      #	URI module.
+      return [nil,nil,uri,nil,nil,nil,nil,nil,nil]
+    end
+
+    path = '' if !path && !opaque # (see RFC2396 Section 5.2)
+    ret = [
+      scheme, 
+      userinfo, host, port,         # X
+      registry,                        # X
+      path,                         # Y
+      opaque,                        # Y
+      query,
+      fragment
+    ]
+    return ret
+  end
+end
+
+def urljoin(base, uri)
+  urifixer = /^([A-Za-z][A-Za-z0-9+-.]*:\/\/)(\/*)(.*?)/u
+  uri = uri.sub(urifixer, '\1\3') 
+  begin
+    return URI.join(base, uri).to_s 
+  rescue URI::BadURIError => e
+    if URI.parse(base).relative? 
+      return URI::parse(uri).to_s
+    end
+  end
+end
+

data/lib/rfeedparser/markup_helpers.rb

@@ -0,0 +1,73 @@
+#!/usr/bin/ruby
+module FeedParserUtilities
+  #FIXME we need to find a better place for this method
+  def stripDoctype(data)
+=begin
+Strips DOCTYPE from XML document, returns (rss_version, stripped_data)
+
+    rss_version may be 'rss091n' or None
+    stripped_data is the same XML document, minus the DOCTYPE
+=end
+    entity_pattern = /<!ENTITY(.*?)>/m # m is for Regexp::MULTILINE
+    data = data.gsub(entity_pattern,'')
+
+    doctype_pattern = /<!DOCTYPE(.*?)>/m
+    doctype_results = data.scan(doctype_pattern)
+    if doctype_results and doctype_results[0]
+      doctype = doctype_results[0][0]
+    else
+      doctype = ''
+    end
+
+    if /netscape/ =~ doctype.downcase
+      version = 'rss091n'
+    else
+      version = nil
+    end
+    data = data.sub(doctype_pattern, '')
+    return version, data
+  end
+
+  def resolveRelativeURIs(htmlSource, baseURI, encoding)
+    $stderr << "entering resolveRelativeURIs\n" if $debug # FIXME write a decent logger
+    relative_uris = [ ['a','href'],
+      ['applet','codebase'],
+      ['area','href'],
+      ['blockquote','cite'],
+      ['body','background'],
+      ['del','cite'],
+      ['form','action'],
+      ['frame','longdesc'],
+      ['frame','src'],
+      ['iframe','longdesc'],
+      ['iframe','src'],
+      ['head','profile'],
+      ['img','longdesc'],
+      ['img','src'],
+      ['img','usemap'],
+      ['input','src'],
+      ['input','usemap'],
+      ['ins','cite'],
+      ['link','href'],
+      ['object','classid'],
+      ['object','codebase'],
+      ['object','data'],
+      ['object','usemap'],
+      ['q','cite'],
+      ['script','src'],
+    ]
+    h = Hpricot(htmlSource)
+    relative_uris.each do |l|
+      ename, eattr = l
+      h.search(ename).each do |elem|
+	euri = elem.attributes[eattr]
+	if euri and not euri.empty? and URI.parse(URI.encode(euri)).relative? 
+	  elem.attributes[eattr] = urljoin(baseURI, euri)
+	end
+      end
+    end
+    return h.to_html
+  end
+end
+
+

data/lib/rfeedparser/parser_mixin.rb

@@ -0,0 +1,1235 @@
+#!/usr/bin/ruby
+module FeedParserMixin
+  attr_accessor :feeddata, :version, :namespacesInUse, :date_handlers
+
+  def startup(baseuri=nil, baselang=nil, encoding='utf-8')
+    $stderr << "initializing FeedParser\n" if $debug
+
+    @namespaces = {'' => '',
+		'http://backend.userland.com/rss' => '',
+		'http://blogs.law.harvard.edu/tech/rss' => '',
+		'http://purl.org/rss/1.0/' => '',
+		'http://my.netscape.com/rdf/simple/0.9/' => '',
+		'http://example.com/newformat#' => '',
+		'http://example.com/necho' => '',
+		'http://purl.org/echo/' => '',
+		'uri/of/echo/namespace#' => '',
+		'http://purl.org/pie/' => '',
+		'http://purl.org/atom/ns#' => '',
+		'http://www.w3.org/2005/Atom' => '',
+		'http://purl.org/rss/1.0/modules/rss091#' => '',
+		'http://webns.net/mvcb/' =>                               'admin',
+		'http://purl.org/rss/1.0/modules/aggregation/' =>         'ag',
+		'http://purl.org/rss/1.0/modules/annotate/' =>            'annotate',
+		'http://media.tangent.org/rss/1.0/' =>                    'audio',
+		'http://backend.userland.com/blogChannelModule' =>        'blogChannel',
+		'http://web.resource.org/cc/' =>                          'cc',
+		'http://backend.userland.com/creativeCommonsRssModule' => 'creativeCommons',
+		'http://purl.org/rss/1.0/modules/company' =>              'co',
+		'http://purl.org/rss/1.0/modules/content/' =>             'content',
+		'http://my.theinfo.org/changed/1.0/rss/' =>               'cp',
+		'http://purl.org/dc/elements/1.1/' =>                     'dc',
+		'http://purl.org/dc/terms/' =>                            'dcterms',
+		'http://purl.org/rss/1.0/modules/email/' =>               'email',
+		'http://purl.org/rss/1.0/modules/event/' =>               'ev',
+		'http://rssnamespace.org/feedburner/ext/1.0' =>           'feedburner',
+		'http://freshmeat.net/rss/fm/' =>                         'fm',
+		'http://xmlns.com/foaf/0.1/' =>                           'foaf',
+		'http://www.w3.org/2003/01/geo/wgs84_pos#' =>             'geo',
+		'http://postneo.com/icbm/' =>                             'icbm',
+		'http://purl.org/rss/1.0/modules/image/' =>               'image',
+		'http://www.itunes.com/DTDs/PodCast-1.0.dtd' =>           'itunes',
+		'http://example.com/DTDs/PodCast-1.0.dtd' =>              'itunes',
+		'http://purl.org/rss/1.0/modules/link/' =>                'l',
+		'http://search.yahoo.com/mrss' =>                         'media',
+		'http://madskills.com/public/xml/rss/module/pingback/' => 'pingback',
+		'http://prismstandard.org/namespaces/1.2/basic/' =>       'prism',
+		'http://www.w3.org/1999/02/22-rdf-syntax-ns#' =>          'rdf',
+		'http://www.w3.org/2000/01/rdf-schema#' =>                'rdfs',
+		'http://purl.org/rss/1.0/modules/reference/' =>           'ref',
+		'http://purl.org/rss/1.0/modules/richequiv/' =>           'reqv',
+		'http://purl.org/rss/1.0/modules/search/' =>              'search',
+		'http://purl.org/rss/1.0/modules/slash/' =>               'slash',
+		'http://schemas.xmlsoap.org/soap/envelope/' =>            'soap',
+		'http://purl.org/rss/1.0/modules/servicestatus/' =>       'ss',
+		'http://hacks.benhammersley.com/rss/streaming/' =>        'str',
+		'http://purl.org/rss/1.0/modules/subscription/' =>        'sub',
+		'http://purl.org/rss/1.0/modules/syndication/' =>         'sy',
+		'http://purl.org/rss/1.0/modules/taxonomy/' =>            'taxo',
+		'http://purl.org/rss/1.0/modules/threading/' =>           'thr',
+		'http://purl.org/rss/1.0/modules/textinput/' =>           'ti',
+		'http://madskills.com/public/xml/rss/module/trackback/' =>'trackback',
+		'http://wellformedweb.org/commentAPI/' =>                 'wfw',
+		'http://purl.org/rss/1.0/modules/wiki/' =>                'wiki',
+		'http://www.w3.org/1999/xhtml' =>                         'xhtml',
+		'http://www.w3.org/XML/1998/namespace' =>                 'xml',
+		'http://www.w3.org/1999/xlink' =>                         'xlink',
+		'http://schemas.pocketsoap.com/rss/myDescModule/' =>      'szf'
+    }
+    @matchnamespaces = {}
+    @namespaces.each do |l|
+      @matchnamespaces[l[0].downcase] = l[1]
+    end
+    @can_be_relative_uri = ['link', 'id', 'wfw_comment', 'wfw_commentrss', 'docs', 'url', 'href', 'comments', 'license', 'icon', 'logo']
+    @can_contain_relative_uris = ['content', 'title', 'summary', 'info', 'tagline', 'subtitle', 'copyright', 'rights', 'description']
+    @can_contain_dangerous_markup = ['content', 'title', 'summary', 'info', 'tagline', 'subtitle', 'copyright', 'rights', 'description']
+    @html_types = ['text/html', 'application/xhtml+xml']
+    @feeddata = FeedParserDict.new # feed-level data
+    @encoding = encoding # character encoding
+    @entries = [] # list of entry-level data
+    @version = '' # feed type/version see SUPPORTED_VERSIOSN
+    @namespacesInUse = {} # hash of namespaces defined by the feed
+
+    # the following are used internall to track state;
+    # this is really out of control and should be refactored
+    @infeed = false
+    @inentry = false
+    @incontent = 0 # Yes, this needs to be zero until I work out popContent and pushContent
+    @intextinput = false
+    @inimage = false
+    @inauthor = false
+    @incontributor = false
+    @inpublisher = false
+    @insource = false
+    @sourcedata = FeedParserDict.new
+    @contentparams = FeedParserDict.new
+    @summaryKey = nil
+    @namespacemap = {}
+    @elementstack = []
+    @basestack = []
+    @langstack = []
+    @baseuri = baseuri || ''
+    @lang = baselang || nil
+    if baselang 
+      @feeddata['language'] = baselang.gsub('_','-')
+    end
+    @date_handlers = [:_parse_date_rfc822,
+      :_parse_date_hungarian, :_parse_date_greek,:_parse_date_mssql,
+      :_parse_date_nate,:_parse_date_onblog,:_parse_date_w3dtf,:_parse_date_iso8601
+    ]
+    $stderr << "Leaving startup\n" if $debug # My addition
+  end
+
+  def unknown_starttag(tag, attrsd)
+    $stderr << "start #{tag} with #{attrsd}\n" if $debug
+    # normalize attrs
+    attrsD = {}
+    attrsd = Hash[*attrsd.flatten] if attrsd.class == Array # Magic! Asterisk!
+    # LooseFeedParser needs the above because SGMLParser sends attrs as a 
+    # list of lists (like [['type','text/html'],['mode','escaped']])
+
+    attrsd.each do |old_k,value| 
+      # There has to be a better, non-ugly way of doing this
+      k = old_k.downcase # Downcase all keys
+      attrsD[k] = value
+      if ['rel','type'].include?value
+	attrsD[k].downcase!   # Downcase the value if the key is 'rel' or 'type'
+      end
+    end
+
+    # track xml:base and xml:lang
+    baseuri = attrsD['xml:base'] || attrsD['base'] || @baseuri 
+    @baseuri = urljoin(@baseuri, baseuri)
+    lang = attrsD['xml:lang'] || attrsD['lang']
+    if lang == '' # FIXME This next bit of code is right? Wtf?
+      # xml:lang could be explicitly set to '', we need to capture that
+      lang = nil
+    elsif lang.nil?
+      # if no xml:lang is specified, use parent lang
+      lang = @lang
+    end
+    if lang and not lang.empty? # Seriously, this cannot be correct
+      if ['feed', 'rss', 'rdf:RDF'].include?tag
+	@feeddata['language'] = lang.gsub('_','-')
+      end
+    end
+    @lang = lang
+    @basestack << @baseuri 
+    @langstack << lang
+
+    # track namespaces
+    attrsd.each do |prefix, uri|
+      if /^xmlns:/ =~ prefix # prefix begins with xmlns:
+	trackNamespace(prefix[6..-1], uri)
+      elsif prefix == 'xmlns':
+	trackNamespace(nil, uri)
+      end
+    end
+
+    # track inline content
+    if @incontent != 0 and @contentparams.has_key?('type') and not ( /xml$/ =~ (@contentparams['type'] || 'xml') )
+      # element declared itself as escaped markup, but isn't really
+
+      @contentparams['type'] = 'application/xhtml+xml'
+    end
+    if @incontent != 0 and @contentparams['type'] == 'application/xhtml+xml'
+      # Note: probably shouldn't simply recreate localname here, but
+      # our namespace handling isn't actually 100% correct in cases where
+      # the feed redefines the default namespace (which is actually
+      # the usual case for inline content, thanks Sam), so here we
+      # cheat and just reconstruct the element based on localname
+      # because that compensates for the bugs in our namespace handling.
+      # This will horribly munge inline content with non-empty qnames,
+      # but nobody actually does that, so I'm not fixing it.
+      tag = tag.split(':')[-1]
+      attrsA = attrsd.to_a.collect{|l| "#{l[0]}=\"#{l[1]}\""}
+      attrsS = ' '+attrsA.join(' ')
+      return handle_data("<#{tag}#{attrsS}>", escape=false) 
+    end
+
+    # match namespaces
+    if /:/ =~ tag
+      prefix, suffix = tag.split(':', 2)
+    else
+      prefix, suffix = '', tag
+    end
+    prefix = @namespacemap[prefix] || prefix
+    if prefix and not prefix.empty?
+      prefix = prefix + '_'
+    end
+
+    # special hack for better tracking of empty textinput/image elements in illformed feeds
+    if (not prefix and not prefix.empty?) and not (['title', 'link', 'description','name'].include?tag)
+      @intextinput = false
+    end
+    if (prefix.nil? or prefix.empty?) and not (['title', 'link', 'description', 'url', 'href', 'width', 'height'].include?tag)
+      @inimage = false
+    end
+
+    # call special handler (if defined) or default handler
+    begin
+      return send('_start_'+prefix+suffix, attrsD)
+    rescue NoMethodError
+      return push(prefix + suffix, true) 
+    end  
+  end # End unknown_starttag
+
+  def unknown_endtag(tag)
+    $stderr << "end #{tag}\n" if $debug
+    # match namespaces
+    if tag.index(':')
+      prefix, suffix = tag.split(':',2)
+    else
+      prefix, suffix = '', tag
+    end
+    prefix = @namespacemap[prefix] || prefix
+    if prefix and not prefix.empty?
+      prefix = prefix + '_'
+    end
+
+    # call special handler (if defined) or default handler
+    begin
+      send('_end_' + prefix + suffix) # NOTE no return here! do not add it!
+    rescue NoMethodError => details
+      pop(prefix + suffix)
+    end
+
+    # track inline content
+    if @incontent != 0 and @contentparams.has_key?'type' and /xml$/ =~ (@contentparams['type'] || 'xml')
+      # element declared itself as escaped markup, but it isn't really
+      @contentparams['type'] = 'application/xhtml+xml'
+    end
+    if @incontent != 0 and @contentparams['type'] == 'application/xhtml+xml'
+      tag = tag.split(':')[-1]
+      handle_data("</#{tag}>", escape=false)
+    end
+
+    # track xml:base and xml:lang going out of scope
+    if @basestack and not @basestack.empty?
+      @basestack.pop
+      if @basestack and @basestack[-1] and not (@basestack.empty? or @basestack[-1].empty?)
+	@baseuri = @basestack[-1]
+      end
+    end
+    if @langstack and not @langstack.empty?
+      @langstack.pop
+      if @langstack and not @langstack.empty? # and @langstack[-1] and not @langstack.empty?
+	@lang = @langstack[-1]
+      end
+    end
+  end
+
+  def handle_charref(ref)
+    # LooseParserOnly 
+    # called for each character reference, e.g. for '&#160;', ref will be '160'
+    $stderr << "entering handle_charref with #{ref}\n" if $debug
+    return if @elementstack.nil? or @elementstack.empty? 
+    ref.downcase!
+    chars = ['34', '38', '39', '60', '62', 'x22', 'x26', 'x27', 'x3c', 'x3e']
+    if chars.include?ref
+      text = "&##{ref};"
+    else
+      if ref[0..0] == 'x'
+	c = (ref[1..-1]).to_i(16)
+      else
+	c = ref.to_i
+      end
+      text = [c].pack('U*')
+    end
+    @elementstack[-1][2] << text
+  end
+
+  def handle_entityref(ref)
+    # LooseParserOnly
+    # called for each entity reference, e.g. for '&copy;', ref will be 'copy'
+
+    return if @elementstack.nil? or @elementstack.empty?
+    $stderr << "entering handle_entityref with #{ref}\n" if $debug
+    ents = ['lt', 'gt', 'quot', 'amp', 'apos']
+    if ents.include?ref
+      text = "&#{ref};"
+    else
+      text = HTMLEntities::decode_entities("&#{ref};")
+    end
+    @elementstack[-1][2] << text
+  end
+
+  def handle_data(text, escape=true)
+    # called for each block of plain text, i.e. outside of any tag and
+    # not containing any character or entity references
+    return if @elementstack.nil? or @elementstack.empty?
+    if escape and @contentparams['type'] == 'application/xhtml+xml'
+      text = text.to_xs 
+    end
+    @elementstack[-1][2] << text
+  end
+
+  def handle_comment(comment)
+    # called for each comment, e.g. <!-- insert message here -->
+  end
+
+  def handle_pi(text)
+  end
+
+  def handle_decl(text)
+  end
+
+  def parse_declaration(i)
+    # for LooseFeedParser
+    $stderr << "entering parse_declaration\n" if $debug
+    if @rawdata[i...i+9] == '<![CDATA['
+      k = @rawdata.index(/\]\]>/u,i+9)
+      k = @rawdata.length unless k
+      handle_data(@rawdata[i+9...k].to_xs,false)
+      return k+3
+    else
+      k = @rawdata.index(/>/,i).to_i
+      return k+1
+    end
+  end
+
+  def mapContentType(contentType)
+    contentType.downcase!
+    case contentType
+    when 'text'
+      contentType = 'text/plain'
+    when 'html'
+      contentType = 'text/html'
+    when 'xhtml'
+      contentType = 'application/xhtml+xml'
+    end
+    return contentType
+  end
+
+  def trackNamespace(prefix, uri)
+
+    loweruri = uri.downcase.strip
+    if [prefix, loweruri] == [nil, 'http://my.netscape.com/rdf/simple/0.9/'] and (@version.nil? or @version.empty?)
+      @version = 'rss090'
+    elsif loweruri == 'http://purl.org/rss/1.0/' and (@version.nil? or @version.empty?)
+      @version = 'rss10'
+    elsif loweruri == 'http://www.w3.org/2005/atom' and (@version.nil? or @version.empty?)
+      @version = 'atom10'
+    elsif /backend\.userland\.com\/rss/ =~ loweruri
+      # match any backend.userland.com namespace
+      uri = 'http://backend.userland.com/rss'
+      loweruri = uri
+    end
+    if @matchnamespaces.has_key? loweruri
+      @namespacemap[prefix] = @matchnamespaces[loweruri]
+      @namespacesInUse[@matchnamespaces[loweruri]] = uri
+    else
+      @namespacesInUse[prefix || ''] = uri
+    end
+  end
+
+  def resolveURI(uri)
+    return urljoin(@baseuri || '', uri)
+  end
+
+  def decodeEntities(element, data)
+    return data
+  end
+
+  def push(element, expectingText)
+    @elementstack << [element, expectingText, []]
+  end
+
+  def pop(element, stripWhitespace=true)
+    return if @elementstack.nil? or @elementstack.empty?
+    return if @elementstack[-1][0] != element
+    element, expectingText, pieces = @elementstack.pop
+    if pieces.class == Array
+      output = pieces.join('')
+    else
+      output = pieces
+    end
+    if stripWhitespace
+      output.strip!
+    end
+    return output if not expectingText
+
+    # decode base64 content
+    if @contentparams['base64']
+      out64 = Base64::decode64(output) # a.k.a. [output].unpack('m')[0]
+      if not output.empty? and not out64.empty?
+	output = out64
+      end
+    end
+
+    # resolve relative URIs
+    if @can_be_relative_uri.include?element and output and not output.empty?
+      output = resolveURI(output)
+    end
+
+    # decode entities within embedded markup
+    if not @contentparams['base64']
+      output = decodeEntities(element, output)
+    end
+
+    # remove temporary cruft from contentparams
+    @contentparams.delete('mode')
+    @contentparams.delete('base64')
+
+    # resolve relative URIs within embedded markup
+    if @html_types.include?mapContentType(@contentparams['type'] || 'text/html')
+      if @can_contain_relative_uris.include?element
+	output = FeedParser.resolveRelativeURIs(output, @baseuri, @encoding)
+      end
+    end
+    # sanitize embedded markup
+    if @html_types.include?mapContentType(@contentparams['type'] || 'text/html')
+      if @can_contain_dangerous_markup.include?element
+	output = FeedParser.sanitizeHTML(output, @encoding)
+      end
+    end
+
+    if @encoding and not @encoding.empty? and @encoding != 'utf-8'
+      output = uconvert(output, @encoding, 'utf-8') 
+      # FIXME I turn everything into utf-8, not unicode, originally because REXML was being used but now beause I haven't tested it out yet.
+    end
+
+    # categories/tags/keywords/whatever are handled in _end_category
+    return output if element == 'category'
+
+    # store output in appropriate place(s)
+    if @inentry and not @insource
+      if element == 'content'
+	@entries[-1][element] ||= []
+	contentparams = Marshal.load(Marshal.dump(@contentparams)) # deepcopy
+	contentparams['value'] = output
+	@entries[-1][element] << contentparams
+      elsif element == 'link'
+	@entries[-1][element] = output
+	if output and not output.empty?
+	  @entries[-1]['links'][-1]['href'] = output
+	end
+      else
+	element = 'summary' if element == 'description'
+	@entries[-1][element] = output
+	if @incontent != 0
+	  contentparams = Marshal.load(Marshal.dump(@contentparams))
+	  contentparams['value'] = output
+	  @entries[-1][element + '_detail'] = contentparams
+	end
+      end
+    elsif (@infeed or @insource) and not @intextinput and not @inimage
+      context = getContext()
+      element = 'subtitle' if element == 'description'
+      context[element] = output
+      if element == 'link'
+	context['links'][-1]['href'] = output
+      elsif @incontent != 0
+	contentparams = Marshal.load(Marshal.dump(@contentparams))
+	contentparams['value'] = output
+	context[element + '_detail'] = contentparams
+      end
+    end
+    return output
+  end
+
+  def pushContent(tag, attrsD, defaultContentType, expectingText)
+    @incontent += 1 # Yes, I hate this.
+    type = mapContentType(attrsD['type'] || defaultContentType)
+    @contentparams = FeedParserDict.new({'type' => type,'language' => @lang,'base' => @baseuri})
+    @contentparams['base64'] = isBase64(attrsD, @contentparams)
+    push(tag, expectingText)
+  end
+
+  def popContent(tag)
+    value = pop(tag)
+    @incontent -= 1
+    @contentparams.clear
+    return value
+  end
+
+  def mapToStandardPrefix(name)
+    colonpos = name.index(':')
+    if colonpos
+      prefix = name[0..colonpos-1]
+      suffix = name[colonpos+1..-1]
+      prefix = @namespacemap[prefix] || prefix
+      name = prefix + ':' + suffix
+    end
+    return name
+  end
+
+  def getAttribute(attrsD, name)
+    return attrsD[mapToStandardPrefix(name)]
+  end
+
+  def isBase64(attrsD, contentparams)
+    return true if (attrsD['mode'] == 'base64')
+    if /(^text\/)|(\+xml$)|(\/xml$)/ =~ contentparams['type']
+      return false
+    end
+    return true
+  end
+
+  def itsAnHrefDamnIt(attrsD)
+    href= attrsD['url'] || attrsD['uri'] || attrsD['href'] 
+    if href
+      attrsD.delete('url')
+      attrsD.delete('uri')
+      attrsD['href'] = href
+    end
+    return attrsD
+  end
+
+
+  def _save(key, value)
+    context = getContext()
+    context[key] ||= value
+  end
+
+  def _start_rss(attrsD)
+    versionmap = {'0.91' => 'rss091u',
+		  '0.92' => 'rss092',
+		  '0.93' => 'rss093',
+		  '0.94' => 'rss094'
+    }
+
+    if not @version or @version.empty?
+      attr_version = attrsD['version'] || ''
+      version = versionmap[attr_version]
+      if version and not version.empty?
+	@version = version
+      elsif /^2\./ =~ attr_version
+	@version = 'rss20'
+      else
+	@version = 'rss'
+      end
+    end
+  end
+
+  def _start_dlhottitles(attrsD)
+    @version = 'hotrss'
+  end
+
+  def _start_channel(attrsD)
+    @infeed = true
+    _cdf_common(attrsD)
+  end
+  alias :_start_feedinfo :_start_channel
+
+  def _cdf_common(attrsD)
+    if attrsD.has_key?'lastmod'
+      _start_modified({})
+      @elementstack[-1][-1] = attrsD['lastmod']
+      _end_modified
+    end
+    if attrsD.has_key?'href'
+      _start_link({})
+      @elementstack[-1][-1] = attrsD['href']
+      _end_link
+    end
+  end
+
+  def _start_feed(attrsD)
+    @infeed = true 
+    versionmap = {'0.1' => 'atom01',
+		  '0.2' => 'atom02',
+		  '0.3' => 'atom03'
+    }
+
+    if not @version or @version.empty?
+      attr_version = attrsD['version']
+      version = versionmap[attr_version]
+      if @version and not @version.empty?
+	@version = version
+      else
+	@version = 'atom'
+      end
+    end
+  end
+
+  def _end_channel
+    @infeed = false
+  end
+  alias :_end_feed :_end_channel
+
+  def _start_image(attrsD)
+    @inimage = true
+    push('image', false)
+    context = getContext()
+    context['image'] ||= FeedParserDict.new
+  end
+
+  def _end_image
+    pop('image')
+    @inimage = false
+  end
+
+  def _start_textinput(attrsD)
+    @intextinput = true
+    push('textinput', false)
+    context = getContext()
+    context['textinput'] ||= FeedParserDict.new
+  end
+  alias :_start_textInput :_start_textinput
+
+  def _end_textinput
+    pop('textinput')
+    @intextinput = false
+  end
+  alias :_end_textInput :_end_textinput
+
+  def _start_author(attrsD)
+    @inauthor = true
+    push('author', true)
+  end
+  alias :_start_managingeditor :_start_author
+  alias :_start_dc_author :_start_author
+  alias :_start_dc_creator :_start_author
+  alias :_start_itunes_author :_start_author
+
+  def _end_author
+    pop('author')
+    @inauthor = false
+    _sync_author_detail()
+  end
+  alias :_end_managingeditor :_end_author
+  alias :_end_dc_author :_end_author
+  alias :_end_dc_creator :_end_author
+  alias :_end_itunes_author :_end_author
+
+  def _start_itunes_owner(attrsD)
+    @inpublisher = true
+    push('publisher', false)
+  end
+
+  def _end_itunes_owner
+    pop('publisher')
+    @inpublisher = false
+    _sync_author_detail('publisher')
+  end
+
+  def _start_contributor(attrsD)
+    @incontributor = true
+    context = getContext()
+    context['contributors'] ||= []
+    context['contributors'] << FeedParserDict.new
+    push('contributor', false)
+  end
+
+  def _end_contributor
+    pop('contributor')
+    @incontributor = false
+  end
+
+  def _start_dc_contributor(attrsD)
+    @incontributor = true
+    context = getContext()
+    context['contributors'] ||= []
+    context['contributors'] << FeedParserDict.new
+    push('name', false)
+  end
+
+  def _end_dc_contributor
+    _end_name
+    @incontributor = false
+  end
+
+  def _start_name(attrsD)
+    push('name', false)
+  end
+  alias :_start_itunes_name :_start_name
+
+  def _end_name
+    value = pop('name')
+    if @inpublisher
+      _save_author('name', value, 'publisher')
+    elsif @inauthor
+      _save_author('name', value)
+    elsif @incontributor
+      _save_contributor('name', value)
+    elsif @intextinput
+      context = getContext()
+      context['textinput']['name'] = value
+    end
+  end
+  alias :_end_itunes_name :_end_name
+
+  def _start_width(attrsD)
+    push('width', false)
+  end
+
+  def _end_width
+    value = pop('width').to_i
+    if @inimage 
+      context = getContext
+      context['image']['width'] = value
+    end
+  end
+
+  def _start_height(attrsD)
+    push('height', false)
+  end
+
+  def _end_height
+    value = pop('height').to_i
+    if @inimage
+      context = getContext()
+      context['image']['height'] = value
+    end
+  end
+
+  def _start_url(attrsD)
+    push('href', true)
+  end
+  alias :_start_homepage :_start_url
+  alias :_start_uri :_start_url
+
+  def _end_url
+    value = pop('href')
+    if @inauthor
+      _save_author('href', value)
+    elsif @incontributor
+      _save_contributor('href', value)
+    elsif @inimage
+      context = getContext()
+      context['image']['href'] = value
+    elsif @intextinput
+      context = getContext()
+      context['textinput']['link'] = value
+    end
+  end
+  alias :_end_homepage :_end_url
+  alias :_end_uri :_end_url
+
+  def _start_email(attrsD)
+    push('email', false)
+  end
+  alias :_start_itunes_email :_start_email
+
+  def _end_email
+    value = pop('email')
+    if @inpublisher
+      _save_author('email', value, 'publisher')
+    elsif @inauthor
+      _save_author('email', value)
+    elsif @incontributor
+      _save_contributor('email', value)
+    end
+  end
+  alias :_end_itunes_email :_end_email
+
+  def getContext
+    if @insource
+      context = @sourcedata
+    elsif @inentry
+      context = @entries[-1]
+    else
+      context = @feeddata
+    end
+    return context
+  end
+
+  def _save_author(key, value, prefix='author')
+    context = getContext()
+    context[prefix + '_detail'] ||= FeedParserDict.new
+    context[prefix + '_detail'][key] = value
+    _sync_author_detail()
+  end
+
+  def _save_contributor(key, value)
+    context = getContext
+    context['contributors'] ||= [FeedParserDict.new]
+    context['contributors'][-1][key] = value
+  end
+
+  def _sync_author_detail(key='author')
+    context = getContext()
+    detail = context["#{key}_detail"]
+    if detail and not detail.empty?
+      name = detail['name']
+      email = detail['email']
+
+      if name and email and not (name.empty? or name.empty?)
+	context[key] = "#{name} (#{email})"
+      elsif name and not name.empty?
+	context[key] = name
+      elsif email and not email.empty?
+	context[key] = email
+      end
+    else
+      author = context[key].dup unless context[key].nil?
+      return if not author or author.empty?
+      emailmatch = author.match(/(([a-zA-Z0-9\_\-\.\+]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([a-zA-Z0-9\-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?))/)
+      email = emailmatch[1]
+      author.gsub!(email, '')
+      author.gsub!("\(\)", '')
+      author.strip!
+      author.gsub!(/^\(/,'')
+		   author.gsub!(/\)$/,'')
+		   author.strip!
+		   context["#{key}_detail"] ||= FeedParserDict.new
+		   context["#{key}_detail"]['name'] = author
+		   context["#{key}_detail"]['email'] = email
+    end
+  end
+
+  def _start_subtitle(attrsD)
+    pushContent('subtitle', attrsD, 'text/plain', true)
+  end
+  alias :_start_tagline :_start_subtitle
+  alias :_start_itunes_subtitle :_start_subtitle
+
+  def _end_subtitle
+    popContent('subtitle')
+  end
+  alias :_end_tagline :_end_subtitle
+  alias :_end_itunes_subtitle :_end_subtitle
+
+  def _start_rights(attrsD)
+    pushContent('rights', attrsD, 'text/plain', true)
+  end
+  alias :_start_dc_rights :_start_rights
+  alias :_start_copyright :_start_rights
+
+  def _end_rights
+    popContent('rights')
+  end
+  alias :_end_dc_rights :_end_rights
+  alias :_end_copyright :_end_rights
+
+  def _start_item(attrsD)
+    @entries << FeedParserDict.new
+    push('item', false)
+    @inentry = true
+    @guidislink = false
+    id = getAttribute(attrsD, 'rdf:about')
+    if id and not id.empty?
+      context = getContext()
+      context['id'] = id
+    end
+    _cdf_common(attrsD)
+  end
+  alias :_start_entry :_start_item
+  alias :_start_product :_start_item
+
+  def _end_item
+    pop('item')
+    @inentry = false
+  end
+  alias :_end_entry :_end_item
+
+  def _start_dc_language(attrsD)
+    push('language', true)
+  end
+  alias :_start_language :_start_dc_language
+
+  def _end_dc_language
+    @lang = pop('language')
+  end
+  alias :_end_language :_end_dc_language
+
+  def _start_dc_publisher(attrsD)
+    push('publisher', true)
+  end
+  alias :_start_webmaster :_start_dc_publisher
+
+  def _end_dc_publisher
+    pop('publisher')
+    _sync_author_detail('publisher')
+  end
+  alias :_end_webmaster :_end_dc_publisher
+
+  def _start_published(attrsD)
+    push('published', true)
+  end
+  alias :_start_dcterms_issued :_start_published
+  alias :_start_issued :_start_published
+
+  def _end_published
+    value = pop('published')
+    _save('published_parsed', parse_date(value))
+  end
+  alias :_end_dcterms_issued :_end_published
+  alias :_end_issued :_end_published
+
+  def _start_updated(attrsD)
+    push('updated', true)
+  end
+  alias :_start_modified :_start_updated
+  alias :_start_dcterms_modified :_start_updated
+  alias :_start_pubdate :_start_updated
+  alias :_start_dc_date :_start_updated
+
+  def _end_updated
+    value = pop('updated')
+    _save('updated_parsed', parse_date(value))
+  end
+  alias :_end_modified :_end_updated
+  alias :_end_dcterms_modified :_end_updated
+  alias :_end_pubdate :_end_updated
+  alias :_end_dc_date :_end_updated
+
+  def _start_created(attrsD)
+    push('created', true)
+  end
+  alias :_start_dcterms_created :_start_created
+
+  def _end_created
+    value = pop('created')
+    _save('created_parsed', parse_date(value))
+  end
+  alias :_end_dcterms_created :_end_created
+
+  def _start_expirationdate(attrsD)
+    push('expired', true)
+  end
+  def _end_expirationdate
+    _save('expired_parsed', parse_date(pop('expired')))
+  end
+
+  def _start_cc_license(attrsD)
+    push('license', true)
+    value = getAttribute(attrsD, 'rdf:resource')
+    if value and not value.empty?
+      @elementstack[-1][2] <<  value
+      pop('license')
+    end
+  end
+
+  def _start_creativecommons_license(attrsD)
+    push('license', true)
+  end
+
+  def _end_creativecommons_license
+    pop('license')
+  end
+
+  def addTag(term, scheme, label)
+    context = getContext()
+    context['tags'] ||= []
+    tags = context['tags']
+    if (term.nil? or term.empty?) and (scheme.nil? or scheme.empty?) and (label.nil? or label.empty?)
+      return
+    end
+    value = FeedParserDict.new({'term' => term, 'scheme' => scheme, 'label' => label})
+    if not tags.include?value
+      context['tags'] << FeedParserDict.new({'term' => term, 'scheme' => scheme, 'label' => label})
+    end
+  end
+
+  def _start_category(attrsD)
+    $stderr << "entering _start_category with #{attrsD}\n" if $debug
+
+    term = attrsD['term']
+    scheme = attrsD['scheme'] || attrsD['domain']
+    label = attrsD['label']
+    addTag(term, scheme, label)
+    push('category', true)
+  end
+  alias :_start_dc_subject :_start_category
+  alias :_start_keywords :_start_category
+
+  def _end_itunes_keywords
+    pop('itunes_keywords').split.each do |term|
+      addTag(term, 'http://www.itunes.com/', nil)
+    end
+  end
+
+  def _start_itunes_category(attrsD)
+    addTag(attrsD['text'], 'http://www.itunes.com/', nil)
+    push('category', true)
+  end
+
+  def _end_category
+    value = pop('category')
+    return if value.nil? or value.empty?
+    context = getContext()
+    tags = context['tags']
+    if value and not value.empty? and not tags.empty? and not tags[-1]['term']:
+      tags[-1]['term'] = value
+    else
+      addTag(value, nil, nil)
+    end
+  end
+  alias :_end_dc_subject :_end_category
+  alias :_end_keywords :_end_category
+  alias :_end_itunes_category :_end_category
+
+  def _start_cloud(attrsD)
+    getContext()['cloud'] = FeedParserDict.new(attrsD)
+  end
+
+  def _start_link(attrsD)
+    attrsD['rel'] ||= 'alternate'
+    attrsD['type'] ||= 'text/html'
+    attrsD = itsAnHrefDamnIt(attrsD)
+    if attrsD.has_key? 'href'
+      attrsD['href'] = resolveURI(attrsD['href'])
+    end
+    expectingText = @infeed || @inentry || @insource
+    context = getContext()
+    context['links'] ||= []
+    context['links'] << FeedParserDict.new(attrsD)
+    if attrsD['rel'] == 'enclosure'
+      _start_enclosure(attrsD)
+    end
+    if attrsD.has_key? 'href'
+      expectingText = false
+      if (attrsD['rel'] == 'alternate') and @html_types.include?mapContentType(attrsD['type'])
+	context['link'] = attrsD['href']
+      end
+    else
+      push('link', expectingText)
+    end
+  end
+  alias :_start_producturl :_start_link
+
+  def _end_link
+    value = pop('link')
+    context = getContext()
+    if @intextinput
+      context['textinput']['link'] = value
+    end
+    if @inimage
+      context['image']['link'] = value
+    end
+  end
+  alias :_end_producturl :_end_link
+
+  def _start_guid(attrsD)
+    @guidislink = ((attrsD['ispermalink'] || 'true') == 'true')
+    push('id', true)
+  end
+
+  def _end_guid
+    value = pop('id')
+    _save('guidislink', (@guidislink and not getContext().has_key?('link')))
+    if @guidislink:
+      # guid acts as link, but only if 'ispermalink' is not present or is 'true',
+      # and only if the item doesn't already have a link element
+      _save('link', value)
+    end
+  end
+
+
+  def _start_title(attrsD)
+    pushContent('title', attrsD, 'text/plain', @infeed || @inentry || @insource)
+  end
+  alias :_start_dc_title :_start_title
+  alias :_start_media_title :_start_title
+
+  def _end_title
+    value = popContent('title')
+    context = getContext()
+    if @intextinput
+      context['textinput']['title'] = value
+    elsif @inimage
+      context['image']['title'] = value
+    end
+  end
+  alias :_end_dc_title :_end_title
+  alias :_end_media_title :_end_title
+
+  def _start_description(attrsD)
+    context = getContext()
+    if context.has_key?('summary')
+      @summaryKey = 'content'
+      _start_content(attrsD)
+    else
+      pushContent('description', attrsD, 'text/html', @infeed || @inentry || @insource)
+    end
+  end
+
+  def _start_abstract(attrsD)
+    pushContent('description', attrsD, 'text/plain', @infeed || @inentry || @insource)
+  end
+
+  def _end_description
+    if @summaryKey == 'content'
+      _end_content()
+    else
+      value = popContent('description')
+      context = getContext()
+      if @intextinput
+	context['textinput']['description'] = value
+      elsif @inimage:
+	context['image']['description'] = value
+      end
+    end
+    @summaryKey = nil
+  end
+  alias :_end_abstract :_end_description
+
+  def _start_info(attrsD)
+    pushContent('info', attrsD, 'text/plain', true)
+  end
+  alias :_start_feedburner_browserfriendly :_start_info
+
+  def _end_info
+    popContent('info')
+  end
+  alias :_end_feedburner_browserfriendly :_end_info
+
+  def _start_generator(attrsD)
+    if attrsD and not attrsD.empty?
+      attrsD = itsAnHrefDamnIt(attrsD)
+      if attrsD.has_key?('href')
+	attrsD['href'] = resolveURI(attrsD['href'])
+      end
+    end
+    getContext()['generator_detail'] = FeedParserDict.new(attrsD)
+    push('generator', true)
+  end
+
+  def _end_generator
+    value = pop('generator')
+    context = getContext()
+    if context.has_key?('generator_detail')
+      context['generator_detail']['name'] = value
+    end
+  end
+
+  def _start_admin_generatoragent(attrsD)
+    push('generator', true)
+    value = getAttribute(attrsD, 'rdf:resource')
+    if value and not value.empty?
+      @elementstack[-1][2] << value
+    end
+    pop('generator')
+    getContext()['generator_detail'] = FeedParserDict.new({'href' => value})
+  end
+
+  def _start_admin_errorreportsto(attrsD)
+    push('errorreportsto', true)
+    value = getAttribute(attrsD, 'rdf:resource')
+    if value and not value.empty?
+      @elementstack[-1][2] << value
+    end
+    pop('errorreportsto')
+  end
+
+  def _start_summary(attrsD)
+    context = getContext()
+    if context.has_key?'summary'
+      @summaryKey = 'content'
+      _start_content(attrsD)
+    else
+      @summaryKey = 'summary'
+      pushContent(@summaryKey, attrsD, 'text/plain', true)
+    end
+  end
+  alias :_start_itunes_summary :_start_summary
+
+  def _end_summary
+    if @summaryKey == 'content':
+      _end_content()
+    else
+      popContent(@summaryKey || 'summary')
+    end
+    @summaryKey = nil
+  end
+  alias :_end_itunes_summary :_end_summary
+
+  def _start_enclosure(attrsD)
+    attrsD = itsAnHrefDamnIt(attrsD)
+    getContext()['enclosures'] ||= []
+    getContext()['enclosures'] << FeedParserDict.new(attrsD)
+    href = attrsD['href']
+    if href and not href.empty?
+      context = getContext()
+      if not context['id']
+	context['id'] = href
+      end
+    end
+  end
+
+  def _start_source(attrsD)
+    @insource = true
+  end
+
+  def _end_source
+    @insource = false
+    getContext()['source'] = Marshal.load(Marshal.dump(@sourcedata))
+    @sourcedata.clear()
+  end
+
+  def _start_content(attrsD)
+    pushContent('content', attrsD, 'text/plain', true)
+    src = attrsD['src']
+    if src and not src.empty?:
+      @contentparams['src'] = src
+    end
+    push('content', true)
+  end
+
+  def _start_prodlink(attrsD)
+    pushContent('content', attrsD, 'text/html', true)
+  end
+
+  def _start_body(attrsD)
+    pushContent('content', attrsD, 'application/xhtml+xml', true)
+  end
+  alias :_start_xhtml_body :_start_body
+
+  def _start_content_encoded(attrsD)
+    pushContent('content', attrsD, 'text/html', true)
+  end
+  alias :_start_fullitem :_start_content_encoded
+
+  def _end_content
+    copyToDescription = (['text/plain'] + @html_types).include? mapContentType(@contentparams['type'])
+    value = popContent('content')
+    if copyToDescription
+      _save('description', value)
+    end
+    alias :_end_body :_end_content
+    alias :_end_xhtml_body :_end_content
+    alias :_end_content_encoded :_end_content
+    alias :_end_fullitem :_end_content
+    alias :_end_prodlink :_end_content
+  end
+
+  def _start_itunes_image(attrsD)
+    push('itunes_image', false)
+    getContext()['image'] = FeedParserDict.new({'href' => attrsD['href']})
+  end
+  alias :_start_itunes_link :_start_itunes_image
+
+  def _end_itunes_block
+    value = pop('itunes_block', false)
+    getContext()['itunes_block'] = (value == 'yes') and true or false
+  end
+
+  def _end_itunes_explicit
+    value = pop('itunes_explicit', false)
+    getContext()['itunes_explicit'] = (value == 'yes') and true or false
+  end
+end # End FeedParserMixin
+
+