mod-wsgi 5.0.2__tar.gz → 6.0.0.dev3__tar.gz

mod_wsgi-6.0.0.dev3/MANIFEST.in

@@ -0,0 +1,13 @@
+include configure.ac
+include configure
+include LICENSE
+include Makefile.in
+include README.rst
+include README-express.rst
+include README-standalone.rst
+include CREDITS.rst
+include src/server/*.h
+include src/server/*.c
+exclude src/express/apxs_config.py
+include images/*
+include pyproject.toml

mod_wsgi-6.0.0.dev3/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: mod_wsgi
+Version: 6.0.0.dev3
+Summary: Installer for Apache/mod_wsgi.
+Home-page: https://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
+Project-URL: Documentation, https://modwsgi.readthedocs.io/
+Project-URL: Source, https://github.com/GrahamDumpleton/mod_wsgi
+Project-URL: Tracker, https://github.com/GrahamDumpleton/mod_wsgi/issues
+Keywords: mod_wsgi wsgi apache
+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 :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Server
+Requires-Python: >=3.10
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+Overview
+--------
+
+The mod_wsgi package provides an Apache module that implements a WSGI
+compliant interface for hosting Python-based web applications on top of
+the Apache web server, conforming to the WSGI specification (PEP 3333).
+
+When installed from PyPi using ``pip``, the ``mod_wsgi`` package builds
+the mod_wsgi Apache module against the Apache and Python installations
+on your host, and installs the ``mod_wsgi-express`` command-line wrapper
+alongside it.
+
+``mod_wsgi-express`` ships a curated Apache configuration template
+tuned for hosting a single WSGI application, and generates a complete
+Apache configuration from it on the fly based on the command-line
+options you supply. Running ``mod_wsgi-express start-server`` brings
+up an Apache instance owned by your own user account, with the
+generated configuration loading mod_wsgi and wiring in your WSGI
+application, without you needing to write or maintain any Apache
+configuration yourself. This makes the package an alternative to
+using a system-supplied mod_wsgi package together with a hand-managed
+Apache configuration, and is well suited to development environments,
+container images, and production deployments where having Apache
+configured automatically is preferable to managing the Apache
+configuration directly.
+
+The ``mod_wsgi`` package can also be used purely as a way to build the
+mod_wsgi Apache module (``mod_wsgi.so``) for use with an existing
+Apache installation. The built module can be referenced from where
+``pip`` placed it, or copied into the modules directory of the target
+Apache using the ``mod_wsgi-express install-module`` command. This
+works both with the system-supplied Apache on your operating system
+and with a self-built Apache installation. In this mode you continue
+to write the Apache configuration yourself, and the ``mod_wsgi``
+package serves as a convenient way to obtain a compiled Apache module
+that matches your Python interpreter.
+
+The ``mod_wsgi`` package on PyPi assumes that you have a suitable
+version of Apache pre-installed on your target system, including its
+development headers. If you do not, and you are on a UNIX-like system
+(Linux), see the companion ``mod_wsgi-standalone`` package on PyPi,
+which additionally installs a private build of Apache as part of the
+Python installation.
+
+For installation instructions, configuration directives, and usage
+guides, see the mod_wsgi documentation site at https://www.modwsgi.org.

mod_wsgi-6.0.0.dev3/README-express.rst

@@ -0,0 +1,46 @@
+Overview
+--------
+
+The mod_wsgi package provides an Apache module that implements a WSGI
+compliant interface for hosting Python-based web applications on top of
+the Apache web server, conforming to the WSGI specification (PEP 3333).
+
+When installed from PyPi using ``pip``, the ``mod_wsgi`` package builds
+the mod_wsgi Apache module against the Apache and Python installations
+on your host, and installs the ``mod_wsgi-express`` command-line wrapper
+alongside it.
+
+``mod_wsgi-express`` ships a curated Apache configuration template
+tuned for hosting a single WSGI application, and generates a complete
+Apache configuration from it on the fly based on the command-line
+options you supply. Running ``mod_wsgi-express start-server`` brings
+up an Apache instance owned by your own user account, with the
+generated configuration loading mod_wsgi and wiring in your WSGI
+application, without you needing to write or maintain any Apache
+configuration yourself. This makes the package an alternative to
+using a system-supplied mod_wsgi package together with a hand-managed
+Apache configuration, and is well suited to development environments,
+container images, and production deployments where having Apache
+configured automatically is preferable to managing the Apache
+configuration directly.
+
+The ``mod_wsgi`` package can also be used purely as a way to build the
+mod_wsgi Apache module (``mod_wsgi.so``) for use with an existing
+Apache installation. The built module can be referenced from where
+``pip`` placed it, or copied into the modules directory of the target
+Apache using the ``mod_wsgi-express install-module`` command. This
+works both with the system-supplied Apache on your operating system
+and with a self-built Apache installation. In this mode you continue
+to write the Apache configuration yourself, and the ``mod_wsgi``
+package serves as a convenient way to obtain a compiled Apache module
+that matches your Python interpreter.
+
+The ``mod_wsgi`` package on PyPi assumes that you have a suitable
+version of Apache pre-installed on your target system, including its
+development headers. If you do not, and you are on a UNIX-like system
+(Linux), see the companion ``mod_wsgi-standalone`` package on PyPi,
+which additionally installs a private build of Apache as part of the
+Python installation.
+
+For installation instructions, configuration directives, and usage
+guides, see the mod_wsgi documentation site at https://www.modwsgi.org.

{mod_wsgi-5.0.2 → mod_wsgi-6.0.0.dev3}/README-standalone.rst

@@ -2,15 +2,17 @@ Overview
 --------
 
 The mod_wsgi package provides an Apache module that implements a WSGI
-compliant interface for hosting Python based web applications on top of the
+compliant interface for hosting Python-based web applications on top of the
 Apache web server.
 
 The primary package for mod_wsgi is available on the Python package index
-(PyPi) as ``mod_wsgi``. That package assumes that you have a suitable
-version of Apache pre-installed on your target system, and if you don't,
-installation of the package will fail.
+(PyPi) as ``mod_wsgi``. That package installs the Apache mod_wsgi module
+itself, along with the ``mod_wsgi-express`` command-line wrapper for
+starting Apache/httpd with mod_wsgi pre-configured. It assumes that you
+have a suitable version of Apache pre-installed on your target system,
+and if you don't, installation of the package will fail.
 
-If you are on a UNIX like system (Linux) and need a version of Apache
+If you are on a UNIX-like system (Linux) and need a version of Apache
 to be installed for you, you can use the ``mod_wsgi-standalone``
 package on PyPi instead. When installing the ``mod_wsgi-standalone``
 package it will first trigger the installation of the ``mod_wsgi-httpd``
@@ -24,15 +26,15 @@ This method of installation is only suitable for where you want to use
 your system Apache installation. This installation method will not
 work on Windows.
 
-When installing mod_wsgi using this method, except that you will install
-the ``mod_wsgi-standalone`` package instead of the ``mod_wsgi`` package,
-you should follow installation and usage instructions outlined on the
-PyPi page for the ``mod_wsgi`` package.
+When installing mod_wsgi using this method, follow the installation and
+usage instructions outlined on the mod_wsgi documentation site at
+https://www.modwsgi.org, substituting ``mod_wsgi-standalone`` for
+``mod_wsgi`` as the package to install.
 
 **NOTE: Although this package may allow you to install a standalone 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
+take some time. So if you think the install is hanging, it is probably
 still busy compiling everything.**

mod_wsgi-6.0.0.dev3/README.rst

@@ -0,0 +1,135 @@
+========
+mod_wsgi
+========
+
+mod_wsgi is an Apache HTTP Server module for hosting Python web
+applications that implement the WSGI specification (`PEP 3333`_). It
+has been used in production deployments for over 15 years and
+continues to be actively maintained.
+
+mod_wsgi requires Python 3.10 or later and Apache 2.4. The 6.x
+release line is the current focus of development; see the
+documentation for the full version support policy.
+
+Documentation
+-------------
+
+Full documentation for mod_wsgi is published at:
+
+* https://www.modwsgi.org
+
+That site covers installation on the various supported platforms,
+the complete reference for ``WSGI`` configuration directives, the
+error code reference for ``WSGI####`` log messages, deployment and
+hardening guides, and troubleshooting.
+
+The documentation sources live under ``docs`` in this repository
+and are built with Sphinx.
+
+Releases
+--------
+
+This source code repository publishes three distinct packages to the
+Python Package Index:
+
+* `mod_wsgi`_ on PyPI builds the mod_wsgi Apache module against an
+  existing Apache and Python installation on your host, and
+  installs the ``mod_wsgi-express`` command-line wrapper for
+  running Apache with a generated configuration tuned for hosting
+  a single WSGI application.
+
+* `mod_wsgi-standalone`_ on PyPI additionally installs a private
+  build of Apache into your Python environment, for use on
+  UNIX-like systems where no system Apache is available.
+
+* `mod_wsgi-telemetry`_ on PyPI is the out-of-process telemetry
+  ingester and live UI that consume datagrams emitted when the
+  ``WSGITelemetryService`` directive is enabled. It is distributed
+  separately so that installations using the operating-system
+  ``mod_wsgi`` package, or any other manually-configured Apache,
+  can adopt the telemetry pipeline without switching to the PyPI
+  ``mod_wsgi`` or ``mod_wsgi-express`` packages.
+
+Reporting bugs
+--------------
+
+File bug reports and feature requests on the GitHub issue tracker:
+
+* https://github.com/GrahamDumpleton/mod_wsgi/issues
+
+Before filing a bug report, work through the troubleshooting guide
+in the documentation. A substantial share of reports against
+mod_wsgi turn out to be configuration, application, or third-party
+package issues rather than mod_wsgi bugs.
+
+For suspected security issues, do not open a public issue. Submit a
+private security advisory via GitHub:
+
+* https://github.com/GrahamDumpleton/mod_wsgi/security/advisories/new
+
+See the security issues page in the documentation for the full
+disclosure process and the list of past CVEs.
+
+Contributing
+------------
+
+Pull requests are welcome. Small fixes and self-contained features
+can be sent straight through. For larger changes it is worth opening
+an issue first to discuss the approach, since mod_wsgi sits across
+both the Apache and CPython C APIs and the relevant context is not
+always obvious from the code alone.
+
+If you have hit a problem or have an idea but writing the code
+yourself would be more friction than help, describing it in an issue
+is just as useful. The maintainer is usually quicker at producing a
+fix or a small feature in this code base than a first-time
+contributor would be.
+
+Sponsorship is set up through GitHub Sponsors:
+
+* https://github.com/sponsors/GrahamDumpleton
+
+Building from source
+--------------------
+
+The repository contains:
+
+* ``src/server`` for the Apache module sources (C).
+* ``src/express`` and the rest of ``src`` for the Python-side
+  package that includes ``mod_wsgi-express`` and the diagnostics
+  WSGI applications.
+* ``telemetry`` for the separately-distributed
+  ``mod_wsgi-telemetry`` package, which provides the out-of-process
+  telemetry ingester, browser-based live UI and ``top``-style
+  curses monitor that consume datagrams emitted when the
+  ``WSGITelemetryService`` directive is enabled.
+* ``docs`` for the Sphinx documentation published to
+  https://www.modwsgi.org.
+* ``tests`` for the test suite and sample WSGI applications used by
+  it.
+* ``scripts`` for helper scripts, including the test runner.
+
+Building from source requires a complete Apache installation
+including its development headers (``apache2-dev`` or
+``httpd-devel`` depending on distribution), and the Python
+development headers. See the documentation's installation page for
+the full prerequisites.
+
+For an editable development build into a virtual environment::
+
+    uv pip install -e . --no-cache
+
+To run the test suite::
+
+    ./scripts/run-tests.sh
+
+License
+-------
+
+mod_wsgi is distributed under the Apache License, Version 2.0. See
+the ``LICENSE`` file in this repository for the full text.
+
+.. _PEP 3333: https://peps.python.org/pep-3333/
+.. _mod_wsgi: https://pypi.org/project/mod_wsgi/
+.. _mod_wsgi-standalone: https://pypi.org/project/mod_wsgi-standalone/
+.. _mod_wsgi-telemetry: https://pypi.org/project/mod_wsgi-telemetry/