La Aventura de Ruby on Rails (Parte 3): Hola Mundo

Con la instalación de Rails obtenemos un nuevo comando de consola, rails, que se usa para construir una nueva aplicación web.

Se preguntarán: ¿Por qué demonios necesito un comando para crear un nuevo proyecto? o quizás digan: Soy un programador que dobla cucharas con la mente ¿Por qué no puedo crear mi proyecto desde cero usando mi editor de texto favorito? Bueno, de hecho, sí se puede crear un proyecto de Rails usando solo un editor de texto y algunos directorios, pero resulta que el comando rails hace un montón de magia tras la cortina para que nuestra aplicación trabaje OUT OF THE BOX con la mínima configuración explícita. Es importante resaltar que la filosofía de Rails es "Convención sobre Configuración".

Además de toda la magia para evitar la configuración, Rails tiene una estructura de directorios muy interesante y cada uno tiene una función bien definida. La imagen a continuación muestra la estructura de un proyecto llamado test:

• app: Contiene los archivos de Modelo, Vista y Controlador


• components: Almacena los componentes reutilizables


• controllers: Guarda todos los controladores


• helpers: Almacena modulos utilitarios de las vistas


• models: Contiene todos los modelos


• views: Almacena todas las vistas


• config: Guarda toda la información de configuración del proyecto y los parametros de conexión a la base de datos


• db: Contiene la información de los esquemas y de las migraciones de la base de datos


• doc: Almacena la documentación autogenerada


• lib: Aloja todo el código que no pertenece exclusivamente a la aplicación (plugins, etc)


• log: Almacena los reportes producidos por la aplicación (y por el framework)


• public: Es la cara externa de la aplicación. El servidor web lo toma como directorio base de la aplicación y lo accesible desde el navegador.


• script: Guarda todos los scripts utilitarios de Rails


• test: Contiene los test unitarios, test funcionales, mocks y fixtures


• tmp: Almacena los archivos temporales de sesiones, cache y cookies


• vendor: Cumple la misma función que lib pero para el código de terceras partes

Lo que realmente nos interesa por los momentos es la carpeta app y todo su contenido; ahí es donde ocurrirá toda la diversión xD

Vamos a crear entonces nuestra primera aplicación de prueba para demostrar los conceptos básicos. Abrimos un terminal y navegamos hasta el directorio donde queremos crear el proyecto, luego ejecutamos:

$ rails test
      create  
      create  app/controllers
      create  app/helpers
      create  app/models
        ..         ..
        ..         ..
      create  log/production.log
      create  log/development.log
      create  log/test.log

Ese comando crea el directorio test con toda la parafernalia y la magia de Rails (directorios, configuraciones, etc). Probemos ahora el script utilitario server para cargar WEBrick (un servidor web que trae Ruby por defecto) y verificar que todo está en orden.

$ ruby script/server
=> Booting WEBrick...
=> Rails application started on http://0.0.0.0:3000
=> Ctrl-C to shutdown server; call with --help for options
[2009-04-21 11:37:30] INFO WEBrick 1.3.1
[2009-04-21 11:37:30] INFO ruby 1.8.7 (2008-08-11) [i486-linux]
[2009-04-21 11:37:30] INFO WEBrick::HTTPServer#start: pid=5199 port=3000

Vamos a nuestro navegador favorito y accedemos a la aplicación con la ruta http://localhost:3000. WEBrick usa por defecto el puerto 3000 pero podemos cambiarlo al puerto de nuestra preferencia ejecutando el server con el parámetro -p y el número del puerto, por ejemplo:

$ ruby script/server -p 8080



Rails es un framework netamente MVC y como tal se basa en un flujo de información de un componente a otro. Primero acepta la solicitud proveniente de un navegador, decodifica la petición para encontrar el controlador y llama una acción de ese controlador. El controlador entonces invoca una vista particular para mostrar el resultado de vuelta al usuario.

Para crear nuestro Hola Mundo necesitamos un controlador y una vista. No hace falta un modelo ya que no estaremos trabajando con ningún tipo de datos.

Así como usamos el comando rails para generar el proyecto, usaremos el script generate para crear un controlador. Supongamos que queremos llamar a nuestro controlador Prueba:

$ ruby script/generate controller Prueba
      exists  app/controllers/
      exists  app/helpers/
      create  app/views/prueba
      exists  test/functional/
      create  app/controllers/prueba_controller.rb
      create  test/functional/prueba_controller_test.rb
      create  app/helpers/prueba_helper.rb

El controlador se ha creado en app/controllers/prueba_controller.rb. Si examinamos el código fuente veremos algo como:

class PruebaController < ApplicationController
end

El controlador es bastante simple, una clase PruebaController que hereda de ApplicationController y por consiguiente tiene todos sus métodos. Es importante resaltar que Rails usa una convención de nombres que poco a poco iremos conociendo, por ejemplo para los nombres de las clases usa el estilo CamelCase, para los nombres de los métodos usa minúsculas separadas por guión bajo y así sucesivamente.

Ahora nos toca personalizar un poco nuestra nueva clase; agreguemos una acción llamada saludar:

class PruebaController < ApplicationController
  def saludar
  end
end

Por los momentos la acción saludar no hará nada porque la tarea del controlador es preparar el terreno y la información para que la vista sepa qué mostrar. En esta aplicación no hay nada que preparar, así que una acción vacía será más que suficiente.

Veamos como acceder a esta nueva acción. Rails asocia las URL con la aplicación; la primera parte de la URL identifica la aplicación, la siguiente el controlador y la última la acción a invocar. El siguiente ejemplo ilustra mejor:



Si vamos a esa URL en nuestro navegador veremos una página como la siguiente:



No hay que alarmarse por el error, se debe a que hemos definido un controlador con una acción pero no hemos creado una vista. Las vistas deben ir asociadas con las acciones del controlador y se almacenan en el directorio app/views. Allí deberiamos tener un directorio por cada controlador creado y dentro de esos directorios van las vistas de cada acción. En este caso debemos crear una vista llamada saludar.rhtml dentro del directorio app/views/prueba. El código fuente de esa vista debería ser algo como:

<html>
  <head>
    <title>Hola Mundo</title>
  </head>
  <body>
    <h1>Hola Mundo! desde Rails</h1>
  </body>
</html>

Intentemos de nuevo abrir la dirección http://locahost:3000/prueba/saludar en nuestro navegador y voilá! Ahora si tenemos una vista =D



Hasta el momento nuestra página es vulgar y aburrida... vamos a cambiar esa situación; ¡agreguemos contenido más dinámico!

Una de las formas más simples de añadir contenido dinámico a una vista es incrustando código Ruby al más puro estilo PHP. Las vistas deben tener extensión .rhtml, porque de esa forma le indicamos a Rails que ese archivo debe ser interpretado usando el sistema ERb (de Embbeded Ruby).

Todo el contenido escrito en HTML es pasado al navegador directamente pero el contenido que esté encerrado entre los símbolos <%= y %> es intrepetado y ejecutado como código Ruby. El resultado de esa ejecución se convierte a cadena de texto y se reemplaza in situ por la secuencia anterior para entonces generar una salida HTML pura hacía el navegador.

Aclarado ese punto pasemos al controlador para preparar la información que mostrará la vista. Calculemos, por ejemplo, la hora actual agregando unas líneas al controlador. El código debería quedar así:

class PruebaController < ApplicationController
  def saludar
    t = Time.now
    @time = t.strftime('%H:%m:%S')
  end
end

Y ahora actualizamos la vista para que muestre la variable @time:

<html>
  <head>
    <title>Hola Mundo!</title>
  </head>
  <body>
    <h1>Hola Mundo! desde Rails</h1>
    <p>Son las <%= @time %></p>
  </body>
</html>

Ruby suele definir las variables de una clase con una arroba (@) al comienzo del nombre. Para enviar contenido a la vista usamos estas variables de instancia del controlador, pero... ¿Cómo puede la vista leer una variable que es privada del controlador? Pues sencillo, Rails hace una de David Cooperfield para que la vista pueda leer a la fulana variable xD.

Sin más preámbulo, nuestra aplicación debería verse así:



Esta página no es la madre del dinamismo pero al menos cambiará con cada actualización xD

