diag

Documentation

Index

• Constants
• type Diag
  • func GetAnalyzeResourceFailureError(urn resource.URN) *Diag
  • func GetDuplicateResourceURNError(urn resource.URN) *Diag
  • func GetPlanApplyFailedError(urn resource.URN) *Diag
  • func GetPreviewFailedError(urn resource.URN) *Diag
  • func GetResourceInvalidError(urn resource.URN) *Diag
  • func GetResourcePropertyInvalidValueError(urn resource.URN) *Diag
  • func Message(urn resource.URN, msg string) *Diag
  • func RawMessage(urn resource.URN, msg string) *Diag
  • func StreamMessage(urn resource.URN, msg string, streamID int32) *Diag
• type FormatOptions
• type ID
• type Severity
• type Sink
  • func DefaultSink(stdout io.Writer, stderr io.Writer, opts FormatOptions) Sink

Constants

const DefaultSinkIDPrefix = "PU"

Types

type Diag

type Diag struct {
	URN     resource.URN // Resource this diagnostics is associated with.  Empty if not associated with any resource.
	ID      ID           // a unique identifier for this diagnostic.
	Message string       // a human-friendly message for this diagnostic.
	Raw     bool         // true if this diagnostic should not be formatted when displayed.

	// An ID used to collate a stream of conceptually sequential messages.  0 means that the message
	// is not part of any sequential message stream.
	StreamID int32
}

Diag is an instance of an error or warning generated by the compiler.

func GetAnalyzeResourceFailureError

func GetAnalyzeResourceFailureError(urn resource.URN) *Diag

func GetDuplicateResourceURNError

func GetDuplicateResourceURNError(urn resource.URN) *Diag

func GetPlanApplyFailedError

func GetPlanApplyFailedError(urn resource.URN) *Diag

func GetPreviewFailedError

func GetPreviewFailedError(urn resource.URN) *Diag

func GetResourceInvalidError

func GetResourceInvalidError(urn resource.URN) *Diag

func GetResourcePropertyInvalidValueError

func GetResourcePropertyInvalidValueError(urn resource.URN) *Diag

func Message

func Message(urn resource.URN, msg string) *Diag

Message returns an anonymous diagnostic message without any source or ID information.

func RawMessage

func RawMessage(urn resource.URN, msg string) *Diag

RawMessage returns an anonymous diagnostic message without any source or ID information that will not be rendered with Sprintf.

func StreamMessage

func StreamMessage(urn resource.URN, msg string, streamID int32) *Diag

StreamMessage returns an anonymous diagnostic message without any source or ID information that is associated with the given stream ID. Displays can use this ID to combine all the messages from a single stream into an entire message, while still rendering the pieces as they come in.

type FormatOptions

type FormatOptions struct {
	Pwd   string              // the working directory.
	Color colors.Colorization // how output should be colorized.
	Debug bool                // if true, debugging will be output to stdout.
}

FormatOptions controls the output style and content.

type ID

type ID int

ID is a unique diagnostics identifier.

type Severity

type Severity string

Severity dictates the kind of diagnostic.

const (
	Debug   Severity = "debug"
	Info    Severity = "info"
	Infoerr Severity = "info#err"
	Warning Severity = "warning"
	Error   Severity = "error"
)

type Sink

type Sink interface {
	// Logf issues a log message.
	Logf(sev Severity, diag *Diag, args ...interface{})
	// Debugf issues a debugging message.
	Debugf(diag *Diag, args ...interface{})
	// Infof issues an informational message (to stdout).
	Infof(diag *Diag, args ...interface{})
	// Infoerrf issues an informational message (to stderr).
	Infoerrf(diag *Diag, args ...interface{})
	// Errorf issues a new error diagnostic.
	Errorf(diag *Diag, args ...interface{})
	// Warningf issues a new warning diagnostic.
	Warningf(diag *Diag, args ...interface{})

	// Stringify stringifies a diagnostic into a prefix and message that is appropriate for printing.
	Stringify(sev Severity, diag *Diag, args ...interface{}) (string, string)
}

Sink facilitates pluggable diagnostics messages.

func DefaultSink

func DefaultSink(stdout io.Writer, stderr io.Writer, opts FormatOptions) Sink

DefaultSink returns a default sink that simply logs output to stderr/stdout.