bee === [![Build Status](https://drone.io/github.com/beego/bee/status.png)](https://drone.io/github.com/beego/bee/latest) Bee is a command line tool facilitating development with beego framework. ## Requirements - Go version >= 1.1. ## Installation Begin by installing `bee` using `go get` command. go get github.com/beego/bee Then you can add `bee` binary to PATH environment variable in your `~/.bashrc` or `~/.bash_profile` file: ```bash export PATH=$PATH:/bin/bee ``` > If you already have `bee` installed, updating `bee` is simple: go get -u github.com/beego/bee ## Basic commands Bee provides a variety of commands which can be helpful at various stage of development. The top level commands include: new create an application base on beego framework run run the app which can hot compile pack compress an beego project api create an api application base on beego framework bale packs non-Go files to Go source files version show the bee & beego version generate source code generator migrate run database migrations ## bee version The first command is the easiest: displaying which version of `bee`, `beego` and `go` is installed on your machine: ```bash $ bee version bee :1.2.2 beego :1.4.0 Go :go version go1.2.1 linux/amd64 ``` ## bee new Creating a new beego web application is no big deal, too. ```bash $ bee new myapp [INFO] Creating application... /home/zheng/gopath/src/myapp/ /home/zheng/gopath/src/myapp/conf/ /home/zheng/gopath/src/myapp/controllers/ /home/zheng/gopath/src/myapp/models/ /home/zheng/gopath/src/myapp/routers/ /home/zheng/gopath/src/myapp/tests/ /home/zheng/gopath/src/myapp/static/ /home/zheng/gopath/src/myapp/static/js/ /home/zheng/gopath/src/myapp/static/css/ /home/zheng/gopath/src/myapp/static/img/ /home/zheng/gopath/src/myapp/views/ /home/zheng/gopath/src/myapp/conf/app.conf /home/zheng/gopath/src/myapp/controllers/default.go /home/zheng/gopath/src/myapp/views/index.tpl /home/zheng/gopath/src/myapp/routers/router.go /home/zheng/gopath/src/myapp/tests/default_test.go /home/zheng/gopath/src/myapp/main.go 2014/08/29 15:45:47 [SUCC] New application successfully created! ``` ## bee run To run the application we just created, navigate to the application folder and execute `bee run`. ```bash $ cd myapp $ bee run ``` ## bee pack coming soon ... ## bee api coming soon ... ## bee bale coming soon ... ## bee migrate ```bash usage: bee migrate [Command] bee migrate [-driver=mysql] [-conn="root:@tcp(127.0.0.1:3306)/test"] run all outstanding migrations -driver: [mysql | postgresql | sqlite], the default is mysql -conn: the connection string used by the driver, the default is root:@tcp(127.0.0.1:3306)/test bee migrate rollback [-driver=mysql] [-conn="root:@tcp(127.0.0.1:3306)/test"] rollback the last migration operation -driver: [mysql | postgresql | sqlite], the default is mysql -conn: the connection string used by the driver, the default is root:@tcp(127.0.0.1:3306)/test bee migrate reset [-driver=mysql] [-conn="root:@tcp(127.0.0.1:3306)/test"] rollback all migrations -driver: [mysql | postgresql | sqlite], the default is mysql -conn: the connection string used by the driver, the default is root:@tcp(127.0.0.1:3306)/test bee migrate refresh [-driver=mysql] [-conn="root:@tcp(127.0.0.1:3306)/test"] rollback all migrations and run them all again -driver: [mysql | postgresql | sqlite], the default is mysql -conn: the connection string used by the driver, the default is root:@tcp(127.0.0.1:3306)/test ``` ## bee generate Bee also comes with a souce code generator which speeds up the development. ```bash usage: bee generate [Command] bee generate scaffold [scaffoldname] [-fields=""] [-driver=mysql] [-conn="root:@tcp(127.0.0.1:3306)/test"] The generate scaffold command will do a number of things for you. -fields: a list of table fields. Format: field:type, ... -driver: [mysql | postgres | sqlite], the default is mysql -conn: the connection string used by the driver, the default is root:@tcp(127.0.0.1:3306)/test example: bee generate scaffold post -fields="title:string,body:text" bee generate model [modelname] [-fields=""] generate RESTFul model based on fields -fields: a list of table fields. Format: field:type, ... bee generate controller [controllerfile] generate RESTFul controllers bee generate view [viewpath] generate CRUD view in viewpath bee generate migration [migrationfile] [-fields=""] generate migration file for making database schema update -fields: a list of table fields. Format: field:type, ... bee generate docs generate swagger doc file bee generate test [routerfile] generate testcase bee generate appcode [-tables=""] [-driver=mysql] [-conn="root:@tcp(127.0.0.1:3306)/test"] [-level=3] generate appcode based on an existing database -tables: a list of table names separated by ',', default is empty, indicating all tables -driver: [mysql | postgres | sqlite], the default is mysql -conn: the connection string used by the driver. default for mysql: root:@tcp(127.0.0.1:3306)/test default for postgres: postgres://postgres:postgres@127.0.0.1:5432/postgres -level: [1 | 2 | 3], 1 = models; 2 = models,controllers; 3 = models,controllers,router ``` ## Shortcuts Because you'll likely type these generator commands over and over, it makes sense to create aliases. ```bash # Generator Stuff alias g:a="bee generate appcode" alias g:m="bee generate model" alias g:c="bee generate controller" alias g:v="bee generate view" alias g:mi="bee generate migration" ``` These can be stored in, for example, your `~/.bash_profile` or `~/.bashrc` files. ## Help If you happend to forget the usage of a command, you can always find the usage information by `bee help `. For instance, to get more information about the `run` command: ```bash $ bee help run usage: bee run [appname] [watchall] [-main=*.go] [-downdoc=true] [-gendoc=true] start the appname throw exec.Command then start a inotify watch for current dir when the file has changed bee will auto go build and restart the app file changed | check if it's go file | yes no | | go build do nothing | restart app ```