gestament 0.3.0 → 0.5.0

package/dist/gestament.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gestament.mjs","sources":["../src/gestament.ts"],"sourcesContent":["#!/usr/bin/env node\n// gestament - TypeScript based test driver for GTK.\n// Copyright (c) Kouji Matsui. (@kekyo@mi.kekyo.net)\n// Under MIT.\n// https://github.com/kekyo/gestament\n\nimport { realpathSync } from 'node:fs';\nimport { mkdir, stat, writeFile } from 'node:fs/promises';\nimport { basename, join, relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { version as packageVersion } from './generated/packageMetadata';\n\n/////////////////////////////////////////////////////////////////////////////////////////\n\n/** Result returned by the gestament CLI runner. */\nexport interface GestamentCliOutput {\n  /** Process exit code. */\n  readonly exitCode: 0 | 2;\n\n  /** Text to write to stderr. */\n  readonly stderr: string;\n\n  /** Text to write to stdout. */\n  readonly stdout: string;\n}\n\ninterface InitOptions {\n  readonly directory: string | undefined;\n  readonly force: boolean;\n  readonly name: string | undefined;\n}\n\ninterface ScaffoldFile {\n  readonly content: string;\n  readonly path: string;\n}\n\nconst fallbackPackageName = 'gestament-tests';\nconst packageNamePattern =\n  /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u;\n\nconst usageText = [\n  'Usage: gestament init [directory] [--name <package-name>] [--force]',\n  '       gestament init --help',\n  '       gestament --help',\n  '',\n  'Creates a minimal Vitest project for gestament GTK tests.',\n  '',\n].join('\\n');\n\nconst gitIgnoreExampleText = [\n  'node_modules/',\n  'test-results/',\n  'coverage/',\n  '*.log',\n  '',\n].join('\\n');\n\nconst tsconfigText = `${JSON.stringify(\n  {\n    compilerOptions: {\n      target: 'ES2020',\n      module: 'ESNext',\n      lib: ['ES2020'],\n      moduleResolution: 'Bundler',\n      strict: true,\n      skipLibCheck: true,\n      noEmit: true,\n    },\n    include: ['tests', 'vitest.config.ts'],\n  },\n  undefined,\n  2\n)}\\n`;\n\nconst vitestConfigText = [\n  \"import { defineConfig } from 'vitest/config';\",\n  '',\n  'export default defineConfig({',\n  '  test: {',\n  '    globals: true,',\n  \"    environment: 'node',\",\n  \"    include: ['tests/**/*.test.ts'],\",\n  '    coverage: {',\n  '      enabled: false,',\n  '    },',\n  '  },',\n  '});',\n  '',\n].join('\\n');\n\nconst isNotFoundError = (error: unknown): boolean =>\n  typeof error === 'object' &&\n  error !== null &&\n  'code' in error &&\n  (error as { readonly code?: string }).code === 'ENOENT';\n\nconst statIfExists = async (\n  path: string\n): Promise<\n  | {\n      readonly isDirectory: () => boolean;\n    }\n  | undefined\n> => {\n  try {\n    return await stat(path);\n  } catch (error) {\n    if (isNotFoundError(error)) {\n      return undefined;\n    }\n    throw error;\n  }\n};\n\nconst normalizePackageName = (value: string): string => {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9._-]+/gu, '-')\n    .replace(/^[._-]+|[._-]+$/gu, '');\n  return normalized.length === 0 ? fallbackPackageName : normalized;\n};\n\nconst isValidPackageName = (value: string): boolean =>\n  value.length <= 214 &&\n  !value.startsWith('.') &&\n  !value.startsWith('_') &&\n  packageNamePattern.test(value);\n\nconst createPackageJsonText = (name: string): string =>\n  `${JSON.stringify(\n    {\n      name,\n      version: '0.0.1',\n      private: true,\n      scripts: {\n        test: 'vitest run',\n      },\n      devDependencies: {\n        '@types/node': '>=20.0.0',\n        gestament: `^${packageVersion}`,\n        typescript: '>=5.7.0',\n        vitest: '>=3.2.0',\n      },\n    },\n    undefined,\n    2\n  )}\\n`;\n\nconst createScaffoldFiles = (name: string): readonly ScaffoldFile[] => [\n  {\n    content: createPackageJsonText(name),\n    path: 'package.json',\n  },\n  {\n    content: tsconfigText,\n    path: 'tsconfig.json',\n  },\n  {\n    content: vitestConfigText,\n    path: 'vitest.config.ts',\n  },\n  {\n    content: gitIgnoreExampleText,\n    path: '.gitignore.gestament-example',\n  },\n];\n\nconst createHelpOutput = (): GestamentCliOutput => ({\n  exitCode: 0,\n  stderr: '',\n  stdout: usageText,\n});\n\nconst createUsageError = (message: string): GestamentCliOutput => ({\n  exitCode: 2,\n  stderr: `${message}\\nRun \"gestament --help\" for usage.\\n`,\n  stdout: '',\n});\n\nconst parseInitOptions = (\n  args: readonly string[]\n): InitOptions | GestamentCliOutput => {\n  let directory: string | undefined;\n  let force = false;\n  let name: string | undefined;\n  let index = 0;\n\n  while (index < args.length) {\n    const argument = args[index];\n    if (argument === undefined) {\n      break;\n    }\n\n    if (argument === '--help' || argument === '-h') {\n      return createHelpOutput();\n    }\n\n    if (argument === '--force') {\n      force = true;\n      index += 1;\n      continue;\n    }\n\n    if (argument === '--name') {\n      const value = args[index + 1];\n      if (value === undefined) {\n        return createUsageError('gestament init: --name requires a value.');\n      }\n      name = value;\n      index += 2;\n      continue;\n    }\n\n    if (argument.startsWith('--name=')) {\n      name = argument.slice('--name='.length);\n      index += 1;\n      continue;\n    }\n\n    if (argument.startsWith('-')) {\n      return createUsageError(`gestament init: unknown option: ${argument}`);\n    }\n\n    if (directory !== undefined) {\n      return createUsageError(\n        `gestament init: unexpected argument: ${argument}`\n      );\n    }\n\n    directory = argument;\n    index += 1;\n  }\n\n  return {\n    directory,\n    force,\n    name,\n  };\n};\n\nconst createRelativePathList = (\n  cwd: string,\n  paths: readonly string[]\n): readonly string[] =>\n  paths.map((path) => {\n    const relativePath = relative(cwd, path);\n    return relativePath.length === 0 ? '.' : relativePath;\n  });\n\nconst collectCollisions = async (\n  targetDirectory: string,\n  files: readonly ScaffoldFile[]\n): Promise<readonly string[]> => {\n  const collisions: string[] = [];\n\n  for (const file of files) {\n    const filePath = join(targetDirectory, file.path);\n    if ((await statIfExists(filePath)) !== undefined) {\n      collisions.push(filePath);\n    }\n  }\n\n  const testsPath = join(targetDirectory, 'tests');\n  const testsStat = await statIfExists(testsPath);\n  if (testsStat !== undefined && !testsStat.isDirectory()) {\n    collisions.push(testsPath);\n  }\n\n  return collisions;\n};\n\nconst writeScaffold = async (\n  targetDirectory: string,\n  files: readonly ScaffoldFile[]\n): Promise<void> => {\n  await mkdir(targetDirectory, { recursive: true });\n  await mkdir(join(targetDirectory, 'tests'), { recursive: true });\n\n  for (const file of files) {\n    await writeFile(join(targetDirectory, file.path), file.content);\n  }\n};\n\nconst runInitCommand = async (\n  args: readonly string[],\n  cwd: string\n): Promise<GestamentCliOutput> => {\n  const parsed = parseInitOptions(args);\n  if ('exitCode' in parsed) {\n    return parsed;\n  }\n\n  if (parsed.name !== undefined && !isValidPackageName(parsed.name)) {\n    return createUsageError(\n      `gestament init: invalid package name: ${parsed.name}`\n    );\n  }\n\n  const directoryArgument = parsed.directory ?? '.';\n  const targetDirectory = resolve(cwd, directoryArgument);\n  const packageName =\n    parsed.name ?? normalizePackageName(basename(targetDirectory));\n  const files = createScaffoldFiles(packageName);\n\n  await mkdir(targetDirectory, { recursive: true });\n\n  if (!parsed.force) {\n    const collisions = await collectCollisions(targetDirectory, files);\n    if (collisions.length > 0) {\n      return {\n        exitCode: 2,\n        stderr: [\n          'gestament init: refusing to overwrite existing scaffold paths:',\n          ...createRelativePathList(cwd, collisions).map((path) => `  ${path}`),\n          'Run \"gestament init --force\" to overwrite generated files.',\n          '',\n        ].join('\\n'),\n        stdout: '',\n      };\n    }\n  }\n\n  await writeScaffold(targetDirectory, files);\n\n  return {\n    exitCode: 0,\n    stderr: '',\n    stdout: [\n      `Created a gestament test project in ${directoryArgument}.`,\n      '',\n      'Next steps:',\n      `  cd ${directoryArgument}`,\n      '  npm install',\n      '  npm test',\n      '',\n    ].join('\\n'),\n  };\n};\n\n/**\n * Runs the gestament command line interface.\n *\n * @param args Command line arguments after the executable name.\n * @param cwd Current working directory used to resolve generated paths.\n * @returns CLI output and exit code.\n */\nexport const runGestamentCli = async (\n  args: readonly string[],\n  cwd: string\n): Promise<GestamentCliOutput> => {\n  const command = args[0];\n  if (command === undefined) {\n    return createUsageError('gestament: missing command.');\n  }\n\n  if (command === '--help' || command === '-h') {\n    return createHelpOutput();\n  }\n\n  if (command !== 'init') {\n    return createUsageError(`gestament: unknown command: ${command}`);\n  }\n\n  return await runInitCommand(args.slice(1), cwd);\n};\n\nconst isMainModule = (): boolean => {\n  const executablePath = process.argv[1];\n  if (executablePath === undefined) {\n    return false;\n  }\n\n  return (\n    realpathSync(executablePath) ===\n    realpathSync(fileURLToPath(import.meta.url))\n  );\n};\n\nconst run = async (): Promise<void> => {\n  const output = await runGestamentCli(process.argv.slice(2), process.cwd());\n  process.stdout.write(output.stdout);\n  process.stderr.write(output.stderr);\n  process.exitCode = output.exitCode;\n};\n\n/////////////////////////////////////////////////////////////////////////////////////////\n\nif (isMainModule()) {\n  run().catch((error: unknown) => {\n    const message = error instanceof Error ? error.message : String(error);\n    process.stderr.write(`gestament: ${message}\\n`);\n    process.exitCode = 2;\n  });\n}\n"],"names":["packageVersion"],"mappings":"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"}

package/dist/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const launchGtkApp = require("./launchGtkApp-BIO_5Xjn.cjs");
+const launchGtkApp = require("./launchGtkApp-CzYcrc9f.cjs");
 exports.createGtkAppEnvironment = launchGtkApp.createGtkAppEnvironment;
 exports.createGtkAppLauncher = launchGtkApp.createGtkAppLauncher;
 exports.launchGtkApp = launchGtkApp.launchGtkApp;

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: gestament
- * version: 0.3.0
+ * version: 0.5.0
  * description: TypeScript based test driver for GTK
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/gestament.git
- * git.commit.hash: c15fe3b28fb1c2fb73504c57773b1ee751cbf8c4
+ * git.commit.hash: 368fd995a6a10f20aea97cb0389ac3e12cfbedb3
  */
 
 export * from './types.js';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { c, a, l } from "./launchGtkApp-qi1qm5G4.js";
+import { c, a, l } from "./launchGtkApp-EI6OIpPI.js";
 export {
   c as createGtkAppEnvironment,
   a as createGtkAppLauncher,