Interfaz de puerta de enlace del servidor web

La interfaz de puerta de enlace del servidor web ( WSGI , pronunciada whiskey ^{[1] [2]} o WIZ -ghee ^[3] ) es una convención de llamada simple para que los servidores web reenvíen solicitudes a aplicaciones web o marcos escritos en el lenguaje de programación Python . La versión actual de WSGI, la versión 1.0.1, se especifica en la Propuesta de mejora de Python (PEP) 3333. ^[4]

WSGI se especificó originalmente como PEP-333 en 2003. ^[5] PEP-3333, publicada en 2010, actualiza la especificación para Python 3 .

En 2003, los marcos web de Python generalmente se escribían solo para CGI , FastCGI , mod_python o alguna otra API personalizada de un servidor web específico . ^[6] Para citar PEP 333:

Python cuenta actualmente con una amplia variedad de marcos de aplicaciones web, como Zope, Quixote, Webware, SkunkWeb, PSO y Twisted Web, por nombrar solo algunos. Esta amplia variedad de opciones puede ser un problema para los nuevos usuarios de Python, porque, en términos generales, su elección de marco de aplicaciones web limitará su elección de servidores web utilizables, y viceversa... Por el contrario, aunque Java tiene tantos marcos de aplicaciones web disponibles, la API de "servlet" de Java permite que las aplicaciones escritas con cualquier marco de aplicaciones web de Java se ejecuten en cualquier servidor web que admita la API de servlet.

De este modo, WSGI se creó como una interfaz neutral en cuanto a la implementación entre servidores web y aplicaciones o marcos web para promover un terreno común para el desarrollo de aplicaciones web portátiles . ^[4]

El WSGI tiene dos caras:

• El lado del servidor o la puerta de enlace. Suele ejecutarse un software de servidor web completo, como Apache o Nginx , o es un servidor de aplicaciones liviano que puede comunicarse con un servidor web, como flup.
• El lado de la aplicación o del marco de trabajo. Se trata de un objeto invocable de Python, proporcionado por el programa o el marco de trabajo de Python.

Entre el servidor y la aplicación, puede haber uno o más componentes de middleware WSGI , que implementan ambos lados de la API, generalmente en código Python.

WSGI no especifica cómo debe iniciarse el intérprete de Python ni cómo debe cargarse o configurarse el objeto de la aplicación, y los distintos marcos y servidores web logran esto de diferentes maneras.

Un componente de middleware WSGI es un elemento invocable de Python que es en sí mismo una aplicación WSGI, pero que puede gestionar solicitudes delegándolas a otras aplicaciones WSGI. Estas aplicaciones pueden ser en sí mismas componentes de middleware WSGI. ^[7]

Un componente de middleware puede realizar funciones como: ^[7]

• Enrutar una solicitud a diferentes objetos de aplicación según la URL de destino , después de cambiar las variables de entorno en consecuencia.
• Permitir que varias aplicaciones o marcos se ejecuten en paralelo en el mismo proceso
• Equilibrio de carga y procesamiento remoto, mediante el reenvío de solicitudes y respuestas a través de una red
• Realizar posprocesamiento de contenido, como aplicar hojas de estilo XSLT

Una aplicación " ¡Hola, mundo! " compatible con WSGI escrita en Python :

def  aplicación ( entorno ,  start_response ): start_response ( '200 OK' ,  [( 'Tipo de contenido' ,  'texto sin formato' )]) rendimiento  b '¡Hola, mundo! \n '

Dónde:

• La línea 1 define una función ^[8] denominada application, que toma dos parámetros, environy start_response. environes un diccionario que contiene variables de entorno CGI así como otros parámetros de solicitud y metadatos bajo claves bien definidas. ^[9] start_response es un objeto invocable en sí mismo, que toma dos parámetros posicionales, statusy response_headers.
• La línea 2 llama start_response, especificando "200 OK" como estado HTTP y un encabezado de respuesta "Content-Type".
• La línea 3 convierte la función en un generador . El cuerpo de la respuesta se devuelve como un iterable de cadenas de bytes .

Un ejemplo completo de un servidor de red WSGI queda fuera del alcance de este artículo. A continuación se muestra un esquema de cómo se llamaría a una aplicación WSGI y se recuperaría su línea de estado HTTP, encabezados de respuesta y cuerpo de respuesta como objetos Python. ^[10]environ Se han omitido los detalles de cómo construir el diccionario.

desde  io  importar  BytesIOdef  call_application ( app ,  environ ):  estado  =  Ninguno  encabezados  =  Ninguno  cuerpo  =  BytesIO ()  def  start_response ( rstatus ,  rheaders ):  estado no local  , estado de los encabezados , encabezados = rstatus , rheaders        app_iter  =  app ( environ ,  start_response )  try :  para  los datos  en  app_iter :  afirmar que  el estado  no es  None y los encabezados no son None , \ " start_response () no fue llamado" body.write ( data ) finally : if hasattr ( app_iter , 'close' ) : app_iter.close ( ) return status , headers , body.getvalue ( )                entorno  =  { ... }  # "entorno" dict estado ,  encabezados ,  cuerpo  =  call_application ( app ,  entorno )

Esta sección puede contener ejemplos excesivos o irrelevantes . Ayúdenos a mejorar el artículo agregando texto descriptivo y eliminando los ejemplos menos pertinentes . ( Septiembre de 2018 )

Numerosos marcos web admiten WSGI:

Actualmente, hay envoltorios disponibles para FastCGI , CGI , SCGI , AJP (usando flup), twisted.web , Apache (usando mod_wsgi o mod_python ), Nginx (usando ngx_http_uwsgi_module), ^[26] Nginx Unit (usando el módulo de lenguaje Python), ^[27] y Microsoft IIS (usando WFastCGI, ^[28] isapi-wsgi, ^[29] PyISAPIe, ^[30] o una puerta de enlace ASP ).

• Interfaz de puerta de enlace de servidor asincrónica (ASGI) : el sucesor espiritual de WSGI, que agrega soporte para aplicaciones asincrónicas
• Rack : interfaz de servidor web Ruby
• PSGI – Interfaz de puerta de enlace de servidor web Perl
• SCGI – Interfaz de puerta de enlace común simple
• JSGI : interfaz de puerta de enlace de servidor web JavaScript

• PEP 333 – Interfaz de puerta de enlace de servidor web Python
• PEP 3333 – Interfaz de puerta de enlace del servidor web Python v1.0.1
• Metamarco WSGI
• Wiki completa sobre todo lo relacionado con WSGI
• Tutorial de WSGI
• Módulo wsgiref de la biblioteca estándar de Python
• Introducción a WSGI
• NWSGI: implementación .NET de la especificación WSGI de Python para IronPython e IIS
• Servidor Gevent-FastCGI implementado mediante la biblioteca de redes basada en corrutinas de Gevent