iso9660_simple 0.2.3

ISO9660 reading library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# ISO9660 Simple

It's a Rust crate that provides minimal ISO9660 images reading and parsing functionality.

# To Do

- [x] Rock Ridge extension support
- [x] Joliet extension support

# Usage

Firstly, add `iso9660_simple` to your project:

```bash
cargo add iso9660_simple
```

Then, implement reading device trait for your device (it may be a real device, or just a file).

The complete implementation of reading device trait for file looks like this:

```rust
use std::fs::File;
use iso9660_simple::Read as ISORead;

struct FileDevice(File);

impl ISORead for FileDevice {
    fn read(&mut self, position: usize, buffer: &mut [u8]) -> Option<()> {
        if self.0.seek(SeekFrom::Start(position as u64)).is_err() {
            return None;
        }

        if self.0.read_exact(buffer).is_ok() {
            Some(())
        } else {
            None
        }
    }
}
```

Then, you're ready to open the device and make ISO9660 reader from it.
For example:

```rust
let device = FileDevice(File::open("image.iso").unwrap());
let mut iso = ISO9660::from_device(device);
```

And now, you can do parse an ISO9660 file:

```rust
let root_directory_lba = iso.root().lba.get();
let data = iso.read_directory(root_directory_lba);  // Read root directory

let first_file = data.first().unwrap();  // Get first file info

let mut buffer = vec![0u8; first_file.file_size()];
let data = iso.read_file(fist_file, 0, &mut buffer);  // Read the whole file into Vec<u8>.
```