Implémentation cadMasterCLI v2.0.0 :

- Interface bilingue FR/EN
- Auto-mise à jour
- Fenêtre unique avec logs intégrés
- liste par badges
- README bilingue
This commit is contained in:
2026-07-04 03:33:47 +02:00
parent 4ff757fd06
commit f9ef170872
4 changed files with 1240 additions and 629 deletions
+44 -22
View File
@@ -19,12 +19,14 @@ cadMasterCLI est une interface graphique qui vous permet de **lancer des scripts
Il suffit de : Il suffit de :
1. Faire un clique-droit sur le fichier cadMasterCLI.ps1 et choisir "Exécuter avec Powershell" 1. Faire un clique-droit sur le fichier cadMasterCLI.ps1 et choisir "Exécuter avec Powershell"
2. Sélectionner le script que vous souhaitez exécuter 2. Sélectionner le script que vous souhaitez exécuter dans la liste à gauche
3. Remplir les informations demandées (adresse IP, fichier CSV, etc.) 3. Remplir les informations demandées (adresse IP, fichier CSV, etc.)
4. Cliquer sur **Lancer le script** 4. Cliquer sur **Lancer le script** et suivre le résultat dans le journal d'exécution intégré
Les scripts sont téléchargés automatiquement depuis un serveur centralisé (Gitea). Si vous n'avez pas accès au réseau, les scripts déjà utilisés restent disponibles en mode hors ligne. Les scripts sont téléchargés automatiquement depuis un serveur centralisé (Gitea). Si vous n'avez pas accès au réseau, les scripts déjà utilisés restent disponibles en mode hors ligne.
L'interface est disponible en **français et en anglais**, et cadMasterCLI **vérifie et propose ses propres mises à jour** au démarrage.
--- ---
## Prérequis ## Prérequis
@@ -94,28 +96,31 @@ Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
## Utilisation ## Utilisation
### 1. Sélectionner un script cadMasterCLI tient dans **une seule fenêtre** : la liste des scripts à gauche, et un panneau à droite qui affiche la documentation, le formulaire et le journal d'exécution du script sélectionné.
Au démarrage, une fenêtre de sélection s'affiche avec la liste des scripts disponibles. ### 1. Choisir la langue de l'interface
| Colonne | Signification | Un bouton **FR / EN** en haut à droite de la fenêtre permet de basculer l'interface entre français et anglais à tout moment. Au premier lancement, la langue de Windows est détectée automatiquement ; votre choix est ensuite mémorisé pour les prochaines fois.
### 2. Sélectionner un script
La liste à gauche affiche en permanence tous les scripts disponibles, avec pour chacun :
| Élément | Signification |
|---|---| |---|---|
| Nom | Nom du script | | Nom | Nom du script |
| Description | Ce que fait le script | | Date | Date de la dernière mise à jour sur le serveur |
| Mis à jour | Date de la dernière mise à jour | | Badge vert **En cache** | Le script a déjà été téléchargé sur cet ordinateur |
| Cache local | Indique si le script a déjà été téléchargé | | Badge orange **Nouveau** | Une mise à jour est disponible pour ce script |
| MAJ dispo | `[NOUVEAU]` si une mise à jour est disponible |
Double-cliquez sur le script souhaité, ou sélectionnez-le et cliquez sur **OK**. Cliquez sur un script pour afficher sa documentation et son formulaire de paramètres dans le panneau de droite.
> Pour fermer sans rien exécuter, fermez simplement la fenêtre. ### 3. Remplir les paramètres
### 2. Remplir les paramètres Le panneau de droite affiche :
Une fenêtre s'ouvre avec :
- **À gauche** : la documentation du script (README), pour comprendre à quoi il sert et comment le remplir. - **À gauche** : la documentation du script (README), pour comprendre à quoi il sert et comment le remplir.
- **À droite** : le formulaire de paramètres à remplir. - **À droite** : le formulaire de paramètres à remplir, ainsi que le journal d'exécution en dessous.
**Types de champs :** **Types de champs :**
@@ -134,27 +139,40 @@ Cliquez sur **[?] Voir l'aide** sous un champ pour afficher une description dét
- Cliquez sur **Fermer README** pour masquer la documentation et agrandir le formulaire. - Cliquez sur **Fermer README** pour masquer la documentation et agrandir le formulaire.
- Cliquez sur **Ouvrir README** pour la réafficher. - Cliquez sur **Ouvrir README** pour la réafficher.
- Vous pouvez redimensionner le panneau README en faisant glisser la barre de séparation entre les deux zones. - Vous pouvez redimensionner le panneau README en faisant glisser la barre de séparation entre les deux zones.
- Si le README du script propose une version française et anglaise, la section affichée suit automatiquement la langue choisie dans l'interface.
### 3. Lancer le script ### 4. Lancer le script et suivre l'exécution
Une fois tous les champs obligatoires remplis : Une fois tous les champs obligatoires remplis :
- Cliquez sur **Lancer le script** (bouton vert). - Cliquez sur **Lancer le script** (bouton vert).
- Le script s'exécute dans le terminal. Attendez la fin de l'exécution. - Le script s'exécute en arrière-plan ; sa sortie s'affiche **en direct dans le journal d'exécution**, directement dans la fenêtre (plus de fenêtre de terminal séparée).
- Appuyez sur **Entrée** pour fermer. - Pendant l'exécution, la liste des scripts et les boutons sont désactivés ; ils redeviennent disponibles à la fin.
- Un message final indique si l'exécution s'est terminée avec succès ou en erreur.
> Cliquez sur **Annuler** pour revenir à la liste des scripts sans rien exécuter. Cliquez sur **Retour à la liste** pour revenir à la liste des scripts et en sélectionner un autre.
--- ---
## Mise à jour automatique des scripts ## Mise à jour automatique des scripts
Lorsqu'une nouvelle version d'un script est disponible sur le serveur, cadMasterCLI vous le signale avec `[NOUVEAU]` dans la liste et vous propose de télécharger la mise à jour. Lorsqu'une nouvelle version d'un script est disponible sur le serveur, cadMasterCLI le signale avec un badge **Nouveau** dans la liste et vous propose de télécharger la mise à jour au moment où vous sélectionnez ce script.
Les scripts sont stockés localement dans le sous-dossier `scripts\` à côté de `cadMasterCLI.ps1`. Les scripts sont stockés localement dans le sous-dossier `scripts\` à côté de `cadMasterCLI.ps1`.
--- ---
## Mise à jour automatique de cadMasterCLI lui-même
À chaque démarrage, cadMasterCLI vérifie s'il existe une version plus récente de lui-même sur le serveur.
- Si c'est le cas, une fenêtre vous propose de l'installer.
- En acceptant, la nouvelle version est téléchargée, remplace automatiquement le fichier `cadMasterCLI.ps1` actuel, et l'application redémarre toute seule.
- En refusant, l'application continue de démarrer normalement avec la version actuelle (la question sera reposée au prochain lancement).
- Si le serveur est inaccessible, aucune vérification n'est possible : cadMasterCLI démarre normalement, sans message d'erreur.
---
## Mode hors ligne ## Mode hors ligne
Si le serveur Gitea est inaccessible (pas de réseau), cadMasterCLI utilise automatiquement les scripts déjà téléchargés. Un message vous prévient que vous êtes en mode hors ligne. Si le serveur Gitea est inaccessible (pas de réseau), cadMasterCLI utilise automatiquement les scripts déjà téléchargés. Un message vous prévient que vous êtes en mode hors ligne.
@@ -177,9 +195,13 @@ Si le serveur Gitea est inaccessible (pas de réseau), cadMasterCLI utilise auto
``` ```
cadMasterCLI/ cadMasterCLI/
├── cadMasterCLI.ps1 ← fichier principal à lancer ├── cadMasterCLI.ps1 ← fichier principal à lancer
├── version.txt ← version de référence pour l'auto-mise à jour
├── cadmastercli.config.json ← préférence de langue (créé automatiquement)
├── README.md ← cette documentation ├── README.md ← cette documentation
├── CONTRIBUTING_SCRIPTS.md ← guide pour créer de nouveaux scripts ├── doc_contribution/
├── _template_script.ps1 ← modèle de script │ ├── CONTRIBUTING_SCRIPTS.md ← guide pour créer de nouveaux scripts
│ ├── _template_script.ps1 ← modèle de script
│ └── _template_script.README.md ← modèle de README bilingue FR/EN
└── scripts/ ← scripts téléchargés (créé automatiquement) └── scripts/ ← scripts téléchargés (créé automatiquement)
└── NomDuScript/ └── NomDuScript/
└── NomDuScript.ps1 └── NomDuScript.ps1
+883 -328
View File
File diff suppressed because it is too large Load Diff
+35 -2
View File
@@ -55,7 +55,40 @@ cadMasterCLI détecte automatiquement un paramètre comme **fichier** et affiche
Si le nom contient `Csv` ou `Input`, une zone de collage d'IPs avec conversion automatique en CSV est également proposée. Si le nom contient `Csv` ou `Input`, une zone de collage d'IPs avec conversion automatique en CSV est également proposée.
### 4. Structure du dépôt Gitea ### 4. README bilingue FR/EN
Depuis cadMasterCLI v2, l'interface peut s'afficher en français ou en anglais. Pour que la documentation du script (panneau de gauche) suive la langue active, le `README.md` du dépôt peut contenir les deux versions dans un seul fichier, séparées par des marqueurs HTML :
```markdown
<!-- FR -->
# Nom du script
Description en français...
## Paramètres
- `MonParam` : ce que fait ce paramètre.
<!-- EN -->
# Script name
Description in English...
## Parameters
- `MonParam`: what this parameter does.
```
Règles :
- Les marqueurs `<!-- FR -->` et `<!-- EN -->` doivent être seuls sur leur ligne.
- L'ordre des sections n'a pas d'importance.
- Si une seule des deux langues est présente, cadMasterCLI l'affiche quelle que soit la langue active (pas d'erreur).
- **Rétro-compatibilité** : un `README.md` sans aucun marqueur continue de s'afficher tel quel dans les deux langues (comportement identique aux versions précédentes de cadMasterCLI).
Voir `_template_script.README.md` dans ce dépôt pour un exemple complet.
### 5. Structure du dépôt Gitea
Le dépôt doit contenir à sa racine : Le dépôt doit contenir à sa racine :
@@ -88,6 +121,6 @@ MonScript/
## Exemple minimal conforme ## Exemple minimal conforme
Voir `_template_script.ps1` dans ce dépôt pour un squelette prêt à l'emploi. Voir `_template_script.ps1` (script) et `_template_script.README.md` (documentation bilingue) dans ce dépôt pour un squelette prêt à l'emploi.
Pour un exemple complet et fonctionnel, voir le script **DaliACLI**. Pour un exemple complet et fonctionnel, voir le script **DaliACLI**.
+1
View File
@@ -0,0 +1 @@
2.0.0