g

G

Einfacher Go-Versionsmanager, glutenfrei.

Warum?

Bestehende Versionsmanager erstellen von Quelle, haben zu viele Abhängigkeiten, verschmutzen den Pfad und/oder verlangen, dass Sie eine bestimmte Shell -Umgebung verwenden. g zielt darauf ab, so unauffällig und tragbar wie möglich zu sein.

g ist inspiriert von TJ/N - zu dem ich in der Vergangenheit beigetragen habe - und leiht einen Teil seines Code.

Merkmale

• Führen Sie jede Go -Version auf Bedarf aus.
• Single tragbares Shell -Skript, das idealerweise dort lebt, wo Ihre Go -Binärdateien leben.
• Funktioniert, egal welche Shell Sie verwenden, solange $GOPATH und $GOROOT exportiert werden, welche ...
• ... ist go und nicht spezifisch für g .
• Es ist nicht erforderlich, Funktionen in Ihrer Shell -Konfiguration zu source .
• Downloads vorgefertigte Binärdateien, also ist es schnell und ...
• ... erfordert kein Git, kein Quecksilber, kein GCC, kein Xcode usw.
• curl und wget Erstklasse gleichermaßen.
• Farbenfrohe Benutzeroberfläche und interaktiv, aber sicher zu putzen und in automatisierten Skripten zu verwenden.
• Self-Upgrade-Befehl, um auf dem neuesten Stand zu bleiben.
• Option, Go -Beta -Versionen zu bekommen.
• Erstaunen Sie in Golang mit einer einzigen Zeile mit dem Installationsskript.
• Das Installationsskript erkennt Namenskollisionen und hilft Ihnen dabei, einen alternativen Namen festzulegen.

Anforderungen

• MacOS-, Linux- oder BSD -Umgebung. Bash für Windows (WSL) wird ebenfalls unterstützt.
• Entweder curl oder wget , wenden Sie sich an curl -V oder wget -V .

Nicht ausschließlich notwendig, aber sehr empfohlen, um eine frühere GO -Installation vollständig zu entfernen - nur um seltsames Ergebnis zu verhindern.

Einzellinieninstallation

Wichtig : Bevor Sie fortfahren, ermutige ich Sie, das Installationsskript zu lesen. Vertraue niemals jemandem, der dir sagt, dass du zufällige Befehle ausführen sollst.

Das heißt, Sie können g mit einem einzigen Befehl installieren:

curl -sSL https://git.io/g-install | sh -s

Wenn Sie stattdessen wget verwenden:

wget -qO- https://git.io/g-install | sh -s

Dadurch wird das g -Skript heruntergeladen, es in $GOPATH/bin/ , geben Sie ihm Ausführungsrechte mit chmod und konfigurieren Sie die Initialisierungsdatei Ihrer Standard -Shell, setzen Sie die GOPATH und GOROOT -Umgebungsvariablen und fügen $GOPATH/bin dem PATH hinzu.

Dann werden Sie aufgefordert, die neueste Version von Go zu installieren. Sie können diesen Schritt überspringen und Ihre bevorzugte Version mit g später installieren.

Hinweis : Sie müssen Ihre aktuelle Shell -Sitzung neu starten, damit sie diese neuen Env -Vars lesen, um g oder go zu verwenden.

Schalenunterstützung

Das Installationsskript unterstützt derzeit die folgenden Shells:

• verprügeln
• ZSH
• Fisch
• Asche
• Bindestrich
• CSH
• TCSH

Das bedeutet nicht, dass Sie g nicht mit anderen Shells verwenden können, sondern einfach mit der manuellen Installation fortfahren.

Mit dem Installationsskript wird Ihre Standardhülle für die Konfiguration ausgewählt. Möglicherweise sehen Sie, wie Ihre Standardschale ausgeführt wird:

 echo $SHELL

Wenn Sie eine Diff -Shell konfigurieren möchten, können Sie sie als Argumente übergeben:

curl -sSL https://git.io/g-install | sh -s -- fish

Sie können auch mehrere Shells konfigurieren, aber das ist normalerweise nicht erforderlich:

 curl -sSL https://git.io/g-install | sh -s -- fish bash zsh

Verwenden Sie die Option -y , um die Eingabeaufforderungen zu überspringen und für alles "Ja" anzunehmen:

curl -sSL https://git.io/g-install | sh -s -- -y

Ausfall ändern

Standardmäßig werden diese GO -Umgebungsvariablen verwendet:

 GOROOT: $HOME/.go
GOPATH: $HOME/go

$GOPATH/bin wird dem PATH hinzugefügt und dort wird g kopiert.

Sie können diese Variablen festlegen, bevor Sie das Installationsskript ausführen. Zum Beispiel in Bash und ZSH:

 export GOROOT= ~ /.local/share/golang
export GOPATH= ~ /MyProjects/go-projects
curl -sSL https://git.io/g-install | sh -s

In Fisch:

 set -gx GOROOT ~ /.local/share/golang
set -gx GOPATH ~ /MyProjects/go-projects
curl -sSL https://git.io/g-install | sh -s

Manuelle Installation

1. Stellen Sie sicher, dass Sie die Umgebungsvariablen $GOPATH & $GOROOT exportieren und $GOPATH/bin auf Ihrem PATH hinzufügen.
2. Nehmen Sie eine Kopie des Skripts ./bin/g und setzen Sie es überall in Ihrem PATH ein - in $GOPATH/bin/ ist eine gute Option.
3. Geben Sie den Skriptausführungsrechten mit chmod +x $GOPATH/bin/g .
4. Starten Sie Ihre Shell -Sitzung neu, um sicherzustellen, dass die Env -Variablen geladen sind.

