macOS / Linux (Homebrew)```bash

Homebrew

brew install depsguard

Ou téléchargez manuellement via PowerShell:```powershell $zip = "$env:TEMP\depsguard.zip" Invoke-WebRequest -Uri "https://github.com/arnica/depsguard/releases/latest/download/depsguard-x86_64-pc-windows-msvc.zip" -OutFile $zip Expand-Archive -LiteralPath $zip -DestinationPath "$env:TEMP\depsguard" -Force Copy-Item "$env:TEMP\depsguard\depsguard.exe" "$HOME\AppData\Local\Microsoft\WindowsApps\depsguard.exe" -Force depsguard.exe --help

Nécessite une chaîne d'outils Rust avec cargo.

Gestionnaires de paquets (lorsqu'ils sont publiés par votre fournisseur)

Si votre organisation distribue DepsGuard via Homebrew, Scoop ou WinGet, suivez leurs instructions. La configuration ou l'automatisation de ces canaux (PRs core Homebrew, buckets, PRs WinGet, secrets CI) relève de la documentation du mainteneur ; voir AGENTS.md sous Publication et distribution.

Magasins d'applications / gestionnaires de paquets

Mettre à jour vers la dernière version

Utilisez le canal avec lequel vous avez installé :

Vérifiez votre version installée à tout moment avec depsguard --version, et consultez la page des versions pour la version la plus récente.

Construire à partir des sources```bash

git clone https://github.com/arnica/depsguard.git cd depsguard cargo build --release

Comment utiliser

1. Installation – choisissez votre plateforme ci-dessus.
2. Exécutez depsguard pour lancer l’interface TUI interactive. Elle analyse votre système et affiche un tableau des résultats. Appuyez sur n’importe quelle touche pour accéder au sélecteur de correctifs. La découverte de la configuration au niveau du dépôt commence dans le répertoire courant et recherche vers le bas. Utilisez depsguard scan pour un rapport en lecture seule, ou depsguard --no-search pour ignorer la recherche récursive de fichiers et ne vérifier que les configurations utilisateur.

   Remarque : certains réglages nécessitent une version minimale. Si votre version est trop ancienne, vous verrez : ℹ min-release-age – requires npm ≥ 11.10 (have 10.2.0). Mettez à jour avec npm install -g npm@latest et relancez.

3. Naviguer et sélectionner – utilisez ↑ ↓ pour vous déplacer dans la liste (^u ^d pour paginer). Appuyez sur Espace pour activer ou désactiver un correctif. Utilisez les touches de filtrage rapide pour sélectionner en masse par fichier : a tout, n .npmrc, u uv.toml, etc. – appuyez une fois pour sélectionner, à nouveau pour désélectionner, une troisième fois pour effacer le filtre. Appuyez sur f pour n’afficher que les correctifs actuellement sélectionnés.
4. Aperçu – appuyez sur d pour voir un diff des modifications avant de valider quoi que ce soit.
5. Appliquer – appuyez sur Entrée pour appliquer les correctifs sélectionnés. Une sauvegarde horodatée est créée avant toute écriture de fichier.
6. Réanalyse – DepsGuard relance automatiquement l’analyse après l’application, afin que vous puissiez vérifier que tout est vert.
7. Restaurer – exécutez depsguard restore à tout moment pour revenir en arrière depuis la liste des sauvegardes. Appuyez sur q ou Échap pour quitter.

Ce qui est vérifié

Emplacements des fichiers de configuration

Les fichiers de configuration utilisateur sont lus depuis leurs emplacements standards (y compris les chemins basés sur XDG lorsque l’outil les prend en charge). Les configurations au niveau du dépôt sont découvertes en recherchant vers le bas à partir du répertoire courant, en ignorant les répertoires volumineux connus (node_modules, .git, target, Library, .cache, etc.) afin que les analyses restent rapides. Les fichiers .npmrc, .yarnrc.yml, pnpm-workspace.yaml, les configurations Renovate et Dependabot au niveau du dépôt sont tous recherchés. Les paramètres pnpm peuvent résider dans ~/.npmrc (pnpm <= 10 uniquement ; pnpm >= 11 lit uniquement les paramètres d’authentification/registre depuis .npmrc), dans le fichier de configuration global pnpm (rc pour pnpm <= 10, config.yaml pour pnpm >= 11), ou dans pnpm-workspace.yaml ; DepsGuard vérifie les trois emplacements indépendamment. Pour pip, uv et poetry, DepsGuard résout le seul fichier de configuration utilisateur effectif et rapporte uniquement ce fichier, plutôt que de signaler les fichiers masqués séparément. pip et poetry fusionnent leurs fichiers de configuration par priorité (le fichier de plus haute priorité qui définit le délai de refroidissement l’emporte, ou l’emplacement préféré si aucun ne le fait) ; uv lit un seul fichier utilisateur ($XDG_CONFIG_HOME/uv/uv.toml lorsque XDG_CONFIG_HOME est défini, sinon ~/.config/uv/uv.toml) sans fusionner les deux. Pour bun, si plusieurs fichiers de configuration utilisateur existent (par exemple un chemin XDG et un chemin dans le répertoire personnel), DepsGuard analyse chaque fichier existant séparément. aube lit le même ~/.npmrc que npm/pnpm (minimumReleaseAge, en minutes) et est également vérifié sur les fichiers .npmrc découverts au niveau du dépôt ; pip et poetry sont analysés à partir de leur configuration utilisateur (pip.conf / pypoetry/config.toml).

Correctif de sécurité urgent

Si la version corrigée est plus récente que votre fenêtre de délai de refroidissement, ajoutez une exception étroite, installez le correctif, puis supprimez l’exception.

Préférez une exception spécifique à un paquet plutôt que d’abaisser le délai de refroidissement global. Cela maintient le délai pour toutes les autres dépendances.

Avant de contourner le délai de refroidissement :

1. Vérifiez si la CVE affecte réellement votre utilisation.
2. Vérifiez si une version plus ancienne connue comme bonne est déjà disponible. Un retour en arrière peut être plus sûr.
3. Supprimez les exceptions temporaires après la mise à jour.

Sauvegardes et restauration

Avant de modifier un fichier, DepsGuard écrit une sauvegarde dans ~/.depsguard/backups/.

Exécutez depsguard restore pour lister les sauvegardes et en restaurer une.

Comment ça fonctionne```

src/ main.rs CLI args, run loop term.rs Raw mode + input (Unix termios / Windows console FFI) manager.rs Detection, scanning, recommendations fix.rs Read/write .npmrc, TOML, YAML; backup/restore ui.rs Banner, tables, selector