bbarth / goread

google reader clone in go on app engine

go read

a google reader clone built with go on app engine and angularjs

setting up a local dev environment

1. install Python 2.7 if you don't have it and make sure it is in your $PATH. Google App Engine doesn't yet work with 3.*.
2. install Git and Mercurial and make sure git and hg are in your $PATH.
3. install the go app engine SDK
4. set your GOPATH (to something like /home/user/mygo), and make sure it's a directory that exists. (Note: Set this on your machine's environment, not in the go.bat file)
5. further commands that use go, dev_appserver.py, and appcfg.py all live in the google_appengine directory from the SDK. make sure it's in your $PATH.
6. download dependencies by running: go get -d github.com/mjibson/goread/goapp. this will download goread and all of its dependencies, and will stick them in your GOPATH.
7. cd $GOPATH/src/github.com/mjibson/goread
8. git checkout master (bug in go get)
9. in the goapp folder, copy settings.go.dist to settings.go
10. from the goread directory, start the app with dev_appserver.py app.yaml
11. view at localhost:8080, admin console at localhost:8000

developer notes

1. press alt+c to show the miniprofiler window
2. press c to clear all feeds and stories, remove all your subscriptions, and reset your unread date

how to host your own on production app engine servers

1. create a new app engine application
2. in app.yaml, change the first line to contain the name of the application you just created
3. from the goread directory, deploy with appcfg.py update .