An open-source entry in TopGit's GitHub warehouse: goreleaser/godownloader, 449 stars, Go. [DEPRECATED] Download Go binaries as fast and easily as possible.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Download Go binaries as fast and easily as possible.
This is the inverse of goreleaser. The goreleaser YAML file is read and creates a custom shell script that can download the right package and the right version for the existing machine.
If you use goreleaser already, this will create scripts suitable for "curl bash" style downloads.
Run godownloader on your goreleaser.yaml file
Add the godownloader.sh file to your repo
Tell your users to use https://raw.githubusercontent.com/YOU/YOURAPP/master/godownloader.sh to install
This is also useful in CI/CD systems such as travis-ci.org.
Much faster then 'go get' (sometimes up to 100x)
Make sure your local environment (macOS) and the CI environment (Linux) are using the exact same versions of your go binaries.
CI/CD Example
Let's say you are using hugo, the static website generator, with travis-ci.
Your old .travis.yml file might have
install:
- go get github.com/gohugoio/hugo
This can take up to 30 seconds!
Hugo doesn't have (yet) a godownloader.sh file. So we will make our own:
# create a godownloader script
godownloader --repo=gohugoio/hugo > ./godownloader-hugo.sh
and add godownloader-hugo.sh to your GitHub repo. Edit your .travis.yml as such
install:
- ./godownloader-hugo.sh v0.37.1
Without a version number, GitHub is queried to get the latest version number.
install:
- ./godownloader-hugo.sh
Typical download time is 0.3 seconds, or 100x improvement.
Your new hugo binary is in ./bin, so change your Makefie or scripts to use ./bin/hugo.
The default installation directory can be changed with the -b flag or the BINDIR environment variable.
Notes on Functionality
Only GitHub Releases are supported right now.
Checksums are checked.
Binares are installed using tar.gz or zip.
No OS-specific installs such as homebrew, deb, rpm. Everything is installed locally via a tar.gz or zip. Typically OS installs are done differently anyways (e.g. brew, apt-get, yum, etc).
Experimental support
Some people do not use Goreleaser (why!), so there is experimental support for the following alterative distributions.
"naked" releases on GitHub
A naked release is just the raw binary put on GitHub releases. Limited support can be done by
./goreleaser -source raw -repo [owner/repo] -exe [name] -nametpl [tpl]
Where exe is the final binary name, and tpl is the same type of name template that Goreleaser uses.
An example repo is at mvdan/sh. Note how the repo sh is different than the binary shfmt.
Equinox.io
Equinox.io is a really interesting platform. Take a look.
There is no API, so godownloader screen scrapes to figure out the latest release. Likewise, checksums are not verified.
./goreleaser -source equinoxio -repo [owner/repo]
While Equinox.io supports the concept of different release channels, only the stable channel is supported by godownloader.
Yes, it's true.
It's a go program that reads a YAML file that uses a template to make a posix shell script.
Other Resources and Inspiration
Other applications have written custom shell downloaders and installers:
golang/dep
The golang/dep package manager has a nice downloader, install.sh. Their trick to extract a version number from GitHub Releases is excellent:
$(echo "${LATEST_RELEASE}" | tr -s '\n' ' ' | sed 's/.*"tag_name":"//' | sed 's/".*//' )
This is probably based on masterminds/glide and its installer at https://glide.sh/get
kubernetes/helm
kubernetes/helm is a "tool for managing Kubernetes charts. Charts are packages of pre-configured Kubernetes resources."
It has a get script. Of note is that it won't re-install if the desired version is already present.
chef
Chef has the one of the most complete installers at https://omnitruck.chef.io/install.sh. In particular it has support for
Support for solaris and aix, and some other less common platforms
python or perl as installers if curl or wget isn't present
http proxy support
Caddy
Caddy is "the HTTP/2 web server with automatic HTTPS" and a NGINX replacement. It has a clever installer at https://getcaddy.com. Of note is GPG signature verification.
TopGit's last sync did not record any GitHub topics for goreleaser/godownloader. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on goreleaser/godownloader?
The most recent commit recorded on goreleaser/godownloader was 5.3 years ago, based on the GitHub push timestamp. The repository has 54 forks — one of the better signals of community interest.
How many stars does goreleaser/godownloader have?
goreleaser/godownloader has 449 GitHub stars — refresh the page for the live number, or check github.com/goreleaser/godownloader. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is goreleaser/godownloader written in?
goreleaser/godownloader is written primarily in Go. GitHub's language field is based on the largest share of bytes in the default branch.
Where do I read more about goreleaser/godownloader?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/goreleaser/godownloader is the definitive source.
Read full README in the tab above.
Still deciding about godownloader?
One click hands the question to an AI along with this page — see what it says about godownloader.