.. _warning-filter-examples:

Warning Filter Examples

Here are some complex examples for filtering warnings.

Note that:func:`filterwarnings` filters have subtle differences

from:option:`-W` and:envvar:`PYTHONWARNINGS` regarding the *message* and *module*

parts of the filter (as described in:ref:`warning-filter`).

filterwarnings("ignore", message=".*generic", module=r"yourmodule\.submodule")

# Ignore warnings in "yourmodule.submodule" which contain "generic"

filterwarnings("ignore", message="generic", module=r"yourmodule\.submodule")

# Ignore warnings in "yourmodule.submodule" which START with "generic"

filterwarnings("ignore", module="yourmodule.*")

# Ignore all warnings in "yourmodule" and its submodules

-W "ignore:generic::yourmodule.submodule:"

# Ignore warnings in "yourmodule.submodule" which START with "generic" (but not those containing it).

# Also note that the '.' in the module does not need to be escaped since it is not a regex

-W "ignore:::yourmodule:"

# Ignore all warnings in "yourmodule", but NOT in its submodules

.. _default-warning-filter:

Add examples of warning filters and the difference between programmatic and

environmental filters.