Aquí termina el Hola Mundo. Más adelante estaré publicando una aplicación un poco más elaborada donde se use una base de datos e interactuemos con los modelos.

Cambio y fuera.

Cómo usar SQLite en Python

SQLite (para los que no la conocen) es una pequeña librería que nos permite manejar bases de datos relacionales y transaccionales, sin necesidad de servidor, sin configuración y almacenadas en un solo archivo en la máquina host.

En otras palabras, nuestra base de datos no es más que un archivo almacenado localmente al que nuestra aplicación tendrá acceso mediante llamadas a las rutinas de la librería como en los viejos tiempos. Symbian, Mozilla, Bloomberg y Adobe son solo algunos pequeños usuarios de esta poderosa librería.

Este tutorial está desarrollado usando Debian Squeeze (testing), Python 2.5.4 y SQLite 3. Empezamos por instalar los paquetes necesarios:

# aptitude install python-pysqlite2 sqlitebrowser

Pysqlite2 es un binding de SQLite para python y el sqlitebrowser es una aplicación que nos permitirá administrar la base de datos. Ejecutamos el browser desde un terminal:

$ sqlitebrowser



Vamos al menú File -> New Database para crear una nueva base de datos, le indicamos la ruta y el nombre, para nuestro ejemplo será test.db.



Luego, vamos al menú Edit -> Create Table y creamos una nueva tabla llamada Usuarios con los siguientes campos:

id -> INTEGER PRIMARY KEY
nombre -> TEXT
edad -> NUMERIC
correo -> TEXT
url -> TEXT
visitas -> NUMERIC

Imaginemos que esta tabla es para manejar un sistema donde registraremos a los usuarios que visitan nuestra página web y almacenamos el número de visitas de cada uno (sí, lo se... apesta, pero fue lo mejor que se me ocurrió como ejemplo :S). Debería quedarnos algo así:



Luego que estemos conformes hacemos click en el botón Create y guardamos los cambios en File -> Save Database.

Ahora vamos con la parte divertida, creamos un nuevo archivo de texto con nuestro editor favorito (el mío es SciTE) y lo guardamos como test.py en la misma carpeta donde guardamos la base de datos.

Lo primero que necesitamos para conectarnos a esa base de datos es importar la librería:

import sqlite3

Hacemos la conexión:

connection = sqlite3.connect('test.db')

La mayoría de las operaciones sobre la base de datos se hacen usando un cursor; un objeto que apunta a la base de datos y a través del cual podemos ejecutar instrucciones similares al SQL estándar (pero no idénticas) para obtener, insertar, actualizar o borrar registros.

cursor = connection.cursor()

Muy bonito todo pero se preguntarán ¿Cómo insertamos registros?. La forma recomendada según el librito es usar placeholders (marcadores de posición) puesto que si armamos la cadena usando variables de Python corremos el riesgo de que nos hagan SQL Injection. Es decir, en lugar de hacer esto:

user = 'pedro'
cursor.execute("SELECT * FROM tabla WHERE usuario = '%s'" % user)

Debemos usar tuplas y hacer esto:

user = ('pedro',)
cursor.execute('SELECT * FROM tabla WHERE usuario =?', t)

Insertemos entonces algunos datos para rellenar esa insípida tabla. Primero creamos un arreglo donde esté toda la información a insertar (en este caso es así porque vamos a insertar muchos datos, pero también podemos hacerlo uno por uno)

datos = [
    ('Pedro Perez', 34, 'pperez@tucorreo.com', '', 4),
    ('Maria Gomez', 25, 'maria@sucorreo.com', '', 7),
    ('Pablo Rodriguez', 41, 'pablor@elcorreo.com', 'www.pablo.com', 3),
]

Ahora usamos un iterador para recorrer el arreglo e insertarlo:

for t in datos:
    cursor.execute('INSERT INTO Usuarios (nombre,edad,correo,url,visitas) VALUES (?,?,?,?,?)', t)

Pero esperen, aún no hemos completado la tarea. SQLite es un gestor transaccional por lo que debemos realizar "la transacción" usando el comando commit, de lo contrario ningún cambio se hará efectivo sobre el archivo. Esto aplica para todas las operaciones que modifican la base de datos (léase INSERT, UPDATE, DELETE, etc).

