command

package
v0.5.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 2, 2026 License: MIT Imports: 14 Imported by: 0

Documentation

Overview

Package command supplies application-owned job operations. Parse before boot; Run borrows the application's configured connections and never owns a worker.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Declaration

func Declaration(construct func(foundation.Resolver) (*jobs.Connections, error)) (cli.Declaration, error)

Declaration registers one jobs command in the ordinary CLI registry. The constructor resolves configured services after boot; parsing/help does no I/O.

Types

type Command

type Command struct {
	// contains filtered or unexported fields
}

Command is a validated immutable operation. Retry is guarded by the token supplied on the command line, including when copied or invoked again. Bulk operations (retry-failed, flush-failed, clear) walk the queue in bounded pages and require --confirm; forget removes one retained terminal job.

func Parse

func Parse(args []string, help io.Writer) (Command, error)

Parse validates job-operation arguments and required confirmation flags without booting the application. Help is written to help and returns flag.ErrHelp.

func (Command) Run

func (c Command) Run(ctx context.Context, connections *jobs.Connections, output io.Writer) error

Run emits only operational metadata. It never exposes payloads or error text. Retry output always includes the supplied token. Any mutation/output failure requires reconciliation with that same token, never a newly fetched one.

Jump to

Keyboard shortcuts

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