https://github.com/jtroo/telescope-buffer-extract

https://github.com/jtroo/telescope-buffer-extract

clipboard convenience ergonomics fuzzy-search lua neovim nvim paste plugin telescope-extension terminal text

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/jtroo/telescope-buffer-extract
• Owner: jtroo
• Created: 2023-02-19T06:44:46.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-07-29T20:45:15.000Z (about 1 year ago)
• Last Synced: 2024-04-16T03:06:06.591Z (5 months ago)
• Topics: clipboard, convenience, ergonomics, fuzzy-search, lua, neovim, nvim, paste, plugin, telescope-extension, terminal, text
• Language: Lua
• Homepage:
• Size: 12.7 KB
• Stars: 9
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Telescope buffer extract

![WindowsTerminal_f29utBfQhh](https://user-images.githubusercontent.com/6634136/219940608-398c6145-a0df-4c47-9c1b-45cdb9d0c408.gif)

## What does this do?

This allows you to fuzzy-select a word or line from the current buffer using

telescope and then either paste the selection at the current position, or copy

the selection to your clipboard.

The inspiration for this plugin came from the tmux

[extrakto](https://github.com/laktak/extrakto) plugin. The reason I created

this was for better ergonomics in the Neovim terminal for the use case of

pasting terminal output back into the terminal input, or copying terminal

output for use elsewhere.

## Installation

I have no idea how modern-day Neovim plugin installation works. I still use pathogen

with vendored plugins. Using pathogen, git clone into the `bundle` directory.

You must have [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim)

installed as well for this plugin to do anything.

## How to use

This plugin automatically adds two new commands that open pickers. After the

telescope picker closes, you will automatically go back to insert or terminal

mode, depending on the active buffer. This is the default behaviour, but can be

overridden.

    :TelescopeBufferExtractWord

    :TelescopeBufferExtractLine

Alternatively, with Lua:

    :lua require'telescope-buffer-extract'.pick_word()

    :lua require'telescope-buffer-extract'.pick_line()

If you do not want to enter insert/terminal mode after running the functions, do:

    :lua require'telescope-buffer-extract'.pick_word({no_insert_mode = true})

    :lua require'telescope-buffer-extract'.pick_line({no_insert_mode = true})

With the picker open, pressing `Tab` will paste the selection at the cursor's

current location. Pressing `Enter` will copy the selection into the `+`

register (usually the OS clipboard).

## How I (jtroo) use it

I use the Neovim terminal only when I'm working in Windows, otherwise on Linux

I'm using tmux. I have some keybindings to emulate tmux workflows inside the

Neovim terminal. The ones calling this plugin in particular are:

    " by word

    tnoremap  :TelescopeBufferExtractWord

    " by line

    tnoremap ` :TelescopeBufferExtractLine

These are terminal-mode mappings (like insert, but within a terminal) which

will open the picker and then go back to terminal-mode once a selection is

made.