jyapayne/Nim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Merge pull request #4131 from niv/pr-logging-syslogish

Browse source 
pure/logging: add notice level, suggest usecases
This commit is contained in:
Andreas Rumpf 2016-05-09 16:32:34 +02:00
commit d2cfd71627
1 changed files with 27 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

28
lib/pure/logging.nim
View file

@ -54,6 +54,7 @@ type
lvlAll, ## all levels active lvlAll, ## all levels active
lvlDebug, ## debug level (and any above) active lvlDebug, ## debug level (and any above) active
lvlInfo, ## info level (and any above) active lvlInfo, ## info level (and any above) active
lvlNotice, ## info notice (and any above) active
lvlWarn, ## warn level (and any above) active lvlWarn, ## warn level (and any above) active
lvlError, ## error level (and any above) active lvlError, ## error level (and any above) active
lvlFatal, ## fatal level (and any above) active lvlFatal, ## fatal level (and any above) active
@ -61,7 +62,7 @@ type
const const
LevelNames*: array [Level, string] = [ LevelNames*: array [Level, string] = [
"DEBUG", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "NONE" "DEBUG", "DEBUG", "INFO", "NOTICE", "WARN", "ERROR", "FATAL", "NONE"
] ]
defaultFmtStr* = "$levelname " ## default format string defaultFmtStr* = "$levelname " ## default format string
@ -258,22 +259,47 @@ template log*(level: Level, args: varargs[string, `$`]) =
template debug*(args: varargs[string, `$`]) = template debug*(args: varargs[string, `$`]) =
## Logs a debug message to all registered handlers. ## Logs a debug message to all registered handlers.
##
## Messages that are useful to the application developer only and are usually
## turned off in release.
log(lvlDebug, args) log(lvlDebug, args)
template info*(args: varargs[string, `$`]) = template info*(args: varargs[string, `$`]) =
## Logs an info message to all registered handlers. ## Logs an info message to all registered handlers.
##
## Messages that are generated during the normal operation of an application
## and are of no particular importance. Useful to aggregate for potential
## later analysis.
log(lvlInfo, args) log(lvlInfo, args)
template notice*(args: varargs[string, `$`]) =
## Logs an notice message to all registered handlers.
##
## Semantically very similar to `info`, but meant to be messages you want to
## be actively notified about (depending on your application).
## These could be, for example, grouped by hour and mailed out.
log(lvlNotice, args)
template warn*(args: varargs[string, `$`]) = template warn*(args: varargs[string, `$`]) =
## Logs a warning message to all registered handlers. ## Logs a warning message to all registered handlers.
##
## A non-error message that may indicate a potential problem rising or
## impacted performance.
log(lvlWarn, args) log(lvlWarn, args)
template error*(args: varargs[string, `$`]) = template error*(args: varargs[string, `$`]) =
## Logs an error message to all registered handlers. ## Logs an error message to all registered handlers.
##
## A application-level error condition. For example, some user input generated
## an exception. The application will continue to run, but functionality or
## data was impacted, possibly visible to users.
log(lvlError, args) log(lvlError, args)
template fatal*(args: varargs[string, `$`]) = template fatal*(args: varargs[string, `$`]) =
## Logs a fatal error message to all registered handlers. ## Logs a fatal error message to all registered handlers.
##
## A application-level fatal condition. FATAL usually means that the application
## cannot go on and will exit (but this logging event will not do that for you).
log(lvlFatal, args) log(lvlFatal, args)
proc addHandler*(handler: Logger) = proc addHandler*(handler: Logger) =