Why log4lib

Log4lib allow libraries to send their log to the user-application logger.

Most of the time library should not log and instead return errors. But there is some time where sending a WARN and keep going is usefull. Log4lib is meant to do this. It provides a set of wrapper for the most commonly used log library.

How to use

As a library developer

Library developer should only install github.com/anthonyraymond/go-log4lib

go get github.com/anthonyraymond/go-log4lib

project/log.go

package thelibrary

import (
    "github.com/anthonyraymond/go-log4lib"
    "github.com/anthonyraymond/log4libwrapper"
)

// Default logger logs to console by default, but user can replace the logger using the SetLibraryLogger()
var logger = log4libwrapper.Default()

// Make use of github.com/anthonyraymond/go-log4lib to allow third party application to pass their logger wrapped in a github.com/anthonyraymond/go-log4libwrapper-xxx
func SetLibraryLogger(l log4lib.LibLogger) {
	logger = l
}

func GetLibLogger() log4lib.LibLogger {
	return logger
}

project/mylibraryfile.go

package thelibrary

func doSomething() {
    GetLibLogger().Info("hello :) that's a log")
}

As a library user

Library users should only install wrapper and must not install github.com/anthonyraymond/go-log4lib

go get github.com/anthonyraymond/go-log4libwrapper-zap
or
go get github.com/anthonyraymond/go-log4libwrapper-logrus
or
go get github.com/anthonyraymond/go-log4libwrapper-golog

Zap:

package myapp

import (
    "github.com/anthonyraymond/go-log4libwrapper-zap"
    "go.uber.org/zap"
    "thelibrary"
)

func init() {
    var logger *zap.Logger = zap.NewProduction()
    thelibrary.SetLibraryLogger(log4libwrapper.WrapZapLogger(logger))
}

logrus:

package myapp

import (
    "github.com/anthonyraymond/go-log4libwrapper-logrus"
    "github.com/sirupsen/logrus"
    "thelibrary"
)

func init() {
    var logger *logrus.Logger = logrus.New()
    thelibrary.SetLibraryLogger(log4libwrapper.WrapLogrusLogger(logger))
}

golog:

package myapp

import (
    "github.com/anthonyraymond/go-log4libwrapper-logrus"
    "github.com/kataras/golog"
    "thelibrary"
)

func init() {
    var logger *golog.Logger = golog.New()
    thelibrary.SetLibraryLogger(log4libwrapper.WrapGologLogger(logger))
}