/goread

google reader clone in go on app engine

Primary LanguageJavaScriptISC LicenseISC

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 and make sure it is in your PATH. (Google App Engine doesn't yet work with Python 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 use goapp which lives in the go_appengine directory from the SDK. Make sure it's in your PATH.
  6. Download dependencies by running: goapp get -d github.com/mjibson/goread. This will download goread and all of its dependencies, and will stick them in your GOPATH. You will get messages about unrecognized imports. Ignore them.
  7. cd $GOPATH/src/github.com/mjibson/goread.
  8. git checkout master (bug in go get).
  9. Copy app.sample.yaml to app.yaml.
  10. In the goread directory, copy settings.go.dist to settings.go.
  11. From the goread directory, start the app with goapp serve. (On Windows, you may need to do this instead: python C:\go_appengine\dev_appserver.py app.yaml.)
  12. 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.

self host on production app engine servers

  1. Set up a local dev environment as described above.
  2. Create a new app engine application.
  3. In app.yaml, change the first line to contain the name of the application you just created.
  4. From the goread directory, deploy with goapp deploy.