- this project used to http test case mock for golang
We welcome community contributions to this project.
Please read Contributor Guide for more information on how to get started.
请阅读有关 贡献者指南 以获取更多如何入门的信息
in go mod project
# warning use private git host must set
# global set for once
# add private git host like github.com to evn GOPRIVATE
$ go env -w GOPRIVATE='github.com'
# use ssh proxy
# set ssh-key to use ssh as http
$ git config --global url."git@github.com:".insteadOf "https://github.com/"
# or use PRIVATE-TOKEN
# set PRIVATE-TOKEN as gitlab or gitea
$ git config --global http.extraheader "PRIVATE-TOKEN: {PRIVATE-TOKEN}"
# set this rep to download ssh as https use PRIVATE-TOKEN
$ git config --global url."ssh://github.com/".insteadOf "https://github.com/"
# before above global settings
# test version info
$ git ls-remote -q https://github.com/sinlov-go/go-http-mock.git
# test depends see full version
$ go list -mod readonly -v -m -versions github.com/sinlov-go/go-http-mock
# or use last version add go.mod by script
$ echo "go mod edit -require=$(go list -mod=readonly -m -versions github.com/sinlov-go/go-http-mock | awk '{print $1 "@" $NF}')"
$ echo "go mod vendor"
- support gin mock test
- more perfect test case coverage
- more perfect benchmark case
- minimum go version: go 1.19
- change
go 1.19
,^1.19
,1.19.12-bullseye
,1.19.12
to new go version
lib | version |
---|---|
https://github.com/stretchr/testify | v1.8.4 |
https://github.com/sebdah/goldie | v2.5.3 |
- more libs see go.mod
- for https://github.com/gin-gonic/gin use package
"github.com/sinlov-go/go-http-mock/gin_mock"
- you can use
gin_mock.MockEngine
to init mockgin.Engine
package gin_mock_test
import (
"github.com/gin-gonic/gin"
"github.com/sinlov-go/go-http-mock/gin_mock"
)
var (
basePath = "/api/v1"
basicRouter *gin.Engine
)
func init() {
basicRouter = setupTestRouter()
// bind gin router
router(basicRouter, basePath)
}
func setupTestRouter() *gin.Engine {
e := gin_mock.MockEngine(func(engine *gin.Engine) error {
return nil
})
return e
}
- test case example
package gin_mock_test_test
import (
"github.com/sinlov-go/go-http-mock/gin_mock"
"github.com/stretchr/testify/assert"
"net/http"
"testing"
)
func TestGetString(t *testing.T) {
ginMock := gin_mock.NewGinMock(t, basicRouter, basePath, "/Biz/string")
recorder := ginMock.
Method(http.MethodGet).
Body(nil).
NewRecorder()
assert.Equal(t, http.StatusOK, recorder.Code)
assert.Equal(t, "this is Biz message", recorder.Body.String())
}
- more example see package
github.com/sinlov-go/go-http-mock/gin_mock_test
# It needs to be executed after the first use or update of dependencies.
$ make init dep
- test code
$ make test testBenchmark
add main.go file and run
# run at env dev use cmd/main.go
$ make dev
- ci to fast check
# check style at local
$ make style
# run ci at local
$ make ci
# then test build as test/Dockerfile
$ make dockerTestRestartLatest
# clean test build
$ make dockerTestPruneLatest
# more info see
$ make helpDocker