arch-toolkit 0.3.0

Complete Rust toolkit for Arch Linux package management
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

[package]
name = "arch-toolkit"
version = "0.3.0"
edition = "2024"
rust-version = "1.91"
description = "Complete Rust toolkit for Arch Linux package management"
license = "MIT"
repository = "https://github.com/Firstp1ck/arch-toolkit"
keywords = ["archlinux", "aur", "pacman", "package-manager"]
categories = ["api-bindings", "command-line-utilities"]
include = [
    "src/**",
    "examples/**",
    "tests/**",
    "Cargo.toml",
    "Cargo.lock",
    "README.md",
    "CHANGELOG.md",
    "LICENSE",
]

[features]
default = ["aur"]
aur = ["dep:reqwest", "dep:tokio", "dep:scraper", "dep:chrono", "dep:rand", "dep:lru", "dep:async-trait"]
deps = []  # No additional dependencies for types only
index = ["dep:tokio", "dep:reqwest"]  # Async refresh and caller-client mirror discovery
install = ["deps"]  # Installation command building (uses deps types)
news = ["dep:reqwest", "dep:tokio", "dep:chrono"]  # Arch news RSS and security advisories
sandbox = ["deps"]  # Build-preflight dependency analysis (uses deps parsers)
fuzzy-search = ["dep:fuzzy-matcher"]  # Optional fuzzy matching for search
cache-disk = ["dep:dirs"]

[dependencies]
# Always included (minimal)
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
thiserror = "2.0"
tracing = "0.1"

# HTTP client (for aur feature)
reqwest = { version = "0.13", features = ["json"], optional = true }
tokio = { version = "1", features = ["rt", "time"], optional = true }

# HTML parsing (for aur comments)
scraper = { version = "0.25", optional = true }

# Date handling (for aur comments)
chrono = { version = "0.4", optional = true }

# Random number generation (for rate limiting jitter)
rand = { version = "0.9", optional = true }

# LRU cache (for cache feature)
lru = { version = "0.16", optional = true }

# Async trait support (for aur feature)
async-trait = { version = "0.1", optional = true }

# Directory utilities (for cache-disk feature)
dirs = { version = "5.0", optional = true }

# Fuzzy matching (for fuzzy-search feature)
fuzzy-matcher = { version = "0.3", optional = true }

[dev-dependencies]
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
wiremock = "0.6"
tempfile = "3.10"

# Examples that use the AUR client directly and cannot compile without it
[[example]]
name = "aur_example"
required-features = ["aur"]

[[example]]
name = "env_config"
required-features = ["aur"]

[[example]]
name = "health_check"
required-features = ["aur"]

[[example]]
name = "mock_testing"
required-features = ["aur"]

[[example]]
name = "rich_error_context"
required-features = ["aur"]

[[example]]
name = "with_caching"
required-features = ["aur"]

# Integration tests that exercise the AUR caching layer
[[test]]
name = "cache_integration"
required-features = ["aur"]

[package.metadata.docs.rs]
all-features = true

[lints.clippy]
# Enable cognitive complexity lint to catch overly complex functions
cognitive_complexity = "warn"
pedantic = { level = "deny", priority = -1 }
nursery = { level = "deny", priority = -1 }
unwrap_used = "deny"
# Keep docs linting consistent with clippy naming
missing_docs_in_private_items = "warn"

[lints.rust]
missing_docs = "warn"
# Ignored tests run with:
# cargo test -- --ignored