feedparser 0.2.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 747fe0251bd3069a2c17b9ef047673386410b314
-  data.tar.gz: 2d5e9a169f84b90e3fd5b66c4b614e5b57adc82e
+  metadata.gz: 8986d2c787017a536660de47dc443469b6eb2a0a
+  data.tar.gz: 94441f640c433a63de4f94ffcfbd993af0e4139b
 SHA512:
-  metadata.gz: 4042d15f3212979e796b7e979acf27f8da6d19fa8105580649d7bd8239f3f73620a0b99ec7254b11f6a77f3e7db10abe7b87126f10551265c6e8574ba1b62efa
-  data.tar.gz: 1b1545a13e22c2320020d32b3d4a7a817c6d22d692df9d5a72c70cb1cb6a383cc12d59f279f9ef5734034f17f9a8169561db8d263cfa2c56471dfdd964ecb80e
+  metadata.gz: 0643b97dc231542d7e0c426191afa625e1114b60c2828abd9615f339509f63d36f6c44fa463877c3932dd9ef6739295eaba24af98d2c942f382398c7e91352d0
+  data.tar.gz: fc838c9f2e4875ff8def0c2855b69bd1786d2391ce9298480cf9b6782915fd88c91c22f961c9f59c17b5e16fcb8b3eb14a0929263c4e2b98fe86cd1d7a26a0ab

data/Manifest.txt

@@ -11,8 +11,15 @@ lib/feedparser/parser.rb
 lib/feedparser/version.rb
 test/feeds/googlegroups.atom
 test/feeds/googlegroups2.atom
-test/feeds/quirksblog.atom.v03
+test/feeds/headius.atom
+test/feeds/lambdatheultimate.rss2
+test/feeds/railstutorial.atom
+test/feeds/rubyflow.rss2
+test/feeds/rubymine.rss2
+test/feeds/rubyonrails.atom
+test/feeds/sitepoint.rss2
 test/helper.rb
 test/test_atom.rb
-test/test_atom_from_file.rb
+test/test_atom_live.rb
 test/test_rss.rb
+test/test_rss_live.rb

data/README.md

@@ -17,24 +17,49 @@ Feed • Item
 
 ### `Feed` Struct
 
+#### Mappings
+
+Note: uses question mark (`?`) for optional elements (otherwise assume required elements)
+
+**Title 'n' Summary**
+
+Note: The Feed parser will remove all html tags and attributes from the title (RSS 2.0+Atom), 
+description (RSS 2.0) and subtitle (Atom) content and will unescape HTML entities e.g. `&` becomes & and so on - always
+resulting in plain vanilla text.
+
+| Feed Struct        | RSS 2.0           | Notes               | Atom          | Notes               |
+| ------------------ | ----------------- | ------------------- | ------------- | ------------------- |
+| `feed.title`       | `title`           | plain vanilla text  | `title`       | plain vanilla text  |
+| `feed.summary`     | `description`     | plain vanilla text  | `subtitle`?   | plain vanilla text  |
+
+
+**Dates**
+
+| Feed Struct        | RSS 2.0             | Notes             | Atom       | Notes           |
+| ------------------ | ------------------- | ----------------- | ---------- | --------------- |
+| `feed.updated`     | `lastBuildDate`?    | RFC-822 format    | `updated`  | ISO 801 format  |
+| `feed.published`   | `pubDate`?          | RFC-822 format    |  -         |                 |
+
+Note: Check - for RSS 2.0 set feed.updated to pubDate or lastBuildDate if only one present? if both present - map as above. 
+
+
+RFC-822 date format e.g. Wed, 14 Jan 2015 19:48:57 +0100
+
+ISO-801 date format e.g. 2015-01-11T09:30:16Z
+
+
 ~~~
 class Feed
   attr_accessor :format   # e.g. atom|rss 2.0|etc.
-  attr_accessor :title
-  attr_accessor :title_type  # e.g. text|html|html-escaped  (optional) -use - why?? why not??
+  attr_accessor :title    # note: always plain vanilla text - if present html tags will get stripped and html entities unescaped
   attr_accessor :url
 
   attr_accessor :items
 
-  attr_accessor :summary        # e.g. description (rss)
-  attr_accessor :summary_type   # e.g. text|html|html-escaped
-
-  attr_accessor :title2         # e.g. subtitle (atom)
-  attr_accessor :title2_type    # e.g. text|html|html-escaped
+  attr_accessor :summary   # note: is description in RSS 2.0 and subtitle in Atom; always plain vanilla text
 
