barrett/canola.nvim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 3

docs(upstream): triage stevearc/oil.nvim#280 as not actionable

Browse source 
Problem: upstream #280 (vim-projectionist support) was still marked
open. `BufNewFile` does not fire for oil-created files because the
file already exists on disk by the time it is opened.

Solution: the `OilFileCreated` user event is the correct hook point.
Added an `oil-recipe-file-templates` recipe documenting both a simple
template approach and a precise vim-projectionist shim via
`OilFileCreated`. Updated the tracker status.
This commit is contained in:
Barrett Ruth 2026-03-17 21:05:14 -04:00
parent 4644a64ac5
commit 12db694973
Signed by: barrett
GPG key ID: A6C96C9349D2FC81
2 changed files with 45 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

44
doc/oil.txt
View file

@ -1321,6 +1321,50 @@ path in the clipboard.
end, { desc = "Paste file from clipboard path into oil directory" })
<
*oil-recipe-file-templates*
Apply initial content to newly created files using the |OilFileCreated| event.
This is the recommended alternative to relying on |BufNewFile|, which does not
fire for files created through oil (the file already exists on disk by the
time it is opened). >lua
vim.api.nvim_create_autocmd("User", {
pattern = "OilFileCreated",
callback = function(args)
local path = args.data.path
local ext = vim.fn.fnamemodify(path, ":e")
local templates = {
sh = { "#!/usr/bin/env bash", "" },
py = { "#!/usr/bin/env python3", "" },
}
if templates[ext] then
vim.fn.writefile(templates[ext], path)
end
end,
})
<
For integration with vim-projectionist or any plugin that hooks |BufNewFile|,
use |OilFileCreated| to track oil-created files, then fire |BufNewFile| the
first time each file is opened. This is more precise than checking for empty
buffers on |BufRead|: >lua
local oil_created = {}
vim.api.nvim_create_autocmd("User", {
pattern = "OilFileCreated",
callback = function(args)
oil_created[args.data.path] = true
end,
})
vim.api.nvim_create_autocmd("BufRead", {
callback = function(args)
local path = vim.api.nvim_buf_get_name(args.buf)
if oil_created[path] then
oil_created[path] = nil
vim.api.nvim_exec_autocmds("BufNewFile", { buffer = args.buf })
end
end,
})
<
--------------------------------------------------------------------------------
EVENTS *oil-events*

2
doc/upstream.md
View file

@ -47,7 +47,7 @@ issues against this fork.
| [#254](https://github.com/stevearc/oil.nvim/issues/254) | Buffer modified highlight group | tracked in [#129](https://github.com/barrettruth/canola.nvim/issues/129) |
| [#263](https://github.com/stevearc/oil.nvim/issues/263) | Diff mode | open |
| [#276](https://github.com/stevearc/oil.nvim/issues/276) | Archives manipulation | not actionable — nvim has builtin zip support |
| [#280](https://github.com/stevearc/oil.nvim/issues/280) | vim-projectionist support | open |
| [#280](https://github.com/stevearc/oil.nvim/issues/280) | vim-projectionist support | not actionable — `OilFileCreated` event provides the correct hook; recipe added to docs |
| [#288](https://github.com/stevearc/oil.nvim/issues/288) | Oil failing to load | not actionable — no reliable repro, likely lazy.nvim timing |
| [#289](https://github.com/stevearc/oil.nvim/issues/289) | Show absolute path toggle | not actionable — display solved by `get_win_title`, editing consolidated into [#32](https://github.com/barrettruth/canola.nvim/issues/32) |
| [#294](https://github.com/stevearc/oil.nvim/issues/294) | Can't handle emojis in filenames | not actionable — libuv bug ([nodejs/node#49042](https://github.com/nodejs/node/issues/49042)) |