rfeedparser 0.9.9 → 0.9.85

data/lib/rfeedparser/feedparserdict.rb

@@ -1,93 +0,0 @@
-#!/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

@@ -1,93 +0,0 @@
-#!/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

@@ -1,73 +0,0 @@
-#!/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

@@ -1,1235 +0,0 @@
-#!/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
-
-