/scraperd

Scraper for Letterboxd user's activity

Primary LanguageRubyMIT LicenseMIT

Build Status

Scraperd

Scraperd is a very simple scraper for the public user activity RSS in Letterboxd. It relies on OpenStruct to build objects.

Installation

To get the latest stable:

gem 'scraperd'

To get the latest code:

gem 'scraperd', git: https://github.com/eltercero/scraperd

And then execute:

$ bundle

Usage

>> require 'scraperd'

>> client = Scraperd::Base.new

# Example
#####################################################
# Return the RSS for an username
>> activities = client.fetch('eltercero')
=> [#<Scraperd::Activity ...]
>> film = activities.first
=> #<Scraperd::Activity title="Porco Rosso, 1992", score=8, link="http://letterboxd.com/eltercero/film/porco-rosso/", film_link="http://letterboxd.com/film/porco-rosso/", watched_at=2015-03-13 00:00:00 +0100, added_at=2015-03-13 22:52:18 +0100, original_response=#<Hashie::Mash dc_creator="V\xC3\xADctor" description="<p><img src=\"http://zardoz.cf.letterboxd.com/resized/film-poster/4/5/1/3/0/45130-porco-rosso-0-150-0-222-crop.jpg\"/></p> <p>Watched on Friday March 13, 2015.</p>" guid="letterboxd-watch-7901161" link="http://letterboxd.com/eltercero/film/porco-rosso/" pubDate=2015-03-13 22:52:18 +0100 title="Porco Rosso, 1992 - \xE2\x98\x85\xE2\x98\x85\xE2\x98\x85\xE2\x98\x85">>
>> film.title
=> "Porco Rosso, 1992"
>> film.score
=> 8
>> film.watched_at
=> 2015-03-13 00:00:00 +0100

Contributing

Please, be my guest!

  1. Fork it ( http://github.com/eltercero/scraperd/fork )
  2. Create your feature branch (git checkout -b sequels-can-be-good). Don't forget to test your changes!
  3. Commit your changes (git commit -am 'Remember Godfather 2!')
  4. Push to the branch (git push origin sequels-can-be-good)
  5. Create new Pull Request

License

Released under the MIT License.