Skip to content

theseus-rs/ristretto

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,678 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Ristretto

ci Documentation Code Coverage Benchmarks Latest version License Semantic Versioning

Embeddable Java Virtual Machine JVM implementation.

Getting Started

ristretto java can be installed using the following methods:

Linux / MacOS

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/theseus-rs/ristretto/releases/latest/download/ristretto_java-installer.sh | sh

Windows

irm https://github.com/theseus-rs/ristretto/releases/latest/download/ristretto_java-installer.ps1 | iex

For more information, and additional installations instructions (cargo, homebrew, msi), visit the ristretto site.

Features

  • Standard runtime classes backed by LTS versions of AWS Corretto.
  • Flexible class loading from directories, JARs, JMODs, JImage files, and URLs.
  • Built-in support for reading, writing, and strictly verifying Java bytecode.
  • Interpreter support for all Java byte codes including invokedynamic.
  • Fully asynchronous, non-blocking execution using Rust async/await for:
    • java.lang.Process
    • java.lang.Thread
    • java.io & java.nio
    • java.net
  • A low-pause, concurrent, and parallel mark-and-sweep garbage collector.
  • Parallel Just-In-Time (JIT) compilation for x86-64, aarch64, s390x, and riscv64 architectures.
  • WebAssembly (WASM) compilation support for single-threaded edge and browser deployments.
  • Native Maven POM (Project Object Model) parsing.

Limitations

Runtime Native Methods

The Java runtime requires hundreds of native methods. This project aims to provide Rust equivalents for these methods. If a native method is called that is not implemented, the program throw a java.lang.UnsatisfiedLinkError. Please submit a pull request, or open an issue if you need a specific native method implemented.

Security Manager

Support for the Security Manager is not implemented and there are no plans to implement it. The security manager has been deprecated; see: JEP 411

System.getSecurityManager() will always return null, and System.setSecurityManager() will throw an exception.

Finalizers

Support for finalizers is not implemented and there are no plans to implement it. Finalizers have been deprecated; see: JEP 421

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

Java Virtual Machine

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors