Struct manic::Downloader

pub struct Downloader { /* fields omitted */ }

Implementations

impl Downloader

pub async fn new(url: &str, workers: u8) -> Result<Self>

Create a new downloader

Arguments

• url - URL of the file
• workers - amount of concurrent tasks

Examples

use manic::Downloader;
    // If only one TLS feature is enabled
    let downloader = Downloader::new("https://crates.io", 5).await?;

pub fn get_filename(url: &Url) -> Result<String>

Get filename from the url, returns an error if the url contains no filename

Arguments

• url - &str with the url

Example

use manic::Downloader;
use manic::Error;
    let url = manic::Url::parse("http://test.rs/test.zip")?;
    let name = Downloader::get_filename(&url)?;
    assert_eq!("test.zip", name);

pub fn progress_bar(&mut self) -> &mut Self

Enable progress reporting

pub fn bar_style(&self, style: ProgressStyle)

Set the progress bar style

pub fn verify(&mut self, hash: Hash) -> Self

Add a SHA checksum to verify against

Arguments

• hash - Hash to verify against

pub async fn download(&self) -> Result<Vec<u8>>

Download the file

Example

use manic::Downloader;
use manic::Error;
let client = Downloader::new("https://crates.io", 5).await?;
let result = client.download().await?;

pub async fn download_and_verify(&self) -> Result<Vec<u8>>

Download and verify the file

Example

use manic::Downloader;
use manic::Error;
let client = Downloader::new("https://crates.io", 5).await?;
let result = client.download_and_verify().await?;

pub async fn download_and_save(&self, path: &str, verify: bool) -> Result<()>

Used to download, save to a file and verify against a SHA256 sum, returns an error if the connection fails or if the sum doesn't match the one provided

Arguments

• path - path to save the file to, if it's a directory then the original filename is used
• verify - set true to verify the file against the hash

Example

use manic::Downloader;
use manic::Error;
use manic::Hash;
#[tokio::main]
async fn main() -> Result<(), Error> {
    let hash = Hash::SHA256("039058c6f2c0cb492c533b0a4d14ef77cc0f78abccced5287d84a1a2011cfb81".to_string());
    let client = Downloader::new("https://crates.io", 5).await?.verify(hash);
    client.download_and_save("~/Downloads", true).await?;
    Ok(())
 }

Trait Implementations

impl Clone for Downloader

pub fn clone(&self) -> Downloader

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Downloader

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.