Bueno, continuando con mi anterior post , hoy nos meteremos de lleno en el código del robot, y cómo manipular todas las posibilidades de un Wave.
Si hacemos un poco de memoria en el anterior post hablamos de definir qué eventos escuchamos y qué funciones llama cuando se da ése evento :
facey.RegisterHandler(events.WAVELET_PARTICIPANTS_CHANGED, OnParticipantsChanged) facey.RegisterHandler(events.WAVELET_SELF_ADDED, OnRobotAdded) facey.RegisterHandler(events.BLIP_SUBMITTED, OnBlipSubmit)
Vemos que los eventos a escuchar en éste caso son 1) cuando los participantes cambian, 2) cuando el robot se añade al Wave y 3) cuando alguien escribe un blip (texto).
Vamos a ver primero el evento que pasa antes, cuando añadimos el robot a un Wave se llama la función OnRobotAdded:
def OnRobotAdded(properties, context):
"""El robot ha sido añadido."""
root_wavelet = context.GetRootWavelet()
root_wavelet.CreateBlip().GetDocument().SetText("Hi I'm Lasty, if you have a Last.fm account you can type 'YourLastFMUser-is-listening' and I will tell you what song are you listening! Example Beldar-is-listening")
Debemos tener claro la estructura de un Wave: está formado de Wavelets (agrupación de blips) y de Blips que son el texto que escribimos, pero en todo Wave hay un Wavelet raíz, que es el que tendremos que conseguir para añadir un nuevo blip al final del resto.
Así pues vemos que en la línea 3 conseguimos el Wavelet raíz, y a continuación creamos un nuevo blip e insertamos un texto dentro, en éste caso, cuál es la función del robot y cómo se usa.
Hemos visto un ejemplo muy sencillo de cómo crear un blip e insertar texto dentro, pero algo que debéis saber es que las conversaciones en Wave se envían y guardan en XML puro, por lo que hay una separación total de contenido y formato, es decir se guarda el texto pero no si es un link, está en negrita o qué tamaño tiene, eso se hace mediante las Annotations (anotaciones).
Ahora mismo están muy limitadas las opciones de formato en Wave, ya que se basan en su editor de texto WYSIWYG y siguen unas opciones un tanto extrañas, así como la forma de aplicar un estilo en el editor es seleccionar el texto y darle al botón de negrita, para hacerlo vía código tenemos que hacerlo de la misma forma, definiendo el rango de texto al que queremos aplicar estilo.
Como expliqué en el anterior artículo tenemos que importar el objeto Range para usarlo:
from waveapi.document import Range
La forma de aplicar una Anotación es un poco incómoda porqué siempre debemos saber el tamaño del string que queremos transformar, tomaremos por ejemplo el blip que genera el robotito Lasty, que tiene ésta pinta:
Blip que general Lasty
Como vemos haremos un repaso a cómo insertar negritas, diferentes tamaños de letras, links e imágenes.
Explicaré sólo el trozo de código que se refiere a las anotaciones, aunque podéis ver el código completo en Google Code que intento mantener actualizado.
Como he dicho, en el XML del Wave no se guardan los estilos del texto, pero tampoco las imágenes y otros elementos embebidos, ya que el protocolo de Wave guarda éstas anotaciones como operaciones que el editor aplica una vez cargado el texto, así lo hace en todos los editores y es una de las razones por las cuales se puede dar un intercambio de información a tiempo real tan rápido, ya que no se envía el contenido y el formato por separado, aunque esto signifique hacerle la vida más complicada a los desarrolladores.