-  attr_accessor :published
-  attr_accessor :updated
-  attr_accessor :built
+  attr_accessor :updated     # note: is lastBuildDate in RSS 2.0
+  attr_accessor :published   # note: is pubDate in RSS 2.0; not available in Atom
 
   attr_accessor :generator
   attr_accessor :generator_version  # e.g. @version (atom)
@@ -45,20 +70,48 @@ end
 
 ### `Item` Struct
 
+**Title 'n' Summary**
+
+Note: The Feed parser will remove all html tags and attributes from the title (RSS 2.0+Atom), 
+description (RSS 2.0) and summary (Atom) content
+and will unescape HTML entities e.g. `&` becomes & and so on - always
+resulting in plain vanilla text.
+
+Note: In plain vanilla RSS 2.0 there's no difference between (full) content and summary - everything is wrapped
+in a description element; however, best practice is using the content "module" from RSS 1.0 inside RSS 2.0.
+If there's no content module present the feed parser will "clone" the description and use one version for `item.summary` and
+the clone for `item.content`.
+
+Note: The content element will assume html content.
+
+| Feed Struct        | RSS 2.0           | Notes               | Atom          | Notes               |
+| ------------------ | ----------------- | ------------------- | ------------- | ------------------- |
+| `item.title`       | `title`           | plain vanilla text  | `title`       | plain vanilla text  |
+| `item.summary`     | `description`     | plain vanilla text  | `summary`?    | plain vanilla text  |
+| `item.content`     | `content`?        | html                | `content`?    | html                |
+
+
+**Dates**
+
+| Item Struct        | RSS 2.0             | Notes             | Atom          | Notes           |
+| ------------------ | ------------------- | ----------------- | ------------- | --------------- |
+| `item.updated`     | `pubDate`?          | RFC-822 format    | `updated`     | ISO 801 format  |
+| `item.published`   | -                   | RFC-822 format    | `published`?  | ISO 801 format  |
+
+Note: In plain vanilla RSS 2.0 there's only one `pubDate` for items, thus, it's not possible to differeniate between published and updated dates for items; note - the `item.pubDate` will get mapped to `item.updated`. To set the published date in RSS 2.0 use the dublin core module e.g `dc:created`, for example.
+
 ~~~
 class Item
-  attr_accessor :title
-  attr_accessor :title_type    # optional for now (text|html|html-escaped) - not yet set
-  attr_accessor :url           # todo: rename to link (use alias) ??
+  attr_accessor :title   # note: always plain vanilla text - if present html tags will get stripped and html entities
+  attr_accessor :url
 
   attr_accessor :content
   attr_accessor :content_type  # optional for now (text|html|html-escaped|binary-base64) - not yet set
 
   attr_accessor :summary
-  attr_accessor :summary_type  # optional for now (text|html|html-escaped) - not yet set
 
-  attr_accessor :published
-  attr_accessor :updated
+  attr_accessor :updated    # note: is pubDate in RSS 2.0 and updated in Atom
+  attr_accessor :published  # note: is published in Atom; not available in RSS 2.0 (use dc:created ??)
 
   attr_accessor :guid     # todo: rename to id (use alias) ??
 end
@@ -78,17 +131,6 @@ pp feed
 ~~~
 
 
