gen

README

Gen - Tools for generating source code for microservices

Just write normal functions, and Gen generates efficient routing source code and documentation for it Because the source code is generated, none of this affects runtime performance
The differences caused by each change in the tool are shown directly in the generated source code
generating clients is also supported

• English
• 简体中文

Examples

1. Install gen tool go get -v github.com/wzshiming/gen/cmd/gen
2. Add gen tool to $PATH
3. Start it gen run github.com/wzshiming/gen-examples/service/...
4. Open http://127.0.0.1:8080/swagger/?url=./openapi.json# with your browser

Examples

Or try to quickly build services from scratch

1. Make a directory mkdir -p $(go env GOPATH)/src/gentest
2. Change directory cd $(go env GOPATH)/src/gentest/
3. Define models

cat > models.go <<EOF
package gentest
type Gentest struct {
    Name string \`json:"name"\`
    Age  int    \`json:"age"\`
}
EOF

1. Generated from CRUD template gen crud -t mock -n Gentest
2. Start it gen run gentest

Supported

• Generate documentation
  • OpenAPI 3
  • SwaggerUI
  • ReDoc
• RESTful
  • Generate Go router
    • Security
      • apiKey
      • http
        • basic
        • bearer
      • oauth2
      • openIdConnet
    • Content
      • Query
      • Path
      • Header
      • Cookie
      • Body
        • JSON
        • XML
        • Formdata
          • File
          • Value
        • URLEncode
  • Generate Go client
    • Security
      • apiKey
      • http
        • basic
        • bearer
      • oauth2
      • openIdConnet
    • Content
      • Query
      • Path
      • Header
      • Cookie
      • Body
        • JSON
        • XML
        • Formdata
          • File
          • Value
        • URLEncode
  • Other Client
    • OpenAPITools/openapi-generator
    • swagger-api/swagger-js
    • swagger-api/swagger-codegen
• gRPC & Proto3

License

Pouch is licensed under the MIT License. See LICENSE for the full license text.