decorator

Documentation

Index

• func Decorate(fset *token.FileSet, n ast.Node) dst.Node
• func DecorateFile(fset *token.FileSet, f *ast.File) *dst.File
• func Fprint(w io.Writer, f *dst.File) error
• func Parse(src interface{}) (*dst.File, error)
• func ParseDir(fset *token.FileSet, path string, filter func(os.FileInfo) bool, ...) (map[string]*dst.Package, error)
• func ParseExpr(x string) (dst.Expr, error)
• func ParseExprFrom(fset *token.FileSet, filename string, src interface{}, mode parser.Mode) (dst.Expr, error)
• func ParseFile(fset *token.FileSet, filename string, src interface{}, mode parser.Mode) (*dst.File, error)
• func Print(f *dst.File) error
• func Restore(file *dst.File) (*token.FileSet, *ast.File)
• type Decorator
  • func New() *Decorator
  • func (d *Decorator) Decorate(fset *token.FileSet, n ast.Node) dst.Node
• type Info
• type Restorer
  • func NewRestorer() *Restorer
  • func (r *Restorer) RestoreFile(name string, file *dst.File) *ast.File

Functions

func Decorate

func Decorate(fset *token.FileSet, n ast.Node) dst.Node

Decorate decorates an ast.Node and returns a dst.Node.

func DecorateFile

func DecorateFile(fset *token.FileSet, f *ast.File) *dst.File

Decorate decorates a *ast.File and returns a *dst.File.

func Fprint

func Fprint(w io.Writer, f *dst.File) error

Fprint uses format.Node to print a *dst.File to a writer

func Parse

func Parse(src interface{}) (*dst.File, error)

Parse uses parser.ParseFile to parse and decorate a Go source file. The src parameter should be string, []byte, or io.Reader.

func ParseDir

func ParseDir(fset *token.FileSet, path string, filter func(os.FileInfo) bool, mode parser.Mode) (map[string]*dst.Package, error)

ParseDir uses parser.ParseDir to parse and decorate a directory containing Go source.

func ParseExpr

func ParseExpr(x string) (dst.Expr, error)

ParseExpr uses parser.ParseExpr to parse and decorate a Go expression. It should be noted that this is of limited use because comments are not parsed by parser.ParseExpr.

func ParseExprFrom

func ParseExprFrom(fset *token.FileSet, filename string, src interface{}, mode parser.Mode) (dst.Expr, error)

ParseExprFrom uses parser.ParseExprFrom to parse and decorate a Go expression. It should be noted that this is of limited use because comments are not parsed by parser.ParseExprFrom.

func ParseFile

func ParseFile(fset *token.FileSet, filename string, src interface{}, mode parser.Mode) (*dst.File, error)

ParseFile uses parser.ParseFile to parse and decorate a Go source file.

func Print

func Print(f *dst.File) error

Print uses format.Node to print a *dst.File to stdout

func Restore

func Restore(file *dst.File) (*token.FileSet, *ast.File)

Restore restores a *dst.File to a *token.FileSet and a *ast.File

Types

type Decorator

type Decorator struct {
	DstNodes   map[ast.Node]dst.Node       // Mapping from ast to dst Nodes
	DstScopes  map[*ast.Scope]*dst.Scope   // Mapping from ast to dst Scopes
	DstObjects map[*ast.Object]*dst.Object // Mapping from ast to dst Objects
	AstNodes   map[dst.Node]ast.Node       // Mapping from dst to ast Nodes
	AstScopes  map[*dst.Scope]*ast.Scope   // Mapping from dst to ast Scopes
	AstObjects map[*dst.Object]*ast.Object // Mapping from dst to ast Objects
	Info       *Info                       // Info object containing source file names
	// contains filtered or unexported fields
}

func New

func New() *Decorator

New returns a new decorator.

func (*Decorator) Decorate

func (d *Decorator) Decorate(fset *token.FileSet, n ast.Node) dst.Node

Decorate decorates an ast.Node and returns a dst.Node

type Info

type Info struct {
	Filenames map[*dst.File]string // Source file names
}

type Restorer

type Restorer struct {
	Fset    *token.FileSet              // Fset is the *token.FileSet in use. Set this to use a pre-existing FileSet.
	Nodes   map[dst.Node]ast.Node       // Mapping from dst to ast Nodes
	Objects map[*dst.Object]*ast.Object // Mapping from dst to ast Objects
	Scopes  map[*dst.Scope]*ast.Scope   // Mapping from dst to ast Scopes
}

func NewRestorer

func NewRestorer() *Restorer

NewRestorer creates a new Restorer

func (*Restorer) RestoreFile

func (r *Restorer) RestoreFile(name string, file *dst.File) *ast.File

RestoreFile restores a *dst.File to an *ast.File