download-extract-progress 1.0.0

A Rust library for downloading and extracting files with progress tracking.
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
116

# download-extract-progress


A Rust library for downloading and extracting files with progress tracking. Supports async downloads, hash verification, and zip extraction with progress updates.

---

## Features


- **Async file download** with progress reporting
- **SHA256 hash verification**
- **zip archive extraction** with progress
- **GitHub release asset download**
- **Error handling** with rich error types

---

## Installation


Add to your `Cargo.toml`:

```toml
[dependencies]
download-extract-progress = "0.1.0"
```

---

## Usage


### Download a file with progress


```rust
use download_extract_progress::download::download;
use futures_util::StreamExt;

#[tokio::main]

async fn main() {
    let url = "https://example.com/file.zip";
    let path = "./file.zip";
    let mut stream = download("Example File", url, path, None).await;
    while let Some(status) = stream.next().await {
        match status {
            Ok((progress, msg)) => println!("{:.0}% - {}", progress * 100.0, msg),
            Err(e) => eprintln!("Error: {}", e),
        }
    }
}
```

### Extract a zip archive with progress


```rust
use download_extract_progress::extract::extract_obs;
use futures_util::StreamExt;
use std::path::Path;

#[tokio::main]

async fn main() {
    let archive = Path::new("./file.zip");
    let out_dir = Path::new("./output");
    let mut stream = extract_obs(archive, out_dir).await;
    while let Some(status) = stream.next().await {
        match status {
            Ok((progress, msg)) => println!("{:.0}% - {}", progress * 100.0, msg),
            Err(e) => eprintln!("Extract error: {}", e),
        }
    }
}
```

### Download the latest GitHub release asset


```rust
use download_extract_progress::download::download_github;
use futures_util::StreamExt;

#[tokio::main]

async fn main() {
    let repo = "user/repo";
    let is_zip = |name: &str| name.ends_with(".zip");
    let path = "./latest.zip";
    let mut stream = download_github(repo, is_zip, path, None).await.unwrap();
    while let Some(status) = stream.next().await {
        match status {
            Ok((progress, msg)) => println!("{:.0}% - {}", progress * 100.0, msg),
            Err(e) => eprintln!("Error: {}", e),
        }
    }
}
```

---

## License


MIT

---

## Contributing


Pull requests and issues are welcome!

---

## Credits


- [reqwest](https://github.com/seanmonstar/reqwest)
- [tokio](https://tokio.rs/)
- [sevenz-rust](https://github.com/sile/sevenz-rust)

---

## API Docs


See [docs.rs](https://docs.rs/download-extract-progress) for full API documentation.