14 breaking releases

Uses old Rust 2015

0.15.0 Aug 27, 2024
0.14.0 Jul 20, 2024
0.13.0 Jun 1, 2024
0.12.0 Jun 11, 2023
0.2.0 Sep 10, 2018

#775 in Parser implementations

Download history 3173/week @ 2024-07-03 3952/week @ 2024-07-10 5017/week @ 2024-07-17 5673/week @ 2024-07-24 3647/week @ 2024-07-31 4834/week @ 2024-08-07 4118/week @ 2024-08-14 3746/week @ 2024-08-21 4093/week @ 2024-08-28 4811/week @ 2024-09-04 3416/week @ 2024-09-11 5250/week @ 2024-09-18 4659/week @ 2024-09-25 4037/week @ 2024-10-02 3340/week @ 2024-10-09 4390/week @ 2024-10-16

17,290 downloads per month
Used in 66 crates (via vulkano)

Apache-2.0/MIT

180KB
4.5K SLoC

vk-parse

LICENSE LICENSE Documentation Crates.io Version Build Status

vk-parse is a Rust crate which parses the Vulkan API registry XML and converts it to a Rust representation.

This crate provides a library which parses the Vulkan registry XML and either provides its own lossless representation of the registry, or converts it to structures from vkxml.

Usage

To get started, you'll need vk.xml file which is used for generating Vulkan header files and is stored in Vulkan-Docs repository.

After that, in your Rust project:

Cargo.toml

[dependencies]
vk-parse = "0.15"

main.rs

extern crate vk_parse;
use std::path::Path;

fn main() {
    let (registry, _errors) = vk_parse::parse_file(Path::new("vk.xml")).unwrap();
    println!("{:?}", registry);
}

Conversion to structures from vkxml is optional and must be enabled using feature.

Cargo.toml

[dependencies]
vk-parse = { version = "0.15", features = ["vkxml-convert"] }
vkxml = "0.3"

main.rs

extern crate vk_parse;
extern crate vkxml;
use std::path::Path;

fn main() {
    // You can either parse normal structures and convert them into vkxml format ...
    let (registry_ir, _errors) = vk_parse::parse_file(Path::new("vk.xml")).unwrap();
    println!("{:?}", registry_ir);
    let registry_vkxml: vkxml::Registry = registry_ir.into();
    println!("{:?}", registry_vkxml);

    // ... or do both in single call.
    let registry_vkxml = vk_parse::parse_file_as_vkxml(Path::new("vk.xml")).unwrap();
    println!("{:?}", registry_vkxml);
}

License

This software is dual-licensed under Apache-2.0/MIT, same as Rust itself.

Dependencies

~245–425KB