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
152
153
154
155
156
157
158
159
160
use crate::providers::{self, parse, request, ProviderError};
use reqwest::blocking::{Client, ClientBuilder};
use std::time::Duration;
/// Url shortener: the way to retrieve a short url.
#[derive(Debug, Clone)]
pub struct UrlShortener {
client: Client,
}
impl UrlShortener {
/// Creates new `UrlShortener` with default (3 seconds) timeout.
pub fn new() -> Result<UrlShortener, reqwest::Error> {
UrlShortener::with_timeout(3)
}
/// Creates new `UrlShortener` with custom read timeout.
pub fn with_timeout(seconds: u64) -> Result<UrlShortener, reqwest::Error> {
let client = ClientBuilder::new()
.timeout(Duration::from_secs(seconds))
.tls_backend_rustls()
.build()?;
Ok(UrlShortener { client })
}
/// Try to generate a short URL from each provider, iterating over each
/// provider until a short URL is successfully generated.
/// If you wish to override the list or providers or their priority,
/// provide your own list of providers as second argument.
///
/// # Examples
///
/// ```rust,no_run
/// use urlshortener::client::UrlShortener;
///
/// let us = UrlShortener::new().unwrap();
/// let long_url = "https://rust-lang.org";
/// let _short_url = us.try_generate(long_url, None);
/// ```
///
/// ```rust,no_run
/// use urlshortener::{client::UrlShortener, providers::Provider};
///
/// let us = UrlShortener::new().unwrap();
/// let providers = [
/// Provider::GooGl { api_key: "MY_API_KEY".to_owned() },
/// Provider::IsGd,
/// ];
/// let long_url = "https://rust-lang.org";
/// let _short_url = us.try_generate(long_url, Some(&providers));
/// ```
///
/// # Errors
///
/// Returns an `Error<ProviderError>` if there is an error generating a
/// short URL from all providers.
///
/// # Notes
///
/// This function has been deprecated since it does not bring any UX improvements.
/// The body could be easily re-written as:
///
/// ```rust,no_run
/// use urlshortener::{client::UrlShortener, providers::Provider};
///
/// let us = UrlShortener::new().unwrap();
/// let providers = [
/// Provider::GooGl { api_key: "MY_API_KEY".to_owned() },
/// Provider::IsGd,
/// ];
/// let long_url = "https://rust-lang.org";
/// let mut short_url = None;
/// for provider in &providers {
/// if let Ok(short_url_res) = us.generate(long_url, provider) {
/// short_url = Some(short_url_res);
/// break;
/// }
/// }
///
/// ```
#[deprecated(since = "1.0.0", note = "Please use `generate` directly instead.")]
pub fn try_generate(
&self,
url: &str,
use_providers: Option<&[providers::Provider]>,
) -> Result<String, ProviderError> {
let providers = use_providers.unwrap_or(providers::PROVIDERS);
let mut last_error = None;
for provider in providers {
match self.generate(url, provider) {
Ok(short) => return Ok(short),
Err(e) => last_error = Some(e),
}
}
Err(last_error.expect("error is impossible to occur"))
}
/// Attempts to get a short URL using the specified provider.
///
/// # Examples
///
/// ```rust, no_run
/// use urlshortener::{providers::Provider, client::UrlShortener};
///
/// let us = UrlShortener::new().unwrap();
/// let long_url = "http://rust-lang.org";
/// let _short_url = us.generate(long_url, &Provider::IsGd);
/// ```
///
/// ```rust,no_run
/// use urlshortener::{providers::Provider, client::UrlShortener};
///
/// let us = UrlShortener::new().unwrap();
/// let api_key = "MY_API_KEY".to_owned();
/// let long_url = "http://rust-lang.org";
/// let _short_url = us.generate(long_url, &Provider::GooGl { api_key: api_key });
/// ```
pub fn generate<S: AsRef<str>>(
&self,
url: S,
provider: &providers::Provider,
) -> Result<String, ProviderError> {
let req = request(url.as_ref(), provider);
match req.execute(&self.client) {
Ok(response) => response
.text()
.map_err(ProviderError::Connection)
.and_then(|t| parse(&t, provider)),
Err(e) => Err(ProviderError::Connection(e)),
}
}
}
#[cfg(test)]
mod tests {
use crate::client;
use crate::providers;
/// This test does not cover services which require authentication for obvious reasons.
#[test]
fn providers() {
let us = client::UrlShortener::with_timeout(5).unwrap();
let url = "http://yandex.com";
let mut valid = 0;
for provider in providers::PROVIDERS {
if let Err(e) = us.generate(url, provider) {
println!("{:?} -> {:?}", provider, e);
} else {
valid += 1;
println!("{:?} -> OK", provider);
}
}
assert!(valid > 0, "There are no valid providers to use.");
}
}