extractors

type Context struct {
	Config *config.Config
	Log    *log.Entry

	OriginalPackages []*packages.Package

	Packages    map[string]*packages.Package
	Inspector   *inspector.Inspector
	CommentMaps map[string]map[string]ast.CommentMap // pkg -> file -> node -> comments

	Definitions Definitions

	Templates []*tmpl.Template
}

type Definition struct {
	Type  DefinitionType
	Token etype.Token
	Pck   *packages.Package
	Ident *ast.Ident
	Path  string // github.com/name/repo/package/pack
	ID    string // github.com/name/repo/package/pack.StructName
	Obj   types.Object

	// only for functions and structs
	FieldIdent *ast.Ident
	FieldName  string
	IsVariadic bool

	// functions only
	FieldPos int
}

type DefinitionType int

type Definitions map[string]map[string]*Definition // path.name -> field || "" -> Definition

type Extractor interface {
	Run(ctx context.Context, extractCtx *Context) ([]result.Issue, error)
	Name() string
}

type SearchResult struct {
	Raw  string
	Node ast.Node
}