base

Documentation

Overview

Package base defines shared xtype pieces of the gop command, in particular logging and the Command structure.

Index

• Variables
• func AddBuildFlags(cmd *Command, mask BuildFlagMask)
• func Main(c *Command, app string, args []string)
• type BuildFlagMask
• type Command
  • func (c *Command) LongName() string
  • func (c *Command) Name() string
  • func (c *Command) Runnable() bool
  • func (c *Command) Usage(w io.Writer)

Variables

var (
	BuildContext = defaultContext()
	// BuildMod         string // -mod flag
	BuildModExplicit bool // whether -mod was set explicitly
	BuildX           bool // -x flag
	BuildV           bool // -v flag
	BuildSSA         bool // -ssa flag
	DebugSSATrace    bool // -ssa-trace flag
	ExperimentalGC   bool // -exp-gc flag experimental support runtime.GC
)

var CmdName string

CmdName - "build", "install", "list", "mod tidy", etc.

var Igop = &Command{
	UsageLine: "igop",
	Short:     `igop is a SSA interpreter of Go/Go+ source code.`,
}

igop command

var Usage func()

Usage is the usage-reporting function, filled in by package main but here for reference by other packages.

Functions

func AddBuildFlags

func AddBuildFlags(cmd *Command, mask BuildFlagMask)

AddBuildFlags adds the flags common to the build, run, and test commands.

func Main

func Main(c *Command, app string, args []string)

Main runs a command.

Types

type BuildFlagMask

type BuildFlagMask int

const (
	DefaultBuildFlags BuildFlagMask = 0
	OmitModFlag       BuildFlagMask = 1 << iota
	OmitVFlag
	OmitSSAFlag
	OmitSSATraceFlag
	OmitExperimentalGCFlag
)

type Command

type Command struct {
	// Run runs the command.
	// The args are the arguments after the command name.
	Run func(cmd *Command, args []string)

	// UsageLine is the one-line usage message.
	// The words between "gop" and the first flag or argument in the line are taken to be the command name.
	UsageLine string

	// Short is the short description shown in the 'gop help' output.
	Short string

	// Flag is a set of flags specific to this command.
	Flag flag.FlagSet

	// Commands lists the available commands and help topics.
	// The order here is the order in which they are printed by 'gop help'.
	// Note that subcommands are in general best avoided.
	Commands []*Command
}

A Command is an implementation of a gop command like gop export or gop install.

func (*Command) LongName

func (c *Command) LongName() string

LongName returns the command's long name: all the words in the usage line between "gop" and a flag or argument,

func (*Command) Name

func (c *Command) Name() string

Name returns the command's short name: the last word in the usage line before a flag or argument.

func (*Command) Runnable

func (c *Command) Runnable() bool

Runnable reports whether the command can be run; otherwise it is a documentation pseudo-command.

func (*Command) Usage

func (c *Command) Usage(w io.Writer)

Usage show the command usage.