A Rust crate featuring utilities related to the q-entities format.
The q-entities format is the unofficial name which this crate gives to the otherwise unnamed format used by id Software's Quake and its derivative titles to store a map's entities.
There exists no formal specification for this format and derivative titles have on occasion been known to modify how it is parsed which makes defining a complete specification that works under all titles unfeasible. This crate attempts to solve this problem by defining a baseline for parsing the format which can be further modified using a simple builder pattern.
The crate's top level module features types used to store and access a q-entities collection (most notably QEntities).
The parse module features types used to parse a q-entities file into a q-entities collection (most notably QEntitiesParseOptions).
```rust use qentities::parse::QEntitiesParseOptions;
const FILEDATA: &'static [u8] = br#" { "classname" "worldspawn" "wad" "mywad.wad" } { "classname" "light" "origin" "0 0 32" } { "classname" "infoplayer_start" "origin" "0 0 0" } "#;
fn main() { let entities = QEntitiesParseOptions::new().parse(&FILEDATA[..]).unwrap(); for entity in entities.iter() { println!("{{"); for kv in entity.iter() { let key = String::fromutf8lossy(kv.key()); let value = String::fromutf8_lossy(kv.value());
println!("{key:?} {value:?}");
}
println!("}}");
}
}
```