astro py:docs

- Index
- Modules

### Navigation

- next »
- « previous |
- Astropy v5.2.1 »
- Astropy Core Package Utilities (`astropy.utils`) »
- format_exception

# format_exception

astropy.utils.misc.format_exception(msg, *args, **kwargs)

  Given an exception message string, uses new-style formatting arguments `{filename}`, `{lineno}`, `{func}` and/or `{text}` to fill in information about the exception that occurred. For example:

  > try:

  >   1/0

  > except:
  >   raise ZeroDivisionError(
  >     format_except(‘A divide by zero occurred in {filename} at ‘

  >       ‘line {lineno} of function {func}.’))

  Any additional positional or keyword arguments passed to this function are also used to format the message.

  Note

  This uses `sys.exc_info` to gather up the information needed to fill in the formatting arguments. Since `sys.exc_info` is not carried outside a handled exception, it’s not wise to use this outside of an `except` clause - if it is, this will substitute ‘<unknown>’ for the 4 formatting arguments.