gentoo-core 0.4.0

Core Gentoo types and utilities for Rust applications
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# gentoo-core

[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Crates.io](https://img.shields.io/crates/v/gentoo-core.svg)](https://crates.io/crates/gentoo-core)
[![docs.rs](https://docs.rs/gentoo-core/badge.svg)](https://docs.rs/gentoo-core)
[![LICENSE](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![CI](https://github.com/lu-zero/gentoo-core/actions/workflows/ci.yml/badge.svg)](https://github.com/lu-zero/gentoo-core/actions/workflows/ci.yml)
[![codecov](https://codecov.io/github/lu-zero/gentoo-core/graph/badge.svg?token=fApuKCrcgU)](https://codecov.io/github/lu-zero/gentoo-core)

Core Gentoo types and utilities for Rust applications.


## Overview

`gentoo-core` provides fundamental Gentoo-specific types and utilities that can be used across various Gentoo-related Rust projects.

## Features

- Gentoo architecture representation and parsing
- Variant configuration for Gentoo systems

## Architecture Support

The crate supports the following Gentoo architectures:

- `arm`, `aarch64` (arm64)
- `x86`, `amd64` (x86_64)
- `riscv`, `riscv64`
- `powerpc`, `ppc64`
- And their Gentoo keyword equivalents

## Installation

Add to your `Cargo.toml`:

```toml
[dependencies]
gentoo-core = "0.3"
```

## Usage

```rust
use gentoo_core::{Arch, Variant, KnownArch};

// Parse a known architecture
let known = KnownArch::parse("amd64").unwrap();
println!("Known: {} (keyword: {}, bitness: {})", known, known.as_keyword(), known.bitness());

// Intern an architecture (known or exotic)
let arch = Arch::intern("amd64");
println!("Arch: {} (keyword: {})", arch, arch.as_keyword());

// Exotic architectures work the same way
let exotic = Arch::intern("my-custom-board");
println!("Exotic: {} (keyword: {})", exotic, exotic.as_keyword());

// Parse a variant
let variant: Variant = "amd64-systemd".parse().unwrap();
println!("Variant: {} (arch: {}, flavor: {})", variant, variant.keyword(), variant.flavor());
```

## Examples

Run the included examples:

```bash
cargo run --example arch
```

## Contributing

See [AGENTS.md](AGENTS.md) for project conventions and contribution guidelines.

## License

MIT