Ruby library for accessing school data using the education.com web services.
Ruby JavaScript
Switch branches/tags
Nothing to show
Latest commit 3ca0c55 Aug 23, 2010 @danwoolley Rev gem version
Permalink
Failed to load latest commit information.
demo
lib
sample_data
README
numbertwopencil.gemspec

README

NumberTwoPencil
Created by Dan Woolley, September 2008.


To install from gem:
$ gem sources -a http://gems.github.com
$ sudo gem install danwoolley-numbertwopencil --include-dependencies


Library requirements: 
* gem install json			# include-dependencies above should take care of this.


Education.com API requirements:
* Docs at http://www.education.com/webservice/documentation/
* Sign up for an API key at http://www.education.com/webservice/request/
* Terms of service at http://www.education.com/webservice/terms/
* This provider is pretty strict about tying your api key to an IP address.  Contact them if you need
multiple IP's.


Sample library usage:
require 'numbertwopencil'
foo = NumberTwoPencil.new(your_api_key)
data = foo.education_com_getSchools "zip" => "33432"
p data
data.each {|item| puts "#{item["schoolname"]}\t#{item["gradelevel"]}\t#{item["city"]}"}



Sample schoolSearch request using curl:
curl "http://www.education.com/service/service.php?f=schoolSearch&sn=sf&resf=json&key=your_education_com_api_key&zip=33432"