#pygobject

Dans cet article on va comprendre les bases de la création d'une interface utilisateur à l'aide de Glade3 (User interface Designer) et PyGi (PyGObject). Ce tutoriel traitera un exemple simple et basique et se sera centré sur l'appel des méthodes de PyGi et la manière de lier un fichier XML généré par Glade3 et notre code en PyGi. Assez parler! Débutons ... ! Création d'une fenêtre de type Top Level nommée (son id) Window1:

Modifier l'affichage de la fenêtre et la forcer à apparaître au centre de l'écran:

Modifier le titre de la fenêtre:

Modifier les dimensions de la fenêtre par défaut:

Utiliser Grid comme Container (La liste des container est regroupée sur Glade, mais dans cet exemple on va utiliser uniquement Grid avec une dimension 3x3 nommé Grid1): La fenêtre sera divisée comme suit:

Notre Grid sera ajouté automatiquement à l'hiérarchie de Window1 :

Dans Grid1 on ajoute ces Widgets listés dans le champs Control and display de Glade3. On aura une interface similaire à cella:

La liste des éléments et leur types ajoutés à Window1 s'affichent comme suit:

On modifie les propriétés de button1 (bouton ajouté à Windows1). On modifie le nom qui s'affiche sur le bouton et on le renomme  Sortir :

On ajoute un signal (événement) à button1 de type clicked et on lie le signal à la méthode on_button :

On ajoute un signal (événement) à comboboxtext1 de type changed et on lie le signal à la méthode on_comboboxtext :

On ajoute le signal (événement) à checkbutton1 de type toggled et on lie le signal à la méthode on_toggle :

On ajoute le signal (événement) à entry1 de type activate et on lie le signal à la méthode on_entry_activate:

On ajoute le signal (événement) au searchentry1 et de type activate et on lie le signal à la méthode on_entry_activate:

Le logiciel s'affichera comme suit:

Pour le widget checkbutton1 on va le faire manuellement en modifiant le fichier XML généré par Glade. On va ajouter le signal au child switch1 (qui signifie que switch1 est l'enfant de Window1) comme ceci:

Cette ligne se traduit avec PyGi en:

switch1.connect("notify::active", on_switch_activate)

Ceci dit lier switch1 à un signal de type notify::active (notification active) Sans beaucoup étaler le tutoriel, voilà le fichier XML généré par Glade3 et le code source en PyGi avec des commentaires pour comprendre l'utilisation et le fonctionnement de chaque ligne. Code source du fichier XML de Glade3:

        False     Test Glade3 & PyGi (Python3)     center-always     500     250                   True         False                               Sortir             True             True             True             top                                             0             0             1             1                                                 True             True                                                                     1             0             1             1                                                 True             False             on                           NeXus               Nymph               Tristiana               Auroroe               Liturgy                                                         2             0             1             1                                                 checkbutton             True             True             False             0             True                                             0             1             1             1                                                 radiobutton             True             True             False             0             True             True                                 1             1             1             1                                                 True             True             Put your text and press Enter                                             1             2             2             1                                                 True             True             edit-find-symbolic             False             False                                             2             1             1             1                                                        

Code source en PyGi de l'exemple: 

#!/user/bin/python # -*- coding: utf-8 -*- ################################################################### # Exemple mis en ligne par: Chiheb NeXus # Licence : Aucune licence! # Langage de programmation: Python3 et PyGi (PyGtk Version 3) ################################################################### from gi.repository import Gtk class Handler(): """ - Mettre tous les signaux dans une seule classe - NB: Dans PyGi les argements des méthodes sont des widgets intermédiaires qui héritent toutes les caractéristiques des widgets d'origine. Ceci dit, si on essaye de donner une action à un widget de type "button" nommé "button1" dans la partie du code on écrit: def action(self, intermerdiare): intermerdiare hérite toutes les caractéristiques de button1 et l'action sur intermerdiare est une action indirecte sur button1 Ceci est peut être bien expliqué en C/GTK+ vu que PyGi est en quelques sorte un porjet réecrit depuis C/GTK+. - Ps: Lors d'une utilisation avancée de PyGi, les signaux jouent un rôle primordial dans la création de notre Gui. C'est pourquoi une maîtrise de l'utilisation des signaux est fortement récommendée et, aussi, la modification du ficher XML généré par Glade3 est, aussi, récommendée. - Dans cet exemple, notre programme principale n'est pas mis dans une classe à part, vu sa simplicité. Mais, dans un programme avancé, une bonne maîtrise de Python et de PyGi est nécessaire. Glade3 ne permet que réduire le temps de création de Gui et éviter la création de l'interface à la main. Cependant, ceci ne veut pas dire qu'on va oublier les manipulations manuelles pour parvenir aux résultas voulus. - Documentation sur Github: 1- Toutes les méthodes Gtk.methodes (exemple: Gtk.main_quit()) https://lazka.github.io/pgi-docs/#Gtk-3.0/functions.html 2- Les méthodes supportées par Gtk.Button() {Comment interéagir avec les widgets de type Gtk.Button()} https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Button.html#Gtk.Button 3- Les méthodes supportées par Gtk.Entry() {Comment interéagir avec les widgets de type Gtk.Entry()} https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Entry.html#Gtk.Entry 4- Les méthodes supportées par Gtk.Switch() {Comment interéagir avec les widgets de type Gtk.Switch()} https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/Switch.html#Gtk.Switch 5- Les méthodes supportées par Gtk.ComboBoxText() {Comment interéagir avec les widgets de type Gtk.ComboBoxText()} https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/ComboBoxText.html#Gtk.ComboBoxText 6- Les méthodes supportées par Gtk.ToggleButton() {Comment interéagir avec les widgets de type Gtk.ToggleButton()} https://lazka.github.io/pgi-docs/#Gtk-3.0/classes/ToggleButton.html#Gtk.ToggleButton 7- Les méthodes supportées par Gtk.SearchEntry() {Comment interéagir avec les widgets de type Gtk.SearchEntry()} https://lazka.github.io/pgi-docs/#RB-3.0/classes/SearchEntry.html#RB.SearchEntry - Pour plus d'informations: https://lazka.github.io/pgi-docs/ """ def on_button(self, button): """ - Gtk.main_quit(): Est une fonction par défaut de PyGi qui permet de sortir de la boucle infinie de l'interface en Gtk+ en utilisant Python - La méthode utilise le mot "self" et "button" comme arguments - "button" joue le rôle d'un widget intermédiaire entre button1 et cette partie de code """ Gtk.main_quit() def on_switch_activate(self, switch, args): """ - "switch" est un widget intermédiaire entre "switch1" et cette partie de code et args est l'argument passé à la méthode lors de l'appel de widget "switch1" - switch.get_active() : Cette méthode retourne "True" ou "False" => "True" = Le bouton (widget) est actif / "False" = Le bouton (widget) est inactif """ if switch.get_active(): # Bouton actif print("Switch activé!") else: # L'inverse print("Switch désactivé!") def on_comboboxtext(self, combobox): """ - L'ajout des éléments à ComboBoxText est faite sous Glade3 - Cette méthode affichera uniquement les noms stockés dans le fichier XML générée par Glade3 - combobox.get_active_text() : Retourne le text activé de widget ComboBoxText lors de la saisie dans l'interface UI Le type de retour est une chaine de caractaire (String) et l'affiche sera sous la terminale """ # On vérifie si combobox est vide ou non. # S'il est vide, il n'y aura aucun affichage sinon on affiche le contenu if combobox.get_active_text() != None: print("L'élément saisi est: " + combobox.get_active_text()) def on_toggle(self, toggle): """ - Le bouton "toggle1" affiche sur la terminale "Toggle button est activé!" ou "Toggle button est désactivé" - toggle.get_active() : Retourne "True" ou "False" et qui permet de vérifier l'état de widget (activé ou non) - L'affiche est sous la terminale """ if toggle.get_active(): print("Toggle button est activé!") else: print("Toggle button est désactivé") def on_entry_activate(self, entry): """ - Affichage du text saisi dans "entry1" et "seachentry1" - entry est un widget intermédiaire entre "entry1" et "seachentry1" - entry.get_text(): Retourne le text entré dans "entry1" et "seachentry1" - L'affiche sera sur la terminale """ txt = entry.get_text() print(txt) #builder est de type Gtk.Builder() : Notre constructeur du fichier XML de Glade builder = Gtk.Builder() # Ajouter le chemin de fichier d'interface générée par Glade builder.add_from_file("test.glade") # Tous les signaus sont mis dans une classe nommée Handler() builder.connect_signals(Handler()) # window est un objet qui hérite toutes les méthodes de window1 window = builder.get_object("window1") # Affichage de la fenêtre window = Affichage de la fenêtre window1 window.show_all() # Lier la fenêtre principale à un signal de destruction de la fenêtre window.connect("delete-event",Gtk.main_quit) # Lancer la boucle infinie qui permettera de visualiser l'interface indéfiniment sauf s'il y aura une intervention # de l'utilisateur ou du programme interne Gtk.main() 

GenHash est un petit logiciel qui permet de générer des hashs de vos fichier de faibles volumes comme les plus volumineux en utilisant le module hashlib de python 3 et PyGI comme interface utilisateur. GenHash prend une taille de bloc de lecture de fichier égale à 65536 octets. Pour plus d'information, veuillez visiter ce lien sur Wikipédia. **12/12/2014**  **Update** - Support des hashs suivants :

    SHA1

    MD5

    SHA256

    SHA384

    SHA512

    OpenSSL : ripemd160

Dans ce biller on va explorer PyZenity qui est une interface facile de Zenity pour Python. Zenity est normalement appelé à partir d'un script qui l'invoque avec une multitude de paramètres de ligne de commande pour construire ses interfaces GTK+. Ce module cache les détails de l'invocation de la commande et présente les fonctions de l'API simples. Assez de théorie, on va explorer ensemble un exemple qui invoque les interfaces GTK+ prédéfinies de PyZenity. Avant de commencer, veuillez télécharger PyZenity 0.1.4 via ce lien sur Google Drive. Après le téléchargement, vous devez dézipper PyZenity et l'installer comme suit :

sudo python setup.py install

Explication du code :

Question('Appuyez sur un Bouton')

InfoMessage('Vous avez appuyez sur Oui! Valider pour continuer')

List(titre,"Liste",None,True,"ALL",sep='|',data=[("Ananas",20),("Pommes",30)])

GetDate()

GetText("Entrer un mot de passe","",True)

Pour plus d'information, vous pouvez lancer l'interpréteur Python et taper :

help("PyZenity")

Youtube-dl PyGtk Gui est une interface graphique du célèbre youtube-dl, crée avec Python 3.xx en utilisant le module Python PyGtk3 (PyGObject nommé aussi PyGI) et GLib. Beaucoup de mots difficiles ? hein ? Pas de problème. Je vais tout expliquer par la suite . youtube-dl : Est un programme tournant sur presque tous les systèmes d'exploiations (Windows, Mac OS X, Gnu/Linux, Unix, Unix-like, BSD , etc...). Cette portabilité est due au  langage de programmation Python qui s'exécute sur les différents systèmes d'exploitations cités (autres aussi). Python : est un langage de programmation objet, multi-paradigme et multiplateformes. Il favorise la programmation impérative structurée, fonctionnelle et orientée objet. Il est doté d'un typage dynamique fort, d'une gestion automatique de la mémoire par ramasse-miettes et d'un système de gestion d'exceptions ; il est ainsi similaire à Perl, Ruby, Scheme, Smalltalk et Tcl. La dernière version stable de Python est Pyton 3.4.2. (source Wikipédia) PyGtk3 : Est un module Python permettant la création d'interfaces graphiques utilisant la bibliothèque GTK2. Depuis la version GTK3, PyGObject (appelé aussi : PyGI) remplace PyGtk dans ce rôle. PyGObject (PyGI) : Est une liaison entre Python et GLib/GObject/GIO/Gtk+. Ce qui signifie : PyGI est une module Python qui donne accès propre et conforme à l'ensemble de la plateforme de logiciel de GNOME grâce à l'utilisation de l'introspection GObject. GLib : est une bibliothèque libre de manipulation de structures de données - arbres, table de hachage et listes. Elle a commencé en tant qu'élément de GTK+, mais est utilisée maintenant par de nombreuses applications. C'était à l'origine une bibliothèque utilisée comme fourre-tout pour le code bas niveau. Elle s'est désormais étendue pour offrir des fonctionnalités diverses qui sont en plus portables. GLib fait partie du paquet GTK+ du projet GNU. Elle est distribuée selon les termes de la licence GNU LGPL. Ouuuuf !! Des définitions, des définitions et encore des définitions !! N'ayez pas peur. Il faut connaître ces outils pour ne pas se casser la tête en tout créant du point de départ (from scartch). Python et tous ces modules nous facilitent la vie et nous donnent un accès à une multitude de choix pour ne pas compliquer la création des GUI. En effet, je me rappelle de mon professeur d'analyse quand il nous a dit pour ne pas compliquer la résolution de cette équation, on la traite avec les nombres complexes et la résultat sera directe. Notre cas suit la règle de mon professeur : Pour créer une interface graphique basée sur GTK+, faudra bien connaître nos outils de travail et savoir les manipuler. Assez de théorique. Un peu de pratique. Le code source de "Youtube-dl PyGtk Gui" peut être téléchargé soi sur Google Drive ou bien sur Github.

Explication du concept générale du programme :

"Youtube-dl PyGtk Gui" est une interface graphique qui se base sur "youtube-dl" qui pourra être téléchargé et installé via ce lien (lien officiel de youtube-dl). Lors du lancement de "Youtube-dl PyGtk Gui", l'utilisateur doit entrer l'URL de la vidéo youtube qu'il veut télécharger, puis choisir le format souhaité (pour l'instant la GUI supporte les formats MP4 et FLV, les autres formats et fonctionnalités seront ajoutées dans les prochaines versions du programme). L'appui sur le bouton télécharger actionne youtube-dl en lui envoyant l'option du téléchargement d'une vidéo, la format et l'URL. Les informations collectées par notre GUI et affichées sur son TextView (espace de visualisation textuel). L'appui sur le bouton Stopper, annule le téléchargement et stoppe la barre de progression "ProgressBar".

Explication de quelques concepts du code utilisé :

Je dois remercier gianmant du forum  stackoverflow pour l'idée de l’a-synchronisation en utilisant GLib :

GLib.source_remove(self.source_id_out) : Enlever self.source_id_out de la boucle principale. Gtk.events_pending() : Retourne "True" s'il y a un événement en attente dans le programme et "False" dans le cas contraire.

Gtk.main_iteration_do(False) : Ne pas bloquer l'itération du programme

GLib.spawn_async(params,flags=GLib.SpawnFlags.SEARCH_PATH|\ GLib.SpawnFlags.DO_NOT_REAP_CHILD,standard_output=True,standard_error=True) :  La définition générale est : GLib.spawn_async(arguments,flags,child,setup,standard_output,standard_error) GLib.spawn_async appelle la fonction GLib.spawn_async_with_pipes sans les pipes, Donc : GLib.spawn_async = Exécute un programme enfant (child)de manière asynchrone. Ce qui signifie que le programme ne sera pas bloqué en attendant l'enfant (processus enfant) pour quitter.

io = GLib.IOChannel(stdout) : Création d'une variable qui stock les informations du socket de retour

err = GLib.IOChannel(stderr) : Création d'une variable qui stock les informations du socket d'erreur

self.source_id_out = io.add_watch(GLib.IO_IN|GLib.IO_HUP, write_to_textview,self.tw_out,priority=GLib.PRIORITY_HIGH) : La définition générale est : def glib.io_add_watch(file id, condition, callback, addional arguments ...)                               File ID : GLib.IO_IN = Date to read / GLib.IO_HUP = Hang UP / GLib.IO_ERR =  Condition d'erreur / GLib.IO_out = Données peuvent être écrites / Glib.IO_PRI = Données urgentes pour la lecture . add_watch : contrôle le file id par la condition ajoutée et si la condition est vraie, callback sera exécuté

GLib.spawn_close_pid(pid)  : Faut fermer GLib.spawn_asyn avec GLib.spawn_close_pid()

Mise à jour : 

18/10/2014 Fixed - Support des formats suivants :

WEBM [Audio Basse Qualité]

M4A [Audio]

MP4 [Vidéo 144p]

WEBM [Vidéo 240p]

MP4 [Vidéo 240p]

WEBM [Vidéo 360p]

MP4 [Vidéo 360p]

WEBM [Vidéo 480p]

MP4 [Vidéo 480p]

WEBM [Vidéo 720p]

MP4 [Vidéo 720p]

WEBM [Vidéo 1080p]

MP4 [Vidéo 1080p]

3GP [Vidéo 176x144]

3GP [Vidéo 320x240]

FLV [Vidéo 400x240]

WEBM [Vidéo 640x360]

MP4 [Vidéo 640x360]

MP4 [Vidéo 1280x720 Meilleure Qualité]

Une seule zone d'affichage du traitement lors du téléchargement

Ajout de deux fenêtres de dialogues en cas de mauvaise manipulation du logiciel

Ajout de la repository GitHub

09/11/2014 Update :

Optimisation du code source

Fenêtre de taille fixe

VBox homogène

Traduction de la Gui en anglais

11/11/2014 Update :