Skip to content

Commit 9367396

Browse files
committed
Add note about extra build requirements.
1 parent c155f0a commit 9367396

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

gel/_internal/arch.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -148,6 +148,29 @@ Run `python tools/gen_models.py` to generate test models into your virtual envir
148148
and you should be able to just run `$ pytest`.
149149
150150
151+
### Setup gotchas
152+
153+
#### Using a system-wide `pytest` install
154+
155+
Errors like `ModuleNotFoundError: No module named typing_inspection’` can
156+
occur when using a system wide pytest installation.
157+
158+
This can be caused by having run either `pip install pytest` outside a venv
159+
or `apt install python3-pytest`.
160+
161+
If you want to keep these installations, you can still run tests locally by
162+
running `python -m pytest`.
163+
164+
#### `make clean && make` to fix binary incompatibilities
165+
166+
Errors such as:
167+
```bash
168+
gel.protocol.protocol.ExecuteContext size changed, may indicate binary
169+
incompatibility. Expected 152 from C header, got 184 from PyObject
170+
```
171+
172+
Indicate something has changed a `pyx` file. A clean rebuild is necessary.
173+
151174
### Running Tests
152175

153176
```bash

0 commit comments

Comments
 (0)