README.textile in somezack-feedzirra-0.0.2 vs README.textile in somezack-feedzirra-0.0.3
- old
+ new
@@ -40,10 +40,15 @@
NoMethodError: undefined method `on_success' for #<Curl::Easy:0x1182724>
from ./lib/feedzirra/feed.rb:88:in `add_url_to_multi'
</pre>
This means that you are requiring curl-multi or the Ruby Forge version of Curb somewhere. You can't use those and need to get the taf2 version up and running.
+If you're on Debian or Ubuntu and getting errors while trying to install the taf2-curb gem, it could be because you don't have the latest version of libcurl installed. Do this to fix:
+<pre>
+sudo apt-get install libcurl4-gnutls-dev
+</pre>
+
Another problem could be if you are running Mac Ports and you have libcurl installed through there. You need to uninstall it for curb to work! The version in Mac Ports is old and doesn't play nice with curb. If you're running Leopard, you can just uninstall and you should be golden. If you're on an older version of OS X, you'll then need to "download curl":http://curl.haxx.se/download.html and build from source. Then you'll have to install the taf2-curb gem again. You might have to perform the step above.
If you're still having issues, please let me know on the mailing list. Also, "Todd Fisher (taf2)":http://github.com/taf2 is working on fixing the gem install. Please send him a full error report.
h2. Usage
@@ -67,15 +72,17 @@
entry.url # => "http://www.pauldix.net/2009/01/ruby-http-client-library-performance.html"
entry.author # => "Paul Dix"
entry.summary # => "..."
entry.content # => "..."
entry.published # => Thu Jan 29 17:00:19 UTC 2009 # it's a Time object
+entry.categories # => ["...", "..."]
# sanitizing an entry's content
-entry.sanitized.title # => returns the title with harmful stuff escaped
-entry.sanitized.author # => returns the author with harmful stuff escaped
-entry.sanitized.content # => returns the content with harmful stuff escaped
+entry.title.sanitize # => returns the title with harmful stuff escaped
+entry.author.sanitize # => returns the author with harmful stuff escaped
+entry.content.sanitize # => returns the content with harmful stuff escaped
+entry.content.sanitize! # => returns content with harmful stuff escaped and replaces original (also exists for author and title)
entry.sanitize! # => sanitizes the entry's title, author, and content in place (as in, it changes the value to clean versions)
feed.sanitize_entries! # => sanitizes all entries in place
# updating a single feed
updated_feed = Feedzirra::Feed.update(feed)
@@ -131,16 +138,13 @@
This thing needs to hammer on many different feeds in the wild. I'm sure there will be bugs. I want to find them and crush them. I didn't bother using the test suite for feedparser. i wanted to start fresh.
Here are some more specific TODOs.
* Make a feedzirra-rails gem to integrate feedzirra seamlessly with Rails and ActiveRecord.
-* Add function to sanitize content.
-* Add support to automatically handle gzip and deflate encododing.
* Add support for authenticated feeds.
* Create a super sweet DSL for defining new parsers.
* Test against Ruby 1.9.1 and fix any bugs.
* I'm not keeping track of modified on entries. Should I add this?
-* Should I be parsing stuff like tags or categories for entries?
* Clean up the fetching code inside feed.rb so it doesn't suck so hard.
* Make the feed_spec actually mock stuff out so it doesn't hit the net.
* Readdress how feeds determine if they can parse a document. Maybe I should use namespaces instead?
h2. LICENSE
\ No newline at end of file