build

type CancelCmd struct {
	BuildNumber string `arg:"" help:"Build number to cancel"`
	Pipeline    string `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Web         bool   `help:"Open the build in a web browser after it has been cancelled." short:"w"`
}

type CreateCmd struct {
	Message             string   `help:"Description of the build. If left blank, the commit message will be used once the build starts." short:"m"`
	Commit              string   `help:"The commit to build." short:"c" default:"HEAD"`
	Branch              string   `help:"The branch to build. Defaults to the default branch of the pipeline." short:"b"`
	Author              string   `help:"Author of the build. Supports: \"Name <email>\", \"email@domain.com\", \"Full Name\", or \"username\"" short:"a"`
	Web                 bool     `help:"Open the build in a web browser after it has been created." short:"w"`
	Pipeline            string   `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Env                 []string `help:"Set environment variables for the build (KEY=VALUE)" short:"e"`
	Metadata            []string `help:"Set metadata for the build (KEY=VALUE)" short:"M"`
	IgnoreBranchFilters bool     `help:"Ignore branch filters for the pipeline" short:"i"`
	EnvFile             string   `help:"Set the environment variables for the build via an environment file" short:"f"`
}

type DownloadCmd struct {
	BuildNumber string `arg:"" optional:"" help:"Build number to download (omit for most recent build)"`
	Pipeline    string `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Branch      string `help:"Filter builds to this branch." short:"b"`
	User        string `help:"Filter builds to this user. You can use name or email." short:"u" xor:"userfilter"`
	Mine        bool   `help:"Filter builds to only my user." short:"m" xor:"userfilter"`
}

type ListCmd struct {
	Pipeline string            `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Since    string            `help:"Filter builds created since this time (e.g. 1h, 30m)"`
	Until    string            `help:"Filter builds created before this time (e.g. 1h, 30m)"`
	Duration string            `help:"Filter by duration (e.g. >5m, <10m, 20m) - supports >, <, >=, <= operators"`
	State    []string          `help:"Filter by build state"`
	Branch   []string          `help:"Filter by branch name"`
	Creator  string            `help:"Filter by creator (email address or user ID)"`
	Commit   string            `help:"Filter by commit SHA"`
	Message  string            `help:"Filter by message content"`
	MetaData map[string]string `help:"Filter by build meta-data (key=value format, can be specified multiple times)"`
	Limit    int               `help:"Maximum number of builds to return" default:"50"`
	NoLimit  bool              `help:"Fetch all builds (overrides --limit)"`
	Output   string            `help:"Output format. One of: json, yaml, text" short:"o" default:"${output_default_format}" enum:"json,yaml,text"`
}

type RebuildCmd struct {
	BuildNumber string `arg:"" optional:"" help:"Build number to rebuild (omit for most recent build)"`
	Pipeline    string `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Branch      string `help:"Filter builds to this branch." short:"b"`
	User        string `help:"Filter builds to this user. You can use name or email." short:"u" xor:"userfilter"`
	Mine        bool   `help:"Filter builds to only my user." short:"m" xor:"userfilter"`
	Web         bool   `help:"Open the build in a web browser after it has been created." short:"w"`
}

type ViewCmd struct {
	BuildNumber string `arg:"" optional:"" help:"Build number to view (omit for most recent build)"`
	Pipeline    string `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Branch      string `help:"Filter builds to this branch." short:"b"`
	User        string `help:"Filter builds to this user. You can use name or email." short:"u" xor:"userfilter"`
	Mine        bool   `help:"Filter builds to only my user." xor:"userfilter"`
	Web         bool   `help:"Open the build in a web browser." short:"w"`
	Output      string `help:"Output format. One of: json, yaml, text" short:"o" default:"${output_default_format}" enum:"json,yaml,text"`
}

type WatchCmd struct {
	BuildNumber string `arg:"" optional:"" help:"Build number to watch (omit for most recent build)"`
	Pipeline    string `help:"The pipeline to use. This can be a {pipeline slug} or in the format {org slug}/{pipeline slug}." short:"p"`
	Branch      string `help:"The branch to watch builds for." short:"b"`
	Interval    int    `help:"Polling interval in seconds" default:"1"`
}