skrub icon indicating copy to clipboard operation
skrub copied to clipboard

Create dedicated doc sections to explain some of the data ops error messages

Open jeromedockes opened this issue 8 months ago • 1 comments

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

jeromedockes avatar Apr 10 '25 14:04 jeromedockes

Related issues:

  • #1571
  • #1773

rcap107 avatar Nov 26 '25 10:11 rcap107

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.

rcap107 avatar Dec 17 '25 09:12 rcap107