add arg parser

src/args.ts

@@ -1,9 +1,98 @@
+import * as E from "fp-ts/lib/Either";
+import * as O from "fp-ts/lib/Option";
+import * as R from "fp-ts/lib/ReadonlyArray";
+import { pipe } from "fp-ts/lib/function";
+import { parseTestType, type TestType } from "./canary";
+
 export interface Args {
-  testFile: string;
+  readonly testsFile: string;
+  readonly testName: O.Option<string>;
+  readonly testType: O.Option<TestType>;
 }
 
-export const parseArgs = (argv: string[]): Args => {
+interface ArgsBuilder {
-  const useful = argv.slice(2); // skip bun path and script path
+  readonly testsFile: O.Option<string>;
+  readonly testName: O.Option<string>;
+  readonly testType: O.Option<string>;
+}
 
-  const flags = useful.map((x, i) => x.startsWith("--") && i);
+type ArgsBuilderField = (arg: string) => (builder: ArgsBuilder) => ArgsBuilder;
+
+const createArgsBuilder = (): ArgsBuilder => ({
+  testsFile: O.none,
+  testName: O.none,
+  testType: O.none,
+});
+
+const withTestsFile: ArgsBuilderField = (testsFile) => (builder) => ({
+  ...builder,
+  testsFile: O.some(testsFile),
+});
+
+const withTestName: ArgsBuilderField = (testName) => (builder) => ({
+  ...builder,
+  testName: O.some(testName),
+});
+
+const withTestType: ArgsBuilderField = (testType) => (builder) => ({
+  ...builder,
+  testType: O.some(testType),
+});
+
+const flagBuilders: Record<string, ArgsBuilderField> = {
+  "--tests-file": withTestsFile,
+  "--test-name": withTestName,
+  "--test-type": withTestType,
+};
+
+const buildArgs = (builder: ArgsBuilder): E.Either<string, Args> => {
+  if (O.isNone(builder.testsFile)) {
+    return E.left("please specify a test file");
+  }
+
+  const testType = pipe(builder.testType, O.flatMap(parseTestType));
+  if (O.isSome(builder.testType) && !O.isSome(testType)) {
+    return E.left("bad test type " + builder.testType.value);
+  }
+
+  return E.right({
+    testsFile: builder.testsFile.value,
+    testName: builder.testName,
+    testType,
+  });
+};
+
+const isArg = (arg: string) => arg.startsWith("--") && arg in flagBuilders;
+
+export const parseArgs = (argv: string[]): E.Either<string, Args> => {
+  if (argv.length < 2) return E.left("bad argv");
+
+  const useful = argv.slice(2);
+  const argApplicators = pipe(
+    useful,
+    R.mapWithIndex((i, arg) => (isArg(arg) ? O.some({ arg, i }) : O.none)),
+    R.compact,
+    R.map(({ arg, i }) =>
+      pipe(
+        O.fromNullable(flagBuilders[arg]),
+        O.bindTo("argApplicator"),
+        O.bind("val", () =>
+          pipe(
+            O.fromNullable(useful.at(i + 1)),
+            O.flatMap((argValue) =>
+              isArg(argValue) ? O.none : O.some(argValue),
+            ),
+          ),
+        ),
+        O.map(({ val, argApplicator }) => argApplicator(val)),
+      ),
+    ),
+  );
+
+  return pipe(
+    argApplicators,
+    R.compact,
+    R.reduce(createArgsBuilder(), (builder, applyArgTo) => applyArgTo(builder)),
+    buildArgs,
+  );
 };

src/canary/testable.ts

@@ -1,4 +1,5 @@
-import type { TaskEither } from "fp-ts/lib/TaskEither";
+import * as TE from "fp-ts/lib/TaskEither";
+import * as O from "fp-ts/lib/Option";
 import type { Job } from "./job";
 import type { D } from "../util";
 
@@ -9,6 +10,11 @@ export enum TestType {
   DNS = "dns",
 }
 
+export const parseTestType = (testType: string): O.Option<TestType> =>
+  Object.values(TestType).includes(testType as TestType)
+    ? O.some(testType as TestType)
+    : O.none;
+
 export interface Schedule {
   every: D.Duration;
   jitter: D.Duration;
@@ -21,4 +27,4 @@ export interface Test {
   schedule: Schedule;
 }
 
-export type Testable<T extends Job> = (job: T) => TaskEither<Error, boolean>;
+export type Testable<T extends Job> = (job: T) => TE.TaskEither<Error, boolean>;

src/config.ts

@@ -1,11 +1,13 @@
 import * as IO from "fp-ts/IO";
 import type { Publisher } from "./publisher";
 import { readFileSync } from "fs";
+import type { Test } from "./canary";
 
 export interface Config {
   result_publishers: Publisher[];
   dns: string[];
-  timeout: string;
+  http_timeout: string;
+  tests: Test[];
 }
 
 export const readConfig =

src/index.ts

@@ -1,5 +1,6 @@
 import * as IO from "fp-ts/IO";
-import { readFileSync } from "fs";
+import { ConsoleLogger } from "./util";
+import { readFileSync } from "node:fs";
 
 const main: IO.IO<void> = ConsoleLogger.log("Hello, world!");
 

src/util/duration.ts

@@ -1,6 +1,6 @@
 import { flow, pipe } from "fp-ts/function";
-import * as E from "fp-ts/Either";
+import * as E from "fp-ts/lib/Either";
-import * as S from "fp-ts/String";
+import * as S from "fp-ts/lib/string";
 import * as O from "fp-ts/lib/Option";
 import * as R from "fp-ts/lib/ReadonlyArray";
 
@@ -60,30 +60,30 @@ export const createDurationBuilder = (): DurationBuilder => ({
   hours: 0,
 });
 
-export const withMillis =
+export type DurationBuilderField<T> = (
-  (millis: number) =>
+  arg: T,
-  (builder: DurationBuilder): DurationBuilder => ({
+) => (builder: DurationBuilder) => DurationBuilder;
+
+export const withMillis: DurationBuilderField<number> =
+  (millis) => (builder) => ({
     ...builder,
     millis,
   });
 
-export const withSeconds =
+export const withSeconds: DurationBuilderField<number> =
-  (seconds: number) =>
+  (seconds) => (builder) => ({
-  (builder: DurationBuilder): DurationBuilder => ({
     ...builder,
     seconds,
   });
 
-export const withMinutes =
+export const withMinutes: DurationBuilderField<number> =
-  (minutes: number) =>
+  (minutes) => (builder) => ({
-  (builder: DurationBuilder): DurationBuilder => ({
     ...builder,
     minutes,
   });
 
-export const withHours =
+export const withHours: DurationBuilderField<number> =
-  (hours: number) =>
+  (hours) => (builder) => ({
-  (builder: DurationBuilder): DurationBuilder => ({
     ...builder,
     hours,
   });
@@ -99,7 +99,7 @@ export const parse = (duration: string): E.Either<string, Duration> => {
     duration,
     S.split(" "),
     R.map(S.trim),
-    R.filter((part) => !S.isEmpty(part))
+    R.filter((part) => !S.isEmpty(part)),
   );
 
   const valueUnitPairs = pipe(
@@ -120,9 +120,9 @@ export const parse = (duration: string): E.Either<string, Duration> => {
     E.map(
       flow(
         R.filter(O.isSome),
-        R.map(({ value }) => value)
+        R.map(({ value }) => value),
-      )
+      ),
-    )
+    ),
   );
 
   return pipe(
@@ -146,10 +146,10 @@ export const parse = (duration: string): E.Either<string, Duration> => {
                 default:
                   return E.left(`unknown unit: ${unit}`);
               }
-            })
+            }),
-          )
+          ),
-      )
+      ),
     ),
-    E.map(build)
+    E.map(build),
   );
 };

