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

//! App configuration for the library

use std::env;

use log::warn;

use crate::http::client::HttpClientConfiguration;

use super::Environment;

const DEFAULT_BASE_URI: &str = "/v2";
pub(crate) const DEFAULT_SQUARE_VERSION: &str = "2022-02-16";

/// Configuration struct for the library
#[derive(Clone, Debug)]
pub struct Configuration {
    /// Current API environment
    pub environment: Environment,
    /// Square connect API versions.
    pub square_version: String,
    /// Http Client Configuration instance.
    pub http_client_config: HttpClientConfiguration,
    /// OAuth 2.0 Access Token, if this isn't provided during initialization, environment
    /// variable SQUARE_API_TOKEN is checked. Failure to provide an API token by one of
    /// these methods will result in unauthorized requests
    pub access_token: String,
    /// Base URI
    pub base_uri: String,
}

impl Configuration {
    /// Gets the base Square API URL for the configured environment, including the API version
    /// specifier (e.g. "/v2")
    pub(crate) fn get_base_url(&self) -> String {
        let base_url = self.environment.get_base_url();
        format!("{}{}", base_url, self.base_uri)
    }
}

/// The default authorization header is a Bearer token found in the `SQUARE_API_TOKEN`
/// environment variable
pub(crate) fn default_authorization() -> String {
    format!(
        "Bearer {}",
        env::var("SQUARE_API_TOKEN").unwrap_or_else(|_| {
            warn!("No SQUARE_API_TOKEN environment variable found");
            String::new()
        })
    )
}

impl Default for Configuration {
    fn default() -> Self {
        Self {
            environment: Default::default(),
            square_version: DEFAULT_SQUARE_VERSION.to_owned(),
            http_client_config: Default::default(),
            access_token: default_authorization(),
            base_uri: DEFAULT_BASE_URI.to_owned(),
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::config::{Configuration, Environment};

    #[test]
    fn get_base_url_default_url() {
        let configuration = Configuration::default();
        assert_eq!(
            "https://connect.squareupsandbox.com/v2",
            configuration.get_base_url()
        );
    }

    #[test]
    fn get_base_url_for_custom_url() {
        let mut configuration = Configuration::default();
        configuration.environment = Environment::Custom(String::from("some_custom_url"));
        assert_eq!("some_custom_url/v2", configuration.get_base_url());
    }

    #[test]
    fn get_base_url_with_different_base_uri() {
        let mut configuration = Configuration::default();
        configuration.base_uri = String::from("/custom_base_uri");
        assert_eq!(
            "https://connect.squareupsandbox.com/custom_base_uri",
            configuration.get_base_url()
        );
    }
}