pytest Language Server

pytest Language Server Extension for Zed

This is a Zed extension that provides support for the pytest-language-server.

Features

• Go to Definition: Jump directly to fixture definitions from anywhere they're used
• Go to Implementation: Navigate to yield statements in generator fixtures
• Call Hierarchy: Explore fixture dependencies (incoming/outgoing calls)
• Code Completion: Smart auto-completion for pytest fixtures with context-aware suggestions
• Find References: Find all usages of a fixture across your entire test suite
• Rename: Rename a @pytest.mark.parametrize parameter and update the decorator string, signature, and body together
• Hover Documentation: View fixture information including signature, location, and docstring
• Document Symbols: Navigate fixtures within a file using the outline view
• Workspace Symbols: Search for fixtures across your entire workspace
• Code Lens: See fixture usage counts directly above definitions
• Inlay Hints: See fixture return types inline next to parameters
• Diagnostics: Warnings for undeclared fixtures, scope mismatches, and circular dependencies
• Code Actions: Quick fixes to add missing fixture parameters, add type annotations for fixture parameters, and bulk-annotate all fixtures in a file — with automatic isort-aware import insertion
• Fixture Priority: Correctly handles pytest's fixture shadowing rules
• Simple Setup: Uses your existing pytest-language-server installation
• Cross-platform: Works on macOS, Linux, and Windows

Installation

1. Open Zed
2. Open the command palette (Cmd+Shift+P / Ctrl+Shift+P)
3. Search for "zed: extensions"
4. Search for "pytest Language Server"
5. Click "Install"

That's it! The extension automatically downloads the appropriate binary for your platform on first use.

How It Works

The extension intelligently handles the language server binary:

1. Check PATH: First, it looks for pytest-language-server in your PATH (if you installed via pip, cargo, or brew)
2. Auto-Download: If not found, it automatically downloads the pre-built binary from GitHub Releases for your platform
3. Version Management: Downloaded binaries are stored in version-specific directories (e.g., bin/v0.7.2/)
4. Auto-Update: When a new version is released, it downloads the new version and cleans up old ones
5. Cache: Downloaded binaries are cached for future use

This means you can either:

• Do nothing - the extension handles everything automatically (including updates!)
• Install manually (via pip/cargo/brew) - the extension will use your installation

Configuration

After installing the extension, you need to enable the language server for Python files. Add the following to your Zed settings.json:

{
  "languages": {
    "Python": {
      "language_servers": ["pyright", "pytest-language-server", "..."]
    }
  }
}

Note: The "..." entry preserves any other language servers you may have configured. You can also use "!pyright" to disable pyright if you prefer a different Python LSP.

Tips

• Custom Binary: If you have pytest-language-server in your PATH, the extension will prioritize that over the auto-downloaded binary
• Offline Use: Download the binary once while online, and it will be cached for offline use
• Manual Installation: Install via pip install pytest-language-server, cargo install pytest-language-server, or brew install pytest-language-server
• Logging: Set the RUST_LOG environment variable to enable debug logging from the language server

Environment Variables

You can control logging verbosity by setting the RUST_LOG environment variable:

{
  "lsp": {
    "pytest-lsp": {
      "initialization_options": {
        "environment": {
          "RUST_LOG": "debug"
        }
      }
    }
  }
}

Development

To develop this extension locally:

1. Clone this repository
2. Install Rust via rustup (required - Homebrew Rust won't work)

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

3. Ensure ~/.cargo/bin is in your PATH before other Rust installations
4. Install the wasm32-wasip1 target:

   rustup target add wasm32-wasip1
   

5. Open Zed
6. Run the command "zed: install dev extension"
7. Select the zed-extension directory from this repository

Troubleshooting: If you get compilation errors, see TROUBLESHOOTING.md

License

MIT License - see LICENSE file for details.

Links

• pytest-language-server
• Zed Extensions Documentation