1. Introducción

2. Plugins n4d

El desarrollo de módulos n4d es bastante sencillo, y consiste principalmente en:

• Ddefinir la clase y los métodos que queremos implementar.
• Indicar al sistema n4d cómo publicar estos métodos de cara a exterior.

La mejor manera de ver esto es através de un pequeño ejemplo que veremos a continuación.

La estructura de un plugin consta de dos ficheros, uno de configuración (/etc/n4d/conf.d) y otro de implementación de la clase (/usr/share/n4d/).

Dentro de la carpeta /usr/share/n4d tenemos diferentes carpetas en función del lenguaje de prograión que usemos para hacer el plugin:

• python-­plugins: escritos en python
• perl-plugins: escritos en perl
• binary-plugins: escritos en bash

3. Creación de un plugin chat de aula

Nuestro plugin, que vamos a nombrar como N4dChat, implentará tres métodos, y dispondrá de un atributo donde guardar los mensajes:

• ClaseN4dChat
  • Atributo mensaje: lista de mensajes.
  • Método SendMessage(ip, usuario, mensaje): Cogerá la ip de quién lo envia, el nombre de usuario y el mensaje.
  • Método getMessages(inicio): Devolverá todos los mensajes enviados a par del mensaje marcado como "Inicio".
  • Método saveChat(archivo): guardará todos los mensajes en el /tmp del servidor.

Los métodos sendMessage y getMEssage son accesibles para todo el mundo y savehat será solo accesible para administradores y profesores.

Para implementar esto crearemos un fichero /etc/n4d/conf.d/N4dChat amb el siguiente contenido:

[SETUP]
type=python
path=N4dChat.py
class=N4dChat
[METHODS]
(ip)sendMessage=anonymous
getMessages=anonymous
saveChat=adm,admins,teachers

Podemos ver que tenemos dos secciones en el archivo:

• SETUP: que es donde se configura el plugin.
  • type=python : definimos el lenguaje de programación del plugin.
  • path=N4dChat.py Nombre del fichero donde se implementan los métodos
  • class=N4dChat Nombre de la clase
• METHODS: donde se indican los métodos que se hacen publicos en la clase.
  • (ip)sendMessage=anonymous : la ip delante indica que la ip de la máquina se envía como primer parámetro
  • getMessages=anonymous
  • saveChat=adm,admins,teachers

import os import json class N4dChat: def __init__(self): ''' Class Constructor: Initializes Messages ''' # Define Messages as a List (empty) self.Messages=[] pass #def init def sendMessage(self, ip, username, message): ''' sends a Message to chat from user,ip ''' try: # Msg is a register formed by ip, username and message msg={"ip":ip, "username": username, "message":message} self.Messages.append(msg) except Exception as e: print "except "+str(e) return ­1 #def sendMessage def getMessages(self,startMsg): ''' returns messages from startMsg to last message ''' try: # Python sublists notation: list[stat:end] return(self.Messages[int(startMsg):]); except Exception as e: print "except "+str(e) return ­1 return 0 #def getMessages def saveChat(self, filename): try: with open("/tmp/"+filename, 'w') as outfile: json.dump(self.Messages, outfile) except Exception as e: print "except "+str(e) return ­1 return 0 # def saveChat #class N4dChat