[日本語]

gup - Update binaries installed by go install

gup command updates binaries installed by go install to the latest version. It updates all binaries in parallel, so very fast. It also provides subcommands for manipulating binaries under $GOPATH/bin ($GOBIN). It is a cross-platform software that runs on Windows, Mac and Linux.

This is a fork of nao1215/gup that focuses on simplicity.

How to install

Build from source (recommended)

go install github.com/Akimon658/gup@latest

Binary install

Download from Releases page.

You can install gup without Golang, but you still need to install it as gup depends on the go command internally.

Usage

Update all binaries

If you want to update all binaries, just run gup update.

$ gup update
gup:INFO : update binary under $GOPATH/bin or $GOBIN
gup:INFO : [ 1/30] github.com/cheat/cheat/cmd/cheat (Already up-to-date: v0.0.0-20211009161301-12ffa4cb5c87)
gup:INFO : [ 2/30] fyne.io/fyne/v2/cmd/fyne_demo (Already up-to-date: v2.1.3)
gup:INFO : [ 3/30] github.com/nao1215/gal/cmd/gal (v1.0.0 to v1.2.0)
gup:INFO : [ 4/30] github.com/matsuyoshi30/germanium/cmd/germanium (Already up-to-date: v1.2.2)
gup:INFO : [ 5/30] github.com/onsi/ginkgo/ginkgo (Already up-to-date: v1.16.5)
gup:INFO : [ 6/30] github.com/git-chglog/git-chglog/cmd/git-chglog (Already up-to-date: v0.15.1)
   :
   :

Update the specified binary

If you want to update only the specified binaries, you specify multiple command names separated by space.

$ gup update subaru gup ubume
gup:INFO : update binary under $GOPATH/bin or $GOBIN
gup:INFO : [1/3] github.com/Akimon658/gup (v0.7.0 to v0.7.1)
gup:INFO : [2/3] github.com/nao1215/subaru (Already up-to-date: v1.0.2)
gup:INFO : [3/3] github.com/nao1215/ubume/cmd/ubume (Already up-to-date: v1.4.1)

List up command name with package path and version under $GOPATH/bin

list subcommand prints command informations of binaries under $GOPATH/bin or $GOBIN. The output informations are the command name, package path, and command version.

Remove the specified binary

If you want to remove a command under $GOPATH/bin or $GOBIN, use the remove subcommand. It asks whether you want to remove it before removing it.

$ gup remove subaru gal ubume
Do you want to remove /home/nao/.go/bin/subaru? [Y/n] y
Removed /home/nao/.go/bin/subaru
Do you want to remove /home/nao/.go/bin/gal? [Y/n] n
Removal cancelled
Do you want to remove /home/nao/.go/bin/ubume? [Y/n] y
Removed /home/nao/.go/bin/ubume

If you want to force the removal, use the --force option.

$ gup remove --force gal
Removed /home/nao/.go/bin/gal

Check if the binary is the latest version

If you want to know if the binary is the latest version, use the check subcommand. check subcommand checks versions and displays the name of the binaries that need to be updated.

$ gup check
gup:INFO : check binary under $GOPATH/bin or $GOBIN
gup:INFO : [ 1/33] github.com/cheat/cheat (Already up-to-date: v0.0.0-20211009161301-12ffa4cb5c87)
gup:INFO : [ 2/33] fyne.io/fyne/v2 (current: v2.1.3, latest: v2.1.4)
   :
gup:INFO : [33/33] github.com/nao1215/ubume (Already up-to-date: v1.5.0)

gup:INFO : If you want to update binaries, the following command.
           $ gup update fyne_demo gup mimixbox 

Like other subcommands, you can only check the specified binaries.

$ gup check lazygit mimixbox
gup:INFO : check binary under $GOPATH/bin or $GOBIN
gup:INFO : [1/2] github.com/jesseduffield/lazygit (Already up-to-date: v0.32.2)
gup:INFO : [2/2] github.com/nao1215/mimixbox (current: v0.32.1, latest: v0.33.2)

gup:INFO : If you want to update binaries, the following command.
           $ gup update mimixbox 

Export/Import

You can use the export/import subcommands if you want to install the same Golang binaries across multiple systems.

export subcommand prints package paths to stdout. To save it as a file, use redirect.

gup export > path/to/file

After you have copied the file to other environment, run gup import.

gup import path/to/file

Configuration

You can define ldflags and tags to pass to go install by a YAML file.

gup uses $XDG_CONFIG_HOME/gup/package.yml. If the environment variable is not defined, gup will use these directories instead.

Fallback locations

OS	Location
Linux	~/.config
macOS	~/Library/Application Support
Windows	%LOCALAPPDATA%

For more details, see adrg/xdg.

Example

global:
  ldflags: -s -w

packages:
  - name: hugo
    ldflags: -s -w -X github.com/gohugoio/hugo/common/hugo.vendorInfo=akimon658
    tags: extended

If name matches the command's name, it will override global settings.

Contributing

First off, thanks for taking the time to contribute! See CONTRIBUTING.md for more information.

LICENSE

The gup project is licensed under the terms of the Apache License 2.0. This is a fork repository of nao1215/gup.