Skip to content

lamproae/beegae

 
 

Repository files navigation

beegae

beego is a Go Framework inspired by tornado and sinatra.

beego is an open-source, high-performance, modular, full-stack web framework.

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 initalizes 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.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.

Please note: As of writing this package has NOT been tested on Managed VMs.

As always, if there any bugs with the package please open an issue and/or submit a PR.

Features

  • Datastore + Memcached backed session store! read more here to learn how to use it.
  • AppEngineCtx is part of the default Controller. View the included sessions package documentation for an example of using it!

beego Documentation

Community

Getting Started

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

  • # goapp get github.com/astaxie/beegae
  • # goapp 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
api_version: go1

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/
  • Now open main.go and change func main() to func init()
  • # goapp serve
  • Done!

LICENSE

beego is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).

Packages

No packages published

Languages

  • Go 97.9%
  • Other 2.1%