KeePass .kdbx database file parser for Rust
```rust extern crate keepass;
use keepass::{Database, DatabaseOpenError, NodeRef}; use std::fs::File;
fn main() -> Result<(), DatabaseOpenError> { // Open KeePass database let path = std::path::Path::new("tests/resources/testdbwith_password.kdbx"); let db = Database::open( &mut File::open(path)?, // the database Some("demopass"), // password None // keyfile )?;
// Iterate over all Groups and Nodes
for node in &db.root {
match node {
NodeRef::Group(g) => {
println!("Saw group '{0}'", g.name);
},
NodeRef::Entry(e) => {
let title = e.get_title().unwrap_or("(no title)");
let user = e.get_username().unwrap_or("(no username)");
let pass = e.get_password().unwrap_or("(no password)");
println!("Entry '{0}': '{1}' : '{2}'", title, user, pass);
}
}
}
Ok(())
} ```
Add the following to the dependencies section of your Cargo.toml:
ignore
[dependencies]
keepass = "*"
Performance note: Please set the RUSTFLAGS environment variable when compiling to enable CPU-specific optimizations (this greatly affects the speed of the AES key derivation):
bash
export RUSTFLAGS='-C target-cpu=native'
For best results, also compile in Release mode.
Alternatively, you can add a .cargo/config.toml like in this project to ensure that rustflags are always set.
For AArch64 / ARMv8:
The aes optimizations are not yet enabled on stable rust. If you want a big performance boost you can build using nightly and enabling the armv8 feature of the aes crate:
```ignore [dependencies.aes]
version = "0.7.5" features = ["armv8"] ```
kp-dump-xmlThis library contains an optionally-compiled command line application to dump out the internal XML representation from a KDBX database. This can be useful for implementing additional features for the XML parser.
Since the tool depends on additional crates, it is not compiled until you specify the utilities feature, e.g.
ignore
cargo run --release --features "utilities" --bin kp-dump-xml -- path/to/database.kdbx
MIT