annotation

type Annotation any

type AnnotationProcessor interface {
	Process(node Node) error
	Output() map[string][]byte
	Version() string
	Name() string
}

type Lookup interface {
	// FindImportByAlias returns related import for alias in current ast.File.
	// For example:
	// import "github.com/bincooo/go-annotation/internal/tag"
	// ...
	// tag.Parse(...)
	// FindImportByAlias("tag") returns "github.com/bincooo/go-annotation/internal/tag", true
	FindImportByAlias(alias string) (string, bool)

	// FindNodeByAlias returns related Node by alias, related import if any and a type/function name from related module
	// if alias is empty, then the search will go in current directory of ast.File
	FindNodeByAlias(alias, nodeName string) (Node, string, error)

	GetFSet() *token.FileSet
}

type Meta interface {
	// Root returns related module root (absolut path)
	Root() string
	// Dir returns absolut path to the file directory
	Dir() string
	// FileName returns file name with extension
	FileName() string
	// PackageName returns current package name
	PackageName() string
	// LocalPackageOf returns the file package
	LocalPackage() string
}

type Node interface {
	// Annotations returns all annotations declared for ast.Node
	Annotations() []Annotation
	// ASTNode returns ast.Node that currently is in processing
	ASTNode() ast.Node
	// AnnotatedNode returns annotation.Node by ast.Node that declared as a sub ast.Node for ASTNode()
	AnnotatedNode(ast.Node) Node
	// ParentNode returns parent annotation.Node by current. false is returned if there is no parents for ast.Node
	ParentNode() (Node, bool)
	// Imports returns all file imports ([]*ast.ImportSpec)
	Imports() []*ast.ImportSpec
	// IsSamePackage compares nodes by module root, file location and package name
	IsSamePackage(v Node) bool
	// Lookup returns a lookup module
	Lookup() Lookup
	// Meta returns node metadata
	Meta() Meta
}

type Rerunable interface {
	ToRerun() []string
	Clear()
}