standard-log 9.1.0 → 9.1.3

package/esm/standardLog.js

@@ -1,10 +1,13 @@
-import { required } from 'type-plus';
+import { record, required } from 'type-plus';
 import { createLogger } from './logger.js';
 import { logLevels } from './logLevels.js';
 import { createLogStore } from './logStore.js';
 import { createMemoryLogReporter } from './memory.js';
 export function createStandardLog(options) {
-    return createStandardLogClosure(options).standardLog;
+    const closure = createStandardLogClosure(options);
+    if (!ctx.gsl)
+        ctx.gsl = closure;
+    return closure.standardLog;
 }
 export function createStandardLogClosure(options) {
     const store = createLogStore(required({ logLevel: logLevels.info }, options));
@@ -18,10 +21,10 @@ export function createStandardLogClosure(options) {
             toLogLevel(name) {
                 return store.logLevelStore.getLevel(name);
             },
-            getLogger([id, options], meta) {
+            getLogger(id, options) {
                 if (store.loggers[id])
                     return store.loggers[id];
-                return store.loggers[id] = createLogger([store, id, options], { ssf: this.getLogger, ...meta });
+                return store.loggers[id] = createLogger(store, id, { ssf: this.getLogger, ...options });
             }
         }
     };
@@ -38,4 +41,34 @@ export function suppressLogs(block, ...logs) {
     logs.forEach((l, i) => l.level = origLevels[i]);
     return result;
 }
+export function getLogger(id, options) {
+    return getGlobalSL().getLogger(id, options);
+}
+export const ctx = record();
+function getGlobalSL() {
+    if (!ctx.gsl)
+        ctx.gsl = createStandardLogClosure();
+    return ctx.gsl.standardLog;
+}
+export function configGlobal(options) {
+    if (ctx.configured) {
+        const log = ctx.gsl?.standardLog.getLogger('standard-log');
+        log?.warn('configGlobal() is being called more than once. Please make sure this is expected. Application should use `createStandardLog()` most of the time.');
+    }
+    if (ctx.gsl) {
+        if (options.logLevel) {
+            ctx.gsl.store.logLevel = options.logLevel;
+        }
+        if (options.reporters) {
+            const reporters = ctx.gsl.store.reporters;
+            while (reporters.length > 0)
+                reporters.pop();
+            reporters.push(...options.reporters);
+        }
+    }
+    else {
+        ctx.gsl = createStandardLogClosure(options);
+    }
+    ctx.configured = true;
+}
 //# sourceMappingURL=standardLog.js.map

package/esm/standardLog.js.map

@@ -1 +1 @@
-{"version":3,"file":"standardLog.js","sourceRoot":"","sources":["../ts/standardLog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAY,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAarD,MAAM,UAAU,iBAAiB,CAC/B,OAA+B;IAE/B,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAC,WAAW,CAAA;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA+B;IAE/B,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IAE7E,OAAO;QACL,KAAK;QACL,WAAW,EAAE;YACX,IAAI,QAAQ,KAAK,OAAO,KAAK,CAAC,QAAQ,CAAA,CAAC,CAAC;YAExC,cAAc,CAAC,KAAa;gBAC1B,OAAO,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAC3C,CAAC;YACD,UAAU,CAAC,IAAY;gBACrB,OAAO,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YAC3C,CAAC;YACD,SAAS,CAAC,CAAC,EAAE,EAAE,OAAO,CAAwC,EAAE,IAAqB;gBACnF,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBAAE,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAQ,CAAA;gBACtD,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,EAAE,CAAQ,CAAA;YACxG,CAAC;SACF;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,WAAqB,SAAS,CAAC,KAAK;IAC3E,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAA;IAC1C,MAAM,WAAW,GAAG,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC1E,OAAO,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,CAAA;AACrC,CAAC;AAMD,MAAM,UAAU,YAAY,CAAI,KAAc,EAAE,GAAG,IAAc;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3C,MAAM,MAAM,GAAG,KAAK,EAAE,CAAA;IACtB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/C,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import { StackTraceMeta } from '@just-func/types'\nimport { required } from 'type-plus'\nimport { createLogger } from './logger.js'\nimport { logLevels } from './logLevels.js'\nimport { createLogStore, LogStore } from './logStore.js'\nimport { createMemoryLogReporter } from './memory.js'\nimport type { Logger, LoggerOptions, LogLevel, LogMethodNames, StandardLogOptions } from './types.js'\n\nexport interface StandardLogInstance<N extends string = LogMethodNames> {\n  logLevel: number,\n  toLogLevelName(level: number): string,\n  toLogLevel(name: N): number,\n  getLogger(params: [id: string, options?: LoggerOptions], meta?: StackTraceMeta): Logger<N | LogMethodNames>\n}\n\nexport interface StandardLog<N extends string = LogMethodNames> extends Readonly<StandardLogInstance<N>> {\n}\n\nexport function createStandardLog<N extends string = LogMethodNames>(\n  options?: StandardLogOptions<N>\n): StandardLog<N> {\n  return createStandardLogClosure(options).standardLog\n}\n\nexport function createStandardLogClosure<N extends string = LogMethodNames>(\n  options?: StandardLogOptions<N>\n): { store: LogStore, standardLog: StandardLog<N> } {\n  const store = createLogStore(required({ logLevel: logLevels.info }, options))\n\n  return {\n    store,\n    standardLog: {\n      get logLevel() { return store.logLevel },\n\n      toLogLevelName(level: number) {\n        return store.logLevelStore.getName(level)\n      },\n      toLogLevel(name: string) {\n        return store.logLevelStore.getLevel(name)\n      },\n      getLogger([id, options]: [id: string, options?: LoggerOptions], meta?: StackTraceMeta) {\n        if (store.loggers[id]) return store.loggers[id] as any\n        return store.loggers[id] = createLogger([store, id, options], { ssf: this.getLogger, ...meta }) as any\n      }\n    }\n  }\n}\n\nexport function createStandardLogForTest(logLevel: LogLevel = logLevels.debug) {\n  const reporter = createMemoryLogReporter()\n  const standardLog = createStandardLog({ reporters: [reporter], logLevel })\n  return { ...standardLog, reporter }\n}\n\n/**\n * Suppress logging within the code block.\n */\nexport function suppressLogs<R>(block: () => R, log: Logger, ...logs: Logger[]): R\nexport function suppressLogs<R>(block: () => R, ...logs: Logger[]): R {\n  const origLevels = logs.map(l => l.level)\n  logs.forEach(l => l.level = logLevels.none)\n  const result = block()\n  logs.forEach((l, i) => l.level = origLevels[i])\n  return result\n}\n"]}
+{"version":3,"file":"standardLog.js","sourceRoot":"","sources":["../ts/standardLog.ts"],"names":[],"mappings":"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","sourcesContent":["import { record, required } from 'type-plus'\nimport { createLogger } from './logger.js'\nimport { logLevels } from './logLevels.js'\nimport { createLogStore, LogStore } from './logStore.js'\nimport { createMemoryLogReporter } from './memory.js'\nimport type { Logger, LoggerOptions, LogLevel, LogMethodNames, StandardLogOptions } from './types.js'\n\nexport interface StandardLogInstance<N extends string = LogMethodNames> {\n  logLevel: number,\n  toLogLevelName(level: number): string,\n  toLogLevel(name: N): number,\n  getLogger(id: string, options?: LoggerOptions): Logger<N | LogMethodNames>\n}\n\nexport interface StandardLog<N extends string = LogMethodNames> extends Readonly<StandardLogInstance<N>> {\n}\n\nexport function createStandardLog<N extends string = LogMethodNames>(\n  options?: StandardLogOptions<N>\n): StandardLog<N> {\n  const closure = createStandardLogClosure(options)\n  if (!ctx.gsl) ctx.gsl = closure as any\n  return closure.standardLog\n}\n\nexport function createStandardLogClosure<N extends string = LogMethodNames>(\n  options?: StandardLogOptions<N>\n): { store: LogStore, standardLog: StandardLog<N> } {\n  const store = createLogStore(required({ logLevel: logLevels.info }, options))\n\n  return {\n    store,\n    standardLog: {\n      get logLevel() { return store.logLevel },\n\n      toLogLevelName(level: number) {\n        return store.logLevelStore.getName(level)\n      },\n      toLogLevel(name: string) {\n        return store.logLevelStore.getLevel(name)\n      },\n      getLogger(id: string, options?: LoggerOptions) {\n        if (store.loggers[id]) return store.loggers[id] as any\n        return store.loggers[id] = createLogger(store, id, { ssf: this.getLogger, ...options }) as any\n      }\n    }\n  }\n}\n\nexport function createStandardLogForTest(logLevel: LogLevel = logLevels.debug) {\n  const reporter = createMemoryLogReporter()\n  const standardLog = createStandardLog({ reporters: [reporter], logLevel })\n  return { ...standardLog, reporter }\n}\n\n/**\n * Suppress logging within the code block.\n */\nexport function suppressLogs<R>(block: () => R, log: Logger, ...logs: Logger[]): R\nexport function suppressLogs<R>(block: () => R, ...logs: Logger[]): R {\n  const origLevels = logs.map(l => l.level)\n  logs.forEach(l => l.level = logLevels.none)\n  const result = block()\n  logs.forEach((l, i) => l.level = origLevels[i])\n  return result\n}\n\nexport function getLogger<N extends string = LogMethodNames>(id: string, options?: LoggerOptions) {\n  return getGlobalSL<N>().getLogger(id, options)\n}\n\nexport const ctx: {\n  configured?: boolean,\n  gsl?: { store: LogStore, standardLog: StandardLogInstance<LogMethodNames> }\n} = record()\n\nfunction getGlobalSL<N extends string = LogMethodNames>(): StandardLogInstance<N> {\n  if (!ctx.gsl) ctx.gsl = createStandardLogClosure()\n\n  return ctx.gsl!.standardLog as StandardLogInstance<N>\n}\n\nexport function configGlobal(options: Omit<StandardLogOptions, 'customLevels'>) {\n  if (ctx.configured) {\n    const log = ctx.gsl?.standardLog.getLogger('standard-log')\n    log?.warn('configGlobal() is being called more than once. Please make sure this is expected. Application should use `createStandardLog()` most of the time.')\n  }\n\n  if (ctx.gsl) {\n    if (options.logLevel) {\n      ctx.gsl.store.logLevel = options.logLevel\n    }\n    if (options.reporters) {\n      const reporters = ctx.gsl.store.reporters\n      while (reporters.length > 0) reporters.pop()\n      reporters.push(...options.reporters)\n    }\n  }\n  else {\n    ctx.gsl = createStandardLogClosure(options)\n  }\n  ctx.configured = true\n}\n"]}

package/esm/standardLog.spec.js

@@ -1,8 +1,9 @@
 import { assertron as a } from 'assertron';
 import { InvalidId } from './errors.js';
+import { createStandardLog, createStandardLogForTest, getLogger, suppressLogs } from './index.js';
 import { logLevels, toLogLevelName } from './logLevels.js';
 import { createMemoryLogReporter } from './memory.js';
-import { createStandardLog, createStandardLogForTest, suppressLogs } from './standardLog.js';
+import { configGlobal, ctx } from './standardLog.js';
 import { assertSSF, wrapTest } from './testUtil.js';
 describe('createStandardLog()', () => {
     describe('logLevel', () => {
@@ -29,11 +30,21 @@ describe('createStandardLog()', () => {
         it('can specify reporter', () => {
             const mem = createMemoryLogReporter();
             const sl = createStandardLog({ reporters: [mem] });
-            const log = sl.getLogger(['x']);
+            const log = sl.getLogger('x');
             log.info('abc');
             expect(mem.logs.length).toBe(1);
         });
     });
+    describe('related to global', () => {
+        beforeEach(() => {
+            ctx.gsl = undefined;
+            ctx.configured = false;
+        });
+        it('will affect getLogger() if configGlobal() is not called', () => {
+            createStandardLog({ logLevel: logLevels.planck });
+            expect(ctx.gsl?.standardLog.logLevel).toBe(logLevels.planck);
+        });
+    });
 });
 describe('createStandardLogForTest()', () => {
     it('returns with memory reporter', () => {
@@ -45,103 +56,103 @@ describe('createStandardLogForTest()', () => {
         expect(store.logLevel).toBe(logLevels.debug);
     });
 });
-describe('getLogger()', () => {
+describe('standardLog.getLogger()', () => {
     it('supports id with alphanumeric and :_-.', () => {
         const sl = createStandardLog();
-        sl.getLogger(['abcdefghijklmnopqrstuvwxyz:-_.1234567890']);
+        sl.getLogger('abcdefghijklmnopqrstuvwxyz:-_.1234567890');
     });
     it('supports id with unicode', () => {
         const sl = createStandardLog();
-        sl.getLogger(['ミク香港']);
+        sl.getLogger('ミク香港');
     });
     it('supports id with @, \\ and /', () => {
         const sl = createStandardLog();
-        sl.getLogger(['@unional/fixture']);
-        sl.getLogger([`a\\b\\c`]);
+        sl.getLogger('@unional/fixture');
+        sl.getLogger(`a\\b\\c`);
     });
     it.each('`~!#$%^&*()=+|[]{}<>,?'.split(''))('throws if id has unsupported character %s', (char) => {
         const sl = createStandardLog();
-        a.throws(() => sl.getLogger([char]), InvalidId);
+        a.throws(() => sl.getLogger(char), InvalidId);
     });
     it('throw InvalidId with ssf to the call site', () => {
         const sl = createStandardLog();
-        const err = a.throws(() => sl.getLogger(['!']), InvalidId);
+        const err = a.throws(() => sl.getLogger('!'), InvalidId);
         assertSSF(err, __filename);
     });
     test('id is readonly', () => {
         const sl = createStandardLog();
-        const log = sl.getLogger(['id is readonly']);
+        const log = sl.getLogger('id is readonly');
         a.throws(() => log.id = 'b');
     });
     test('get logger with same name gets the same instance', () => {
         const sl = createStandardLog();
-        const expected = sl.getLogger(['same-inst']);
-        const actual = sl.getLogger(['same-inst']);
+        const expected = sl.getLogger('same-inst');
+        const actual = sl.getLogger('same-inst');
         expect(actual).toBe(expected);
     });
     it('can specify local log level', () => {
         const sl = createStandardLog();
-        const log = sl.getLogger(['local', { level: logLevels.trace }]);
+        const log = sl.getLogger('local', { level: logLevels.trace });
         expect(log.level).toBe(logLevels.trace);
     });
     test('new logger will get custom level', () => {
         const sl = createStandardLog({ customLevels: { 'to_logger': 1234 } });
-        const actual = sl.getLogger(['to_logger_logger']);
+        const actual = sl.getLogger('to_logger_logger');
         expect(typeof actual.to_logger).toBe('function');
     });
     it('Logger have at least the default log method names', () => {
         function wrapper(options) {
             const sl = createStandardLog(options);
             // since `N` is generic, just `Logger<N>` will not have the default log method names.
-            const log = sl.getLogger(['local']);
+            const log = sl.getLogger('local');
             expect(log.info).toBeDefined();
             return sl;
         }
         const sl = wrapper({ customLevels: { 'cust': 123 } });
-        const actual = sl.getLogger(['c']);
+        const actual = sl.getLogger('c');
         expect(actual.cust).toBeDefined();
     });
     describe('log levels', () => {
         async function assertLoggedAtLevel(sl, method, level) {
-            const log = sl.getLogger([method]);
+            const log = sl.getLogger(method);
             const msg = `should log on level: ${level}`;
             log[method](msg);
             a.satisfies(sl.reporter.logs, [{ id: method, level: sl.toLogLevel(method), args: [msg] }]);
         }
         async function assertNotLoggedAtLevel(sl, method, level) {
-            const log = sl.getLogger([method]);
+            const log = sl.getLogger(method);
             log[method](`should not log on level: ${level}`);
             expect(sl.reporter.logs.length).toBe(0);
         }
         async function assertLoggedAtLocalLevel(sl, method, localLevel) {
-            const log = sl.getLogger([method, { level: localLevel }]);
+            const log = sl.getLogger(method, { level: localLevel });
             const msg = `should log on level: ${localLevel}`;
             log[method](msg);
             a.satisfies(sl.reporter.logs, [{ id: log.id, level: sl.toLogLevel(method), args: [msg] }]);
         }
         async function assertNotLoggedAtLocalLevel(sl, method, localLevel) {
-            const log = sl.getLogger([method, { level: localLevel }]);
+            const log = sl.getLogger(method, { level: localLevel });
             log[method](`should not log on level: ${localLevel}`);
             expect(sl.reporter.logs.length).toBe(0);
         }
         async function assertLoggedAtCallLevel(sl, method, callLevel) {
-            const log = sl.getLogger([method]);
+            const log = sl.getLogger(method);
             let actual = false;
             log.on(callLevel, () => actual = true);
             expect(actual).toBe(true);
         }
         async function assertNotLoggedAtCallLevel(sl, method, callLevel, actualLevel) {
-            const log = sl.getLogger([method]);
+            const log = sl.getLogger(method);
             log.on(callLevel, () => { throw new Error(`should not log at level ${actualLevel}`); });
         }
         async function assertLoggedAtCallLevelOverrideLocalLevel(sl, method, localLevel, callLevel) {
-            const log = sl.getLogger([method, { level: localLevel }]);
+            const log = sl.getLogger(method, { level: localLevel });
             let actual = false;
             log.on(callLevel, () => actual = true);
             expect(actual).toBe(true);
         }
         async function assertNotLoggedAtCallLevelOverrideLocalLevel(sl, method, localLevel, callLevel) {
-            const log = sl.getLogger([method, { level: localLevel }]);
+            const log = sl.getLogger(method, { level: localLevel });
             log.on(callLevel, () => { throw new Error(`should not log at level ${localLevel}`); });
         }
         const shouldLog = wrapTest((test) => (method, level) => {
@@ -299,20 +310,20 @@ describe('getLogger()', () => {
     });
     it('writes entry directly', () => {
         const sl = createStandardLogForTest();
-        const log = sl.getLogger(['write-entry']);
+        const log = sl.getLogger('write-entry');
         const entry = { id: 'write-entry', level: logLevels.info, args: ['abc'], timestamp: new Date() };
         log.write(entry);
         a.satisfies(sl.reporter.logs, [entry]);
     });
     test.each(['on', 'count', 'error', 'warn', 'info', 'debug'])('method %s is readonly', name => {
         const sl = createStandardLog();
-        const log = sl.getLogger([`${name} is readonly`]);
+        const log = sl.getLogger(`${name} is readonly`);
         a.throws(() => log[name] = true);
     });
     describe('on()', () => {
         it('log using log argument', () => {
             const sl = createStandardLogForTest();
-            const logger = sl.getLogger(['log on fn']);
+            const logger = sl.getLogger('log on fn');
             logger.on('error', log => { log('value'); });
             a.satisfies(sl.reporter.logs, [
                 { id: 'log on fn', level: logLevels.error, args: ['value'] }
@@ -320,14 +331,14 @@ describe('getLogger()', () => {
         });
         it('can take log level name in first argument', () => {
             const sl = createStandardLogForTest();
-            const log = sl.getLogger(['string-on']);
+            const log = sl.getLogger('string-on');
             log.on('debug', () => { return; });
         });
     });
     describe('count()', () => {
         test('will increment the counter', async () => {
             const sl = createStandardLogForTest();
-            const logger = sl.getLogger(['inc counter']);
+            const logger = sl.getLogger('inc counter');
             logger.count();
             logger.count();
             a.satisfies(sl.reporter.logs, [
@@ -338,7 +349,7 @@ describe('getLogger()', () => {
         test('append args after the counter', async () => {
             const sl = createStandardLogForTest(logLevels.debug);
             const id = 'inc with args';
-            const logger = sl.getLogger([id]);
+            const logger = sl.getLogger(id);
             logger.count('msg1', 'msg2');
             a.satisfies(sl.reporter.logs, [
                 { id, level: logLevels.debug, args: [1, 'msg1', 'msg2'] }
@@ -347,7 +358,7 @@ describe('getLogger()', () => {
         test('not log if log level is less than debug', async () => {
             const sl = createStandardLogForTest(logLevels.debug - 1);
             const id = 'inc with args';
-            const logger = sl.getLogger([id]);
+            const logger = sl.getLogger(id);
             logger.count('msg1', 'msg2');
             expect(sl.reporter.logs.length).toBe(0);
         });
@@ -355,41 +366,41 @@ describe('getLogger()', () => {
     test('logger with custom level', async () => {
         const mem = createMemoryLogReporter();
         const sl = createStandardLog({ customLevels: { 'cust_lvl': 100 }, reporters: [mem] });
-        const logger = sl.getLogger(['cust']);
+        const logger = sl.getLogger('cust');
         logger.cust_lvl('a', 'b');
         a.satisfies(mem.logs, [{ id: 'cust', level: 100, args: ['a', 'b'] }]);
     });
     describe('getLogger([,{ writeTo }])', () => {
-        function testWriteTo(loggerParams, handler) {
+        function testWriteTo(id, options, handler) {
             const memReporter = createMemoryLogReporter();
             const specialReporter = createMemoryLogReporter({ id: 'special' });
             const sl = createStandardLog({ reporters: [memReporter, specialReporter] });
-            const log = sl.getLogger(loggerParams);
+            const log = sl.getLogger(id, options);
             handler(log, memReporter.logs, specialReporter.logs, sl);
         }
         it('can specify which reporter to use by name', () => {
-            testWriteTo(['writeTo-string', { writeTo: 'special' }], (log, memLogs, specialLogs) => {
+            testWriteTo('writeTo-string', { writeTo: 'special' }, (log, memLogs, specialLogs) => {
                 log.error('error message');
                 expect(memLogs.length).toEqual(0);
                 expect(specialLogs.length).toEqual(1);
             });
         });
         it('can specify which reporter to use by regex', () => {
-            testWriteTo(['writeTo-regex', { writeTo: /^spec/ }], (log, memLogs, specialLogs) => {
+            testWriteTo('writeTo-regex', { writeTo: /^spec/ }, (log, memLogs, specialLogs) => {
                 log.error('error message');
                 expect(memLogs.length).toEqual(0);
                 expect(specialLogs.length).toEqual(1);
             });
         });
         it('can specify which reporter to use by RegExp', () => {
-            testWriteTo(['writeTo-RegExp', { writeTo: new RegExp('^spec') }], (log, memLogs, specialLogs) => {
+            testWriteTo('writeTo-RegExp', { writeTo: new RegExp('^spec') }, (log, memLogs, specialLogs) => {
                 log.error('error message');
                 expect(memLogs.length).toEqual(0);
                 expect(specialLogs.length).toEqual(1);
             });
         });
         it('can specify which reporter to use by function', () => {
-            testWriteTo(['writeTo-fn', { writeTo: id => id === 'special' }], (log, memLogs, specialLogs) => {
+            testWriteTo('writeTo-fn', { writeTo: id => id === 'special' }, (log, memLogs, specialLogs) => {
                 log.error('error message');
                 expect(memLogs.length).toEqual(0);
                 expect(specialLogs.length).toEqual(1);
@@ -397,7 +408,7 @@ describe('getLogger()', () => {
         });
         it('can specify custom reporter', () => {
             const reporter = createMemoryLogReporter({ id: 'custom mem' });
-            testWriteTo(['writeTo-reporter', { writeTo: reporter }], (log, memLogs, specialLogs) => {
+            testWriteTo('writeTo-reporter', { writeTo: reporter }, (log, memLogs, specialLogs) => {
                 log.error('error message');
                 expect(memLogs.length).toEqual(0);
                 expect(specialLogs.length).toEqual(0);
@@ -408,8 +419,8 @@ describe('getLogger()', () => {
             // if not, it would be a security issue as the new reporter
             // can capture the logs from other logger and send it elsewhere
             const reporter = createMemoryLogReporter({ id: 'custom mem' });
-            testWriteTo(['writeTo-reporter-no-override', { writeTo: reporter }], (_, memLogs, specialLogs, sl) => {
-                const log = sl.getLogger(['writeTo-reporter-no-override-2']);
+            testWriteTo('writeTo-reporter-no-override', { writeTo: reporter }, (_, memLogs, specialLogs, sl) => {
+                const log = sl.getLogger('writeTo-reporter-no-override-2');
                 log.error('error message');
                 expect(reporter.logs.length).toEqual(0);
             });
@@ -419,7 +430,7 @@ describe('getLogger()', () => {
 describe('suppressLogs()', () => {
     test('suppress log', () => {
         const sl = createStandardLogForTest();
-        const log = sl.getLogger(['l']);
+        const log = sl.getLogger('l');
         suppressLogs(() => {
             log.alert('should not see me');
         }, log);
@@ -427,8 +438,8 @@ describe('suppressLogs()', () => {
     });
     test('suppress multiple logs', () => {
         const sl = createStandardLogForTest();
-        const log1 = sl.getLogger(['l1']);
-        const log2 = sl.getLogger(['l2']);
+        const log1 = sl.getLogger('l1');
+        const log2 = sl.getLogger('l2');
         suppressLogs(() => {
             log1.alert('should not see me');
             log2.alert('should not see me too');
@@ -437,10 +448,46 @@ describe('suppressLogs()', () => {
     });
     test('return block result', () => {
         const sl = createStandardLogForTest();
-        const log1 = sl.getLogger(['l']);
-        const log2 = sl.getLogger(['l2']);
+        const log1 = sl.getLogger('l');
+        const log2 = sl.getLogger('l2');
         const a = suppressLogs(() => 1, log1, log2);
         expect(a).toBe(1);
     });
 });
+describe('getLogger()', () => {
+    it('gets a logger that logs to console by default', () => {
+        const log = getLogger('default');
+        log.info('from global log, expected to be printed');
+        log.debug('from global log, this should not be printed');
+    });
+});
+describe('configGlobal()', () => {
+    beforeEach(() => {
+        ctx.gsl = undefined;
+        ctx.configured = false;
+    });
+    it('configure the global instance', () => {
+        const mem = createMemoryLogReporter();
+        configGlobal({ logLevel: logLevels.error, reporters: [mem] });
+        const log = getLogger('default');
+        log.error('error message');
+        log.info('info message');
+        expect(mem.logs.length).toBe(1);
+    });
+    it('can call after getLogger', () => {
+        const log = getLogger('default');
+        log.info('from global log, expected to be printed');
+        const mem = createMemoryLogReporter();
+        configGlobal({ logLevel: logLevels.error, reporters: [mem] });
+        log.error('from global log, expected to be printed');
+        log.info('from global log, this should not be printed');
+        expect(mem.logs.length).toBe(1);
+    });
+    it('will emit a warning when called twice', () => {
+        const mem = createMemoryLogReporter();
+        configGlobal({ reporters: [mem] });
+        configGlobal({ reporters: [] });
+        a.satisfies(mem.logs, [{ id: 'standard-log', level: logLevels.warn, args: [/being called more than once/] }]);
+    });
+});
 //# sourceMappingURL=standardLog.spec.js.map