Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aurumcodex/jdkenv

A tool to help with the selection of JDKs, written in Go.
https://github.com/aurumcodex/jdkenv

go golang java java-environment jdk openjdk solus solus-linux

Last synced: about 1 month ago
JSON representation

A tool to help with the selection of JDKs, written in Go.

Host: GitHub
URL: https://github.com/aurumcodex/jdkenv
Owner: aurumcodex
License: apache-2.0
Created: 2020-09-27T22:52:35.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2020-10-13T00:35:58.000Z (about 4 years ago)
Last Synced: 2024-09-29T23:21:29.592Z (about 2 months ago)
Topics: go, golang, java, java-environment, jdk, openjdk, solus, solus-linux
Language: Go
Homepage:
Size: 189 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.adoc
- License: LICENSE

Awesome Lists containing this project

README

        = jdkenv image:https://img.shields.io/github/workflow/status/aurumcodex/jdkenv/jdkenv-build?style=flat-square[GitHub Workflow Status]

A simple Go program to manage and install (if not found) various JDKs.

Useful for when you use multiple JDK implementations, or want to build on different versions to test your

Java projects or other JVM language projects on different standard libraries.

Creates a directory `.jdkenv` in the `$HOME` directory, and will contain the downloaded JDK .tar.gz archives

fully extracted. Once a JDK has been selected, an `env` file will be created within the `.jdkenv` directory

that can then be sourced via a shell recfile. (`.bashrc`, `.zshrc`, `.profile`, etc.)

Takes quite a lot of inspiration from how JetBrains' IntelliJ IDEA IDE can download and use various JDKs.

(Even the `.toml` files take quite a lot of inspiration from IntelliJ's `*.intellij` files for its known JDKs.)

NOTE: Environment variable setting not yet implemented. macOS testing needs to be done,

as well as determining the best way of writing to Window's environment variables.

== Dependencies

- Go 1.15 (min version needs to be checked from deps)

== Installation

=== Using Go Modules

- Make sure `$GOBIN` and `$GOPATH` are set, and `$GOBIN` is added to your `$PATH`

- Run `go get -u github.com/aurumcodex/jdkenv`

== Usage

Running this program without a subcommand will only print the set JDK

and Java version given.

----

Usage:

  jdkenv [flags]

  jdkenv [command]

Available Commands:

  azul        Set usage of Azul Zulu Community JDK

  corretto    Set usage of Amazon Corretto JDK

  errors      Print error codes and their meanings

  help        Help about any command

  liberica    Set usage of BellSoft Liberica JDK

  local       Set usage of a locally installed JDK

  openjdk     Set usage of AdoptOpenJDK

  oracle      Set usage of Oracle OpenJDK Reference Implementation

  sapmachine  A brief description of your command

  system      Set usage of system installed JDK

Flags:

  -h, --help       help for jdkenv

  -j, --java int   use specific Java version (valid: 8, 11, 15) (default 8)

      --no-color   use monochrome output

      --spinner    disables the activity spinner (default true)

----

== Supported JDKs

// - Oracle OpenJDK `(Windows and Linux only)`

// ** JDK 8

// ** JDK 11

// ** JDK 15

// - Amazon Corretto

// ** JDK 8

// ** JDK 11

// - BellSoft Liberica

// ** JDK 8

// ** JDK 11

// ** JDK 15

// - AdoptOpenJDK

// ** JDK 8  `(Hotspot JVM / OpenJ9 JVM)`

// ** JDK 11 `(Hotspot JVM / OpenJ9 JVM)`

// ** JDK 15 `(Hotspot JVM / OpenJ9 JVM)`

// - SAP Sapmachine

// ** JDK 11

// ** JDK 15

// - Azul Zulu Community™

// ** JDK 8

// ** JDK 11

// ** JDK 15

[options="header",cols="h,4*"]

|===

| JDK Implementation  | Java 8 | Java 11 | Java 15 | Notes

| Oracle OpenJDK      | ✓      | ✓       | ✓       | `Windows and Linux Only`

| Amazon Corretto     | ✓      | ✓       |         | `none`

| BellSoft Liberica   | ✓      | ✓       | ✓       | `none`

| AdoptOpenJDK        | ✓      | ✓       | ✓       | `Hotspot and OpenJ9 JVMs supported`

| SAP Sapmachine      |        | ✓       | ✓       | `none`

| Azul Zulu Community | ✓      | ✓       | ✓       | `none`

|===

== License

JDKEnv is licensed under the Apache 2.0 License.

See link:LICENSE[LICENSE] for more details.

.Third Party libraries used (and their licenses)

- briandowns/spinner (Apache-2.0)

- cavaliercoder/grab (BSD-3)

- logrusorgru/aurora (Unlicense)

- mholt/archiver     (MIT)

- pelletier/go-toml  (MIT)

- spf13/cobra        (Apache-2.0)

- go-ini/ini         (Apache-2.0)