Debug & inspect · alpha · Neovim 0.10+ · 743 commits
testing.nvim
A test runner and orchestration layer for Neovim plugins, built on lib.nvim. The goal is to replace busted and plenary for the author's plugins and to replace, extend and improve their hand-written test harnesses, with the existing specs running unchanged. What is true today: the runner runs describe/it specs without plenary or busted (verified on the 13 plenary repositories of the fleet, with a probe that fails when plenary is reachable), runs the harness-style specs of the fleet (return function(H) and the like, on the project's own harness where there is one), runs self-running scripts, can run every spec file in a child editor of its own, tests this very repository with its own runner, and reports through a terminal reporter, GitHub annotations, JUnit XML and a JSON result format. How close the fleet is to the goal is measured, not claimed: see Fleet status. Moving the fleet's repositories over has not happened.
Connections
Tap the picture to open it at full size.
Install
{
"WKDSteve/testing.nvim",
opts = {},
} Pre-alpha, milestones M0 to M2 are done, M4 and M5 are being wired in. A test runner for Neovim plugins that runs the spec styles of the author's plugins unchanged, tells the truth about a run, and tests itself with itself. Spec files can run in a child editor of their own, guards name what a spec leaves behind, an opt-in warm pool reuses editors between files, and an opt-in result cache skips spec files that cannot have changed. No editor UI beyond :Testing. Expect breaking changes; do not depend on it.
Documentation
- docs/BINDINGS.md
- docs/CACHE.md
- docs/CHILD.md
- docs/CI-CACHE.md
- docs/CI.md
- docs/CLI.md
- docs/CONFIG.md
- docs/CONFORMANCE.md
- docs/DIALECTS.md
- docs/EXIT-CODES.md
- docs/GUARDS.md
- docs/HOOKS.md
- docs/ISOLATION.md
- docs/MIGRATING.md
- docs/OUTPUT-FORMATS.md
- docs/PERFORMANCE.md
- docs/RUNNER-GUARD.md
- docs/SHEETS.md
- docs/STATE.md
- docs/SURFACE.md
- docs/TIER3.md
- docs/WORKFLOW-CI.md
Also as
- Native app testing-desktop — A local web UI for the test and CI results of the repositories that use testing.nvim
- Web testing-web — The page of testing-desktop as a single HTML file that Chrome opens from disk (file://).
Recent commits
- test mcp: scripts/mcp.lua as a real stdio process, driven by the lib.nvim MCP client
- fix mcp: a dir argument can no longer smuggle an option into testing call
- feat mcp: read-only MCP server over testing-export/1
- refactor stats: --since reads its day through lib.lua.time.presets.since_utc
- feat sheets: a live sheet may name no variable (network alone)
- fix health: check lib.nvim.fs.fast and fs.helper, which the Linux watch uses now
- perf watch: on Linux one file-helper watch per root instead of a handle per folder
- fix sheets: pass a live sheet's values to the child as they are
Combos
- Work list
One list of open work, fed from three sides: tasks.nvim keeps it, the findings of a rules.nvim check become tasks, and a task can carry the state of testing.nvim's test sheets.