Documentation
¶
Overview ¶
Package output formats command results for human and machine consumers.
Index ¶
- func AnonKeys(w io.Writer, keys []apiclient.AnonKey)
- func Database(w io.Writer, database *apiclient.Database, showConnectionString bool)
- func DatabaseBranch(w io.Writer, branch *apiclient.DatabaseBranch, showConnectionString bool)
- func DatabaseBranchConnectionString(w io.Writer, branch *apiclient.DatabaseBranch)
- func DatabaseBranchCreated(w io.Writer, branch *apiclient.DatabaseBranch, databaseName string, ...)
- func DatabaseBranches(w io.Writer, branches []apiclient.DatabaseBranch, databaseName string)
- func DatabaseCreated(w io.Writer, database *apiclient.Database, showConnectionString bool)
- func Databases(w io.Writer, page *apiclient.PaginatedDatabases, showConnectionString bool, ...)
- func Errorf(w io.Writer, format string, args ...any)
- func FormatTimeAgo(t time.Time) string
- func FormatTimestamp(t time.Time) string
- func Frontend(w io.Writer, fe *apiclient.Frontend)
- func FrontendCustomDomain(w io.Writer, domain *apiclient.FrontendCustomDomainResponse)
- func FrontendCustomDomains(w io.Writer, entries []FrontendCustomDomainEntry)
- func Frontends(w io.Writer, page *apiclient.PaginatedFrontends, commandPrefix ...string)
- func Function(w io.Writer, fn *apiclient.Function)
- func FunctionRuntimes(w io.Writer, runtimes []apiclient.FunctionRuntimeOption)
- func Functions(w io.Writer, page *apiclient.PaginatedFunctions, commandPrefix ...string)
- func GitConnected(w io.Writer, binding GitBinding)
- func GitConnection(w io.Writer, binding GitBinding)
- func GitDisconnected(w io.Writer, repoFullName string)
- func GitNotConnected(w io.Writer, project, connectCommand string)
- func GitStatus(w io.Writer, binding GitBinding)
- func LocalModeDockerUnavailable(w io.Writer)
- func LocalModeNotRunning(w io.Writer)
- func LocalModeStatus(w io.Writer, details LocalModeStatusDetails)
- func LogEvents(w io.Writer, events []apiclient.LogEvent)
- func LogSearchEvents(w io.Writer, events []apiclient.LogSearchEvent)
- func Note(w io.Writer, format string, args ...any)
- func PrintLogStreamEvent(w io.Writer, event *api.ProjectLogStreamEvent)
- func PrintSearchLogs(w io.Writer, fetch SearchLogsFetcher) error
- func PrintSearchLogsSkipping(w io.Writer, fetch SearchLogsFetcher, skip map[string]struct{}) error
- func Project(w io.Writer, project *apiclient.Project)
- func ProjectConfigApplyReport(w io.Writer, result *apiclient.ProjectConfigApplyResult)
- func ProjectConfigValidationErrors(w io.Writer, errs []apiclient.ProjectConfigValidationError)
- func Projects(w io.Writer, cfg *config.Config, page *apiclient.PaginatedProjects)
- func Scheduler(w io.Writer, scheduler *apiclient.FunctionScheduler)
- func Schedulers(w io.Writer, fn *apiclient.Function, ...)
- func StorageBucket(w io.Writer, bucket *apiclient.StorageBucket)
- func StorageBuckets(w io.Writer, buckets []apiclient.StorageBucket)
- func StorageObject(w io.Writer, bucketName string, object *apiclient.StorageObject)
- func StorageObjects(w io.Writer, bucketName string, page *apiclient.StorageListResponse, ...)
- func StoragePolicies(w io.Writer, bucketName string, policies []apiclient.StoragePolicy)
- func StoragePolicy(w io.Writer, bucketName string, policy *apiclient.StoragePolicy)
- func StorageStats(w io.Writer, stats *apiclient.StorageStats)
- func Success(w io.Writer, format string, args ...any)
- func Truncate(value string, maxLen int) string
- func Variable(w io.Writer, variable *apiclient.Variable)
- func Variables(w io.Writer, page *apiclient.PaginatedVariables, commandPrefix ...string)
- func Warning(w io.Writer, format string, args ...any)
- type FrontendCustomDomainEntry
- type GitBinding
- type LocalModeServiceStatus
- type LocalModeStatusDetails
- type SearchLogsFetcher
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AnonKeys ¶ added in v0.5.0
AnonKeys renders a project's anon keys. The key value is the publishable JWT for the frontend/SDK Authorization header, so it is printed in full.
func DatabaseBranch ¶ added in v0.21.0
func DatabaseBranch(w io.Writer, branch *apiclient.DatabaseBranch, showConnectionString bool)
DatabaseBranch renders one branch.
func DatabaseBranchConnectionString ¶ added in v0.21.0
func DatabaseBranchConnectionString(w io.Writer, branch *apiclient.DatabaseBranch)
DatabaseBranchConnectionString renders just a branch's connection string.
func DatabaseBranchCreated ¶ added in v0.21.0
func DatabaseBranchCreated(w io.Writer, branch *apiclient.DatabaseBranch, databaseName string, commandPrefix ...string)
DatabaseBranchCreated renders a branch that was just forked. The branch is still provisioning at this point, so there is no connection string to show.
func DatabaseBranches ¶ added in v0.21.0
func DatabaseBranches(w io.Writer, branches []apiclient.DatabaseBranch, databaseName string)
DatabaseBranches renders a database's branch list. The list endpoint omits connection strings, so there is nothing to reveal here.
func DatabaseCreated ¶
DatabaseCreated renders a newly created database.
func Databases ¶
func Databases(w io.Writer, page *apiclient.PaginatedDatabases, showConnectionString bool, commandPrefix ...string)
Databases renders one database list page.
func FormatTimeAgo ¶
FormatTimeAgo returns a compact relative timestamp or "-".
func FormatTimestamp ¶
FormatTimestamp returns a local RFC3339 timestamp or "-".
func FrontendCustomDomain ¶
func FrontendCustomDomain(w io.Writer, domain *apiclient.FrontendCustomDomainResponse)
FrontendCustomDomain renders one custom domain detail view.
func FrontendCustomDomains ¶
func FrontendCustomDomains(w io.Writer, entries []FrontendCustomDomainEntry)
FrontendCustomDomains renders custom domains configured for frontends.
func Frontends ¶
func Frontends(w io.Writer, page *apiclient.PaginatedFrontends, commandPrefix ...string)
Frontends renders one frontend list page.
func FunctionRuntimes ¶
func FunctionRuntimes(w io.Writer, runtimes []apiclient.FunctionRuntimeOption)
FunctionRuntimes renders function runtime options.
func Functions ¶
func Functions(w io.Writer, page *apiclient.PaginatedFunctions, commandPrefix ...string)
Functions renders one function list page.
func GitConnected ¶ added in v0.22.0
func GitConnected(w io.Writer, binding GitBinding)
GitConnected renders a repository binding that was just made, followed by what a push to the production branch will actually deploy. Settings are optional: a connect still succeeded if reading them afterwards did not.
func GitConnection ¶ added in v0.22.0
func GitConnection(w io.Writer, binding GitBinding)
GitConnection renders an existing binding without claiming anything changed.
func GitDisconnected ¶ added in v0.22.0
GitDisconnected renders a removed binding. The repository is untouched, which is worth saying: "disconnect" reads as destructive and is not.
func GitNotConnected ¶ added in v0.22.0
GitNotConnected renders a project with no repository bound. This is a state, not a failure, so it reads as an answer and says what would change it.
func GitStatus ¶ added in v0.22.0
func GitStatus(w io.Writer, binding GitBinding)
GitStatus renders a binding as a plain report. It deliberately does not read as an outcome — nothing was just done — and it names no GitHub account, because answering that would mean contacting the provider, which the command behind it does not do.
func LocalModeDockerUnavailable ¶
LocalModeDockerUnavailable renders Docker setup guidance for local mode.
func LocalModeNotRunning ¶
LocalModeNotRunning renders the local-mode status when the stack is stopped.
func LocalModeStatus ¶
func LocalModeStatus(w io.Writer, details LocalModeStatusDetails)
LocalModeStatus renders local-mode service status and metadata.
func LogSearchEvents ¶ added in v0.0.4
func LogSearchEvents(w io.Writer, events []apiclient.LogSearchEvent)
LogSearchEvents renders function log search events.
func PrintLogStreamEvent ¶ added in v0.0.4
func PrintLogStreamEvent(w io.Writer, event *api.ProjectLogStreamEvent)
PrintLogStreamEvent renders one parsed project log stream event.
func PrintSearchLogs ¶ added in v0.0.4
func PrintSearchLogs(w io.Writer, fetch SearchLogsFetcher) error
PrintSearchLogs renders paginated searched log events from fetch until the response signals no more pages or the cursor cannot be advanced.
func PrintSearchLogsSkipping ¶ added in v0.0.4
func PrintSearchLogsSkipping(w io.Writer, fetch SearchLogsFetcher, skip map[string]struct{}) error
PrintSearchLogsSkipping renders paginated searched log events, excluding IDs already present in skip.
func ProjectConfigApplyReport ¶ added in v0.0.5
func ProjectConfigApplyReport(w io.Writer, result *apiclient.ProjectConfigApplyResult)
ProjectConfigApplyReport renders the server's config apply (or dry-run) report: per-section action counts, per-entry errors and notices, and prominent warnings for skipped and missing resources.
func ProjectConfigValidationErrors ¶ added in v0.0.5
func ProjectConfigValidationErrors(w io.Writer, errs []apiclient.ProjectConfigValidationError)
ProjectConfigValidationErrors renders the server's 422 validation error list, one line per entry.
func Scheduler ¶
func Scheduler(w io.Writer, scheduler *apiclient.FunctionScheduler)
Scheduler renders one scheduler.
func Schedulers ¶
Schedulers renders schedulers configured for a function.
func StorageBucket ¶
func StorageBucket(w io.Writer, bucket *apiclient.StorageBucket)
StorageBucket renders one bucket detail view.
func StorageBuckets ¶
func StorageBuckets(w io.Writer, buckets []apiclient.StorageBucket)
StorageBuckets renders one bucket list.
func StorageObject ¶
func StorageObject(w io.Writer, bucketName string, object *apiclient.StorageObject)
StorageObject renders one object detail view.
func StorageObjects ¶
func StorageObjects(w io.Writer, bucketName string, page *apiclient.StorageListResponse, commandPrefix ...string)
StorageObjects renders one cursor page of objects.
func StoragePolicies ¶
func StoragePolicies(w io.Writer, bucketName string, policies []apiclient.StoragePolicy)
StoragePolicies renders one policy list.
func StoragePolicy ¶
func StoragePolicy(w io.Writer, bucketName string, policy *apiclient.StoragePolicy)
StoragePolicy renders one policy detail view.
func StorageStats ¶
func StorageStats(w io.Writer, stats *apiclient.StorageStats)
StorageStats renders aggregate project storage usage.
Types ¶
type FrontendCustomDomainEntry ¶
type FrontendCustomDomainEntry struct {
FrontendName string
FrontendID string
Domain apiclient.FrontendCustomDomainResponse
}
FrontendCustomDomainEntry contains one frontend custom domain row.
type GitBinding ¶ added in v0.22.0
type GitBinding struct {
Connection *apiclient.ProjectGitConnection
Settings *apiclient.ProjectGitDeploySettings
// Project labels the project that was bound.
Project string
// GitHubAccount is the connected GitHub account whose stored token the
// platform reads the repository with. Empty when it is not known, as it is
// not for a binding that was only read back.
GitHubAccount string
// InstallationAccount is the account the App installation belongs to. It is
// reported only when it differs from the repository's owner, which is the
// case worth pointing out.
InstallationAccount string
// SettingsErr is why Settings could not be read, when they could not. The
// binding is unaffected by that failure, so it is reported as a warning
// rather than swallowed: "nothing to say about what a push deploys" and
// "could not find out" are different states, and only one of them is safe
// to read as "no deploy configured".
SettingsErr error
}
GitBinding is everything worth reporting about a binding: what was bound, which project it was bound to, and which GitHub identity it was bound through. The project and the GitHub identity are chosen by the CLI rather than named by the user, which is why they are reported rather than assumed.
type LocalModeServiceStatus ¶
LocalModeServiceStatus is one local-mode service status row.
type LocalModeStatusDetails ¶
type LocalModeStatusDetails struct {
Services []LocalModeServiceStatus
ProjectID string
UserID string
APIURL string
AnonKey string
ServiceKey string
DatabaseURL string
PSQLCommand string
}
LocalModeStatusDetails contains the data rendered by `volcano status`.
type SearchLogsFetcher ¶ added in v0.0.4
type SearchLogsFetcher func(cursor string) (*apiclient.LogSearchResponse, error)
SearchLogsFetcher fetches one page of searched log events. An empty cursor requests the first page.
Source Files