37 lines
1.5 KiB
Go
37 lines
1.5 KiB
Go
// Copyright 2016-2018, Pulumi Corporation. All rights reserved.
|
|
|
|
package diag
|
|
|
|
import (
|
|
"github.com/pulumi/pulumi/pkg/resource"
|
|
)
|
|
|
|
// ID is a unique diagnostics identifier.
|
|
type ID int
|
|
|
|
// Diag is an instance of an error or warning generated by the compiler.
|
|
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.
|
|
StreamID int32 // An ID used to collate a stream of conceptually sequention messages.
|
|
}
|
|
|
|
// Message returns an anonymous diagnostic message without any source or ID information.
|
|
func Message(urn resource.URN, msg string) *Diag {
|
|
return &Diag{URN: urn, Message: msg}
|
|
}
|
|
|
|
// RawMessage returns an anonymous diagnostic message without any source or ID information that will not be rendered
|
|
// with Sprintf.
|
|
func RawMessage(urn resource.URN, msg string) *Diag {
|
|
return &Diag{URN: urn, Message: msg, Raw: true}
|
|
}
|
|
|
|
// 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.
|
|
func StreamMessage(urn resource.URN, msg string, streamID int32) *Diag {
|
|
return &Diag{URN: urn, Message: msg, Raw: true, StreamID: streamID}
|
|
}
|