Neovim plugin to copy the reference path of a Python symbol.

• Supports copying different path formats (see examples):
  • Dotted path (e.g. some.module.func_1)
  • Import path (e.g. from some.module import func_1)
• Supports various Python symbol definitions (see Getting started)
• Simple Python project root detection
• Allow copy to user-specified register
• No LSP setup required

Requires Neovim >=0.8.0.

With folke/lazy.nvim:

-- Stable version
{
  'AnsonH/copy-python-path.nvim',
  version = '*',
  cmd = { "CopyPythonPath" },
}

With wbthomason/packer.nvim:

-- Stable version
use {"AnsonH/copy-python-path.nvim", tag = "*" }

Open a Python file and place the cursor on the following supported symbols:

• Function definitions (e.g. def func_1(), async def func_2())
• Class definitions (e.g. class MyClass:)
• Class methods and inner classes
• Module-level variable definitions
• Imported symbols (e.g. import numpy as np, from some.module import func_1)

Then, run the command :CopyPythonPath <format> to copy to clipboard:

• :CopyPythonPath dotted - Copies the dotted path (e.g. some.module.func_1)
• :CopyPythonPath import - Copies the import path (e.g. from some.module import func_1)

Let's say we have a file called app.py:

""" app.py """
import numpy as np
from user.models import User

# (1) 👇
def func_1():
    pass

# (2) 👇
async def func_2():
    pass

# (3) 👇
class MyClass:
    # (4) 👇
    class Meta:
        pass

    # (5) 👇
    def method_1(self):
        # (6) 👇
        User()
        #  (7) 👇
        return np.array([])

# (8) 👇
MODULE_VAR = 'foo'

Notes:

1. Inner classes and class methods cannot be directly imported, so it only imports the outer class.
2. When the symbol is imported, it copies the original path of where it was imported from.

This plugin does NOT set up any keymappings by default. You can define custom keymappings in your Neovim config, for example:

vim.api.nvim_set_keymap('n', '<Leader>yd', ':CopyPythonPath dotted<CR>', { noremap = true, silent = true })
vim.api.nvim_set_keymap('n', '<Leader>yi', ':CopyPythonPath import<CR>', { noremap = true, silent = true })

:CopyPythonPath <format> [<register>]

Copies the reference path of the Python symbol under the cursor.

The plugin API is available via:

local copy_python_path = require('copy-python-path')

Gets the Python path of the symbol underneath the cursor.

--- Gets the Python path of the symbol underneath the cursor.
---@param format string The Python path format. Accepted values are:
---  - `"dotted"`: Dotted path (e.g. `user.models.User`)
---  - `"import"`: Import statement (e.g. `from user.models import User`)
---@return string path
copy_python_path.get_path_under_cursor(format)

Example: Copy the shell command for running a Django test:

-- e.g. `./manage.py test some.module.func_1`
vim.api.nvim_create_user_command("CopyDjangoTestCommand", function(opts)
    local copy_python_path = require("copy-python-path")

    local path = copy_python_path.get_path_under_cursor("dotted")
    local command = "./manage.py test " .. path

    vim.fn.setreg("+", command)
end, {})

• kawamataryo/copy-python-path - VS Code plugin that inspired this project
• ranelpadon/python-copy-reference.vim - Vim Script plugin with similar functionality

Special thanks to neovim-plugin-boilerplate for the plugin boilerplate code.