Skip to content

tsoutsman/kaitai-rs

Repository files navigation

kaitai

Crates.io Documentation Workflow Status

This crate is still very much a work in progress.

A macro for compiling Kaitai Struct into Rust.

Example

Given the following file basic_be.ksy:

meta:
  id: basic
  endian: be
seq:
  - id: header
    type: u2
  - id: body
    type: s8
  - id: tail
    type: u4

The rust code to read a basic_be buffer would look something like this:

#[kaitai_source("../tests/formats/basic_be.ksy")]
struct BasicBigEndian;

fn main() -> Result<()> {
    let file = BasicBigEndian::from_file("tests/files/example.basic")?;

    println!("header: {}", file.header);
    println!("body: {}", file.body);
    println!("tail: {}", file.tail);
}

Semantics

The filepath provided to kaitai_source is taken relative to the current file, similarly to how modules are found. However, the filepath provided to from_file is taken relative to the root of the project, like std::fs::File::open.

License

Licensed under either of

at your option.

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

A macro for compiling Kaitai Struct into Rust.

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

No packages published