Neovim Extract

Extract; Draw forth what really matters

Extract puts and yanks to a list with normal, visual swapping, and insert list/register/deoplete completion.

Version 4 Indexes

Version 3

Version 2

Version 1

Things to know

• You can still use "<register>p/P
  • Putting will add to the list if it's a new item.
• Yanking will add to the list if it's a new item.
• If you put/yank a duplicate, with a different *-wise insertion, it will choose the newest *-wise.
• If you put/yank a duplicate that is the same *-wise, it will go to the top of the list, but not add a new occurance.
• If you yank just whitespace or tabs it will ignore it, assuming you don't alter the option.
• You're clipboards will be automatically pulled into the list on a timer, ignoring duplicates.

Usage

Normal and Visual

Putting

Use p/P like normal, once you use it with different registers or you yank text, it will add those to the list. Then, you can use use s to go forward in the list, and S to go backwards. If you want to change whether it pastes linewise/blockwise/characther wise, hit c-s to cycle through them.

Index

You can use insert completion (the c-v mapping by default in insert) or the default normal mappings for / to pick an index (seeing the list), whenever you do this it will select a new one in the list. To see the list you can use o (by default). Late noteworthy thing, when a new yank happens index will reset to 0 to make sure you are pasting in the thing you just yanked.

Examples:

Note: index will start at 4 (top, makes sense) List: Index 4 A <- Will paste B C clip + clip *

List: Index 0 A B C <- Will paste clip + clip *

Swapping

Use ["reg]s motion, this will delete and replace with the register you pick. If no register is specified it will use the default.

Pinning

Use <leader>p to open a input to ask you which you would like to pin. After doing this it will stay at the top of your list, so if even if you add more items to the list, putting will still use that pinned value.

To unpin use <leader>P.

Optinonally you can use ExtractPin and ExtractUnPin on the command line as well.

Insert Mode

Use c-v to paste from the ring, this will make a popup for the ring with the most recent at the top, descending to the least current.

Once selected you can continue typing like usual, or something I use a lot: whenever I yank something, it's usually linewise (like yy), which means that it puts mean on a new line after putting the text, if you then type <c-s> to complete it, it will then switch the *-wise and put you in front of the completed text.

Use <m-s\S> to cycle inside the ring while inside of insert mode.

Use <m-v> to show a popup menu you for your registers.

Global options

" Color options for preview window
let g:extract_preview_colors = {
            \ 'Title':      'Special',
            \ 'CursorLine': 'CursorLine',
            \ 'Separator':  'Function',
            \ 'Index':      'Number',
            \ 'Type':       'Type',
            \ 'Lines':      'Boolean',
            \ 'Content':    'Statement'
            \ }

I Don't Like your mappings...

It's cool, just map these

let g:extract_normal_mappings = {
            \ 'p'         : '<Plug>(extract-put)',
            \ 'P'         : '<Plug>(extract-Put)',
            \ '<leader>p' : ':ExtractPin<cr>A',
            \ '<leader>P' : ':ExtractUnPin<cr>A',
            \ 's '        : '<Plug>(extract-replace-normal)',
            \ 'S '        : '<Plug>(extract-replace-normal)$',
            \ 'ss'        : 'V<Plug>(extract-replace-visual)',
            \ '<leader>o' : '<Plug>(extract-preview)',
            \ '<down>'     : '<Plug>(extract-sin-preview-inc)',
            \ '<up>'     : '<Plug>(extract-sin-preview-dec)'
            \ }

let g:extract_global_mappings = {
            \ '<m-s>' : '<Plug>(extract-sycle)',
            \ '<m-S>' : '<Plug>(extract-Sycle)',
            \ '<c-s>' : '<Plug>(extract-cycle)'
            \ }

let g:extract_visual_mappings = {
            \ 'p' : '<Plug>(extract-put)',
            \ 'P' : '<Plug>(extract-Put)',
            \ 's' : '<Plug>(extract-replace-visual)'
            \ }

let g:extract_insert_mappings = {
            \ '<m-v>' :  '<Plug>(extract-completeReg)',
            \ '<c-v>' :  '<Plug>(extract-completeList)',
            \ '<c-s>' :  '<Plug>(extract-cycle)',
            \ '<m-s>' :  '<Plug>(extract-sycle)',
            \ '<m-S>' :  '<Plug>(extract-Sycle)'
            \ }