Présentation

Projet

Ce projet est une application de minuteur ne nécessitant pas de connexion Internet, qui a débuté le 9 février 2024 pour les professeurs du collège. Je place le code et tout élément associé au projet sur GitHub, à ce lien : https://github.com/pandaroux007/GoTime

Tip

Pour tout signalement de bug ou proposition de nouvelle.s fonctionnalitée.s, merci de créer une issue.

Licence

Ce projet est sous licence BSL 1.0 (Boost Software License 1.0). J'autorise quiconque à utiliser, modifier et commercialiser le code, tant que l'auteur Pandaroux007 est mentionné.

Crédits

1. Merci à ma professeur d'anglais, qui a lancer l'idée et qui m'a fait confiance pour réaliser ce projet;
2. Merci à Lounys pour son aide sur le bug du bouton 'copier le lien' dans Source;
3. Merci à Techvij/Solme pour son soutien pendant les longues phases de correction de bugs;
4. Merci à Roucoule/PandaR09 pour son aide au début de mon apprentissage de tkinter;
5. Merci à PetitOurs pour ses conseils sur l'ergonomie et pour le module py vers exe;
6. Merci au développeur de ce programme qui m'a permis de découvrir comment faire en sorte que quand on clique hors d'une entrée cela lui retire le focus, mais que pour les boutons cela ne fasse rien (pas de contours noir du focus quand on clique dessus)
7. Merci à tous les développeurs des modules utilisés dans ce projet pour leurs travaux et leurs contributions à la communauté open-source;
8. Enfin, merci à tous les créateurs de contenus techniques sur internet qui m'ont permis de trouver de la documentation pour chaque éléments des modules.

Apparence globale

Interface

Barre de Menu

Au niveau de la barre de menu, trois onglets :

• Fenêtre -> Propose des options pour l'interface et l'application;
  • Paramètres -> Ouvre la fenêtre des paramètres.
  • Redémarrer -> Redémarre l'application.
  • Quitter -> Ferme l'application.
• Commandes -> Permet d'effectuer des actions;
  • Effacer les entrées -> Efface le temps actuellement entré dans les sélecteurs.
  • Déporter minuteur -> Affiche le temps restant dans une nouvelle fenêtre.
• Source -> Donne des informations sur l'application;
  • Ouvrir GitHub -> Ouvre directement le dépôt GitHub dans le navigateur.
  • Afficher GitHub -> Ouvre une fenêtre affichant le lien vers le dépôt GitHub, avec un bouton permettant de le copier.
  • Afficher LICENCE -> Affiche une fenêtre avec la licence du projet (voir le chapitre LICENCE)

Fenêtre

Sur la fenêtre principale, est disponible, dans l'ordre :

• L'heure, en grand, en haut (possibilité de ne plus l'afficher dans les paramètres)
• Un rectangle coloré contenant le nom de l'application, puis le temps restant pendant le décompte.
• Trois boutons (LANCER, PAUSE, ARRÊTER).
• Un bouton pour déporter le temps restant dans une nouvelle fenêtre.
• Deux entrées (minutes/secondes) et un bouton pour les effacer rapidement. L'application peut être agrandie et mise en plein écran.

Détails sur la déportation du temps restant : Comme indiqué plus haut, sur la fenêtre se trouve un bouton permettant de "déporter le temps restant". Concrètement cela signifie ouvrir une nouvelle fenêtre avec afficher seulement le temps restant, sur un fond de couleur. Cette fenêtre à l'avantage d'être beaucoup plus visible que l'affichage de l'application, mais aussi le fait qu'elle reste toujours au premier plan (même si vous cliquez à côté, elle restera apparente).

Améliorations et Ajouts

Maintenant qu'il n'y a plus de bugs dans le code python d'après les tests fait récemment, voici une petite liste non exhaustive des futurs améliorations.

