logrusHelper

Logrus Helper

A Helper arround Logrus to wrap with spf13/Viper to load configuration with fangs!

And to simplify Logrus configuration use some behavior of Logrus_mate

Why?

Logrus is wonderful but miss some configuration helper. Logrus_mate v1.0.1 is powerful, but bring some unecessary pattern. This specific library version is a fork of Logrus_mate which whose upgrade in v2.0.0. spf13/Viper is simple, powerful and generic.

Howto use it

import(

	"github.com/sirupsen/logrus"
	"github.com/spf13/viper"
	"github.com/heirko/go-contrib/logrusHelper"
	_ "github.com/heralight/logrus_mate/hooks/file"
)


func initLogger() {

    // ########## Init Viper  
	var viper = viper.New()

	viper.SetConfigName("mate") // name of config file (without extension), here we use some logrus_mate sample
	viper.AddConfigPath("/etc/appname/")   // path to look for the config file in
	viper.AddConfigPath("$HOME/.appname")  // call multiple times to add many search paths
	viper.AddConfigPath(".")               // optionally look for config in the working directory
	err := viper.ReadInConfig() // Find and read the config file
	if err != nil { // Handle errors reading the config file
		panic(fmt.Errorf("Fatal error config file: %s \n", err))
	}
    // ########### End Init Viper

    // Read configuration
	var c = logrusHelper.UnmarshalConfiguration(viper) // Unmarshal configuration from Viper
	logrusHelper.SetConfig(logrus.StandardLogger(), c) // for e.g. apply it to logrus default instance
	
	// ### End Read Configuration
	
	// ### Use logrus as normal
	logrus.WithFields(logrus.Fields{
		"animal": "walrus",
	}).Error("A walrus appears")
}

A sample is accessible in test directory at Heirko go-contrib.