Registry / testing / textmate-grammar-test

textmate-grammar-test

library0.6.0jsnpmunverified

This package provides a comprehensive test runner for validating TextMate grammars against the same engine used by VS Code. It offers both unit and snapshot testing capabilities, enabling developers to write assertions against token scopes and to easily track changes in grammar tokenization over time. The current stable version is 0.6.0, with minor releases occurring relatively frequently, driven by performance improvements, bug fixes, and feature enhancements. It serves as a modern and actively maintained successor to the `vscode-tmgrammar-test` package, featuring an updated codebase and enhanced functionality. Key differentiators include its direct validation against the VS Code TextMate engine, robust snapshot testing with an update mechanism, and detailed unit testing syntax for precise scope assertions, including negative assertions and line start token targeting.

testing

npm install textmate-grammar-test

github ↗package ↗

INSTALL

IMPORT

SIG · TEXTMATE-GRAMMAR-T

textmate-grammar-test

testingjavascriptv0.6.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

runUnitTests

✓ import { runUnitTests } from 'textmate-grammar-test';

✗ const { runUnitTests } = require('textmate-grammar-test');

Primarily a CLI tool, but programmatic access is available for integration. The package is ESM-first, requiring `import` syntax.

runSnapshotTests

✓ import { runSnapshotTests } from 'textmate-grammar-test';

✗ const { runSnapshotTests } = require('textmate-grammar-test');

Used for programmatic execution of snapshot tests. The `textmate-grammar-snap` CLI command wraps this function.

TextMateGrammarTestCLI

✓ npx textmate-grammar-test

The primary interaction is via the command-line interface. This 'import' refers to invoking the CLI directly, not a programmatic import.

Demonstrates setting up `textmate-grammar-test` in `package.json` scripts and a basic unit test file for a TypeScript grammar.

{ "name": "my-grammar", "version": "1.0.0", "scripts": { "test:grammar": "npx textmate-grammar-test syntax/tests/**/*.ts" }, "devDependencies": { "textmate-grammar-test": "^0.6.0" } } // syntax/tests/example.ts // SYNTAX TEST "source.ts" "Basic TypeScript variable declaration" let count: number = 1; // ^^^^^ variable.other.readwrite.ts // ^^^^^^ support.type.primitive.ts const message = "Hello, World!"; // <---- storage.type.ts // ^^^^^^^ string.quoted.double.ts

textmate-grammar-test --version

Debug

Known issues

breakingThe `--xunit-report` and `--xunit-format` CLI options were removed in version 0.5.0, impacting CI/CD setups that relied on XUnit reporting.

fix

Migrate to alternative reporting mechanisms or update CI configurations to no longer expect XUnit output from `textmate-grammar-test`.

affects: >=0.5.0

gotchaThe `--scope` option was initially removed in v0.4.0 but subsequently re-added in v0.4.2. Users upgrading directly from versions before 0.4.2 or between 0.4.0 and 0.4.2 might encounter unexpected CLI behavior regarding scope specification.

fix

Ensure you are on version 0.4.2 or later if you intend to use the `--scope` option. Always refer to the `--help` output for the most current options.

affects: 0.4.0, 0.4.1

breakingWhen migrating from the deprecated `vscode-tmgrammar-test` package, snapshot format changes require a one-time update of existing `.snap` files.

fix

After installing `textmate-grammar-test` and updating package references, run `npx textmate-grammar-snap --updateSnapshot "tests/**/*.foo"` once to conform to the new snapshot format.

affects: >=0.3.0

gotchaUnit test files now strictly enforce space-based indentation. Using tabs within test files can lead to errors or incorrect tokenization results, as noted in changes around version 0.5.0.

fix

Ensure all unit test `.ts` or `.js` files use spaces for indentation. Configure your editor to convert tabs to spaces for these files.

affects: >=0.5.0

deprecatedThe `vscode-tmgrammar-test` and `vscode-tmgrammar-snap` packages are deprecated in favor of `textmate-grammar-test`. The new package offers an updated codebase, bug fixes, and new features.

fix

Migrate to `textmate-grammar-test` by installing `npm i -D textmate-grammar-test` and replacing all occurrences of `vscode-tmgrammar-test` and `vscode-tmgrammar-snap` in your project.

affects: <=0.3.0

Errors

Common errors & fixes

Command 'textmate-grammar-test' not found

The package is not installed as a local dependency or `npx` is not being used to invoke the command.

fix

Ensure `textmate-grammar-test` is listed in your `devDependencies` and run the command using `npx textmate-grammar-test` (e.g., `npx textmate-grammar-test syntax/tests/**/*.ts`) or add it to your `PATH` if globally installed (less common for dev tools).

Snapshot mismatch: Your snapshot tests have changed from the last run.

Your grammar's tokenization has changed, or you are migrating from an older version of `textmate-grammar-test` or `vscode-tmgrammar-test` with a different snapshot format.

fix

If the changes are expected, update your snapshots by running `npx textmate-grammar-snap --updateSnapshot "tests/**/*.foo"`. If not, review your grammar changes or test files.

error: Tabs are not allowed in unit test files.

A unit test file contains tab characters for indentation, which is now disallowed to ensure consistent parsing and avoid ambiguity.

fix

Convert all tab characters to spaces within the affected unit test file(s). Most IDEs have a 'Convert Indentation to Spaces' feature.

Cannot find module 'textmate-grammar-test' from 'your-test-file.js'

When attempting to use `import { ... } from 'textmate-grammar-test';` in a CommonJS environment without proper transpilation or configuration, or if the package is not installed.

fix

Ensure your project is configured for ESM (e.g., `"type": "module"` in `package.json`) if using `import`, or install the package with `npm install textmate-grammar-test`.

Upgrade

Version history

0.6.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/serkonda7/textmate-grammar-test ↗

packagehttps://www.npmjs.com/package/textmate-grammar-test ↗