https://github.com/telegraphic-dev/juv

uv for Java
https://github.com/telegraphic-dev/juv

Last synced: about 1 month ago
JSON representation

uv for Java

• Host: GitHub
• URL: https://github.com/telegraphic-dev/juv
• Owner: telegraphic-dev
• Created: 2026-05-26T20:41:40.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-05-27T08:07:05.000Z (about 1 month ago)
• Last Synced: 2026-05-27T08:21:20.314Z (about 1 month ago)
• Language: Rust
• Homepage:
• Size: 167 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# juv

`juv` is a Rust-native port of JBang, starting with the execution path.

This repository is intentionally aiming for JBang compatibility rather than inventing a new script format.

## Current slice

Implemented now:

- `juv run  [args...]`

- `juv build `

- `juv init ` built-in Java template generation

- `juv template list [--json]` list built-in and imported catalog init templates

- `juv cache clear`

- `juv cache path [--cache-dir ...]`

- `juv cache list [--json] [--cache-dir ...]`

- `juv trust add|remove|list|clear` for remote script trust entries

- `juv run --trust ` / `juv build --trust `

- `juv app install ` install a script as a PATH command

- `juv app uninstall ` remove an installed command

- `juv app list` list installed script commands

- `juv alias list [--json]` list aliases from the nearest `jbang-catalog.json`

- `juv alias add  [args...]` add a local catalog alias

- `juv alias remove ` remove a local catalog alias

- `juv catalog add   [--import]` register an external catalog

- `juv catalog list [--json]` list external catalogs from the nearest `jbang-catalog.json`

- `juv run ` / `juv ` run local catalog aliases

- `juv export local  [-o app.jar]` export a runnable JAR with local manifest classpath

- `juv export portable  [-o app.jar]` export a runnable JAR plus `lib/` dependencies

- `juv export native  [-o app]` export a native executable via GraalVM `native-image`

- `juv info classpath `

- `juv info tools ` with `--select`

- `juv info docs `

- `juv info cache [--cache-dir ...]`

- `juv info main|java|description|gav|module `

- `juv info deps|repos|sources|files `

- `juv info compile-options|runtime-options|native-options|javaagents|manifest `

- `juv  [args...]` JBang-style shorthand

- directive parsing for:

  - `//JAVA`

  - `//DEPS`

  - `//REPOS`

  - `//SOURCES`

  - `//FILES`

  - `//PREVIEW`

  - `//JAVAC_OPTIONS` / `//COMPILE_OPTIONS`

  - `//RUNTIME_OPTIONS` / `//JAVA_OPTIONS`

  - `//MAIN`

  - `//DESCRIPTION`

  - `//GAV`

  - `//MODULE`

  - `//DOCS`

  - `//MANIFEST`

  - `//JAVAAGENT`

  - `//NATIVE_OPTIONS`

  - `//CDS`

  - `//NOINTEGRATIONS`

- compile/run cache under the OS cache directory

- `juv build` compiles scripts into cache without running them

- `juv init` creates Java 25+ unnamed-class scripts from built-in or imported catalog templates (`hello`/`java`, `compact`, `cli`, `agent`, plus catalog `templates` entries), supports `--deps`, `--java`, `--template`, and `--force`

- `juv template list` lists built-in and imported catalog init templates and supports `--json`

- `juv cache clear` clears the compiled-script cache

- `juv cache path` prints the effective compiled-script cache directory

- `juv cache list` lists cached script entries with their classes/cache directories and supports `--json`

- `juv trust add ` stores the current remote script content hash

- `juv trust list`, `remove`, and `clear` manage trusted remote script entries

- remote `http://` and `https://` scripts are downloaded into cache and require matching trust before build/run unless `--trust` is passed

- remote relative `//SOURCES`, source-like `//DEPS`, and `//FILES` resources are downloaded next to the cached remote script

- remote trust hashes cover those downloaded resources; legacy trust entries still work for scripts that do not declare relative resources

- `juv info classpath` prints the script runtime classpath, with `--deps-only`

- `juv info tools` prints JSON metadata for tooling and supports selecting a single field

- `juv info docs` prints description and documentation references

- `juv info main`, `java`, `description`, `gav`, and `module` print single metadata values

- `juv info deps`, `repos`, `sources`, and `files` print directive collections one-per-line

- `juv info compile-options`, `runtime-options`, `native-options`, `javaagents`, and `manifest` print advanced directive collections

- `juv info cache` prints the effective cache directory

- CLI overrides for `--deps`, `--repo`, `--source`, `--files`, `--java`, `--main`, `--compile-option`, `--java-option`, and `--javaagent`

- local and imported catalog aliases from `jbang-catalog.json` / `.jbang/jbang-catalog.json`, including `alias add/remove`, `catalog add/list`, `base-ref`, `script-ref`, `catalog-ref`, `import`, `arguments`, `dependencies`, `repositories`, `sources`, `files`, classpaths, Java/runtime/compile options, agents, Java version, and main-class metadata

- imported catalog templates with `file-refs` and default `properties`, usable via `juv init --template `

- `juv export local` creates runnable JARs whose manifest classpath points at local dependency paths

- `juv export portable` creates runnable JARs and copies file-based dependency classpath entries into sibling `lib/`

- `juv export native` compiles scripts then invokes GraalVM `native-image`, passing `//NATIVE_OPTIONS` plus `--native-option` values

- Java package-aware main-class inference

- `//FILES` resources copied onto the runtime classpath

- non-coordinate `//DEPS` treated as source dependencies

- `//PREVIEW` compile/runtime flag handling

- `juv resolve ` resolve Maven coordinates to dependency list

- `juv resolve --classpath ` resolve to classpath

- `juv fetch ` fetch artifacts and print classpath

- `juv fetch --deps-only ` print coordinates instead of paths

- `juvx  -- [args...]` run an executable JAR resolved from Maven coordinates

- `juvx --main   -- [args...]` run a main class with the resolved classpath

- `juv jdk list` list discovered/cached JDKs

- `juv jdk home [version]` print the JDK home for a version (default: 25)

- `juv jdk install ` download a Temurin JDK from Adoptium

- native Maven dependency resolver (no Coursier required)

- reuses existing Maven (`~/.m2/repository`), Gradle (`~/.gradle/caches`), and Coursier (`~/.cache/coursier`) caches via symlinks

- discovers existing JDKs from `JAVA_HOME`, `PATH`, JBang (`~/.jbang/jdks`), SDKMAN (`~/.sdkman/candidates/java`), mise (`~/.local/share/mise/installs`), Gradle (`~/.gradle/jdks`), and system JVM directories

- caches discovered JDKs under `~/.cache/juv/jdks/` via symlinks so future runs do not rescan everything

- auto-provisions missing JDKs from Adoptium/Eclipse Temurin with SHA-256 archive verification

Not yet implemented: catalog remove for nested catalogs, multi-file template expansion, template property CLI overrides, export mavenrepo/jlink/project variants, edit integration, and the rest of JBang's lovely edge-case museum.

## Example

```java

//JAVA 25+

void main(String[] args) {

  IO.println("hello " + args[0]);

}

```

```bash

juv run Hello.java world

# hello world

```

## Development

```bash

cargo test --locked

cargo fmt --check

```