Este documento describe la instalación y configuración de TurboGears, un framework web de código abierto escrito en Python. Explica los componentes principales de TurboGears como SQLAlchemy, Genshi y Pylons. También detalla los pasos para instalar Python, SetupTools, VirtualEnv y TurboGears de forma local, y crear y modificar un proyecto de TurboGears utilizando sus plantillas predeterminadas.

1. INSTITUTO TECNOLÓGICO DE TEHUACÁN
Ingeniería en Sistemas Computacionales
2014
TurboGears
Programación Web
INTEGRANTES:
Martínez Ramos Natalia 11360619
Valencia Cid Mireya 11360660
Instituto Tecnológico de Tehuacán
29/11/2014

2. TurboGears
Introducción
TurboGears es un megaframework para desarrollo web de código abierto, escrito en
Python. Fue creado en el año 2005 por Kevin Dangoor. Es un stack web completo, que
abarca desde Pylons, SQLAlchemy, Genshi, Mako, Reponze y ToscaWidgets.
Está diseñado basado en la arquitectura Modelo–vista–controlador parecido a Stratus o
Ruby on Rails, diseñado para generar rápidamente aplicaciones web en Python y que
sean fáciles de mantener.
Componentes de TurboGears
TurboGears se construye en la parte superior de numerosas bibliotecas dispares y
Middleware. Las herramientas predeterminadas han cambiado entre la serie 1.x y 2.x,
pero la mayoría de estos componentes pueden ser utilizados en cualquiera, ya que
existe soporte para muchas configuraciones alternativas. Los siguientes son los
componentes principales con las que un desarrollador podría interactuar.
TurboGears 2.x
 SQLAlchemy (Modelo de datos) -define la estructura de tablas de la base de
datos del usuario y cómo vincularlos a los objetos de Python controlador del
usuario puede interactuar.
 Genshi (Vista de datos) -define las plantillas para el código HTML o XHTML que
el usuario va a generar. Aquí es donde el usuario define el front-end del usuario
con el que el cliente va a interactuar.
 Pylons (Controlador) -este middleware se encarga de toda la lógica de fondo
del usuario y se conecta al servidor web del usuario para ofrecer seguridad de
datos en la web. Por defecto, se utiliza el servidor web Paster, pero el usuario
también puede conectarse al Servidor HTTP Apache, Nginx, o cualquier otro
servidor web compatible con WSGI.
Objetivo de la práctica
Realizar la instalación del framework TurboGears de forma local y modificar la plantilla
predeterminada.

3. Características del equipo e instalación
 Windows 8 Industry Pro Embebbed
 TurboGears 2.1
 Python 2.6.5
o SetupTools 7.0
Instalación de Python
Desde la página de Python, en el apartado de versiones disponibles para Windows, se
descarga el archivo MSI de Python 2.6.5. Esta versión fue elegida debido a que la
documentación de instalación de TurboGears especifica que la versión 2.1 funciona
correctamente con las versiones 2.5 y 2.6 de Python.
Después de dar doble clic al instalador, inicia el proceso de instalación de Python para
Windows. En la primera ventana, se especifica si Python se va a instalar para todos los
usuarios o sólo para uno.

4. La siguiente ventana especifica el directorio destino de la instalación. Por default y por
conveniencia, se instala en C:.
Se seleccionan las características que se van a instalar.

5. El siguiente paso es la instalación de los componentes especificados anteriormente.
Este paso puede tardar algunos minutos.
Presionando el botón “Finish” se completa la instalación de Python.

6. Modificación del Path
Para que el Símbolo del Sistema admita comandos de Python, se modifica el Path de
Windows. Para ello, se accede a la configuración avanzada del sistema desde
Configuración >> Panel de Control >> Sistema >> Configuración avanzada del sistema
En la ventana que se muestra, dar clic en “Variables de Entorno…”

7. Se modifica el Path de la lista correspondiente a Variables del Sistema.
Al final de la línea, se incluyen las direcciones C:Python26 y C:Python26Scripts

8. separados por “ ; ” (punto y coma).
Instalación de SetupTools
En la página de Python Package Index se busca el paquete correspondiente a
setuptools 7.0 y se siguen las instrucciones correspondientes a la instalación de éste en
Windows.
Desde esta página, se descarga el archivo ez_setup.py dando clic derecho sobre el link
y seleccionando “Guardar enlace como..”

9. Una vez descargado el archivo, al darle doble clic se abrirá una ventana de consola en
la que se indica que setuptools se está descargando y posteriormente instalando.
SetupTools instalará en las carpetas de Python el programa easy_install, el cual permite
descargar e instalar paquetes de ´python de forma sencilla. Este programa es necesario
para la instalación de los siguientes componentes nocesarios para TurboGears.
Instalación de VirtualEnv
Desde la línea de comandos de Windows, se teclea la instrucción easy_install virtualenv
Esta caracteristica permite crer un entorno virtual para cada proyecto de TurboGears
que se realice, ya que permite modificar las librerias de Python, pero sin afectar a las de
la computadora.

10. Crear un entorno virtual
Se abre un directorio donde se pueda crear una carpeta correspondiente al entorno
virtual que se va a utilizar, y se teclea el comando virtualenv –no-sit-packages seguido
del nombre de la nueva carpeta.
Activar el entorno virtual
Para activar el entorno virtual, se abre la carpeta recién creada , y a continuación se
escribe Scriptsactivate.bat

11. Instalación de TurboGears
Para instalar TurboGears se escribe dentro del entorno virtual easy_install.exe -i
http://www.turbogears.org/2.1/downloads/current/index tg.devtools

12. Para crear un proyecto de TurboGears, se escribe el comando paster quickstart seguido
del nombre del proyecto. A continuación, se hacen 3 preguntas para configurar el
proyecto:
Se pide introducir el nombre del proyecto (en caso de dar un Enter, el nombre será el
mismo que el de la carpeta. Después, pregunta sobre si utilizar plantillas Mako o no; y
por último, si8 se requiere autenticación y autorización. Se eligieron los valores
predeterminados para todas estas preguntas.
Se abre el directorio correspondiente al proyecto y se ejecuta el comando python
setup.py develop , el cual agrega el proyecto al entorno virtual y descarga algunos
paquetes para el desarrollo del proyecto.

13. El siguiente comando, paster setup-app development.ini inicializa la base de datos.
El siguiente comando, paster serve development.ini inicia el servidor.
La página de inicio del proyecto nuevo de TurboGears se ve como la siguiente imagen:

14. Modificando algunos de los archivos *.html de las plantillas, se puede cambiar el
aspecto de la página. Algunos de esos cambios se pueden ver a continuación:

15. Carpetas correspondientes al proyecto
Carpeta de los archivos *.html
CSS, JavaScript e
Aspectos de los archivos por separado
Imágenes