You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
48 lines
1.6 KiB
48 lines
1.6 KiB
def friendly_message(exc):
|
|
"""
|
|
Returns a string to append to a standard error message.
|
|
If possible, the string contains a friendly explanation of the error.
|
|
Otherwise, the string is empty.
|
|
"""
|
|
try:
|
|
if "has no column" in str(exc):
|
|
# Avoid the standard AttributeError explanation
|
|
return ""
|
|
|
|
# Imported locally because it's Python 3 only
|
|
from friendly_traceback.core import FriendlyTraceback
|
|
|
|
fr = FriendlyTraceback(type(exc), exc, exc.__traceback__)
|
|
fr.assign_generic()
|
|
fr.assign_cause()
|
|
|
|
generic = fr.info["generic"] # broad explanation for the exception class
|
|
cause = fr.info.get("cause") # more specific explanation
|
|
|
|
if "https://github.com" in generic:
|
|
# This is a placeholder message when there is no explanation,
|
|
# with a suggestion to report the case on GitHub.
|
|
return ""
|
|
|
|
if "All built-in exceptions defined by Python are derived from `Exception`" in generic:
|
|
# Unhelpful explanation for a generic `Exception`
|
|
return ""
|
|
|
|
# Add a blank line between the standard message and the friendly message
|
|
result = "\n\n" + generic
|
|
|
|
# Check for the placeholder message again in the cause
|
|
if cause and "https://github.com" not in cause:
|
|
result += "\n" + cause
|
|
|
|
result = result.rstrip()
|
|
if isinstance(exc, SyntaxError):
|
|
result += "\n\n"
|
|
|
|
return result
|
|
except (Exception, SystemExit):
|
|
# This can go wrong in many ways, it's not worth propagating the error.
|
|
# friendly-traceback raises SystemExit when it encounters an internal error.
|
|
# Note that SystemExit is not a subclass of Exception.
|
|
return ""
|