• Premièrement, utilisation du module ttkbootstrap pour rendre plus modernes les widgets de l'application, le module complémentaire ttk n'étant pas adapté, trop complexe à implémenter, et l'utilisation d'un autre module de GUI comme CustomTkinter manquant de choix de widget. Si vous souhaitez voir à quoi ressemble ttkbootstrap, installez-le avec la commande pip install ttkbootstrap puis effectuez la commande python3 -m ttkbootstrap.

• Ajout d'un système permettant à l'utilisateur d'enregistrer des temps (par exemple ceux qu'il utilise régulièrement), en plus du système initial avec les entrées/spinbox. Cela consisterai en un menu déroulant de type combobox, qui ne s'afficherai que si au moins un temps est déjà enregistré, sinon un bouton pour créer un nouveau temps prédéfini. Si un ou plusieurs temps a déjà été enregistré, le sélecteur s'affiche, à côté un bouton pour lancer le temps prédéfini sur le minuteur et un autre permettant d'ajouter un nouveau temps à la liste. Cette amélioration sera l'objectif de la V2.

• Ajout d'un système d'extension à l'application, comme un générateur de mots de passe sécurisé, un chronomètre, ou un générateur de plan de classe aléatoire, par exemple. Les extensions seraient stockées sur un GitHub séparé de celui de l'application, et celle-ci viendrai télécharger et intégrer celle que l'utilisateur souhaitera dans un onglets spécifique des paramètres. Cette amélioration sera l'objectif de la V3.

• Choix de la sonnerie. Dans les versions à venir de l'application, il sera possible de choisir la sonnerie via un sélecteur dans les paramètres, de type combobox. Ce sélecteur sera géré dynamiquement via la variable tkinter du checkbutton permettant d'activer la sonnerie. Concrètement, si la sonnerie est désactivé alors le sélecteur sera grisé, inutilisable.

Bug compilation

Aujourd'hui je ne peux pas créer de version binaire du projet pour le distribuer car il y a un bug dans les chemins de fichiers. Quand je compile, et ce sur nuitka, auto-py-to-exe, ou un autre, que ce soit en mode onefile ou en standalone, et que j'exécute le binaire au bon endroit dans l'arborescence (au même endroit que les fichiers python du code source), il ne trouve pas le fichier de paramètre sans lequel l'application ne peut pas démarrer. Si quelqu'un tombe sur le projet et est tenté de trouver la solution maintenant, les chemins de fichiers sont créés et modifiés dans le fichier variables.py avec le module os. Pour voir le bug, voici la commande utilisée pour compiler en binaire le code avec nuitka (chemins à adapter):

python3 -m nuitka --run --onefile --output-filename="GoTime" --disable-console --follow-imports --linux-icon="dep/icon.ico" --macos-app-icon="dep/icon.ico" --windows-icon-from-ico="dep/icon.ico" runApp.py

Il est probable que la méthode utilisée pour les chemins et la manipulations des fichiers ainsi que l'arborescence ne soit pas bonne. Si c'est le cas, vous pouvez créer une issue GitHub pour présenter votre façon de corriger le problème.

Développement

Installation

Attention, certains des modules utilisés par le projet ne sont pas inclus par défauts dans python. Pour les installer, il vous suffit de lancer la commande suivante (après vous être déplacé dans le répertoire du projet téléchargé - commande 'cd path' sous Windows et Unix):

pip install -r requirements.txt

Cette commande installera tous les modules listés dans le fichier requirements.txt, utilisés par les programmes Python de l'application.

Fonctionnement

GoTime fonctionne avec la fonction after de tkinter. L'affichage de l'heure fonctionne de cette manière et le minuteur également. Cette méthode permet d'appeller une fonction un certain temps plus tard, temps défini en ms. Pour modifier chaque seconde l'heure, par exemple, on utilise cette commande (l.130)

self.after(1000, self.update_time)  # Met à jour toutes les secondes

Cela crée une boucle qui met à jour l'heure toutes les 1000ms, soit 1s. C'est le même principe qui est utilisé pour le rafraichissement du minuteur Tout le reste de l'application n'est qu'une question d'apparence et de widgets, la base fonctionne comme ceci.