You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
We don't often catch exceptions and reraise errors with more specific and friendly messages. My personal preference is for verbose error messages written in a conversational tone with as much useful info for debugging as possible.
I'd like to use this issue to track specific cases of unhelpful error messages, which can each be tracked in their own issue:
I'm glad this issue exists. What came to mind right now, after another quick session of trying to parse error messages, is that a few generic validators that can run on some of the nbdev commands could be really useful, i.e.:
settings.ini validator - is it well formated (i.e. before running nbdev_export, nbdev_clean)
a notebook validator - is it a valid JSON? is each cell valid (i.e. catch python cells with indented blocks that are empty.
I imagine more things can be addressed this way (i.e. maybe a utility to test image tag in markdown cells before running docs?).
If that approach seems amenable, I wouldn't mind looking into 1 in the near term, if no one else is planning to do so. I can try to tackle 2 as well afterwards but I don't have much experience parsing ipynb files so someone else may be at an advantage :P
We don't often catch exceptions and reraise errors with more specific and friendly messages. My personal preference is for verbose error messages written in a conversational tone with as much useful info for debugging as possible.
I'd like to use this issue to track specific cases of unhelpful error messages, which can each be tracked in their own issue:
nbdev_export
raises an unhelpful error message if a cell's code fails to parse while building modidx #1169The text was updated successfully, but these errors were encountered: