Decorated Yank

Decorate your yanks with the filename and line numbers.

Installation

• neovim 0.5.0+ required
• nvim-lua/plenary.nvim
• install using your favorite plugin manager

Packer

  use {
    'simondrake/decorated_yank',
    requires = { "nvim-lua/plenary.nvim" }
  }

Lazy

	{ "simondrake/decorated_yank", dependencies = { "nvim-lua/plenary.nvim" } },

Set-up

If you won't be using decorated_yank_with_link(), you can simply call require('decorated_yank').setup(). If you will be using decorated_yank_with_link(), see the Configuration section below.

Configuration

For the decorated_yank_with_link(), you need to tell the plug-in the format of the links you will be using. This comes in three parts:

• url - The domain itself (e.g. github.com). Note: Do not include the schema (i.e. https)
• blob - The format of the blob in the URL (e.g. for GitHub it's /blob/, for GitLab it's /-/blob)
• line_format - The format of the line numbers (e.g. for GitHub it's L<start>-L<end>, for GitLab it's L<start>-<end>)

For example, if you are working on a self-hosted instance of GitLab and GitHub, you could set-up your configuration like so:

require('decorated_yank').setup({
  domains = {
    github = {
      url = "github.com",
      blob = "/blob/",
      line_format = "#L%s-L%s",
    },
    yourKeyHere = {
      url = "your.custom.domain",
      blob = "/-/blob/",
      line_format = "#L%s-%s",
    }
  }
})

Note: The object key (e.g. yourKeyHere above) is not important.

Decorating

Note: Decorated Yank currently only works with visual selection.

File Name and Line Numbers

:'<,'>lua require('decorated_yank').decorated_yank()

------------------------
file name: internal/notes/notes.go
------------------------

15 type NoteReader interface {
16 	ListNotes() ([]Note, error)
17 	GetNoteByID(int) (*Note, error)
18 	GetNoteByTitle(string) (*Note, error)
19 }

A mapping (in this case ctrl + y) can be defined like this:

vim.keymap.set("v", "<C-y>", function() require('decorated_yank').decorated_yank() end)

File Name, Line Numbers, and Link

:'<,'>lua require('decorated_yank').decorated_yank_with_link()

------------------------
file name: internal/notes/notes.go

type name: NoteReader

link: https://github.com/simondrake/copy-paste-notes/blob/9dc72ec691a561b543c3116a20413ec1d3b18beb/internal/notes/notes.go#L15-L19
------------------------

15 type NoteReader interface {
16 	ListNotes() ([]Note, error)
17 	GetNoteByID(int) (*Note, error)
18 	GetNoteByTitle(string) (*Note, error)
19 }

A mapping (in this case ctrl + y) can be defined like this:

vim.keymap.set("v", "<C-y>", function() require('decorated_yank').decorated_yank_with_link() end)