@techdocs/cli 1.10.2 → 1.10.3-next.1

package/dist/lib/run.cjs.js

@@ -1,58 +0,0 @@
-'use strict';
-
-var child_process = require('child_process');
-
-const run = async (name, args = [], options = {}) => {
-  const { stdoutLogFunc, stderrLogFunc } = options;
-  const env = {
-    ...process.env,
-    FORCE_COLOR: "true",
-    ...options.env ?? {}
-  };
-  const stdio = [
-    "inherit",
-    stdoutLogFunc ? "pipe" : "inherit",
-    stderrLogFunc ? "pipe" : "inherit"
-  ];
-  const childProcess = child_process.spawn(name, args, {
-    stdio,
-    ...options,
-    env
-  });
-  if (stdoutLogFunc && childProcess.stdout) {
-    childProcess.stdout.on("data", stdoutLogFunc);
-  }
-  if (stderrLogFunc && childProcess.stderr) {
-    childProcess.stderr.on("data", stderrLogFunc);
-  }
-  return childProcess;
-};
-async function waitForSignal(childProcesses) {
-  const promises = [];
-  for (const signal of ["SIGINT", "SIGTERM"]) {
-    process.on(signal, () => {
-      childProcesses.forEach((childProcess) => {
-        childProcess.kill();
-      });
-    });
-  }
-  childProcesses.forEach((childProcess) => {
-    if (typeof childProcess.exitCode === "number") {
-      if (childProcess.exitCode) {
-        throw new Error(`Non zero exit code from child process`);
-      }
-      return;
-    }
-    promises.push(
-      new Promise((resolve, reject) => {
-        childProcess.once("error", reject);
-        childProcess.once("exit", resolve);
-      })
-    );
-  });
-  await Promise.all(promises);
-}
-
-exports.run = run;
-exports.waitForSignal = waitForSignal;
-//# sourceMappingURL=run.cjs.js.map

