eix 0.4.0

Library for handling the EIX-file format of Gentoo Linux
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

# eix
[<img alt="github" src="https://img.shields.io/badge/github-Komplix%2Feix--lib-8da0cb?style=for-the-badge&labelColor=555555&logo=github" height="20">](https://github.com/Komplix/eix-lib)
[<img alt="crates.io" src="https://img.shields.io/crates/v/eix.svg?style=for-the-badge&color=fc8d62&logo=rust" height="20">](https://crates.io/crates/eix)
[![Build](https://github.com/Komplix/eix-lib/actions/workflows/build.yml/badge.svg)](https://github.com/Komplix/eix-lib/actions/workflows/build.yml)
![maintenance-status](https://img.shields.io/badge/maintenance-actively--developed-brightgreen.svg)

A Rust library to parse and search the `Gentoo Linux` Portage Package Manager `eix` database format.

## Usage

```rust
use eix::{Database, PackageReader};

fn main() -> std::io::Result<()> {
    let mut db = Database::open_read("/var/cache/eix/portage.eix")?;
    let header = db.read_header(0)?;
    let mut reader = PackageReader::new(db, header);

    while reader.next_category()? {
        let category = reader.current_category();
        while let Some(pkg) = reader.read_package()? {
            println!("{}/{}: {}", category, pkg.name, pkg.description);
        }
    }
    Ok(())
}
```

## Examples

### eix2json

The library includes an example tool `eix2json` that converts an `eix` database to JSON format.

```bash
cargo run --example eix2json -- /var/cache/eix/portage.eix output.json
```

If no output file is specified, it will output to stdout.

### eix_version_masks

The example `eix_version_masks` displays all versions of each package along with their mask flags and other metadata.

```bash
cargo run --example eix_version_masks -- /var/cache/eix/portage.eix
```

## License
Licensed under either of

* Apache License, Version 2.0
  ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
* MIT license
  ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>)

at your option.