1
0
Fork 0
Singleton for simple logging
Go to file
Alexander Zhirov 075ccdcdcc Merge pull request 'v0.5.0' (#5) from dev into master
Reviewed-on: dlang/singlog#5
2023-07-21 14:19:45 +00:00
source v0.5.0 2023-07-21 17:15:21 +03:00
tests v0.5.0 2023-07-21 17:15:21 +03:00
.gitignore first test 2023-04-27 21:08:12 +03:00
CHANGELOG.md v0.5.0 2023-07-21 17:15:21 +03:00
LICENSE v0.1.0 2023-03-23 12:20:46 +03:00
README.md v0.5.0 2023-07-21 17:15:21 +03:00
dub.json fix name program in Windows 2023-06-07 10:02:47 +03:00
dub.selections.json v0.1.0 2023-03-23 12:20:46 +03:00
dub.settings.json v0.1.0 2023-03-23 12:20:46 +03:00
logo.png v0.5.0 2023-07-21 17:15:21 +03:00
singlog.png release v0.3.0 2023-04-28 11:32:15 +03:00

README.md

singlog

license main githab dub linux windows

Singleton for simple logging

Basic Usage

import singlog;

void main(string[] argv) {
    log.output(log.output.syslog.stderr.stdout.file)    // write to syslog, standard error/output streams and file
        .program(argv[0])                               // program name as an identifier (for Windows OS)
        .level(log.level.debugging)                     // logging level
        .color(true)                                    // color text output
        .file("./test.log");                            // the path to the log file

    log.i("This is an information message");
    log.n("This is a notice message");
    log.w("This is a warning message");
    log.e("This is an error message");
    log.c("This is a critical message");
    log.a("This is an alert message");
    log.d("This is a debug message");

    log.now(log.output.stdout).n("This error message will only be written to the standard output stream");
    log.now(log.output.syslog.file).c("This error message will only be written to the syslog and file");
}

output

output

Examples

Setting the name of the logged program (it matters for Windows OS):

log.program("My program");

Setting the status of color text output (false by default):

log.color(true);

Setting the error output level:

log.level(log.level.debugging);
log.level(log.level.alert);
log.level(log.level.critical);
log.level(log.level.error);
log.level(log.level.warning);
log.level(log.level.notice);
log.level(log.level.information);

Assigning a target output:

log.output(log.output.syslog.stderr.stdout);

Setup and allowing writing to a file:

log.output(log.output.file);
log.file("./file.log");

Write messages to the log:

log.a("Alert message")          =>    log.alert("Alert message");
log.c("Critical message")       =>    log.critical("Critical message");
log.e("Error message")          =>    log.error("Error message");
log.w("Warning message")        =>    log.warning("Warning message");
log.n("Notice message")         =>    log.notice("Notice message");
log.i("Information message")    =>    log.information("Information message");
log.d("Debugging message")      =>    log.debugging("Debugging message");

Write message to specific outputs:

log.now(log.output.stdout).n("This error message will only be written to the standard output stream");
log.now(log.output.syslog.file).c("This error message will only be written to the syslog and file");

DUB

Add a dependency on "singlog": "~>0.5.0".