discocli: A Java repository from HanSolo

Disco CLI

Disco CLI is a command line interface for the foojay.io Disco API

You can either use the jar file and start it with java -jar discocli-17.0.15.jar (which needs JDK 17 to be the current jdk) or you can use the native image and call it via discocli. At the moment there are binaries available for

Windows x64 (Intel)
Linux x64 (Intel)
Macos x64 (which also works on aarch64, thx to Rosetta2)

The available binaries can be found here

From version 17.0.3 on now the native images will always be build on each push using github actions and can be downloaded from the action itself. Keep in mind that you might have to allow the downloaded binary to be executed on your local machine. On Macos you need to open the binary by CTRL+RIGHT click and Open it once in the Finder and then it will work from the command line. On Windows you have to double click the exe file and agree to execute it once, after that you can execute it also from the command line.

Attention: On Windows it might be needed to download and install the Microsoft Visual C++ 2015 Redistributable Update 3 RC to get the VCRUNTIME140.dll for Java based native images.

The operating system parameter (-os) can be left out if you would like to get a JDK for your current machine because it will be detected automatically.

Help:

Get help by using the -h or --help parameter as follows:

Using the jar:
java -jar discocli-17.0.15.jar -h

Using the binary:
discocli -h

Info:

If not specified, the distribution will default to Zulu and the archive type will default to tar.gz for Linux, Mac and to zip for Windows. If you do not specify the operating system discocli will try to detect the current operating system and use it. In case you would like to download a version for Alpine Linux, you can either specify the -os parameter to -os alpine-linux or use the lib c type parameter in combination with linux as os e.g. -os linux -lc musl.

Example usaging the jar file (needs JDK 17):

Get Zulu with version 17.0.2 for windows including JavaFX:

java -jar discocli-17.0.15.jar -d zulu -v 17.0.2 -fx -os windows

Get the latest version of JDK 17 for Temurin on Linux:

java -jar discocli-17.0.15.jar -d temurin -v 17 -os linux -latest

Example using the binary:

Get Zulu with version 17.0.2 for the current operating system including JavaFX:

discocli -d zulu -v 17.0.2 -fx

Get the latest version of JDK 16 for Liberica on Windows:

discocli -d liberica -v 16 -os windows -latest

Get the JDK 17.0.2 of temurin for macos with aarch64 as a tar.gz and store it to a folder

discocli -d temurin -v 17.0.2 -os macos -arc aarch64 -at tar.gz -p /Users/hansolo

In case a JDK pkg cannot be found discocli will try to give you the available pkgs.

discocli -d liberica -v 12 -os linux -arc x64 -fx -latest

Sorry, defined pkg not found in Disco API

Packages available for Liberica for version 12:
discocli -d liberica -v 12.0.2 -os linux -lc glibc -arc amd64 -at tar.gz -pt jdk
discocli -d liberica -v 12.0.1 -os linux -lc glibc -arc amd64 -at tar.gz -pt jdk
discocli -d liberica -v 12 -os linux -lc glibc -arc amd64 -at tar.gz -pt jdk

Find available pkgs for a given set of parameters e.g. early access builds of zulu with version 18 for mac on aarch64 as jdk

discocli -fu zulu,19,macos,aarch64,jdk,ea

Updates found  

discocli -d zulu -v 19-ea+8 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea 
discocli -d zulu -v 19-ea+7 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea 
discocli -d zulu -v 19-ea+6 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea 
discocli -d zulu -v 19-ea+5 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea 
discocli -d zulu -v 19-ea+4 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea 
discocli -d zulu -v 19-ea+3 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea 
discocli -d zulu -v 19-ea+2 -os macos -lc libc -arc aarch64 -at zip -pt jdk -ea

Find distributions in a given folder

discocli -fd "/System/Volumes/Data/Library/Java/JavaVirtualMachines/"

Distributions found
graalvm_ce17,22.0.0.2,macos,x86_64
zulu,11.0.14.1,macos,aarch64
zulu,16.0.1,macos,aarch64,fx
*zulu,17.0.2,macos,aarch64
zulu,18-ea+34,macos,aarch64
zulu,8.0.322+6,macos,aarch64,fx

The distribution that is currently defined in JAVA_HOME is marked with an '*'. If you would like to check the default path for your operating system, you can simply use

discocli -fd ""

Distributions found
graalvm_ce17,22.0.0.2,macos,x86_64
zulu,11.0.14.1,macos,aarch64
zulu,16.0.1,macos,aarch64,fx
*zulu,17.0.2,macos,aarch64
zulu,18-ea+34,macos,aarch64
zulu,8.0.322+6,macos,aarch64,fx

The default paths for the different operating systems are:

Macos  : /System/Volumes/Data/Library/Java/JavaVirtualMachines/
Windows: C:\Program Files\Java\
Linux  : /usr/lib/jvm

You can check if there is an update available for a given distribution using the following command

Find updates for Zulu 16.0.1 for MacOS on x64 as a JRE:

discocli -fu "zulu,16.0.1,macos,x64,jre"

Updates found

discocli -d zulu -v 16.0.2 -os macos -lc libc -arc x64 -at dmg -pt jre
discocli -d zulu -v 16.0.2 -os macos -lc libc -arc x64 -at zip -pt jre
discocli -d zulu -v 16.0.2 -os macos -lc libc -arc x64 -at tar.gz -pt jre



