==================
WSGIPythonOptimize
==================

:Description: Enables basic Python optimisation features.
:Syntax: ``WSGIPythonOptimize [0|1|2]``
:Default: ``WSGIPythonOptimize 0``
:Context: server config

Sets the Python interpreter's optimisation level. This is the embedded
equivalent of the ``-O`` and ``-OO`` command-line options to the
``python`` executable.

* **0** (default): no optimisations applied.
* **1** (equivalent to ``-O``): ``assert`` statements are skipped and
  ``__debug__`` is set to ``False``.
* **2** (equivalent to ``-OO``): everything from level 1, plus
  docstrings are stripped from the bytecode. Some Python packages
  inspect docstrings at runtime and may fail under this level.

For example::

  WSGIPythonOptimize 1

Note that this only affects bytecode that mod_wsgi causes to be
compiled while the application runs. Bytecode files that already
exist on disk for the standard library or installed packages are
reused as-is, regardless of the level set here. As a result, the
practical effect on memory or performance is usually small.

Code that depends on ``assert`` statements for runtime validation
will silently change behaviour at level 1 or higher.