connection.commit()

¡Qué bien! Ya sabemos insertar registros, ya nuestra base de datos no es tan insípida ;)

Ahora veamos como obtener la información que acabamos de guardar. Esto es tan sencillo como estructurar la búsqueda y ejecutarla.

Primero veamos como listar todos los registros:

cursor.execute('SELECT * FROM Usuarios')
for row in cursor:
    print row

Esto nos imprime en el terminal algo como:

(u'pperez@tucorreo.com', 34, 1, u'Pedro Perez', u'', 4)
(u'maria@sucorreo.com', 25, 2, u'Maria Gomez', u'', 7)
(u'pablor@elcorreo.com', 41, 3, u'Pablo Rodriguez', u'www.pablo.com', 3)

Y si queremos una búsqueda más específica podemos hacer algo como lo siguiente para buscar el nombre y las visitas de todos los registros con id igual a 1:

id = (1, )
cursor.execute("SELECT nombre, visitas FROM Usuarios WHERE id=?", id)
for row in cursor:
    print "%s ha realizado %i visitas" % (row[0], row[1])

Para obtener:

Pedro Perez ha realizado 4 visitas

Vamos ahora a actualizar un registro. Es tan fácil como realizar una búsqueda pero usando el comando UPDATE; le decimos qué tabla vamos a actualizar, los campos con sus nuevos valores y la condición que identifica al registro. Para actualizar la edad de Pablo a 24 sería algo como:

values = (24, 'pablor@elcorreo.com', )
cursor.execute("UPDATE Usuarios SET edad=? WHERE correo=?", values)
connection.commit()

Donde values es la tupla que se reemplazará donde están los placeholders. El motor de SQLite interpretará esa búsqueda como si le dijeramos:

cursor.execute("UPDATE Usuarios SET edad=24 WHERE correo='pablor@elcorreo.com'")

La ventaja de los placeholders es que nos permiten crear instrucciones dinámicas y cambiar el contenido de la misma sin tener que estructurarla nuevamente (muy útil para usarla en bucles).

Pero ¿cómo sabemos que realmente se actualizó el registro? Pues sencillo, listemos de nuevo todos los registros:

cursor.execute('SELECT * FROM Usuarios')
for row in cursor:
    print row

Y en el terminal veremos algo como (nótese el nuevo valor de la edad de Pablo):

(u'pperez@tucorreo.com', 34, 1, u'Pedro Perez', u'', 4)
(u'maria@sucorreo.com', 25, 2, u'Maria Gomez', u'', 7)
(u'pablor@elcorreo.com', 24, 3, u'Pablo Rodriguez', u'www.pablo.com', 3)

Todo se ve muy bien, pero surge una última pregunta: ¿Cómo rayos puedo borrar un registro?. Simple, la instrucción DELETE obvio ¿no? seguida de la tabla y de la condición que identifica al registro. Borremos a todos los ancianos usuarios mayores de 34 de nuestro registro:

value = (34,)
cursor.execute("DELETE FROM Usuarios WHERE edad >= ?", value)
connection.commit()

Y una vez más mostramos a todo el mundo:

cursor.execute('SELECT * FROM Usuarios')
for row in cursor:
    print row

Obteniendo:
(u'maria@sucorreo.com', 25, 2, u'Maria Gomez', u'', 7)
(u'pablor@elcorreo.com', 24, 3, u'Pablo Rodriguez', u'www.pablo.com', 3)

Lo sentimos mucho por Pedro Pérez pero esa es la Ley del Oeste ;)

Para finalizar el testamento la entrada les dejo el archivo test.py después de unir todo lo que hemos hecho hasta ahora:

# -*- coding: utf-8 -*-
# Importamos la libreria de SQLite
import sqlite3

# Creamos la conexion
connection = sqlite3.connect('test.db')

# Creamos el cursor
cursor = connection.cursor()

# Creamos el arreglo que contiene toda la informacion
datos = [
    ('Pedro Perez', 34, 'pperez@tucorreo.com', '', 4),
    ('Maria Gomez', 25, 'maria@sucorreo.com', '', 7),
    ('Pablo Rodriguez', 41, 'pablor@elcorreo.com', 'www.pablo.com', 3),
]

