Descriptif

À quoi sert ToolBox Manager V1.0.1 ? Voilà la question existantentielle du moment. Ce "Plugin" sert à centraliser les codes utilitaires généraux qui sont utilisés régulièrement de le code source de plusieurs projets.


Si une fonction ou groupe de fonctions (Exemple Vector3.pb) est/sont utilisée(s) dans le code source de 10 programmes différents. Bien souvent le réflexe est de placer le code de ses fonctions dans un fichier séparé puis de copier ce dernier dans le répertoire de chacun des projets. Ce qui rend leurs mises à jour particulièrement pénible. En effet, à chacune des mises à jour, il faut recopier le nouveau source 10 fois, un pour chacun programme qui l'utilise.


L'autre solution est bien entendu de créer une librairie à l'aide de TailBite ou encore de Moebius. Ce qui n'est pas sans poser des problèmes lorsque le code source de ces libraires sont également en développement. À chacune des mises à jour, il bien souvent reconstruire les fichiers résidents, recompiler les librairies et résoudre les problèmes éventuels sans oublier que bien souvent le est à faire sur la plateforme Windows, la plateforme Linux et la plateforme MacOS. Ce qui augmente la charge de travail pour finalement avoir aucun gain tangible en bout de ligne.


La solution apportée par ToolBox Manager est simple. Elle consiste à centraliser dans un répertoire tout les codes qui sont réutilisés dans plusieurs programmes et de les rendre accessibles autant pour le compilateur que pour le programmeur tout en évitant de copier plusieurs fois le même code source. À la limite, le répertoire ToolBox pourrait se trouver sur un disque réseau partagé et donc accessible pour plusieurs programmeurs en même temps.


Il est possible de faire la même chose sans même utiliser ToolBox Manager. Cependant, ce dernier permet d'alléger l'écriture effectuant une partie du travail en arrière plan.

En temps normal, pour inclure un /des fichier(s) source(s) externe(s) dans le code source principal d'un programme il faut faire :

IncludeFile "/home/guimauve/codes purebasic/librairies/maths/vector/vector2.pb"
IncludeFile "/home/guimauve/codes purebasic/librairies/maths/vector/vector3.pb"
IncludeFile "/home/guimauve/codes purebasic/librairies/maths/vector/vector4.pb"

Il n'y a que 3 fichiers d'inclus et c'est déjà pénible alors imaginez s'il y en a 20, 30, 40 ou même plus ! ToolBox Manager permet simplifier ces trois lignes en une seule :

ToolBoxFile "vector2.pb", "vector3.pb", "vector4.pb"

Comme on peut le voir, c'est bien plus léger ! De plus, il est possible de mettre plusieurs noms sur une même ligne, il n'y a aucune limite cependant il faut comprendre que ToolBox Manager effectue l'ouverture, à la demande, de tout les codes se trouvant après le mot clé ToolBoxFile. Dans l'exemple ci-dessus, l'ouverture dans l'éditeur des fichiers "vector2.pb", "vector3.pb" et "vector4.pb" sera effectuées et ce même si seulement le fichier "vector3.pb" doit être consulté.


Compilation et Installation

Pour installer ToolBox Manager, il est recommandé de l'installer dans un sous-répertoire nommé "plugins/toolbox_manager/" dans le répertoire où PureBasic est installé. De plus, ToolBox Manager est distribué avec son code source qui pourra être compilé pour créer l'exécutable.


Configuration

Une fois installé, il suffit simplement de le configurer dans le menu "Outils", sous-menu "Outils personnalisés...".



