https://github.com/x4e/classfile-rs

JVM classfile parser and writer for Rust
https://github.com/x4e/classfile-rs

bytecode classfile java jvm rust

Last synced: about 1 month ago
JSON representation

JVM classfile parser and writer for Rust

• Host: GitHub
• URL: https://github.com/x4e/classfile-rs
• Owner: x4e
• License: mit
• Created: 2020-10-11T21:40:28.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2021-04-22T22:46:26.000Z (over 3 years ago)
• Last Synced: 2024-08-10T14:16:33.429Z (5 months ago)
• Topics: bytecode, classfile, java, jvm, rust
• Language: Rust
• Homepage:
• Size: 512 KB
• Stars: 36
• Watchers: 2
• Forks: 6
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# classfile-rs

Speedy class file implementation for rust

This is a library for reading, manipulating, and writing class files.

Goals:

* Simple, abstract AST

* Stackmap frame generation

* Resistant to malicious/malformed class files

The AST is designed to be more logical and intuitive to a Java developer than the official bytecode

 specification. 

For example, `iconst_0`s are represented as `ldc(0)`s, `invokestatic(...)`s are represented as `invoke(static, ...)`.

Bytecode offsets are also transformed into labels.

The constant pool is fully abstracted.

Todos:

* Stackmap frame generation

* Class writing

(Feel free to contribute on these)

## Speed

The library should take <1ms to read an averagely sized class file, but can take longer depending on the amount of

 control flow within the class (Label reading is not optimal at the moment).

Here is a benchmark:

![Throughput benchmark](https://cdn.discordapp.com/attachments/665688984302649354/803225667399057448/unknown.png)

## Examples

[Reading a class file](https://github.com/x4e/classfile-rs/tree/master/examples/read/src/main.rs)