fix(base): add string concat mode to make it work with old code

.github/workflows/.luarc.json

@@ -1,30 +1,30 @@
 {
-    "$schema": "https://raw.githubusercontent.com/sumneko/vscode-lua/master/setting/schema.json",
-    "runtime.version": "LuaJIT",
-    "runtime.path": [
-        "lua/?.lua",
-        "lua/?/init.lua",
-        "${3rd}/busted/library/?.lua",
-        "${3rd}/busted/library/?/init.lua"
-    ],
-    "workspace.library": [
-        "/home/runner/work/pathlib.nvim/pathlib.nvim/deps/neodev.nvim/types/stable",
-        "/home/runner/work/pathlib.nvim/pathlib.nvim/deps/nvim-nio/lua",
-        "${3rd}/busted/library",
-        "${3rd}/luassert/library"
-    ],
-    "diagnostics.globals": [
-        "describe",
-        "assert",
-        "it",
-        "vim",
-        "setup",
-        "teardown"
-    ],
-    "runtime.special": {
-        "luassert": "loadfile"
-    },
-    "workspace.maxPreload": 100000,
-    "diagnostics.libraryFiles": "Disable",
-    "workspace.checkThirdParty": false
+  "$schema": "https://raw.githubusercontent.com/sumneko/vscode-lua/master/setting/schema.json",
+  "runtime.version": "LuaJIT",
+  "runtime.path": [
+    "lua/?.lua",
+    "lua/?/init.lua",
+    "${3rd}/busted/library/?.lua",
+    "${3rd}/busted/library/?/init.lua"
+  ],
+  "workspace.library": [
+    "/home/runner/work/pathlib.nvim/pathlib.nvim/deps/neodev.nvim/types/stable",
+    "/home/runner/work/pathlib.nvim/pathlib.nvim/lua_modules/share/lua/5.1",
+    "${3rd}/busted/library",
+    "${3rd}/luassert/library"
+  ],
+  "diagnostics.globals": [
+    "describe",
+    "assert",
+    "it",
+    "vim",
+    "setup",
+    "teardown"
+  ],
+  "runtime.special": {
+    "luassert": "loadfile"
+  },
+  "workspace.maxPreload": 100000,
+  "diagnostics.libraryFiles": "Disable",
+  "workspace.checkThirdParty": false
 }

.github/workflows/lua_ls-typecheck.yml

@@ -21,14 +21,24 @@ jobs:
           repository: "folke/neodev.nvim"
           path: "deps/neodev.nvim"
 
-      - name: Checkout dependency nio
-        uses: actions/checkout@v3
+      - uses: leafo/gh-actions-lua@v9
         with:
-          repository: "nvim-neotest/nvim-nio"
-          path: "deps/nvim-nio"
+          luaVersion: "5.1"
+      - uses: leafo/gh-actions-luarocks@v4
+
+      - name: install dependencies
+        run: |
+          luarocks init
+          luarocks config --scope project lua_version 5.1
+          luarocks install --only-deps ./pathlib.nvim-scm-1.rockspec
 
       - name: Print Filetree
