feat: Add ability to have a user defined function to format the path display (#1000)

doc/telescope.txt

@@ -181,6 +181,15 @@ telescope.setup({opts})                                    *telescope.setup()*
 
         path_display can also be set to 'hidden' string to hide file names
 
+        path_display can also be set to a function for custom formatting of
+        the path display. Example:
+
+            -- Format path as "file.txt (path\to\file\)"
+            path_display = function(opts, path)
+              local tail = require("telescope.utils").path_tail(path)
+              return string.format("%s (%s)", tail, path)
+            end,
+
         Default: {}
 
                                          *telescope.defaults.prompt_prefix*

lua/telescope/config.lua

@@ -190,6 +190,15 @@ local telescope_defaults = {
 
     path_display can also be set to 'hidden' string to hide file names
 
+    path_display can also be set to a function for custom formatting of
+    the path display. Example:
+
+        -- Format path as "file.txt (path\to\file\)"
+        path_display = function(opts, path)
+          local tail = require("telescope.utils").path_tail(path)
+          return string.format("%s (%s)", tail, path)
+        end,
+
     Default: {}]]
   },
 

lua/telescope/utils.lua

@@ -274,12 +274,16 @@ end
 utils.transform_path = function(opts, path)
   local path_display = utils.get_default(opts.path_display, require('telescope.config').values.path_display)
 
+  local transformed_path = path
+
+  if type(path_display) == "function" then
+    return path_display(opts, transformed_path)
+  end
+
   if utils.is_path_hidden(nil, path_display) then
     return ''
   end
 
-  local transformed_path = path
-
   if vim.tbl_contains(path_display, "tail") then
     transformed_path = utils.path_tail(transformed_path)
   else