caesura 0.19.0

An all-in-one command line tool to **transcode FLAC** audio files and **upload to gazelle** based indexers/trackers.
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use colored::Colorize;
use di::{injectable, Ref};
use log::*;
use reqwest::{Client, Response};
use serde::de::DeserializeOwned;
use std::time::{Duration, SystemTime};
use tower::limit::RateLimit;
use tower::ServiceExt;

use crate::api::{ApiFactory, UploadForm, UploadResponse};
use crate::api::{ApiResponse, GroupResponse, TorrentResponse};
use crate::errors::AppError;

/// API client
///
/// Created by an [`ApiFactory`]
pub struct Api {
    pub api_url: String,
    pub client: RateLimit<Client>,
}

#[injectable]
impl Api {
    #[must_use]
    pub fn new(factory: Ref<ApiFactory>) -> Self {
        factory.create()
    }

    /// Get a torrent by id
    ///
    /// A torrent is a specific encoding of a release (album, EP, single, etc.).
    ///
    /// # See Also
    /// - <https://github.com/OPSnet/Gazelle/blob/master/docs/07-API.md#torrent>
    pub async fn get_torrent(&mut self, id: i64) -> Result<TorrentResponse, AppError> {
        let url = format!("{}/ajax.php?action=torrent&id={}", self.api_url, id);
        let response = self.get(&url, "get torrent").await?;
        self.deserialize(response, "get torrent response").await
    }

    /// Get a torrent group by id
    ///
    /// A torrent group is a collection of different encodings of
    /// a release (album, EP, single, etc.).
    ///
    /// # See Also
    /// - <https://github.com/OPSnet/Gazelle/blob/master/docs/07-API.md#torrent-group>
    pub async fn get_torrent_group(&mut self, id: i64) -> Result<GroupResponse, AppError> {
        let url = format!("{}/ajax.php?action=torrentgroup&id={}", self.api_url, id);
        let response = self.get(&url, "get torrent group").await?;
        self.deserialize(response, "get torrent group response")
            .await
    }

    /// Get the content of the .torrent file as a buffer
    ///
    /// # See Also
    /// - <https://github.com/OPSnet/Gazelle/blob/master/docs/07-API.md#download>
    pub async fn get_torrent_file_as_buffer(&mut self, id: i64) -> Result<Vec<u8>, AppError> {
        let url = format!("{}/ajax.php?action=download&id={}", self.api_url, id);
        let response = self.get(&url, "get torrent file").await?;
        let status_code = response.status();
        if status_code.is_success() {
            let bytes = response
                .bytes()
                .await
                .expect("Response should not be empty");
            let buffer = bytes.to_vec();
            Ok(buffer)
        } else {
            AppError::response(status_code, "get torrent file")
        }
    }

    /// Upload the torrent
    ///
    /// # See Also
    ///  - <https://github.com/OPSnet/Gazelle/blob/master/docs/07-API.md#upload>
    pub async fn upload_torrent(&mut self, upload: UploadForm) -> Result<UploadResponse, AppError> {
        let url = format!("{}/ajax.php?action=upload", self.api_url);
        let form = upload.to_form()?;
        let client = self.wait_for_client().await;
        let result = client.post(&url).multipart(form).send().await;
        trace!("{} POST request: {}", "Sent".bold(), &url);
        let response = result.or_else(|e| AppError::request(e, "post upload"))?;
        self.deserialize(response, "upload torrent response").await
    }

    async fn get(&mut self, url: &String, action: &str) -> Result<Response, AppError> {
        trace!("{} request GET {}", "Sending".bold(), &url);
        let client = self.wait_for_client().await;
        let start = SystemTime::now();
        let result = client.get(url).send().await;
        let elapsed = start
            .elapsed()
            .expect("elapsed should not fail")
            .as_secs_f64();
        trace!("{} response after {elapsed:.3}", "Received".bold());
        result.or_else(|e| AppError::request(e, action))
    }

    async fn deserialize<T: DeserializeOwned>(
        &mut self,
        response: Response,
        action: &str,
    ) -> Result<T, AppError> {
        let status_code = response.status();
        let json = response.text().await.unwrap_or_default();
        let deserialized = serde_json::from_str::<ApiResponse<T>>(json.as_str())
            .or_else(|e| AppError::json(e, format!("deserialize {action}").as_str()));
        if status_code.is_success() {
            let deserialized = deserialized?;
            if deserialized.status == "success" {
                Ok(deserialized.response.expect("response should be set"))
            } else {
                AppError::explained(action, format!("{deserialized}"))
            }
        } else {
            let message = if let Ok(response) = deserialized {
                response.error.unwrap_or(json)
            } else {
                json
            };
            Err(AppError {
                action: action.to_owned(),
                message,
                status_code: Some(status_code.as_u16()),
                ..AppError::default()
            })
        }
    }

    async fn wait_for_client(&mut self) -> &Client {
        let start = SystemTime::now();
        let client = self
            .client
            .ready()
            .await
            .expect("client should be available")
            .get_ref();
        let duration = start.elapsed().expect("duration should not fail");
        if duration > Duration::from_millis(200) {
            trace!(
                "{} {:.3} for rate limiter",
                "Waited".bold(),
                duration.as_secs_f64()
            );
        }
        client
    }
}