justinawrey/bash

Ergonomically run bash commands in Deno.

bash 🥊

Ergonomically run bash commands in Deno.

Usage

Run any bash command:

import { bash } from "https://deno.land/x/bash/mod.ts";

const result = await bash("echo 'hello world'");
console.log(result); // hello world

If the underlying command fails, bash will throw an error:

import { bash, BashError } from "https://deno.land/x/bash/mod.ts";

try {
  const result = await bash("laskdjf");
} catch (error) {
  if (error instanceof BashError) {
    console.error(error.message);
  }
}

By default, bash will strip the trailing newline from both the stdout output and stderr output. If you want to disable this behavior, pass { stripTrailingNewline: true } as the second argument:

import { bash } from "https://deno.land/x/bash/mod.ts";

const result = await bash("echo 'hello world'", { stripTrailingNewline: true });
console.log(result); // hello world\n

Required permissions

Using bash requires the --allow-run permission. This is because bash uses Deno.run to execute the underlying command.