==================
WSGIPythonWarnings
==================

:Description: Add an entry to the Python warnings filter.
:Syntax: ``WSGIPythonWarnings`` *spec*
:Context: server config

Adds an entry to the Python warnings filter. This is the embedded
equivalent of the ``-W`` command-line option to the ``python``
executable, or one entry of the ``PYTHONWARNINGS`` environment
variable.

The argument is a single warning filter specification using the
standard Python ``-W`` syntax::

  action:message:category:module:lineno

Each field is optional. The most common form supplies only the
action, which is one of ``default``, ``error``, ``always``,
``module``, ``once`` or ``ignore``.

For example, to turn all warnings into errors::

  WSGIPythonWarnings error

Or to silence ``DeprecationWarning`` from a specific module::

  WSGIPythonWarnings ignore::DeprecationWarning:somepackage.legacy

The directive may be specified multiple times. Each occurrence
appends a further entry to the warnings filter. Filters are applied
in the order they appear in the configuration.

When configuring via ``mod_wsgi-express``, the ``--python-warnings``
option emits one ``WSGIPythonWarnings`` directive per occurrence in
the generated configuration. It may be repeated to install multiple
filter entries, mirroring the directive's append semantics.

See the Python documentation on the warnings module and the ``-W``
option for details on filter precedence and matching.