[{"result":{"data":[{"id":"4afda660-5cca-441d-a510-7529f16d3166","title":"refactor!: disable netrw by default (#155)","text":"refactor!: disable netrw by default (#155)\n\nIf you use oil and you want to still use netrw, set\n`default_file_explorer = false`.\n\nIt is nonsensical to both use netrw _and_ have oil hijack directory\nbuffers (which was the case for the default config). It also causes\nundefined behavior and bugs. When `default_file_explorer = true` (the\ndefault) oil will now disable netrw for you.","type":"breaking-change","createdAt":"2023-08-20T02:10:38.188Z","breakingChange":{"id":34,"postId":"4afda660-5cca-441d-a510-7529f16d3166","pluginId":108,"externalUrl":"https://github.com/stevearc/oil.nvim/commit/9d90893c377b6b75230e4bad177f8d0103ceafe4","sha":"9d90893c377b6b75230e4bad177f8d0103ceafe4","plugin":{"id":108,"owner":"stevearc","name":"oil.nvim","type":"github","source":"awesome-neovim","category":"file-explorer","link":"https://github.com/stevearc/oil.nvim","shortDescription":"Neovim file explorer: edit your filesystem like a buffer","createdAt":"2023-03-22T19:35:21.577Z","readme":"# oil.nvim\n\nA [vim-vinegar](https://github.com/tpope/vim-vinegar) like file explorer that lets you edit your filesystem like a normal Neovim buffer.\n\nhttps://user-images.githubusercontent.com/506791/209727111-6b4a11f4-634a-4efa-9461-80e9717cea94.mp4\n\n\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Quick start](#quick-start)\n- [Options](#options)\n- [Adapters](#adapters)\n- [API](#api)\n- [FAQ](#faq)\n\n\n\n## Requirements\n\n- Neovim 0.8+\n- (optional) [nvim-web-devicons](https://github.com/nvim-tree/nvim-web-devicons) for file icons\n\n## Installation\n\noil.nvim supports all the usual plugin managers\n\n

lazy.nvim

\n\n```lua\n{\n 'stevearc/oil.nvim',\n opts = {},\n -- Optional dependencies\n dependencies = { \"nvim-tree/nvim-web-devicons\" },\n}\n```\n\n

\n\n

Packer

\n\n```lua\nrequire('packer').startup(function()\n use {\n 'stevearc/oil.nvim',\n config = function() require('oil').setup() end\n }\nend)\n```\n\n

\n\n

Paq

\n\n```lua\nrequire \"paq\" {\n {'stevearc/oil.nvim'};\n}\n```\n\n

\n\n

vim-plug

\n\n```vim\nPlug 'stevearc/oil.nvim'\n```\n\n

\n\n

dein

\n\n```vim\ncall dein#add('stevearc/oil.nvim')\n```\n\n

\n\n

Pathogen

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/oil.nvim.git ~/.vim/bundle/\n```\n\n

\n\n

Neovim native package

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/oil.nvim.git \\\n \"${XDG_DATA_HOME:-$HOME/.local/share}\"/nvim/site/pack/oil/start/oil.nvim\n```\n\n

\n\n## Quick start\n\nAdd the following to your init.lua\n\n```lua\nrequire(\"oil\").setup()\n```\n\nThen open a directory with `nvim .`. Use `` to open a file/directory, and `-` to go up a directory. Otherwise, just treat it like a normal buffer and make changes as you like. Remember to `:w` when you're done to actually perform the actions.\n\nIf you want to mimic the `vim-vinegar` method of navigating to the parent directory of a file, add this keymap:\n\n```lua\nvim.keymap.set(\"n\", \"-\", \"Oil\", { desc = \"Open parent directory\" })\n```\n\nYou can open a directory with `:edit ` or `:Oil `. To open oil in a floating window, do `:Oil --float `.\n\n## Options\n\n```lua\nrequire(\"oil\").setup({\n -- Oil will take over directory buffers (e.g. `vim .` or `:e src/`)\n -- Set to false if you still want to use netrw.\n default_file_explorer = true,\n -- Id is automatically added at the beginning, and name at the end\n -- See :help oil-columns\n columns = {\n \"icon\",\n -- \"permissions\",\n -- \"size\",\n -- \"mtime\",\n },\n -- Buffer-local options to use for oil buffers\n buf_options = {\n buflisted = false,\n bufhidden = \"hide\",\n },\n -- Window-local options to use for oil buffers\n win_options = {\n wrap = false,\n signcolumn = \"no\",\n cursorcolumn = false,\n foldcolumn = \"0\",\n spell = false,\n list = false,\n conceallevel = 3,\n concealcursor = \"nvic\",\n },\n -- Send deleted files to the trash instead of permanently deleting them (:help oil-trash)\n delete_to_trash = false,\n -- Skip the confirmation popup for simple operations\n skip_confirm_for_simple_edits = false,\n -- Change this to customize the command used when deleting to trash\n trash_command = \"trash-put\",\n -- Selecting a new/moved/renamed file or directory will prompt you to save changes first\n prompt_save_on_select_new_entry = true,\n -- Keymaps in oil buffer. Can be any value that `vim.keymap.set` accepts OR a table of keymap\n -- options with a `callback` (e.g. { callback = function() ... end, desc = \"\", nowait = true })\n -- Additionally, if it is a string that matches \"actions.\",\n -- it will use the mapping at require(\"oil.actions\").\n -- Set to `false` to remove a keymap\n -- See :help oil-actions for a list of all available actions\n keymaps = {\n [\"g?\"] = \"actions.show_help\",\n [\"\"] = \"actions.select\",\n [\"\"] = \"actions.select_vsplit\",\n [\"\"] = \"actions.select_split\",\n [\"\"] = \"actions.select_tab\",\n [\"\"] = \"actions.preview\",\n [\"\"] = \"actions.close\",\n [\"\"] = \"actions.refresh\",\n [\"-\"] = \"actions.parent\",\n [\"_\"] = \"actions.open_cwd\",\n [\"`\"] = \"actions.cd\",\n [\"~\"] = \"actions.tcd\",\n [\"gs\"] = \"actions.change_sort\",\n [\"gx\"] = \"actions.open_external\",\n [\"g.\"] = \"actions.toggle_hidden\",\n },\n -- Set to false to disable all of the above keymaps\n use_default_keymaps = true,\n view_options = {\n -- Show files and directories that start with \".\"\n show_hidden = false,\n -- This function defines what is considered a \"hidden\" file\n is_hidden_file = function(name, bufnr)\n return vim.startswith(name, \".\")\n end,\n -- This function defines what will never be shown, even when `show_hidden` is set\n is_always_hidden = function(name, bufnr)\n return false\n end,\n sort = {\n -- sort order can be \"asc\" or \"desc\"\n -- see :help oil-columns to see which columns are sortable\n { \"type\", \"asc\" },\n { \"name\", \"asc\" },\n },\n },\n -- Configuration for the floating window in oil.open_float\n float = {\n -- Padding around the floating window\n padding = 2,\n max_width = 0,\n max_height = 0,\n border = \"rounded\",\n win_options = {\n winblend = 0,\n },\n -- This is the config that will be passed to nvim_open_win.\n -- Change values here to customize the layout\n override = function(conf)\n return conf\n end,\n },\n -- Configuration for the actions floating preview window\n preview = {\n -- Width dimensions can be integers or a float between 0 and 1 (e.g. 0.4 for 40%)\n -- min_width and max_width can be a single value or a list of mixed integer/float types.\n -- max_width = {100, 0.8} means \"the lesser of 100 columns or 80% of total\"\n max_width = 0.9,\n -- min_width = {40, 0.4} means \"the greater of 40 columns or 40% of total\"\n min_width = { 40, 0.4 },\n -- optionally define an integer/float for the exact width of the preview window\n width = nil,\n -- Height dimensions can be integers or a float between 0 and 1 (e.g. 0.4 for 40%)\n -- min_height and max_height can be a single value or a list of mixed integer/float types.\n -- max_height = {80, 0.9} means \"the lesser of 80 columns or 90% of total\"\n max_height = 0.9,\n -- min_height = {5, 0.1} means \"the greater of 5 columns or 10% of total\"\n min_height = { 5, 0.1 },\n -- optionally define an integer/float for the exact height of the preview window\n height = nil,\n border = \"rounded\",\n win_options = {\n winblend = 0,\n },\n },\n -- Configuration for the floating progress window\n progress = {\n max_width = 0.9,\n min_width = { 40, 0.4 },\n width = nil,\n max_height = { 10, 0.9 },\n min_height = { 5, 0.1 },\n height = nil,\n border = \"rounded\",\n minimized_border = \"none\",\n win_options = {\n winblend = 0,\n },\n },\n})\n```\n\n## Adapters\n\nOil does all of its filesystem interaction through an _adapter_ abstraction. In practice, this means that oil can be used to view and modify files in more places than just the local filesystem, so long as the destination has an adapter implementation.\n\nNote that file operations work _across adapters_. This means that you can use oil to copy files to/from a remote server using the ssh adapter just as easily as you can copy files from one directory to another on your local machine.\n\n### SSH\n\nThis adapter allows you to browse files over ssh, much like netrw. To use it, simply open a buffer using the following name template:\n\n```\nnvim oil-ssh://[username@]hostname[:port]/[path]\n```\n\nThis may look familiar. In fact, this is the same url format that netrw uses.\n\nNote that at the moment the ssh adapter does not support Windows machines, and it requires the server to have a `/bin/sh` binary as well as standard unix commands (`rm`, `mv`, `mkdir`, `chmod`, `cp`, `touch`, `ln`, `echo`).\n\n## API\n\n\n\n- [get_entry_on_line(bufnr, lnum)](doc/api.md#get_entry_on_linebufnr-lnum)\n- [get_cursor_entry()](doc/api.md#get_cursor_entry)\n- [discard_all_changes()](doc/api.md#discard_all_changes)\n- [set_columns(cols)](doc/api.md#set_columnscols)\n- [set_sort(sort)](doc/api.md#set_sortsort)\n- [set_is_hidden_file(is_hidden_file)](doc/api.md#set_is_hidden_fileis_hidden_file)\n- [toggle_hidden()](doc/api.md#toggle_hidden)\n- [get_current_dir()](doc/api.md#get_current_dir)\n- [open_float(dir)](doc/api.md#open_floatdir)\n- [toggle_float(dir)](doc/api.md#toggle_floatdir)\n- [open(dir)](doc/api.md#opendir)\n- [close()](doc/api.md#close)\n- [select(opts, callback)](doc/api.md#selectopts-callback)\n- [save(opts)](doc/api.md#saveopts)\n- [setup(opts)](doc/api.md#setupopts)\n\n\n\n## FAQ\n\n**Q: Why \"oil\"**?\n\n**A:** From the [vim-vinegar](https://github.com/tpope/vim-vinegar) README, a quote by Drew Neil:\n\n> Split windows and the project drawer go together like oil and vinegar\n\nVinegar was taken. Let's be oil.\nPlus, I think it's pretty slick ;)\n\n**Q: Why would I want to use oil vs any other plugin?**\n\n**A:**\n\n- You like to use a netrw-like view to browse directories (as opposed to a file tree)\n- AND you want to be able to edit your filesystem like a buffer\n- AND you want to perform cross-directory actions. AFAIK there is no other plugin that does this. (update: [mini.files](https://github.com/echasnovski/mini.nvim/blob/main/readmes/mini-files.md) also offers this functionality)\n\nIf you don't need those features specifically, check out the alternatives listed below\n\n**Q: Why write another plugin yourself instead of adding functionality to one that already exists**?\n\n**A:** Because I am a _maniac control freak_.\n\n**Q: Can oil display files as a tree view**?\n\n**A:** No. A tree view would require a completely different methodology, necessitating a complete rewrite. I don't use tree views, so I will leave this as a plugin for someone else to write.\n\n**Q: What are some alternatives?**\n\n**A:**\n\n- [mini.files](https://github.com/echasnovski/mini.nvim/blob/main/readmes/mini-files.md): A newer plugin that also supports cross-directory filesystem-as-buffer edits. It utilizes a unique column view.\n- [vim-vinegar](https://github.com/tpope/vim-vinegar): The granddaddy. This made me fall in love with single-directory file browsing. I stopped using it when I encountered netrw bugs and performance issues.\n- [defx.nvim](https://github.com/Shougo/defx.nvim): What I switched to after vim-vinegar. Much more flexible and performant, but requires python and the API is a little hard to work with.\n- [dirbuf.nvim](https://github.com/elihunter173/dirbuf.nvim): The first plugin I encountered that let you edit the filesystem like a buffer. Never used it because it [can't do cross-directory edits](https://github.com/elihunter173/dirbuf.nvim/issues/7).\n- [lir.nvim](https://github.com/tamago324/lir.nvim): What I used prior to writing this plugin. Similar to vim-vinegar, but with better Neovim integration (floating windows, lua API).\n- [vim-dirvish](https://github.com/justinmk/vim-dirvish): Never personally used, but well-established, stable, simple directory browser.\n- [vidir](https://github.com/trapd00r/vidir): Never personally used, but might be the first plugin to come up with the idea of editing a directory like a buffer.\n\nThere's also file trees like [neo-tree](https://github.com/nvim-neo-tree/neo-tree.nvim) and [nvim-tree](https://github.com/nvim-tree/nvim-tree.lua), but they're really a different category entirely.\n","dotfyleShieldAddedAt":null,"stars":1253,"lastSyncedAt":"2023-09-26T02:13:47.410Z","addedLastWeek":8}}},{"id":"85e18c9e-56a7-4f01-b5b2-4ee15f4f265f","title":"fix!: selecting multiple files only opens buffers, not windows (#111)","text":"fix!: selecting multiple files only opens buffers, not windows (#111)\n\nIn an oil buffer you can select multiple entries by highlighting them in\nvisual mode and then calling `oil.select()` (or using a keymap that does\nso, like `` or ``. Previously we would automatically assume\nthat you wanted to open multiple entries as splits. Now, we treat a\ndefault call to `select()` (which is what `` does) as if you simply\nwanted to open the buffers and keep the same window. This plays nicer\nwith bufferlines. If you want the old behavior, you can explicitly pass\nin `oil.select({vertical = true})` or use the `` keymap when you\nhave multiple entries selected.","type":"breaking-change","createdAt":"2023-06-22T22:40:04.873Z","breakingChange":{"id":4,"postId":"85e18c9e-56a7-4f01-b5b2-4ee15f4f265f","pluginId":108,"externalUrl":"https://github.com/stevearc/oil.nvim/commit/393f0dcf82f04de597e194ec120d8cbe6fe212a8","sha":"393f0dcf82f04de597e194ec120d8cbe6fe212a8","plugin":{"id":108,"owner":"stevearc","name":"oil.nvim","type":"github","source":"awesome-neovim","category":"file-explorer","link":"https://github.com/stevearc/oil.nvim","shortDescription":"Neovim file explorer: edit your filesystem like a buffer","createdAt":"2023-03-22T19:35:21.577Z","readme":"# oil.nvim\n\nA [vim-vinegar](https://github.com/tpope/vim-vinegar) like file explorer that lets you edit your filesystem like a normal Neovim buffer.\n\nhttps://user-images.githubusercontent.com/506791/209727111-6b4a11f4-634a-4efa-9461-80e9717cea94.mp4\n\n\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Quick start](#quick-start)\n- [Options](#options)\n- [Adapters](#adapters)\n- [API](#api)\n- [FAQ](#faq)\n\n\n\n## Requirements\n\n- Neovim 0.8+\n- (optional) [nvim-web-devicons](https://github.com/nvim-tree/nvim-web-devicons) for file icons\n\n## Installation\n\noil.nvim supports all the usual plugin managers\n\n

lazy.nvim

\n\n```lua\n{\n 'stevearc/oil.nvim',\n opts = {},\n -- Optional dependencies\n dependencies = { \"nvim-tree/nvim-web-devicons\" },\n}\n```\n\n

\n\n

Packer

\n\n```lua\nrequire('packer').startup(function()\n use {\n 'stevearc/oil.nvim',\n config = function() require('oil').setup() end\n }\nend)\n```\n\n

\n\n

Paq

\n\n```lua\nrequire \"paq\" {\n {'stevearc/oil.nvim'};\n}\n```\n\n

\n\n

vim-plug

\n\n```vim\nPlug 'stevearc/oil.nvim'\n```\n\n

\n\n

dein

\n\n```vim\ncall dein#add('stevearc/oil.nvim')\n```\n\n

\n\n

Pathogen

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/oil.nvim.git ~/.vim/bundle/\n```\n\n

\n\n

Neovim native package

\n\n```sh\ngit clone --depth=1 https://github.com/stevearc/oil.nvim.git \\\n \"${XDG_DATA_HOME:-$HOME/.local/share}\"/nvim/site/pack/oil/start/oil.nvim\n```\n\n