topgrade

Einführung

Beachten Sie, dass dies eine Gabel von Topgrade von R-Darwish ist, um sie aufrechterhalten zu halten.

Wenn Sie Ihr System auf dem neuesten Stand halten, werden in der Regel mehrere Paketmanager aufgerufen. Dies führt zu großen, nicht portablen Shell-Einzeilern, die in Ihrer Hülle gespeichert sind. Um dies zu beheben, erkennt Topgrade , welche Tools Sie verwenden, und führt die entsprechenden Befehle aus, um sie zu aktualisieren.

Installation

• Arch Linux: Aur
• Nixos: NIXPKGS
• Void Linux: xbps
• MacOS: Homebrew oder MacPorts
• Fenster: Schokolade, Schaufel oder Winget
• Pypi: Pip
• Fedora: Copr

Andere Systeme Benutzer können entweder cargo install oder die kompilierten Binärdateien auf der Release -Seite verwenden. Die zusammengestellten Binärdateien enthalten eine selbstberufliche Funktion.

Verwendung

Führen Sie einfach topgrade aus.

Konfiguration

Eine Beispielkonfigurationsdatei finden Sie unter config.example.toml .

Migration und Brechen von Veränderungen

Immer wenn es eine Breaking -Änderung gibt, wird die Hauptversionsnummer gestoßen, und wir werden diese Änderungen in der Versionsnote dokumentieren. Schauen Sie sich sie bitte an, wenn Sie auf eine Hauptveröffentlichung aktualisiert werden.

Hast du eine Frage? Fühlen Sie sich frei, ein Problem oder eine Diskussion zu eröffnen!

Konfigurationspfad

CONFIG_DIR auf jeder Plattform

• Windows : %APPDATA%
• macOS und andere UNIX-Systeme : ${XDG_CONFIG_HOME:-~/.config}

topgrade wird an den folgenden Stellen in der Reihenfolge der Priorität nach der Konfigurationsdatei suchen:

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

Wenn die Datei mit höherer Priorität vorhanden ist, werden die anderen Konfigurationsdateien ignoriert.

Beim ersten Lauf (keine Konfigurationsdatei) erstellt topgrade eine Konfigurationsdatei unter CONFIG_DIR/topgrade.toml für Sie.

Benutzerdefinierte Befehle

Benutzerdefinierte Befehle können in der Konfigurationsdatei definiert werden, die nach Bedarf vor, während oder nach den eingebauten Befehlen ausgeführt werden kann. Standardmäßig werden die benutzerdefinierten Befehle mit einer neuen Shell gemäß der $SHELL -Umgebungsvariable auf UNIX (zurückfällt auf sh ) oder pwsh unter Windows (fällt auf powershell zurück) ausgeführt.

Wenn Sie Ihren Befehl mit einer interaktiven Shell ausführen möchten, können Sie beispielsweise die RC -Dateien Ihrer Shell ausführen, können Sie zu Beginn Ihres benutzerdefinierten Befehls -i . Beachten Sie jedoch, dass der Befehl erforderlich ist, um die Shell richtig zu beenden, sonst hängt die Schale auf unbestimmte Zeit.

Fernausführung

Sie können einen Schlüssel namens remote_topgrades in der Konfigurationsdatei angeben. Dieser Schlüssel sollte eine Liste von Hostnamen enthalten, bei denen die Topgrade installiert ist. Topgrade verwendet ssh , um topgrade auf Remote -Hosts auszuführen, bevor Sie lokal handeln. Um die Ausführung nur auf bestimmte Hosts zu beschränken, verwenden Sie den Parameter --remote-host-limit Parameter.

Beitrag

Probleme oder fehlende Funktionen?

Öffnen Sie ein neues Problem, das Ihr Problem beschreibt und nach Möglichkeit eine Lösung anbietet.

Fehlen einer Funktion oder ein nicht unterstütztes Werkzeug/eine nicht unterstützte Distribution?

Lassen Sie uns jetzt das, was Sie fehlen, durch das Eröffnen eines Problems fehlen. Für Tools öffnen Sie bitte ein Problem, in dem das Tool beschreibt, das es unterstützt, und geben Sie uns, wenn möglich, ein Beispiel für die Verwendung.

Möchten Sie zum Code beitragen?

Geben Sie einfach das Repository und beginnen Sie mit der Codierung.

Beitragsrichtlinien

Siehe Beitrag.md

Roadmap

• Fügen Sie der Codebasis ein ordnungsgemäßes Testframework hinzu.
• Fügen Sie Unit -Tests für Paketmanager hinzu.
• Teilen Sie den Code in wartbarere Teile auf, z. Setzen Sie jeden Linux -Paket -Manager in ein eigenes Submodul von Linux.rs.