In Python, how does one catch warnings as if they were exceptions?


A third-party library (written in C) that I use in my python code is issuing warnings. I want to be able to use the try except syntax to properly handle these warnings. Is there a way to do this?

Asked By: Boris Gorelik



To quote from the python handbook (27.6.4. Testing Warnings):

import warnings

def fxn():
    warnings.warn("deprecated", DeprecationWarning)

with warnings.catch_warnings(record=True) as w:
    # Cause all warnings to always be triggered.
    # Trigger a warning.
    # Verify some things
    assert len(w) == 1
    assert issubclass(w[-1].category, DeprecationWarning)
    assert "deprecated" in str(w[-1].message)
Answered By: Bobby Powers

Here’s a variation that makes it clearer how to work with only your custom warnings.

import warnings
with warnings.catch_warnings(record=True) as w:
    # Cause all warnings to always be triggered.

    # Call some code that triggers a custom warning.

    # ignore any non-custom warnings that may be in the list
    w = filter(lambda i: issubclass(i.category, UserWarning), w)

    if len(w):
        # do something with the first warning
Answered By: mcqwerty

To handle warnings as errors simply use this:

import warnings

After this you will be able to catch warnings same as errors, e.g. this will work:

except RuntimeWarning:

You can also reset the behaviour of warnings by running:


P.S. Added this answer because the best answer in comments contains misspelling: filterwarnigns instead of filterwarnings.

Answered By: niekas

If you just want your script to fail on warnings you can invoke python with the -W argument:

python -W error
Answered By: azmeuk

In some cases, you need use ctypes to turn warnings into errors. For example:

str(b'test')  # no error
import warnings
warnings.simplefilter('error', BytesWarning)
str(b'test')  # still no error
import ctypes
ctypes.c_int.in_dll(ctypes.pythonapi, 'Py_BytesWarningFlag').value = 2
str(b'test')  # this raises an error
Answered By: Collin Anderson

Expanding on niekas answer, but using the catch_warnings context manager that resets the warnings behavior to default after context exit:

import warnings

with warnings.catch_warnings():
     # Code in this block will raise exception for a warning
# Code in this block will have default warning behaviour
Answered By: CharlesB

Just for completeness, you can also export an env variable:

PYTHONWARNINGS=error /usr/bin/run_my_python_utility
Answered By: pmav99

Catching all warnings can be problematic. You can catch specific warnings. For example, I needed to catch a Pillow warning:

import warnings
warnings.filterwarnings("error", category=Image.DecompressionBombWarning)

def process_images():

  except Image.DecompressionBombWarning as e:
Answered By: wcDogg