About this .gem, IRS_Pub78

This IRS .gem is designed to allow improve the accessibility of public nonprofit information provided by the IRS via Publication 78 online. This .gem is not provided or maintained by the IRS. The information available is publicly available.

Usage

From the terminal:

gem install irs_pub78 # install the .gem

irb # start IRB require ‘irs_pub78’ # require the IRS_Pub78 gem i = IrsPub78::Client.new # create a new instance of the IRS::Client i.download # tell the instance to download the file. downloads to /data/irs.zip i.unzip # tell the instance to unzip the downloaded file to a txt file i.parse_txt_to_json => /data/irs.json # tell the instance to parse the txt file to .json

i.find(“Vacaville”, “CA”) # tell the instance to find the nonprofits* on the IRS Pub 78 online

# in a specific City and State. returns an easy-to-use array of hashes,
# each which has the attributes (Name, City, State, Code)
#
# * currently only supports the first 500 nonprofits in a city

Notes

IRS Pub 78 The source is a .zip file. There are 800,000+ records in the file.

Known Issues

This .gem does not support more than 500 nonprofits on a given, which most large cities have. support may be added in the future, if a Use Case requires it

Development Environment

This wrapper is developed against Ruby 1.9.2.

License

Apache 2.0. See LICENSE or www.apache.org/licenses/LICENSE-2.0.txt

Credits

an open-source project by MoreQuality, a 501©(3) nonprofit based in Solano County, California.

Support this work

Please consider making a donation (morequality.org/donate) to support MoreQuality’s technology and civic education initiatives.