Repository files navigation

loggy is a minimalist logging library for Go that provides configurable logging with multiple severity levels, formatted messages, caller location tracking, and thread-safe operations. It is designed to be lightweight and highly customizable to suit various logging needs.

• Severity Levels: Supports five levels of logging:
  • Debug
  • Info
  • Warn
  • Error
  • Fatal (triggers a panic)
• Formatted Logging: Use both direct and formatted log methods.
• Customization: Easily configure output time formats, logger names, and severity labels.
• Caller Location: Optionally include caller information (file and line number) in log messages.
• Thread-Safe: Supports concurrent logging by locking the writer if it implements a locker interface.
• Multiple Logger Instances: Create package-specific logger instances or use the provided default logger.

• Go version 1.23 or higher

To start usingloggy, rungo get:

• For a specific version:

  go get github.com/sivaosorg/loggy@v0.0.1

• For the latest version:

  go get -u github.com/sivaosorg/loggy@latest

WithGo's module support,go [build|run|test] automatically fetches the necessary dependencies when you add the import in your code:

import"github.com/sivaosorg/loggy"

Here is a simple example that demonstrates how to useloggy:

package mainimport ("os""github.com/sivaosorg/loggy")funcmain() {// Create a new logger instance.// The logger name must be in the format ": name:".logger:=loggy.New(": my-service:",os.Stdout,loggy.DebugIssuer,loggy.WithUTC(true),loggy.WithTimeFormat("2006-01-02 15:04:05.000000"),loggy.WithSeverityNames([]string{"DEBUG: ","INFO: ","WARN: ","ERROR: ","FATAL: "}),)// Log a debug message.logger.Debug("This is a debug message.")// Log an informational message.logger.Info("Service started successfully.")// Log a warning message with formatted output.logger.Warnf("Cache miss for key: %s","user123")// Log an error message.logger.Error("Failed to connect to database.")// Log a fatal error (this will panic).// logger.Fatal("Critical error, shutting down!")}

Use theNew function to create a custom logger instance:

logger:=loggy.New(": my-service:",os.Stdout,loggy.DebugIssuer,loggy.WithUTC(true),loggy.WithTimeFormat("2006-01-02 15:04:05.000000"),loggy.WithSeverityNames([]string{"DEBUG: ","INFO: ","WARN: ","ERROR: ","FATAL: "}),)

Parameters:

• name: Must be in the format": name:". For example,": my-service:".
• writer: Anio.Writer where log messages will be sent (e.g.,os.Stdout).
• minLevel: The minimum severity level to log. Messages below this level are ignored.
• Options: Additional configuration options provided via option functions (e.g.,WithUTC,WithTimeFormat,WithSeverityNames).

Each logging method supports an optional caller depth argument (of typeCaller) to specify how many stack frames to skip when reporting the caller's file and line number. If no caller is needed, simply omit it.

• Direct Logging:

logger.Debug("This is a debug message.")logger.Info("Service started successfully.")logger.Warn("This is a warning message.")logger.Error("An error occurred.")// logger.Fatal("A fatal error occurred.") // Will panic after logging.

• Formatted Logging:

logger.Debugf("Debug info: %v",someValue)logger.Infof("User %s logged in",username)logger.Warnf("Cache miss for key: %s",cacheKey)logger.Errorf("Error processing request: %s",err)// logger.Fatalf("Fatal error: %s", err) // Will panic after logging.

To include a custom caller depth (e.g., when wrapping log calls in your own functions), provide aCaller value as the first argument:

// Caller depth set to 1.logger.Info(loggy.Caller(1),"Called from a wrapper function")

loggy also provides a package-level default logger. You can use it directly with convenience functions:

package mainimport ("github.com/sivaosorg/loggy")funcmain() {loggy.Debug("Using default logger for debug")loggy.Infof("Hello, %s!","world")// loggy.Fatal("This is a fatal message") // Will panic.}

To safely change the output destination of a logger, use theUpdateWriter method:

ifok:=logger.UpdateWriter(newWriter);!ok {logger.Error("Writer update failed: incompatible locker interface")}

Adjust the minimum severity level at runtime:

logger.SetLevel(loggy.InfoIssuer)

And query the current level with:

currentLevel:=logger.GetLevel()

To contribute to project, follow these steps:

1. Clone the repository:

git clone --depth 1 https://github.com/sivaosorg/loggy.git

2. Navigate to the project directory:

cd loggy

3. Prepare the project environment:

go mod tidy