diff --git a/source/leccion1/entorno_desarrollo.rst b/source/leccion1/entorno_desarrollo.rst index 8c2f197..49e6d80 100644 --- a/source/leccion1/entorno_desarrollo.rst +++ b/source/leccion1/entorno_desarrollo.rst @@ -224,7 +224,7 @@ Así de esta forma congela las versiones usadas para el proceso de instalación Entornos virtuales Python -^^^^^^^^^^^^^^^^^^^^^^^^^ +------------------------- Para la instalación de la herramienta de entornos virtuales en Python, ejecute el siguiente comando: diff --git a/source/leccion4/hello_world.rst b/source/leccion4/hello_world.rst index 21392ec..de6aa65 100644 --- a/source/leccion4/hello_world.rst +++ b/source/leccion4/hello_world.rst @@ -107,7 +107,7 @@ De esta forma puede una aplicación web ``WSGI`` simple que maneja una petición Estos son los bloques de construcción muy simplificados utilizados en :ref:`framework web ` -populares como :ref:`Flask ` y :ref:`Django `. +populares como :ref:`Flask ` y :ref:`Django `. De esta forma ha aprendido a crear aplicaciones web ``WSGI`` que maneja peticiones ``GET`` y ``POST``. diff --git a/source/leccion4/index.rst b/source/leccion4/index.rst index 6a8042e..2d5fb93 100644 --- a/source/leccion4/index.rst +++ b/source/leccion4/index.rst @@ -7,8 +7,8 @@ Web Server Gateway Interface diferentes servidores web y framework de aplicaciones interactúen según una API común. -En esta lección se busca hacer una introducción a la especificación WSGI -en Python, sus características, instalación, interacciones con un WSGI y +En esta lección se busca hacer una introducción a la especificación ``WSGI`` +en Python, sus características, instalación, interacciones con un ``WSGI`` y los recursos más destacados disponibles en la Web para tomar en cuenta. A continuación el temario de esta lección: diff --git a/source/leccion4/introduccion_wsgi.rst b/source/leccion4/introduccion_wsgi.rst index 6ec8761..0e8c853 100644 --- a/source/leccion4/introduccion_wsgi.rst +++ b/source/leccion4/introduccion_wsgi.rst @@ -3,28 +3,27 @@ Introducción a WSGI =================== -Tras bambalinas de frameworks como :ref:`Flask `, -:ref:`Django `, Bottle y cualquier otro framework web +Tras bambalinas de frameworks como :ref:`Flask `, +:ref:`Django `, `Bottle`_ y cualquier otro framework web de Python, se encuentra el *Web Server Gateway Interface (WSGI)*. -WSGI es para Python lo que son Servlets para Java: una especificación común +``WSGI`` es para Python lo que son Servlets para Java: una especificación común para servidores web que permite que diferentes servidores web y framework de aplicaciones interactúen según una API común. Sin embargo, como con la mayoría de las cosas, la versión de Python es considerablemente más simple. -WSGI se define en el `PEP 3333 `_, que le -recomiendo que lea como referencia si desea obtener más información después -de esta introducción rápida. +``WSGI`` se define en el `PEP 3333`_, que le recomiendo que lea como referencia +si desea obtener más información después de esta introducción rápida. -WSGI no es un servidor, un módulo de Python, un framework, una API o cualquier +``WSGI`` no es un servidor, un módulo de Python, un framework, una API o cualquier tipo de software. Es solo una especificación de interfaz mediante la cual el servidor y la aplicación se comunican. Tanto el lado del servidor como la interfaz de la aplicación se especifican en -el *PEP 3333*. Si se escribe una aplicación (o framework o kit de herramientas) -en la especificación WSGI, se ejecutará en cualquier servidor escrito en esa +el `PEP 3333`_. Si se escribe una aplicación (o framework o kit de herramientas) +en la especificación ``WSGI``, se ejecutará en cualquier servidor escrito en esa especificación. .. _python_wsgi_app: @@ -32,10 +31,10 @@ especificación. Aplicaciones WSGI ------------------ -Las aplicaciones WSGI (lo que significa que cumplen con el WSGI) se pueden +Las aplicaciones ``WSGI`` (lo que significa que cumplen con el ``WSGI``) se pueden apilar. Los que están en la mitad de la pila se denominan **middleware** y deben implementar ambos lados de la interfaz, la aplicación y el servidor -WSGI. +``WSGI``. Para la aplicación que se encuentra en la parte superior, se comportará como un servidor y para la aplicación (o servidor) a continuación como una @@ -47,28 +46,28 @@ aplicación. Servidor WSGI -------------- -Un servidor WSGI (lo que significa que cumple con el WSGI) solo +Un servidor ``WSGI`` (lo que significa que cumple con el ``WSGI``) solo recibe la solicitud del cliente, la pasa a la aplicación y luego envía la respuesta devuelta por la aplicación al cliente. No hace nada más. Todos los detalles explícitos deben ser suministrados -por la aplicación o middleware. +por la aplicación o **middleware**. -No es necesario conocer la especificación WSGI para crear +No es necesario conocer la especificación ``WSGI`` para crear aplicaciones sobre frameworks o kits de herramientas. Para usar -middleware, se debe tener una comprensión mínima de cómo apilarlos +**middleware**, se debe tener una comprensión mínima de cómo apilarlos con la aplicación o el marco, a menos que el framework ya esté integrado o el framework proporcione algún tipo de envoltorio para integrar los que no lo están. -Python 2.5 y versiones posteriores vienen con un servidor WSGI -que se utilizará en este tutorial. En 2.4 y anteriores se puede +En la versión de Python 2.5 y versiones posteriores vienen con un servidor ``WSGI`` +que se utilizará en este tutorial. En la versión de Python 2.4 y anteriores se puede instalar. Para el código de producción, emplee un estándar probado -en la industria como Apache con `mod_wsgi `_. +en la industria como Apache con el módulo `mod_wsgi`_. -Todo el código en este tutorial es de bajo nivel y tiene el único -propósito de demostrar la especificación WSGI en funcionamiento. +Todo el código fuente en este sección es de bajo nivel y tiene el único +propósito de demostrar la especificación ``WSGI`` en funcionamiento. No es para uso real. Para código de producción, utilice a los kits -de herramientas, frameworks y middleware. +de herramientas, :ref:`frameworks Web ` y **middleware**. .. figure:: ../_static/images/web_browser_server_wsgi.png :class: image-inline @@ -92,3 +91,8 @@ de herramientas, frameworks y middleware. .. .. disqus:: + + +.. _`Bottle`: https://bottlepy.org/docs/dev/ +.. _`PEP 3333`: https://peps.python.org/pep-3333 +.. _`mod_wsgi`: https://modwsgi.readthedocs.io/en/master/ diff --git a/source/leccion5/index.rst b/source/leccion5/index.rst index e4f1820..4d518cb 100644 --- a/source/leccion5/index.rst +++ b/source/leccion5/index.rst @@ -60,7 +60,7 @@ el que mejor se adapte a sus necesidades específicas. Incluye una gran cantidad de funcionalidades integradas, como un ORM (Object-Relational Mapping), un sistema de autenticación y un panel de administración. -- **Pyramid**: Un framework que se adapta tanto a proyectos pequeños +- `Pyramid`_: Un framework que se adapta tanto a proyectos pequeños como a aplicaciones complejas. Pyramid es muy flexible y permite a los desarrolladores elegir los componentes que desean utilizar. - :doc:`FastAPI <../leccion8/index>`: Un framework moderno y de alto @@ -75,6 +75,10 @@ Al elegir un framework web en Python, es importante considerar factores como la complejidad del proyecto, las necesidades de rendimiento y las preferencias personales del equipo de desarrollo. +.. important:: + Es importante comunicarse con el equipo de desarrollo para asegurarse de + que el framework se adapte adecuadamente a sus necesidades. + ---- @@ -93,3 +97,6 @@ preferencias personales del equipo de desarrollo. .. .. disqus:: + + +.. _`Pyramid`: https://pypi.org/project/pyramid/ diff --git a/source/leccion6/admin_dashboard.rst b/source/leccion6/admin_dashboard.rst index 1ee6e55..79dabaf 100644 --- a/source/leccion6/admin_dashboard.rst +++ b/source/leccion6/admin_dashboard.rst @@ -12,7 +12,7 @@ Requisitos previos Para hacer un demostración local de un aplicación Dashboard de ``Flask-Admin`` requiere instalar las siguientes librerías: -- :ref:`Flask `. +- :ref:`Flask `. - `Flask-Admin `_. diff --git a/source/leccion6/crud_app.rst b/source/leccion6/crud_app.rst index a5d8c53..81d1f3a 100644 --- a/source/leccion6/crud_app.rst +++ b/source/leccion6/crud_app.rst @@ -25,7 +25,7 @@ instalar las siguientes librerías: Para trabajar una aplicación ``Flask`` con bases de datos relacionales requiere instalar las siguientes librerías: -- :ref:`Flask `. +- :ref:`Flask `. - :ref:`SQLAlchemy `. diff --git a/source/leccion6/index.rst b/source/leccion6/index.rst index e2e3508..51abf6c 100644 --- a/source/leccion6/index.rst +++ b/source/leccion6/index.rst @@ -1,4 +1,4 @@ -.. _python_leccion6: +.. _python_flask: Flask ===== diff --git a/source/leccion6/instalacion.rst b/source/leccion6/instalacion.rst index 038ddc3..d1f5935 100644 --- a/source/leccion6/instalacion.rst +++ b/source/leccion6/instalacion.rst @@ -3,7 +3,7 @@ Instalación =========== -Para instalar el framework :ref:`Flask ` debe seguir los siguientes pasos: +Para instalar el framework :ref:`Flask ` debe seguir los siguientes pasos: Requisitos previos diff --git a/source/leccion7/index.rst b/source/leccion7/index.rst index 786c5a9..8bb6c93 100644 --- a/source/leccion7/index.rst +++ b/source/leccion7/index.rst @@ -1,4 +1,4 @@ -.. _python_leccion7: +.. _python_django: Django ====== diff --git a/source/leccion7/instalacion.rst b/source/leccion7/instalacion.rst index 25e760e..4ebed08 100644 --- a/source/leccion7/instalacion.rst +++ b/source/leccion7/instalacion.rst @@ -3,7 +3,7 @@ Instalación =========== -Para instalar el framework :ref:`Django ` debe seguir los siguientes pasos: +Para instalar el framework :ref:`Django ` debe seguir los siguientes pasos: Requisitos previos diff --git a/source/leccion8/index.rst b/source/leccion8/index.rst index 13ddb0d..6c29502 100644 --- a/source/leccion8/index.rst +++ b/source/leccion8/index.rst @@ -1,4 +1,4 @@ -.. _python_leccion8: +.. _python_fastapi: FastAPI ======= diff --git a/source/leccion8/instalacion.rst b/source/leccion8/instalacion.rst index f02efef..869be51 100644 --- a/source/leccion8/instalacion.rst +++ b/source/leccion8/instalacion.rst @@ -3,7 +3,7 @@ Instalación =========== -Para instalar el framework :ref:`FastAPI ` debe seguir los siguientes pasos: +Para instalar el framework :ref:`FastAPI ` debe seguir los siguientes pasos: Requisitos previos