feat: highlight config

Refs #402

README.md

@@ -231,6 +231,10 @@ require("oil").setup({
       { "type", "asc" },
       { "name", "asc" },
     },
+    -- Return a highlight group name for each entry
+    highlight = function(name, type)
+      return nil
+    end,
   },
   -- Extra arguments to pass to SCP when moving/copying files over SSH
   extra_scp_args = {},

doc/oil.txt

@@ -116,6 +116,10 @@ CONFIG                                                                *oil-confi
           { "type", "asc" },
           { "name", "asc" },
         },
+        -- Return a highlight group name for each entry
+        highlight = function(name, type)
+          return nil
+        end,
       },
       -- Extra arguments to pass to SCP when moving/copying files over SSH
       extra_scp_args = {},

lua/oil/config.lua

@@ -101,6 +101,10 @@ local default_config = {
       { "type", "asc" },
       { "name", "asc" },
     },
+    -- Return a highlight group name for each entry
+    highlight = function(name, type)
+      return nil
+    end,
   },
   -- Extra arguments to pass to SCP when moving/copying files over SSH
   extra_scp_args = {},
@@ -267,6 +271,7 @@ local M = {}
 ---@field natural_order boolean
 ---@field case_insensitive boolean
 ---@field sort oil.SortSpec[]
+---@field highlight fun(name: string, type: string): string|nil
 
 ---@class (exact) oil.SetupViewOptions
 ---@field show_hidden? boolean Show files and directories that start with "."
@@ -275,6 +280,7 @@ local M = {}
 ---@field natural_order? boolean Sort file names in a more intuitive order for humans. Is less performant, so you may want to set to false if you work with large directories.
 ---@field case_insensitive? boolean Sort file and directory names case insensitive
 ---@field sort? oil.SortSpec[] Sort order for the file list
+---@field highlight fun(name: string, type: string): string|nil Return a highlight group name for each entry
 
 ---@class (exact) oil.SortSpec
 ---@field [1] string

lua/oil/view.lua

@@ -700,10 +700,11 @@ M.format_entry_cols = function(entry, column_defs, col_width, adapter)
   end
   -- Always add the entry name at the end
   local entry_type = entry[FIELD_TYPE]
+  local highlight = config.view_options.highlight
   if entry_type == "directory" then
-    table.insert(cols, { name .. "/", "OilDir" })
+    table.insert(cols, { name .. "/", highlight(name, entry_type) or "OilDir" })
   elseif entry_type == "socket" then
-    table.insert(cols, { name, "OilSocket" })
+    table.insert(cols, { name, highlight(name, entry_type) or "OilSocket" })
   elseif entry_type == "link" then
     local link_text
     if meta then
@@ -719,12 +720,12 @@ M.format_entry_cols = function(entry, column_defs, col_width, adapter)
       end
     end
 
-    table.insert(cols, { name, "OilLink" })
+    table.insert(cols, { name, highlight(name, entry_type) or "OilLink" })
     if link_text then
-      table.insert(cols, { link_text, "OilLinkTarget" })
+      table.insert(cols, { link_text, highlight(name, entry_type) or "OilLinkTarget" })
     end
   else
-    table.insert(cols, { name, "OilFile" })
+    table.insert(cols, { name, highlight(name, entry_type) or "OilFile" })
   end
   return cols
 end