@lowlighter/run 0.2.0

package/README.md

@@ -0,0 +1,14 @@
+# ⏯️ Run subprocesses
+
+[![JSR](https://jsr.io/badges/@libs/run)](https://jsr.io/@libs/run) [![JSR Score](https://jsr.io/badges/@libs/run/score)](https://jsr.io/@libs/run)
+[![NPM](https://img.shields.io/npm/v/@lowlighter%2Frun?logo=npm&labelColor=cb0000&color=183e4e)](https://www.npmjs.com/package/@lowlighter/run) [![Coverage](https://libs-coverage.lecoq.io/run/badge.svg)](https://libs-coverage.lecoq.io/run)
+
+- [`🦕 Playground`](https://libs.lecoq.io/run)
+- [`📚 Documentation`](https://jsr.io/@libs/run/doc)
+
+## 📜 Licenses
+
+```
+Copyright (c) Lecoq Simon <@lowlighter>. (MIT License)
+https://github.com/lowlighter/libs/blob/main/LICENSE
+```

package/command.mjs

@@ -0,0 +1,33 @@
+var e=class e{constructor({level:t,format:n,output:o,tags:r,options:s}={}){if("granted"===globalThis.Deno?.permissions.querySync?.({name:"env",variable:"LOG_LEVEL"}).state){const n=globalThis.Deno?.env.get("LOG_LEVEL")??"";n in e.level&&(t??=e.level[n]),Number.isNaN(Number.parseInt(n))||(t??=Number.parseInt(n))}this.level=t??e.level.log,this.#e=o||null===o?o:console,this.#t=n??e.format.text,this.tags=r??{},this.options={date:!1,time:!1,delta:!0,...s,caller:!1!==s?.caller&&{file:!1,name:!1,line:!1,...s?.caller}}}level;#t;#e;tags;options;error(...t){return this.level>=e.level.error&&this.#e?.error(...this.#t(this,{level:e.level.error,content:t})),this}warn(...t){return this.level>=e.level.warn&&this.#e?.warn(...this.#t(this,{level:e.level.warn,content:t})),this}info(...t){return this.level>=e.level.info&&this.#e?.info(...this.#t(this,{level:e.level.info,content:t})),this}log(...t){return this.level>=e.level.log&&this.#e?.log(...this.#t(this,{level:e.level.log,content:t})),this}debug(...t){return this.level>=e.level.debug&&this.#e?.debug(...this.#t(this,{level:e.level.debug,content:t})),this}with(t={}){return new e({level:this.level,format:this.#t,output:this.#e,options:{...this.options},tags:{...this.tags,...t}})}#n(e=3){const t=Error,n=t.prepareStackTrace;t.prepareStackTrace=(e,t)=>t;const{stack:o}=new Error;t.prepareStackTrace=n;const r=o[e];return{file:r.getFileName(),name:r.getFunctionName(),line:r.getLineNumber(),column:r.getColumnNumber()}}static level=Object.freeze({disabled:NaN,error:0,warn:1,info:2,log:3,debug:4});static format={text(t,{level:n=0,content:o}){const r=["red","orange","cyan","white","gray"][n],s=[`%c ${Object.keys(e.level).find((t=>e.level[t]===n)).toLocaleUpperCase().padEnd(5)} │%c`],i=[`color: black; background-color: ${r}`,""];if(t.options.date||t.options.time||t.options.delta){const e=(new Date).toISOString(),n=[];if(t.options.delta){const e=performance.now()/1e3;let t=e.toPrecision(4);e<1&&(t=e.toPrecision(2)),n.push(`+${t}`)}t.options.date&&t.options.time?n.push(e):t.options.date?n.push(e.slice(0,e.indexOf("T"))):t.options.time&&n.push(e.slice(e.indexOf("T")+1,-1)),s.push(`%c ${n.join(" ¦ ").trim()} %c`),i.push(`color: black; background-color: ${r}`,"")}if(t.options.caller){const e=t.#n();if(e){const n=[];t.options.caller.file&&n.push(`${e.file.replace(t.options.caller.fileformat,"$<file>")}`),t.options.caller.name&&e.name&&n.push(e.name),t.options.caller.line&&n.push(e.line,e.column),s.push(`%c ${n.join(":").trim()} %c`),i.push("color: black; background-color: gray","")}}{const n=[];for(const[o,r]of Object.entries(t.tags))n.push(`${o}:${e.inspect(r)}`);s.push(`%c ${n.join(" ").trim()} %c`),i.push("background-color: black","")}return[s.join(""),...i,...o.map(e.inspect)]},json(t,{level:n=0,content:o}){const r={level:Object.keys(e.level).find((t=>e.level[t]===n)),timestamp:Date.now(),tags:t.tags,content:o},s={};if(t.options.date||t.options.time){const e=new Date(r.timestamp).toISOString();t.options.date&&(s.date=e.slice(0,e.indexOf("T"))),t.options.time&&(s.time=e.slice(e.indexOf("T")+1,-1))}if(t.options.delta&&(s.delta=performance.now()/1e3),t.options.caller){const e=t.#n();e&&(s.caller={},t.options.caller.file&&(s.caller.file=`${e.file.replace(t.options.caller.fileformat,"$<file>")}`),t.options.caller.name&&e.name&&(s.caller.name=e.name),t.options.caller.line&&(s.caller.line=[e.line,e.column]))}return[JSON.stringify({...r,...s})]}};static inspect(e){return globalThis.Deno?.inspect(e,{colors:!0,depth:1/0})??e}},t=class extends Error{constructor(e){super(e),this.name="AssertionError"}};TransformStream;function n(e){let t=0;for(const n of e)t+=n.length;const n=new Uint8Array(t);let o=0;for(const t of e)n.set(t,o),o+=t.length;return n}function o(e){const t=e.length,n=new Uint8Array(t);n[0]=0;let o=0,r=1;for(;r<t;)e[r]===e[o]?(o++,n[r]=o,r++):0===o?(n[r]=0,r++):o=n[o-1];return n}TransformStream,TransformStream,TransformStream,TransformStream;var r=class extends TransformStream{#o="";constructor(e={allowCR:!1}){super({transform:(t,n)=>{for(t=this.#o+t;;){const o=t.indexOf("\n"),r=e.allowCR?t.indexOf("\r"):-1;if(-1!==r&&r!==t.length-1&&(-1===o||o-1>r)){n.enqueue(t.slice(0,r)),t=t.slice(r+1);continue}if(-1===o)break;const s="\r"===t[o-1]?o-1:o;n.enqueue(t.slice(0,s)),t=t.slice(o+1)}this.#o=t},flush:t=>{if(""===this.#o)return;const n=e.allowCR&&this.#o.endsWith("\r")?this.#o.slice(0,-1):this.#o;t.enqueue(n)}})}};new TextDecoder;var s=new TextEncoder,i=new TextDecoder;function l(t,n,{log:o=new e,stdin:l=null,stdout:c="debug",stderr:u="error",env:d,cwd:p,raw:h,callback:f,buffering:m,sync:w,throw:g,winext:b="",os:v=Deno.build.os}={}){"windows"===v&&(t=`${t}${b}`),o=o.with({bin:t}),f&&"piped"!==a(l)&&(l="piped");const T=new Deno.Command(t,{args:n,stdin:w?"null":a(l),stdout:a(c),stderr:a(u),env:d,cwd:p,windowsRawArguments:h});return w?function(e,{bin:t,log:n,throw:o,stdout:r,stderr:s}){const l=Date.now(),c=e.outputSync(),{success:u,code:d}=c,p=Date.now()-l,h={get stdio(){return[[p,1,this.stdout],[p,2,this.stderr]]},stdin:"",stdout:"piped"===a(r)?i.decode(c.stdout):"",stderr:"piped"===a(s)?i.decode(c.stderr):""};for(const{channel:e,mode:t}of[{channel:"stdout",mode:r},{channel:"stderr",mode:s}])"piped"===a(t)&&h[e]&&n.with({t:p,channel:e})[t]?.(h[e]);if(!u&&o)throw new EvalError(`${t} exited with non-zero code ${d}:\n${h.stdout}\n${h.stderr}`);return{success:u,code:d,...h}}(T,{bin:t,log:o,throw:g,stdout:c,stderr:u}):async function(e,{bin:t,log:n,callback:o=(({close:e})=>e?.()),buffering:i=250,throw:l,...c}){const u=e.spawn(),d=Date.now(),p={stdio:[],get stdin(){return this.stdio.filter((([e,t])=>0===t)).map((([e,t,n])=>n)).join("\n")},get stdout(){return this.stdio.filter((([e,t])=>1===t)).map((([e,t,n])=>n)).join("\n")},get stderr(){return this.stdio.filter((([e,t])=>2===t)).map((([e,t,n])=>n)).join("\n")}},h={};let f="";const m=function(e,t){let n=null,o=null;const r=(...s)=>{r.clear(),o=()=>{r.clear(),e.call(r,...s)},n=setTimeout(o,t)};return r.clear=()=>{"number"==typeof n&&(clearTimeout(n),n=null,o=null)},r.flush=()=>{o?.()},Object.defineProperty(r,"pending",{get:()=>"number"==typeof n}),r}((async e=>{n.with({t:e}).debug("debounced"),f="",await o({stdio:p,i:p.stdin.length,...h})}),i);if("piped"===a(c.stdin)){const e=u.stdin.getWriter();Object.assign(h,{async write(t,o=!0){const r=Date.now()-d;c.stdin&&n.with({t:r,channel:"stdin"})[c.stdin]?.(t),p.stdio.push([r,0,t]),o&&!t.endsWith("\n")&&(t+="\n"),await e.write(s.encode(t)),f="stdin",e.releaseLock()},async close(){try{e.releaseLock(),await u.stdin.close(),n.with({t:Date.now()-d,closed:"stdin"}).debug()}catch{}},async wait(e=1e3){const t=Date.now()-d;n.with({t:t,waiting:e}).debug(),await function(e,t={}){const{signal:n,persistent:o=!0}=t;return n?.aborted?Promise.reject(n.reason):new Promise(((t,r)=>{const s=()=>{clearTimeout(i),r(n?.reason)},i=setTimeout((()=>{n?.removeEventListener("abort",s),t()}),e);if(n?.addEventListener("abort",s,{once:!0}),!1===o)try{Deno.unrefTimer(i)}catch(e){if(!(e instanceof ReferenceError))throw e;console.error("`persistent` option is only available in Deno")}}))}(e),m(t)}}),m(Date.now()-d)}await Promise.all(["stdout","stderr"].filter((e=>"piped"===a(c[e]))).map((async e=>{for await(const t of u[e].pipeThrough(new TextDecoderStream).pipeThrough(new r)){const o=Date.now()-d,r={stdout:1,stderr:2}[e];if(c[e]&&n.with({t:o,channel:e})[c[e]]?.(t),p.stdio.length&&f===e){const e=p.stdio.at(-1);e[1]===r&&(e[2]+=`\n${t}`)}else p.stdio.push([o,r,t]);f=e,m(o)}}))),m.flush();const{success:w,code:g}=await u.status;if(!w&&l)throw new EvalError(`${t} exited with non-zero code ${g}:\n${p.stdout}\n${p.stderr}`);return{success:w,code:g,...p}}(T,{bin:t,log:o,callback:f,buffering:m,throw:g,stdin:"piped"===a(l)?l:null,stdout:"piped"===a(c)?c:null,stderr:"piped"===a(u)?u:null})}function a(e){return["inherit","null"].includes(`${e}`)?`${e}`:"piped"}export{l as command};
+/**
+ * Logger library
+ *
+ * It is intended to supersed {@link https://developer.mozilla.org/en-US/docs/Web/API/console | console} by providing:
+ * - Colored output
+ * - Log levels
+ * - Tags
+ * - Timestamps
+ * - Delta
+ * - Caller information
+ * - Log formatters
+ *
+ * @example
+ * ```ts
+ * import { Logger } from "./mod.ts"
+ *
+ * // Configure logger
+ * const tags = { foo: true, bar: "string" }
+ * const options = { date: true, time: true, delta: true, caller: { file: true, fileformat: /.*\/(?<file>libs\/.*)$/, name: true, line: true } }
+ * const log = new Logger({ level: Logger.level.debug, options, tags })
+ *
+ * // Print logs
+ * log.error("🍱 bento")
+ * log.warn("🍜 ramen")
+ * log.info("🍣 sushi")
+ * log.log("🍥 narutomaki")
+ * log.debug("🍡 dango")
+ * ```
+ *
+ * @author Simon Lecoq (lowlighter)
+ * @license MIT
+ */

package/command.ts

@@ -0,0 +1,269 @@
+// Imports
+import type { Arg, Nullable, Promisable } from "@libs/typing"
+import { Logger, type loglevel } from "@libs/logger"
+import { TextLineStream } from "@std/streams"
+import { debounce } from "@std/async/debounce"
+import { delay } from "@std/async/delay"
+
+/** Run options. */
+export type options = {
+  /** Logger. */
+  log?: Logger
+  /** Environment variables. */
+  env?: Deno.CommandOptions["env"]
+  /** Current working directory. */
+  cwd?: Deno.CommandOptions["cwd"]
+  /** Raw arguments (Windows only). */
+  raw?: boolean
+  /** Handling of stdin. When using a loglevel, channel will be piped and logged to specified log level. */
+  stdin?: loglevel | "piped" | "inherit" | null
+  /** Handling of stdout. When using a loglevel, channel will be piped and logged to specified log level. */
+  stdout?: loglevel | "piped" | "inherit" | null
+  /** Handling of stderr. When using a loglevel, channel will be piped and logged to specified log level. */
+  stderr?: loglevel | "piped" | "inherit" | null
+  /**
+   * Stdin interaction callback.
+   * Each time data is received on either stdin or stdout, this will be called after input buffering.
+   * You can then read stdio content, write to stdin, close stdin or retry later (for polling).
+   * Passing this option will automatically set stdin to "piped" if it is "inherit" or "null".
+   */
+  callback?: callback
+  /**
+   * Stdio buffering.
+   * This is used to merge messages that are received relatively closely.
+   * Buffering is skipped when a different channel is used in-between.
+   */
+  buffering?: number
+  /**
+   * Execute process synchronously.
+   * Note that stdin is not usable in sync mode.
+   */
+  sync?: boolean
+  /** Process extension on Windows. */
+  winext?: string
+  /** Operating system. */
+  os?: typeof Deno.build.os
+  /** Throw an error if exit code is non-zero rather than returning a result. */
+  throw?: boolean
+}
+
+/** Run result. */
+export type result = {
+  /** Whether the process exited with a zero-code. */
+  success: Deno.CommandStatus["success"]
+  /** Process exit code. */
+  code: Deno.CommandStatus["code"]
+  /**
+   * Process stdio content.
+   * First element is the delta timestamp since process start, second element is the channel (0:stdin, 1:stdout, 2:stderr), third element is the content.
+   */
+  stdio: Array<[number, 0 | 1 | 2, string]>
+  /** Process stdin content. */
+  stdin: string
+  /** Process stdout content. */
+  stdout: string
+  /** Process stderr content. */
+  stderr: string
+}
+
+/** Stdin interaction callback. */
+export type callback = (options: { stdio: Pick<result, "stdin" | "stdout" | "stderr">; i: number; write: (content: string) => Promise<void>; close: () => Promise<void>; wait: (dt: number) => Promise<void> }) => Promisable<void>
+
+/** Text encoder */
+const encoder = new TextEncoder()
+
+/** Text decoder */
+const decoder = new TextDecoder()
+
+export function command(bin: string, args: string[], options?: options & { sync?: false }): Promise<result>
+export function command(bin: string, args: string[], options?: options & { sync: true }): result
+/**
+ * Run a command.
+ *
+ * This is a wrapper around `Deno.command` that provides a better handling of stdio for interactive processes.
+ *
+ * `stdin`, `stdout` and `stderr` can be set to allowed `Deno.command` values (`"inherit"`, `"null"`, `"piped"`),
+ * or can be set to a supported log level of `@libs/logger` library. In the later case, the content will be piped and
+ * logged to the specified level.
+ *
+ * Like `Deno.command`, it is possible to pass `env`, `cwd`, and `raw` (alias for `windowsRawArguments`).
+ *
+ * You can pass the `sync` option to run the process synchronously. Note that stdin is not usable in sync mode and will
+ * always be empty.
+ *
+ * You can pass the `throw` option to throw an error if the process exits with a non-zero code rather than returning a result.
+ *
+ * You can pass the `winext` option to append an extension to the binary path on Windows (like `.cmd` or `.exe`) when it won't
+ * automatically be resolved.
+ *
+ * Resulted object contains the same properties as `Deno.CommandStatus` with additional `stdio` property that contains an array
+ * of ordered tuples with the delta timestamp since process start, the channel (0:stdin, 1:stdout, 2:stderr) and the content.
+ * This allows to easily track the order of messages and have a proper history rather than a merged output.
+ *
+ * Additionally, you can buffer output using the `buffering` option to merge messages that are received relatively closely.
+ *
+ * Finally, you can pass a `callback` option to interact with the process stdin and stdout.
+ * This callback receives an object with the current stdio content, the current command index (based on the content written to stdin),
+ * along with a few additional methods:
+ * - `write(content: string, newline?: boolean): Promise<void>` encodes and writes content to stdin. It automatically appends a newline
+ * by default but can be toggled off by setting `newline` to `false`.
+ * - `close(): Promise<void>` closes stdin. Note that you **need** to eventually call this method to prevent most processes from hanging as
+ * they're waiting for more input.
+ * - `wait(dt: number): Promise<void>` waits for a given amount of time before calling the callback again. This can be useful for polling,
+ * like checking if a specific line has been written to stdio or not.
+ *
+ * The callback is called at each new line from piped channels, except that it is debounced by the `buffering` option which makes it more
+ * likely to send input when the process is actually expecting it.
+ *
+ * @example
+ * ```ts
+ * import { command } from "./command.ts"
+ * const { stdout } = await command("deno", ["repl"], {
+ *   env: { NO_COLOR: "true" },
+ *   callback: ({ i, write, close }) => i === 0 ? write("console.log('hello')") : close(),
+ * })
+ * console.assert(stdout.includes("hello"))
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { command } from "./command.ts"
+ * command("deno", ["eval", "Deno.exit(1)"], { throw: true, sync: true })
+ * ```
+ */
+export function command(bin: string, args: string[], { log = new Logger(), stdin = null, stdout = "debug", stderr = "error", env, cwd, raw, callback, buffering, sync, throw: _throw, winext = "", os = Deno.build.os } = {} as options): Promisable<result> {
+  if (os === "windows") {
+    bin = `${bin}${winext}`
+  }
+  log = log.with({ bin })
+  if (callback && (handle(stdin) !== "piped")) {
+    stdin = "piped"
+  }
+  const command = new Deno.Command(bin, { args, stdin: !sync ? handle(stdin) : "null", stdout: handle(stdout), stderr: handle(stderr), env, cwd, windowsRawArguments: raw })
+  if (sync) {
+    return exec(command, { bin, log, throw: _throw, stdout, stderr })
+  }
+  return spawn(command, { bin, log, callback, buffering, throw: _throw, stdin: handle(stdin) === "piped" ? stdin as loglevel : null, stdout: handle(stdout) === "piped" ? stdout as loglevel : null, stderr: handle(stderr) === "piped" ? stderr as loglevel : null })
+}
+
+/** Returns the handle type for a given mode. */
+function handle(mode: Nullable<string>) {
+  return ["inherit", "null"].includes(`${mode}`) ? `${mode}` as "inherit" | "null" : "piped"
+}
+
+/** Execute a command synchronously. */
+function exec(command: Deno.Command, { bin, log, throw: _throw, stdout, stderr }: { bin: string; log: Logger; throw?: boolean; stdout: Nullable<string>; stderr: Nullable<string> }) {
+  const start = Date.now()
+  const output = command.outputSync()
+  const { success, code } = output // Do not access stdout or stderr before "piped" status check
+  const t = Date.now() - start
+  const stdio = {
+    get stdio() {
+      return [[t, 1, this.stdout], [t, 2, this.stderr]]
+    },
+    stdin: "",
+    stdout: handle(stdout) === "piped" ? decoder.decode(output.stdout) : "",
+    stderr: handle(stderr) === "piped" ? decoder.decode(output.stderr) : "",
+  } as Pick<result, "stdio" | "stdin" | "stdout" | "stderr">
+  for (const { channel, mode } of [{ channel: "stdout", mode: stdout }, { channel: "stderr", mode: stderr }] as const) {
+    if ((handle(mode) === "piped") && (stdio[channel])) {
+      log.with({ t, channel })[mode as loglevel]?.(stdio[channel])
+    }
+  }
+  if ((!success) && _throw) {
+    throw new EvalError(`${bin} exited with non-zero code ${code}:\n${stdio.stdout}\n${stdio.stderr}`)
+  }
+  return { success, code, ...stdio }
+}
+
+/** Spawn a command asynchronously. */
+async function spawn(
+  command: Deno.Command,
+  { bin, log, callback = ({ close }) => close?.(), buffering = 250, throw: _throw, ...channels }: { bin: string; log: Logger; callback?: callback; buffering?: number; throw?: boolean; stdin: Nullable<loglevel>; stdout: Nullable<loglevel>; stderr: Nullable<loglevel> },
+) {
+  const process = command.spawn()
+  const start = Date.now()
+  const stdio = {
+    stdio: [],
+    get stdin() {
+      return this.stdio.filter(([_, i]) => i === 0).map(([_, __, content]) => content).join("\n")
+    },
+    get stdout() {
+      return this.stdio.filter(([_, i]) => i === 1).map(([_, __, content]) => content).join("\n")
+    },
+    get stderr() {
+      return this.stdio.filter(([_, i]) => i === 2).map(([_, __, content]) => content).join("\n")
+    },
+  } as Pick<result, "stdio" | "stdin" | "stdout" | "stderr">
+  const options = {} as Pick<Arg<callback>, "write" | "close" | "wait">
+  let last = ""
+  const debounced = debounce(async (t: number) => {
+    log.with({ t }).debug("debounced")
+    last = ""
+    await callback({ stdio, i: stdio.stdin.length, ...options })
+  }, buffering)
+  // Prepare stdin handlers if channel is piped
+  if (handle(channels.stdin) === "piped") {
+    const writer = process.stdin.getWriter()
+    Object.assign(options, {
+      async write(content: string, newline = true) {
+        const t = Date.now() - start
+        if (channels.stdin) {
+          log.with({ t, channel: "stdin" })[channels.stdin]?.(content)
+        }
+        stdio.stdio.push([t, 0, content])
+        if (newline && (!content.endsWith("\n"))) {
+          content += "\n"
+        }
+        await writer.write(encoder.encode(content))
+        last = "stdin"
+        writer.releaseLock()
+      },
+      async close() {
+        try {
+          writer.releaseLock()
+          await process.stdin.close()
+          log.with({ t: Date.now() - start, closed: "stdin" }).debug()
+        } catch {
+          // Ignore
+        }
+      },
+      async wait(dt = 1000) {
+        const t = Date.now() - start
+        log.with({ t, waiting: dt }).debug()
+        await delay(dt)
+        debounced(t)
+      },
+    })
+    debounced(Date.now() - start)
+  }
+  // Buffer output and debounce interaction callback
+  await Promise.all(
+    (["stdout", "stderr"] as const).filter((channel) => handle(channels[channel]) === "piped").map(async (channel) => {
+      for await (const line of process[channel].pipeThrough(new TextDecoderStream()).pipeThrough(new TextLineStream())) {
+        const t = Date.now() - start
+        const stdi = { stdout: 1, stderr: 2 }[channel] as 1 | 2
+        if (channels[channel]) {
+          log.with({ t, channel })[channels[channel]!]?.(line)
+        }
+        if ((stdio.stdio.length) && (last === channel)) {
+          const previous = stdio.stdio.at(-1)!
+          if (previous[1] === stdi) {
+            previous[2] += `\n${line}`
+          }
+        } else {
+          stdio.stdio.push([t, stdi, line])
+        }
+        last = channel
+        debounced(t)
+      }
+    }),
+  )
+  debounced.flush()
+  // Result
+  const { success, code } = await process.status
+  if ((!success) && _throw) {
+    throw new EvalError(`${bin} exited with non-zero code ${code}:\n${stdio.stdout}\n${stdio.stderr}`)
+  }
+  return { success, code, ...stdio }
+}

package/command_test.ts

@@ -0,0 +1,118 @@
+import { Logger } from "@libs/logger"
+import { command } from "./command.ts"
+import { expect, test, type testing } from "@libs/testing"
+
+test("deno")("command() can spawn subprocesses asynchronously", async () => {
+  let result = command("deno", ["--version"], { env: { NO_COLOR: "true" } }) as testing
+  expect(result).toBeInstanceOf(Promise)
+  result = await result
+  expect(result).toMatchObject({ success: true, code: 0, stdin: "", stderr: "" })
+  expect(result.stdio).toBeInstanceOf(Array)
+  expect(result.stdout).toMatch(/deno/)
+}, { permissions: { run: ["deno"] } })
+
+test("deno")("command() can spawn subprocesses synchronously", () => {
+  const result = command("deno", ["--version"], { env: { NO_COLOR: "true" }, sync: true })
+  expect(result).not.toBeInstanceOf(Promise)
+  expect(result).toMatchObject({ success: true, code: 0, stdin: "", stderr: "" })
+  expect(result.stdio).toBeInstanceOf(Array)
+  expect(result.stdout).toMatch(/deno/)
+}, { permissions: { run: ["deno"] } })
+
+test("deno")("command() handles callback<write()> and callback<close()> calls", async () => {
+  const result = await command("deno", ["repl"], { env: { NO_COLOR: "true" }, callback: ({ i, write, close }) => i === 0 ? write("console.log('hello')") : close() })
+  expect(result).toMatchObject({ success: true, code: 0, stdin: "console.log('hello')" })
+  expect(result.stdout).toMatch(/hello/)
+}, { permissions: { run: ["deno"] } })
+
+test("deno")("command() handles multiple callback<close()> calls", async () => {
+  const result = await command("deno", ["repl"], {
+    env: { NO_COLOR: "true" },
+    callback: async ({ close }) => {
+      await close()
+      await close()
+    },
+  })
+  expect(result).toMatchObject({ success: true, code: 0 })
+}, { permissions: { run: ["deno"] } })
+
+test("deno")("command() handles callback<wait()> calls", async () => {
+  let waited = false
+  const result = await command("deno", ["repl"], {
+    env: { NO_COLOR: "true" },
+    callback: ({ wait, close }) => waited ? close() : (waited = true, wait(250)),
+  })
+  expect(result).toMatchObject({ success: true, code: 0 })
+}, { permissions: { run: ["deno"] } })
+
+for (const sync of [false, true]) {
+  for (const mode of ["inherit", "piped", null, "debug", "log", "info", "warn", "error"] as const) {
+    test("deno")(`command() supports stdio set to "${mode}" in "${sync ? "sync" : "async"}" mode`, async () => {
+      const result = await command("deno", ["--version"], {
+        log: new Logger({ level: Logger.level.disabled }),
+        env: { NO_COLOR: "true" },
+        stdin: mode,
+        stdout: mode,
+        stderr: mode,
+        sync: sync as testing,
+      })
+      expect(result).toMatchObject({ success: true, code: 0 })
+    }, { permissions: { run: ["deno"] } })
+  }
+}
+
+test("deno")("command() handles both stdout and stderr channels", async () => {
+  const result = await command("deno", ["eval", "await Deno.stdout.write(new TextEncoder().encode(`foo\n`));await Deno.stderr.write(new TextEncoder().encode(`bar\n`))"], {
+    env: { NO_COLOR: "true" },
+    stdout: "piped",
+    stderr: "piped",
+  })
+  expect(result).toMatchObject({ success: true, code: 0, stdout: "foo", stderr: "bar" })
+}, { permissions: { run: ["deno"] } })
+
+test("deno")("command() supports buffering", async () => {
+  // Combined entries if buffering is greater than the time between writes
+  {
+    const result = await command("deno", ["eval", "console.log(`foo`);await new Promise(resolve => setTimeout(resolve, 100));console.log(`bar`)"], {
+      env: { NO_COLOR: "true" },
+      buffering: 150,
+    })
+    expect(result.stdio).toHaveLength(1)
+    expect(result.stdio[0][2]).toBe("foo\nbar")
+    expect(result.stdout).toBe("foo\nbar")
+  }
+  // Separated entries if buffering is less than the time between writes
+  {
+    const result = await command("deno", ["eval", "console.log(`foo`);await new Promise(resolve => setTimeout(resolve, 100));console.log(`bar`)"], {
+      env: { NO_COLOR: "true" },
+      buffering: 50,
+    })
+    expect(result.stdio).toHaveLength(2)
+    expect(result.stdio[0][2]).toBe("foo")
+    expect(result.stdio[1][2]).toBe("bar")
+    expect(result.stdout).toBe("foo\nbar")
+  }
+  // Separated entries even if buffering is active but channel was changed in-between
+  {
+    const result = await command("deno", [
+      "eval",
+      "await Deno.stdout.write(new TextEncoder().encode(`foo\n`));await Deno.stderr.write(new TextEncoder().encode(`baz\n`));await Deno.stdout.write(new TextEncoder().encode(`bar\n`))",
+    ], {
+      stdout: "piped",
+      stderr: "piped",
+      env: { NO_COLOR: "true" },
+      buffering: 200,
+    })
+    expect(result.stdio).toHaveLength(3)
+    expect(result.stdio[0][2]).toBe("foo")
+    expect(result.stdio[1][2]).toBe("baz")
+    expect(result.stdio[2][2]).toBe("bar")
+    expect(result.stdout).toBe("foo\nbar")
+    expect(result.stderr).toBe("baz")
+  }
+}, { permissions: { run: ["deno"] } })
+
+test("deno")("command() throws an error when `throw` option is enabled and exit code is non-zero", async () => {
+  expect(() => command("deno", ["eval", "Deno.exit(1)"], { env: { NO_COLOR: "true" }, throw: true, sync: true })).toThrow(EvalError)
+  await expect(command("deno", ["eval", "Deno.exit(1)"], { env: { NO_COLOR: "true" }, throw: true })).rejects.toThrow(EvalError)
+}, { permissions: { run: ["deno"] } })

package/deno.jsonc

@@ -0,0 +1,78 @@
+{
+  "icon": "⏯️",
+  "name": "@libs/run",
+  "version": "0.2.0",
+  "description": "Utilities to run subprocess.",
+  "keywords": [
+    "subprocess",
+    "esm"
+  ],
+  "license": "MIT License",
+  "author": "lowlighter (Simon Lecoq)",
+  "funding": "https://github.com/sponsors/lowlighter",
+  "homepage": "https://github.com/lowlighter/libs",
+  "playground": "https://libs.lecoq.io/run",
+  "supported": [
+    "deno"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lowlighter/libs.git"
+  },
+  "npm": true,
+  "exports": {
+    ".": "./mod.ts",
+    "./command": "./command.ts"
+  },
+  "imports": {
+    "@std/async/delay": "jsr:@std/async@0.224.1/delay",
+    "@std/async/debounce": "jsr:@std/async@0.224.1/debounce",
+    "@std/streams": "jsr:@std/streams@0.224.2",
+    "@libs/logger": "jsr:@libs/logger@1",
+    "@libs/testing": "jsr:@libs/testing@1",
+    "@libs/typing": "jsr:@libs/typing@2"
+  },
+  "test:permissions": {
+    "run": [
+      "deno",
+      "node",
+      "bun",
+      "npx"
+    ]
+  },
+  "tasks": {
+    "test": "deno test --allow-run=deno,node,bun,npx --no-prompt --coverage --clean --trace-leaks --doc",
+    "dev": "deno fmt && deno task test --filter='/^\\[deno\\]/' && deno coverage --exclude=.js --detailed && deno lint && deno publish --dry-run --quiet --allow-dirty",
+    "dev:future": "DENO_FUTURE=1 && deno task dev",
+    "coverage": "deno task test --filter='/^\\[deno\\]/' --quiet && deno coverage --exclude=.js",
+    "ci": "deno fmt --check && deno task test --filter='/^\\[node|bun \\]/' --quiet && deno coverage --exclude=.js && deno lint",
+    "ci:coverage": "deno task coverage --html && sleep 1 && mkdir -p ../coverage && rm -rf ../coverage/run && mv coverage/html ../coverage/run"
+  },
+  "lint": {
+    "rules": {
+      "include": [
+        "no-throw-literal",
+        "no-eval",
+        "eqeqeq",
+        "ban-untagged-todo"
+      ]
+    },
+    "exclude": [
+      "**/wasm_*",
+      "**/*.mjs"
+    ]
+  },
+  "fmt": {
+    "lineWidth": 280,
+    "semiColons": false,
+    "exclude": [
+      "coverage",
+      "**/coverage",
+      "**/node_modules",
+      "**/package.json",
+      "**/package-lock.json",
+      "**/wasm_*",
+      "**/*.mjs"
+    ]
+  }
+}

package/deno.lock

@@ -0,0 +1,100 @@
+{
+  "version": "3",
+  "packages": {
+    "specifiers": {
+      "jsr:@libs/logger@1": "jsr:@libs/logger@1.1.1",
+      "jsr:@libs/testing@1": "jsr:@libs/testing@1.0.7",
+      "jsr:@libs/typing@2": "jsr:@libs/typing@2.1.0",
+      "jsr:@std/assert@^0.224.0": "jsr:@std/assert@0.224.0",
+      "jsr:@std/assert@^0.225.3": "jsr:@std/assert@0.225.3",
+      "jsr:@std/async@0.224.1": "jsr:@std/async@0.224.1",
+      "jsr:@std/bytes@^0.224.0": "jsr:@std/bytes@0.224.0",
+      "jsr:@std/bytes@^1.0.0-rc.3": "jsr:@std/bytes@1.0.0-rc.3",
+      "jsr:@std/expect@0.224.0": "jsr:@std/expect@0.224.0",
+      "jsr:@std/fmt@^0.224.0": "jsr:@std/fmt@0.224.0",
+      "jsr:@std/internal@^0.224.0": "jsr:@std/internal@0.224.0",
+      "jsr:@std/io@^0.224.0": "jsr:@std/io@0.224.0",
+      "jsr:@std/path@0.225.1": "jsr:@std/path@0.225.1",
+      "jsr:@std/streams@0.224.2": "jsr:@std/streams@0.224.2",
+      "npm:@types/node": "npm:@types/node@18.16.19"
+    },
+    "jsr": {
+      "@libs/logger@1.1.1": {
+        "integrity": "7b74ca947062b955e8d63299f77a41fc4f2cf0a663a6ad836b703d601f622ccf"
+      },
+      "@libs/testing@1.0.7": {
+        "integrity": "b1a7caa9d2e00569f90b9753eb768ec6b16ff5c859f104b73a6ef4611968892e",
+        "dependencies": [
+          "jsr:@std/expect@0.224.0",
+          "jsr:@std/path@0.225.1"
+        ]
+      },
+      "@libs/typing@2.1.0": {
+        "integrity": "3c3b93e1da1e4bb45a22dde168fdfd1cc765edbdb371b46bf4ca7873ee79e15d"
+      },
+      "@std/assert@0.224.0": {
+        "integrity": "8643233ec7aec38a940a8264a6e3eed9bfa44e7a71cc6b3c8874213ff401967f"
+      },
+      "@std/assert@0.225.3": {
+        "integrity": "b3c2847aecf6955b50644cdb9cf072004ea3d1998dd7579fc0acb99dbb23bd4f"
+      },
+      "@std/async@0.224.1": {
+        "integrity": "2fda2c8151cc5811a6ca37fe825f1f71c95e02a374abb6ef868e0e19eca814a5"
+      },
+      "@std/bytes@0.224.0": {
+        "integrity": "a2250e1d0eb7d1c5a426f21267ab9bdeac2447fa87a3d0d1a467d3f7a6058e49"
+      },
+      "@std/bytes@1.0.0-rc.3": {
+        "integrity": "b3e93f73f1ccf167124f695596d2d026b0030930c38bd0ddec81d7f75ab41948"
+      },
+      "@std/expect@0.224.0": {
+        "integrity": "54bc071f7edcbd7bb4531f913e466e5ec3642f401dc3771fe5975f0693f25969",
+        "dependencies": [
+          "jsr:@std/assert@^0.224.0",
+          "jsr:@std/fmt@^0.224.0",
+          "jsr:@std/internal@^0.224.0"
+        ]
+      },
+      "@std/fmt@0.224.0": {
+        "integrity": "e20e9a2312a8b5393272c26191c0a68eda8d2c4b08b046bad1673148f1d69851"
+      },
+      "@std/internal@0.224.0": {
+        "integrity": "afc50644f9cdf4495eeb80523a8f6d27226b4b36c45c7c195dfccad4b8509291"
+      },
+      "@std/io@0.224.0": {
+        "integrity": "0aff885d21d829c050b8a08b1d71b54aed5841aecf227f8d77e99ec529a11e8e",
+        "dependencies": [
+          "jsr:@std/assert@^0.224.0",
+          "jsr:@std/bytes@^0.224.0"
+        ]
+      },
+      "@std/path@0.225.1": {
+        "integrity": "8c3220635a73730eb51fe43de9e10b79e2724a5bb8638b9355d35ae012fd9429"
+      },
+      "@std/streams@0.224.2": {
+        "integrity": "5d437af1423e4f616111b986ea783c15e0bc998b53e23e93b623de7ef0b14c2b",
+        "dependencies": [
+          "jsr:@std/assert@^0.225.3",
+          "jsr:@std/bytes@^1.0.0-rc.3",
+          "jsr:@std/io@^0.224.0"
+        ]
+      }
+    },
+    "npm": {
+      "@types/node@18.16.19": {
+        "integrity": "sha512-IXl7o+R9iti9eBW4Wg2hx1xQDig183jj7YLn8F7udNceyfkbn1ZxmzZXuak20gR40D7pIkIY1kYGx5VIGbaHKA==",
+        "dependencies": {}
+      }
+    }
+  },
+  "remote": {},
+  "workspace": {
+    "dependencies": [
+      "jsr:@libs/logger@1",
+      "jsr:@libs/testing@1",
+      "jsr:@libs/typing@2",
+      "jsr:@std/async@0.224.1",
+      "jsr:@std/streams@0.224.2"
+    ]
+  }
+}

package/mod.mjs

@@ -0,0 +1,33 @@
+var e=class e{constructor({level:t,format:n,output:o,tags:r,options:s}={}){if("granted"===globalThis.Deno?.permissions.querySync?.({name:"env",variable:"LOG_LEVEL"}).state){const n=globalThis.Deno?.env.get("LOG_LEVEL")??"";n in e.level&&(t??=e.level[n]),Number.isNaN(Number.parseInt(n))||(t??=Number.parseInt(n))}this.level=t??e.level.log,this.#e=o||null===o?o:console,this.#t=n??e.format.text,this.tags=r??{},this.options={date:!1,time:!1,delta:!0,...s,caller:!1!==s?.caller&&{file:!1,name:!1,line:!1,...s?.caller}}}level;#t;#e;tags;options;error(...t){return this.level>=e.level.error&&this.#e?.error(...this.#t(this,{level:e.level.error,content:t})),this}warn(...t){return this.level>=e.level.warn&&this.#e?.warn(...this.#t(this,{level:e.level.warn,content:t})),this}info(...t){return this.level>=e.level.info&&this.#e?.info(...this.#t(this,{level:e.level.info,content:t})),this}log(...t){return this.level>=e.level.log&&this.#e?.log(...this.#t(this,{level:e.level.log,content:t})),this}debug(...t){return this.level>=e.level.debug&&this.#e?.debug(...this.#t(this,{level:e.level.debug,content:t})),this}with(t={}){return new e({level:this.level,format:this.#t,output:this.#e,options:{...this.options},tags:{...this.tags,...t}})}#n(e=3){const t=Error,n=t.prepareStackTrace;t.prepareStackTrace=(e,t)=>t;const{stack:o}=new Error;t.prepareStackTrace=n;const r=o[e];return{file:r.getFileName(),name:r.getFunctionName(),line:r.getLineNumber(),column:r.getColumnNumber()}}static level=Object.freeze({disabled:NaN,error:0,warn:1,info:2,log:3,debug:4});static format={text(t,{level:n=0,content:o}){const r=["red","orange","cyan","white","gray"][n],s=[`%c ${Object.keys(e.level).find((t=>e.level[t]===n)).toLocaleUpperCase().padEnd(5)} │%c`],i=[`color: black; background-color: ${r}`,""];if(t.options.date||t.options.time||t.options.delta){const e=(new Date).toISOString(),n=[];if(t.options.delta){const e=performance.now()/1e3;let t=e.toPrecision(4);e<1&&(t=e.toPrecision(2)),n.push(`+${t}`)}t.options.date&&t.options.time?n.push(e):t.options.date?n.push(e.slice(0,e.indexOf("T"))):t.options.time&&n.push(e.slice(e.indexOf("T")+1,-1)),s.push(`%c ${n.join(" ¦ ").trim()} %c`),i.push(`color: black; background-color: ${r}`,"")}if(t.options.caller){const e=t.#n();if(e){const n=[];t.options.caller.file&&n.push(`${e.file.replace(t.options.caller.fileformat,"$<file>")}`),t.options.caller.name&&e.name&&n.push(e.name),t.options.caller.line&&n.push(e.line,e.column),s.push(`%c ${n.join(":").trim()} %c`),i.push("color: black; background-color: gray","")}}{const n=[];for(const[o,r]of Object.entries(t.tags))n.push(`${o}:${e.inspect(r)}`);s.push(`%c ${n.join(" ").trim()} %c`),i.push("background-color: black","")}return[s.join(""),...i,...o.map(e.inspect)]},json(t,{level:n=0,content:o}){const r={level:Object.keys(e.level).find((t=>e.level[t]===n)),timestamp:Date.now(),tags:t.tags,content:o},s={};if(t.options.date||t.options.time){const e=new Date(r.timestamp).toISOString();t.options.date&&(s.date=e.slice(0,e.indexOf("T"))),t.options.time&&(s.time=e.slice(e.indexOf("T")+1,-1))}if(t.options.delta&&(s.delta=performance.now()/1e3),t.options.caller){const e=t.#n();e&&(s.caller={},t.options.caller.file&&(s.caller.file=`${e.file.replace(t.options.caller.fileformat,"$<file>")}`),t.options.caller.name&&e.name&&(s.caller.name=e.name),t.options.caller.line&&(s.caller.line=[e.line,e.column]))}return[JSON.stringify({...r,...s})]}};static inspect(e){return globalThis.Deno?.inspect(e,{colors:!0,depth:1/0})??e}},t=class extends Error{constructor(e){super(e),this.name="AssertionError"}};TransformStream;function n(e){let t=0;for(const n of e)t+=n.length;const n=new Uint8Array(t);let o=0;for(const t of e)n.set(t,o),o+=t.length;return n}function o(e){const t=e.length,n=new Uint8Array(t);n[0]=0;let o=0,r=1;for(;r<t;)e[r]===e[o]?(o++,n[r]=o,r++):0===o?(n[r]=0,r++):o=n[o-1];return n}TransformStream,TransformStream,TransformStream,TransformStream;var r=class extends TransformStream{#o="";constructor(e={allowCR:!1}){super({transform:(t,n)=>{for(t=this.#o+t;;){const o=t.indexOf("\n"),r=e.allowCR?t.indexOf("\r"):-1;if(-1!==r&&r!==t.length-1&&(-1===o||o-1>r)){n.enqueue(t.slice(0,r)),t=t.slice(r+1);continue}if(-1===o)break;const s="\r"===t[o-1]?o-1:o;n.enqueue(t.slice(0,s)),t=t.slice(o+1)}this.#o=t},flush:t=>{if(""===this.#o)return;const n=e.allowCR&&this.#o.endsWith("\r")?this.#o.slice(0,-1):this.#o;t.enqueue(n)}})}};new TextDecoder;var s=new TextEncoder,i=new TextDecoder;function l(t,n,{log:o=new e,stdin:l=null,stdout:c="debug",stderr:u="error",env:d,cwd:p,raw:h,callback:f,buffering:m,sync:w,throw:g,winext:b="",os:v=Deno.build.os}={}){"windows"===v&&(t=`${t}${b}`),o=o.with({bin:t}),f&&"piped"!==a(l)&&(l="piped");const T=new Deno.Command(t,{args:n,stdin:w?"null":a(l),stdout:a(c),stderr:a(u),env:d,cwd:p,windowsRawArguments:h});return w?function(e,{bin:t,log:n,throw:o,stdout:r,stderr:s}){const l=Date.now(),c=e.outputSync(),{success:u,code:d}=c,p=Date.now()-l,h={get stdio(){return[[p,1,this.stdout],[p,2,this.stderr]]},stdin:"",stdout:"piped"===a(r)?i.decode(c.stdout):"",stderr:"piped"===a(s)?i.decode(c.stderr):""};for(const{channel:e,mode:t}of[{channel:"stdout",mode:r},{channel:"stderr",mode:s}])"piped"===a(t)&&h[e]&&n.with({t:p,channel:e})[t]?.(h[e]);if(!u&&o)throw new EvalError(`${t} exited with non-zero code ${d}:\n${h.stdout}\n${h.stderr}`);return{success:u,code:d,...h}}(T,{bin:t,log:o,throw:g,stdout:c,stderr:u}):async function(e,{bin:t,log:n,callback:o=(({close:e})=>e?.()),buffering:i=250,throw:l,...c}){const u=e.spawn(),d=Date.now(),p={stdio:[],get stdin(){return this.stdio.filter((([e,t])=>0===t)).map((([e,t,n])=>n)).join("\n")},get stdout(){return this.stdio.filter((([e,t])=>1===t)).map((([e,t,n])=>n)).join("\n")},get stderr(){return this.stdio.filter((([e,t])=>2===t)).map((([e,t,n])=>n)).join("\n")}},h={};let f="";const m=function(e,t){let n=null,o=null;const r=(...s)=>{r.clear(),o=()=>{r.clear(),e.call(r,...s)},n=setTimeout(o,t)};return r.clear=()=>{"number"==typeof n&&(clearTimeout(n),n=null,o=null)},r.flush=()=>{o?.()},Object.defineProperty(r,"pending",{get:()=>"number"==typeof n}),r}((async e=>{n.with({t:e}).debug("debounced"),f="",await o({stdio:p,i:p.stdin.length,...h})}),i);if("piped"===a(c.stdin)){const e=u.stdin.getWriter();Object.assign(h,{async write(t,o=!0){const r=Date.now()-d;c.stdin&&n.with({t:r,channel:"stdin"})[c.stdin]?.(t),p.stdio.push([r,0,t]),o&&!t.endsWith("\n")&&(t+="\n"),await e.write(s.encode(t)),f="stdin",e.releaseLock()},async close(){try{e.releaseLock(),await u.stdin.close(),n.with({t:Date.now()-d,closed:"stdin"}).debug()}catch{}},async wait(e=1e3){const t=Date.now()-d;n.with({t:t,waiting:e}).debug(),await function(e,t={}){const{signal:n,persistent:o=!0}=t;return n?.aborted?Promise.reject(n.reason):new Promise(((t,r)=>{const s=()=>{clearTimeout(i),r(n?.reason)},i=setTimeout((()=>{n?.removeEventListener("abort",s),t()}),e);if(n?.addEventListener("abort",s,{once:!0}),!1===o)try{Deno.unrefTimer(i)}catch(e){if(!(e instanceof ReferenceError))throw e;console.error("`persistent` option is only available in Deno")}}))}(e),m(t)}}),m(Date.now()-d)}await Promise.all(["stdout","stderr"].filter((e=>"piped"===a(c[e]))).map((async e=>{for await(const t of u[e].pipeThrough(new TextDecoderStream).pipeThrough(new r)){const o=Date.now()-d,r={stdout:1,stderr:2}[e];if(c[e]&&n.with({t:o,channel:e})[c[e]]?.(t),p.stdio.length&&f===e){const e=p.stdio.at(-1);e[1]===r&&(e[2]+=`\n${t}`)}else p.stdio.push([o,r,t]);f=e,m(o)}}))),m.flush();const{success:w,code:g}=await u.status;if(!w&&l)throw new EvalError(`${t} exited with non-zero code ${g}:\n${p.stdout}\n${p.stderr}`);return{success:w,code:g,...p}}(T,{bin:t,log:o,callback:f,buffering:m,throw:g,stdin:"piped"===a(l)?l:null,stdout:"piped"===a(c)?c:null,stderr:"piped"===a(u)?u:null})}function a(e){return["inherit","null"].includes(`${e}`)?`${e}`:"piped"}export{l as command};
+/**
+ * Logger library
+ *
+ * It is intended to supersed {@link https://developer.mozilla.org/en-US/docs/Web/API/console | console} by providing:
+ * - Colored output
+ * - Log levels
+ * - Tags
+ * - Timestamps
+ * - Delta
+ * - Caller information
+ * - Log formatters
+ *
+ * @example
+ * ```ts
+ * import { Logger } from "./mod.ts"
+ *
+ * // Configure logger
+ * const tags = { foo: true, bar: "string" }
+ * const options = { date: true, time: true, delta: true, caller: { file: true, fileformat: /.*\/(?<file>libs\/.*)$/, name: true, line: true } }
+ * const log = new Logger({ level: Logger.level.debug, options, tags })
+ *
+ * // Print logs
+ * log.error("🍱 bento")
+ * log.warn("🍜 ramen")
+ * log.info("🍣 sushi")
+ * log.log("🍥 narutomaki")
+ * log.debug("🍡 dango")
+ * ```
+ *
+ * @author Simon Lecoq (lowlighter)
+ * @license MIT
+ */

package/mod.ts

@@ -0,0 +1 @@
+export * from "./command.ts"

package/mod_test.ts

@@ -0,0 +1 @@
+import "./mod.ts"

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@lowlighter/run",
+  "version": "0.2.0",
+  "type": "module",
+  "scripts": {},
+  "description": "Utilities to run subprocess.",
+  "keywords": [
+    "subprocess",
+    "esm"
+  ],
+  "license": "MIT License",
+  "author": "lowlighter (Simon Lecoq)",
+  "homepage": "https://github.com/lowlighter/libs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lowlighter/libs.git"
+  },
+  "funding": "https://github.com/sponsors/lowlighter",
+  "exports": {
+    ".": "./mod.mjs",
+    "./command": "./command.mjs"
+  }
+}