Windows

Para el sistema operativo Windows, encontraremos un paquete comprimido con todo lo necesario, simplemente seguir las siguientes instrucciones para tener web2py funcionando:

• Descargar el paquete todo-en-uno web2py_win.zip
• Descomprimirlo
• Ejecutar (doble click) en web2py.exe

Mac

La instalación para Mac es muy similar a Windows, con un paquete comprimido web2py_osx.zip. Solo hay que descomprimirlo y ejecutar web2py.app para lanzar el programa.

GNU/Linux

Por el momento no existen paquetes para las distintas distribuciones de GNU/Linux, ya que en la mayoría de los casos se puede ejecutar simplemente desde el código fuente, dado que Python y las dependencias principales generalmente están preinstaladas en estos entornos.

Para usar web2py desde el código fuente, se pueden realizar los siguientes pasos:

• Instalar las dependencias (python y conectores a la base de datos)
• Descargar el código fuente web2py_src.zip
• Descomprimir
• Ejecutar python web2py.py

Como ejemplo para Ubuntu (o Debian), abrir una consola y ejecutar:

sudo apt-get install python-psycopg2
wget http://www.web2py.com/examples/static/web2py_src.zip
unzip web2py_src.zip
cd web2py
python web2py.py

Arranque

Al ejecutar web2py nos mostrará la pantalla de inicio mientras cargue e inicie el programa:

Luego aparecerá la pantalla del servidor web para desarrollo que web2py trae incorporado. Para iniciarlo deberemos elegir y ingresar una contraseña de administrador propia (por ej. 'abc') y presionar start:

Bienvenida

Al iniciar el servidor, web2py lanzará un explorador con la página de bienvenida predeterminada:

Esta página es la aplicación predeterminada, un "esqueleto" que se usa cuando creamos aplicaciones en web2py.

Básicamente tenemos varios enlaces a la interfaz administrativa, documentación y ejemplos interactivos; y una breve descripción sobre la página que estamos viendo:

• Visitó la URL .../default/index
• Que llamó la función index() ubicada en el archivo .../controllers/default.py
• La salida de este archivo es un diccionario que ha sido renderizado por la vista .../views/default/index.html

Interfaz Administrativa

Una vez que tenemos web2py funcionando y vemos la página de inicio, podemos empezar a crear y editar nuestras aplicaciones web, dirigiéndonos a la interfaz administrativa:

En dicha página, se debe ingresar la contraseña previamente escogida en los pasos previos para poder acceder, y se abrirá un índice con las aplicaciones instaladas en esta instancia:

Aquí podríamos crear nuevas aplicaciones, subir o descargar aplicaciones ya realizadas, editar código fuente, páginas html, subir archivos estáticos o traducir los mensajes, revisar los errores, etc. Todos estos temas los iremos tratando en sucesivos artículos.

En este caso, vamos a ingresar a la aplicación predeterminada welcome (bienvenida), presionando el enlace EDIT (editar):

Y allí, por ejemplo, podemos modificar el código fuente del controlador principal (default.py) presionando en el link edit (editar):

Los enlaces superiores nos permiten editar rápidamente las plantillas html relacionadas y probar las funcionalidades expuestas.

Podemos ver que el código del hola mundo es muy simple, tenemos la función index (que se ejecuta por defecto al ingresar a la aplicación), donde se establece el mensaje intermitente "Bienvenido a Web2Py" y se devuelve un diccionario con una variable mensaje='Hola Mundo' que se usará para generar la página web:

def index():
  """
  acción ejemplo usando el operador de internacionalización T y mensaje flash
  renderizado por views/default/index.html o views/generic.html
  """
  response.flash = T('Welcome to web2py')
  return dict(message=T('Hello World'))

Cabe destacar que este es todo el código es el que se usa en la función para generar la página web, no es obligatorio ejecutar scripts de gestión, modificar archivos de configuración, mapear URL con expresiones regulares y/o importar varios módulos, web2py se encarga de todos estos temas por nosotros.

Por el momento terminaremos aquí, ya que la idea era mostrar una breve introducción a la herramienta. En artículos posteriores veremos de retomar y continuar con temas más avanzados.

Para los usuarios que deseen seguir experimentando con esta herramienta, aconsejamos seguir los ejemplos interactivos: http://www.web2py.com.ar/examples/default/examples, donde se analizan, con pequeños segmentos de código, las características principales del framework.