Guide of local development

Please refer to the coding format of golang
Unit test is needed for all codes.
Pass through all unit tests.
Please follow regulations of submmiting codes

The following guidiance tells you how to submit code.

Fork

Transfer to the home page of Github ,and then click button Fork to generate the git under your own file directory,such as https://github.com/USERNAME/bfe

Clone

Clone remote git to local:

At present Git stream branch model is applied to BFE to undergo task of development,test,release and maintenance.Please refer to about details。

All development tasks of feature and bug fix should be finished in a new branch which is extended from develop branch.

Create and switch to a new branch with command git checkout -b.

$ git checkout -b my-cool-stuff

Use `pre-commit` hook

BFE developers use the tool to manage Git pre-commit hooks. It helps us format the source code and automatically check some basic things before committing (such as having only one EOL per file, not adding large files in Git, etc.).

The pre-commit test is part of the unit test in Travis-CI. A PR that does not satisfy the hook cannot be submitted to BFE. Install pre-commit first and then run it in current directory：

$ pre-commit install

BFE modify the format of golang source code with gofmt .

Start development

I delete a line of README.md and create a new file in the case.

View the current state via git status , which will prompt some changes to the current directory, and you can also view the file’s specific changes via git diff .

Please refer to about construction and test.

Commit

$ git checkout -- README.md
On branch test
Untracked files:
  (use "git add <file>..." to include in what will be committed)
    test
nothing added to commit but untracked files present (use "git add" to track)
$ git add test

It’s required that the commit message is also given on every Git commit, through which other developers will be notified of what changes have been made. Type git commit to realize it.

$ git commit
CRLF end-lines remover...............................(no files to check)Skipped
yapf.................................................(no files to check)Skipped
Check for added large files..............................................Passed
Check for merge conflicts................................................Passed
Check for broken symlinks................................................Passed
clang-formater.......................................(no files to check)Skipped
[my-cool-stuff c703c041] add test file
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 233

Attention needs to be paid：you need to add commit message to trigger CI test.The command is as follows:

Keep the latest local repository

It needs to keep up with the latest code of original repository(https://github.com/baidu/bfe）before Pull Request.

Check the name of current remote repository with git remote.

$ git remote
origin
$ git remote -v
origin    https://github.com/USERNAME/bfe (fetch)
origin    https://github.com/USERNAME/bfe (push)

origin is the name of remote repository that we clone, which is also the BFE under your own account. Next we create a remote host of an original BFE and name it upstream.

$ git remote add upstream https://github.com/baidu/bfe
$ git remote
origin
upstream

Get the latest code of upstream and update current branch.

Local development