magnetease 0.1.4

A library to fetch magnets from the internet
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

//! Magnetease is a library that fetches `Magnet`s from different sources.
//!
//! You can construct [Magnetease] with [Provider]s that you want to search.
//! Examples
//! ```
//! # tokio_test::block_on(async {
//! use magnetease::Magnetease;
//! let magnetease = Magnetease::new();
//! let magnets = magnetease.search("Ubuntu Pro").await;
//! # });
//! ```

mod magnetease;
/// Providers that you can search invidually or within [Magnetease]
pub mod providers;

use async_trait::async_trait;
pub use magnetease::Magnetease;
use reqwest::Client;
use thiserror::Error;

/// Holds the magnet itself in `url` and some metadata along with it.
#[derive(Clone, Debug)]
pub struct Magnet {
    /// The title associated with the magnet link.
    pub title: String,
    /// The URL of the magnet
    pub url: String,
    /// The number of seeders
    pub seeders: u32,
    /// The size of the content in bytes.
    pub bytes: u64,
}

#[derive(Error, Debug)]
pub enum MagneteaseError {
    #[error(transparent)]
    ConnectionError(#[from] reqwest::Error),
}

#[async_trait]
pub trait Provider {
    async fn search(&self, client: &Client, query: &str) -> Result<Vec<Magnet>, MagneteaseError>;
}