# unrar.rs
[](https://travis-ci.org/muja/unrar.rs)
[](https://crates.io/crates/unrar)
Please look inside the [examples directory](./examples) to see how to use this library!
Basic example to list archive entries:
```rust
extern crate unrar;
fn main() {
for entry in unrar::Archive::new("archive.rar").list().unwrap() {
println!("{}", entry.unwrap().filename);
}
}
```
Run this example using: `cargo run --example basic_list`.
Note that you have to put a `archive.rar` in this directory first.
For example, using the `rar` CLI: `rar a archive.rar .`
# Features
- [x] Multipart files
- [x] Listing archives
- [x] Extracting them (not fully tested yet)
- [x] Testing them (not fully tested yet)
- [x] Encrypted archives with password
- [ ] Tests
- [ ] Option to link dynamically or statically
- [ ] Building unrar from source on build
- [ ] Basic functionality that only uses filenames / paths (without reading archives)
- [ ] More documentation / RustDoc
# Contributing
Feel free to contribute! If you detect a bug or issue, open an issue.
Pull requests are welcome!
# Help
If you need help using the library, ping me at irc.mozilla.org, my handle is **danyel**