logger

README

logger

Documentation

Index

• func Is(e error, kargs ...string) bool
• type Config
• type Error
  • func (e *Error) Is(kargs ...string) bool
• type Log
  • func (l Log) ToCsv() string
  • func (l Log) ToJSON() string
  • func (l Log) ToString() string
• type Logger
  • func NewLogger(config *Config) *Logger
  • func (l Logger) ErrorF(statusCode int, format string, args ...any) *Error
  • func (l Logger) Fatal(format string, args ...any)
  • func (l Logger) Info(format string, args ...any) *Log
  • func (l Logger) LogF(statusCode int, format string, args ...any) *Log
  • func (l *Logger) RunWithRetries(status int, f func() error) *Error

Functions

func Is

func Is(e error, kargs ...string) bool

Is checks if the given error contains any of the specified substrings. It returns true if any of the substrings are found, otherwise false.

Types

type Config

type Config struct {
	Format  string // json, text, csv
	Level   int    // 100: DEBUG, 200: INFO, 300: NOTICE, 400: WARNING, 500: ERROR, 502: CRITICAL, 509: ALERT
	Output  string // stdout, <filepath>
	Retries int
	Wait    time.Duration
}

Config represents the configuration for the logger.

type Error

type Error struct {
	UUID    string `json:"uuid"`
	Status  int    `json:"-"`
	Message string `json:"message"`
}

Error represents an error with a UUID, status, and message.

func (*Error) Is

func (e *Error) Is(kargs ...string) bool

Is checks if the error's message contains any of the specified substrings. It returns true if any of the substrings are found, otherwise false.

type Log

type Log struct {
	Timestamp string `json:"timestamp"`
	Severity  string `json:"severity"`
	Path      string `json:"path"`
	Line      int    `json:"line"`
	Error
}

Log represents a log entry.

func (Log) ToCsv

func (l Log) ToCsv() string

ToCsv converts the log entry to a CSV format.

func (Log) ToJSON

func (l Log) ToJSON() string

ToJSON converts the log entry to JSON formated string.

func (Log) ToString

func (l Log) ToString() string

ToString converts the log entry to a string format.

type Logger

type Logger struct {
	// contains filtered or unexported fields
}

Logger represents a logger instance.

func NewLogger

func NewLogger(config *Config) *Logger

NewLogger creates a new logger instance with the given configuration.

func (Logger) ErrorF

func (l Logger) ErrorF(statusCode int, format string, args ...any) *Error

ErrorF logs an error message with the given status code and arguments. It returns an error object.

func (Logger) Fatal

func (l Logger) Fatal(format string, args ...any)

Fatal logs an error message and exits the program

func (Logger) Info

func (l Logger) Info(format string, args ...any) *Log

Info logs an info message with the given arguments.

func (Logger) LogF

func (l Logger) LogF(statusCode int, format string, args ...any) *Log

LogF logs a formatted message with the given status code and arguments. It returns the log entry.

func (*Logger) RunWithRetries

func (l *Logger) RunWithRetries(status int, f func() error) *Error

RunWithRetries executes a function and retries if any error.