output

type EndOperationStatus interface {
	Fprintln(w io.Writer, format string, a ...any) (n int, err error)
}

type Output interface {
	// Info displays informative output.
	//
	// Example:
	//  output.Info("namespace created")
	Info(msg string)

	// Infof displays informative output.
	//
	// Example:
	//  output.Infof("namespace %q created", namespace)
	Infof(format string, args ...interface{})

	// InfoWriter returns a writer for informative output.
	//
	// Example:
	//  io.WriteString(output.InfoWriter(), "namespace created")
	InfoWriter() io.Writer

	// Warn communicates a warning to the user.
	//
	// Example:
	//  output.Warn("could not connect, retrying...")
	Warn(msg string)

	// Warnf communicates a warning to the user.
	//
	// Example:
	//  output.Warnf("could not connect to %q, retrying...", service)
	Warnf(format string, args ...interface{})

	// WarnWriter returns a writer for warnings.
	//
	// Example:
	//  io.WriteString(output.WarnWriter(), "could not connect, retrying...")
	WarnWriter() io.Writer

	// Error communicates an error to the users.
	//
	// Example:
	//  output.Error(err, "namespace could not be created")
	Error(err error, msg string)

	// Errorf communicates an error to the users.
	//
	// Example:
	//  output.Errorf(err, "namespace %q could not be created", namespace)
	Errorf(err error, format string, args ...interface{})

	// ErrorWriter returns a writer for errors.
	//
	// Example:
	//  io.WriteString(output.ErrorWriter(), "namespace could not be created")
	ErrorWriter() io.Writer

	// StartOperation communicates the beginning of a long-running operation.
	// If running in a terminal, a progress animation will be shown. Starting a
	// new operation ends any previously running operation.
	//
	// Example:
	//  output.StartOperation("installing package")
	//  err := installPackage()
	//  if err != nil {
	//  	output.EndOperation(false)
	//  	output.Error(err, "")
	//  	return
	//  }
	//  output.EndOperation(true)
	StartOperation(status string)

	// StartOperationWithProgress communicates the beginning of a long-running operation.
	// If running in a terminal, a progress animation will be shown. Starting a
	// new operation ends any previously running operation.
	// This behaves identical to StartOperation above but with an extra progress bar with time elapsed.
	//
	// Example:
	//  gauge := &ProgressGauge{}
	//  gauge.SetStatus("descriptive status that need not be static")
	//  gauge.SetCapacity(10)
	//  output.StartOperationWithProgress(gauge)
	//  for (int i = 0; i < 10; i++) {
	//     err = longWaitFunction()
	//     if err != nil {
	//  	 output.EndOperation(false)
	//		 output.Error(err, "")
	//  	 return
	//     }
	//     gauge.Inc()
	//  }
	//
	//  if err != nil {
	//  	output.EndOperation(false)
	//  	output.Error(err, "")
	//  	return
	//  }
	//  output.EndOperation(true)
	StartOperationWithProgress(gauge *ProgressGauge)

	// Deprecated: Use EndOperationWithStatus instead. EndOperation exists for historical compatibility
	// and should not be used.
	//
	// EndOperation communicates the end of a long-running operation, either because
	// the operation completed successfully or failed (parameter success).
	//
	// Example:
	//  output.StartOperation("installing package")
	//  err := installPackage()
	//  if err != nil {
	//  	output.EndOperation(false)
	//  	output.Error(err, "")
	//  	return
	//  }
	//  output.EndOperation(true)
	EndOperation(success bool)

	// EndOperation communicates the end of a long-running operation, either because
	// the operation completed successfully or failed (parameter success).
	//
	// Example:
	//  output.StartOperation("installing package")
	//  err := installPackage()
	//  if err != nil {
	//  	output.EndOperationWithStatus(output.Failure())
	//  	output.Error(err, "")
	//  	return
	//  }
	//  output.EndOperationWithStatus(output.Success())
	EndOperationWithStatus(endStatus EndOperationStatus)

	// Result outputs the result of an operation, e.g. a "get <something>" command.
	//
	// Example:
	//  output.Result(pods.String())
	Result(result string)

	// ResultWriter returns a writer for command results.
	//
	// Example:
	//  encoder := json.NewEncoder(output.ResultWriter())
	//  encoder.Encode(object)
	ResultWriter() io.Writer

	// V returns an Output with a higher verbosity level (default: 0).
	// Info and Error output with a higher verbosity is only displayed if the
	// "--verbose" flag is set to an equal or higher value.
	//
	// Example:
	//  output.V(1).Info("verbose information")
	V(level int) Output

	// WithValues returns an Output with additional context in the form of
	// structured data (key-value pairs). Not displayed in interactive shells.
	//
	// Example:
	//  output.WithValues("cluster", clusterName).Info("namespace created")
	WithValues(keysAndValues ...interface{}) Output
}

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