tst/args.spec.ts

@@ -0,0 +1,104 @@
+import { test, expect } from "bun:test";
+import * as E from "fp-ts/lib/Either";
+import * as O from "fp-ts/lib/Option";
+import { parseArgs, type Args } from "../src/args";
+import { TestType } from "../src/canary";
+
+test("should return an error if argv has less than 2 arguments", () => {
+  const result = parseArgs([]);
+  expect(E.isLeft(result)).toBe(true);
+  expect(E.left<string, Args>("bad argv")).toEqual(result);
+});
+
+test("should return an error if --tests-file is not specified", () => {
+  const result = parseArgs(["node", "script.js", "--test-name", "test"]);
+  expect(E.isLeft(result)).toBe(true);
+  expect(E.left<string, Args>("please specify a test file")).toEqual(result);
+});
+
+test("should return an error if test type is invalid", () => {
+  const result = parseArgs([
+    "bun",
+    "script.js",
+    "--tests-file",
+    "testFile",
+    "--test-type",
+    "invalidType",
+  ]);
+  expect(E.isLeft(result)).toBe(true);
+  expect(E.left<string, Args>("bad test type invalidType")).toEqual(result);
+});
+
+test("should parse arguments correctly with all options specified", () => {
+  const result = parseArgs([
+    "node",
+    "script.js",
+    "--tests-file",
+    "testFile",
+    "--test-name",
+    "testName",
+    "--test-type",
+    "dns",
+  ]);
+
+  const expected: Args = {
+    testsFile: "testFile",
+    testName: O.some("testName"),
+    testType: O.some(TestType.DNS),
+  };
+
+  expect(E.isRight(result)).toBe(true);
+  expect(E.right<string, Args>(expected)).toEqual(result);
+});
+
+test("should parse arguments correctly with only testsFile specified", () => {
+  const result = parseArgs(["node", "script.js", "--tests-file", "testFile"]);
+
+  const expected: Args = {
+    testsFile: "testFile",
+    testName: O.none,
+    testType: O.none,
+  };
+
+  expect(E.isRight(result)).toBe(true);
+  expect(E.right<string, Args>(expected)).toEqual(result);
+});
+
+test("should handle missing values for flags gracefully", () => {
+  const result = parseArgs([
+    "node",
+    "script.js",
+    "--tests-file",
+    "testFile",
+    "--test-name",
+  ]);
+
+  const expected: Args = {
+    testsFile: "testFile",
+    testName: O.none,
+    testType: O.none,
+  };
+
+  expect(E.isRight(result)).toBe(true);
+  expect(E.right<string, Args>(expected)).toEqual(result);
+});
+
+test("should not parse args as values", () => {
+  const result = parseArgs([
+    "node",
+    "script.js",
+    "--tests-file",
+    "testFile",
+    "--test-name",
+    "--tests-file",
+  ]);
+
+  const expected: Args = {
+    testsFile: "testFile",
+    testName: O.none,
+    testType: O.none,
+  };
+
+  expect(E.isRight(result)).toBe(true);
+  expect(E.right<string, Args>(expected)).toEqual(result);
+});