Package logcap is for capturing Logrus log entries and comparing them with Gomega matchers.
It's designed to work within Ginkgo test suites:
package main
import (
"testing"
"github.com/allenluce/logcap"
"github.com/sirupsen/logrus"
. "github.com/onsi/ginkgo"
. "github.com/onsi/gomega"
)
var _ = Describe("matches logs", func() {
It("matcher", func() {
logHook := logcap.NewLogHook()
logHook.Start()
defer logHook.Stop()
logrus.Info("This is a log entry")
Ω(logHook).Should(logcap.HaveLogs("This is a log entry"))
})
})
func TestThings(t *testing.T) {
RegisterFailHandler(Fail)
RunSpecs(t, "Logcap Suite")
}
func HaveLogs(args ...interface{}) types.GomegaMatcherHaveLogs takes a number of strings, Gomega matchers and/or logrus.Fields as arguments. It attempts to match logs based on the strings/matchers given. If a logrus.Fields{} argument is given, it is applied to all strings/matchers that precede it up until the previous logrus.Fields{} argument. To succeed, all strings/matchers must match along with their associated logrus.Fields{} argument.
This matches three distinct log entries, each with a {"task": "exiting"} field set:
HaveLogs("culler", "tallier", "summer", logrus.Fields{"task": "exiting"})
This matches two log entries with empty field sets, and one without:
HaveLogs("alpha", "beta", logrus.Fields{}, "gamma", logrus.Fields{"big": "whoop"})
An optional time.Duration added to the arguments will set the timeout for HaveLogs giving up on waiting for a match.
HaveLogs("summation", time.Seconds*100)
The default timeout is two seconds.
func HaveNoLogs() types.GomegaMatcherHaveNoLogs is the inverse of HaveLogs(). It makes sure that there are no logs that haven't been matched already.
type LogCap struct {
}Logcap is the base type that implements a Logrus hook.
func NewLogHook(l ...*logrus.Logger) *LogCapNewLogHook creates a new LogCap hook. If supplied with a logger, it'll attach the hook to that logger. Otherwise it'll attach to the logrus.StandardLogger()
func (hook *LogCap) Display(levels ...logrus.Level)Display registers log levels to display to os.Stderr. Normally, all output is suppressed from the logs. Call Display with a list of levels (or call it multiple times) to print logs for that level.
func (hook *LogCap) Fire(entry *logrus.Entry) errorFire is required to implement the Logrus hook interface
func (hook *LogCap) IgnoreCaller(s string)IgnoreCaller registers filenames (or parts of filenames) that shouldn't be included when tracing the call stack back to find the file and line number to display with log failures. It defaults to []string{"sirupsen/logrus"} to elide all files in the Logrus library. If you have your logging module in a subsidiary file, add it with IgnoreCaller() so the original call site will be displayed.
func (hook *LogCap) Levels() []logrus.LevelLevels is required to implement the Logrus hook interface
func (hook *LogCap) Start()Start starts the hook, attaching it to the given logger.
func (hook *LogCap) Stop()Stop stops the hook and removes ALL hooks from the logger.
type Repeater struct {
M interface{}
N int
}Repeater allows for easy repeating of log matches. If you have something that's going to log 30 times, just use a repeater:
Ω(logHook).Should(HaveLogs(Repeater{MatchRegexp(`Log entry \d+`), 30}))