A fast, lightweight, zero-dependency logging solution for Go applications that prioritizes performance and simplicity.
Compatible with Go version 1.18.x and above

• Lightweight: No external dependencies mean faster builds and smaller binaries.
• Simplicity: Clean API design with a minimal learning curve. You'll set it up in seconds.
• Performance: The library is benchmarked to be very fast. It implements custom JSON and YAML marshaling specifically optimized for logging
  • Up to 1.4x faster JSON marshaling than encoding/json
  • Up to 5x faster YAML marshaling than gopkg.in/yaml.v3
• Color Support: Built-in ANSI color support for terminal output
• Thread-Safe: Concurrent-safe logging with atomic operations
• Time-Optimized: Efficient date/time print built-int logic with minimal allocations
• Reliability: Thoroughly tested with high test coverage
• Maintainability: A small, focused codebase makes it easy to understand and modify at will

/******************** Basic Logging methods usage ********************/
logger := logs.NewLogger()
logger.Warn("my warning test") // stdout: 'WARN: my warning test'
logger.Info("my", "into", "test", 2) // stdout: 'INFO: my info test 2'
logger.Debug("hey", "check this", "debug") // stdout: 'DEBUG: hey check this debug'
logger.Error("here is the error") // stderr: 'ERROR: here is the error'

/******************** Configuration setup example ********************/
logger := logs.NewLogger().
SetLogLvl(ll.WarnLvlName).
EnableColors(true).
AddTime(true).
AddDate(true)

logger.Warn("This is my Warn log", "Test arg") // stdout: WARN[03/11/2024 18:35:43]: This is my Warn log Test arg

logger.SetEncoder(shared.JsonEncoderType)
logger.Debug("This is my Debug log", "Test arg") // stdout: {"level":"DEBUG","date":"03/11/2024","time":"18:35:43","message":"This is my Debug log Test arg"}

logger.AddTime(false)
logger.Debug("This is my Debug log", "Test arg") // stdout: {"level":"DEBUG","date":"03/11/2024","message":"This is my Debug log Test second arg"}

/******************** Logging to a file example ********************/
file, err := os.OpenFile("./my-out-file.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
    println("ERROR: cannot open out file", err)
}

// From this point on loggers logs will be redirected to the file
logger := logs.NewLogger().SetLogFile(file)

logger.Debug("This is my Debug log", "Test arg")
// Close the file
logger.CloseLogFile()

This is the result of running the ./test/benchmark_test.go benchmark on my machine, (ns/op)times do not include the terminal graphical visualization time.

Contributions are welcome, Here's how you can help:

1. Fork the repository
2. Clone your fork:
3. Create a new branch:

   git checkout -b feat/your-feature-name

• Code Style

  • Follow standard Go formatting (go fmt)
  • Use meaningful variable names
  • Add comments for non-obvious code sections
  • Write tests for new functionality

• Testing

  • Run tests: make test
  • Run benchmarks: make test-benchmark
  • Ensure test coverage remains high, it can be checked using make test-coverage

MIT License—see LICENSE file for details