WhiteBlackGoose/ts-advanced-git-search.nvim

Telescope Advanced Git Search

🖥️ Usage

📖 Open a picker

:Telescope advanced_git_search {function_name}

or in lua

require('telescope').extensions.advanced_git_search.{function_name}()

🔎 Enter a query

Your usual telescope experience. See the individual commands for the grep behaviour.

✏️ Further search on commit author with @

The prompt is split on @. Everything following the @ is the pattern for the author name.

⚡️Commands

1. diff_branch_file

Opens a Telescope window with a list of local branches

Keymaps

• <CR> opens a diff for the current file with the selected branch

2. diff_commit_line

Opens a Telescope window with a list of previous commit logs with respect to selected lines

Note: First you have to select the lines in visual mode, then go back to normal mode and execute this command.

Keymaps

• <CR> opens a diff for the current file with the selected commit
• <C-o> opens a the selected commit in the browser

3. diff_commit_file

Opens a Telescope window with a list of git commits that changed the current file (renames included)

Keymaps

• <CR> Opens a diff of the current file with the selected commit
• <C-e> Opens an entire git diff of the selected commit
• <C-o> Open the selected commit in the browser

4. search_log_content

Opens a Telescope window with a list of previous commit logs filtered on the content of the commits.

Keymaps

• <CR> opens a diff for the current file with the selected commit
• <C-o> opens the selected commit in the browser

5. checkout_reflog

Opens a Telescope window with all reflog entries

Keymaps

• <CR> checkout the reflog entry

6. show_custom_functions

A telescope picker for all functions above.

⚙️ Installation

With Lazy

    {
        "aaronhallaert/ts-advanced-git-search.nvim",
        config = function()
            require("telescope").load_extension("advanced_git_search")
        end,
        dependencies = {
            "nvim-telescope/telescope.nvim",
            -- to show diff splits and open commits in browser
            "tpope/vim-fugitive",
        },
    }

With Packer

    use({
        "aaronhallaert/ts-advanced-git-search.nvim",
        config = function()
            require("telescope").load_extension("advanced_git_search")
        end,
        requires = {
            "nvim-telescope/telescope.nvim",
            -- to show diff splits and open commits in browser
            "tpope/vim-fugitive",
        },
    })

Prerequisites

• git
• vim-fugitive
• telescope.nvim