@canopycanopycanopy/b-ber-logger 3.0.8-nav-memo.4 → 3.0.8-next.61

package/README.md

@@ -1,58 +1,31 @@
 # `@canopycanopycanopy/b-ber-logger`
 
-`b-ber-logger` is b-ber's console logger.
-
-## Install
-
-```
-$ npm i -g @canopycanopycanopy/b-ber-logger
-```
-
-## Usage
-
-Output from `bber` commands can be logged to the console with different levels of verbosity.
-
-### Arguments
-
-#### `--quiet`
-
-The `--quiet` flag will emit nothing to the console and is an alias of `loglevel=0`.
-
-```
-$ bber build --quiet
-$ bber build --log-level=0
-```
-
-#### `--warn`
-
-The `---warn` flag will emit warnings and single-line error messages to the console and is an alias of `loglevel=1`.
-
-```
-$ bber build --warn
-$ bber build --log-level=1
-```
-
-#### `--error`
-
-The `--error` flag will emit warnings and stack traces for errors to the console and is an alias of `loglevel=2`.
-
-```
-$ bber build --error
-$ bber build --log-level=2
-```
-
-#### `--verbose`
-
-The `--verbose` flat will emit messages, warnings, errors and stack traces to the console.
-
-```
-$ bber build --verbose
-```
-
-#### `--debug`
-
-The `--debug` flag will emit stack traces for everything, as well as warnings and errors to the console.
-
-```
-$ bber build --debug
+`b-ber-logger` is the logging utility for the b-ber build pipeline. It exports a single `Logger` singleton (`log`) that all other packages import instead of using `console.log` directly. The logger supports levelled output (`info`, `warn`, `error`, `debug`, `trace`, `notice`, `inspect`), chalk-coloured formatting, indentation tracking across nested task steps, a build-run timer, end-of-run summary of collected warnings and errors, and quiet/verbose/debug modes driven by CLI flags (`--quiet`, `--verbose`, `--debug`, `--log-level=N`).
+
+## Key exports
+
+| Export          | Purpose                                                       |
+| --------------- | ------------------------------------------------------------- |
+| `log` (default) | Singleton `Logger` instance; import and call methods directly |
+
+### Logger methods
+
+| Method                    | Purpose                                            |
+| ------------------------- | -------------------------------------------------- |
+| `log.info(msg)`           | Standard informational output                      |
+| `log.warn(msg)`           | Warning, collected for end-of-run summary          |
+| `log.error(msg)`          | Error output, collected for end-of-run summary     |
+| `log.debug(msg)`          | Debug output; enabled by `--debug` flag            |
+| `log.trace(msg)`          | Trace-level output                                 |
+| `log.notice(msg)`         | Notice-level output                                |
+| `log.inspect(val)`        | Pretty-prints objects                              |
+| `log.printSummary()`      | Prints collected warnings/errors at end of a build |
+| `log.configure(opts)`     | Applies settings (logLevel, boringOutput, etc.)    |
+| `log.registerSequence(n)` | Sets total task count for progress display         |
+
+## Dev
+
+```bash
+npm test      # jest
+npm run build
 ```

package/dist/index.js

@@ -12,8 +12,8 @@ var _reduce = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-sta
 var _forEach = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/for-each"));
 var _keys = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/object/keys"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
-var _lodash = _interopRequireDefault(require("lodash.has"));
-var _lodash2 = _interopRequireDefault(require("lodash.isundefined"));
+var _has = _interopRequireDefault(require("lodash/has"));
+var _isUndefined = _interopRequireDefault(require("lodash/isUndefined"));
 var _Timer = _interopRequireDefault(require("./Timer"));
 var _printer = require("./printer");
 var _indenter = require("./indenter");
@@ -95,12 +95,12 @@ class Logger extends _Timer.default {
     const argv = (0, _reduce.default)(_context = process.argv).call(_context, (acc, curr) => {
       const [k, v] = curr.split('=');
       // eslint-disable-next-line no-restricted-globals
-      acc[k] = (0, _lodash2.default)(v) ? true : !isNaN(v) ? Number(v) : v;
+      acc[k] = (0, _isUndefined.default)(v) ? true : !isNaN(v) ? Number(v) : v;
       return acc;
     }, {});
     (0, _forEach.default)(_context2 = (0, _keys.default)(this.settings)).call(_context2, a => {
       const opt = `--${a}`;
-      if ((0, _lodash.default)(argv, opt)) this.settings[a] = argv[opt];
+      if ((0, _has.default)(argv, opt)) this.settings[a] = argv[opt];
     });
     this.configure();
     (0, _bind.default)(_context3 = this).call(_context3);

package/dist/summary.js

@@ -11,7 +11,7 @@ var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable
 var _forEach = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/for-each"));
 var _entries = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/object/entries"));
 var _util = _interopRequireDefault(require("util"));
-var _lodash = _interopRequireDefault(require("lodash.isplainobject"));
+var _isPlainObject = _interopRequireDefault(require("lodash/isPlainObject"));
 /* eslint-disable import/prefer-default-export */
 
 const INDENTATION = '  ';
@@ -39,7 +39,7 @@ function printNavigation(data, context, indent = 0) {
 function writeMetadata(data, context) {
   var _context3;
   (0, _forEach.default)(_context3 = (0, _entries.default)(data)).call(_context3, ([, v]) => {
-    if ((0, _lodash.default)(v)) {
+    if ((0, _isPlainObject.default)(v)) {
       write([[`${v.term}: ${v.value}`]], context);
     }
   });
@@ -51,7 +51,7 @@ function writeConfig(data, context, indent = 0) {
     if (typeof v === 'string') {
       write([[`${indent_}${k}: ${v}`]], context);
     }
-    if ((0, _lodash.default)(v)) {
+    if ((0, _isPlainObject.default)(v)) {
       write([[`${indent_}${k}`]], context);
       writeConfig(v, context, indent + 1);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canopycanopycanopy/b-ber-logger",
-  "version": "3.0.8-nav-memo.4+d47a9aae",
+  "version": "3.0.8-next.61+2bbec564",
   "description": "",
   "main": "dist/index.js",
   "scripts": {
@@ -18,11 +18,7 @@
   },
   "dependencies": {
     "chalk": "^2.1.0",
-    "lodash": "^4.17.21",
-    "lodash.has": "latest",
-    "lodash.isplainobject": "latest",
-    "lodash.isundefined": "^3.0.1",
-    "tar": "^6.1.11"
+    "lodash": "^4.17.21"
   },
   "devDependencies": {
     "@babel/cli": "^7.10.5",
@@ -49,5 +45,5 @@
       "url": "https://maxwellsimmer.com"
     }
   ],
-  "gitHead": "d47a9aae74dec3e3225e363b2434c7abe0fcf21b"
+  "gitHead": "2bbec5643278f53becb0d2ba1f55edfe379d5587"
 }