node-jdk-utils

A collection of Java related utils.

Installation

``bash
npm i jdk-utils
`

Usage

$3

Find Java runtime from all possible locations on your machine.
Covering:
* JAVA_HOME.
* JDK-like paths from PATH.
* SDKMAN installation location.
* jabba installation location, i.e. ~/.jabba/jdk
* JBang installation location, i.e. ~/.jbang/cache/jdks
* ASDF installation location.
* JDK installations managed by Gradle, e.g. ~/.gradle/jdk
* Links specified in jEnv.
* Homebrew installation:
* macOS Intel: /usr/local
* macOS Apple Silicon: /opt/homebrew
* Linux: /home/linuxbrew/.linuxbrew
* Platform-specific conventional installation location:
* Linux: /usr/lib/jvm
* macOS: /Library/Java/JavaVirtualMachines, ~/Library/Java/JavaVirtualMachines, output of java_home -V.
* Windows: JDK-like folders under %ProgramFiles% and %LocalAppData%,

Note: If you want to skip scanning a certain source for better performance, you can specify skipFrom options when calling the API.

#### CLI

Below command lists all detected JDKs with details.
`bash
npx jdk-utils
`


#### callback-style

`ts
require("jdk-utils").findRuntimes().then(console.log)
/*
[{
homedir: '/home/username/.sdkman/candidates/java/17.0.1-ms',
}, {
homedir: '/usr/lib/jvm/java-11-openjdk-amd64',
},
...
]
*/
`

#### promise-style
`ts
import { findRuntimes } from "jdk-utils";
await findRuntimes({checkJavac: true, withVersion: true, withTags: true});
/*
[{
homedir: '/home/yanzh/.sdkman/candidates/java/17.0.1-ms',
hasJavac: true,
isFromSDKMAN: true,
version: { java_version: '17.0.1', major: 17 }
}, {
homedir: '/usr/lib/jvm/java-11-openjdk-amd64',
hasJavac: true,
version: { java_version: '11.0.7', major: 11 }
},
...
]
*/
``