Configuration du mode Préférences

  • Ligne de commande : Sélectionner le programme "toolbox_manager" dans le répertoire où est installé.
  • Arguments : "PREFS" (l'argument doit être entre guillemets)
  • Répertoire de travail : Sélectionner le répertoire où le programme "toolbox_manager" est installé.
  • Nom : ToolBox Manager (Mode Preferences)


Le mode Préférences permet de sélectionner le/les répertoire(s) principal(aux) pour les ToolBox et de les activer/désactiver selon les besoins.

Notes Importantes !

Un répertoire sélectionné sera parcouru de manière récusive en incluant tout les sous-répertoires qu'il contient.


Configuration du mode Compilation

  • Ligne de commande : Sélectionner le programme "toolbox_manager" dans le répertoire où il est installé.
  • Arguments : "COMPILE" "%COMPILEFILE" (chaque arguments doit être entre guillemets)
  • Répertoire de travail : Sélectionner le répertoire où le programme "toolbox_manager" est installé.
  • Nom : ToolBox Manager (Mode Compilation)
  • Événement pour déclencher l'outil : Avant Compiler/exécuter
  • Cocher : Attendre la fin du programme
  • Cocher : Cacher l'outil du menu principal



Configuration du mode Création d'exécutable

  • Ligne de commande : Sélectionner le programme "toolbox_manager" dans le répertoire où il est installé.
  • Arguments : "COMPILE" "%COMPILEFILE" (chaque arguments doit être entre guillemets)
  • Répertoire de travail : Sélectionner le répertoire où le programme "toolbox_manager" est installé.
  • Nom : ToolBox Manager (Mode Création d'exécutable)
  • Événement pour déclencher l'outil : Avant de créer un exécutable
  • Cocher : Attendre la fin du programme
  • Cocher : Cacher l'outil du menu principal



Configuration du mode Chargement

  • Ligne de commande : Sélectionner le programme "toolbox_manager" dans le répertoire où est installé.
  • Arguments : "LOAD" "%FILE" "%CURSOR" (chaque arguments doit être entre guillemets)
  • Répertoire de travail : Sélectionner le répertoire où le programme "toolbox_manager" est installé.
  • Nom : ToolBox Manager (Mode Chargement)
  • Événement pour déclencher l'outil : Menu ou raccourci
  • Raccourci : Maj + F11


Le mode Chargement permet d'ouvrir le/les codes sources de la ToolBox dans l'éditeur. Pour que cette commande fonctionne, il faut que le curseur se trouve sur ligne de code débutant par le mot-clef ToolBoxFile.

Notes Importantes !

Pour que le mot-clef ToolBoxFile apparaîsse comme les autres mots-clefs, il faut l'ajouter dans les mots-clefs utilisateur.



Configuration du mode Ouverture

  • Ligne de commande : Sélectionner le programme "toolbox_manager" dans le répertoire où est installé.
  • Arguments : "OPEN" (l'argument doit être entre guillemets)
  • Répertoire de travail : Sélectionner le répertoire où le programme "toolbox_manager" est installé.
  • Nom : ToolBox Manager (Mode Ouverture)
  • Événement pour déclencher l'outil : Menu ou raccourci
  • Raccourci : Maj + F10


Le mode Ouverture permet d'ouvrir le/les codes sources de la ToolBox dans l'éditeur. La sélection est faite à partir de la fenêtre de sélection de fichiers contrairement au mode Chargement qui lui s'effectue sur les fichiers désignés par le mot clef ToolBoxFile.


Configuration du mode Insertion

  • Ligne de commande : Sélectionner le programme "toolbox_manager" dans le répertoire où il est installé.
  • Arguments : "INSERT" "%FILE" "%CURSOR" (chaque arguments doit être entre guillemets)
  • Répertoire de travail : Sélectionner le répertoire où le programme "toolbox_manager" est installé.
  • Nom : ToolBox Manager (Mode Insertion)
  • Événement pour déclencher l'outil : Menu ou raccourci
  • Raccourci : Maj + F9
  • Cocher : Attendre la fin du programme
  • Cocher : Recharger le code source à la fin du programme
  • Option : Onglet courant


Le mode Insertion permet de sélectionner les fichiers désirés et de les ajouter dans le code en cours d'édition là où se trouve le curseur. Si la ligne où se trouve le curseur débute par le mot-clef ToolBoxFile alors le nom des fichiers sera ajouté après ceux déjà présent. Si la ligne est vide alors le mot-clef ToolBoxFile suivit du nom des fichiers sélectionnés sera ajouté. Si la ligne contient quelque chose d'autre cette dernière sera coupé en deux à la position du curseur et le mot-clef ToolBoxFile suivit du nom des fichiers sélectionnés sera ajouté entre les deux parties.