-        run: echo $PWD && ls -la && ls -la deps
+        run: |
+          echo $PWD && ls -la && ls -la deps
+          ls -la lua_modules
+          ls -la lua_modules/*
+          ls -la lua_modules/share/*
+          ls -la lua_modules/share/lua/*
 
       - name: Type Check Code Base
         uses: mrcjkb/lua-typecheck-action@v0

.neoconf.json

@@ -3,7 +3,8 @@
     "library": {
       "enabled": true,
       "plugins": [
-        "neodev.nvim"
+        "neodev.nvim",
+        "nvim-nio"
       ]
     }
   },

README.md

@@ -90,9 +90,14 @@ assert(tostring(foo:parent()) == "folder")
 assert(foo                    == Path("./folder/foo.txt")) -- Path object can be created with arguments
 assert(foo                    == Path(folder, "foo.txt"))  -- Unpack any of them if you want!
 
--- Create siblings (just like `./<foo>/../bar.txt`)
+-- Create siblings mode (just like `./<foo>/../bar.txt`)
 local bar = foo .. "bar.txt"
 assert(tostring(bar)          == "folder/bar.txt")
+-- Mimic string concat mode (to work with your old code).
+-- This makes old code with string paths work mostly as expected.
+-- This is enabled only if rhs starts with "/" or "\\".
+local old_path = folder .. "/" .. "old-way" .. "/to/make/path.txt"
+assert(old_path               == Path("folder/old-way/to/make/path.txt"))
 
 -- Calculate relativily
 assert(foo:is_relative_to(Path("folder")))

README.norg

@@ -103,9 +103,14 @@ version: 1.1.1
   assert(foo                    == Path("./folder/foo.txt")) -- Path object can be created with arguments
   assert(foo                    == Path(folder, "foo.txt"))  -- Unpack any of them if you want!
 
-  -- Create siblings (just like `./<foo>/../bar.txt`)
+  -- Create siblings mode (just like `./<foo>/../bar.txt`)
   local bar = foo .. "bar.txt"
   assert(tostring(bar)          == "folder/bar.txt")
+  -- Mimic string concat mode (to work with your old code).
+  -- This makes old code with string paths work mostly as expected.
+  -- This is enabled only if rhs starts with "/" or "\\".
+  local old_path = folder .. "/" .. "old-way" .. "/to/make/path.txt"
+  assert(old_path               == Path("folder/old-way/to/make/path.txt"))
 
   -- Calculate relativily
   assert(foo:is_relative_to(Path("folder")))

lua/pathlib/base.lua

@@ -15,6 +15,7 @@ local watcher = require("pathlib.utils.watcher")
 ---@field public __fs_event_callbacks table<string, PathlibWatcherCallback>|nil # List of functions called when a fs_event is triggered.
 ---@field public __string_cache string|nil # Cache result of `tostring(self)`.
 ---@field public __parent_cache PathlibPath|nil # Cache reference to parent object.
+---@field public __concat_dir_mode boolean|nil # If the object was created with `Path() .. "/"`, next string concat will append as a file.
 local Path = setmetatable({
   mytype = const.path_module_enum.PathlibPath,
   sep_str = "/",
@@ -933,13 +934,32 @@ function Path:__div(other)
 end
 
 ---Concatenate paths with the parent of lhs. `Path("./foo/foo.txt") .. "bar.txt" == "./foo/bar.txt"`
+---
+---To keep backwards compatibility, when rhs is a string and starts with "[/\\]", it behaves as like a string.
+---
+--->>> Path("./foo/foo.txt") .. "bar.txt" -- sibling mode
+---Path("./foo/bar.txt")
+---
+--->>> Path("./foo") .. "/" .. "bar.txt" -- mimic string concat mode
+---Path("./foo/bar.txt")
+---
 ---@param other PathlibPath | string
 ---@return PathlibPath
--- Path.__concat = function(self, other)
 function Path:__concat(other)
   if not utils.tables.is_path_module(self) and not utils.tables.is_path_module(other) then
     -- one of objects must be a path object
     errs.value_error("__concat", other)
+  elseif utils.tables.is_path_module(self) and type(other) == "string" then
+    if self.__concat_dir_mode then
+      other = "/" .. other
+    end
+    local first_letter = other:sub(1, 1)
+    local last_letter = other:sub(#other)
+    if first_letter == "/" or first_letter == "\\" then
+      local new = self.new(self, other)
+      new.__concat_dir_mode = last_letter == "/" or last_letter == "\\"
+      return new
+    end
   end
   return self.new(self:parent(), other)
 end

spec/path_dunder_spec.lua

@@ -82,6 +82,14 @@ describe("Test Dunder Methods of Path Object;", function()
       assert.are.equal(foo, sibling_file .. Posix.new("./foo.txt"))
     end)
 
+    it("backwards compat", function()
+      local path = Posix.new("./folder")
+      assert.are.equal(foo, path .. "/foo.txt")
+      assert.are.equal(foo, path .. "/" .. "foo.txt")
+      assert.are.equal(foo, path .. "/" .. "./foo.txt")
+      assert.are_not.equal(foo, path .. "foo.txt")
+    end)
+
     it("raise error", function()
       assert.has_error(function()
         return Posix.new(".") / {}