parse

Documentation

Index

• func EnableDebug()
• type Function
  • func (f Function) ExecCode() (string, error)
  • func (f Function) ID() string
  • func (f Function) TargetName() string
• type PkgInfo
  • func Package(path string, files []string) (*PkgInfo, error)

Functions

func EnableDebug

func EnableDebug()

EnableDebug turns on debug logging.

Types

type Function

type Function struct {
	PkgAlias   string
	Package    string
	ImportPath string
	Name       string
	Receiver   string
	IsError    bool
	IsContext  bool
	Synopsis   string
	Comment    string
}

Function represented a job function from a mage file

func (Function) ExecCode

func (f Function) ExecCode() (string, error)

ExecCode returns code for the template switch to run the target. It wraps each target call to match the func(context.Context) error that runTarget requires.

func (Function) ID

func (f Function) ID() string

ID returns user-readable information about where this function is defined.

func (Function) TargetName

func (f Function) TargetName() string

TargetName returns the name of the target as it should appear when used from the mage cli. It is always lowercase.

type PkgInfo

type PkgInfo struct {
	Description string
	Funcs       []*Function
	DefaultFunc *Function
	Aliases     map[string]*Function
	Imports     map[string]string
	RootImports []string
}

PkgInfo contains inforamtion about a package of files according to mage's parsing rules.

func Package

func Package(path string, files []string) (*PkgInfo, error)

Package parses a package. If files is non-empty, it will only parse the files given.