Compare commits
5 Commits
18fe9d7186
...
feature/go
| Author | SHA1 | Date | |
|---|---|---|---|
| 9bf66f6d90 | |||
| 3f0f13147b | |||
| 2b2eb87f45 | |||
| 3ffbb550ec | |||
| 98b5187bfc |
2
.gitignore
vendored
2
.gitignore
vendored
@@ -1,7 +1,7 @@
|
||||
log/
|
||||
dist/
|
||||
build/
|
||||
__pycache__/
|
||||
rsrc.syso
|
||||
*.spec
|
||||
*.exe.old
|
||||
_update.bat
|
||||
|
||||
107
CLAUDE.md
107
CLAUDE.md
@@ -6,37 +6,53 @@ Outil Windows (.exe) avec interface graphique qui vérifie les mises à jour de
|
||||
Conçu pour être placé sur une **clé USB** dont la lettre de lecteur peut changer.
|
||||
Le programme peut **s'auto-mettre à jour** car il est lui-même dans un dépôt git.
|
||||
|
||||
## Langage
|
||||
|
||||
**Go** (anciennement Python, migré en Go depuis v0.7.x).
|
||||
- GUI : `github.com/lxn/walk` (contrôles natifs Windows)
|
||||
- Exe unique, aucune dépendance externe à l'exécution
|
||||
- Build : `go build` via `build.bat`
|
||||
|
||||
## Structure du projet
|
||||
|
||||
```
|
||||
Lanceur-geco/
|
||||
├── git_updater.py # Script principal Python (GUI tkinter)
|
||||
├── version.txt # Fichier contenant le numéro de version (ex: "0.5.1")
|
||||
├── config.ini # Configuration multi-repo
|
||||
├── build.bat # Script de compilation en .exe via PyInstaller
|
||||
├── log/ # Dossier de logs (créé automatiquement, 1 fichier par jour)
|
||||
├── main.go # Point d'entrée, constante VERSION
|
||||
├── config.go # Chargement config.ini (repos + self-update)
|
||||
├── git.go # Opérations git (check, clone, pull, checkout, clean)
|
||||
├── gui.go # Interface graphique (walk/TableView)
|
||||
├── logger.go # Logging fichier (1 fichier/jour, rotation 30j)
|
||||
├── selfupdate.go # Auto-mise à jour du programme
|
||||
├── platform_windows.go # Code spécifique Windows (création processus)
|
||||
├── version.txt # Numéro de version (utilisé par l'auto-update distant)
|
||||
├── config.ini # Configuration multi-repo
|
||||
├── build.bat # Script de compilation en .exe
|
||||
├── app.manifest # Manifeste Windows (DPI, elevation)
|
||||
├── icon.ico # Icône application
|
||||
├── go.mod / go.sum # Dépendances Go
|
||||
├── log/ # Dossier de logs (créé automatiquement)
|
||||
└── CLAUDE.md
|
||||
```
|
||||
|
||||
## Règles importantes
|
||||
|
||||
- **Tous les chemins doivent être relatifs** à l'emplacement de l'exe. Jamais de chemin absolu (pas de `C:\`, `G:\`, etc.). Utiliser `..` et des chemins relatifs pour référencer les dossiers.
|
||||
- **Accès lecture seule** : le programme ne fait que `git fetch`, `git pull` et `git checkout`. Jamais de `git push`, `git commit`, `git add`, ou toute opération d'écriture vers le remote.
|
||||
- **Accès lecture seule** : le programme ne fait que `git ls-remote`, `git fetch`, `git pull`, `git checkout` et `git clean`. Jamais de `git push`, `git commit`, `git add`, ou toute opération d'écriture vers le remote.
|
||||
- **Multi-repo** : le programme peut surveiller plusieurs dépôts Git configurés dans `config.ini`.
|
||||
|
||||
## Versioning
|
||||
|
||||
- La version est définie en dur dans `git_updater.py` via la constante `VERSION` (ex: `VERSION = "0.5.1"`)
|
||||
- La version est définie en dur dans `main.go` via la constante `VERSION` (ex: `const VERSION = "0.7.6"`)
|
||||
- Le fichier `version.txt` à la racine du projet contient le même numéro de version (utilisé par le mécanisme d'auto-update distant)
|
||||
- Format : **semver simplifié** `MAJEUR.MINEUR.PATCH` (ex: `0.5.1`)
|
||||
- **Les deux doivent toujours être synchronisés** : quand on change la version, mettre à jour `VERSION` dans `git_updater.py` ET `version.txt`
|
||||
- Format : **semver simplifié** `MAJEUR.MINEUR.PATCH` (ex: `0.7.6`)
|
||||
- **Les deux doivent toujours être synchronisés** : quand on change la version, mettre à jour `VERSION` dans `main.go` ET `version.txt`
|
||||
|
||||
### Mise à jour de la version
|
||||
|
||||
A chaque changement de version, il faut mettre à jour **4 éléments** :
|
||||
1. `VERSION` dans `git_updater.py` (constante en haut du fichier)
|
||||
1. `VERSION` dans `main.go` (constante en haut du fichier)
|
||||
2. `version.txt` à la racine du projet
|
||||
3. **Recompiler l'exe** via `build.bat` et copier `dist/GitUpdateChecker.exe` à la racine du projet
|
||||
3. **Recompiler l'exe** via `build.bat` (produit `GitUpdateChecker.exe` à la racine)
|
||||
4. **Créer un commit** avec le message suivant :
|
||||
|
||||
```
|
||||
@@ -50,18 +66,18 @@ Changements :
|
||||
|
||||
Exemple :
|
||||
```
|
||||
v0.5.2 - Detection depot hors ligne
|
||||
v0.7.6 - Clone dossier non-vide et verification rapide
|
||||
|
||||
Changements :
|
||||
- Ajout verification connectivite remote avant fetch (git ls-remote)
|
||||
- Affichage "HORS LIGNE" si le serveur est inaccessible
|
||||
- Synchronisation auto de l'URL origin depuis config.ini
|
||||
- Clone dans dossier non-vide (git init + remote add + fetch + checkout)
|
||||
- Verification rapide via git ls-remote au lieu de git fetch
|
||||
- Support branche par repo dans config.ini
|
||||
```
|
||||
|
||||
### Mécanisme de comparaison
|
||||
|
||||
- La fonction `_version_tuple(v)` convertit la chaîne version en tuple d'entiers (ex: `"0.5.1"` -> `(0, 5, 1)`) pour permettre la comparaison numérique
|
||||
- L'auto-update télécharge `version.txt` depuis le serveur Gitea via HTTP (`{repo_url}/raw/branch/master/version.txt`) et compare avec la `VERSION` locale
|
||||
- La fonction `parseVersion(v)` convertit la chaîne version en `[3]int` (ex: `"0.7.6"` -> `[0, 7, 6]`) pour permettre la comparaison numérique
|
||||
- L'auto-update télécharge `version.txt` depuis le serveur Gitea via HTTP (`{repo_url}/raw/branch/{branch}/version.txt`) et compare avec la `VERSION` locale
|
||||
- Si la version distante est supérieure, une mise à jour est proposée
|
||||
|
||||
## Fonctionnement
|
||||
@@ -71,64 +87,77 @@ Changements :
|
||||
2. Compare la version distante avec la constante `VERSION` locale (comparaison par tuple numérique)
|
||||
3. Si la version distante est supérieure, propose de télécharger le nouvel exe
|
||||
4. Stratégie de remplacement : télécharge dans `.new`, renomme l'exe actuel en `.old`, place le nouveau
|
||||
5. Après mise à jour, demande un redémarrage
|
||||
5. Après mise à jour, lance un script batch de redémarrage
|
||||
|
||||
### Vérification des dépôts
|
||||
1. Lit la liste des dépôts depuis `config.ini` (chemins relatifs à l'exe)
|
||||
2. Pour chaque dépôt :
|
||||
- `git fetch` pour récupérer l'état distant
|
||||
- Compare commits locaux vs distants
|
||||
- Détecte les fichiers supprimés/modifiés localement
|
||||
3. Affiche le résultat dans une interface graphique (tkinter)
|
||||
2. Pour chaque dépôt (en parallèle via goroutines) :
|
||||
- `git ls-remote` pour vérifier la disponibilité et comparer les hashs (rapide, timeout 15s)
|
||||
- `git status --porcelain` pour détecter les fichiers modifiés/non suivis localement
|
||||
3. Affiche le résultat dans une interface graphique (walk/TableView)
|
||||
4. Propose pour chaque dépôt :
|
||||
- `git pull` si nouveaux commits distants
|
||||
- `git checkout -- .` si fichiers locaux manquants/modifiés
|
||||
- `git pull` si MAJ disponible (hash distant différent)
|
||||
- `git checkout -- .` si fichiers locaux modifiés
|
||||
- `git clean -fd` si fichiers non suivis en trop
|
||||
|
||||
### Clone dans dossier non-vide
|
||||
Si le dossier cible existe déjà mais n'a pas de `.git` (ex: repos imbriqués), le programme fait un clone "in-place" :
|
||||
`git init` + `git remote add` + `git fetch` + `git checkout -b <branch>`
|
||||
|
||||
## Configuration (config.ini)
|
||||
|
||||
Supporte plusieurs sections `[repo:NomDuRepo]` :
|
||||
|
||||
```ini
|
||||
[repo:Batch]
|
||||
url = http://192.168.1.235:3125/zogzog/Batch
|
||||
path = ../Batch
|
||||
[self-update]
|
||||
url = http://192.168.1.235:3125/zogzog/Lanceur-geco
|
||||
exe_name = GitUpdateChecker.exe
|
||||
branch = master
|
||||
|
||||
[repo:Powershell]
|
||||
url = http://192.168.1.235:3125/zogzog/Powershell
|
||||
path = ../Powershell
|
||||
[repo:Scripts]
|
||||
url = http://192.168.1.235:3125/zogzog/Scripts
|
||||
path = ../SOFT/Batch/Scripts
|
||||
|
||||
[repo:Soft]
|
||||
url = http://192.168.1.235:3125/zogzog/Soft.git
|
||||
path = ../SOFT/
|
||||
branch = master
|
||||
```
|
||||
|
||||
- `url` : URL du dépôt Git distant
|
||||
- `path` : Chemin **relatif** vers le dossier local du dépôt (relatif à l'exe)
|
||||
- `branch` : Branche à suivre (optionnel, défaut: `master`)
|
||||
|
||||
## Logging
|
||||
|
||||
- Les logs sont écrits dans `log/` à côté de l'exe (1 fichier par jour, format `YYYY-MM-DD.log`)
|
||||
- Les vieux logs sont nettoyés automatiquement (30 jours de rétention)
|
||||
- Chaque action git, erreur, et résultat est loggé avec timestamp
|
||||
- Bouton "Ouvrir les logs" dans la GUI pour accéder au dossier
|
||||
- Bouton "Logs" dans la GUI pour ouvrir le dossier
|
||||
|
||||
## Build
|
||||
|
||||
```bat
|
||||
build.bat
|
||||
```
|
||||
Requiert Python + pip. Installe PyInstaller automatiquement si absent.
|
||||
Produit `dist/GitUpdateChecker.exe`. Copier `config.ini` à côté de l'exe.
|
||||
Requiert Go installé et dans le PATH. Installe `rsrc` automatiquement si absent.
|
||||
Produit `GitUpdateChecker.exe` à la racine (exe unique, pas de dépendances).
|
||||
Flags de build : `-H windowsgui -s -w` (pas de console, symboles strippés).
|
||||
|
||||
## Contraintes techniques
|
||||
|
||||
- **Chemins relatifs** : Tout est relatif à l'exe, jamais de chemin absolu
|
||||
- **Encodage** : Force UTF-8 pour les caractères Unicode
|
||||
- **Clé USB** : Fonctionne sur n'importe quelle lettre de lecteur
|
||||
- **Git requis** : Git doit être installé et dans le PATH de la machine
|
||||
- **Serveur Gitea** : Le remote origin pointe vers une instance Gitea locale (192.168.1.235:3125)
|
||||
- **Lecture seule** : Aucune opération d'écriture vers le remote (pas de push/commit)
|
||||
- **Interface** : GUI tkinter (inclus dans Python, pas de dépendance externe)
|
||||
- **Interface** : GUI native Windows via walk (pas de console)
|
||||
- **Logs** : Dossier `log/` à côté de l'exe, rotation automatique 30 jours
|
||||
- **Repos imbriqués** : Supporte les dépôts git imbriqués (ex: parent/enfant) via clone in-place
|
||||
|
||||
## Conventions
|
||||
|
||||
- Langage : Python 3, pas de dépendances externes (seulement stdlib + tkinter)
|
||||
- Interface : GUI tkinter en français
|
||||
- Langue : Français pour l'interface utilisateur
|
||||
- Langage : Go 1.22+
|
||||
- GUI : github.com/lxn/walk (contrôles natifs Windows)
|
||||
- Interface en français
|
||||
- Pas de console (flag `-H windowsgui`)
|
||||
|
||||
Binary file not shown.
BIN
gitchecker.exe
BIN
gitchecker.exe
Binary file not shown.
3
go.mod
3
go.mod
@@ -1,9 +1,10 @@
|
||||
module gitchecker
|
||||
|
||||
go 1.22
|
||||
go 1.25.0
|
||||
|
||||
require (
|
||||
github.com/lxn/walk v0.0.0-20210112085537-c389da54e794
|
||||
golang.org/x/image v0.38.0
|
||||
golang.org/x/sys v0.18.0
|
||||
)
|
||||
|
||||
|
||||
2
go.sum
2
go.sum
@@ -2,6 +2,8 @@ github.com/lxn/walk v0.0.0-20210112085537-c389da54e794 h1:NVRJ0Uy0SOFcXSKLsS65Om
|
||||
github.com/lxn/walk v0.0.0-20210112085537-c389da54e794/go.mod h1:E23UucZGqpuUANJooIbHWCufXvOcT6E7Stq81gU+CSQ=
|
||||
github.com/lxn/win v0.0.0-20210218163916-a377121e959e h1:H+t6A/QJMbhCSEH5rAuRxh+CtW96g0Or0Fxa9IKr4uc=
|
||||
github.com/lxn/win v0.0.0-20210218163916-a377121e959e/go.mod h1:KxxjdtRkfNoYDCUP5ryK7XJJNTnpC8atvtmTheChOtk=
|
||||
golang.org/x/image v0.38.0 h1:5l+q+Y9JDC7mBOMjo4/aPhMDcxEptsX+Tt3GgRQRPuE=
|
||||
golang.org/x/image v0.38.0/go.mod h1:/3f6vaXC+6CEanU4KJxbcUZyEePbyKbaLoDOe4ehFYY=
|
||||
golang.org/x/sys v0.0.0-20201018230417-eeed37f84f13/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
|
||||
golang.org/x/sys v0.18.0 h1:DBdB3niSjOA/O0blCZBqDefyWNYveAYMNF1Wum0DYQ4=
|
||||
golang.org/x/sys v0.18.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
|
||||
|
||||
32
gui.go
32
gui.go
@@ -1,7 +1,11 @@
|
||||
package main
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
_ "embed"
|
||||
"fmt"
|
||||
"image"
|
||||
"image/png"
|
||||
"os"
|
||||
"os/exec"
|
||||
"path/filepath"
|
||||
@@ -12,8 +16,12 @@ import (
|
||||
|
||||
"github.com/lxn/walk"
|
||||
. "github.com/lxn/walk/declarative"
|
||||
xdraw "golang.org/x/image/draw"
|
||||
)
|
||||
|
||||
//go:embed icon.png
|
||||
var iconPNG []byte
|
||||
|
||||
// ── Modèle TableView ──────────────────────────────────────────────────────────
|
||||
|
||||
type RepoItem struct {
|
||||
@@ -206,6 +214,7 @@ func (m *RepoModel) hasUpdates() bool {
|
||||
|
||||
type App struct {
|
||||
mw *walk.MainWindow
|
||||
iconView *walk.ImageView
|
||||
statusLabel *walk.Label
|
||||
tv *walk.TableView
|
||||
model *RepoModel
|
||||
@@ -242,6 +251,12 @@ func (a *App) buildAndRun() error {
|
||||
Composite{
|
||||
Layout: HBox{MarginsZero: true},
|
||||
Children: []Widget{
|
||||
ImageView{
|
||||
AssignTo: &a.iconView,
|
||||
MinSize: Size{Width: 24, Height: 24},
|
||||
MaxSize: Size{Width: 24, Height: 24},
|
||||
Mode: ImageViewModeIdeal,
|
||||
},
|
||||
Label{
|
||||
Text: "Git Update Checker v" + VERSION,
|
||||
Font: Font{Bold: true, PointSize: 12},
|
||||
@@ -322,13 +337,28 @@ func (a *App) buildAndRun() error {
|
||||
return err
|
||||
}
|
||||
|
||||
// Icône fenêtre
|
||||
// Icône fenêtre (depuis fichier .ico externe)
|
||||
if icoPath := filepath.Join(exeDir(), "icon.ico"); fileExists(icoPath) {
|
||||
if icon, err := walk.NewIconFromFile(icoPath); err == nil {
|
||||
a.mw.SetIcon(icon)
|
||||
}
|
||||
}
|
||||
|
||||
// Icône dans l'en-tête (depuis PNG embarqué dans l'exe, redimensionné 24x24)
|
||||
if img, err := png.Decode(bytes.NewReader(iconPNG)); err != nil {
|
||||
logWarn("Icône PNG: décodage échoué: " + err.Error())
|
||||
} else {
|
||||
const iconSize = 24
|
||||
dst := image.NewRGBA(image.Rect(0, 0, iconSize, iconSize))
|
||||
xdraw.CatmullRom.Scale(dst, dst.Bounds(), img, img.Bounds(), xdraw.Over, nil)
|
||||
bmp, err := walk.NewBitmapFromImageForDPI(dst, 96)
|
||||
if err != nil {
|
||||
logWarn("Icône PNG: bitmap échoué: " + err.Error())
|
||||
} else {
|
||||
a.iconView.SetImage(bmp)
|
||||
}
|
||||
}
|
||||
|
||||
// Lancer la vérification au démarrage
|
||||
go func() {
|
||||
time.Sleep(150 * time.Millisecond)
|
||||
|
||||
BIN
icon.png
BIN
icon.png
Binary file not shown.
|
Before Width: | Height: | Size: 1.4 MiB After Width: | Height: | Size: 793 KiB |
BIN
icon_small.png
BIN
icon_small.png
Binary file not shown.
|
Before Width: | Height: | Size: 2.2 KiB |
2
main.go
2
main.go
@@ -9,7 +9,7 @@ import (
|
||||
"github.com/lxn/walk"
|
||||
)
|
||||
|
||||
const VERSION = "0.7.6"
|
||||
const VERSION = "0.7.7"
|
||||
|
||||
func exeDir() string {
|
||||
exe, err := os.Executable()
|
||||
|
||||
@@ -1 +1 @@
|
||||
0.7.6
|
||||
0.7.7
|
||||
|
||||
Reference in New Issue
Block a user