Skip to main content

Convert WSGI app to ASGI app or ASGI app to WSGI app.

Project description

a2wsgi

Convert WSGI app to ASGI app or ASGI app to WSGI app.

Pure Python. Only depend on the standard library.

Compared with other converters, the advantage is that a2wsgi will not accumulate the requested content or response content in the memory, so you don't have to worry about the memory limit caused by a2wsgi. This problem exists in converters implemented by uvicorn/startlette or hypercorn.

Install

pip install a2wsgi

How to use

WSGIMiddleware

Convert WSGI app to ASGI app:

from a2wsgi import WSGIMiddleware

ASGI_APP = WSGIMiddleware(WSGI_APP)

WSGIMiddleware executes WSGI applications with a thread pool of up to 10 threads by default. If you want to increase or decrease this number, just like WSGIMiddleware(..., workers=15).

WSGIMiddleware utilizes a queue to direct traffic from the WSGI App to the client. To adjust the queue size, simply specify the send_queue_size parameter (default to 10) during initialization, like so: WSGIMiddleware(..., send_queue_size=15). This enable developers to balance memory usage and application responsiveness.

ASGIMiddleware

Convert ASGI app to WSGI app:

from a2wsgi import ASGIMiddleware

WSGI_APP = ASGIMiddleware(ASGI_APP)

ASGIMiddleware will wait for the ASGI application's Background Task to complete before returning the last null byte. But sometimes you may not want to wait indefinitely for the execution of the Background Task of the ASGI application, then you only need to give the parameter ASGIMiddleware(..., wait_time=5.0), after the time exceeds, the ASGI task corresponding to the request will be tried to cancel, and the last null byte will be returned.

You can also specify your own event loop through the loop parameter instead of the default event loop. Like ASGIMiddleware(..., loop=faster_loop)

Access the original Scope/Environ

Sometimes you may need to access the original WSGI Environ in the ASGI application, just use scope["wsgi_environ"]; it is also easy to access the ASGI Scope in the WSGI Application, use environ["asgi.scope"].

Benchmark

Run pytest ./benchmark.py -s to compare the performance of a2wsgi and uvicorn.middleware.wsgi.WSGIMiddleware / asgiref.wsgi.WsgiToAsgi.

Why a2wsgi

Convert WSGI app to ASGI app

You can convert an existing WSGI project to an ASGI project to make it easier to migrate from WSGI applications to ASGI applications.

Convert ASGI app to WSGI app

There is a lot of support for WSGI. Converting ASGI to WSGI, you will be able to use many existing services to deploy ASGI applications.

Compatibility list

This list quickly demonstrates the compatibility of some common frameworks for users who are unfamiliar with the WSGI and ASGI protocols.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

a2wsgi-1.10.10.tar.gz (18.8 kB view details)

Uploaded Source

Built Distribution

a2wsgi-1.10.10-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

File details

Details for the file a2wsgi-1.10.10.tar.gz.

File metadata

  • Download URL: a2wsgi-1.10.10.tar.gz
  • Upload date:
  • Size: 18.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.20.1 CPython/3.10.18 Linux/6.11.0-1015-azure

File hashes

Hashes for a2wsgi-1.10.10.tar.gz
Algorithm Hash digest
SHA256 a5bcffb52081ba39df0d5e9a884fc6f819d92e3a42389343ba77cbf809fe1f45
MD5 2b57e7a3d099d80d7f7c54f851008330
BLAKE2b-256 9acb822c56fbea97e9eee201a2e434a80437f6750ebcb1ed307ee3a0a7505b14

See more details on using hashes here.

File details

Details for the file a2wsgi-1.10.10-py3-none-any.whl.

File metadata

  • Download URL: a2wsgi-1.10.10-py3-none-any.whl
  • Upload date:
  • Size: 17.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.20.1 CPython/3.10.18 Linux/6.11.0-1015-azure

File hashes

Hashes for a2wsgi-1.10.10-py3-none-any.whl
Algorithm Hash digest
SHA256 d2b21379479718539dc15fce53b876251a0efe7615352dfe49f6ad1bc507848d
MD5 d8a0401bcbd5336c2cb2faf73229aee6
BLAKE2b-256 02d5349aba3dc421e73cbd4958c0ce0a4f1aa3a738bc0d7de75d2f40ed43a535

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page