Introduction
As I work on various Go projects, I often find myself creating utility functions, extending existing packages, or developing packages to solve specific problems. Moving from one project to another, I usually have to copy or rewrite these solutions. So I created this repository to have all these utilities and packages in one place. Hopefully, you'll find them useful as well.
These packages aim to enhance the functionality of the standard library and other popular packages. They are intended to be used together with other packages rather than replacing them. The APIs are designed based on my experience working with Go, focusing on simplicity and ease of use. I will try to follow best practices in Go, but not always. I also tend to choose a more performance implementation if possible.
ezpkg.io/logz
Package logz provides common interfaces and utilities for working with other log packages, including log/slog and zap. It’s useful for package library to provide a common interface for logging, so that the user can choose the logging package they want to use.
Examples
package mypackage
import "log/slog"
import "os"
import "testing"
import "go.uber.org/zap"
import "ezpkg.io/errorz"
import "ezpkg.io/logz"
type SuperPower struct {
logger logz.Logger
}
func NewSuperPower(logger logz.Logger) (*SuperPower, error) {
sp := &SuperPower{logger: logger}
sp.logger.Debugw("A new SuperPower is created! Better be prepared! 🔥")
return sp, nil
}
func TestSuperPowerUsingSlog(t *testing.T) {
opt := &slog.HandlerOptions{Level: slog.LevelDebug}
handler := slog.NewTextHandler(os.Stderr, opt)
stdLogger := slog.New(handler)
sp, err := NewSuperPower(logz.FromLoggerI(stdLogger))
assertSuperPower(sp, err)
}
func TestSuperPowerUsingZap(t *testing.T) {
zapLogger := errorz.Must(zap.NewDevelopment()).Sugar()
sp, err := NewSuperPower(logz.FromLoggerx(zapLogger))
assertSuperPower(sp, err)
}