feat(tests): add tests for utils.fs module

Author: broken-pen

tests/plenary/helpers.lua

@@ -3,6 +3,30 @@ local orgmode = require('orgmode')
 
 local M = {}
 
+---Temporarily change a variable.
+---@param ctx table<string, any>
+---@param name string
+---@param value any
+---@param inner fun()
+function M.with_var(ctx, name, value, inner)
+  local old = ctx[name]
+  ctx[name] = value
+  local ok, err = pcall(inner)
+  ctx[name] = old
+  assert(ok, err)
+end
+
+---Temporarily change the working directory.
+---@param new_path string
+---@param inner fun()
+function M.with_cwd(new_path, inner)
+  local old_path = vim.fn.getcwd()
+  vim.cmd.cd(new_path)
+  local ok, err = pcall(inner)
+  vim.cmd.cd(old_path)
+  assert(ok, err)
+end
+
 ---@param path string
 function M.load_file(path)
   vim.cmd.edit(path)

tests/plenary/utils/fs_spec.lua

@@ -0,0 +1,88 @@
+local fs_utils = require('orgmode.utils.fs')
+local helpers = require('tests.plenary.helpers')
+
+local uv = vim.uv or vim.loop
+local file = helpers.create_file({})
+
+describe('get_current_file_dir', function()
+  it('gives the dirname of current_file_path', function()
+    assert.are.same(vim.fs.dirname(file.filename), fs_utils.get_current_file_dir())
+  end)
+
+  it('always gives an absolute path', function()
+    local tempdir = vim.fs.dirname(file.filename)
+    helpers.with_cwd(tempdir, function()
+      assert.are.same('.', vim.fs.dirname(vim.fn.bufname()))
+      local dir = fs_utils.get_current_file_dir()
+      assert.are.same(dir .. '/', vim.fn.fnamemodify(dir, ':p'))
+    end)
+  end)
+end)
+
+describe('substitute_path', function()
+  it('leaves absolute paths untouched', function()
+    assert.are.same('/a/b/c', fs_utils.substitute_path('/a/b/c'))
+  end)
+
+  it('expands ~ to HOME', function()
+    local output
+    helpers.with_var(vim.env, 'HOME', '/home/org', function()
+      output = fs_utils.substitute_path('~/foobar')
+    end)
+    assert.are.same('/home/org/foobar', output)
+  end)
+
+  it('expands . to the current file dir', function()
+    local output = fs_utils.substitute_path('./a/b')
+    assert(output)
+    assert(vim.startswith(output, vim.fs.dirname(file.filename)))
+  end)
+
+  it('expands .. to the current file dir plus ..', function()
+    local output = fs_utils.substitute_path('../a/b')
+    assert(output)
+    assert(vim.startswith(output, vim.fs.dirname(file.filename)))
+    local normalized = vim.fs.normalize(output)
+    assert.are.Not.same(output, normalized, "normalize didn't remove ..")
+  end)
+
+  it('fails on all other relative paths', function()
+    assert.is.False(fs_utils.substitute_path('a/b/c'))
+  end)
+end)
+
+describe('get_real_path', function()
+  local link_name = nil
+
+  before_each(function()
+    if not link_name then
+      link_name = vim.fn.tempname()
+      assert(uv.fs_symlink(file.filename, link_name))
+    end
+  end)
+
+  it('resolves symlinks', function()
+    assert(link_name)
+    assert.are.same(file.filename, fs_utils.get_real_path(link_name))
+  end)
+
+  it('resolves relative paths', function()
+    assert(link_name)
+    local relpath = vim.fs.joinpath('.', vim.fs.basename(link_name))
+    assert.are.same(file.filename, fs_utils.get_real_path(relpath))
+  end)
+
+  it('keeps trailing slash if it is there', function()
+    local path = fs_utils.get_real_path('././')
+    assert.are.same(vim.fs.dirname(file.filename) .. '/', path)
+  end)
+
+  it('keeps trailing slash away if it is not there', function()
+    local path = fs_utils.get_real_path('./.')
+    assert.are.same(vim.fs.dirname(file.filename), path)
+  end)
+
+  it('fails on bare dot "."', function()
+    assert.is.False(fs_utils.get_real_path('.'))
+  end)
+end)