ryanwold.net - Civic Tech, Bitcoin, and Open Government Innovation

Title

Text

UPDATE: Jan 1, 2012

The National Data Catalog has been retired by Sunlight Labs sometime ago.

Please check out other Data Catalogs like CKAN and offerings from CivicCommons.
This summer, I'll be working on the National Data Catalog with Sunlight Labs, a division of the Sunlight Foundation.

<hr>

The National Data Catalog is designed to be "an open platform for government data sets and APIs. It makes it easy to find datasets by and about government, across all levels (federal, state, and local) and across all branches (executive, legislative, and judicial)."

The purpose of this post is to outline how to get the code up and running so you can contribute to the development of the open source platform.
Getting the code setup locally takes a bit of work, but is certainly doable.
It consists of cloning 3 repositories located at Github down to the your local machine.

* http://github.com/sunlightlabs/datacatalog-web
* http://github.com/sunlightlabs/datacatalog-api
* http://github.com/sunlightlabs/ruby-datacatalog

1. get an API key from the National Data Catalog API's site)
1. Install gems and their dependencies. 
1. configure several .yml config files located in /config)

rake db:create # creates the development database
    rake db:migrate
    RAILS_ENV=test rake db:create
    RAILS_ENV=test rake db:migrate
    rake test (all tests should pass)

### Developer References

* http://api.nationaldatacatalog.com/docs/
* irc://chat.freenode.net/transparency

So, after getting the basics installed, it is time to actually start using it, which involves using the "Importers".   Making use of the importers also requires the Data Importer (http://github.com/sunlightlabs/datacatalog-importer).  I started with the DataSF.org importer (http://github.com/sunlightlabs/datacatalog-imp-datasf).  The importer also need a /config.yml file that requires the API key from the data-catalog /config/users.yml file for the specific importer - paste the API key into the specific importer's /config.yml file, and then...

Then, using the specific importer, run the following commands.

IMPORTER_ENV=local
    rake pull
    rake push

An entry