pyfixy.nvim

A tiny Neovim + Rust LSP sidecar for pytest fixtures.

pyfixy.nvim provides pytest fixture-only LSP features:

• completion for fixture names in test function parameters
• go to definition from fixture parameter to fixture declaration
• references from fixture definitions or fixture parameters to fixture usages

Early prototype, but usable for static pytest fixture completion/definition.

Install with lazy.nvim

{
  "AlexanderFarkas/pyfixy.nvim",
  ft = "python",
  build = "./scripts/install.sh",
  config = function()
    require("pyfixy").setup()
  end,
}

Current scope

Supported so far:

• @pytest.fixture
• @pytest.fixture(name = "custom_name")
• @fixture
• fixtures in the same test file
• fixtures in ancestor conftest.py files
• fixture imports/re-exports across helper modules
• plugin-provided fixtures declared via pytest_plugins in the test file or ancestor conftest.py files

Not implemented yet:

• dynamic pytest fixture generation
• incremental indexing

Root detection

By default pyfixy starts for Python buffers under the nearest content root marked by one of:

{ "pyproject.toml", "pytest.ini", "tox.ini", "setup.cfg", "setup.py", ".git" }

You can override markers or provide a custom root callback:

require("pyfixy").setup({
  root_markers = { "pyproject.toml", ".git" },
  root_dir = function(bufnr)
    return vim.fs.root(vim.api.nvim_buf_get_name(bufnr), { "pyproject.toml" })
  end,
})

Releasing

Push a version tag to build release binaries:

git tag v0.1.0
git push origin v0.1.0

GitHub Actions publishes tarballs for:

pyfixy-lsp-aarch64-apple-darwin.tar.gz
pyfixy-lsp-x86_64-unknown-linux-gnu.tar.gz
pyfixy-lsp-aarch64-unknown-linux-gnu.tar.gz