lighty-core 0.8.2

Core utilities for Lighty Launcher
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

# lighty-core


Core utilities for [LightyLauncher](https://crates.io/crates/lighty-launcher).

## Note


This is an internal crate for the LightyLauncher ecosystem. Most users should use the main [`lighty-launcher`](https://crates.io/crates/lighty-launcher) crate instead.

## Features


- **Async Downloads**: Concurrent downloads with retry logic and SHA1 verification
- **Archive Extraction**: Support for ZIP, TAR, and TAR.GZ formats
- **System Detection**: OS and architecture detection
- **Hosts Management**: HTTP client with custom user agent
- **Error Handling**: Comprehensive error types with thiserror

## Usage


```toml
[dependencies]
lighty-core = "0.6.3"
```

```rust
use lighty_core::download::download_file;
use lighty_core::system::{get_os, get_architecture};

#[tokio::main]

async fn main() {
    // Detect system
    let os = get_os();
    let arch = get_architecture();
    println!("Running on {:?} {:?}", os, arch);

    // Download file
    let path = download_file(
        "https://example.com/file.zip",
        "/tmp/file.zip",
        Some("expected-sha1-hash")
    ).await?;
}
```

## Structure


```
lighty-core/
└── src/
    ├── lib.rs          # Module declarations and re-exports
    ├── download.rs     # Async file downloads with SHA1 verification
    ├── extract.rs      # Archive extraction (ZIP, TAR, TAR.GZ)
    ├── system.rs       # OS and architecture detection
    ├── hosts.rs        # HTTP client with custom user agent
    ├── hash.rs         # Hash utilities (SHA1, SHA256 verification)
    ├── errors.rs       # Error types (DownloadError, ExtractError, SystemError)
    └── macros.rs       # Utility macros
```

## Modules


- `download` - Async file downloads with retry logic and SHA1 verification
- `extract` - Archive extraction for ZIP, TAR, and TAR.GZ formats
- `system` - Cross-platform OS and architecture detection
- `hosts` - Shared HTTP client with appropriate user agent
- `errors` - Comprehensive error types with thiserror
- `macros` - Utility macros for common patterns

## License


MIT

## Links


- **Main Package**: [lighty-launcher](https://crates.io/crates/lighty-launcher)
- **Repository**: [GitHub](https://github.com/Lighty-Launcher/LightyLauncherLib)
- **Documentation**: [docs.rs/lighty-core](https://docs.rs/lighty-core)