cmd

package

v8.91.7 Latest Latest Go to latest Published: Sep 23, 2026 License: Apache-2.0 Imports: 23 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/giantswarm/devctl

Links

Open Source Insights

Documentation ¶

Index ¶

func Execute(root *cobra.Command, stderr io.Writer) int
func IsInvalidConfig(err error) bool
func IsInvalidFlags(err error) bool
func New(config Config) (*cobra.Command, error)
type Config
type UsageError
- func (e *UsageError) Error() string
- func (e *UsageError) Unwrap() error

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Execute ¶ added in v8.91.4

func Execute(root *cobra.Command, stderr io.Writer) int

Execute runs root with the process arguments and returns the exit code. An agent-facing command has written its JSON document already: its outcome is the exit code and nothing more is printed. Any other error is printed on stderr for a person: a wrong call with the command's usage line and a pointer to its help, the stack trace only at --log-level debug.

func IsInvalidConfig ¶

func IsInvalidConfig(err error) bool

IsInvalidConfig asserts invalidConfigError.

func IsInvalidFlags ¶

func IsInvalidFlags(err error) bool

IsInvalidFlags asserts invalidFlagsError.

func New ¶

func New(config Config) (*cobra.Command, error)

Types ¶

type Config ¶

type Config struct {
	Logger micrologger.Logger
	Stderr io.Writer
	Stdout io.Writer

	BinaryName string
}

type UsageError ¶ added in v8.91.4

type UsageError struct {
	Command *cobra.Command
	Err     error
	// Usage prints the command's usage line under the message; an unknown
	// subcommand prints only the pointer to the help, which lists them.
	Usage bool
}

UsageError is a command called the wrong way: an argument, a flag or a subcommand it does not take. It is printed with the command's usage line and a pointer to its help, never with a stack trace.

func (*UsageError) Error ¶ added in v8.91.4

func (e *UsageError) Error() string

func (*UsageError) Unwrap ¶ added in v8.91.4

func (e *UsageError) Unwrap() error

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
auth
login
status
completion
deploy
gen
ami
apptest
circleci
dependabot
llm
makefile
precommit
renovate
renovate/reviewers
workflows
pr
approvealign
approvemergerenovate
merge
wait
release
archive
create
wait
replace
repo
adopt Package adopt is `devctl repo adopt`: an existing, undeclared repository declared in a team's file.	Package adopt is `devctl repo adopt`: an existing, undeclared repository declared in a team's file.
align Package align is `devctl repo align`: Align now for one repository, through the reconciler, in the mode its team-file entry decides.	Package align is `devctl repo align`: Align now for one repository, through the reconciler, in the mode its team-file entry decides.
approve Package approve is `devctl repo approve`: the approving review of a team-file pull request, as the person, after the team check.	Package approve is `devctl repo approve`: the approving review of a team-file pull request, as the person, after the team check.
checks
create
get Package get is `devctl repo get`: one inventory record of giantswarm-repo-manager.	Package get is `devctl repo get`: one inventory record of giantswarm-repo-manager.
info Package info is `devctl repo info`: how giantswarm-repo-manager sees the call -- the caller, the identities, the inventory, the engine.	Package info is `devctl repo info`: how giantswarm-repo-manager sees the call -- the caller, the identities, the inventory, the engine.
internal/auth Package auth resolves the GitHub token the repo commands act with: the person's own, so a pull request they open is theirs.	Package auth resolves the GitHub token the repo commands act with: the person's own, so a pull request they open is theirs.
internal/client Package client is what the repo commands that call giantswarm-repo-manager share: the muster token from the keychain, the manager client over the person's muster endpoint, the output flag, and the text renderers of the answers the verbs have in common.	Package client is what the repo commands that call giantswarm-repo-manager share: the muster token from the keychain, the manager client over the person's muster endpoint, the output flag, and the text renderers of the answers the verbs have in common.
internal/engine Package engine is what the repo commands share to run the set-up steps of pkg/reposetup/reconcile as the person: the clients from the token environment variables, the repository slug, the log adapter and the result on stdout.	Package engine is what the repo commands share to run the set-up steps of pkg/reposetup/reconcile as the person: the clients from the token environment variables, the repository slug, the log adapter and the result on stdout.
internal/write Package write is what the team-file writes share -- adopt, update, transfer, set-lifecycle: one call to a write tool of giantswarm-repo-manager with dryRun or mode commit, the plan printed on a dry run and the outcome on a commit.	Package write is what the team-file writes share -- adopt, update, transfer, set-lifecycle: one call to a write tool of giantswarm-repo-manager with dryRun or mode commit, the plan printed on a dry run and the outcome on a commit.
list Package list is `devctl repo list`: the inventory of the org's repositories as giantswarm-repo-manager holds it, scoped and filtered as on the Repositories page.	Package list is `devctl repo list`: the inventory of the org's repositories as giantswarm-repo-manager holds it, scoped and filtered as on the Repositories page.
reconcile
setlifecycle Package setlifecycle is `devctl repo set-lifecycle`: a declared repository deprecated, archived or deleted through its team-file entry.	Package setlifecycle is `devctl repo set-lifecycle`: a declared repository deprecated, archived or deleted through its team-file entry.
setup
setup/ciwebhooks
setup/renovate
status
sweep Package sweep is `devctl repo sweep`: the full inventory sweep, started now.	Package sweep is `devctl repo sweep`: the full inventory sweep, started now.
transfer Package transfer is `devctl repo transfer`: a declared repository moved to another team.	Package transfer is `devctl repo transfer`: a declared repository moved to another team.
update Package update is `devctl repo update`: a declared repository's team-file entry changed.	Package update is `devctl repo update`: a declared repository's team-file entry changed.
validate
watch Package watch is `devctl repo watch`: a new repository followed to readiness after its creation.	Package watch is `devctl repo watch`: a new repository followed to readiness after its creation.
version
check
update

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL