Gestionnaire d’Environnements Python (VENV) pour Geany et XFCE

Introduction

Le développement Python moderne repose fortement sur l’utilisation des environnements virtuels (venv) pour isoler les dépendances de chaque projet. Cependant, le processus de création, d’activation en terminal, et d’ouverture de l’éditeur de code (comme Geany) peut devenir répétitif.

Cet article présente une solution pour les utilisateurs Linux (notamment sous l’environnement de bureau XFCE) : une petite application en Python/Tkinter qui automatise la gestion des venv et intègre parfaitement l’éditeur Geany et le terminal xfce4-terminal en un seul clic.

---

🎯 Problématique et Objectifs

La Problématique Manuelle

Habituellement, pour démarrer un nouveau projet ou reprendre un ancien, le développeur doit effectuer plusieurs étapes manuelles (ouvrir le terminal, naviguer, activer l’environnement, lancer l’éditeur).

L’Objectif de l’Application guienv.py

L’application guienv.py résout cette séquence fastidieuse en un clic, garantissant que :

• Création Automatisée : Un environnement virtuel Python est créé dans un emplacement centralisé.
• Configuration Geany Immersive : Un fichier de configuration Geany (<nom_env>.geany) est généré avec les clés [project], name et base_path corrects.
• Lancement Synchronisé : Lancement simultané du terminal et de Geany, suivi de la fermeture automatique de l’interface graphique.
• Terminal Prêt à l’Emploi : Le terminal s’ouvre dans le répertoire du projet avec l’environnement venv déjà activé.

---

🐍 Le Code Source de guienv.py

Le script utilise la librairie standard Tkinter pour l’interface graphique et le module subprocess pour exécuter les commandes système.

Note : Ce code doit être sauvegardé dans le fichier guienv.py.

Python

import tkinter as tk from tkinter import messagebox, simpledialog import os import subprocess import sys import tempfile # — Configuration Globale — # Le répertoire racine où tous les environnements seront stockés ENV_ROOT_DIR = os.path.join(os.path.expanduser("~"), "env_python") # Commande pour le terminal et l'éditeur de code TERMINAL_COMMAND = "xfce4-terminal" GEANY_COMMAND = "geany" # —————————- class PythonEnvManagerApp: def __init__(self, master): self.master = master master.title("🐍 Gestionnaire d'Environnements Python") self._setup_env_root() self._create_widgets() self.load_environments() def _setup_env_root(self): if not os.path.exists(ENV_ROOT_DIR): try: os.makedirs(ENV_ROOT_DIR) except OSError as e: messagebox.showerror("Erreur Système", f"Impossible de créer le répertoire {ENV_ROOT_DIR}. Erreur : {e}") sys.exit(1) def _create_widgets(self): list_frame = tk.LabelFrame(self.master, text="Environnements Disponibles", padx=10, pady=10) list_frame.pack(padx=10, pady=5, fill="x") self.env_listbox = tk.Listbox(list_frame, height=10, width=50) self.env_listbox.pack(side="left", fill="both", expand=True) scrollbar = tk.Scrollbar(list_frame, orient="vertical", command=self.env_listbox.yview) scrollbar.pack(side="right", fill="y") self.env_listbox.config(yscrollcommand=scrollbar.set) button_frame = tk.Frame(self.master, padx=10, pady=5) button_frame.pack(pady=10) create_btn = tk.Button(button_frame, text="✨ Créer un Environnement", command=self.create_environment, width=25, bg='#4CAF50', fg='white') create_btn.pack(side="left", padx=10) open_btn = tk.Button(button_frame, text="▶️ Ouvrir l'Environnement", command=self.open_environment, width=25, bg='#2196F3', fg='white') open_btn.pack(side="right", padx=10) refresh_btn = tk.Button(self.master, text="🔄 Rafraîchir la Liste", command=self.load_environments) refresh_btn.pack(pady=5) def load_environments(self): self.env_listbox.delete(0, tk.END) try: environments = [d for d in os.listdir(ENV_ROOT_DIR) if os.path.isdir(os.path.join(ENV_ROOT_DIR, d))] for env in sorted(environments): self.env_listbox.insert(tk.END, env) if not environments: self.env_listbox.insert(tk.END, "(Aucun environnement trouvé)") except Exception as e: messagebox.showerror("Erreur de Lecture", f"Impossible de lire le contenu de {ENV_ROOT_DIR}. Erreur : {e}") def create_environment(self): env_name = simpledialog.askstring("Nouveau Environnement", "Entrez un nom pour le nouvel environnement Python :", parent=self.master) if not env_name: return env_path = os.path.join(ENV_ROOT_DIR, env_name) if os.path.exists(env_path): messagebox.showerror("Erreur", f"Le répertoire '{env_name}' existe déjà.") return try: messagebox.showinfo("Création…", f"Création de l'environnement '{env_name}' en cours. Cela peut prendre quelques instants…") # 1. Création de l'environnement virtuel (venv) subprocess.run([sys.executable, "-m", "venv", env_path], check=True, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) # 2. Création du fichier de configuration Geany (.geany) avec la section [project] geany_config_file = os.path.join(env_path, f"{env_name}.geany") # Contenu basé sur le format Geany idéal config_content = ( "[editor]\nline_wrapping=false\nline_break_column=72\nauto_continue_multiline=true\n\n[files]\ncurrent_page=0\nFILE_NAME_0=0;None;0;EUTF-8;0;1;0;None;0;4\n\n[file_prefs]\nfinal_new_line=true\nensure_convert_new_lines=false\nstrip_trailing_spaces=false\nreplace_tabs=false\n\n[indentation]\nindent_width=4\nindent_type=0\nindent_hard_tab_width=8\ndetect_indent=false\ndetect_indent_width=false\nindent_mode=2\n\n[project]\n" f"name={env_name}\n" f"base_path={env_path}\n" "description=\n\n[long line marker]\nlong_line_behaviour=1\nlong_line_column=72\n\n[VTE]\n" f"last_dir={env_path}\n" ) with open(geany_config_file, 'w') as f: f.write(config_content) messagebox.showinfo("Succès", f"L'environnement '{env_name}' a été créé avec succès dans {env_path}.") self.load_environments() except subprocess.CalledProcessError as e: messagebox.showerror("Erreur Venv", f"Erreur lors de la création de l'environnement virtuel : {e}") except Exception as e: messagebox.showerror("Erreur", f"Une erreur inattendue est survenue : {e}") def open_environment(self): try: selected_index = self.env_listbox.curselection() if not selected_index: messagebox.showwarning("Sélection", "Veuillez sélectionner un environnement à ouvrir.") return env_name = self.env_listbox.get(selected_index[0]) env_path = os.path.join(ENV_ROOT_DIR, env_name) activate_script_path = os.path.join(env_path, "bin", "activate") geany_config_file = os.path.join(env_path, f"{env_name}.geany") if not os.path.exists(activate_script_path): messagebox.showerror("Erreur d'Activation", "Le script d'activation est introuvable.") return # 1. Création du contenu du script shell temporaire script_content = ( f'#!/bin/bash\n' f'source "{activate_script_path}"\n' f'{GEANY_COMMAND} "{geany_config_file}" &\n' f'exec $SHELL' ) # 2. Écriture et permissions du fichier temporaire with tempfile.NamedTemporaryFile(mode='w', delete=False, suffix='.sh') as tmp: tmp.write(script_content) temp_script_path = tmp.name os.chmod(temp_script_path, 0o755) # 3. Commande finale pour xfce4-terminal terminal_cmd = [ TERMINAL_COMMAND, "–title", f"VENV: {env_name}", "–working-directory", env_path, "-e", temp_script_path ] # 4. Lancement du processus (asynchrone) subprocess.Popen(terminal_cmd) # 5. Fermeture de l'application Tkinter self.master.destroy() except Exception as e: messagebox.showerror("Erreur d'Ouverture", f"Une erreur est survenue lors de l'ouverture : {e}") if __name__ == "__main__": root = tk.Tk() app = PythonEnvManagerApp(root) root.mainloop()

---

🛠️ Installation et Configuration

Pour mettre en place cette solution, suivre ces étapes :

1. Prérequis et Placement du Script

1. Assurez-vous d’avoir Python 3, Geany et xfce4-terminal installés.
2. Placez le code Python ci-dessus dans un fichier nommé guienv.py dans un répertoire permanent, par exemple : ~/scripts/

2. Création du Lanceur (.desktop)

Créez un fichier nommé gestion_env_python.desktop avec le contenu suivant (ajustez le chemin Exec= si votre nom d’utilisateur n’est pas teclast ou si le chemin du script est différent) :

3. Installation des Raccourcis

Installez le lanceur aux emplacements souhaités :

A. Raccourci sur le Bureau

Rendez le fichier .desktop exécutable et copier le:

B. Intégration au Menu “Développement”

Copiez le fichier dans le répertoire standard des applications de l’utilisateur :

L’entrée apparaîtra dans la catégorie Développement de votre menu système grâce à la clé Categories=Development;Utility;.

---

🚀 Guide d’Utilisation

1. Lancez l’Application : Cliquez sur le raccourci ou accèder par le menu système.
2. Créer un Environnement : Cliquez sur “Créer un Environnement” et donnez un nom.
3. Ouvrir l’Environnement : Sélectionnez l’environnement créé dans la liste et cliquez sur “Ouvrir l’Environnement”.
4. Résultat : Le GUI se ferme, Geany s’ouvre sur le projet, et un terminal xfce4-terminal s’ouvre dans le répertoire du projet, avec l’environnement virtuel activé (vérifiable avec la commande pip list).

---

Conclusion

L’outil guienv.py automatise efficacement le processus de mise en place de l’environnement de développement Python sous Linux, garantissant un démarrage rapide et conforme aux bonnes pratiques d’isolation des dépendances.