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

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

[optional steps if you want google reader import support]

1. sign up for some API keys at the google apis console
2. fill in values for localhost and whatever your hostname is in the init() function of settings.go
3. get a google analytics key and put it into the appropriate field in settings.go

[and finally, deploy]

1. from the goread directory, deploy with appcfg.py update .