spars_httpd/settings/
handler.rs

1// SPDX-FileCopyrightText: 2025 Cullen Walsh <ckwalsh@cullenwalsh.com>
2// SPDX-License-Identifier: MIT OR Apache-2.0
3
4use std::path::PathBuf;
5use std::str::FromStr;
6
7pub struct HandlerSettings {
8    pub root: PathBuf,
9    pub index_file: String,
10    pub fallback_path: Option<String>,
11    pub expose_hidden: ExposeHiddenFiles,
12}
13
14#[derive(Default)]
15pub enum ExposeHiddenFiles {
16    #[default]
17    OnlyWellKnown,
18    Hide,
19    Expose,
20}
21
22impl From<&str> for ExposeHiddenFiles {
23    fn from(s: &str) -> Self {
24        if s.eq_ignore_ascii_case("hide") {
25            Self::Hide
26        } else if s.eq_ignore_ascii_case("expose") {
27            Self::Expose
28        } else if s.eq_ignore_ascii_case("wellknown") {
29            Self::OnlyWellKnown
30        } else if let Ok(expose) = bool::from_str(s) {
31            if expose { Self::Expose } else { Self::Hide }
32        } else {
33            Self::OnlyWellKnown
34        }
35    }
36}
37
38impl Default for HandlerSettings {
39    fn default() -> Self {
40        Self {
41            root: PathBuf::from("./public"),
42            index_file: "index.html".to_owned(),
43            fallback_path: Some("404.html".to_owned()),
44            expose_hidden: Default::default(),
45        }
46    }
47}
48
49type Result<T, E = super::SettingsFromEnvError> = std::result::Result<T, E>;
50
51impl HandlerSettings {
52    pub fn from_env() -> Result<Self> {
53        let mut settings = Self::default();
54
55        if let Some(s) = super::env("ROOT")? {
56            settings.root = PathBuf::from(s)
57                .canonicalize()
58                .map_err(super::SettingsFromEnvError::BadFilePath)?;
59
60            let metadata = settings
61                .root
62                .metadata()
63                .map_err(super::SettingsFromEnvError::BadFilePath)?;
64
65            if !metadata.is_dir() {
66                return Err(super::SettingsFromEnvError::RootNotADirectory);
67            }
68        }
69
70        if let Some(s) = super::env("INDEX_FILE")? {
71            settings.index_file = s;
72        }
73
74        if let Some(s) = super::env("FALLBACK_PATH")? {
75            settings.fallback_path = if s.is_empty() { None } else { Some(s) };
76        }
77
78        if let Some(s) = super::env("EXPOSE_HIDDEN")? {
79            settings.expose_hidden = s.as_str().into();
80        }
81
82        Ok(settings)
83    }
84}
spars_httpd/settings/handler.rs

spars_httpd/settings/
handler.rs
