topgrade

Introduction

Remarque Il s'agit d'une fourche de topgrade par r-darwish pour le maintenir.

Garder votre système à jour consiste généralement à invoquer plusieurs gestionnaires de packages. Il en résulte une grosse obus non portable en unie-crue enregistrée dans votre coquille. Pour y remédier, Topgrade détecte les outils que vous utilisez et exécute les commandes appropriées pour les mettre à jour.

Installation

• Arch Linux: Aur
• Nixos: Nixpkgs
• Void Linux: xbps
• macOS: homebrew ou macport
• Fenêtres: Chocolatey, Scoop ou Winget
• PYPI: Pip
• Fedora: Copr

D'autres utilisateurs de systèmes peuvent utiliser cargo install ou les binaires compilés à partir de la page de version. Les binaires compilés contiennent une fonction d'auto-amélioration.

Usage

Exécutez simplement topgrade .

Configuration

Voir config.example.toml pour un exemple de fichier de configuration.

Migration et changements de rupture

Chaque fois qu'il y a un changement de rupture , le numéro de version majeur sera heurté et nous documenterons ces modifications dans la note de version, veuillez y jeter un œil lorsqu'il est mis à jour vers une version majeure.

Vous avez une question? N'hésitez pas à ouvrir un problème ou une discussion!

Chemin de configuration

CONFIG_DIR sur chaque plate-forme

• Windows : %APPDATA%
• macOS et autres systèmes UNIX : ${XDG_CONFIG_HOME:-~/.config}

topgrade recherchera le fichier de configuration aux endroits suivants, par ordre de priorité:

1. CONFIG_DIR/topgrade.toml
2. CONFIG_DIR/topgrade/topgrade.toml

Si le fichier avec une priorité plus élevée est présent, peu importe qu'il soit valide ou non, les autres fichiers de configuration seront ignorés.

Lors de la première exécution (aucun fichier de configuration n'existe), topgrade créera un fichier de configuration sur CONFIG_DIR/topgrade.toml pour vous.

Commandes personnalisées

Les commandes personnalisées peuvent être définies dans le fichier de configuration qui peut être exécuté avant, pendant ou après les commandes intégrées, selon les besoins. Par défaut, les commandes personnalisées sont exécutées à l'aide d'un nouveau shell en fonction de la variable d'environnement $SHELL sur UNIX (tombe à sh ) ou pwsh sur Windows (retombe à powershell ).

Sur Unix, si vous souhaitez exécuter votre commande à l'aide d'un shell interactif, par exemple pour vous procurer des fichiers RC de votre shell, vous pouvez ajouter -i au début de votre commande personnalisée. Mais notez que cela nécessite que la commande quitte correctement le shell ou bien que le shell se bloque indéfiniment.

Exécution à distance

Vous pouvez spécifier une clé appelée remote_topgrades dans le fichier de configuration. Cette touche doit contenir une liste des noms d'hôte qui ont été installés sur les termes. Topgrade utilisera ssh pour exécuter topgrade sur les hôtes distants avant d'agir localement. Pour limiter l'exécution uniquement aux hôtes spécifiques, utilisez le paramètre --remote-host-limit .

Contribution

Problèmes ou fonctionnalités manquantes?

Ouvrez un nouveau problème décrivant votre problème et si possible, fournissez une solution.

Vous manquez une fonctionnalité ou trouvé un outil / distribution non pris en charge?

Laissez-nous maintenant ce que vous manquez en ouvrant un problème. Pour les outils, veuillez ouvrir un problème décrivant l'outil, quelles plates-formes qu'elle prend en charge et, si possible, donnez-nous un exemple de son utilisation.

Vous voulez contribuer au code?

Frais simplement le référentiel et commencez à coder.

Lignes directrices de contribution

Voir contribution.md

Feuille de route

• Ajoutez un cadre de test approprié à la base de code.
• Ajoutez des tests unitaires pour les gestionnaires de packages.
• Divisez le code en pièces plus maintenables, par exemple. Mettre chaque gestionnaire de packages Linux dans un propre sous-module de Linux.RS.