Exemple minimal PyGObject : mise-à-jour d'une étiquette

Quand on apprend en solitaire la programmation d'interfaces graphiques en Python 3, Gtk 3 et PyGObject, on tombe nécessairement, souvent, et pendant plusieurs jours, sur des blocages. On ne trouve pas la réponse à certaines questions que l'on se pose, questions souvent très simples, malgré les nombreuses documentations et les bons tutoriaux que l'on trouve sur l'internet. Étant très sensible à la notion d'exemple minimal dans les apprentissages, je donne ici sous cette forme quelques clés qui m'ont permis de passer ces blocages.

Le premier est particulièrement trivial : comment met-on à jour une étiquette (label) dans une interface graphique ?

Dans cet exemple, on affiche l'heure courante dans une étiquette de la fenêtre, et l'étiquette est mise à jour toutes les secondes : il s'agit donc d'une horloge numérique.

#!/usr/bin/python

"""
Exemple minimal PyGObject : mise-à-jour d'une étiquette
jpsb
3 août 2024
"""

# ----------------------------------------------------
import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk, GLib
import time

# ----------------------------------------------------
class Example(Gtk.Window):

    # ----------------------------------------------------
    def __init__(self):

        super().__init__(title="Une étiquette")

        self.set_size_request (200, 200);

        self.label = Gtk.Label()

        self.add(self.label)

        self.update()

    # ----------------------------------------------------
    def update(self):

        self.label.set_text(time.strftime("%H:%M:%S"))

        GLib.timeout_add_seconds(1, self.update)

# ----------------------------------------------------
win = Example()
win.connect("destroy", Gtk.main_quit)
win.show_all()

Gtk.main()

Sans rien connaître à la programmation-objet il y a encore trois semaines, chacune des parties des exemples lus était compréhensible, mais le tout l'était moins. Quel était donc le rôle de ces self. qui précédaient la plupart des commandes et des variables ? Ils indiquaient bien sûr leur appartenance à la classe de la fenêtre Example. Mais pourquoi ne passait-on pas d'argument à la fonction self.update() et pourquoi celle-ci ne renvoyait-elle pas la nouvelle valeur de l'étiquette avec un return ? J'ai fini par comprendre que le self. permet de partager toutes les informations de la classe avec toutes ses méthodes. C'est donc ces self. qui permettent de mettre à jour l'étiquette self.label.

La deuxième chose incompréhensible pour moi était pourquoi la commande GLib.timeout_add_seconds(1, self.update), qui permet de relancer la mise-à-jour toutes les secondes, ne pose pas de problème de limites de récursivité. J'ai compris qu'il ne s'agissait pas d'un appel de la fonction dans elle-même, mais seulement de la mise en attente du prochain appel de la fonction... Et donc qu'il n'y avait aucune récursivité là-dedans.

Deux très bons tutoriaux dont j'ai abondamment réutilisés les exemples :

• Des interfaces graphiques en Python et GTK (Zeste de savoir), en français;
• The Python GTK+ 3 Tutorial, en anglais.