Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/braxtons12/blame_line.nvim
A simple and configurable git blame line annotation for Neovim 0.7+ using pure lua
https://github.com/braxtons12/blame_line.nvim
Last synced: 11 days ago
JSON representation
A simple and configurable git blame line annotation for Neovim 0.7+ using pure lua
- Host: GitHub
- URL: https://github.com/braxtons12/blame_line.nvim
- Owner: braxtons12
- License: mit
- Created: 2022-06-13T03:01:44.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-25T06:12:32.000Z (5 months ago)
- Last Synced: 2024-03-01T07:34:13.360Z (4 months ago)
- Language: Lua
- Size: 583 KB
- Stars: 25
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - braxtons12/blame_line.nvim - A simple and configurable git blame line annotation for Neovim 0.7+ using pure lua (Lua)
README
blame_line.nvim
A simple and configurable git blame line using virtual text for Neovim 0.7+ built using lua.
This plugin provides a virtual-text annotation containing user-specified info from `git blame`
for the current line.
This plugin is implemented completely in lua, but is heavily inspired by and in some ways
is a fork & rewrite of blamer.nvim by APZelos (see https://github.com/APZelos/blamer.nvim).
The primary reason for this plugin's existence is that existing offerings either
(1) didn't work on all platforms (e.g., Windows) (or at all) or
(2) were too slow and introduced flicker in the current line (this is the case for blamer.nvim).
This plugin aims to solve both of those problems.
# Table of Contents
- [Requirements](#requirements)
- [Installation](#installation)
- [Quickstart](#quickstart)
- [Setup](#setup)
- [Commands](#commands)
## Requirements
* Requires Neovim version 0.7 or higher and `git` installed and in `PATH`
## Installation
* Simply install like you would any other plugin using your favorite package manager, e.g. with packer.nvim:
```lua
local packer = require("packer")
packer.use { "braxtons12/blame_line.nvim",
config = function()
require("blame_line").setup {
}
end
}
```
## Quickstart
### Setup
* Setup and configuration uses lua. The setup with packer.nvim, with default configuration options, is shown below:
```lua
local packer = require("packer")
packer.use { "braxtons12/blame_line.nvim",
config = function()
require("blame_line").setup {
-- whether the blame line should be shown in visual modes
show_in_visual = true,
-- whether the blame line should be shown in insert mode
show_in_insert = true,
-- the string to prefix the blame line with
prefix = " ",
-- String specifying the the blame line format.
-- Any combination of the following specifiers, along with any additional text.
-- - `""` - the author of the change.
-- - `""` - the email of the author.
-- - `""` - the time the author made the change.
-- - `""` - the person who committed the change to the repository.
-- - `""` - the email of the committer.
-- - `""` - the time the change was committed to the repository.
-- - `""` - the commit summary/message.
-- - `""` - short portion of the commit hash.
-- - `""` - the full commit hash.
template = " • • ",
-- The date format settings, for `""` and `""`
date = {
-- whether the date should be relative instead of precise
-- (I.E. "3 days ago" instead of "09-06-2022".
relative = true,
-- `strftime` compatible format string.
-- Only used if `date.relative == false`
format = "%d-%m-%y",
},
-- The highlight group to highlight the blame line with.
-- The highlight of this group defaults to `Comment`.
hl_group = "BlameLineNvim",
-- The delay in milliseconds between a cursor movement and
-- when the blame line should appear/update
delay = 0,
}
end
}
```
### Commands
* blame_line.nvim only provides three commands, all for enabling/disabling the plugin:
- `BlameLineEnable` (in lua, `require("blame_line").enable()`)- Enables the blame line for files tracked by git, in modes valid for the current configuration (see `blame_line.setup.show_in_insert` and see `blame_line.setup.show_in_visual`).
By default, the blame line is enabled
- `BlameLineDisable` (in lua, `require("blame_line").disable()`)- Disables the blame line completely until the user calls `BlameLineEnable` or `lua require("blame_line").enable()` to re-enable the blame line.
- `BlameLineToggle` - Toggles whether the blame line is enabled.
Equivalent to calling `BlameLineEnable` if the blame line is disabled or `BlameLineDisable` if it is enabled.