@vbarbarosh/node-helpers 3.60.0 → 3.62.0

package/package.json

@@ -2,7 +2,7 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.60.0",
+    "version": "3.62.0",
     "description": "A set of helpers for JavaScript/Node.js",
     "files": [
         "src"

package/src/array_index.js

@@ -1,3 +1,10 @@
+/**
+ * Usage:
+ *     array_index(items, v => v.name)
+ *
+ * Seems, there is a native way to do it:
+ *     Object.fromEntries(items.map(v => [v.name, v]));
+ */
 function array_index(array, fn)
 {
     const out = {};

package/src/camel_to_snake.js

@@ -0,0 +1,9 @@
+function camel_to_snake(s)
+{
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')  // Insert underscore between lowercase/number and uppercase
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2') // Separate acronyms from regular CamelCase words
+        .toLowerCase();
+}
+
+module.exports = camel_to_snake;

package/src/camel_to_snake.test.js

@@ -0,0 +1,17 @@
+const assert = require('assert');
+const camel_to_snake = require('./camel_to_snake');
+
+const items = [
+    ['UPC', 'upc'],
+    ['CamelCase', 'camel_case'],
+    ['SomeUPCCode', 'some_upc_code'],
+    ['XMLHTTPRequest', 'xmlhttp_request'],
+];
+
+describe('camel_to_snake', function () {
+    items.forEach(function ([input, expected],) {
+        it(`${input === '' ? '☒' : input} → ${expected}`, function () {
+            assert.deepStrictEqual(camel_to_snake(input), expected);
+        });
+    });
+});

package/src/fcmp_from_spec.js

@@ -1,5 +1,6 @@
 /**
- * Create fcmp from an array of props. For desc order a prop should be prefixed with minus sign (e.g. -price).
+ * Create fcmp from an array of props. For desc order a prop should be prefixed
+ * with minus sign (e.g. -price).
  */
 function fcmp_from_spec(props)
 {

package/src/filter1_from_spec.js

@@ -0,0 +1,75 @@
+/**
+ * Creates a filtering function based on the following spec:
+ * 1. Substrings are separated by `/`.
+ * 2. Each substring may have special characters:
+ *    - `^`: Substring must appear at the beginning.
+ *    - `$`: Substring must appear at the end.
+ *    - `!`: Negates the condition (substring must not appear).
+ */
+function filter1_from_spec(spec)
+{
+    let a, b, c, d;
+    const parts = parse_spec(spec);
+    switch (parts.length) {
+    case 0:
+        // No filters, always true
+        return () => true;
+    case 1:
+        return parts[0];
+    case 2:
+        [a, b] = parts;
+        return s => a(s) && b(s);
+    case 3:
+        [a, b, c] = parts;
+        return s => a(s) && b(s) && c(s);
+    case 4:
+        [a, b, c, d] = parts;
+        return s => a(s) && b(s) && c(s) && d(s);
+    default:
+        return s => parts.every(fn => fn(s));
+    }
+}
+
+function parse_spec(spec)
+{
+    return spec.split('/').filter(v => v).map(parse_expr);
+}
+
+// convert expr into an array of objects {substr, starts, ends}
+function parse_expr(expr)
+{
+    let substr;
+    let starts = false; // ^
+    let ends = false; // $
+    substr = expr.replaceAll('^', '');
+    starts = (substr.length !== expr.length);
+    expr = substr;
+    substr = expr.replaceAll('$', '');
+    ends = (substr.length !== expr.length);
+    expr = substr;
+    substr = expr.replaceAll('!', '');
+    if ((expr.length - substr.length) % 2) { // not
+        if (starts && ends) {
+            return s => !s.startsWith(substr) && !s.endsWith(substr);
+        }
+        if (starts) {
+            return s => !s.startsWith(substr);
+        }
+        if (ends) {
+            return s => !s.endsWith(substr);
+        }
+        return s => !s.includes(substr);
+    }
+    if (starts && ends) {
+        return s => s.startsWith(substr) && s.endsWith(substr);
+    }
+    if (starts) {
+        return s => s.startsWith(substr);
+    }
+    if (ends) {
+        return s => s.endsWith(substr);
+    }
+    return s => s.includes(substr);
+}
+
+module.exports = filter1_from_spec;

package/src/filter1_from_spec.test.js

@@ -0,0 +1,31 @@
+const assert = require('assert');
+const filter1_from_spec = require('./filter1_from_spec');
+
+const scenarios = [
+    // Format: [spec, input, expected, description]
+    ['substr', 'this is a substr example', true, 'Single substring match'],
+    ['^start', 'start of the string', true, 'Starts with substring'],
+    ['end$', 'this is the end', true, 'Ends with substring'],
+    ['!foo', 'this string does not contain it', true, 'Does not contain substring'],
+    ['^start/end$', 'start and end', true, 'Starts and ends with substrings'],
+    ['substr1/substr2', 'contains substr1 and substr2', true, 'Two matches'],
+    ['substr1/substr2/substr3', 'contains substr1, substr2, and substr3', true, 'Three matches'],
+    ['substr1/substr2/substr3/substr4', 'contains substr1, substr2, substr3, and substr4', true, 'Four matches'],
+    ['substr1/substr2/substr3/substr4/substr5', 'contains substr1, substr2, substr3, substr4, substr5', true, 'Five matches'],
+    ['!not1/!not2', 'this string avoids nota and notb', true, 'Does not contain multiple substrings'],
+    ['^start1/^start2', 'start1 followed by start2', false, 'Conflicting start substrings'],
+    ['end1$/end2$', 'ends with end1 or end2', false, 'Conflicting end substrings'],
+    ['^start1/!substr1', 'start1 without substr', true, 'Starts with start1 and have no substr1'],
+    ['substr/!not', 'contains substr but no ...', true, 'Combination of positive and negative substrings'],
+    ['!missing', 'this string does not mention it', true, 'Negative substring absent'],
+    ['missing', 'this string does not mention it', false, 'Substring missing']
+];
+
+describe('filter1_from_spec', function () {
+    scenarios.forEach(function ([spec, input, expected, description]) {
+        it(`${description || spec}`, function () {
+            const filter = filter1_from_spec(spec);
+            assert.strictEqual(filter(input), expected, description);
+        });
+    });
+});

package/src/format_bytes.js

@@ -18,3 +18,11 @@ function format_bytes(bytes)
 }
 
 module.exports = format_bytes;
+
+// https://wiki.ubuntu.com/UnitsPolicy
+// > Applications must use SI standard for base-10 units:
+// >
+// > 1 kB = 1,000 bytes (Note: small k)
+// > 1 MB = 1,000 kB = 1,000,000 bytes
+// > 1 GB = 1,000 MB = 1,000,000 kB = 1,000,000,000 bytes
+// > 1 TB = 1,000 GB = 1,000,000 MB = 1,000,000,000 kB = 1,000,000,000,000 bytes

package/src/sanitize_var_name.js

@@ -0,0 +1,16 @@
+const camel_to_snake = require('./camel_to_snake');
+const sanitize_dash_name = require('./sanitize_dash_name');
+
+function sanitize_var_name(var_name)
+{
+    const out = sanitize_dash_name(camel_to_snake(var_name)).replace(/[^a-z0-9]+/g, '_');
+    if (out.length === 0) {
+        return '_';
+    }
+    if (out[0].match(/[0-9]/)) {
+        return '_' + out;
+    }
+    return out;
+}
+
+module.exports = sanitize_var_name;

package/src/sanitize_var_name.test.js

@@ -0,0 +1,32 @@
+const assert = require('assert');
+const sanitize_var_name = require('./sanitize_var_name');
+
+const items = [
+    ['', '_'],
+    [' ', '_'],
+    ['   ', '_'],
+    ['Product ID', 'product_id'],
+    ['Product-ID', 'product_id'],
+    ['Image URL', 'image_url'],
+    ['Ópera Prima', 'opera_prima'],
+    ['1000-stories', '_1000_stories'],
+    ['A, C, D', 'a_c_d'],
+    ['@odata.etag', 'odata_etag'],
+    ['ItemInternalId', 'item_internal_id'],
+    ['UPC', 'upc'],
+    ['Sale_price', 'sale_price'],
+    ['% de disponibilidad de tiendas', 'de_disponibilidad_de_tiendas'],
+    ['%Tiendas con precio moda', 'tiendas_con_precio_moda'],
+
+    // https://github.com/Advanon/sanitize-s3-objectkey
+    // https://github.com/hamxabaig/s3-filename
+    // ['some  漢字 ćööł %  #fíłéñàmé.jpg', 'some_cool_filename_jpg'],
+];
+
+describe('sanitize_var_name', function () {
+    items.forEach(function ([input, expected],) {
+        it(`${input === '' ? '☒' : input} → ${expected}`, function () {
+            assert.deepStrictEqual(sanitize_var_name(input), expected);
+        });
+    });
+});

package/src/shell_curl_progress.js

@@ -11,7 +11,7 @@ async function shell_curl_progress(args, {options, user_friendly_status})
     // > you need to redirect the response output to a file, using
     // > shell redirect (>), -o, --output or similar.
 
-    const tmp = ['--progress-meter'];
+    const tmp = ['--no-silent', '--progress-meter'];
     if (!args.includes('-o')) {
         tmp.push('-o', '/dev/null');
     }

package/src/stream_curl_progress.d/basic

@@ -0,0 +1,3 @@
+  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
+                                 Dload  Upload   Total   Spent    Left  Speed
+
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
  2  390k    2 10934    0     0  10234      0  0:00:39  0:00:01  0:00:38 10237
  5  390k    5 21877    0     0  10569      0  0:00:37  0:00:02  0:00:35 10573
  8  390k    8 32125    0     0  10241      0  0:00:39  0:00:03  0:00:36 10243
 10  390k   10 43059    0     0  10406      0  0:00:38  0:00:04  0:00:34 10408
 14  390k   14 56853    0     0  10922      0  0:00:36  0:00:05  0:00:31 10922
 17  390k   17 69113    0     0  10548      0  0:00:37  0:00:06  0:00:31 10610
 20  390k   20 81782    0     0  10552      0  0:00:37  0:00:07  0:00:30 10546
 20  390k   20 81782    0     0  10239      0  0:00:39  0:00:07  0:00:32 10238
 23  390k   23 94460    0     0  10509      0  0:00:38  0:00:08  0:00:30 10598
 26  390k   26  103k    0     0  10378      0  0:00:38  0:00:10  0:00:28  9814
 29  390k   29  115k    0     0  10455      0  0:00:38  0:00:11  0:00:27 10325
 32  390k   32  127k    0     0  10352      0  0:00:38  0:00:12  0:00:26 10032
 35  390k   35  139k    0     0  10418      0  0:00:38  0:00:13  0:00:25 10667
 35  390k   35  139k    0     0  10241      0  0:00:39  0:00:13  0:00:26  9754
 39  390k   39  152k    0     0  10402      0  0:00:38  0:00:14  0:00:24 10456
 41  390k   41  163k    0     0  10327      0  0:00:38  0:00:16  0:00:22 10028
 45  390k   45  175k    0     0  10381      0  0:00:38  0:00:17  0:00:21 10456
 48  390k   48  188k    0     0  10371      0  0:00:38  0:00:18  0:00:20 10238
 51  390k   51  199k    0     0  10311      0  0:00:38  0:00:19  0:00:19 10479
 51  390k   51  199k    0     0  10240      0  0:00:39  0:00:19  0:00:20  9752
 54  390k   54  211k    0     0  10356      0  0:00:38  0:00:20  0:00:18 10456
 57  390k   57  223k    0     0  10304      0  0:00:38  0:00:22  0:00:16 10030
 61  390k   61  239k    0     0  10503      0  0:00:38  0:00:23  0:00:15 11020
 65  390k   65  255k    0     0  10487      0  0:00:38  0:00:24  0:00:14 11171
 65  390k   65  255k    0     0  10241      0  0:00:39  0:00:25  0:00:14 10242
 69  390k   69  271k    0     0  10473      0  0:00:38  0:00:26  0:00:12 10912
 69  390k   69  271k    0     0  10240      0  0:00:39  0:00:27  0:00:12  9952
 73  390k   73  287k    0     0  10458      0  0:00:38  0:00:28  0:00:10 10234
 77  390k   77  303k    0     0  10448      0  0:00:38  0:00:29  0:00:09 10245
 77  390k   77  303k    0     0  10241      0  0:00:39  0:00:30  0:00:09 10241
 81  390k   81  319k    0     0  10436      0  0:00:38  0:00:31  0:00:07 10231
 85  390k   85  335k    0     0  10427      0  0:00:38  0:00:32  0:00:06 11303
 85  390k   85  335k    0     0  10240      0  0:00:39  0:00:33  0:00:06  9110
 90  390k   90  351k    0     0  10418      0  0:00:38  0:00:34  0:00:04 10231
 90  390k   90  351k    0     0  10241      0  0:00:39  0:00:35  0:00:04 10240
 94  390k   94  367k    0     0  10411      0  0:00:38  0:00:36  0:00:02 10248
 98  390k   98  383k    0     0  10403      0  0:00:38  0:00:37  0:00:01 10236
 98  390k   98  383k    0     0  10240      0  0:00:39  0:00:38  0:00:01 10238

package/src/stream_curl_progress.d/basic.json

@@ -0,0 +1,42 @@
+[
+  {"perc":"0","done":"0","total":"0","perc2":"0","recv":"0","perc3":"0","transferred":"0","speed_down":"0","speed_up":"0","time_total":"~","duration":"~","eta":"~","speed":"0"},
+  {"perc":"2","done":"10934","total":"390k","perc2":"2","recv":"10934","perc3":"0","transferred":"0","speed_down":"10234","speed_up":"0","time_total":"0:00:39","duration":"0:00:01","eta":"0:00:38","speed":"10237"},
+  {"perc":"5","done":"21877","total":"390k","perc2":"5","recv":"21877","perc3":"0","transferred":"0","speed_down":"10569","speed_up":"0","time_total":"0:00:37","duration":"0:00:02","eta":"0:00:35","speed":"10573"},
+  {"perc":"8","done":"32125","total":"390k","perc2":"8","recv":"32125","perc3":"0","transferred":"0","speed_down":"10241","speed_up":"0","time_total":"0:00:39","duration":"0:00:03","eta":"0:00:36","speed":"10243"},
+  {"perc":"10","done":"43059","total":"390k","perc2":"10","recv":"43059","perc3":"0","transferred":"0","speed_down":"10406","speed_up":"0","time_total":"0:00:38","duration":"0:00:04","eta":"0:00:34","speed":"10408"},
+  {"perc":"14","done":"56853","total":"390k","perc2":"14","recv":"56853","perc3":"0","transferred":"0","speed_down":"10922","speed_up":"0","time_total":"0:00:36","duration":"0:00:05","eta":"0:00:31","speed":"10922"},
+  {"perc":"17","done":"69113","total":"390k","perc2":"17","recv":"69113","perc3":"0","transferred":"0","speed_down":"10548","speed_up":"0","time_total":"0:00:37","duration":"0:00:06","eta":"0:00:31","speed":"10610"},
+  {"perc":"20","done":"81782","total":"390k","perc2":"20","recv":"81782","perc3":"0","transferred":"0","speed_down":"10552","speed_up":"0","time_total":"0:00:37","duration":"0:00:07","eta":"0:00:30","speed":"10546"},
+  {"perc":"20","done":"81782","total":"390k","perc2":"20","recv":"81782","perc3":"0","transferred":"0","speed_down":"10239","speed_up":"0","time_total":"0:00:39","duration":"0:00:07","eta":"0:00:32","speed":"10238"},
+  {"perc":"23","done":"94460","total":"390k","perc2":"23","recv":"94460","perc3":"0","transferred":"0","speed_down":"10509","speed_up":"0","time_total":"0:00:38","duration":"0:00:08","eta":"0:00:30","speed":"10598"},
+  {"perc":"26","done":"103k","total":"390k","perc2":"26","recv":"103k","perc3":"0","transferred":"0","speed_down":"10378","speed_up":"0","time_total":"0:00:38","duration":"0:00:10","eta":"0:00:28","speed":"9814"},
+  {"perc":"29","done":"115k","total":"390k","perc2":"29","recv":"115k","perc3":"0","transferred":"0","speed_down":"10455","speed_up":"0","time_total":"0:00:38","duration":"0:00:11","eta":"0:00:27","speed":"10325"},
+  {"perc":"32","done":"127k","total":"390k","perc2":"32","recv":"127k","perc3":"0","transferred":"0","speed_down":"10352","speed_up":"0","time_total":"0:00:38","duration":"0:00:12","eta":"0:00:26","speed":"10032"},
+  {"perc":"35","done":"139k","total":"390k","perc2":"35","recv":"139k","perc3":"0","transferred":"0","speed_down":"10418","speed_up":"0","time_total":"0:00:38","duration":"0:00:13","eta":"0:00:25","speed":"10667"},
+  {"perc":"35","done":"139k","total":"390k","perc2":"35","recv":"139k","perc3":"0","transferred":"0","speed_down":"10241","speed_up":"0","time_total":"0:00:39","duration":"0:00:13","eta":"0:00:26","speed":"9754"},
+  {"perc":"39","done":"152k","total":"390k","perc2":"39","recv":"152k","perc3":"0","transferred":"0","speed_down":"10402","speed_up":"0","time_total":"0:00:38","duration":"0:00:14","eta":"0:00:24","speed":"10456"},
+  {"perc":"41","done":"163k","total":"390k","perc2":"41","recv":"163k","perc3":"0","transferred":"0","speed_down":"10327","speed_up":"0","time_total":"0:00:38","duration":"0:00:16","eta":"0:00:22","speed":"10028"},
+  {"perc":"45","done":"175k","total":"390k","perc2":"45","recv":"175k","perc3":"0","transferred":"0","speed_down":"10381","speed_up":"0","time_total":"0:00:38","duration":"0:00:17","eta":"0:00:21","speed":"10456"},
+  {"perc":"48","done":"188k","total":"390k","perc2":"48","recv":"188k","perc3":"0","transferred":"0","speed_down":"10371","speed_up":"0","time_total":"0:00:38","duration":"0:00:18","eta":"0:00:20","speed":"10238"},
+  {"perc":"51","done":"199k","total":"390k","perc2":"51","recv":"199k","perc3":"0","transferred":"0","speed_down":"10311","speed_up":"0","time_total":"0:00:38","duration":"0:00:19","eta":"0:00:19","speed":"10479"},
+  {"perc":"51","done":"199k","total":"390k","perc2":"51","recv":"199k","perc3":"0","transferred":"0","speed_down":"10240","speed_up":"0","time_total":"0:00:39","duration":"0:00:19","eta":"0:00:20","speed":"9752"},
+  {"perc":"54","done":"211k","total":"390k","perc2":"54","recv":"211k","perc3":"0","transferred":"0","speed_down":"10356","speed_up":"0","time_total":"0:00:38","duration":"0:00:20","eta":"0:00:18","speed":"10456"},
+  {"perc":"57","done":"223k","total":"390k","perc2":"57","recv":"223k","perc3":"0","transferred":"0","speed_down":"10304","speed_up":"0","time_total":"0:00:38","duration":"0:00:22","eta":"0:00:16","speed":"10030"},
+  {"perc":"61","done":"239k","total":"390k","perc2":"61","recv":"239k","perc3":"0","transferred":"0","speed_down":"10503","speed_up":"0","time_total":"0:00:38","duration":"0:00:23","eta":"0:00:15","speed":"11020"},
+  {"perc":"65","done":"255k","total":"390k","perc2":"65","recv":"255k","perc3":"0","transferred":"0","speed_down":"10487","speed_up":"0","time_total":"0:00:38","duration":"0:00:24","eta":"0:00:14","speed":"11171"},
+  {"perc":"65","done":"255k","total":"390k","perc2":"65","recv":"255k","perc3":"0","transferred":"0","speed_down":"10241","speed_up":"0","time_total":"0:00:39","duration":"0:00:25","eta":"0:00:14","speed":"10242"},
+  {"perc":"69","done":"271k","total":"390k","perc2":"69","recv":"271k","perc3":"0","transferred":"0","speed_down":"10473","speed_up":"0","time_total":"0:00:38","duration":"0:00:26","eta":"0:00:12","speed":"10912"},
+  {"perc":"69","done":"271k","total":"390k","perc2":"69","recv":"271k","perc3":"0","transferred":"0","speed_down":"10240","speed_up":"0","time_total":"0:00:39","duration":"0:00:27","eta":"0:00:12","speed":"9952"},
+  {"perc":"73","done":"287k","total":"390k","perc2":"73","recv":"287k","perc3":"0","transferred":"0","speed_down":"10458","speed_up":"0","time_total":"0:00:38","duration":"0:00:28","eta":"0:00:10","speed":"10234"},
+  {"perc":"77","done":"303k","total":"390k","perc2":"77","recv":"303k","perc3":"0","transferred":"0","speed_down":"10448","speed_up":"0","time_total":"0:00:38","duration":"0:00:29","eta":"0:00:09","speed":"10245"},
+  {"perc":"77","done":"303k","total":"390k","perc2":"77","recv":"303k","perc3":"0","transferred":"0","speed_down":"10241","speed_up":"0","time_total":"0:00:39","duration":"0:00:30","eta":"0:00:09","speed":"10241"},
+  {"perc":"81","done":"319k","total":"390k","perc2":"81","recv":"319k","perc3":"0","transferred":"0","speed_down":"10436","speed_up":"0","time_total":"0:00:38","duration":"0:00:31","eta":"0:00:07","speed":"10231"},
+  {"perc":"85","done":"335k","total":"390k","perc2":"85","recv":"335k","perc3":"0","transferred":"0","speed_down":"10427","speed_up":"0","time_total":"0:00:38","duration":"0:00:32","eta":"0:00:06","speed":"11303"},
+  {"perc":"85","done":"335k","total":"390k","perc2":"85","recv":"335k","perc3":"0","transferred":"0","speed_down":"10240","speed_up":"0","time_total":"0:00:39","duration":"0:00:33","eta":"0:00:06","speed":"9110"},
+  {"perc":"90","done":"351k","total":"390k","perc2":"90","recv":"351k","perc3":"0","transferred":"0","speed_down":"10418","speed_up":"0","time_total":"0:00:38","duration":"0:00:34","eta":"0:00:04","speed":"10231"},
+  {"perc":"90","done":"351k","total":"390k","perc2":"90","recv":"351k","perc3":"0","transferred":"0","speed_down":"10241","speed_up":"0","time_total":"0:00:39","duration":"0:00:35","eta":"0:00:04","speed":"10240"},
+  {"perc":"94","done":"367k","total":"390k","perc2":"94","recv":"367k","perc3":"0","transferred":"0","speed_down":"10411","speed_up":"0","time_total":"0:00:38","duration":"0:00:36","eta":"0:00:02","speed":"10248"},
+  {"perc":"98","done":"383k","total":"390k","perc2":"98","recv":"383k","perc3":"0","transferred":"0","speed_down":"10403","speed_up":"0","time_total":"0:00:38","duration":"0:00:37","eta":"0:00:01","speed":"10236"},
+  {"perc":"98","done":"383k","total":"390k","perc2":"98","recv":"383k","perc3":"0","transferred":"0","speed_down":"10240","speed_up":"0","time_total":"0:00:39","duration":"0:00:38","eta":"0:00:01","speed":"10238"},
+  {"perc":"100","done":"390k","total":"390k","perc2":"100","recv":"390k","perc3":"0","transferred":"0","speed_down":"10422","speed_up":"0","time_total":"0:00:38","duration":"0:00:38","eta":"~","speed":"10457"}
+]

package/src/stream_curl_progress.test.js

@@ -0,0 +1,17 @@
+const assert = require('assert');
+const fs = require('fs');
+const fs_path_resolve = require('./fs_path_resolve');
+const fs_read_json = require('./fs_read_json');
+const stream = require('stream');
+const stream_curl_progress = require('./stream_curl_progress');
+
+describe('stream_curl_progress', function () {
+    it('should handle basic input', async function () {
+        const expected = await fs_read_json(fs_path_resolve(__dirname, 'stream_curl_progress.d/basic.json'));
+        const actual = await stream.compose(
+            fs.createReadStream(fs_path_resolve(__dirname, 'stream_curl_progress.d/basic')),
+            stream_curl_progress(),
+        ).toArray();
+        assert.deepStrictEqual(actual, expected);
+    });
+});

package/src/waitcb.js

@@ -4,7 +4,7 @@ const Promise = require('bluebird');
  * Wait for a Node-like function to finish (which will call `callback`
  * with 2 arguments: `error` and `value`).
  *
- * await waitcb(cb => fs.promises.writeFile('a', 'hello\n', cb));
+ * await waitcb(cb => fs.writeFile('a', 'hello\n', cb));
  */
 function waitcb(fn)
 {