uwsgi-tools

1.1.1 verified Fri May 01 auth: no python

uwsgi-tools provides uwsgi_curl and uwsgi_proxy, utilities for direct HTTP requests and reverse proxying to uWSGI backends via the uwsgi protocol. Current version is 1.1.1.

pip install uwsgi-tools

Common errors

error ModuleNotFoundError: No module named 'uwsgi_tools' ↓

cause The library does not provide any Python importable module; it only installs CLI scripts.

fix

Use command-line calls via subprocess or shell. Example: 'uwsgi_curl http://localhost:9090'

error Couldn't connect to UWSGI server (connection refused) ↓

cause The target address does not have a uWSGI server listening, or the port/protocol is wrong.

fix

Ensure uWSGI is running with the 'uwsgi' protocol (using --protocol=uwsgi) and the correct address.

Warnings

gotcha The library does not expose any Python modules; it only installs CLI commands uwsgi_curl and uwsgi_proxy. Attempting to import uwsgi_tools will fail. ↓

fix Run the tools from the shell, not from Python import.

gotcha uwsgi_curl only works with uWSGI backends using the binary uwsgi protocol (not HTTP). It cannot be used with generic HTTP servers. ↓

fix Ensure the target server speaks the uwsgi protocol.

Quickstart

Run uwsgi_curl from the command line.

import subprocess
# Example: using uwsgi_curl from command line
subprocess.run(['uwsgi_curl', '--help'])