Feedie The Feed

Hi! My name is Feedie The Feed. I'm a Ruby gem that enables you to aggregate RSS and Facebook pages feed with one entry point, wooop! Just feed me the link and I'll go get them for you, master! Rawr!

I should work on Ruby 2.2 and over. I'm built with great help from these cool gems:

• feedjira - for RSS feed
• koala - for the Facebook API
• public_suffix - for parsing the links
• nesty - for cute nested exceptions

You can just

gem install feedie_the_feed

and you're good to go! Although it may contain a slightly older version, so you can clone me (oh the 21st century), if you feel adventurous!

git clone git@github.com:krabique48/feedie_the_feed.git
cd feedie_the_feed
bundle install

Just run rake and watch it go green for RSpec and RuboCop!

bundle exec rake

Have my bro YARD generate the documentation for you

yard doc

Or just visit http://www.rubydoc.info/gems/feedie_the_feed/ for that matter.

You can check try_me.rb out, it's quite self-explanatory.

Very simple, create FeedieTheFeed::FeedGrabber object and use it's get method with a URL as a parameter:

@feed_grabber = FeedieTheFeed::FeedGrabber.new
feed = @feed_grabber.get(
  'https://raw.githubusercontent.com/krabique48/' \
  'feedie_the_feed/master/rss_test_sample'
)

(return format is explained below)

To use the gem with Facebook you'll have to use your Facebook AppID and Facebook secret key.The simplest way to provide those is to just have them in your environment variables as FACEBOOK_APPID and FACEBOOK_SECRET. This way, all you have to do is create a new instance of the FeedieTheFeed::FeedGrabber class and call it's get method with a URL to a Facebook page as a parameter.

@feed_grabber = FeedieTheFeed::FeedGrabber.new
@feed_grabber.get('https://www.facebook.com/ruby.programming')

You can also do this, without explicitly creating an object, as a shortcut.

FeedieTheFeed.get('https://www.facebook.com/ruby.programming')

It acts just like as if you have created a FeedieTheFeed::FeedGrabber instance, and called it's get instance method.

Facebook AppID and secret key follow a priority rule:

get method parameters > object values > environment variables

So, you can also provide the Facebook credentials as parameters in the get method:

@feed_grabber = FeedieTheFeed::FeedGrabber.new
@feed_grabber.get(
  'https://www.facebook.com/ruby.programming',
  facebook_appid: '123',
  facebook_secret: '123'
)

Or during object creation:

@feed_grabber = FeedieTheFeed::FeedGrabber.new(
  facebook_appid: '123',
  facebook_secret: '123'
)
@feed_grabber.get('https://www.facebook.com/ruby.programming')

You can also set the amount of posts you want to get, similarly to Facebook credentials (it also follows the same priority rule):

@feed_grabber = FeedieTheFeed::FeedGrabber.new(facebook_posts_limit: 50)

or

@feed_grabber.get(some_url, facebook_posts_limit: 50)

and if you don't provide it at all, it shall default to 10.

So the get method returns an array of hashes, where each hash is either a Facebook page post or an RSS entry.

Facebook hashes would always have these keys:

'entry_id'
'url'
'published'

plus some additional ones that may not always be there, due to the nature of Facebook posts:

'title'
'summary'
'image'

'title', if not provided, will be automatically generated based on 'summary', and will not exceed 80 characters (exactly like RoR truncate(80) method). For example,

summary: The Grand Finals of the #ManilaMasters will start in less than an hour. Newbee or Evil Geniuses, who are you rooting for?

will turn to

title: The Grand Finals of the #ManilaMasters will start is less than an hour...

With RSS, the only two keys that would be there no matter what are entry_id and url, due to the nature of RSS. Although, most of the time, some other keys will also be present:

'entry_id'
'title'
'summary'
'url'
'published'
'image'

fb_appid_and_secret_key(facebook_appid, facebook_secret) is used to set the Facebook credentials for the object.

reset_fb_appid_and_secret_key! is used to reset the Facebook credentials for the object.

fb_posts_limit(limit) is used to set the object's Facebook posts limit (should be an integer from 1 to 100).

reset_fb_posts_limit! is used to reset the object's Facebook posts limit.

MIT

• Oleg Larkin - Initial work - krabique48 (krabique48@gmail.com)