Golang: go:generate - Generating code

[hhstore]

related:

• 167

[hhstore]

golang 代码生成器工具: go:generate

• go 语言内置代码生产工具命令
• https://blog.golang.org/generate

ref:

• https://juejin.im/post/5c98e891f265da60d428fed2
• 这篇介绍用法
• 译:自动代码生成的 5 点建议

应用场景:

• go当前版本, 无模板语法, 无法优雅实现多态.
• 利用反射实现, 性能开销
• 故大量针对类型差异, 实现的重复代码过多. 就需要工具傻瓜式生产代码.

应用范例:

官方:

• https://github.com/golang/go/wiki/GoGenerateTools
• 官方Wiki整理大量案例

项目级别:

• https://github.com/cweill/gotests

  • go test 代码自动生成插件
  • IDE支持

• https://github.com/google/wire

  • https://github.com/google/go-cloud/tree/master/samples/guestbook
  • 示例代码

• https://github.com/yakumioto/mgen

  • for mongodb
  • 支持基于yaml配置生成
  • /github.com/yakumioto/mgen/template/mgo.tmpl
  • action.go 基于模板生成. 2个action方法.
  • 入口在: mgen/main.go

• https://github.com/dave/jennifer

  • 另类go代码生成, 语义化生成.

[hhstore]

go 标准库: ast/parser/token

• AST: abstract syntax tree(抽象语法树)
• /go/1.12.4/libexec/src/go/parser/interface.go
• ParseFile() : 该方法很强大, mode 支持多个解析模式. 支持解析注释

ref:

• Go之底层利器-AST遍历

• Go的AST(抽象语法树)

• 参考项目: https://github.com/yuroyoro/goast-viewer

  • 在线演示: https://yuroyoro.github.io/goast-viewer/index.html
  • 具体解析: https://github.com/yuroyoro/goast-viewer/blob/master/ast.go

• 文档: https://cloud.tencent.com/developer/section/1142083

• 使用示例:

package gen

import (
    "go/ast"
    "go/parser"
    "go/token"
)

// This example shows what an AST looks like when printed for debugging.
func ExamplePrint() {
    // src is the input for which we want to print the AST.
    src := `
package main

// main: this is main func
func main() {
    // call println -key1=value1 -key2=value2
    println("Hello, World!")
}
`

    // Create the AST by parsing src.
    fset := token.NewFileSet()                                      // positions are relative to fset
    f, err := parser.ParseFile(fset, "", src, parser.ParseComments) // [mode=0]
    if err != nil {
        panic(err)
    }

    // Print the AST.
    ast.Print(fset, f)
}

• 测试:

package gen

import (
    "testing"
)

func TestExamplePrint(t *testing.T) {
    ExamplePrint()
}

[hhstore]

go 标准库: template

• https://github.com/valyala/quicktemplate
• 语法更现代
• https://github.com/shiyanhui/hero

crud 定义:

• http://gorm.io/docs/update.html