logging

Documentation

Overview

Copyright 2017 HootSuite Media Inc.

Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Modified hereafter by contributors to runatlantis/atlantis.

Package logging handles logging throughout Atlantis.

Index

• type LogLevel
  • func ToLogLevel(levelStr string) LogLevel
• type SimpleLogger
  • func NewNoopLogger() *SimpleLogger
  • func NewSimpleLogger(source string, logger *log.Logger, keepHistory bool, level LogLevel) *SimpleLogger
  • func (l *SimpleLogger) Debug(format string, a ...interface{})
  • func (l *SimpleLogger) Err(format string, a ...interface{})
  • func (l *SimpleLogger) GetLevel() LogLevel
  • func (l *SimpleLogger) Info(format string, a ...interface{})
  • func (l *SimpleLogger) Log(level LogLevel, format string, a ...interface{})
  • func (l *SimpleLogger) Underlying() *log.Logger
  • func (l *SimpleLogger) Warn(format string, a ...interface{})
• type SimpleLogging

Types

type LogLevel

type LogLevel int

const (
	Debug LogLevel = iota
	Info
	Warn
	Error
)

func ToLogLevel

func ToLogLevel(levelStr string) LogLevel

ToLogLevel converts a log level string to a valid LogLevel object. If the string doesn't match a level, it will return Info.

type SimpleLogger

type SimpleLogger struct {
	// Source is added as a prefix to each log entry.
	// It's useful if you want to trace a log entry back to a
	// context, for example a pull request id.
	Source string
	// History stores all log entries ever written using
	// this logger. This is safe for short-lived loggers
	// like those used during plan/apply commands.
	History     bytes.Buffer
	Logger      *log.Logger
	KeepHistory bool
	Level       LogLevel
}

SimpleLogger wraps the standard logger with leveled logging and the ability to store log history for later adding it to a VCS comment.

func NewNoopLogger

func NewNoopLogger() *SimpleLogger

NewNoopLogger creates a logger instance that discards all logs and never writes them. Used for testing.

func NewSimpleLogger

func NewSimpleLogger(source string, logger *log.Logger, keepHistory bool, level LogLevel) *SimpleLogger

NewSimpleLogger creates a new logger. source is added as a prefix to each log entry. It's useful if you want to trace a log entry back to a specific context, for example a pull request id. logger is the underlying logger. If nil will create a logger from stdlib. keepHistory set to true will store all log entries written using this logger. level will set the level at which logs >= than that level will be written. If keepHistory is set to true, we'll store logs at all levels, regardless of what level is set to.

func (*SimpleLogger) Debug

func (l *SimpleLogger) Debug(format string, a ...interface{})

Debug logs at debug level.

func (*SimpleLogger) Err

func (l *SimpleLogger) Err(format string, a ...interface{})

Err logs at error level.

func (*SimpleLogger) GetLevel

func (l *SimpleLogger) GetLevel() LogLevel

GetLevel returns the current log level of the logger.

func (*SimpleLogger) Info

func (l *SimpleLogger) Info(format string, a ...interface{})

Info logs at info level.

func (*SimpleLogger) Log

func (l *SimpleLogger) Log(level LogLevel, format string, a ...interface{})

Log writes the log at level.

func (*SimpleLogger) Underlying

func (l *SimpleLogger) Underlying() *log.Logger

Underlying returns the underlying logger.

func (*SimpleLogger) Warn

func (l *SimpleLogger) Warn(format string, a ...interface{})

Warn logs at warn level.

type SimpleLogging

type SimpleLogging interface {
	Debug(format string, a ...interface{})
	Info(format string, a ...interface{})
	Warn(format string, a ...interface{})
	Err(format string, a ...interface{})
	Log(level LogLevel, format string, a ...interface{})
	// Underlying returns the underlying logger.
	Underlying() *log.Logger
	// GetLevel returns the current log level.
	GetLevel() LogLevel
}

SimpleLogging is the interface that our SimpleLogger implements. It's really only used for mocking when we need to test what's being logged.