-
-## Alternatives
-
-- [`syndication`](http://syndication.rubyforge.org) [(Source)](https://github.com/lpar/syndication) - by Mathew (aka lpar);  RSS 1.0, 2.0, Atom, and understands namespaces; optional support for Dublin Core, iTunes/podcast feeds, and RSS 1.0 Syndication and Content modules
-- [`simple-rss`](http://rubyforge.org/projects/simple-rss)
-- [`feedtools`](http://rubyforge.org/projects/feedtools)
-
-TBD
-
-
-
 ## Install
 
 Just install the gem:

data/Rakefile

@@ -18,7 +18,8 @@ Hoe.spec 'feedparser' do
   self.history_file = 'HISTORY.md'
 
   self.extra_deps = [
-    ['logutils', '>= 0.6.1']
+    ['logutils', '>=0.6.1'],
+    ['textutils', '>=1.0.0'],
   ]
 
   ###  todo: add fetcher dep for testing (e.g. development only)

data/lib/feedparser.rb

@@ -1,12 +1,18 @@
+# encoding: utf-8
+
+
 # core and stdlibs
 
 require 'rss'
 require 'pp'
-require 'date'
+require 'time'    # note: ruby has a builtin core time class and a stdlib time class pack; require stdlib extensions 
+require 'date'    # note: ruby has a builtin core date class and a stdlib date class pack; require stdlib extensions 
 
 # 3rd party gems/libs
 
 require 'logutils'
+require 'textutils'
+
 
 # our own code
 

data/lib/feedparser/builder/atom.rb

@@ -1,3 +1,4 @@
+# encoding: utf-8
 
 module FeedParser
 
@@ -5,6 +6,12 @@ class AtomFeedBuilder
 
   include LogUtils::Logging
 
+
+  def self.build( atom_feed )
+    feed = self.new( atom_feed )
+    feed.to_feed
+  end
+
   def initialize( atom_feed )
     @feed = build_feed( atom_feed )
   end
@@ -13,28 +20,21 @@ class AtomFeedBuilder
     @feed
   end
 
-  def self.build( atom_feed )
-    feed = self.new( atom_feed )
-    feed.to_feed
-  end
 
 
   def build_feed( atom_feed )
     feed = Feed.new
-    ## feed.object = atom_feed  # not use for now
     feed.format = 'atom'
 
-    feed.title  = atom_feed.title.content
-    logger.debug "  atom | title.content  >#{atom_feed.title.content}< : #{atom_feed.title.content.class.name}"
-
+    feed.title  = handle_content( atom_feed.title, 'feed.title' )
 
-    logger.debug "  atom | id.content  >#{atom_feed.id.content}< : #{atom_feed.id.content.class.name}"
+    logger.debug "  atom | feed.id.content  >#{atom_feed.id.content}< : #{atom_feed.id.content.class.name}"
 
     feed.url = nil
 
     ## note: use links (plural to allow multiple links e.g. self,alternate,etc.)
     atom_feed.links.each_with_index do |link,i|
-      logger.debug "  atom | link[#{i+1}] link rel=>#{link.rel}< : #{link.rel.class.name} type=#{link.type} href=#{link.href}"
+      logger.debug "  atom | feed.link[#{i+1}]  rel=>#{link.rel}< : #{link.rel.class.name} type=>#{link.type}< href=>#{link.href}<"
 
       ## for now assume alternate is link or no rel specified (assumes alternate)
       ##   note: only set if feed.url is NOT already set (via <id> for example)
@@ -43,7 +43,11 @@ class AtomFeedBuilder
       end
     end
 
-    ## note: as fallback try id if still no url found
+    if feed.url.nil?
+      ### todo/fix: issue warning - no link found!!!!
+    end
+
+    ## note: as fallback try id if still no url found - why?? why not??
     ##   use url only if starts_with http
     ##     might not be link e.g blogger uses for ids =>
     ##    <id>tag:blogger.com,1999:blog-4704664917418794835</id>
@@ -58,30 +62,23 @@ class AtomFeedBuilder
 
 
     if atom_feed.updated
-      # NOTE: empty updated.content e.g.  used by google groups feed
-      #   will return nil : NilClass
-      
-      ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
-      
-      feed.updated =  atom_feed.updated.content.nil?  ? nil : atom_feed.updated.content.to_datetime  #  .utc.strftime( "%Y-%m-%d %H:%M" )
-      logger.debug "  atom | updated.content  >#{atom_feed.updated.content}< : #{atom_feed.updated.content.class.name}"
+      feed.updated = handle_date( atom_feed.updated, 'feed.updated' )
     end
 
     if atom_feed.generator
       ## Note: remove (strip) leading and trailing spaces and newlines
       feed.generator =  atom_feed.generator.content.strip
-      logger.debug "  atom | generator.content  >#{atom_feed.generator.content}< : #{atom_feed.generator.content.class.name}"
+      logger.debug "  atom | feed.generator.content  >#{atom_feed.generator.content}< : #{atom_feed.generator.content.class.name}"
 
       # pp atom_feed.generator
       feed.generator_version = atom_feed.generator.version
       feed.generator_uri     = atom_feed.generator.uri
-      logger.debug "  atom | generator.version  >#{atom_feed.generator.version}< : #{atom_feed.generator.version.class.name}"
-      logger.debug "  atom | generator.uri      >#{atom_feed.generator.uri}< : #{atom_feed.generator.uri.class.name}"
+      logger.debug "  atom | feed.generator.version  >#{atom_feed.generator.version}< : #{atom_feed.generator.version.class.name}"
+      logger.debug "  atom | feed.generator.uri      >#{atom_feed.generator.uri}< : #{atom_feed.generator.uri.class.name}"
     end
 
     if atom_feed.subtitle
-      feed.title2 =  atom_feed.subtitle.content
-      logger.debug "  atom | subtitle.content  >#{atom_feed.subtitle.content}< : #{atom_feed.subtitle.content.class.name}"
+      feed.summary =  handle_content( atom_feed.subtitle, 'feed.subtitle => summary' )
     end
 
 
@@ -94,48 +91,101 @@ class AtomFeedBuilder
     feed # return new feed
   end # method build_feed_from_atom
 
+
   def build_feed_item( atom_item )
     item = Item.new   # Item.new
-    ## item.object = atom_item  # not used for now
 
-    item.title     = atom_item.title.content
-    item.url       = atom_item.link.href
-
-    logger.debug "  atom | item.title.content: >#{atom_item.title.content}< : #{atom_item.title.content.class.name}"
-    logger.debug "  atom | item.link.href: >#{atom_item.link.href}< : #{atom_item.link.href.class.name}"
+    item.title     = handle_content( atom_item.title, 'item.title' )
+
+    ## Note: item might have many links
+    ##   e.g. see blogger (headius)
+    ##   <link rel='replies' type='application/atom+xml' href='http://blog.headius.com/feeds/3430080308857860963/comments/default' title='Post Comments'/>
+    ##   <link rel='replies' type='text/html' href='http://blog.headius.com/2014/05/jrubyconfeu-2014.html#comment-form' title='0 Comments'/>
+    ##   <link rel='edit' type='application/atom+xml' href='http://www.blogger.com/feeds/4704664917418794835/posts/default/3430080308857860963'/>
+    ##   <link rel='self' type='application/atom+xml' href='http://www.blogger.com/feeds/4704664917418794835/posts/default/3430080308857860963'/>
+    ##   <link rel='alternate' type='text/html' href='http://blog.headius.com/2014/05/jrubyconfeu-2014.html' 
+
+    item.url = nil
+
+    if atom_item.links.size == 1
+      item.url       = atom_item.link.href
+      logger.debug "  atom | item.link.href  >#{atom_item.link.href}< : #{atom_item.link.href.class.name}"
+    else
+      ## note: use links (plural to allow multiple links e.g. self,alternate,etc.)
+      atom_item.links.each_with_index do |link,i|
+        logger.debug "  atom | item.link[#{i+1}]  rel=>#{link.rel}< : #{link.rel.class.name} type=>#{link.type}< href=>#{link.href}<"
+        ## for now assume alternate is link or no rel specified (assumes alternate)
+        ##   note: only set if feed.url is NOT already set (via <id> for example)
+        if item.url.nil? && (link.rel == 'alternate' || link.rel.nil?)
+          item.url = link.href
+        end
+      end
+    end
 
 
     if atom_item.updated
-      ## change time to utc if present? why? why not?
-      #  --  .utc.strftime( "%Y-%m-%d %H:%M" )
-
-      ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
-
-      item.updated    =  atom_item.updated.content.nil? ? nil : atom_item.updated.content.to_datetime
-      logger.debug "  atom | item.updated.content  >#{atom_item.updated.content}< : #{atom_item.updated.content.class.name}"
+      item.updated    = handle_date( atom_item.updated, 'item.updated' )
     end
 
     if atom_item.published
-      ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
-
-      item.published   =  atom_item.published.content.nil? ? nil : atom_item.published.content.to_datetime
-      logger.debug "  atom | item.published.content  >#{atom_item.published.content}< : #{atom_item.published.content.class.name}"
+      item.published  = handle_date( atom_item.published, 'item.published' )
     end
 
 
     item.guid       =  atom_item.id.content
-    logger.debug "  atom | item.id.content: >#{atom_item.id.content}< : #{atom_item.id.content.class.name}"
+    logger.debug "  atom | item.id.content  >#{atom_item.id.content}< : #{atom_item.id.content.class.name}"
 
     if atom_item.content
       item.content = atom_item.content.content
     end
 
     if atom_item.summary
-      item.summary = atom_item.summary.content
+      item.summary = handle_content( atom_item.summary, 'item.summary' )
     end
 
     item
   end # method build_feed_item
 
+
+
+  def handle_date( el, name )
+    ## change time to utc if present? why? why not?
+    #  --  .utc.strftime( "%Y-%m-%d %H:%M" )
+
+    ###############
+    # examples:
+    #  2015-01-02 01:56:06 +0100
+
+    logger.debug "  atom | #{name}.content  >#{el.content}< : #{el.content.class.name}"
+
+    # NOTE: empty updated.content possible e.g.  used by google groups feed (e.g. <updated></updated>)
+    #   will return nil : NilClass
+
+    ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
+    date = if el.content.nil?
+             nil
+           else
+             el.content.to_datetime
+           end
+
+    date
+  end
+
+
+  def handle_content( el, name )   ## rename to handle_plain_vanilla_text_content - why? why not?
+    ### todo/fix: if type html ?? strip html tags n attributes
+    ##    always strip html tags n attributes?? why? why not?
+
+    ## check if content.nil? possible e.g. <title></title> => empty string or nil?
+
+    ## note: dump head (first 30 chars)
+    logger.debug "  atom | #{name}.content[0..30] (type=>#{el.type}<)  >#{el.content[0..30]}< : #{el.content.class.name}"
+
+    ## note: always strip leading and trailing whitespaces (spaces/tabs/newlines)
+    text = el.content.strip
+    text
+  end
+
+
 end # AtomFeedBuilder
 end # FeedParser

data/lib/feedparser/builder/rss.rb

@@ -1,3 +1,4 @@
+# encoding: utf-8
 
 module FeedParser
 
@@ -8,6 +9,12 @@ class RssFeedBuilder
 
   include LogUtils::Logging
 
+
+  def self.build( rss_feed )
+    feed = self.new( rss_feed )
+    feed.to_feed
+  end
+
   def initialize( rss_feed )
     @feed = build_feed( rss_feed )
   end
@@ -16,41 +23,25 @@ class RssFeedBuilder
     @feed
   end
 
-  def self.build( rss_feed )
-    feed = self.new( rss_feed )
-    feed.to_feed
-  end
 
 
   def build_feed( rss_feed )
     feed = Feed.new
-    ## feed.object = rss_feed   # not use for now
     feed.format = "rss #{rss_feed.rss_version}"
 
-    feed.title     = rss_feed.channel.title           # required
-    feed.url       = rss_feed.channel.link            # required
-    feed.summary   = rss_feed.channel.description     # required
-
-    logger.debug "  rss | channel.description: >#{rss_feed.channel.description}< : #{rss_feed.channel.description.class.name}"
-
-     # NOTE:
-     # All date-times in RSS conform
-     #   to the Date and Time Specification of RFC 822
-     #  e.g. Sun, 19 May 2012 15:21:36 GMT  or
-     #       Sat, 07 Sep 2013 00:00:01 GMT
+    logger.debug "  rss | feed.version  >#{rss_feed.rss_version}<"
 
-    ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
-
-    feed.built     = rss_feed.channel.lastBuildDate.nil? ? nil : rss_feed.channel.lastBuildDate.to_datetime  # optional
-    feed.published = rss_feed.channel.pubDate.nil?       ? nil : rss_feed.channel.pubDate.to_datetime     # optional
+    feed.title     = handle_content( rss_feed.channel.title,       'feed.title'       )  # required
+    feed.summary   = handle_content( rss_feed.channel.description, 'feed.description => summary' )  # required
+    feed.url       = rss_feed.channel.link            # required
 
-    logger.debug "  rss | channel.lastBuildDate: >#{rss_feed.channel.lastBuildDate}< : #{rss_feed.channel.lastBuildDate.class.name}"
-    logger.debug "  rss | channel.pubDate: >#{rss_feed.channel.pubDate}< : #{rss_feed.channel.pubDate.class.name}"
+    feed.updated   = handle_date( rss_feed.channel.lastBuildDate, 'feed.lastBuildDate => updated' )  # optional
+    feed.published = handle_date( rss_feed.channel.pubDate,       'feed.pubDate => published'     )  # optional
 
 
-    feed.generator = rss_feed.channel.generator       # optional
+    feed.generator = rss_feed.channel.generator    # optional
 
-    logger.debug "  rss | channel.generator: >#{rss_feed.channel.generator}< : #{rss_feed.channel.generator.class.name}"
+    logger.debug "  rss | feed.generator  >#{rss_feed.channel.generator}< : #{rss_feed.channel.generator.class.name}"
 
 
     items = []
@@ -65,13 +56,12 @@ class RssFeedBuilder
   def build_feed_item( rss_item )
 
     item = Item.new
-    ## item.object = rss_item  # not use for now
 
-    item.title     = rss_item.title
+    item.title     = handle_content( rss_item.title, 'item.title' )
     item.url       = rss_item.link
 
-    logger.debug "  rss | item.title: >#{rss_item.title}< : #{rss_item.title.class.name}"
-    logger.debug "  rss | item.link: >#{rss_item.link}< : #{rss_item.link.class.name}"
+    logger.debug "  rss | item.link  >#{rss_item.link}< : #{rss_item.link.class.name}"
+
 
 ## todo:
 ##  check if feedburner:origLink present - if yes, use it for url/link
@@ -81,24 +71,15 @@ class RssFeedBuilder
 ##  - <link>http://feedproxy.google.com/~r/Rubyflow/~3/Ym9Sltg_2_c/9803-gotta-ruby-s-syntax</link>
 
 
-    item.summary   = rss_item.description
+    item.summary   = handle_content( rss_item.description, 'item.description => summary' )
 
     # check for <content:encoded>
     # -- using RSS 1.0 content module in RSS 2.0
     item.content = rss_item.content_encoded
-    logger.debug "  rss | item.content_encoded[0..40]: >#{rss_item.content_encoded ? rss_item.content_encoded[0..40] : ''}< : #{rss_item.content_encoded.class.name}"
-
-    # NOTE:
-    # All date-times in RSS conform
-    #   to the Date and Time Specification of RFC 822
-    #  e.g. Sun, 19 May 2012 15:21:36 GMT  or
-    #       Sat, 07 Sep 2013 00:00:01 GMT
-
-    ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
+    logger.debug "  rss | item.content_encoded[0..40]  >#{rss_item.content_encoded ? rss_item.content_encoded[0..40] : ''}< : #{rss_item.content_encoded.class.name}"
 
-    item.published = rss_item.pubDate.nil? ? nil : rss_item.pubDate.to_datetime    # .utc.strftime( "%Y-%m-%d %H:%M" )
 
-    logger.debug "  rss | item.pubDate: >#{rss_item.pubDate}< : #{rss_item.pubDate.class.name}"
+    item.updated   = handle_date( rss_item.pubDate, 'item.pubDate => updated' )
 
 
     ## fix/todo: check if rss_item.guid present? !!!!
@@ -107,7 +88,7 @@ class RssFeedBuilder
 
     if rss_item.guid && rss_item.guid.content
       item.guid     = rss_item.guid.content
-      logger.debug "  rss | item.guid.content: >#{rss_item.guid.content}< : #{rss_item.guid.content.class.name}"
+      logger.debug "  rss | item.guid.content  >#{rss_item.guid.content}< : #{rss_item.guid.content.class.name}"
     else
       item.guid     = rss_item.link
       logger.warn "  rss | item.guid.content missing !!!! - using link for guid"
@@ -121,9 +102,56 @@ class RssFeedBuilder
     # <category><![CDATA[Ruby]]></category>
     # <category><![CDATA[Ruby on Rails]]></category>
 
-
     item
   end # method build_feed_item_from_rss
 
+
+
+  def handle_date( el, name )
+    ## change time to utc if present? why? why not?
+    #  --  .utc.strftime( "%Y-%m-%d %H:%M" )
+
+    # NOTE:
+    # All date-times in RSS conform
+    #   to the Date and Time Specification of RFC 822
+    #  e.g. Sun, 19 May 2012 15:21:36 GMT  or
+    #       Sat, 07 Sep 2013 00:00:01 GMT
+
+    ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
+
+    logger.debug "  rss | #{name}  >#{el}< : #{el.class.name}"
+
+
+    ## convert from time to to_datetime  (avoid errors on windows w/ builtin rss lib)
+    date = if el.nil?
+             nil
+           else
+             el.to_datetime
+           end
+
+    date
+  end
+
+  def handle_content( el, name )
+    ## note:
+    #   use for feed.title, feed.description
+    #           item.title, item.description
+    #
+    # do NOT use for others e.g. feed.generator, etc.
+
+
+    ## todo/fix: strip html tags n attributes ???
+
+    logger.debug "  rss | #{name}  >#{el}< : #{el.class.name}"
+
+    text = if el.nil?
+             nil
+           else
+             el.strip
+           end
+    text
+  end
+
+
 end # class RssFeedBuilder
 end # module FeedParser