Skip to main content

elemental_driver/
url.rs

1use std::{fmt::Debug, hash::Hash};
2
3use crate::error::Result;
4
5mod known;
6mod policy;
7mod rewrite;
8#[cfg(test)]
9mod tests;
10mod util;
11
12pub use policy::OriginPolicy;
13pub(crate) use util::{require_http_scheme, with_directory_path};
14
15pub trait Origin: Copy + Debug + Eq + Hash + Send + Sync + 'static {
16    fn canonical(self) -> &'static str;
17    fn all() -> &'static [Self];
18}
19
20#[derive(Debug, Clone)]
21pub struct OriginEndpoints<O: Origin> {
22    origin_policy: OriginPolicy<O>,
23}
24
25impl<O: Origin> Default for OriginEndpoints<O> {
26    fn default() -> Self {
27        Self::official()
28    }
29}
30
31impl<O: Origin> OriginEndpoints<O> {
32    pub fn new(origin_policy: OriginPolicy<O>) -> Self {
33        Self { origin_policy }
34    }
35
36    pub fn official() -> Self {
37        Self::new(OriginPolicy::default())
38    }
39
40    pub fn with_overrides<const N: usize>(overrides: [(O, String); N]) -> Result<Self> {
41        let mut policy = OriginPolicy::default();
42        for (origin, raw_url) in overrides {
43            policy = policy.with_override(origin, raw_url)?;
44        }
45        Ok(Self::new(policy))
46    }
47
48    pub fn origin_policy(&self) -> &OriginPolicy<O> {
49        &self.origin_policy
50    }
51
52    pub fn resolve(&self, origin: O, path: &str) -> Result<String> {
53        self.origin_policy.resolve(origin, path)
54    }
55
56    pub fn resolve_segments<const N: usize>(
57        &self,
58        origin: O,
59        segments: [&str; N],
60    ) -> Result<String> {
61        self.origin_policy.resolve_segments(origin, segments)
62    }
63
64    pub fn rewrite_upstream(&self, raw_url: &str) -> Result<String> {
65        self.origin_policy.rewrite_origin_url(raw_url)
66    }
67
68    pub fn rewrite_known_or_keep(&self, raw_url: &str) -> Result<String> {
69        self.origin_policy.rewrite_known_origin_url_or_keep(raw_url)
70    }
71}