Troubleshooting¶

Version Conflicts During Installation¶

If you encounter version conflicts or dependency errors while installing gwmock, this is often due to conflicting package versions in your Python environment. To resolve this:

1. Use a Virtual Environment: Always install gwmock in a dedicated virtual environment to isolate it from your system Python and other projects. We recommend using uv for this:

   uv venv --python 3.12 gwmock-env  # Replace 3.12 with your preferred version (3.12-3.13)
   source gwmock-env/bin/activate  # On Windows: gwmock-env\Scripts\activate
   uv pip install gwmock
   

2. Check Python Version: Ensure you're using Python 3.12 or 3.13, as these are the versions the package is built and tested against. Using an unsupported version (e.g., 3.11 or 3.14+) may cause compatibility issues:

   python --version  # Should show 3.12.x or 3.13.x
   

3. Update Dependencies: If conflicts persist, try updating pip and uv:

   pip install --upgrade pip uv
   uv pip install --upgrade gwmock
   

4. Clean Install: If issues continue, remove the virtual environment and recreate it:

   rm -rf gwmock-env  # Or delete the folder
   uv venv --python 3.12 gwmock-env
   source gwmock-env/bin/activate
   uv pip install gwmock
   

For more details on installation, see the Installation Guide. If problems persist, check the GitHub issues or create a new issue with your Python version and full error output.