feat: initial commit

Author: sQVe

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.gitignore

@@ -0,0 +1 @@
+node_modules/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Oskar Grunning
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1 @@
+# bufignore

lua/bufignore/config.lua

@@ -0,0 +1,24 @@
+local defaults = require('bufignore.defaults')
+
+--- @class Config
+--- @field private _user_config UserConfig
+local M = {}
+
+M._user_config = nil
+
+--- Gets the user's configuration.
+--- @return UserConfig config The current configuration.
+M.get_user_config = function()
+  return M._user_config
+end
+
+--- Sets up the configuration.
+--- @param overrides? UserConfig Configration which will override the defaults.
+--- @return UserConfig config The configuration.
+M.setup = function(overrides)
+  M._user_config = vim.tbl_deep_extend('force', defaults, overrides or {})
+
+  return M._user_config
+end
+
+return M

lua/bufignore/defaults.lua

@@ -0,0 +1,11 @@
+--- @alias ConfigCallback fun(event: { bufnr: number, file_path: string }): boolean
+
+--- @class UserConfig
+--- @field auto_start boolean
+--- @field callback ConfigCallback | false | nil TODO
+local defaults = {
+  auto_start = true,
+  callback = nil,
+}
+
+return defaults

lua/bufignore/dispatcher.lua

@@ -0,0 +1,51 @@
+local queue = require('bufignore.queue')
+
+local augroup =
+  vim.api.nvim_create_augroup('bufignore-augroup', { clear = true })
+
+--- @class Dispatcher
+--- @field private _is_bound boolean
+local M = {}
+
+M._is_bound = false
+
+--- Binds event listeners for the plugin.
+M.bind_events = function()
+  if not M._is_bound then
+    -- Listen for `BufHidden` events and enqueue the file for
+    -- processing.
+    vim.api.nvim_create_autocmd('BufHidden', {
+      group = augroup,
+      callback = function(event)
+        queue.enqueue_file(vim.fn.fnamemodify(event.file, ':p'))
+      end,
+    })
+
+    -- Listen for `DirChanged` events and enqueue all buffers for
+    -- processing.
+    vim.api.nvim_create_autocmd('DirChanged', {
+      group = augroup,
+      callback = function()
+        local bufnrs = vim.api.nvim_list_bufs()
+
+        queue.clear_queue()
+        for _, bufnr in ipairs(bufnrs) do
+          queue.enqueue_file(vim.api.nvim_buf_get_name(bufnr))
+        end
+      end,
+    })
+
+    M._is_bound = true
+  end
+end
+
+--- Unbinds event listeners for the plugin.
+M.unbind_events = function()
+  if M._is_bound then
+    vim.api.nvim_clear_autocmds({ group = augroup })
+
+    M._is_bound = false
+  end
+end
+
+return M

lua/bufignore/file-processor.lua

@@ -0,0 +1,52 @@
+local config = require('bufignore.config')
+
+--- @class FileProcessor
+local M = {}
+
+--- Checks if a buffer meets the requirements for unlisting.
+--- @param bufnr number The buffer number.
+--- @param file_path string The path of the file associated with the buffer.
+--- @return boolean `true` if the buffer meets the unlisting requirements, otherwise `false`.
+M._is_valid_for_unlisting = function(bufnr, file_path)
+  local user_config = config.get_user_config()
+
+  -- Buffer is not visible
+  return vim.fn.bufwinid(bufnr) == -1
+    -- Buffer is valid
+    and vim.api.nvim_buf_is_valid(bufnr)
+    -- Buffer is loaded
+    and vim.api.nvim_buf_is_loaded(bufnr)
+    -- Buffer is listed
+    and vim.api.nvim_buf_get_option(bufnr, 'buflisted')
+    -- User-defined callback is either falsy or returns true.
+    and (
+      not user_config.callback
+      or user_config.callback({ bufnr = bufnr, file_path = file_path })
+    )
+end
+
+--- Unlists a buffer for an ignored file.
+--- @param file_path string The path of the ignored file.
+--- @private
+M._unlist_ignored_file = function(file_path)
+  -- Schedules main event-loop invocation to preventing textlock issues.
+  vim.schedule(function()
+    ---@diagnostic disable-next-line: param-type-mismatch
+    local bufnr = vim.fn.bufnr(file_path)
+
+    if M._is_valid_for_unlisting(bufnr, file_path) then
+      -- Unlist git ignored file buffer.
+      vim.api.nvim_buf_set_option(bufnr, 'buflisted', false)
+    end
+  end)
+end
+
+--- Unlists buffers for ignored files.
+---@param file_paths string[] The paths of the ignored files.
+M.unlist_ignored_files = function(file_paths)
+  for _, file_path in ipairs(file_paths) do
+    M._unlist_ignored_file(file_path)
+  end
+end
+
+return M

lua/bufignore/git.lua

@@ -0,0 +1,36 @@
+local Job = require('plenary.job')
+
+--- @class Git
+local M = {}
+
+--- Checks if files are ignored by Git.
+--- @param file_paths string[] The list of file paths to check for ignore status.
+--- @param callback function The callback function that receives the ignored file paths.
+M.check_ignore = function(file_paths, callback)
+  local args = { 'check-ignore' }
+
+  for _, file_path in ipairs(file_paths) do
+    table.insert(args, file_path)
+  end
+
+  -- Execute the Git command.
+  Job:new({
+    command = 'git',
+    args = args,
+    on_exit = function(_, exit_code)
+      if exit_code > 0 then
+        callback({})
+      end
+    end,
+    on_stdout = function(_, data)
+      local ignored_file_paths = {}
+      for line in data:gmatch('([^\n]+)') do
+        table.insert(ignored_file_paths, line)
+      end
+
+      callback(ignored_file_paths)
+    end,
+  }):start()
+end
+
+return M

lua/bufignore/init.lua

@@ -0,0 +1,27 @@
+local config = require('bufignore.config')
+local dispatcher = require('bufignore.dispatcher')
+
+--- @class Init
+local M = {}
+
+--- Sets up the plugin.
+--- @param overrides? UserConfig Configration which will override the defaults.
+M.setup = function(overrides)
+  local user_config = config.setup(overrides)
+
+  if user_config.auto_start then
+    M.start()
+  end
+end
+
+--- Starts the plugin.
+M.start = function()
+  dispatcher.bind_events()
+end
+
+--- Stops the plugin.
+M.stop = function()
+  dispatcher.unbind_events()
+end
+
+return M