DonorsChoose.org is an online charity that makes it easy for anyone to help students in need.
This is a gem that wraps their API.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
$ gem install donors_choose
The first thing you should do is request an API key. They provide a test key, "DONORSCHOOSE", that will occasionally be turned off. So be nice and get your own. :)
We're currently developing support for the full API, but right now, there are just two methods.
DonorsChoose.api_key = "DONORSCHOOSE" projects = DonorsChoose.projects_near_me("40.4405556", "-79.9961111") projects = DonorsChoose.projects_by_zip("15232")
Projects will be an array of objects that contain all of the data returned by the request. You can learn about these objects through introspection:
> (projects.first.methods - Object.new.methods) => [:id, ...
For example. These objects are dynamically created based on the response, so minor API updates may change the attributes.
- 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