test(*): add a basic set of test cases

Author: andrewbrey

.github/workflows/lint-and-test.yaml

@@ -22,4 +22,4 @@ jobs:
         run: deno lint --unstable
 
       - name: Run tests
-        run: deno test --unstable --allow-read --allow-env --allow-run
+        run: deno test --unstable --shuffle --allow-read --allow-env --allow-run --allow-write

.gitignore

@@ -1,2 +1,3 @@
 .idea
-.vscode
+.vscode
+.tmp/

src/runtime/mod.ts

@@ -3,6 +3,9 @@ import { cd } from "./cd.ts";
 import { exec } from "./exec.ts";
 import { quote } from "./quote.ts";
 
+export { ProcessError } from "./process_error.ts";
+export { ProcessOutput } from "./process_output.ts";
+
 export type $Global = typeof exec & typeof colors & {
   shell: string;
   prefix: string;

test.ts

@@ -1,11 +1,64 @@
 /// <reference path="./types.d.ts" />
 
-import { assertEquals } from "https://deno.land/[email protected]/testing/asserts.ts";
+import {
+  assert,
+  assertEquals,
+  assertThrowsAsync,
+} from "https://deno.land/[email protected]/testing/asserts.ts";
 
-import { $ } from "./mod.ts";
+import { $, cd, path, ProcessError } from "./mod.ts";
 
 Deno.test("$ works", async () => {
   const result = await $`echo hello`;
 
   assertEquals(result.stdout, "hello\n");
 });
+
+Deno.test("passing environment variables to the child process", async () => {
+  Deno.env.set("IS_THIS_THING_ON", "yes");
+  const result = await $`echo $IS_THIS_THING_ON`;
+
+  assertEquals(result.stdout, "yes\n");
+});
+
+Deno.test("escape and quote arguments", async () => {
+  const complexArg = 'bar"";baz!$#^$\'&*~*%)({}||\\/';
+  const result = (await $`echo ${complexArg}`);
+
+  assertEquals(result.stdout.trim(), complexArg);
+});
+
+Deno.test("create a directory with a space in the name", async () => {
+  const now = Date.now();
+  const path = `./.tmp/test_${now}/foo bar`;
+
+  try {
+    await $`mkdir -p ${path}`;
+    assert((await Deno.stat(path)).isDirectory);
+  } finally {
+    await Deno.remove(`./.tmp`, { recursive: true });
+  }
+});
+
+Deno.test("subprocess command failure throws a ProcessError", async () => {
+  await assertThrowsAsync(async () => await $`somefakebinary`, ProcessError);
+});
+
+Deno.test("cwd of the parent process is always the starting point for calls to cd", async () => {
+  const parentPwd = Deno.cwd();
+
+  try {
+    const testStartingDir = path.dirname(path.fromFileUrl(import.meta.url));
+    Deno.chdir(testStartingDir);
+
+    cd("src");
+    const pwd1 = await $`pwd`;
+    assertEquals(pwd1.stdout.trim(), path.join(testStartingDir, "src"));
+
+    cd(".github");
+    const pwd2 = await $`pwd`;
+    assertEquals(pwd2.stdout.trim(), path.join(testStartingDir, ".github"));
+  } finally {
+    Deno.chdir(parentPwd);
+  }
+});