package/dist/lib/run.cjs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.cjs.js","sources":["../../src/lib/run.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { spawn, SpawnOptions, ChildProcess } from 'child_process';\n\nexport type LogFunc = (data: Buffer | string) => void;\ntype SpawnOptionsPartialEnv = Omit<SpawnOptions, 'env'> & {\n  env?: Partial<NodeJS.ProcessEnv>;\n  // Pipe stdout to this log function\n  stdoutLogFunc?: LogFunc;\n  // Pipe stderr to this log function\n  stderrLogFunc?: LogFunc;\n};\n\n// TODO: Accept log functions to pipe logs with.\n// Runs a child command, returning the child process instance.\n// Use it along with waitForSignal to run a long running process e.g. mkdocs serve\nexport const run = async (\n  name: string,\n  args: string[] = [],\n  options: SpawnOptionsPartialEnv = {},\n): Promise<ChildProcess> => {\n  const { stdoutLogFunc, stderrLogFunc } = options;\n\n  const env: NodeJS.ProcessEnv = {\n    ...process.env,\n    FORCE_COLOR: 'true',\n    ...(options.env ?? {}),\n  };\n\n  // Refer: https://nodejs.org/api/child_process.html#child_process_subprocess_stdio\n  const stdio = [\n    'inherit',\n    stdoutLogFunc ? 'pipe' : 'inherit',\n    stderrLogFunc ? 'pipe' : 'inherit',\n  ] as ('inherit' | 'pipe')[];\n\n  const childProcess = spawn(name, args, {\n    stdio: stdio,\n    ...options,\n    env,\n  });\n\n  if (stdoutLogFunc && childProcess.stdout) {\n    childProcess.stdout.on('data', stdoutLogFunc);\n  }\n  if (stderrLogFunc && childProcess.stderr) {\n    childProcess.stderr.on('data', stderrLogFunc);\n  }\n\n  return childProcess;\n};\n\n// Block indefinitely and wait for a signal to stop the child process(es)\n// Throw error if any child process errors\n// Resolves only when all processes exit with status code 0\nexport async function waitForSignal(\n  childProcesses: Array<ChildProcess>,\n): Promise<void> {\n  const promises: Array<Promise<void>> = [];\n\n  for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n    process.on(signal, () => {\n      childProcesses.forEach(childProcess => {\n        childProcess.kill();\n      });\n    });\n  }\n\n  childProcesses.forEach(childProcess => {\n    if (typeof childProcess.exitCode === 'number') {\n      if (childProcess.exitCode) {\n        throw new Error(`Non zero exit code from child process`);\n      }\n      return;\n    }\n\n    promises.push(\n      new Promise<void>((resolve, reject) => {\n        childProcess.once('error', reject);\n        childProcess.once('exit', resolve);\n      }),\n    );\n  });\n\n  await Promise.all(promises);\n}\n"],"names":["spawn"],"mappings":";;;;AA6BO,MAAM,GAAA,GAAM,OACjB,IAAA,EACA,IAAA,GAAiB,EAAC,EAClB,OAAA,GAAkC,EAAC,KACT;AAC1B,EAAA,MAAM,EAAE,aAAA,EAAe,aAAA,EAAc,GAAI,OAAA;AAEzC,EAAA,MAAM,GAAA,GAAyB;AAAA,IAC7B,GAAG,OAAA,CAAQ,GAAA;AAAA,IACX,WAAA,EAAa,MAAA;AAAA,IACb,GAAI,OAAA,CAAQ,GAAA,IAAO;AAAC,GACtB;AAGA,EAAA,MAAM,KAAA,GAAQ;AAAA,IACZ,SAAA;AAAA,IACA,gBAAgB,MAAA,GAAS,SAAA;AAAA,IACzB,gBAAgB,MAAA,GAAS;AAAA,GAC3B;AAEA,EAAA,MAAM,YAAA,GAAeA,mBAAA,CAAM,IAAA,EAAM,IAAA,EAAM;AAAA,IACrC,KAAA;AAAA,IACA,GAAG,OAAA;AAAA,IACH;AAAA,GACD,CAAA;AAED,EAAA,IAAI,aAAA,IAAiB,aAAa,MAAA,EAAQ;AACxC,IAAA,YAAA,CAAa,MAAA,CAAO,EAAA,CAAG,MAAA,EAAQ,aAAa,CAAA;AAAA,EAC9C;AACA,EAAA,IAAI,aAAA,IAAiB,aAAa,MAAA,EAAQ;AACxC,IAAA,YAAA,CAAa,MAAA,CAAO,EAAA,CAAG,MAAA,EAAQ,aAAa,CAAA;AAAA,EAC9C;AAEA,EAAA,OAAO,YAAA;AACT;AAKA,eAAsB,cACpB,cAAA,EACe;AACf,EAAA,MAAM,WAAiC,EAAC;AAExC,EAAA,KAAA,MAAW,MAAA,IAAU,CAAC,QAAA,EAAU,SAAS,CAAA,EAAY;AACnD,IAAA,OAAA,CAAQ,EAAA,CAAG,QAAQ,MAAM;AACvB,MAAA,cAAA,CAAe,QAAQ,CAAA,YAAA,KAAgB;AACrC,QAAA,YAAA,CAAa,IAAA,EAAK;AAAA,MACpB,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH;AAEA,EAAA,cAAA,CAAe,QAAQ,CAAA,YAAA,KAAgB;AACrC,IAAA,IAAI,OAAO,YAAA,CAAa,QAAA,KAAa,QAAA,EAAU;AAC7C,MAAA,IAAI,aAAa,QAAA,EAAU;AACzB,QAAA,MAAM,IAAI,MAAM,CAAA,qCAAA,CAAuC,CAAA;AAAA,MACzD;AACA,MAAA;AAAA,IACF;AAEA,IAAA,QAAA,CAAS,IAAA;AAAA,MACP,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AACrC,QAAA,YAAA,CAAa,IAAA,CAAK,SAAS,MAAM,CAAA;AACjC,QAAA,YAAA,CAAa,IAAA,CAAK,QAAQ,OAAO,CAAA;AAAA,MACnC,CAAC;AAAA,KACH;AAAA,EACF,CAAC,CAAA;AAED,EAAA,MAAM,OAAA,CAAQ,IAAI,QAAQ,CAAA;AAC5B;;;;;"}