Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dlapiduz/govcode.org

Government Open Source Project Explorer
https://github.com/dlapiduz/govcode.org

Last synced: 5 days ago
JSON representation

Government Open Source Project Explorer

Awesome Lists containing this project

README

        

## NOTE: THIS PROJECT HAS BEEN RETIRED, IT IS NOT LONGER ACTIVE
Govcode
=============

[![wercker status](https://app.wercker.com/status/a02fb4fa99d40f8de4e90722491b7c2a/s "wercker status")](https://app.wercker.com/project/bykey/a02fb4fa99d40f8de4e90722491b7c2a)

## What is this?

Govcode is an application that lists government open source projects.
The purpose is to track what is being worked on and build analytics on top of it.

![index page](screenshots/govcode.png "Index Page")
![api documentation](govcoded/README.md "API documentation")

## How to run it?

This application is structured as an API and a front end. The `common`, `govcode` and `govcoded` directories
hold the API code while the `front` directory holds the front end.

All the steps mentioned below assume that you cloned the repo into a local folder.

To setup the API you need to do the following:
1. Build the `govcode` tool:
```
cd govcode
go build
```
1. Get a github api key, go to https://github.com/settings/applications#personal-access-tokens and click "generate new token".
1. Set up a postgres database with a new user, password and db just for govcode.
1. Set the environment variables for the Postgres database and Github API key:
```
export GH_KEY="xxx"
export PG_CONN_STR="postgres://govcode_user:[email protected]/govcode_db?sslmode=disable"
```
1. Migrate the database to build all the tables:
`./govcode migrate`
1. (Optionally) Run an import to populate the DB:
`./govcode import`

Now we have a loaded DB with the settings in the environment.

To actually run the server:
```
cd govcoded
go run main.go
```

Or use [gin](https://github.com/codegangsta/gin):
```
go get github.com/codegangsta/gin
cd govcoded
gin
```

This should start the API on port 3000. You can change the port by setting the `PORT` environment variable.

To run the front end:
1. Install required npm packages:
```
cd front
npm install
npm install -g bower
```
1. Install the bower packages:
`bower install`
1. Run the server:
`grunt serve`
1. Go to `http://localhost:9000` on your browser

If you see an error about `compass` you might need to install the [compass ruby gem](http://compass-style.org/install/):
`gem install compass`

## Contributing

All contributions are welcome. You might want to create an issue describing what you want to work on
to make sure the is no duplication.

## License

This project is licensed under the [MIT license](LICENSE).