progress

deps/std/flags.ts

@@ -1 +1 @@
-export { parse } from "https://deno.land/std@0.114.0/flags/mod.ts";
+export { parse } from "https://deno.land/std@0.116.0/flags/mod.ts";

deps/std/fs.ts

@@ -1 +1 @@
-export { exists, expandGlob } from "https://deno.land/std@0.114.0/fs/mod.ts";
+export { exists, expandGlob } from "https://deno.land/std@0.116.0/fs/mod.ts";

deps/std/path.ts

@@ -5,4 +5,4 @@ export {
   join,
   normalize,
   parse,
-} from "https://deno.land/std@0.114.0/path/mod.ts";
+} from "https://deno.land/std@0.116.0/path/mod.ts";

deps/std/testing.ts

@@ -2,13 +2,13 @@ export {
   assert,
   assertEquals,
   assertThrows,
-} from "https://deno.land/std@0.114.0/testing/asserts.ts";
+} from "https://deno.land/std@0.116.0/testing/asserts.ts";
 export {
   bench,
   runBenchmarks,
-} from "https://deno.land/std@0.114.0/testing/bench.ts";
+} from "https://deno.land/std@0.116.0/testing/bench.ts";
 export type {
   BenchmarkResult,
   BenchmarkRunProgress,
   BenchmarkTimer,
-} from "https://deno.land/std@0.114.0/testing/bench.ts";
+} from "https://deno.land/std@0.116.0/testing/bench.ts";

docs/getting-started.md

@@ -8,3 +8,10 @@ self_link: https://fart.tools/getting-started
 > Fart deserves better!
 
 > Curious reader, visit <https://fart.tools/getting-started/>.
+
+## Project Scripts
+
+- **Upgrade a Dependency**: `deno run --unstable --allow-read --allow-write devops/upgrade_dep.ts -y --verbose --dep=std --v=0.116.0`
+- **Run the CLI**: `deno run --allow-read --allow-write fart_cli/run.ts ./ex/pokemon/mod.fart --reg=ts --output=./ex/pokemon/mod.out.ts`
+- **Spin up Server**: `deno run --allow-net --allow-read --allow-env --unstable fart_server/serve_http.ts`
+- **Develop the Server**: `deployctl run --watch fart_server/worker.ts`

lib/cartridge/cartridge.test.ts

@@ -1,6 +1,7 @@
 import { assertEquals } from "../../deps/std/testing.ts";
 import { Cartridge } from "./cartridge.ts";
 import { CartridgeEvent } from "./cartridge_event.ts";
+import { CodeBlock } from "../code_block/mod.ts";
 
 /**
  * @todo @ethanthatonekid write tests that reflect cartridge api design/usage
@@ -13,3 +14,20 @@ Deno.test("hello world", () => {
   cartridge.on(CartridgeEvent.FileStart, console.log);
   assertEquals(1, 1);
 });
+
+Deno.test("event 'file_start' makes a successful dispatch", async () => {
+  const cartridge = new Cartridge();
+  cartridge.on(CartridgeEvent.FileStart, (event) => {
+    assertEquals(event.type, CartridgeEvent.FileStart, "matches event name");
+    assertEquals(event.tokens.length, 0, "expects 0 tokens");
+    assertEquals(event.data, null, "always null");
+    return "ABC";
+  });
+  const result = await cartridge.dispatch(CartridgeEvent.FileStart, {
+    type: CartridgeEvent.FileStart,
+    code: new CodeBlock(),
+    data: null,
+    tokens: [],
+  });
+  assertEquals(result, "ABC");
+});

lib/text_builder/text_builder.test.ts

@@ -0,0 +1,10 @@
+import { assertEquals } from "../../deps/std/testing.ts";
+import { TextBuilder } from "./text_builder.ts";
+import { Cartridge } from "../cartridge/mod.ts";
+
+const dummy = new Cartridge();
+
+Deno.test("text builder exports an empty string when nothing is appended", () => {
+  const builder = new TextBuilder(dummy);
+  assertEquals(builder.export(), "");
+});