Did you know ... | Search Documentation: |
Packs (add-ons) for SWI-Prolog |
Title: | Logging for Prolog |
---|---|
Rating: | Not rated. Create the first rating! |
Latest version: | 0.0.9 |
SHA1 sum: | 62624b63d46057e76ae85616612801ad707f8b52 |
Author: | Phil Hargett <phil@haphazardhouse.net> |
Maintainer: | Phil Hargett <phil@haphazardhouse.net> |
Packager: | Phil Hargett <phil@haphazardhouse.net> |
Home page: | https://github.com/hargettp/log4p |
Download URL: | https://github.com/hargettp/log4p/releases/*.zip |
Provides: | logger |
No reviews. Create the first review!.
Version | SHA1 | #Downloads | URL |
---|---|---|---|
0.0.2 | a24d40f2cf68bbaeab7221a6ce8c8dd92a46531c | 137 | https://github.com/hargettp/log4p/archive/v0.0.2.zip |
0.0.4 | 83cc5a08f3d0de14feb73977644eaef83c1bda19 | 4 | https://github.com/hargettp/log4p/archive/v0.0.4.zip |
0.0.5 | 9553076da778b8b0fec99bcda59f00523655086c | 10 | https://github.com/hargettp/log4p/archive/v0.0.5.zip |
0.0.7 | 909dcee11eb86e1aaa3ccd09effddfbbb932e025 | 3 | https://github.com/hargettp/log4p/archive/v0.0.7.zip |
0.0.9 | 62624b63d46057e76ae85616612801ad707f8b52 | 119 | https://github.com/hargettp/log4p/archive/refs/tags/v0.0.9.zip |
A simple logging library for Prolog, inspired by log4j.
This is a package for SWI-Prolog, installable using the built-in package manager with the package name log4p
.
?- pack_install(log4p).
The basic model for logging involves a few simple concepts.
trace
, debug
, info
, warn
, error
, fatal
. If the current log level is set to info
, for example, then message of debug
or to further left in that list will not be given to a handler.
Generating messages is usually a matter of using a number of predicates named for each level: info/1, info/2, warn/1, warn/2 etc. The `/1` variant logs a constant string (or term rendered as a string). The `/2` variant takes a format string and an array of arguments, then calls swritef
to generate a constant string which is then passed onto log handlers. If the currently effective log level for the calling thread is not equal to or "higher" (e.g., more to the right in the above list of log levels), then the message will be filtered out and not delivered to any handlers.
The effective log level is a layered per-thread choice, depending on which settings are specified:
default_log_level
: the log4p
library defines info
as the log level to assume if no other setting has been specified for the current thread.global_log_level
: any configured global level overrides the default for all threads, new or existing. A global setting remains in place until its cleared with clear_global_log_level
.local_log_level
: if a level has been specified for the current thread, then this value will override any global setting, even if the global value is later changed. Using clear_local_log_level
will remove any local setting, thus resetting the thread's level to either the global or default level.
The current level can be set using the any of the following techniques:
Log handlers disseminate messages to an output desintation, such as stdout
or stderr
or a log file. To add or remove log handlers, use add_log_handler/1 and remove_log_handler/1 respectively. A log handler is a simple function that simply takes 2 arguments: the level
of the message, and the message
etc. (after formatting).
Pack contains 7 files holding a total of 10.8K bytes.