beego is a Go Framework inspired by tornado and sinatra.
beego is used for rapid development of RESTful APIs, web apps and backend services in Go. It is inspired by Tornado, Sinatra and Flask. beego has some Go-specific features such as interfaces and struct embedding.
More info beego.me
beegae is a port of beego intended to be used on Google's AppEngine. There are a few subtle differences between how beego and beegae initializes applications which you can see for yourself here example
The aim of this project is to keep as much of beego unchanged as possible in beegae.
IMPORTANT UPDATE - Breaking Changes with beegae 1.6.1
There were changes made to the beego core that were updated in beegae for consistency between packages. Many of these changes are in relation to refactoring various objects in beego as well addressing golint recommendations to variable/function names. This may result in minor tweaks to your code (e.g. UrlFor is now URLFor on controllers).
This package now supports both classic AppEngine runtime as well as flexible (formerly Managed VM) runtime.
IMPORTANT UPDATE - Breaking Changes with beegae 1.5
With the latest update beegae now uses the google.golang.org/appengine AppEngine package. You can read the differences from the classic
appengine package on the new package's repository.
beegae users will need to update their apps to use this package as per the instructions on the repository. The
controller.AppEngineCtx type was changed to
context.Context so minimal changes to users' code should be necessary.
The session code was also updated to reflect these changes, most notably, the
context.Context is now the first argument for the session interface functions. Additionally, the package was moved to be more in-line with how
beego broke out its session implementations.
Like other session providers as part of
beego, you need to do an blank import of the
appengine session provider:
import _ "github.com/astaxie/beegae/session/appengine"
This will register the
appengine session provider so you may use it in your application. You may do this in your
main.go file. Look at the examples for guidance.
My apologies for any inconvenience this brings to your code. The new package is the recommended approach to Go on AppEngine as it works on both classic AppEngine and Managed VMs, and so beegae was updated to support this recommendation.
As always, if there any bugs with the package please open an issue and/or submit a PR.
- Datastore + Memcached backed session store! read more here to learn how to use it.
AppEngineCtxis part of the default Controller. View the included sessions package documentation for an example of using it!
- Welcome to join us in Slack: https://beego.slack.com, you can get invited from here
This will be a quick overview of how to setup the repository and get started with beegae on AppEngine. It is already assumed that you have setup the AppEngine SDK for Go correctly and setup your GOPATH correctly
# go get github.com/astaxie/beegae
# go get github.com/beego/bee
# cd $GOPATH/src
# $GOPATH/bin/bee new hellogae
# cd hellogae
- Make a new file app.yaml and fill it as such:
application: hellobeegae version: 1 runtime: go threadsafe: true api_version: go1 handlers: - url: /.* script: _go_app
or if you are using the flexible runtime:
runtime: go vm: true threadsafe: true api_version: 1 handlers: - url: /.* script: _go_app
# gofmt -r '"github.com/astaxie/beego" -> "github.com/astaxie/beegae"' -w ./
# gofmt -r 'beego -> beegae' -w ./
# mkdir main && mv main.go main/ && mv app.yaml main/ && mv conf/ main/ && mv views/ main/ && cd main/
- If you are using the classic AppeEngine runtime, open
func init(), otherwise skip this step.
# goapp serve
beego source code is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).