1
0
mirror of https://github.com/beego/bee.git synced 2024-11-22 05:00:54 +00:00

Updated README.md

This commit is contained in:
Faissal Elamraoui 2016-12-26 22:44:27 +01:00
parent bbe1a4efe3
commit 3c676b602c

242
README.md
View File

@ -32,18 +32,21 @@ go get -u github.com/beego/bee
## Basic commands ## Basic commands
Bee provides a variety of commands which can be helpful at various stages of development. The top level commands include: Bee provides a variety of commands which can be helpful at various stages of development. The top level commands include:
``` ```
new Create a Beego application new Creates a Beego application
run Run the app and start a Web server for development run Run the application by starting a local development server
pack Compress a beego project into a single file pack Compresses a Beego application into a single file
api Create an API beego application api Creates a Beego API application
hprose Create an rpc application use hprose base on beego framework hprose Creates an RPC application based on Hprose and Beego frameworks
bale Packs non-Go files to Go source files bale Transforms non-Go files to Go source files
version Prints the current Bee version version Prints the current Bee version
generate Source code generator generate Source code generator
migrate Run database migrations migrate Runs database migrations
fix Fix the Beego application to make it compatible with Beego 1.6 fix Fixes your application by making it compatible with newer versions of Beego
dockerize Generates a Dockerfile for your Beego application
``` ```
### bee version ### bee version
To display the current version of `bee`, `beego` and `go` installed on your machine: To display the current version of `bee`, `beego` and `go` installed on your machine:
@ -55,19 +58,38 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
├── Beego : 1.7.0 ├── Beego : 1.7.2
├── GoVersion : go1.6.2 ├── GoVersion : go1.7.4
├── GOOS : windows ├── GOOS : linux
├── GOARCH : amd64 ├── GOARCH : amd64
├── NumCPU : 4 ├── NumCPU : 2
├── GOPATH : C:\Users\beeuser\go ├── GOPATH : /home/beeuser/.go
├── GOROOT : C:\go ├── GOROOT : /usr/lib/go
├── Compiler : gc ├── Compiler : gc
└── Date : Monday, 22 Aug 2016 └── Date : Monday, 26 Dec 2016
``` ```
You can also change the output format using `-o` flag:
```bash
$ bee version -o json
{
"GoVersion": "go1.7.4",
"GOOS": "linux",
"GOARCH": "amd64",
"NumCPU": 2,
"GOPATH": "/home/beeuser/.go",
"GOROOT": "/usr/lib/go",
"Compiler": "gc",
"BeeVersion": "1.6.2",
"BeegoVersion": "1.7.2"
}
```
For more information on the usage, run `bee help version`.
### bee new ### bee new
To create a new Beego web application: To create a new Beego web application:
@ -79,26 +101,26 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
2016/08/22 14:53:45 [INFO] Creating application... 2016/12/26 22:28:11 INFO ▶ 0001 Creating application...
create C:\Users\beeuser\go\src\github.com\user\my-web-app\ create /home/beeuser/.go/src/github.com/user/my-web-app/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\conf\ create /home/beeuser/.go/src/github.com/user/my-web-app/conf/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\controllers\ create /home/beeuser/.go/src/github.com/user/my-web-app/controllers/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\models\ create /home/beeuser/.go/src/github.com/user/my-web-app/models/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\routers\ create /home/beeuser/.go/src/github.com/user/my-web-app/routers/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\tests\ create /home/beeuser/.go/src/github.com/user/my-web-app/tests/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\static\ create /home/beeuser/.go/src/github.com/user/my-web-app/static/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\static\js\ create /home/beeuser/.go/src/github.com/user/my-web-app/static/js/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\static\css\ create /home/beeuser/.go/src/github.com/user/my-web-app/static/css/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\static\img\ create /home/beeuser/.go/src/github.com/user/my-web-app/static/img/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\views\ create /home/beeuser/.go/src/github.com/user/my-web-app/views/
create C:\Users\beeuser\go\src\github.com\user\my-web-app\conf\app.conf create /home/beeuser/.go/src/github.com/user/my-web-app/conf/app.conf
create C:\Users\beeuser\go\src\github.com\user\my-web-app\controllers\default.go create /home/beeuser/.go/src/github.com/user/my-web-app/controllers/default.go
create C:\Users\beeuser\go\src\github.com\user\my-web-app\views\index.tpl create /home/beeuser/.go/src/github.com/user/my-web-app/views/index.tpl
create C:\Users\beeuser\go\src\github.com\user\my-web-app\routers\router.go create /home/beeuser/.go/src/github.com/user/my-web-app/routers/router.go
create C:\Users\beeuser\go\src\github.com\user\my-web-app\tests\default_test.go create /home/beeuser/.go/src/github.com/user/my-web-app/tests/default_test.go
create C:\Users\beeuser\go\src\github.com\user\my-web-app\main.go create /home/beeuser/.go/src/github.com/user/my-web-app/main.go
2016/08/22 14:53:45 [SUCC] New application successfully created! 2016/12/26 22:28:11 SUCCESS ▶ 0002 New application successfully created!
``` ```
For more information on the usage, run `bee help new`. For more information on the usage, run `bee help new`.
@ -130,14 +152,15 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
2016/08/22 15:11:01 Packaging application: C:\Users\beeuser\go\src\github.com\user\my-web-app 2016/12/26 22:29:29 INFO ▶ 0001 Packaging application on '/home/beeuser/.go/src/github.com/user/my-web-app'...
2016/08/22 15:11:01 Building application... 2016/12/26 22:29:29 INFO ▶ 0002 Building application...
2016/08/22 15:11:01 Env: GOOS=windows GOARCH=amd64 2016/12/26 22:29:29 INFO ▶ 0003 Using: GOOS=linux GOARCH=amd64
2016/08/22 15:11:08 Build successful 2016/12/26 22:29:31 SUCCESS ▶ 0004 Build Successful!
2016/08/22 15:11:08 Excluding relpath prefix: . 2016/12/26 22:29:31 INFO ▶ 0005 Writing to output: /home/beeuser/.go/src/github.com/user/my-web-app/my-web-app.tar.gz
2016/08/22 15:11:08 Excluding relpath suffix: .go:.DS_Store:.tmp 2016/12/26 22:29:31 INFO ▶ 0006 Excluding relpath prefix: .
2016/08/22 15:11:10 Writing to output: `C:\Users\beeuser\go\src\github.com\user\my-web-app\my-web-app.tar.gz` 2016/12/26 22:29:31 INFO ▶ 0007 Excluding relpath suffix: .go:.DS_Store:.tmp
2016/12/26 22:29:32 SUCCESS ▶ 0008 Application packed!
``` ```
For more information on the usage, run `bee help pack`. For more information on the usage, run `bee help pack`.
@ -153,23 +176,23 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
2016/08/22 15:14:10 [INFO] Creating API... 2016/12/26 22:30:12 INFO ▶ 0001 Creating API...
create C:\Users\beeuser\go\src\github.com\user\my-api create /home/beeuser/.go/src/github.com/user/my-api
create C:\Users\beeuser\go\src\github.com\user\my-api\conf create /home/beeuser/.go/src/github.com/user/my-api/conf
create C:\Users\beeuser\go\src\github.com\user\my-api\controllers create /home/beeuser/.go/src/github.com/user/my-api/controllers
create C:\Users\beeuser\go\src\github.com\user\my-api\tests create /home/beeuser/.go/src/github.com/user/my-api/tests
create C:\Users\beeuser\go\src\github.com\user\my-api\conf\app.conf create /home/beeuser/.go/src/github.com/user/my-api/conf/app.conf
create C:\Users\beeuser\go\src\github.com\user\my-api\models create /home/beeuser/.go/src/github.com/user/my-api/models
create C:\Users\beeuser\go\src\github.com\user\my-api\routers\ create /home/beeuser/.go/src/github.com/user/my-api/routers/
create C:\Users\beeuser\go\src\github.com\user\my-api\controllers\object.go create /home/beeuser/.go/src/github.com/user/my-api/controllers/object.go
create C:\Users\beeuser\go\src\github.com\user\my-api\controllers\user.go create /home/beeuser/.go/src/github.com/user/my-api/controllers/user.go
create C:\Users\beeuser\go\src\github.com\user\my-api\tests\default_test.go create /home/beeuser/.go/src/github.com/user/my-api/tests/default_test.go
create C:\Users\beeuser\go\src\github.com\user\my-api\routers\router.go create /home/beeuser/.go/src/github.com/user/my-api/routers/router.go
create C:\Users\beeuser\go\src\github.com\user\my-api\models\object.go create /home/beeuser/.go/src/github.com/user/my-api/models/object.go
create C:\Users\beeuser\go\src\github.com\user\my-api\models\user.go create /home/beeuser/.go/src/github.com/user/my-api/models/user.go
create C:\Users\beeuser\go\src\github.com\user\my-api\main.go create /home/beeuser/.go/src/github.com/user/my-api/main.go
2016/08/22 15:14:10 [SUCC] New API successfully created! 2016/12/26 22:30:12 SUCCESS ▶ 0002 New API successfully created!
``` ```
For more information on the usage, run `bee help api`. For more information on the usage, run `bee help api`.
@ -185,16 +208,26 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
2016/08/22 16:09:13 [INFO] Creating Hprose application... 2016/12/26 22:30:58 INFO ▶ 0001 Creating application...
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app create /home/beeuser/.go/src/github.com/user/my-rpc-app/
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app\conf create /home/beeuser/.go/src/github.com/user/my-rpc-app/conf/
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app\conf\app.conf create /home/beeuser/.go/src/github.com/user/my-rpc-app/controllers/
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app\models create /home/beeuser/.go/src/github.com/user/my-rpc-app/models/
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app\models\object.go create /home/beeuser/.go/src/github.com/user/my-rpc-app/routers/
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app\models\user.go create /home/beeuser/.go/src/github.com/user/my-rpc-app/tests/
create C:\Users\beeuser\go\src\github.com\user\my-rpc-app\main.go create /home/beeuser/.go/src/github.com/user/my-rpc-app/static/
2016/08/22 16:09:13 [SUCC] New Hprose application successfully created! create /home/beeuser/.go/src/github.com/user/my-rpc-app/static/js/
create /home/beeuser/.go/src/github.com/user/my-rpc-app/static/css/
create /home/beeuser/.go/src/github.com/user/my-rpc-app/static/img/
create /home/beeuser/.go/src/github.com/user/my-rpc-app/views/
create /home/beeuser/.go/src/github.com/user/my-rpc-app/conf/app.conf
create /home/beeuser/.go/src/github.com/user/my-rpc-app/controllers/default.go
create /home/beeuser/.go/src/github.com/user/my-rpc-app/views/index.tpl
create /home/beeuser/.go/src/github.com/user/my-rpc-app/routers/router.go
create /home/beeuser/.go/src/github.com/user/my-rpc-app/tests/default_test.go
create /home/beeuser/.go/src/github.com/user/my-rpc-app/main.go
2016/12/26 22:30:58 SUCCESS ▶ 0002 New application successfully created!
``` ```
For more information on the usage, run `bee help hprose`. For more information on the usage, run `bee help hprose`.
@ -210,11 +243,9 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
2016/08/22 16:37:24 [INFO] Detected bee.json 2016/12/26 22:32:41 INFO ▶ 0001 Loading configuration from 'bee.json'...
2016/08/22 16:37:24 [INFO] Packaging directory(static/js) 2016/12/26 22:32:41 SUCCESS ▶ 0002 Baled resources successfully!
2016/08/22 16:37:24 [INFO] Packaging directory(static/css)
2016/08/22 16:37:24 [SUCC] Baled resources successfully!
``` ```
For more information on the usage, run `bee help bale`. For more information on the usage, run `bee help bale`.
@ -238,15 +269,35 @@ ______
| |_/ / ___ ___ | |_/ / ___ ___
| ___ \ / _ \ / _ \ | ___ \ / _ \ / _ \
| |_/ /| __/| __/ | |_/ /| __/| __/
\____/ \___| \___| v1.5.0 \____/ \___| \___| v1.6.2
2016/08/22 16:55:30 [INFO] Using 'Hello' as controller name 2016/12/26 22:33:58 INFO ▶ 0001 Using 'Hello' as controller name
2016/08/22 16:55:30 [INFO] Using 'controllers' as package name 2016/12/26 22:33:58 INFO ▶ 0002 Using 'controllers' as package name
create C:\Users\beeuser\go\src\github.com\user\my-web-app/controllers/hello.go create /home/beeuser/.go/src/github.com/user/my-web-app/controllers/hello.go
2016/08/22 16:55:30 [SUCC] Controller successfully generated! 2016/12/26 22:33:58 SUCCESS ▶ 0003 Controller successfully generated!
``` ```
For more information on the usage, run `bee help generate`. For more information on the usage, run `bee help generate`.
### bee dockerize
Bee also helps you dockerize your Beego application by generating a Dockerfile.
For example, to generate a Dockerfile with `Go version 1.6.4` and exposing port `9000`:
```bash
$ bee dockerize -image="library/golang:1.6.4" -expose=9000
______
| ___ \
| |_/ / ___ ___
| ___ \ / _ \ / _ \
| |_/ /| __/| __/
\____/ \___| \___| v1.6.2
2016/12/26 22:34:54 INFO ▶ 0001 Generating Dockerfile...
2016/12/26 22:34:54 SUCCESS ▶ 0002 Dockerfile generated.
```
For more information on the usage, run `bee help dockerize`.
## Shortcuts ## Shortcuts
Because you'll likely type these generator commands over and over, it makes sense to create aliases: Because you'll likely type these generator commands over and over, it makes sense to create aliases:
@ -270,10 +321,33 @@ For instance, to get more information about the `run` command:
```bash ```bash
$ bee help run $ bee help run
usage: bee run [appname] [watchall] [-main=*.go] [-downdoc=true] [-gendoc=true] [-vendor=true] [-e=folderToExclude] [-tags=goBuildTags] USAGE
bee run [appname] [watchall] [-main=*.go] [-downdoc=true] [-gendoc=true] [-vendor=true] [-e=folderToExclude] [-tags=goBuildTags] [-runmode=BEEGO_RUNMODE]
Run command will supervise the file system of the beego project using inotify, OPTIONS
it will recompile and restart the app after any modifications. -downdoc
Enable auto-download of the swagger file if it does not exist.
-e=[]
List of paths to exclude.
-gendoc
Enable auto-generate the docs.
-main=[]
Specify main go files.
-runmode
Set the Beego run mode.
-tags
Set the build tags. See: https://golang.org/pkg/go/build/
-vendor=false
Enable watch vendor folder.
DESCRIPTION
Run command will supervise the filesystem of the application for any changes, and recompile/restart it.
``` ```
## Contributing ## Contributing