pulumi/pkg/engine/eventsink.go
Sean Gillespie 703a954839
Improve error messages output by the CLI (#1011)
* Improve error messages output by the CLI

This fixes a couple known issues with the way that we present errors
from the Pulumi CLI:
    1. Any errors from RPC endpoints were bubbling up as they were to
    the top-level, which was unfortunate because they contained
    RPC-specific noise that we don't want to present to the user. This
    commit unwraps errors from resource providers.
    2. The "catastrophic error" message often got printed twice
    3. Fatal errors are often printed twice, because our CLI top-level
    prints out the fatal error that it receives before exiting. A lot of
    the time this error has already been printed.
    4. Errors were prefixed by PU####.

* Feedback: Omit the 'catastrophic' error message and use a less verbose error message as the final error

* Code review feedback: interpretRPCError -> resourceStateAndError

* Code review feedback: deleting some commented-out code, error capitalization

* Cleanup after rebase
2018-03-09 15:43:16 -08:00

151 lines
4.2 KiB
Go

package engine
import (
"bytes"
"fmt"
"sync"
"github.com/pulumi/pulumi/pkg/diag"
"github.com/golang/glog"
"github.com/pulumi/pulumi/pkg/diag/colors"
"github.com/pulumi/pulumi/pkg/util/contract"
)
func newEventSink(events eventEmitter) diag.Sink {
return &eventSink{
events: events,
counts: make(map[diag.Severity]int),
}
}
// eventSink is a sink which writes all events to a channel
type eventSink struct {
events eventEmitter // the channel to emit events into.
counts map[diag.Severity]int // the number of messages that have been issued per severity.
mutex sync.RWMutex // a mutex for guarding updates to the counts map
}
func (s *eventSink) Count() int { return s.Debugs() + s.Infos() + s.Errors() + s.Warnings() }
func (s *eventSink) Debugs() int { return s.getCount(diag.Debug) }
func (s *eventSink) Infos() int { return s.getCount(diag.Info) }
func (s *eventSink) Infoerrs() int { return s.getCount(diag.Infoerr) }
func (s *eventSink) Errors() int { return s.getCount(diag.Error) }
func (s *eventSink) Warnings() int { return s.getCount(diag.Warning) }
func (s *eventSink) Success() bool { return s.Errors() == 0 }
func (s *eventSink) Logf(sev diag.Severity, d *diag.Diag, args ...interface{}) {
switch sev {
case diag.Debug:
s.Debugf(d, args...)
case diag.Info:
s.Infof(d, args...)
case diag.Infoerr:
s.Infoerrf(d, args...)
case diag.Warning:
s.Warningf(d, args...)
case diag.Error:
s.Errorf(d, args...)
default:
contract.Failf("Unrecognized severity: %v", sev)
}
}
func (s *eventSink) Debugf(d *diag.Diag, args ...interface{}) {
// For debug messages, write both to the glogger and a stream, if there is one.
glog.V(3).Infof(d.Message, args...)
msg := s.Stringify(diag.Debug, d, args...)
if glog.V(9) {
glog.V(9).Infof("eventSink::Debug(%v)", msg[:len(msg)-1])
}
s.events.diagDebugEvent(msg)
s.incrementCount(diag.Debug)
}
func (s *eventSink) Infof(d *diag.Diag, args ...interface{}) {
msg := s.Stringify(diag.Info, d, args...)
if glog.V(5) {
glog.V(5).Infof("eventSink::Info(%v)", msg[:len(msg)-1])
}
s.events.diagInfoEvent(msg)
s.incrementCount(diag.Info)
}
func (s *eventSink) Infoerrf(d *diag.Diag, args ...interface{}) {
msg := s.Stringify(diag.Info /* not Infoerr, just "info: "*/, d, args...)
if glog.V(5) {
glog.V(5).Infof("eventSink::Infoerr(%v)", msg[:len(msg)-1])
}
s.events.diagInfoerrEvent(msg)
s.incrementCount(diag.Infoerr)
}
func (s *eventSink) Errorf(d *diag.Diag, args ...interface{}) {
msg := s.Stringify(diag.Error, d, args...)
if glog.V(5) {
glog.V(5).Infof("eventSink::Error(%v)", msg[:len(msg)-1])
}
s.events.diagErrorEvent(msg)
s.incrementCount(diag.Error)
}
func (s *eventSink) Warningf(d *diag.Diag, args ...interface{}) {
msg := s.Stringify(diag.Warning, d, args...)
if glog.V(5) {
glog.V(5).Infof("eventSink::Warning(%v)", msg[:len(msg)-1])
}
s.events.diagWarningEvent(msg)
s.incrementCount(diag.Warning)
}
func (s *eventSink) incrementCount(sev diag.Severity) {
s.mutex.Lock()
defer s.mutex.Unlock()
s.counts[sev]++
}
func (s *eventSink) getCount(sev diag.Severity) int {
s.mutex.RLock()
defer s.mutex.RUnlock()
return s.counts[sev]
}
func (s *eventSink) Stringify(sev diag.Severity, d *diag.Diag, args ...interface{}) string {
var buffer bytes.Buffer
// Now print the message category's prefix (error/warning).
switch sev {
case diag.Debug:
buffer.WriteString(colors.SpecDebug)
case diag.Info, diag.Infoerr:
buffer.WriteString(colors.SpecInfo)
case diag.Error:
buffer.WriteString(colors.SpecError)
case diag.Warning:
buffer.WriteString(colors.SpecWarning)
default:
contract.Failf("Unrecognized diagnostic severity: %v", sev)
}
buffer.WriteString(string(sev))
buffer.WriteString(": ")
buffer.WriteString(colors.Reset)
// Finally, actually print the message itself.
buffer.WriteString(colors.SpecNote)
if d.Raw {
buffer.WriteString(d.Message)
} else {
buffer.WriteString(fmt.Sprintf(d.Message, args...))
}
buffer.WriteString(colors.Reset)
buffer.WriteRune('\n')
// TODO[pulumi/pulumi#15]: support Clang-style expressive diagnostics. This would entail, for example, using
// the buffer within the target document, to demonstrate the offending line/column range of code.
return buffer.String()
}