Skip to main content

📒 Common questions

Frequently Asked Questions​

🔍 The plugin doesnt give the results I'm expecting

If you're not getting the expected results from :VenvSelect, follow these debugging steps:

Debugging Steps
  1. Enable debug mode in your configuration options
  2. Run :VenvSelect to trigger the selection
  3. Run :VenvSelectLog to view the detailed debug log
Understanding Search Functions

To better understand how the selection works, examine the code for the built-in search functions. This will show you exactly how the search patterns are constructed and applied.

🚀 The plugin doesnt seem to start

If the plugin isn't starting at all, here's how to troubleshoot:

Installation Check

First, verify that you have installed the plugin correctly according to the Installation instructions. Double-check that:

  • The plugin is properly added to your plugin manager
  • All dependencies are installed
  • Your Neovim version meets the requirements
Still Not Working?

If you've verified the installation and it's still not working, please create a GitHub Issue with:

  • Your Neovim version
  • Your plugin manager configuration
  • Any error messages you're seeing
  • Your operating system details
⚙️ How do I customize the search behavior?

You can customize how venv-selector finds your virtual environments:

Custom Search Functions

The plugin allows you to define custom search functions in your configuration. Check the configuration options for details on:

  • Adding custom search paths
  • Modifying search patterns
  • Setting up project-specific environments
🐍 Which Python versions are supported?
Python Compatibility

venv-selector.nvim works with any Python version that supports virtual environments, including:

  • Python 3.6+
  • Conda environments
  • Poetry environments
  • Pipenv environments
  • Custom virtual environment setups
💻 Does this work on Windows/macOS/Linux?
Cross-Platform Support

Yes! The plugin is designed to work across all major operating systems:

  • Linux: Full support
  • macOS: Full support
  • Windows: Full support (including WSL)
🔧 How do I contribute or report bugs?
Contributing

We welcome contributions! Here's how you can help:

  • Report bugs via GitHub Issues
  • Submit feature requests
  • Contribute code via pull requests
Need More Help?

If your question isn't answered here, check out the Configuration Options or create an issue on GitHub.