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)] 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)) .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); for provider in providers { let res = self.generate(url, provider); if res.is_ok() { return res; } } Err(ProviderError::Connection) } /// 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); if let Ok(response) = req.execute(&self.client) { response .text() .map_err(|_| ProviderError::Connection) .and_then(|t| parse(&t, provider)) } else { Err(ProviderError::Connection) } } } #[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."); } }