Upgrade

g enthält einen self-upgrade -Befehl, den Sie ausführen können, um die neueste Version von g zu erhalten. In diesem Befehl wird das Skript installieren.

Verwendung

  Usage: g [COMMAND] [options] [args]

  Commands:

    g                         Open interactive UI with downloaded versions
    g install latest          Download and set the latest go release
    g install <version>       Download and set go <version>
    g download <version>      Download go <version>
    g set <version>           Switch to go <version>
    g run <version>           Run a given version of go
    g which <version>         Output bin path for <version>
    g remove <version ...>    Remove the given version(s)
    g prune                   Remove all versions except the current version
    g list                    Output downloaded go versions
    g list-all                Output all available, remote go versions
    g self-upgrade            Upgrades g to the latest version
    g help                    Display help information, same as g --help

  Options:

    -h, --help                Display help information and exit
    -v, --version             Output current version of g and exit
    -q, --quiet               Suppress almost all output
    -c, --no-color            Force disabled color output
    -y, --non-interactive     Prevent prompts
    -o, --os                  Override operating system
    -a, --arch                Override system architecture
    -u, --unstable            Include unstable versions in list

Deinstallieren

g ist ein einzelnes tragbares Shell -Skript, das sich wie ein Binärdatum verändert, das in Ihrem $PATH erhältlich ist. Wenn Sie g mit dem Installationskript einrichten, sollte die Entfernung ziemlich einfach sein.

Achten Sie zunächst einige Informationen zu Ihrem System:

 echo $SHELL
echo $GOROOT
echo $GOPATH
command -v g

Sie werden bemerken, dass die g -Datei in Ihrem $GOPATH/bin/ verzeichnis lebt. Wenn Sie nur g entfernen und Ihre aktuell installierten go -Binärdateien und zugehörigen Dateien aufbewahren möchten, löschen Sie einfach g :

 # If you're using bash, zsh, or other POSIX shell:
rm " $( command -v g ) "

# If you're using fish:
rm (command -v g)

Wenn Sie jetzt alles entfernen möchten, sollten Sie zuerst Ihre Projekte in $GOROOT , falls vorhanden, sichern . Dann entfernen Sie alles in $GOROOT und $GOPATH :

rm -r $GOPATH $GOROOT

Öffnen Sie dann Ihre Shell-Konfigurationsdatei mit Ihrem Texteditor der Wahl und suchen Sie nach einer Zeile, die g-install enthält, um sie zu entfernen. Dies sind die Orte, die normalerweise vom Installationskript verwendet werden:

 # bash on MacOS
~ /.bash_profile

# bash on linux/BSD
~ /.bashrc

# zsh
~ /.zshrc

# fish shell
~ /.config/fish/config.fish

# csh
~ /.cshrc

# tcsh
~ /.tcshrc

# For ash and dash, check your $ENV var
echo $ENV

Zu diesem Zeitpunkt hätten Sie g entfernt und vollständig go .

Todo

• Verbessere Dokumente ein bisschen mehr
• Machen Sie g und g-install -konform
• Fügen Sie Unterstützung für weitere Shells hinzu
• Warnen Sie Benutzer, dass sie bereits eine Golang-Installation haben, wenn Sie g-install verwenden
• Verwenden Sie eine bessere Benennung für g install <version> , use vielleicht oder set . Siehe #8
  • Verwenden Sie install nur für die Installation und entfernen Sie die Option --download
• Bewältigen Sie den Fall, wenn g bereits existiert, hauptsächlich zsh mit oh-my-zsh
  • Machen Sie es so, dass g-install dem Benutzer einen alternativen Alias ​​für g einrichten kann
• Machen Sie den Befehl self-upgrade -Wurf, wenn g nicht auf die gemeinsame Weise installiert wurde
• Fügen Sie einen complete Befehl hinzu, der Abschlüsse für die unterstützten Shells generiert
  • Lassen Sie die Shells g-install einrichten
• Erforschen Sie die Funktion, um Shells zu autoload -Go -Versionen basierend auf mod.go zu konfigurieren
• Testen Sie es auf Diff -Plattformen
• Kreta ein Test -Setup mit Docker und Github -Aktionen
• Fügen Sie weitere Tests hinzu

Die Alternativen (und warum ich g bevor ich es bevorzuge)

• Moovweb/GVM
  • Zu viele Funktionen.
  • Baut aus Quelle, dh GCC, make, xcode usw. erfordert
  • Benötigt Git und Mercurial.
  • Benötigt Bootstrapping, dh, installieren Sie Go 1.4 zuerst.
  • Speziell für eine Hülle funktioniert nicht mit Fishshell.
• Syndbg/Goenv
  • Zu viele Funktionen und seltsamer DX.
  • Verwendet eine hart codierte Liste von Go-Versionen ...
  • ... So müssen Sie goenv aktualisieren, bevor Sie eine neue Version von Go installieren.
  • Fügt viel zu Ihrer Umwelt und Ihrem Pfad hinzu.
• hit9/oo
  • Ziemlich gleich wie gvm .
• Asdf-Golang
  • Hängt von ASDF ab.
• Andrewkroh/GVM
  • Bash, Batch und PowerShell unterstützen nur.
  • Umständlich zu bedienen.
• Makenowjust/govm
  • Baut aus der Quelle auf.
  • Benötigt Python 2.

Beitragen

Bitte lesen Sie mitwirkend.md. ♥

Anerkennung

• Jeder Beitrag zu diesem Projekt.
• Das n -Projekt, von dem g inspiriert ist und von dem er basiert.
• Das n-install , auf dem g ebenfalls basiert.

Lizenz

MIT ♥