NORMAL ~/wkd/p/testing :set skin=modern utf-8

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.

status
alpha — 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.
category
Debug & inspect
neovim
0.10+
repo
github.com/WKDSteve/testing.nvim
commits
743
help
:help testing

install

{
  "WKDSteve/testing.nvim",
  opts = {},
}

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://).

docs/

git log

  1. test mcp: scripts/mcp.lua as a real stdio process, driven by the lib.nvim MCP client
  2. fix mcp: a dir argument can no longer smuggle an option into testing call
  3. feat mcp: read-only MCP server over testing-export/1
  4. refactor stats: --since reads its day through lib.lua.time.presets.since_utc
  5. feat sheets: a live sheet may name no variable (network alone)
  6. fix health: check lib.nvim.fs.fast and fs.helper, which the Linux watch uses now
  7. perf watch: on Linux one file-helper watch per root instead of a handle per folder
  8. fix sheets: pass a live sheet's values to the child as they are
  9. test ci: the fake gh of ci_runner_guard_share_spec writes a file per comparison
  10. test sheets: sheet_webview_spec prints what it got before what it expected
  11. fix sheets: a build or prepare step past its limit is seen even when wait returns early or nothing
  12. fix ci: commit --wsl mirrors the testing.nvim checkout, not its lua/ folder

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search plugins and apps (app: x or plugin: x narrows)
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :apps · :play · :log · :stack
plugin list · app list · play area · activity stream · dependency graph
:log apps
the stream of one area (plugins or apps)
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close