mage

Documentation

Index

• func Compile(magePath, goCmd, compileTo string, gofiles []string, isDebug bool, ...) error
• func ExeName(goCmd, cacheDir string, files []string) (string, error)
• func GenerateMainfile(path, cachedir string, info *parse.PkgInfo) (hash string, _ error)
• func Invoke(inv Invocation) int
• func Magefiles(magePath, goCmd string, stderr io.Writer, isDebug bool) ([]string, error)
• func Main() int
• func Parse(stderr, stdout io.Writer, args []string) (inv Invocation, cmd Command, err error)
• func ParseAndRun(stdout, stderr io.Writer, stdin io.Reader, args []string) int
• func RunCompiled(inv Invocation, exePath string) int
• type Command
  • func (i Command) String() string
• type Invocation

Functions

func Compile

func Compile(magePath, goCmd, compileTo string, gofiles []string, isDebug bool, stderr, stdout io.Writer) error

Compile uses the go tool to compile the files into an executable at path.

func ExeName

func ExeName(goCmd, cacheDir string, files []string) (string, error)

ExeName reports the executable filename that this version of Mage would create for the given magefiles.

func GenerateMainfile

func GenerateMainfile(path, cachedir string, info *parse.PkgInfo) (hash string, _ error)

GenerateMainfile generates the mage mainfile at path. Because go build's cache cares about modtimes, we squirrel away our mainfiles in the cachedir and move them back as needed.

func Invoke

func Invoke(inv Invocation) int

Invoke runs Mage with the given arguments.

func Magefiles

func Magefiles(magePath, goCmd string, stderr io.Writer, isDebug bool) ([]string, error)

Magefiles returns the list of magefiles in dir.

func Main

func Main() int

Main is the entrypoint for running mage. It exists external to mage's main function to allow it to be used from other programs, specifically so you can go run a simple file that run's mage's Main.

func Parse

func Parse(stderr, stdout io.Writer, args []string) (inv Invocation, cmd Command, err error)

Parse parses the given args and returns structured data. If parse returns flag.ErrHelp, the calling process should exit with code 0.

func ParseAndRun

func ParseAndRun(stdout, stderr io.Writer, stdin io.Reader, args []string) int

ParseAndRun parses the command line, and then compiles and runs the mage files in the given directory with the given args (do not include the command name in the args).

func RunCompiled

func RunCompiled(inv Invocation, exePath string) int

RunCompiled runs an already-compiled mage command with the given args,

Types

type Command

type Command int

Command tracks invocations of mage that run without targets or other flags.

const (
	None          Command = iota
	Version               // report the current version of mage
	Init                  // create a starting template for mage
	Clean                 // clean out old compiled mage binaries from the cache
	CompileStatic         // compile a static binary of the current directory
)

The various command types

func (Command) String

func (i Command) String() string

type Invocation

type Invocation struct {
	Debug      bool          // turn on debug messages
	Dir        string        // directory to read magefiles from
	Force      bool          // forces recreation of the compiled binary
	Verbose    bool          // tells the magefile to print out log statements
	List       bool          // tells the magefile to print out a list of targets
	Help       bool          // tells the magefile to print out help for a specific target
	Keep       bool          // tells mage to keep the generated main file after compiling
	Timeout    time.Duration // tells mage to set a timeout to running the targets
	CompileOut string        // tells mage to compile a static binary to this path, but not execute
	Stdout     io.Writer     // writer to write stdout messages to
	Stderr     io.Writer     // writer to write stderr messages to
	Stdin      io.Reader     // reader to read stdin from
	Args       []string      // args to pass to the compiled binary
	GoCmd      string        // the go binary command to run
	CacheDir   string        // the directory where we should store compiled binaries
}

Invocation contains the args for invoking a run of Mage.