A Ruby wrapper for the NYTimes Event Listings API.
Currently v0.0.1. As of right now, you can supply any legal parameters and receive the response back from NYTimes as a JSON hash. Next to come: faceted search, spatial search, and more robust error handling. Possible other features include an option for XML response. Also, if there are any other features that people may want, feel free to contribute or let me know.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
$ gem install nytimes-events
A simple usage example, as of right now:
listing = Nytimes::Event::List.new(MY_API_KEY) listing.find('query' => 'food')
search takes a hash of parameters which directly correspond to the parameters found on the NYTimes' Event Listings API page. You must initialize any object with your API key which can be obtained from the NYTimes API website.
Query parameters can be found here: http://developer.nytimes.com/docs/read/events_api
You will receive back a JSON hash of events.
nytimes-event is based off of the linked-list data structure. That is,
Nytimes::Event::List actually retrieves
batch_size number of events, and you can retrieve the next
batch_size events or the previous
batch_size by default is 20.
listing = Nytimes::Event::List.new(MY_API_KEY) listing.batch_size = 10 listing.find('query' => 'food') #=> next retrieves the next 10 events listing.next #=> previous retrieves the previous 10 events listing.prev
Also, you can reset to head (such that the results are those which would appear if you hadn't called next or previous at all) by calling
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request