# Insertamos todos los registros
for t in datos:
    cursor.execute('INSERT INTO Usuarios (nombre,edad,correo,url,visitas) VALUES (?,?,?,?,?)', t)

# Hacemos efectiva la transaccion
connection.commit()

# Imprimimos todos los registros
print "\nLista de todos los registros de la base de datos:"
cursor.execute('SELECT * FROM Usuarios')
for row in cursor:
    print row

# Imprimimos solo el registro que tenga id = 1
id = (1, )
cursor.execute("SELECT nombre, visitas FROM Usuarios WHERE id=?", id)
for row in cursor:
    print "\n%s ha realizado %i visitas" % (row[0], row[1])

# Actualizamos la edad de Pablo
values = (24, 'pablor@elcorreo.com', )
cursor.execute("UPDATE Usuarios SET edad=? WHERE correo=?", values)
connection.commit()
print "\nActualizada la edad de Pablo"

# Y volvemos a imprimir todos los registros para verificar los cambios
print "\nRegistros de la base de datos despues de actualizar a Pablo:"
cursor.execute('SELECT * FROM Usuarios')
for row in cursor:
    print row
    
# Borramos todos los registros con edades mayores de 34 anios
value = (34,)
cursor.execute("DELETE FROM Usuarios WHERE edad >= ?", value)
connection.commit()
print "\nBorrados todos los ancianos ;)"

# E imprimimos otra vez todos los registros para verificar los cambios
print "\nRegistros de la base de datos despues de borrar a los viejitos:"
cursor.execute('SELECT * FROM Usuarios')
for row in cursor:
    print row
    
# Finalmente cerramos todo como debe ser
cursor.close()
connection.close()

Es todo, espero que les haya sido de utilidad este pequeño tutorial

Dust Theme en Debian

Últimamente he estado viendo muchas capturas de pantalla en la web con un tema de ventanas que me llama mucho la atención, principalmente porque es negro y además porque tiene un estilo demasiado limpio, moderno y estilizado, con bordes redondeados y muy bien trabajado. No es de esos temas negros que te queman la retina a los pocos minutos, es más bien un tema agradable... les hablo del famoso Dust Theme.



Éste tema lo han creado Rico Sta. Cruz y Kido Mariano con la idea de que sea incluido en el Ubuntu 9.04 (Jaunty Jackalope) para refrescar y mejorar un poco la apariencia del escritorio. Ojalá lo logren porque no es la primera vez que se escucha a la gente de Ubuntu decir que van a revolucionar el escritorio, que van a sacar un nuevo tema que nos dejará a todos boquiabiertos y bah... siempre salen con la misma cochinada el mismo tema Human :S

Bueno, lo primero que debemos saber es que el tema Dust trabaja con los motores de GTK2 Murrine y Clearlooks. Sin embargo el motor Murrine que trae Debian Squeeze no funciona con Dust, así que tenemos que descargar la versión SVN y compilarlo... nada del otro mundo xD

Instalaremos primero todas las dependencias:
# aptitude install gtk2-engines subversion build-essential automake autoconf intltool libtool libgtk2.0-dev

Luego nos descargamos la versión SVN de Murrine y la compilamos:
$ svn co http://svn.gnome.org/svn/murrine/trunk/ murrine
$ cd murrine
$ ./autogen.sh --prefix=/usr --enable-animation
$ make
# make install

El parámetro --enable-animation permite entre otras cosas habilitar las barras de progreso animadas (cosa que lograron gracias a Cairo).

Por último, descargamos el tema Dust para GTK2, el Dust para Firefox y los extras de Dust.

El Dust de GTK2 y los extras de Dust los instalamos de la siguiente forma: vamos al menú Sistema -> Preferencias -> Apariencia y arrastramos los archivos comprimidos dentro de la ventana anterior o simplemente descomprimimos los archivos en la carpeta ~/.themes. Cuando estén instalados entonces los seleccionamos en la misma ventana que sale en Sistema -> Preferencias -> Apariencia.

Al final nos debería quedar algo así:



Aún me falta instalar las fuentes que trae por defecto el Dust, cuando lo haga actualizo el post.

Cambio y fuera