Skip to content

Commit 8e85865

Browse files
committed
feat(launcher): Add --install/--uninstall CLI flags to Windows launcher
Mirror the Linux/Mac launcher CLI: albert-code.bat --install and --uninstall are now equivalent to menu options 2 and 3, exiting immediately instead of looping back to the menu. Document --install / --uninstall for both .sh and .bat in the README, in a new "Rendre la commande disponible globalement" subsection.
1 parent a9792d7 commit 8e85865

2 files changed

Lines changed: 50 additions & 2 deletions

File tree

‎README.md‎

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -66,12 +66,34 @@ Sous Windows, utiliser `albert-code.bat` à la place de `albert-code.sh`.
6666
> Lancer `.\albert-code.bat` sans argument affiche un menu interactif :
6767
>
6868
> 1. **Lancer Albert Code** : démarre l'application normalement.
69-
> 2. **Installer la commande dans le PATH utilisateur** : ajoute le dossier d'Albert Code au `PATH` afin que `albert-code` soit disponible depuis n'importe quel répertoire.
70-
> 3. **Désinstaller la commande du PATH utilisateur** : retire l'entrée du `PATH` (le dossier et l'application restent en place).
69+
> 2. **Installer la commande dans le PATH utilisateur** : ajoute le dossier d'Albert Code au `PATH` afin que `albert-code` soit disponible depuis n'importe quel répertoire (équivalent CLI : `albert-code.bat --install`).
70+
> 3. **Désinstaller la commande du PATH utilisateur** : retire l'entrée du `PATH` (équivalent CLI : `albert-code.bat --uninstall`). Le dossier et l'application restent en place.
7171
> 4. **Quitter** : ferme le menu sans rien lancer.
7272
>
7373
> Avec des arguments (par exemple `albert-code.bat -p "..."` ou `albert-code.bat --version`), le menu est court-circuité et la commande s'exécute directement.
7474
75+
### Rendre la commande disponible globalement (optionnel)
76+
77+
Pour pouvoir taper `albert-code` depuis n'importe quel dossier au lieu de `/chemin/vers/albert-code/albert-code.sh`, les deux lanceurs proposent une sous-commande d'installation. Le dossier de travail courant est préservé : Albert Code s'exécute toujours dans le répertoire d'où la commande est appelée.
78+
79+
**Linux / Mac** (crée un lien symbolique dans `~/.local/bin/`) :
80+
81+
```bash
82+
./albert-code.sh --install # installe le lien
83+
./albert-code.sh --uninstall # retire le lien
84+
```
85+
86+
Si `~/.local/bin` n'est pas dans le `PATH`, le script l'indique et propose la ligne à ajouter au `~/.bashrc` ou `~/.zshrc`.
87+
88+
**Windows** (ajoute le dossier au `PATH` utilisateur) :
89+
90+
```powershell
91+
.\albert-code.bat --install # ajoute le dossier au PATH
92+
.\albert-code.bat --uninstall # retire le dossier du PATH
93+
```
94+
95+
Sous Windows, ces sous-commandes font la même chose que les options 2 et 3 du menu interactif. Ouvrir une nouvelle fenêtre Windows Terminal après l'installation pour que la modification du `PATH` soit prise en compte.
96+
7597
## 3 - Utilisation
7698

7799
```bash

‎albert-code.bat‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,13 @@
11
@echo off
22
REM Lanceur albert-code -- Windows
3+
REM
34
REM Sans argument : affiche un menu (lancer / installer / desinstaller / quitter).
45
REM Avec arguments : execute albert-code en mode direct.
6+
REM
7+
REM Sous-commandes (equivalent CLI des options du menu) :
8+
REM albert-code.bat --install -> ajoute le dossier au PATH utilisateur
9+
REM albert-code.bat --uninstall -> retire le dossier du PATH utilisateur
10+
REM
511
REM Usage : albert-code.bat [options] [PROMPT]
612

713
REM %~dp0 = dossier du script (d=drive, p=path, 0=argument 0)
@@ -10,6 +16,11 @@ REM Supprimer le \ final pour eviter les doubles \ dans les chemins
1016
if "%SCRIPT_DIR:~-1%"=="\" set SCRIPT_DIR=%SCRIPT_DIR:~0,-1%
1117
set VENV_DIR=%SCRIPT_DIR%\.venv
1218

19+
REM Sous-commandes d'installation / desinstallation en mode CLI (sortie immediate).
20+
REM A traiter avant le check generique "if not arg empty" pour ne pas tomber dans :prepare.
21+
if /i "%~1"=="--install" goto :cli_install_path
22+
if /i "%~1"=="--uninstall" goto :cli_uninstall_path
23+
1324
REM Si des arguments sont fournis, mode direct (pas de menu, pas de check console)
1425
if not "%~1"=="" goto :prepare
1526

@@ -105,6 +116,21 @@ echo.
105116
pause
106117
goto :menu
107118

119+
REM Variantes CLI : meme action que les options du menu, mais sortie immediate
120+
REM (pas de retour vers le menu, pas de pause finale).
121+
:cli_install_path
122+
echo Ajout de "%SCRIPT_DIR%" au PATH utilisateur...
123+
powershell -NoProfile -Command "$dir = '%SCRIPT_DIR%'; $current = [Environment]::GetEnvironmentVariable('Path', 'User'); if ($current -notlike ('*' + $dir + '*')) { if ([string]::IsNullOrEmpty($current)) { $new = $dir } else { $new = $current.TrimEnd(';') + ';' + $dir }; [Environment]::SetEnvironmentVariable('Path', $new, 'User'); Write-Host 'Ajoute.' } else { Write-Host 'Deja present, aucun changement.' }"
124+
echo.
125+
echo Tu peux maintenant lancer "albert-code" depuis n'importe quel dossier.
126+
echo Ouvrir une nouvelle fenetre Windows Terminal pour que le PATH soit pris en compte.
127+
exit /b 0
128+
129+
:cli_uninstall_path
130+
echo Retrait de "%SCRIPT_DIR%" du PATH utilisateur...
131+
powershell -NoProfile -Command "$dir = '%SCRIPT_DIR%'; $current = [Environment]::GetEnvironmentVariable('Path', 'User'); if ([string]::IsNullOrEmpty($current)) { Write-Host 'PATH utilisateur vide, rien a faire.' } else { $entries = $current -split ';' | Where-Object { $_ -ne $dir -and $_ -ne '' }; $new = $entries -join ';'; [Environment]::SetEnvironmentVariable('Path', $new, 'User'); Write-Host 'Retire.' }"
132+
exit /b 0
133+
108134
:prepare
109135
REM Verifier que python est disponible
110136
where python >nul 2>&1

0 commit comments

Comments
 (0)