skrub
skrub copied to clipboard
Create dedicated doc sections to explain some of the data ops error messages
Some of the errors can be difficult to understand at first: those related to the fact that expressions are lazy. We discussed adding sections in the doc and showing the url in the error message
Examples:
- https://github.com/skrub-data/skrub/pull/1661#discussion_r2527447184
Related issues:
- #1571
- #1773
Another error I've encountered a few times and that I always forget is this:
"dot" with args ['-Tsvg', '/var/folders/s5/sh5p03613f99c34ty0s6p3tc0000gn/T/tmpgqs7a9fj/tmpyr57lrb_'] returned code: 1
stdout, stderr:
b''
b'Format: "svg" not recognized. No formats found.\nPerhaps "dot -c" needs to be run (with installer\'s privileges) to register the plugins?\n'
Which is accompanied by this not very helpful exception:
File ~/work/skrub/skrub/_data_ops/_inspection.py:340, in _check_graphviz()
338 if _has_graphviz():
339 return
--> [340](https://file+.vscode-resource.vscode-cdn.net/Users/rcap/work/skrub/~/work/skrub/skrub/_data_ops/_inspection.py:340) raise ImportError("Please install pydot and graphviz to draw data_op graphs.")
ImportError: Please install pydot and graphviz to draw data_op graphs.
The solution is simple (dot -c in a terminal in whatever environment is being used), but it's not very obvious, so it might warrant being added to the "common errors" list.