« RobotJabberFR » : différence entre les versions

De Wiki JabberFR
Aller à la navigation Aller à la recherche
(la faute n'a pas était corrigée à la bonne ligne)
 
(11 versions intermédiaires par 6 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
= Projet de [[Robot]] multifonction pour la communauté JabberFR =
== Projet de [[Robot]] multifonction pour la communauté JabberFR ==
== Participants ==
=== Participants ===
Liste des personnes volontaires pour aider à la création du robot.
Liste des personnes volontaires pour aider à la création du robot.
* [[Utilisateur:Omega|Omega]] (omega_chez_im.apinc.org)
* [[Utilisateur:Omega|Omega]] (omega_chez_im.apinc.org)
Ligne 6 : Ligne 6 :
* [[Utilisateur:Talou|Talou]] (JID:talou_chez_timot.net)
* [[Utilisateur:Talou|Talou]] (JID:talou_chez_timot.net)


== Solutions de bots existantes ==
=== Solutions de bots existantes ===
* [http://ejabberd.jabber.ru/neutron Neutron] (python)
* [http://ejabberd.jabber.ru/neutron Neutron] (python)
* [http://www.jezuk.co.uk/cgi-bin/view/whereskal WhereSkal] (python)
* [http://www.jezuk.co.uk/cgi-bin/view/whereskal WhereSkal] (python)
Ligne 12 : Ligne 12 :
* solution basée sur [http://home.gna.org/xmpp4r/ xmpp4r] (ruby)
* solution basée sur [http://home.gna.org/xmpp4r/ xmpp4r] (ruby)


== Fonctions du Robot ==
=== Fonctions du Robot ===
=== Forum ===
==== Forum ====
* Suivi des discussions par abonnement (comme pour les actuelles notifications mail)
* Suivi des discussions par abonnement (comme pour les actuelles notifications mail)
* Recherche
* Recherche


=== Wiki ===
==== Wiki ====
* Suivi des modifications d'articles par abonnement (comme pour les notifs mail actuelles)
* Suivi des modifications d'articles par abonnement (comme pour les notifs mail actuelles)
* Recherche
* Recherche


=== Planet ===
==== Planet ====
* Abonnement aux notifications de nouveaux billets
* Abonnement aux notifications de nouveaux billets
* Historique et recherche dans le planet
* Historique et recherche dans le planet
Ligne 27 : Ligne 27 :
* Admin : mise à jour manuelle
* Admin : mise à jour manuelle


=== Annuaire ===
==== Annuaire ====
* Recherche et interrogation de l'annuaire
* Recherche et interrogation de l'annuaire
:Est-ce vraiment utile ? L'annuaire est déjà disponible de puis jabber ... [[Utilisateur:Omega|Omega]] 29 mar 2006 à 17:45 (CEST)
:Est-ce vraiment utile ? L'annuaire est déjà disponible de puis jabber ... [[Utilisateur:Omega|Omega]] 29 mar 2006 à 17:45 (CEST)


=== Général ===
==== Général ====
* Présence sur le web (à la manière d'Edgar)
* Présence sur le web (à la manière d'Edgar)
* seen
* seen
Ligne 42 : Ligne 42 :
:Je vois pas à quoi ca peut servir ça ? [[Utilisateur:Omega|Omega]] 24 jun 2006 à 09:12 (CEST)
:Je vois pas à quoi ca peut servir ça ? [[Utilisateur:Omega|Omega]] 24 jun 2006 à 09:12 (CEST)


== Remarques ==
=== Remarques ===
* il peut y avoir plusieurs bots, notamment du fait qu'il y a des éléments de jabberfr sur plusieurs machines, ce qui permet de répartir les commandes. Les ressources sont là pour ça.
* il peut y avoir plusieurs bots, notamment du fait qu'il y a des éléments de jabberfr sur plusieurs machines, ce qui permet de répartir les commandes. Les ressources sont là pour ça.


== Roadmap ? ==
=== Roadmap ? ===


== Inventaire des bots jabber existants ==
=== Inventaire des bots jabber existants ===
[[Robot#Inventaire]]
[[Robot#Inventaire]]


== Aspects techniques ==
=== Aspects techniques ===


=== Client vs Composant ===
==== Client vs Composant ====


Un robot "client" est un robot qui se connecte au serveur de la même manière qu'un client jabber.
Un robot "client" est un robot qui se connecte au serveur de la même manière qu'un client jabber.
Ligne 58 : Ligne 58 :
Un robot "composant" est un robot qui se connecte au serveur comme un composant (par exemple une passerelle). L'avantage d'un tel robot est que son jid est du genre bot.jabberfr.org, on peut donc le faire apparaitre dans les services (disco) des serveurs. On peut aussi plus facilement s'inscrire dessus (comme une passerelle) ou faire des recherches (comme un annuaire). Par contre presqu'aucun bot n'est fait comme ça. On devrait donc tout recoder.
Un robot "composant" est un robot qui se connecte au serveur comme un composant (par exemple une passerelle). L'avantage d'un tel robot est que son jid est du genre bot.jabberfr.org, on peut donc le faire apparaitre dans les services (disco) des serveurs. On peut aussi plus facilement s'inscrire dessus (comme une passerelle) ou faire des recherches (comme un annuaire). Par contre presqu'aucun bot n'est fait comme ça. On devrait donc tout recoder.


=== Langage de programmation ===
Pour l'instant le robot est un client, mais il peut très bien se transformer en composant pour avoir plus de fonctionnalités.
* Python
: Langage interprété simple à maitriser et très efficace. Dispose de plusieurs bibliothèques pour XMPP ([http://xmpppy.sourceforge.net/ xmpppy], [http://pyxmpp.jabberstudio.org/ pyxmpp], [http://twistedmatrix.com/ twisted words]).
* PHP
: Langage de programmation orienté web. Permet très simplement d'afficher des présences web. Principalement 3 bibliothèques ([http://cjphp.netflint.net/ class.jabber.php], [http://jabberstudio.org/projects/xmpp4/project/view.php xmpp4] et [http://code.blitzaffe.com/pages/phpclasses/files/jabber_client_52-11 Jabber Client]) dont le développement avance faiblement, avec tout de même un regain pour la dernière.
* Ruby
: [http://home.gna.org/xmpp4r/ xmpp4r]
* Autre
: (C, C++, java, ...)


===Communication entre le wiki/forum/planet/... et le robot===
==== Langage de programmation ====
Python est utilisé avec la biliothèque jabber xmpp.py.
 
==== Communication entre le wiki/forum/planet/... et le robot ====
Pour pouvoir envoyer des notifications de modification il faut que le robot soit au courant de ces modifications.
Pour pouvoir envoyer des notifications de modification il faut que le robot soit au courant de ces modifications.


* RSS
On utilise pour l'instant une communication par xmlrpc
**Le planet, le wiki et le forum possèdent tous les trois un fil RSS, on peut donc très bien récupérer ce fil à interval régulier et envoyer des messages si y'a eu des modifications.
**C'est simple à réaliser mais ce n'est pas instantannée. Et même si le site n'est pas hébergé au même endroit que le robot ca marchera.
:**Le problème du polling, c'est que ça génère du trafic... et des requêtes qui faussent les stats. Le mieux (mais pas facile) est de "pusher" les modifs : les applications doivent être "aware" qu'elles sont client Jabber et doivent envoyer un message à chaque évènement. [[Utilisateur:Nyco|Nyco]] 29 mar 2006 à 08:59 (CEST)
* D-Bus, DCOP ou tout autre moyen de communication entre les processus
**Pas forcément simple à mettre en oeuvre mais au moins on garde le caractère instantannée des notifications.
**Le site doit être sur le même serveur que le robot.
**Il faut avoir des bibliothèque adaptées en php
* Socket ou RPC
**Notifications instantannées
**Possibilité d'avoir les sites sur différents serveurs
**Il faut par contre pouvoir authentifier la connection pour éviter que le robot soit utilisé pour envoyer du spam.


La méthode RPC me semble la plus apropriée par contre il faut pouvoir s'assurer de l'origine de la communication.
Les avantages :
Peut être en envoyant un hash d'un mot de passe ou quelque chose comme ca. [[Utilisateur:Omega|Omega]] 28 mar 2006 à 21:19 (CEST)
*Notifications instantannées
*Possibilité d'avoir les sites sur différents serveurs


= Avancement =
== Utilisation ==
Le bot est en place, son jid est pour l'instant [xmpp:jabberfr@im.apinc.org jabberfr@im.apinc.org].
Le robot est [xmpp:jabberfr@im.apinc.org jabberfr@im.apinc.org]. Vous pouvez l'ajouter comme contact.


Pour l'instant il ne permet que la notification des changements sur le wiki. Pour s'inscrire à la notifications il faut lui envoyer comme message  
=== Liste des commandes ===
  !notice_sub wiki
Envoyer comme message au robot
Les notifications sont encore assez succintes, mais c'est assez facile d'améliorer après. [[Utilisateur:Omega|Omega]] 17 jun 2006 à 13:42 (CEST)
  !commands
Ils vous renverra la liste des commandes disponibles


* Possibilité de ne pas recevoir de notifiactions lorsqu'on est déconnecté, occupé, ou absent
=== Notifications sur le wiki ===
Pour utiliser la notification du wiki il faut envoyer un message au robot en lui disant :
:* Pour recevoir une notification pour tous les changements :
!wiki tout
:* Pour recvevoir une notification uniquement pour les articles suivis :
!wiki suivi
:* Pour ne plus recevoir de notification :
!wiki non
 
=== Notifications sur le forum ===
Pour utiliser la notification du forum il faut envoyer un message au robot en lui disant :
:* Pour recevoir une notification pour tout nouveau message posté sur le forum :
!forum tout
:* Pour ne plus recevoir de notification :
!forum non
 
== Avancement ==
 
* Possibilité de ne pas recevoir de notifications lorsqu'on est déconnecté, occupé, ou absent
  !notice_status busy
  !notice_status busy
pour ne pas recevoir de notification lorsqu'on est occupé (les autres possibilités sont away et offline)
pour ne pas recevoir de notification lorsqu'on est occupé (les autres possibilités sont away et offline)
* Possibilité de configurer le bot avec les commandes ad-hoc [[Utilisateur:Omega|Omega]] 21 jun 2006 à 20:30 (CEST)
* Possibilité de configurer le bot avec les [[commandes ad-hoc]] [[Utilisateur:Omega|Omega]] 21 jun 2006 à 20:30 (CEST)
 
*Correction d'un bug sur les accents [[Utilisateur:Omega|Omega]] 24 jun 2006 à 18:03 (CEST)


* Changement de la manière dont marchent les notifications. Maintenant c'est plus intégré dans mediawiki, et ca permet de ne recevoir des notifications que pour les pages suivies. [[Utilisateur:Omega|Omega]] 14 aoû 2006 à 17:43 (CEST)
* Changement de la manière dont marchent les notifications. Maintenant c'est plus intégré dans mediawiki, et ça permet de ne recevoir des notifications que pour les pages suivies. [[Utilisateur:Omega|Omega]] 14 aoû 2006 à 17:43 (CEST)


* Modularisation d'une partie du code (voir svn) [[Utilisateur:Omega|Omega]] 14 aoû 2006 à 17:45 (CEST)
* Modularisation d'une partie du code (voir svn) [[Utilisateur:Omega|Omega]] 14 aoû 2006 à 17:45 (CEST)


= Participer =
== Participer ==
Pour participer c'est simple il suffit de contacter [User:Omega Omega].
Pour participer c'est simple il suffit de contacter [User:Omega Omega].
* Le dépot subversion se trouve à : [http://gpl.insa-lyon.fr/svn/omega/botjabberfr].
* Le dépot subversion se trouve à : [http://gpl.insa-lyon.fr/svn/omega/botjabberfr].
* Voir le dépot : [http://gpl.insa-lyon.fr/websvn/listing.php?repname=omega&path=%2Fbotjabberfr%2F WebSVN]
* Voir le dépot : [http://gpl.insa-lyon.fr/websvn/listing.php?repname=omega&path=%2Fbotjabberfr%2F WebSVN]
* Récupérer les fichiers : <code>svn co http://gpl.insa-lyon.fr/svn/omega/botjabberfr</code>
* Récupérer les fichiers : <code>svn co http://gpl.insa-lyon.fr/svn/omega/botjabberfr</code>

Dernière version du 29 décembre 2007 à 17:15

Projet de Robot multifonction pour la communauté JabberFR

Participants

Liste des personnes volontaires pour aider à la création du robot.

  • Omega (omega_chez_im.apinc.org)
  • Jb (JID:jb_chez_jabber.fr)
  • Talou (JID:talou_chez_timot.net)

Solutions de bots existantes

  • Neutron (python)
  • WhereSkal (python)
  • solution basée sur cjp (php) - je bosse sur un projet modulaire avec cjp, disponible par svn ici : [1] -- Talou
  • solution basée sur xmpp4r (ruby)

Fonctions du Robot

Forum

  • Suivi des discussions par abonnement (comme pour les actuelles notifications mail)
  • Recherche

Wiki

  • Suivi des modifications d'articles par abonnement (comme pour les notifs mail actuelles)
  • Recherche

Planet

  • Abonnement aux notifications de nouveaux billets
  • Historique et recherche dans le planet
  • Admin : gestion des blogs participants
  • Admin : mise à jour manuelle

Annuaire

  • Recherche et interrogation de l'annuaire
Est-ce vraiment utile ? L'annuaire est déjà disponible de puis jabber ... Omega 29 mar 2006 à 17:45 (CEST)

Général

  • Présence sur le web (à la manière d'Edgar)
  • seen
C'est vraiment utile seen ? C'est déjà définie dans le protocol jabber (JEP-0012) Omega 24 jun 2006 à 09:12 (CEST)
  • help
  • visible (choix des contact du bot de le voir ou non, comme Edgar)
  • admin : presence (gestion de la présence du bot)
Je comprends pas trop ce point. Omega 24 jun 2006 à 09:12 (CEST)
  • admin : gestion du roster du bot
Je vois pas à quoi ca peut servir ça ? Omega 24 jun 2006 à 09:12 (CEST)

Remarques

  • il peut y avoir plusieurs bots, notamment du fait qu'il y a des éléments de jabberfr sur plusieurs machines, ce qui permet de répartir les commandes. Les ressources sont là pour ça.

Roadmap ?

Inventaire des bots jabber existants

Robot#Inventaire

Aspects techniques

Client vs Composant

Un robot "client" est un robot qui se connecte au serveur de la même manière qu'un client jabber.

Un robot "composant" est un robot qui se connecte au serveur comme un composant (par exemple une passerelle). L'avantage d'un tel robot est que son jid est du genre bot.jabberfr.org, on peut donc le faire apparaitre dans les services (disco) des serveurs. On peut aussi plus facilement s'inscrire dessus (comme une passerelle) ou faire des recherches (comme un annuaire). Par contre presqu'aucun bot n'est fait comme ça. On devrait donc tout recoder.

Pour l'instant le robot est un client, mais il peut très bien se transformer en composant pour avoir plus de fonctionnalités.

Langage de programmation

Python est utilisé avec la biliothèque jabber xmpp.py.

Communication entre le wiki/forum/planet/... et le robot

Pour pouvoir envoyer des notifications de modification il faut que le robot soit au courant de ces modifications.

On utilise pour l'instant une communication par xmlrpc

Les avantages :

  • Notifications instantannées
  • Possibilité d'avoir les sites sur différents serveurs

Utilisation

Le robot est jabberfr@im.apinc.org. Vous pouvez l'ajouter comme contact.

Liste des commandes

Envoyer comme message au robot

!commands

Ils vous renverra la liste des commandes disponibles

Notifications sur le wiki

Pour utiliser la notification du wiki il faut envoyer un message au robot en lui disant :

  • Pour recevoir une notification pour tous les changements :
!wiki tout
  • Pour recvevoir une notification uniquement pour les articles suivis :
!wiki suivi
  • Pour ne plus recevoir de notification :
!wiki non

Notifications sur le forum

Pour utiliser la notification du forum il faut envoyer un message au robot en lui disant :

  • Pour recevoir une notification pour tout nouveau message posté sur le forum :
!forum tout
  • Pour ne plus recevoir de notification :
!forum non

Avancement

  • Possibilité de ne pas recevoir de notifications lorsqu'on est déconnecté, occupé, ou absent
!notice_status busy

pour ne pas recevoir de notification lorsqu'on est occupé (les autres possibilités sont away et offline)

  • Changement de la manière dont marchent les notifications. Maintenant c'est plus intégré dans mediawiki, et ça permet de ne recevoir des notifications que pour les pages suivies. Omega 14 aoû 2006 à 17:43 (CEST)
  • Modularisation d'une partie du code (voir svn) Omega 14 aoû 2006 à 17:45 (CEST)

Participer

Pour participer c'est simple il suffit de contacter [User:Omega Omega].