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 Mercurial and make sure hg is in your path.
3. checkout the code
4. install the go app engine SDK
5. 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)
6. 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.
7. download dependencies by running: go get -d github.com/mjibson/goread/goapp. although you've already checked out the code for development use, this will automatically download all of goread's dependencies, and will stick them all in your GOPATH.
8. in the goapp folder, copy settings.go.dist to settings.go
9. 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 .