Classe irc multhi-thread, multi-server .. autonome avec hook sur commandes, pseduo, chan etc ..

Soyez le premier à donner votre avis sur cette source.

Vue 6 545 fois - Téléchargée 452 fois

Description

Cette classe permet d'integrer à vos progs l'irc, permet en deux lignes de se connecter à un server, s'identifier, et lance un thread par serveur qui gere la connexion, les reponses, les pings etc ..

- Se reconnecte automatiquement au serveur si deconnexion, et re-join les cannaux précedements joint, change de nick s'il est utilisé ..
- Gere les notices, messages (salon, privés ..), l'identification, changement de nick .. l'utilisateur a la possibilité de changer dynamiquement la vitesse de comunication avec le serveur, pour eviter les Excess flood.
- Appel de vos fonctions sur les evenements choisis, que ce soit sur un destinataire (chan), source (pseudo ou chan ) ou morceau de texte dans le message, vous pouvez dans les limite de la mémoire disponnible (...) definir des hook, ex : obj.bind("yAAm",IRC_NOTICE,HOOK_SRC,traite_notice) ;
=> va appeler votre fonction "traite_notice" à chaques fois que l'utilisateur yAAm envoie une NOTICE sur le bot ..
- fonctionne selon plusieurs mode :
- evenementiel -> gestion des hook
- semi autonome (par default) -> gere les messages du erveur, par ex nick name is in use, no such channel etc .. et y repond, mais vous laisse gerer les messages utilisateur. Vous devez alors depiler les messages traité de la pile
- completement autonome -> gere tout les messages, pas besoin de gerer la pile. Ca sert surtout à emetre des messages, pour logger etc ..
- minimal -> ne gere rien, sauf le ping, la connexion/reconnexion etc. vous devez traiter les messages utilisateur + messages d'erreur serveur

Si vous l'utiliser donnez moi votre avis !!

Le code utilise les socket windows, la winsock2.h, et ne compilera pas sur une autre systeme .
MyIrc.h -> à include dans le projet
MyIrc.cpp -> à rajouter à voter projet.
main.cpp programme d'exemple de l'utilisation.
N'hesitez pas à me contacter pour l'ameliorer, rajouter des fonctionalités, ou même pour me conseiller sur le codage.

Qu'en pensez vous ?

Source / Exemple :


#include "MyIrc.h"

//ex : 

int traite_notice(irc_event * recipient, void * obj)
{
	myIrc * myobj = reinterpret_cast<myIrc *>(obj);
	myobj->message("#testx",recipient->msg) ;
	return 0 ;
}
int traite_all(irc_event * recipient, void * obj)
{
    myIrc * myobj = reinterpret_cast<myIrc *>(obj);
	myobj->message("#testx",recipient->msg) ;
	return 0 ;
}

// Deux declarations de fonctions : attention, les fonction bindées doivent repecter ce prototype  : int xxxxxx(irc_event * , void *obj) 
// ou obj est un myIrc * transmis en parametre pour reagir directement sr le serveur si besoin avec ses fonctions membres 

//exemple de bindage : 
     server2.bind("yAAm",IRC_NOTICE,HOOK_SRC,traite_notice) ;  
     server2.bind("",IRC_ALLCMD,HOOK_MSG,traite_all) ; // bind sur tout type de message, de toute provenance 
//Voir le main.cpp -> un exemple que recopie un chan present sur un serveur, sur un autre chan qui est sur un serveur different. 
// le programme d'exemple repond à ces quelques commandes 

//!talk -> recopie le salon #programmation sur le serveur irc.freenode.net #testx 
//!shut -> arrete de recopier les messages  
//!nick le_nick mot_de_pass_nickserv -> change de nom, et s'identifie 
//!speed x -> change la vitesse de com ac le serveur 
//---> ces commandes sont geré sur l'objet serveur1 qui est en mode semi autonome.  

//l'objet serveur2 lui est en mode evenementiel donc n'appel que les fonction qui sont bindées .-> plus simple à utiliser, l'utilisateur n'a rien à "depiler"

Conclusion :


petite explication : La classe fonctionne avec une pile irc_istack et irc_ostack (input et output) protegée par des mutex. ce sont deux listes dans lesquelles les "messages" s'ajoutent pour être traités par la suite soit par irc_thread, pour envoyer ce qui se trouve dans irc_ostack, soit par main_thread qui gere les bind sur les fonctions + l'input.
L'exemple parle de lui même pour la connexion, et l'envoi de message, la reception.

Pourquoi deux thread ?

L'input et l'output sont separé , ce qui implique deux vitesse de communication differentes, pas besoin de temporiser sur la reception. De plus si une de vos fonction appelée met du temps à retourner, le thread qui gere l'envoi de message n'en sera pas retardé, et continuera à reagir. Si une liste d'envoi de message tres grosse est en cours, aucune chance de ping time out, et le programme continuera à reagir sur les evenements arrivants.


d'autres fonctions :

objet.chnick("nick") ; change de nick
objet.notice("destinataire","message") ; envoie une notice
objet.disconect() ; se deconecte du serveur, nettoie les piles.., ferme les thread de gestion tcp

avant de se connecter à un autre serveur, regler l'adresse avec objet.serveur (char *), objet.port (int) .si elle change
objet.xconnect() ; se connecte au serveur, et relance les thread de gestion tcp et irc

objet.part("#chan") part du salon et l'efface de la liste des salon à rejopindre en cas de deconnection
etc ..

L'objet stocke toute les fonctions que vous bindez avec. et les executera toutes si eles correspondent au evenements entrant. Autrement dit si vous fait un hook gobal + un hook sur PRIVMSG sans preciser de source + un hook sur un utilisateur, et que l'utilisateur parle vos trois fonctions vont etre appelées .
Je pense qu'avec cette classe, plus besoin de réecrire un bout de code vite fait mal fait pour ajouter l'irc à vos progs, ca devrai suffire amplement ..

regardez le MyIrc.h pour avoir plus d'infos ou demandez. Que pensez vous du codage, de l'architecture de la classe ou encore de l'utilisation ? Ces remarques m'interesse ! Si vous trouvez des bugs, signalez le moi .. :))

Codes Sources

A voir également

Ajouter un commentaire

Commentaires

Messages postés
123
Date d'inscription
samedi 29 novembre 2003
Statut
Membre
Dernière intervention
11 mars 2007

Ca parait bien je vais regarder ça demain quand j'serai moins crevé et j'dirai quoi
*add bookmark*
Messages postés
23
Date d'inscription
jeudi 16 mars 2006
Statut
Membre
Dernière intervention
23 mars 2007

Un petit commentaire serait le bien venu, si une note est posée ;-)

Vous n'êtes pas encore membre ?

inscrivez-vous, c'est gratuit et ça prend moins d'une minute !

Les membres obtiennent plus de réponses que les utilisateurs anonymes.

Le fait d'être membre vous permet d'avoir un suivi détaillé de vos demandes et codes sources.

Le fait d'être membre vous permet d'avoir des options supplémentaires.

Du même auteur (bAzilew)