Metadata-Version: 2.1
Name: mod_wsgi-httpd
Version: 2.4.54.1
Summary: Installer for Apache httpd server.
Home-page: http://www.modwsgi.org/
Author: Graham Dumpleton
Author-email: Graham.Dumpleton@gmail.com
Maintainer: Graham Dumpleton
Maintainer-email: Graham.Dumpleton@gmail.com
License: Apache License, Version 2.0
Platform: UNKNOWN
Classifier: Development Status :: 6 - Mature
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: SunOS/Solaris
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Server
License-File: LICENSE

Overview
--------

The ``mod_wsgi-httpd`` package is a companion package for mod_wsgi. It will
compile and install a copy of the Apache httpd server into your Python
installation. If this is done, when the ``mod_wsgi`` package is
subsequently installed, it will be compiled against the Apache httpd server
installed by this package. When ``mod_wsgi-express`` from the ``mod_wsgi``
package is then run, it will also use the same Apache httpd server.

This package therefore allows you to side step the fact that most Linux
distributions and MacOS X ship out of date versions of the Apache httpd
server, allowing you to use the very latest version. It also allows you to
install ``mod_wsgi-express`` where you don't control your operating system
and so don't have root access, and the Apache httpd server is not
installed, or its companion ``dev`` packages are not installed, which are a
prerequsite for being able to build mod_wsgi from source code.

**NOTE: Although this package may allow you to install a newer Apache
version, it is only really recommended that you use this package if you
have absolutely no other choice for getting the Apache httpd server
installed. Always use the Apache httpd server supplied with the operating
system if you can. Building this package if you do choose to do so, will
take some time. So if you you think the install is hanging, it is probably
still busy compiling everything.**

Installation
------------

To install the Apache httpd server::

    pip install -v mod_wsgi-httpd

The ``-v`` option enables you to see the output as everything is being
compiled. This way you can better track that it is doing something and
isn't hanging.

To subsequently install the mod_wsgi package and mod_wsgi-express::

    pip install mod_wsgi

Installation of each package needs to be done separately, you cannot list
both in a ``requirements.txt`` file because the ``mod_wsgi-httpd`` package
will not be installed before ``pip`` processes the ``mod_wsgi`` package.
As a result the installation of ``mod_wsgi`` may fail, or the system Apache
will still be used if available.

If you need to install packages using ``pip`` from a ``requirements.txt``
file, or other similar Python package installer, you should instead
install the ``mod_wsgi-standalone`` package. This is a special variant
of the ``mod_wsgi`` package that will ensure that ``mod_wsgi-httpd`` is
installed first. Ensure you have an up to date version of ``pip`` which
understands ``pyproject.toml`` files when using this option.

To run mod_wsgi-express::

    mod_wsgi-express start-server

You can then access the server at::

    http://localhost:8000/

For more help on mod_wsgi-express see the documentation for the mod_wsgi
package and/or run::

    mod_wsgi-express start-server --help


