Add --include-docstrings to generate_stubs.py #984
Conversation
```
with dai.Device() as device:
data = device.readCcmEepromRaw(dai.CameraBoardSocket.CAM_A, 64*1024)
np.frombuffer(bytearray(data)).tofile('ccm_eeprom.bin')
```
This feature was added to stubgen in 2023 and would improve developer experience with depthai. Bellow is quote from the original issue (on stubgen repo): I think this would be most useful for external C or C++ modules, because some IDEs don't look for signatures or docstrings in compiled modules. Using stubgen at least fixes autocomplete for compiled modules, but if the stub files don't include docstrings, IDEs might not show any documentation when hovering over the function/class/variable in the editor (unlike with plain Python modules). For example, Pylance in VSCode doesn't show documentation for functions in compiled modules, even with stub files generated by stubgen.
|
@filipproch do you have a comparison of the output stubs? LGTM otherwise, with an exception if mypy 1.3.0 or below has this already in? ( |
Comparison attached Checked the compatibility (missed the version constraint before) and we would need to use mypy 1.8.0 (as 1.7 had some regressions relating to pybind11). I tested it on my machine - but if there are some specific steps/things I should check for. Otherwise I will update the PR with corrected |
|
@filipproch please bump the mypy to 1.8.0 - there was some issues afaik on rpi's building with higher versions (missing wheels), but by the looks, versions are now in place for it. The diff seems to expand on some parts (inner structs) - hopefully it doesn't bring in 3.8+ exclusive parts into it. |
|
version fixed to |
|
Kicked of a build - lets see if it goes through as expected: https://github.com/luxonis/depthai-python/actions/runs/8063852135 CC: @moratom to merge for release if all okay |
|
Looks like the build fails for old python versions https://github.com/luxonis/depthai-python/actions/runs/8063852135/job/22026593339 Not sure if we could decouple the stubs generations from python versions? |
for the default case (non-burst mode). Other ToF changes: - fix timestamps and sequence numbers - reduce device CPU load when ToF streams, depending on FPS - set the proper ToF exposure time in ImgFrame metadata, 796us max - warnings for FPS capping, 80 max recommended, 88 max possible (with reduced depth quality far away)
copied the tof_depth.py logic
This feature was added to stubgen in 2023 and would improve developer experience with depthai.
Bellow is quote from the original issue (on stubgen repo):