Objet de Debuggage
Présentation
A la base, j'avais conçu cette classe pour répondre à un besoin simple : comment afficher les messages de debuggage lorsque l'on est en train de concevoir un programme dans un environnement multi-thread ?
Après quelques recherches, la réponses fut plutôt simple : un objet qui dispose d'une file d'attente et qui affiche les messages au fur et à mesure de leur arrivée dans cette file.
Cette "bibliothèque" est diffusée sous license
GNU LGPL.
Détail des fonctions
-
Creation :
DbgObj = DebugObject(level=0, target_file=None)
Pramètres :
- level : (optionnel) permet de définir un niveau maximum d'affichage des messages (cf la fonction Show)
- target_file : (optionnel) permet d'indiquer l'emplacement d'un fichier qui recevra les informations de debuggage au lieu de les envoyer à la sortie standard
Retourne :
- une instance de la classe en cas de succès
- False en cas d'erreur
-
Lancement de la boucle principale :
DbgObj.start()
Pramètres :
Retourne :
-
Envoi d'un message de debuggage :
DbgObj.Show( message, level=0 )
Pramètres :
- message : le message de debuggage à envoyer
- level : (optionnel) permet d'affecter un "niveau" au message envoyé ; en fonction du niveau passé lors de l'initialisation de l'objet, le message pourra ne pas être pris en compte
Retourne :
-
Arrêt de l'objet :
DbgObj.stop( waiting=False )
Pramètres :
- waiting : (optionnel) indique s'il faut attendre ou non que l'objet est terminé le traitement des messages dans la file d'attente avant de revenir au programme appellant
Retourne :
Exemple
from DebugObject import DebugObject
# Création de l'objet
DbgObj = DebugObject()
# Lancement de l'objet
DbgObj.start()
# Le traitement doit s'effectuer ici
DbgObj.Show("Ceci va s'afficher")
DbgObj.Show("Ceci ne va pas s'afficher",1)
# Arrêt de l'objet
DbgObj.stop(True)
Téléchargement
License GNU LGPL
Télécharger la bibliothèque