Skip to content

Commit 3dd7425

Browse files
Try and provide separate PyPi instructions for mod_wsgi-standalone package.
1 parent e65eae5 commit 3dd7425

File tree

2 files changed

+36
-1
lines changed

2 files changed

+36
-1
lines changed

README-standalone.rst

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
Overview
2+
--------
3+
4+
The mod_wsgi package provides an Apache module that implements a WSGI
5+
compliant interface for hosting Python based web applications on top of the
6+
Apache web server.
7+
8+
The primary package for mod_wsgi is available on the Python package index
9+
(PyPi) as ``mod_wsgi``. That package assumes that you have a suitable
10+
version of Apache pre-installed on your target system, and if you don't,
11+
installation of the package will fail.
12+
13+
If you are on a UNIX like system (Linux, macOS) and need a version of
14+
Apache to be installed for you, you can use the ``mod_wsgi-standalone``
15+
package on PyPi instead. When installing the ``mod_wsgi-standalone``
16+
package it will first trigger the installation of the ``mod_wsgi-httpd``
17+
package, which will result in a version of Apache being installed as
18+
part of your Python installation. Next the ``mod_wsgi`` package will be
19+
installed, with it using the version of Apache installed by the
20+
``mod_wsgi-httpd`` package rather than any system package for Apache.
21+
22+
Note that this method of installation is only suitable for where you want
23+
to use ``mod_wsgi-expres``. It cannot be used to build mod_wsgi for use
24+
with your system Apache installation. This installation method will also
25+
not work on Windows.
26+
27+
When installing mod_wsgi using this method, except that you will install
28+
the ``mod_wsgi-standalone`` package instead of the ``mod_wsgi`` package,
29+
you should follow installation and usage instructions outlined on the
30+
PyPi page for the ``mod_wsgi`` package.

setup.py

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -544,11 +544,16 @@ def _version():
544544

545545
# Now finally run distutils.
546546

547+
package_name = 'mod_wsgi'
547548
long_description = open('README.rst').read()
548549

549550
standalone = os.path.exists('pyproject.toml')
550551

551-
setup(name = standalone and 'mod_wsgi-standalone' or 'mod_wsgi',
552+
if standalone:
553+
package_name = 'mod_wsgi-standalone'
554+
long_description = open('README-standalone.rst').read()
555+
556+
setup(name = package_name,
552557
version = _version(),
553558
description = 'Installer for Apache/mod_wsgi.',
554559
long_description = long_description,

0 commit comments

Comments
 (0)