« get me outta code hell

node-utils.js « util « src - hsmusic-wiki - HSMusic - static wiki software cataloguing collaborative creation
about summary refs log tree commit diff
path: root/src/util/node-utils.js
blob: 6c75bab68f34d65989d9af3a8a669d46e802ff9e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
// Utility functions which are only relevant to particular Node.js constructs.

import {readdir} from 'fs/promises';
import {fileURLToPath} from 'url';
import * as path from 'path';

import _commandExists from 'command-exists';

// This package throws an error instead of returning false when the command
// doesn't exist, for some reason. Yay for making logic more difficult!
// Here's a straightforward workaround.
export function commandExists(command) {
  return _commandExists(command).then(
    () => true,
    () => false
  );
}

// Very cool function origin8ting in... http-music pro8a8ly!
// Sorry if we happen to 8e violating past-us's copyright, lmao.
export function promisifyProcess(proc, showLogging = true) {
  // Takes a process (from the child_process module) and returns a promise
  // that resolves when the process exits (or rejects, if the exit code is
  // non-zero).
  //
  // Ayy look, no alpha8etical second letter! Couldn't tell this was written
  // like three years ago 8efore I was me. 8888)

  return new Promise((resolve, reject) => {
    if (showLogging) {
      proc.stdout.pipe(process.stdout);
      proc.stderr.pipe(process.stderr);
    }

    proc.on('exit', (code) => {
      if (code === 0) {
        resolve();
      } else {
        reject(code);
      }
    });
  });
}

// Handy-dandy utility function for detecting whether the passed URL is the
// running JavaScript file. This takes `import.meta.url` from ES6 modules, which
// is great 'cuz (module === require.main) doesn't work without CommonJS
// modules.
export function isMain(importMetaURL) {
  const metaPath = fileURLToPath(importMetaURL);
  const relative = path.relative(process.argv[1], metaPath);
  const isIndexJS = path.basename(metaPath) === 'index.js';
  return [
    '',
    isIndexJS && 'index.js'
  ].includes(relative);
}

// Like readdir... but it's recursive!
export function traverse(startDirPath, {
  filterFile = () => true,
  filterDir = () => true
} = {}) {
  const recursive = (names, subDirPath) =>
    Promise.all(
      names.map((name) =>
        readdir(path.join(startDirPath, subDirPath, name)).then(
          (names) =>
            filterDir(name)
              ? recursive(names, path.join(subDirPath, name))
              : [],
          () => (filterFile(name) ? [path.join(subDirPath, name)] : [])
        )
      )
    ).then((pathArrays) => pathArrays.flatMap((x) => x));

  return readdir(startDirPath).then((names) => recursive(names, ''));
}