Line data    Source code

       1              : //! Wrapper around `std::env::var` for parsing environment variables.
       2              : 
       3              : use std::fmt::Display;
       4              : use std::str::FromStr;
       5              : 
       6              : /// For types `V` that implement [`FromStr`].
       7         2499 : pub fn var<V, E>(varname: &str) -> Option<V>
       8         2499 : where
       9         2499 :     V: FromStr<Err = E>,
      10         2499 :     E: Display,
      11         2499 : {
      12         2499 :     match std::env::var(varname) {
      13            0 :         Ok(s) => Some(
      14            0 :             s.parse()
      15            0 :                 .map_err(|e| {
      16            0 :                     format!("failed to parse env var {varname} using FromStr::parse: {e:#}")
      17            0 :                 })
      18            0 :                 .unwrap(),
      19            0 :         ),
      20         2499 :         Err(std::env::VarError::NotPresent) => None,
      21              :         Err(std::env::VarError::NotUnicode(_)) => {
      22            0 :             panic!("env var {varname} is not unicode")
      23              :         }
      24              :     }
      25            3 : }
      26              : 
      27              : /// For types `V` that implement [`serde::de::DeserializeOwned`].
      28          192 : pub fn var_serde_json_string<V>(varname: &str) -> Option<V>
      29          192 : where
      30          192 :     V: serde::de::DeserializeOwned,
      31          192 : {
      32          192 :     match std::env::var(varname) {
      33          192 :         Ok(s) => Some({
      34          192 :             let value = serde_json::Value::String(s);
      35          192 :             serde_json::from_value(value)
      36          192 :                 .map_err(|e| {
      37            0 :                     format!("failed to parse env var {varname} as a serde_json json string: {e:#}")
      38          192 :                 })
      39          192 :                 .unwrap()
      40          192 :         }),
      41            0 :         Err(std::env::VarError::NotPresent) => None,
      42              :         Err(std::env::VarError::NotUnicode(_)) => {
      43            0 :             panic!("env var {varname} is not unicode")
      44              :         }
      45              :     }
      46            0 : }