local t = require('test.testutil') local n = require('test.functional.testnvim')() local clear = n.clear local exec_lua = n.exec_lua local eq = t.eq local mkdir_p = n.mkdir_p local rmdir = n.rmdir local nvim_dir = n.nvim_dir local command = n.command local api = n.api local test_build_dir = t.paths.test_build_dir local test_source_path = t.paths.test_source_path local nvim_prog = n.nvim_prog local is_os = t.is_os local mkdir = t.mkdir local nvim_prog_basename = is_os('win') and 'nvim.exe' or 'nvim' local test_basename_dirname_eq = { '~/foo/', '~/foo', '~/foo/bar.lua', 'foo.lua', ' ', '', '.', '..', '../', '~', '/usr/bin', '/usr/bin/gcc', '/', '/usr/', '/usr', 'c:/usr', 'c:/', 'c:', 'c:/users/foo', 'c:/users/foo/bar.lua', 'c:/users/foo/bar/../', '~/foo/bar\\baz', } local tests_windows_paths = { 'c:\\usr', 'c:\\', 'c:', 'c:\\users\\foo', 'c:\\users\\foo\\bar.lua', 'c:\\users\\foo\\bar\\..\\', } before_each(clear) describe('vim.fs', function() describe('parents()', function() it('works', function() local test_dir = nvim_dir .. '/test' mkdir_p(test_dir) local dirs = {} --- @type string[] for dir in vim.fs.parents(test_dir .. '/foo.txt') do dirs[#dirs + 1] = dir if dir == test_build_dir then break end end eq({ test_dir, nvim_dir, test_build_dir }, dirs) rmdir(test_dir) end) end) describe('dirname()', function() it('works', function() eq(test_build_dir, vim.fs.dirname(nvim_dir)) ---@param paths string[] ---@param is_win? boolean local function test_paths(paths, is_win) local gsub = is_win and [[:gsub('\\', '/')]] or '' local code = string.format( [[ local path = ... return vim.fn.fnamemodify(path,':h')%s ]], gsub ) for _, path in ipairs(paths) do eq(exec_lua(code, path), vim.fs.dirname(path), path) end end test_paths(test_basename_dirname_eq) if is_os('win') then test_paths(tests_windows_paths, true) end end) end) describe('basename()', function() it('works', function() eq(nvim_prog_basename, vim.fs.basename(nvim_prog)) ---@param paths string[] ---@param is_win? boolean local function test_paths(paths, is_win) local gsub = is_win and [[:gsub('\\', '/')]] or '' local code = string.format( [[ local path = ... return vim.fn.fnamemodify(path,':t')%s ]], gsub ) for _, path in ipairs(paths) do eq(exec_lua(code, path), vim.fs.basename(path), path) end end test_paths(test_basename_dirname_eq) if is_os('win') then test_paths(tests_windows_paths, true) end end) end) describe('dir()', function() before_each(function() mkdir('testd') mkdir('testd/a') mkdir('testd/a/b') mkdir('testd/a/b/c') end) after_each(function() rmdir('testd') end) it('works', function() eq( true, exec_lua(function() for name, type in vim.fs.dir(nvim_dir) do if name == nvim_prog_basename and type == 'file' then return true end end return false end) ) end) it('works with opts.depth and opts.skip', function() io.open('testd/a1', 'w'):close() io.open('testd/b1', 'w'):close() io.open('testd/c1', 'w'):close() io.open('testd/a/a2', 'w'):close() io.open('testd/a/b2', 'w'):close() io.open('testd/a/c2', 'w'):close() io.open('testd/a/b/a3', 'w'):close() io.open('testd/a/b/b3', 'w'):close() io.open('testd/a/b/c3', 'w'):close() io.open('testd/a/b/c/a4', 'w'):close() io.open('testd/a/b/c/b4', 'w'):close() io.open('testd/a/b/c/c4', 'w'):close() local function run(dir, depth, skip) return exec_lua(function() local r = {} local skip_f if skip then skip_f = function(n0) if vim.tbl_contains(skip or {}, n0) then return false end end end for name, type_ in vim.fs.dir(dir, { depth = depth, skip = skip_f }) do r[name] = type_ end return r end) end local exp = {} exp['a1'] = 'file' exp['b1'] = 'file' exp['c1'] = 'file' exp['a'] = 'directory' eq(exp, run('testd', 1)) exp['a/a2'] = 'file' exp['a/b2'] = 'file' exp['a/c2'] = 'file' exp['a/b'] = 'directory' eq(exp, run('testd', 2)) exp['a/b/a3'] = 'file' exp['a/b/b3'] = 'file' exp['a/b/c3'] = 'file' exp['a/b/c'] = 'directory' eq(exp, run('testd', 3)) eq(exp, run('testd', 999, { 'a/b/c' })) exp['a/b/c/a4'] = 'file' exp['a/b/c/b4'] = 'file' exp['a/b/c/c4'] = 'file' eq(exp, run('testd', 999)) end) end) describe('find()', function() it('works', function() eq( { test_build_dir .. '/build' }, vim.fs.find('build', { path = nvim_dir, upward = true, type = 'directory' }) ) eq({ nvim_prog }, vim.fs.find(nvim_prog_basename, { path = test_build_dir, type = 'file' })) local parent, name = nvim_dir:match('^(.*/)([^/]+)$') eq({ nvim_dir }, vim.fs.find(name, { path = parent, upward = true, type = 'directory' })) end) it('accepts predicate as names', function() local opts = { path = nvim_dir, upward = true, type = 'directory' } eq( { test_build_dir .. '/build' }, vim.fs.find(function(x) return x == 'build' end, opts) ) eq( { nvim_prog }, vim.fs.find(function(x) return x == nvim_prog_basename end, { path = test_build_dir, type = 'file' }) ) eq( {}, vim.fs.find(function(x) return x == 'no-match' end, opts) ) opts = { path = test_source_path .. '/contrib', limit = math.huge } eq( exec_lua(function() return vim.tbl_map( vim.fs.basename, vim.fn.glob(test_source_path .. '/contrib/*', false, true) ) end), vim.tbl_map( vim.fs.basename, vim.fs.find(function(_, d) return d:match('[\\/]contrib$') end, opts) ) ) end) end) describe('root()', function() before_each(function() command('edit test/functional/fixtures/tty-test.c') end) it('works with a single marker', function() eq(test_source_path, exec_lua([[return vim.fs.root(0, 'CMakePresets.json')]])) end) it('works with multiple markers', function() local bufnr = api.nvim_get_current_buf() eq( vim.fs.joinpath(test_source_path, 'test/functional/fixtures'), exec_lua([[return vim.fs.root(..., {'CMakeLists.txt', 'CMakePresets.json'})]], bufnr) ) end) it('works with a function', function() ---@type string local result = exec_lua(function() return vim.fs.root(0, function(name, _) return name:match('%.txt$') end) end) eq(vim.fs.joinpath(test_source_path, 'test/functional/fixtures'), result) end) it('works with a filename argument', function() eq(test_source_path, exec_lua([[return vim.fs.root(..., 'CMakePresets.json')]], nvim_prog)) end) it('works with a relative path', function() eq( test_source_path, exec_lua([[return vim.fs.root(..., 'CMakePresets.json')]], vim.fs.basename(nvim_prog)) ) end) it('uses cwd for unnamed buffers', function() command('new') eq(test_source_path, exec_lua([[return vim.fs.root(0, 'CMakePresets.json')]])) end) it("uses cwd for buffers with non-empty 'buftype'", function() command('new') command('set buftype=nofile') command('file lua://') eq(test_source_path, exec_lua([[return vim.fs.root(0, 'CMakePresets.json')]])) end) end) describe('joinpath()', function() it('works', function() eq('foo/bar/baz', vim.fs.joinpath('foo', 'bar', 'baz')) eq('foo/bar/baz', vim.fs.joinpath('foo', '/bar/', '/baz')) end) end) describe('normalize()', function() it('removes trailing /', function() eq('/home/user', vim.fs.normalize('/home/user/')) end) it('works with /', function() eq('/', vim.fs.normalize('/')) end) it('works with ~', function() eq(vim.fs.normalize(assert(vim.uv.os_homedir())) .. '/src/foo', vim.fs.normalize('~/src/foo')) end) it('works with environment variables', function() local xdg_config_home = test_build_dir .. '/.config' eq( xdg_config_home .. '/nvim', exec_lua(function() vim.env.XDG_CONFIG_HOME = xdg_config_home return vim.fs.normalize('$XDG_CONFIG_HOME/nvim') end) ) end) -- Opts required for testing posix paths and win paths local posix_opts = is_os('win') and { win = false } or {} local win_opts = is_os('win') and {} or { win = true } it('preserves leading double slashes in POSIX paths', function() eq('//foo', vim.fs.normalize('//foo', posix_opts)) eq('//foo/bar', vim.fs.normalize('//foo//bar////', posix_opts)) eq('/foo', vim.fs.normalize('///foo', posix_opts)) eq('//', vim.fs.normalize('//', posix_opts)) eq('/', vim.fs.normalize('///', posix_opts)) eq('/foo/bar', vim.fs.normalize('/foo//bar////', posix_opts)) end) it('allows backslashes on unix-based os', function() eq('/home/user/hello\\world', vim.fs.normalize('/home/user/hello\\world', posix_opts)) end) it('preserves / after drive letters', function() eq('C:/', vim.fs.normalize([[C:\]], win_opts)) end) it('works with UNC and DOS device paths', function() eq('//server/share/foo/bar', vim.fs.normalize([[\\server\\share\\\foo\bar\\\]], win_opts)) eq('//system07/C$/', vim.fs.normalize([[\\system07\C$\\\\]], win_opts)) eq('//./C:/foo/bar', vim.fs.normalize([[\\.\\C:\foo\\\\bar]], win_opts)) eq('//?/C:/foo/bar', vim.fs.normalize([[\\?\C:\\\foo\bar\\\\]], win_opts)) eq( '//?/UNC/server/share/foo/bar', vim.fs.normalize([[\\?\UNC\server\\\share\\\\foo\\\bar]], win_opts) ) eq('//./BootPartition/foo/bar', vim.fs.normalize([[\\.\BootPartition\\foo\bar]], win_opts)) eq( '//./Volume{12345678-1234-1234-1234-1234567890AB}/foo/bar', vim.fs.normalize([[\\.\Volume{12345678-1234-1234-1234-1234567890AB}\\\foo\bar\\]], win_opts) ) end) it('handles invalid UNC and DOS device paths', function() eq('//server/share', vim.fs.normalize([[\\server\share]], win_opts)) eq('//server/', vim.fs.normalize([[\\server\]], win_opts)) eq('//./UNC/server/share', vim.fs.normalize([[\\.\UNC\server\share]], win_opts)) eq('//?/UNC/server/', vim.fs.normalize([[\\?\UNC\server\]], win_opts)) eq('//?/UNC/server/..', vim.fs.normalize([[\\?\UNC\server\..]], win_opts)) eq('//./', vim.fs.normalize([[\\.\]], win_opts)) eq('//./foo', vim.fs.normalize([[\\.\foo]], win_opts)) eq('//./BootPartition', vim.fs.normalize([[\\.\BootPartition]], win_opts)) end) it('converts backward slashes', function() eq('C:/Users/jdoe', vim.fs.normalize([[C:\Users\jdoe]], win_opts)) end) describe('. and .. component resolving', function() it('works', function() -- Windows paths eq('C:/Users', vim.fs.normalize([[C:\Users\jdoe\Downloads\.\..\..\]], win_opts)) eq('C:/Users/jdoe', vim.fs.normalize([[C:\Users\jdoe\Downloads\.\..\.\.\]], win_opts)) eq('C:/', vim.fs.normalize('C:/Users/jdoe/Downloads/./../../../', win_opts)) eq('C:foo', vim.fs.normalize([[C:foo\bar\.\..\.]], win_opts)) -- POSIX paths eq('/home', vim.fs.normalize('/home/jdoe/Downloads/./../..', posix_opts)) eq('/home/jdoe', vim.fs.normalize('/home/jdoe/Downloads/./../././', posix_opts)) eq('/', vim.fs.normalize('/home/jdoe/Downloads/./../../../', posix_opts)) -- OS-agnostic relative paths eq('foo/bar/baz', vim.fs.normalize('foo/bar/foobar/../baz/./')) eq('foo/bar', vim.fs.normalize('foo/bar/foobar/../baz/./../../bar/./.')) end) it('works when relative path reaches current directory', function() eq('C:', vim.fs.normalize('C:foo/bar/../../.', win_opts)) eq('.', vim.fs.normalize('.')) eq('.', vim.fs.normalize('././././')) eq('.', vim.fs.normalize('foo/bar/../../.')) end) it('works when relative path goes outside current directory', function() eq('../../foo/bar', vim.fs.normalize('../../foo/bar')) eq('../foo', vim.fs.normalize('foo/bar/../../../foo')) eq('C:../foo', vim.fs.normalize('C:../foo', win_opts)) eq('C:../../foo/bar', vim.fs.normalize('C:foo/../../../foo/bar', win_opts)) end) it('.. in root directory resolves to itself', function() eq('C:/', vim.fs.normalize('C:/../../', win_opts)) eq('C:/foo', vim.fs.normalize('C:/foo/../../foo', win_opts)) eq('//server/share/', vim.fs.normalize([[\\server\share\..\..]], win_opts)) eq('//server/share/foo', vim.fs.normalize([[\\server\\share\foo\..\..\foo]], win_opts)) eq('//./C:/', vim.fs.normalize([[\\.\C:\..\..]], win_opts)) eq('//?/C:/foo', vim.fs.normalize([[\\?\C:\..\..\foo]], win_opts)) eq('//./UNC/server/share/', vim.fs.normalize([[\\.\UNC\\server\share\..\..\]], win_opts)) eq( '//?/UNC/server/share/foo', vim.fs.normalize([[\\?\UNC\server\\share\..\..\foo]], win_opts) ) eq('//?/BootPartition/', vim.fs.normalize([[\\?\BootPartition\..\..]], win_opts)) eq('//./BootPartition/foo', vim.fs.normalize([[\\.\BootPartition\..\..\foo]], win_opts)) eq('/', vim.fs.normalize('/../../', posix_opts)) eq('/foo', vim.fs.normalize('/foo/../../foo', posix_opts)) end) end) end) end)