codegen

Documentation

Overview

codegen defines general utilities for codegen.

Index

• Constants
• func BufPrintf(w io.Writer) (func(format string, args ...any), func() error)
• func EnumerateCommentGroup(comments *ast.CommentGroup) iter.Seq[string]
• func ExcludeIgnoredGenDecl(genDecl *ast.GenDecl) (bool, error)
• func ExcludeIgnoredTypeSpec(ts *ast.TypeSpec, _ types.Object) (bool, error)
• func FieldAst(st *ast.StructType) iter.Seq[FieldDescAst]
• func FieldDst(st *dst.StructType) iter.Seq[FieldDescDst]
• func ParseFieldDirectiveCommentDst[T any](prefix string, comments dst.FieldDecorations, ...) (T, bool, error)
• func PrintAstExprPanicking(expr ast.Expr) string
• func PrintFileHeader(w io.Writer, af *ast.File, fset *token.FileSet) error
• func PrintTypeParamsAst(ts *ast.TypeSpec) string
• func PrintTypeParamsDst(ts *dst.TypeSpec) string
• func TrimPackageComment(f *dst.File)
• func TypeToAst(ty types.Type, pkgPath string, importMap imports.ImportMap) ast.Expr
• func TypeToDst(ty types.Type, pkgPath string, importMap imports.ImportMap) dst.Expr
• type Direction
  • func ParseDirectiveComment(comments *ast.CommentGroup) (Direction, bool, error)
  • func ParseDirectiveCommentDst(comments dst.NodeDecs) (Direction, bool, error)
  • func (d Direction) MustIgnore() bool
• type FieldDescAst
• type FieldDescDst
• type Parser
  • func NewParser(dir string) *Parser
  • func (p *Parser) ParseFile(fset *token.FileSet, filename string, src []byte) (*ast.File, error)

Constants

const (
	DirectiveCommentIgnore    = "ignore"
	DirectiveCommentGenerated = "generated"
)

const (
	DirectivePrefix = "codegen:"
)

Functions

func BufPrintf

func BufPrintf(w io.Writer) (func(format string, args ...any), func() error)

func EnumerateCommentGroup

func EnumerateCommentGroup(comments *ast.CommentGroup) iter.Seq[string]

func ExcludeIgnoredGenDecl

func ExcludeIgnoredGenDecl(genDecl *ast.GenDecl) (bool, error)

func ExcludeIgnoredTypeSpec

func ExcludeIgnoredTypeSpec(ts *ast.TypeSpec, _ types.Object) (bool, error)

func FieldAst

func FieldAst(st *ast.StructType) iter.Seq[FieldDescAst]

func FieldDst

func FieldDst(st *dst.StructType) iter.Seq[FieldDescDst]

func ParseFieldDirectiveCommentDst

func ParseFieldDirectiveCommentDst[T any](
	prefix string,
	comments dst.FieldDecorations,
	parser func(s []string) (T, error),
) (T, bool, error)

func PrintAstExprPanicking

func PrintAstExprPanicking(expr ast.Expr) string

func PrintFileHeader

func PrintFileHeader(w io.Writer, af *ast.File, fset *token.FileSet) error

func PrintTypeParamsAst

func PrintTypeParamsAst(ts *ast.TypeSpec) string

func PrintTypeParamsDst

func PrintTypeParamsDst(ts *dst.TypeSpec) string

func TrimPackageComment

func TrimPackageComment(f *dst.File)

func TypeToAst

func TypeToAst(ty types.Type, pkgPath string, importMap imports.ImportMap) ast.Expr

func TypeToDst

func TypeToDst(ty types.Type, pkgPath string, importMap imports.ImportMap) dst.Expr

Types

type Direction

type Direction struct {
	// contains filtered or unexported fields
}

func ParseDirectiveComment

func ParseDirectiveComment(comments *ast.CommentGroup) (Direction, bool, error)

func ParseDirectiveCommentDst

func ParseDirectiveCommentDst(comments dst.NodeDecs) (Direction, bool, error)

func (Direction) MustIgnore

func (d Direction) MustIgnore() bool

type FieldDescAst

type FieldDescAst struct {
	Pos   int
	Name  string
	Field *ast.Field
}

type FieldDescDst

type FieldDescDst struct {
	Pos   int
	Name  string
	Field *dst.Field
}

type Parser

type Parser struct {
	// contains filtered or unexported fields
}

func NewParser

func NewParser(dir string) *Parser

func (*Parser) ParseFile

func (p *Parser) ParseFile(fset *token.FileSet, filename string, src []byte) (*ast.File, error)