Categorygithub.com/jsign/go-ethereumloggerglog
package
0.9.39
Repository: https://github.com/jsign/go-ethereum.git
Documentation: pkg.go.dev
Overview
Versions
1
Dependencies
15
Dependents
0
Files
898 SLOC

# README

glog

Leveled execution logs for Go.

This is an efficient pure Go implementation of leveled logs in the manner of the open source C++ package http://code.google.com/p/google-glog

By binding methods to booleans it is possible to use the log package without paying the expense of evaluating the arguments to the log. Through the -vmodule flag, the package also provides fine-grained control over logging at the file level.

The comment from glog.go introduces the ideas:

Package glog implements logging analogous to the Google-internal
C++ INFO/ERROR/V setup.  It provides functions Info, Warning,
Error, Fatal, plus formatting variants such as Infof. It
also provides V-style logging controlled by the -v and
-vmodule=file=2 flags.

Basic examples:

	glog.Info("Prepare to repel boarders")

	glog.Fatalf("Initialization failed: %s", err)

See the documentation for the V function for an explanation
of these examples:

	if glog.V(2) {
		glog.Info("Starting transaction...")
	}

	glog.V(2).Infoln("Processed", nItems, "elements")

The repository contains an open source version of the log package used inside Google. The master copy of the source lives inside Google, not here. The code in this repo is for export only and is not itself under development. Feature requests will be ignored.

Send bug reports to [email protected].

# Functions

CopyStandardLogTo arranges for messages written to the Go "log" package's default logs to also appear in the Google logs for the named and lower severities.
Error logs to the ERROR, WARNING, and INFO logs.
ErrorDepth acts as Error but uses depth to determine which call frame to log.
Errorf logs to the ERROR, WARNING, and INFO logs.
Errorln logs to the ERROR, WARNING, and INFO logs.
Exit logs to the FATAL, ERROR, WARNING, and INFO logs, then calls os.Exit(1).
ExitDepth acts as Exit but uses depth to determine which call frame to log.
Exitf logs to the FATAL, ERROR, WARNING, and INFO logs, then calls os.Exit(1).
Exitln logs to the FATAL, ERROR, WARNING, and INFO logs, then calls os.Exit(1).
Fatal logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
FatalDepth acts as Fatal but uses depth to determine which call frame to log.
Fatalf logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
Fatalln logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
Flush flushes all pending log I/O.
GetTraceLocation returns the global TraceLocation object.
No description provided by the author
Info logs to the INFO log.
InfoDepth acts as Info but uses depth to determine which call frame to log.
Infof logs to the INFO log.
Infoln logs to the INFO log.
No description provided by the author
SetToStderr sets the global output style.
SetV sets the global verbosity level.
V reports whether verbosity at the call site is at least the requested level.
Warning logs to the WARNING and INFO logs.
WarningDepth acts as Warning but uses depth to determine which call frame to log.
Warningf logs to the WARNING and INFO logs.
Warningln logs to the WARNING and INFO logs.

# Variables

MaxSize is the maximum size of a log file in bytes.
Stats tracks the number of lines of output and number of bytes per severity level.

# Structs

OutputStats tracks the number of output lines and bytes written.
traceLocation represents the setting of the -log_backtrace_at flag.

# Type aliases

Level specifies a level of verbosity for V logs.
Verbose is a boolean type that implements Infof (like Printf) etc.