Find updates for Liberica 17.0.1 for Windows on x64 as a JDK incl. JavaFX:

discocli -fu "liberica,17.0.1,windows,x64,jdk,fx"

Updates found

discocli -d liberica -v 17.0.2 -os windows -lc c_std_lib -arc amd64 -at zip -pt jdk -fx
discocli -d liberica -v 17.0.2 -os windows -lc c_std_lib -arc amd64 -at msi -pt jdk -fx

You also simply check for available packages for a set of parameters

Find all available jdk packages of Zulu for Macos on AARCH64 for version 17.0.2 
that comes as a tar.gz:

discocli -f -d zulu -v 17.0.2 -arc aarch4 -os macos -at tar.gz -pt jdk

Packages found for Zulu for version 17:
discocli -d zulu -v 17.0.2 -os macos -lc libc -arc x64 -at tar.gz -pt jdk -fx
discocli -d zulu -v 17.0.2 -os macos -lc libc -arc x64 -at tar.gz -pt jdk

If you just want to download the latest available LTS release of a given distro

Get the latest available LTS release of Zulu for your machine:

discocli -d zulu -latest-lts

Build native image with GraalVM:

Make sure you have GraalVM installed (including the native image feature)
Set GRAALVM_HOME environment variable
Find more info related to operating system specific requirements here

Build the jar file using:
./gradlew clean build

Go to the build/libs folder:
cd /build/libs

Windows:
%GRAALVM_HOME%\bin\native-image.cmd -jar discocli-17.0.15![img.png](img.png).jar --no-server -H:Name=discocli --no-fallback --static --enable-http --enable-https

Linux:
$GRAALVM_HOME/bin/native-image -jar discocli-17.0.15.jar --no-server -H:Name=discocli --no-fallback --static --enable-http --enable-https

Macos:
$GRAALVM_HOME/bin/native-image -jar ./discocli-17.0.15.jar --no-server -H:Name=discocli --no-fallback --enable-http --enable-https

Usage

discocli [-h] [-d=<d>] [-v=<v>] [-os=<os>] [-lc=<lc>] [-arc=<arc>] [-at=<at>] [-pt=<pt>] [-p=<p>] [-ea] [-fx] [-f] [-latest] [-i]

Download a JDK pkg defined by the given parameters:

-h,   --help                  Show help

-d,   --distribution=<d>      Distribution (e.g. zulu, temurin, etc.)

-v,   --version=<v>           Version number (e.g. 17.0.2)

-os,  --operating-system=<os> Operating system (e.g. windows, linux, macos)

-lc,  --libc-type=<lc>        Lib C type (libc, glibc, c_std_lib, musl)

-arc, --architecture=<arc>    Architecture (e.g. x64, aarch64)

-at,  --archive-type=<at>     Archive tpye (e.g. tar.gz, zip)

-pt,  --package-type=<pt>     Package type (e.g. jdk, jre)

-p,   --path=<p>              The path where the JDK pkg should be saved to (e.g. /Users/hansolo)

-ea,  --early-access          Include early access builds

-fx,  --javafx                Bundled with JavaFX

-f,   --find                  Find available JDK pkgs for given parameters

-fd,  --find-distros          Find distributions in given path (e.g. ./)

-fu,  --find-update           Find update for given distribution in the format DISTRO,VERSION,OPERATING SYSTEM,ARCHITECTURE,PACKAGE TYPE,FX(optional)
                              (e.g. discocli -fu "zulu,16.0.1,macos,x64,jdk")

-latest                       Latest available for given version number

-latest-lts                   Latest available LTS release

-i,   --info                  Info about parameters

Parameters

---------- Distributions ----------
aoj              (AdoptOpenJDK)
aoj_openj9       (AdoptOpenJDK OpenJ9)
bisheng          (Bi Sheng)
corretto         (Corretto)
dragonwell       (Dragonwell)
graalvm_ce11     (GraalVM CE11)
graalvm_ce16     (GraalVM CE16)
graalvm_ce17     (GraalVM CE17)
graalvm_ce8      (GraalVM CE8)
jetbrains        (JetBrains)
kona             (Kona)
liberica         (Liberica)
liberica_native  (Liberica Native)
mandrel          (Mandrel)
microsoft        (Microsoft)
ojdk_build       (OJDK Build)
openlogic        (OpenLogic)
oracle           (Oracle)
oracle_open_jdk  (Oracle OpenJDK)
sap_machine      (SAP Machine)
semeru           (Semeru)
semeru_certified (Semeru certified)
temurin          (Temurin)
trava            (Trava)
zulu             (Zulu)
zulu_prime       (Zulu Prime)

---------- Operating systems ------
windows
linux
macos
alpine-linux

---------- Lib C types ------------
glibc
musl
libc
c_std_lib

---------- Architectures ----------
aarch64
aarch32
arm
arm32
armhf
armel
arm64
mips
mipsel
ppc
ppc64
ppc64le
riscv64
s390x
sparc
sparcv9
x64
x32
i386
i386
i386
x86
x86_64
amd64
ia64

---------- Archive types ----------
apk
bin
cab
deb
dmg
msi
pkg
rpm
src_tar
tar
tar.gz
tgz
tar.z
zip
exe

---------- Package types ----------
jdk
jre

HanSolo/discocli