-
Notifications
You must be signed in to change notification settings - Fork 915
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
23def4e
commit 1c82741
Showing
2 changed files
with
36 additions
and
44 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
# glog | ||
|
||
[](https://pkg.go.dev/github.com/golang/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 [_glog_](https://github.com/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 the functions Info, Warning, Error, Fatal, plus formatting variants such as Infof. It also provides V-style loggingcontrolled by the `-v` and `-vmodule=file=2` flags. | ||
|
||
Basic examples: | ||
|
||
```go | ||
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: | ||
|
||
```go | ||
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]. |