Skip to content

Commit 1f88d66

Browse files
ericapisaniclaude
andcommitted
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 <noreply@anthropic.com>
1 parent fa88d92 commit 1f88d66

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

CONTRIBUTING.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,20 @@ lldb -- ../../uwsgi/uwsgi --pythonpath "$PWD/.venv/lib/python3.14/site-packages"
126126
--need-app \
127127
```
128128

129+
### Troubleshooting "module not found" error in relation to the `sentry-sdk` when it's installed in editable mode
130+
131+
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:
132+
133+
```bash
134+
lldb -- ../../uwsgi/uwsgi --pythonpath "$PWD/.venv/lib/python3.14/site-packages" \
135+
--pythonpath "<path-to-local-sentry-python-directory>" \
136+
--http :8000 \
137+
--module mysite.wsgi:application \
138+
--home "$PWD/.venv" \
139+
--need-app \
140+
```
141+
142+
129143
## Adding a New Integration
130144

131145
### SDK Contract

0 commit comments

Comments
 (0)