You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
557 lines
11 KiB
Go
557 lines
11 KiB
Go
package gogen
|
|
|
|
import (
|
|
goformat "go/format"
|
|
"io/ioutil"
|
|
"os"
|
|
"path/filepath"
|
|
"strings"
|
|
"testing"
|
|
|
|
"github.com/stretchr/testify/assert"
|
|
"github.com/tal-tech/go-zero/tools/goctl/api/parser"
|
|
)
|
|
|
|
const testApiTemplate = `
|
|
info(
|
|
title: doc title
|
|
desc: ">
|
|
doc description first part,
|
|
doc description second part<"
|
|
version: 1.0
|
|
)
|
|
|
|
// TODO: test
|
|
// {
|
|
type Request struct { // TODO: test
|
|
// TODO
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + ` // }
|
|
} // TODO: test
|
|
|
|
// TODO: test
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
@server(
|
|
// C0
|
|
group: greet/s1
|
|
)
|
|
// C1
|
|
service A-api {
|
|
// C2
|
|
@server( // C3
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response) // hello
|
|
|
|
// C4
|
|
@handler NoResponseHandler // C5
|
|
get /greet/get(Request)
|
|
}
|
|
`
|
|
|
|
const testMultiServiceTemplate = `
|
|
info(
|
|
title: doc title
|
|
desc: doc description first part
|
|
version: 1.0
|
|
)
|
|
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
service A-api {
|
|
@server(
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
|
|
service A-api {
|
|
@server(
|
|
handler: NoResponseHandler
|
|
)
|
|
get /greet/get(Request)
|
|
}
|
|
`
|
|
|
|
const apiNoInfo = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
service A-api {
|
|
@server(
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const invalidApiFile = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
service A-api
|
|
@server(
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const anonymousAnnotation = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
service A-api {
|
|
@handler GreetHandler
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const apiHasMiddleware = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
@server(
|
|
middleware: TokenValidate
|
|
)
|
|
service A-api {
|
|
@handler GreetHandler
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const apiJwt = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
@server(
|
|
jwt: Auth
|
|
signature: true
|
|
)
|
|
service A-api {
|
|
@handler GreetHandler
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const apiJwtWithMiddleware = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
@server(
|
|
jwt: Auth
|
|
jwtTransition: Trans
|
|
middleware: TokenValidate
|
|
)
|
|
service A-api {
|
|
@handler GreetHandler
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const apiHasNoRequest = `
|
|
service A-api {
|
|
@handler GreetHandler
|
|
post /greet/ping ()
|
|
}
|
|
`
|
|
|
|
const apiRouteTest = `
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
service A-api {
|
|
@handler NormalHandler
|
|
get /greet/from/:name(Request) returns (Response)
|
|
@handler NoResponseHandler
|
|
get /greet/from/:sex(Request)
|
|
@handler NoRequestHandler
|
|
get /greet/from/request returns (Response)
|
|
@handler NoRequestNoResponseHandler
|
|
get /greet/from
|
|
}
|
|
`
|
|
|
|
const hasCommentApiTest = `
|
|
type Inline struct {
|
|
|
|
}
|
|
|
|
type Request struct {
|
|
Inline
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + ` // name in path
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"msg"` + "`" + ` // message
|
|
}
|
|
|
|
service A-api {
|
|
@doc ("helloworld")
|
|
@server(
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const hasInlineNoExistTest = `
|
|
|
|
type Request struct {
|
|
Inline
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + ` // message
|
|
}
|
|
|
|
service A-api {
|
|
@doc ("helloworld")
|
|
@server(
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const importApi = `
|
|
type ImportData struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
`
|
|
|
|
const hasImportApi = `
|
|
import "importApi.api"
|
|
|
|
type Request struct {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type Response struct {
|
|
Message string ` + "`" + `json:"message"` + "`" + ` // message
|
|
}
|
|
|
|
service A-api {
|
|
@server(
|
|
handler: GreetHandler
|
|
)
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const noStructTagApi = `
|
|
type Request {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
}
|
|
|
|
type XXX {}
|
|
|
|
type (
|
|
Response {
|
|
Message string ` + "`" + `json:"message"` + "`" + `
|
|
}
|
|
|
|
A {}
|
|
|
|
B struct {}
|
|
)
|
|
|
|
service A-api {
|
|
@handler GreetHandler
|
|
get /greet/from/:name(Request) returns (Response)
|
|
}
|
|
`
|
|
|
|
const nestTypeApi = `
|
|
type Request {
|
|
Name string ` + "`" + `path:"name,options=you|me"` + "`" + `
|
|
XXX struct {
|
|
}
|
|
}
|
|
|
|
service A-api {
|
|
@handler GreetHandler
|
|
get /greet/from/:name(Request)
|
|
}
|
|
`
|
|
|
|
func TestParser(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(testApiTemplate), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
api, err := parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
assert.Equal(t, len(api.Types), 2)
|
|
assert.Equal(t, len(api.Service.Routes()), 2)
|
|
|
|
assert.Equal(t, api.Service.Routes()[0].Path, "/greet/from/:name")
|
|
assert.Equal(t, api.Service.Routes()[1].Path, "/greet/get")
|
|
|
|
assert.Equal(t, api.Service.Routes()[1].RequestTypeName(), "Request")
|
|
assert.Equal(t, api.Service.Routes()[1].ResponseType, nil)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestMultiService(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(testMultiServiceTemplate), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
api, err := parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
assert.Equal(t, len(api.Service.Routes()), 2)
|
|
assert.Equal(t, len(api.Service.Groups), 2)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestApiNoInfo(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(apiNoInfo), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestInvalidApiFile(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(invalidApiFile), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.NotNil(t, err)
|
|
}
|
|
|
|
func TestAnonymousAnnotation(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(anonymousAnnotation), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
api, err := parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
assert.Equal(t, len(api.Service.Routes()), 1)
|
|
assert.Equal(t, api.Service.Routes()[0].Handler, "GreetHandler")
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestApiHasMiddleware(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(apiHasMiddleware), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestApiHasJwt(t *testing.T) {
|
|
filename := "jwt.api"
|
|
err := ioutil.WriteFile(filename, []byte(apiJwt), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestApiHasJwtAndMiddleware(t *testing.T) {
|
|
filename := "jwt.api"
|
|
err := ioutil.WriteFile(filename, []byte(apiJwtWithMiddleware), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestApiHasNoRequestBody(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(apiHasNoRequest), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
}
|
|
|
|
func TestApiRoutes(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(apiRouteTest), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestHasCommentRoutes(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(hasCommentApiTest), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestInlineTypeNotExist(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(hasInlineNoExistTest), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.NotNil(t, err)
|
|
}
|
|
|
|
func TestHasImportApi(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(hasImportApi), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
importApiName := "importApi.api"
|
|
err = ioutil.WriteFile(importApiName, []byte(importApi), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(importApiName)
|
|
|
|
api, err := parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
var hasInline bool
|
|
for _, ty := range api.Types {
|
|
if ty.Name() == "ImportData" {
|
|
hasInline = true
|
|
break
|
|
}
|
|
}
|
|
assert.True(t, hasInline)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestNoStructApi(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(noStructTagApi), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
spec, err := parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
assert.Equal(t, len(spec.Types), 5)
|
|
|
|
validate(t, filename)
|
|
}
|
|
|
|
func TestNestTypeApi(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(nestTypeApi), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.NotNil(t, err)
|
|
}
|
|
|
|
func TestCamelStyle(t *testing.T) {
|
|
filename := "greet.api"
|
|
err := ioutil.WriteFile(filename, []byte(testApiTemplate), os.ModePerm)
|
|
assert.Nil(t, err)
|
|
defer os.Remove(filename)
|
|
|
|
_, err = parser.Parse(filename)
|
|
assert.Nil(t, err)
|
|
|
|
validateWithCamel(t, filename, "GoZero")
|
|
}
|
|
|
|
func validate(t *testing.T, api string) {
|
|
validateWithCamel(t, api, "gozero")
|
|
}
|
|
|
|
func validateWithCamel(t *testing.T, api, camel string) {
|
|
dir := t.TempDir()
|
|
err := DoGenProject(api, dir, camel)
|
|
assert.Nil(t, err)
|
|
filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
|
|
if strings.HasSuffix(path, ".go") {
|
|
code, err := ioutil.ReadFile(path)
|
|
assert.Nil(t, err)
|
|
assert.Nil(t, validateCode(string(code)))
|
|
}
|
|
return nil
|
|
})
|
|
}
|
|
|
|
func validateCode(code string) error {
|
|
_, err := goformat.Source([]byte(code))
|
|
return err
|
|
}
|