pyuwsgi

Warnings

• gotcha pyuwsgi provides the uWSGI server *executable*, not a Python library to import for server management. Attempting to `import uwsgi` to start or manage the server from your application code will not work as expected; the `uwsgi` module is for applications *already running within* a uWSGI instance to interact with the server environment (e.g., `uwsgi.log()`, `uwsgi.cache_get()`).
  Fix: Run uWSGI as a command-line executable (e.g., `uwsgi --ini myapp.ini` or `python -m uwsgi ...`) and point it to your WSGI application.
• gotcha Installation via `pip install pyuwsgi` often requires C compilers (like `gcc`) and Python development headers (e.g., `python3-dev` on Debian/Ubuntu, `build-essential`, or Xcode Command Line Tools on macOS) to be present on the system, as `pyuwsgi` is a C extension. Without these, `pip` might fail to compile and install the package.
  Fix: Ensure you have the necessary build tools and Python development libraries installed for your operating system before running `pip install`.
• gotcha uWSGI offers a vast array of configuration options, typically managed via `.ini` files. While command-line arguments are suitable for simple cases, production deployments almost universally use `.ini` files for clarity, reusability, and advanced features (e.g., multiple processes, logging, master/worker management).
  Fix: Familiarize yourself with uWSGI's configuration options and consider using `.ini` files for deployment (e.g., `uwsgi --ini myapp.ini`).
• gotcha For robust production environments, it's highly recommended to run uWSGI behind a reverse proxy server like Nginx or Caddy. The reverse proxy can handle static file serving, SSL/TLS termination, request buffering, and load balancing more efficiently and securely than uWSGI directly.
  Fix: Deploy uWSGI behind a dedicated reverse proxy server to offload network-facing tasks and enhance performance/security.

Install

• pip install pyuwsgi Install pyuwsgi

Imports

• uwsgi

  import uwsgi

  The `uwsgi` module is primarily for applications *already running within* a uWSGI instance to interact with server internals (e.g., logging, caching). It is NOT used to start or manage the uWSGI server itself from arbitrary Python code; uWSGI is run as an executable.

Quickstart

This quickstart demonstrates how to create a simple WSGI application and run it using the `uwsgi` executable provided by the `pyuwsgi` package. The server listens on HTTP port 8000 and serves the 'application' callable from `app.py`.

import os

def application(environ, start_response):
    # A minimal WSGI application
    status = '200 OK'
    headers = [('Content-type', 'text/plain')]
    start_response(status, headers)
    return [b"Hello from uWSGI!"]

# To run this, save it as `app.py` and then run:
# uwsgi --http :8000 --wsgi-file app.py --callable application
# Or, if `uwsgi` executable isn't in your PATH:
# python -m uwsgi --http :8000 --wsgi-file app.py --callable application