java-manager 0.2.0

A Rust library for managing and locating Java installations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

<div align="center">

# java-manager


![Rust.Crate](https://img.shields.io/badge/Crate-java--manager-brightgreen?style=for-the-badge&logo=Rust&logoColor=orange
)
[![Crates.io](https://img.shields.io/crates/v/java-manager.svg?style=for-the-badge)](https://crates.io/crates/java-manager)
[![License](https://img.shields.io/github/license/TaimWay/java-manager?style=for-the-badge&logo=apachelucene&logoColor=white
)](https://github.com/TaimWay/java-manager/blob/main/LICENSE-APACHE.txt)

[![Github](https://img.shields.io/badge/Github-TaimWay%2Fjava--manager-black?style=for-the-badge&logo=Github&logoColor=white
)](https://github.com/TaimWay/java-manager)
[![Author](https://img.shields.io/badge/Author-TaimWay-green?style=for-the-badge&logo=devdotto&logoColor=white
)](https://github.com/TaimWay)
![DevState](https://img.shields.io/badge/DevState-Debug%2FIndev-red?style=for-the-badge&logo=devbox&logoColor=red
)

A comprehensive Rust library and command-line tool for discovering, managing, and interacting with Java installations.

</div>

---

> **The project is currently under development. All bugs related to the project can be reported by submitting issues on GitHub, and we will regularly fix the reported problems**

## Features


- **Cross‑platform** – Works on Windows, macOS, and Linux/Unix.
- **Java discovery** – Find Java installations via `PATH`, `JAVA_HOME`, or deep system scans (Everything SDK on Windows, common directories on Linux).
- **Detailed metadata** – Extract version, vendor, architecture, and the location of the `java` executable and `JAVA_HOME`.
- **Execution control** – Run Java programs (JAR or main class) with configurable memory limits, arguments, and I/O redirection.
- **Error handling** – Comprehensive error types for path issues, I/O, command execution, and process failures.

## Installation


Add this to your `Cargo.toml`:

```toml
[dependencies]
java-manager = "0.2"
```

Or use the `cargo` command:

```bash
cargo add java-manager
```

## Usage


### Locate Java installations


```rust
use java_manager::{quick_search, deep_search, java_home};

// Quick search: look for 'java' in every directory in PATH
let javas = quick_search()?;
for java in javas {
    println!("Found Java at {} (version {})", java.path.display(), java.version);
}

// Deep search: use platform‑specific tools to find more installations
let all_javas = deep_search()?;

// Check JAVA_HOME environment variable
if let Some(java) = java_home() {
    println!("JAVA_HOME points to Java version {}", java.version);
}
```

### Execute a Java program


```rust
use java_manager::{JavaRunner, JavaRedirect};

let java = java_home().expect("JAVA_HOME not set");

// Run a JAR file
JavaRunner::new()
    .java(java.clone())
    .jar("myapp.jar")
    .min_memory(256 * 1024 * 1024)   // 256 MB
    .max_memory(1024 * 1024 * 1024)  // 1 GB
    .arg("--server")
    .redirect(JavaRedirect::new().output("out.log").error("err.log"))
    .execute()?;

// Or run a main class
JavaRunner::new()
    .java(java)
    .main_class("com.example.Main")
    .arg("arg1")
    .arg("arg2")
    .execute()?;
```

### Get metadata from a specific Java path


```rust
use java_manager::JavaInfo;

let info = JavaInfo::new("/usr/lib/jvm/java-11-openjdk/bin/java".into())?;
println!("Name: {}", info.name);
println!("Version: {}", info.version);
println!("Vendor: {}", info.vendor);
println!("Architecture: {}", info.architecture);
println!("JAVA_HOME: {}", info.java_home.display());
```

## Platform Notes


- **Windows**: Deep search uses the [Everything SDK](https://www.voidtools.com/). Everything must be installed and running.
- **Linux**: Deep search walks common directories (`/usr/lib/jvm`, `/usr/java`, `/opt`, `/usr/local`) and follows symbolic links.
- **macOS**: Currently supports the same methods as Linux (will be enhanced in future releases).

## License


This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.