@oazmi/build-tools/esm/logger.js

general deno build tool scripts which I practically use in all of my typescript repos

/** a module for simplifying logging with a global state.
 * intended mostly for internal use.
 *
 * @module
*/
import { console_log } from "./deps.js";
export { console_log, console_warn } from "./deps.js";
// there are three logging level:
// "none": `log_is_basic` and `log_is_verbose` are both `false` => no logging occurs
// "basic": `log_is_basic` is `true` but `log_is_verbose` is `false` => basic logging occurs
// "verbose": `log_is_basic` and `log_is_verbose` are both `true` => basic logging + verbose logging occurs
let log_level = "basic", log_is_basic = true, log_is_verbose = false;
/** set the logging to a certain level.
 * the value passed to this function affects the logging behavior of the {@link logBasic} and {@link logVerbose} functions.
 *
 * possible options:
 * - `{ log: undefined }`: logging level is unchanged. by default, it starts with `"basic"`.
 * - `{ log: "none" }`: no logging occurs (neither {@link logBasic} nor {@link logVerbose} print anything).
 * - `{ log: "basic" }`: basic logging occurs ({@link logBasic} prints, but {@link logVerbose} does not print).
 * - `{ log: "verbose" }`: basic logging + verbose logging occurs (both {@link logBasic} and {@link logVerbose} print).
*/
export const setLog = (config) => {
    const { log } = config;
    if (log || log === false) {
        log_level = typeof log === "string"
            ? log
            : log ? "basic" : "none";
        log_is_verbose = log_level === "verbose";
        log_is_basic = log_is_verbose || log_level === "basic";
    }
};
/** print some basic useful information on the console.
 * the print will only appear if the logging-level is either set to `"basic"` or `"verbose"` via {@link setLog}
*/
export const logBasic = (...data) => {
    if (log_is_basic) {
        console_log(...data);
    }
};
/** print verbose details on the console.
 * the print will only appear if the logging-level is either set to `"verbose"` via {@link setLog}
*/
export const logVerbose = (...data) => {
    if (log_is_verbose) {
        console_log(...data);
    }
};