From 1f88d668e8780f84800bcb60400a23f3c973a057 Mon Sep 17 00:00:00 2001 From: Erica Pisani Date: Thu, 26 Feb 2026 09:05:24 -0500 Subject: [PATCH] docs: Add troubleshooting note for editable installs with uWSGI When debugging a Django app with sentry-sdk installed in editable mode, uWSGI cannot find the package without an explicit --pythonpath pointing to the local sentry-python directory. Document this fix alongside the existing lldb/uWSGI debugging instructions. Co-Authored-By: Claude --- CONTRIBUTING.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d7ee48b14f..0286a3170e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -126,6 +126,20 @@ lldb -- ../../uwsgi/uwsgi --pythonpath "$PWD/.venv/lib/python3.14/site-packages" --need-app \ ``` +### Troubleshooting "module not found" error in relation to the `sentry-sdk` when it's installed in editable mode + +If you are trying to debug a Django applicaton such as that described above, and have the Sentry SDK installed in editable mode in the Django project, you will likely encounter this error because the editable package is not being found in the uWSGI's python path. To fix this, the above command needs to be updated to include a `--pythonpath` argument that passes in where your local `sentry-python` codebase is: + +```bash +lldb -- ../../uwsgi/uwsgi --pythonpath "$PWD/.venv/lib/python3.14/site-packages" \ + --pythonpath "" \ + --http :8000 \ + --module mysite.wsgi:application \ + --home "$PWD/.venv" \ + --need-app \ +``` + + ## Adding a New Integration ### SDK Contract