Objet de Debuggage

• Présentation
• Détail des fonctions
• Exemple
• Téléchargement

---

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 :
  • aucun
  Retourne :
  • None
• 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 :
  • True
• 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 :
  • True

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