Files
neovim/test/functional/terminal/altscreen_spec.lua
Justin M. Keyes 6d8c8b18d5 test(harness): migrate away from magic globals
Problem:
The magic globals `it`, `describe`, etc., are more trouble than they are
worth.

- Hooking into `after_each` requires `getfenv()` hacks.
- They confuse luals/emmylua, because the top-level `.luarc.json` isn't
  merged with `test/.luarc.json` (apparently a luals limitation?)
- They totally defeat discoverability because the user just has to
  "know" about the various magic symbols.

So they harm DX, which means they serve no purpose at all.

Solution:
- Expose the test API from `testutil`, so tests can call `t.it()`,
  `t.describe()`, etc., in the conventional way.
- Drop `getfenv()` hacks.
- Drop the `setfenv()` injection in `load_chunk`.
- Drop `test/_meta.lua`.
2026-07-21 13:22:39 +02:00

189 lines
6.5 KiB
Lua

local t = require('test.testutil')
local n = require('test.functional.testnvim')()
local tt = require('test.functional.testterm')
local describe, it, before_each = t.describe, t.it, t.before_each
local clear, eq, api = n.clear, t.eq, n.api
local feed = n.feed
local feed_data = tt.feed_data
local enter_altscreen = tt.enter_altscreen
local exit_altscreen = tt.exit_altscreen
describe(':terminal altscreen', function()
local screen
before_each(function()
clear()
screen = tt.setup_screen()
feed_data({
'line1',
'line2',
'line3',
'line4',
'line5',
'line6',
'line7',
'line8',
'',
})
screen:expect([[
line4 |
line5 |
line6 |
line7 |
line8 |
^ |
{5:-- TERMINAL --} |
]])
enter_altscreen()
screen:expect([[
|*5
^ |
{5:-- TERMINAL --} |
]])
eq(10, api.nvim_buf_line_count(0))
end)
it('wont clear lines already in the scrollback', function()
feed('<c-\\><c-n>gg')
screen:expect([[
^tty ready |
line1 |
line2 |
line3 |
|*3
]])
-- ED 3 is no-op in altscreen
feed_data('\027[3J')
screen:expect_unchanged()
end)
describe('restores buffer state', function()
local function test_exit_altscreen_restores_buffer_state()
exit_altscreen()
screen:expect([[
line4 |
line5 |
line6 |
line7 |
line8 |
^ |
{5:-- TERMINAL --} |
]])
feed('<c-\\><c-n>gg')
screen:expect([[
^tty ready |
line1 |
line2 |
line3 |
line4 |
line5 |
|
]])
end
it('after exit', function()
test_exit_altscreen_restores_buffer_state()
end)
it('after ED 2 and ED 3 and exit', function()
feed_data('\027[H\027[2J\027[3J')
screen:expect([[
^ |
|*5
{5:-- TERMINAL --} |
]])
test_exit_altscreen_restores_buffer_state()
end)
end)
describe('with lines printed after the screen height limit', function()
before_each(function()
feed_data({
'line9',
'line10',
'line11',
'line12',
'line13',
'line14',
'line15',
'line16',
'',
})
screen:expect([[
line12 |
line13 |
line14 |
line15 |
line16 |
^ |
{5:-- TERMINAL --} |
]])
end)
it('wont modify line count', function()
eq(10, api.nvim_buf_line_count(0))
end)
it('wont modify lines in the scrollback', function()
feed('<c-\\><c-n>gg')
screen:expect([[
^tty ready |
line1 |
line2 |
line3 |
line12 |
line13 |
|
]])
end)
end)
describe('after height is decreased by 2', function()
local function wait_removal()
screen:try_resize(screen._width, screen._height - 2)
screen:expect([[
|*2
rows: 4, cols: 50 |
^ |
{5:-- TERMINAL --} |
]])
end
it('removes 2 lines from the bottom of the visible buffer', function()
wait_removal()
feed('<c-\\><c-n>4k')
screen:expect([[
^ |
|*2
rows: 4, cols: 50 |
|
]])
eq(9, api.nvim_buf_line_count(0))
end)
describe('and after exit', function()
before_each(function()
wait_removal()
exit_altscreen()
end)
it('restore buffer state', function()
screen:expect(t.is_os('win') and [[
line6 |
line7 |
line8 |
^ |
{5:-- TERMINAL --} |
]] or [[
line5 |
line6 |
line7 |
^line8 |
{5:-- TERMINAL --} |
]])
end)
end)
end)
end)