Go Logger

A simple logging package for Go applications. Log in disco colors and emojis with no setup or dependencies.

Features

• Multiple logging levels (DEBUG, INFO, WARN, ERROR, FATAL(LogError/LogErrorf))
• Customizable log formatters
• Has aliases matching all stdlib log functions so a simple replace can be done in go.mod
• EMOJIS 🎉

Installation

go get gopkg.hlmpn.dev/pkg/go-logger

Basic logging

package main

import (
    "gopkg.hlmpn.dev/pkg/go-logger"
)

func main() {
// Log a basic log message
log.Log("Hello, world!")

// Log a formatted log message
log.Logf("Hello, %s!", "world")

// Or the aliases
logger.Printf("Hello, %s!", "world")
logger.Print("Hello, world!")
}

Log a warning message

Outputs with a yellow emoji in orange color!

========================================
⚠️ Warning: [your formatted message here]
========================================

Usage:

logger.Warnf("Something went wrong: %s", err)
// or non "f"-formatted warning message
logger.Warn("Something went wrong!")

Log a info message

Outputs with a blue emoji in blue color!

========================================
ℹ️ Info: [your formatted message here]
========================================

Usage:

logger.LogInfof("Something went wrong: %s", err)
// or non "f"-formatted info message
logger.LogInfo("Something went wrong!")

Log a success message

Outputs with a green emoji in green color!

========================================
✅ Success: [your message here]
========================================

Usage:

logger.LogSuccessf("Done with %s!", err)
// or non "f"-formatted success message
logger.LogSuccess("Everything is fine!")

Log nice looking error messages

Outputs with a nice emoji in red color!

========================================
❌ ERROR: [your formatted message here]
========================================

Usage:

// Pre-formatted error message
logger.LogRedf("Error: %s", "Something went wrong")
// or non "f"-formatted error message
logger.LogRed("Error: Something went wrong")

Log and exit using a pre-formatted error message

Output the same as above, but exits the program with a non-zero status code.

Usage:

// Log and exit with a non-zero status code
logger.LogErrorf("Error: %s", "Something went wrong")
// or non "f"-formatted error message
logger.LogError("Something went wrong")

Note tha the above examples would have the same effect as the stdlib:

log.Fatalf("Error: %s", "Something went wrong")

But is nicer looking and more readable.

Documentation

For full documentation and examples, please refer to the GoDoc.

License

This project is licensed under the terms of the included LICENSE file.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.