https://github.com/heartwilltell/log
Simple leveled logging wrapper around standard log package
https://github.com/heartwilltell/log
go golang lib library log logger logging logging-library zero-dependency
Last synced: 26 days ago
JSON representation
Simple leveled logging wrapper around standard log package
- Host: GitHub
- URL: https://github.com/heartwilltell/log
- Owner: heartwilltell
- License: mit
- Created: 2022-05-01T19:29:10.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T14:24:16.000Z (about 3 years ago)
- Last Synced: 2024-07-31T20:52:12.146Z (over 1 year ago)
- Topics: go, golang, lib, library, log, logger, logging, logging-library, zero-dependency
- Language: Go
- Homepage:
- Size: 284 KB
- Stars: 16
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS.md
Awesome Lists containing this project
- awesome-go - log - Simple leveled logging wrapper around standard log package. (Logging / Search and Analytic Databases)
- awesome-go - log - Simple leveled logging wrapper around standard log package. (Logging / Search and Analytic Databases)
- fucking-awesome-go - log - Simple leveled logging wrapper around standard log package. (Logging / Search and Analytic Databases)
- awesome-go-cn - log
- awesome-go-with-stars - log - 12-06 | (Logging / Search and Analytic Databases)
- awesome-go - log - Simple leveled logging wrapper around standard log package. (Logging / Search and Analytic Databases)
- awesome-go - log - Simple leveled logging wrapper around standard log package. (Logging / Search and Analytic Databases)
- awesome-go-plus - log - Simple leveled logging wrapper around standard log package.  (Logging / Search and Analytic Databases)
- awesome-go - log - Simple leveled logging wrapper around standard log package. (Logging / Search and Analytic Databases)
- awesome-go-cn - log
README
# `log` - Simple leveled logging based on standard log package
## Documentation
[](https://goreportcard.com/report/github.com/heartwilltell/log)
[](https://pkg.go.dev/github.com/heartwilltell/log)
[](https://github.com/heartwilltell/log/actions/workflows/pr.yml)
[](https://codecov.io/gh/heartwilltell/log)
## Benefits
- 😻 Leveled logging
- 😚 Simple API
- 🤝 `fmt` friendly
- 👌 Zero dependencies
- 😮💨 No global logger
- 👏 No structured logging bullshit
## Installation
```bash
go get github.com/heartwilltell/log
```
## Leveled logging
The `StdLog` implements a simple interface:
```go
// Logger formats the message according to standard format specifiers from the fmt package
// and writes the message to writer specified by the concrete interface implementation.
type Logger interface {
// Error formats and writes the error level message.
Error(format string, v ...any)
// Warning formats and writes the warning level message.
Warning(format string, v ...any)
// Info formats and writes the information level message.
Info(format string, v ...any)
// Debug formats and writes the debug level message.
Debug(format string, v ...any)
}
```
## Usage
👇 The usage is pretty simple. Just create a logger instance and call any of leveled methods.
```go
logger := log.New()
logger.Info("Listen on port: %d", 8080)
```
###
👇 Sets the logging level to `debug` level.
```go
logger := log.New(log.WithLevel(log.DBG))
```
###
👇 Parses string to level and creates logger with `warning` level.
```go
level, levelErr := log.ParseLevel("warning")
if levelErr != nil {
// handle error here
}
logger := log.New(log.WithLevel(level))
```
###
👇 Creates logger with different `io.Writer`.
```go
var w bytes.Buffer
logger := log.New(log.WithWriter(w))
```
###
👇 Disables the colorful output.
```go
logger := log.New(log.WithNoColor())
```
###
👇 Sets the UTC time format.
```go
logger := log.New(log.WithUTC())
```
###
👇 Enables printing the code line number.
```go
// Short format:
// INF: 2022/07/08 11:22:30 server.go:111: message
logger := log.New(log.WithLineNum(log.ShortFmt))
```
OR
```go
// Long format:
// INF: 2022/07/08 11:22:30 /Users/heartwilltell/Go/app/server.go:111: message
logger := log.New(log.WithLineNum(log.LongFmt))
```
###
👇 Sets the level mark at the end of log prefix.
```go
logger := log.New(log.WithLevelAtPrefixEnd())
```
Will produce this 👇
```
// 2022/07/08 11:22:30 INF: message
```
Instead of this 👇
```
// INF: 2022/07/08 11:22:30: message
```
###
👇 Creates nop logger which implements `log.Logger` interface.
```go
logger := log.NewNopLog()
```
💡 _Useful for tests or places where logger should be disabled by default_
## License
[MIT License](LICENSE).