feat: Add basic user config reading mechanism

Author: Techassi

Cargo.lock

@@ -53,6 +53,7 @@ stackable-operator = { git = "https://github.com/stackabletech/operator-rs.git",
 tera = "1.20"
 termion = "4.0"
 tokio = { version = "1.38", features = ["rt-multi-thread", "macros", "fs", "process", "io-std"] }
+toml = { version = "0.9.8", features = ["serde"] }
 tower-http = { version = "0.5", features = ["validate-request"] }
 tracing = "0.1"
 tracing-indicatif = "0.3.9"

Cargo.nix

@@ -30,6 +30,7 @@ serde.workspace = true
 snafu.workspace = true
 tera.workspace = true
 tokio.workspace = true
+toml.workspace = true
 tracing-subscriber.workspace = true
 tracing.workspace = true
 tracing-indicatif.workspace = true

Cargo.toml

@@ -1,8 +1,8 @@
-use std::env;
+use std::{env, path::Path};
 
 use clap::{Parser, Subcommand, ValueEnum};
 use directories::ProjectDirs;
-use snafu::{ResultExt, Snafu};
+use snafu::{OptionExt, ResultExt, Snafu};
 use stackable_cockpit::{
     constants::{HELM_REPO_NAME_DEV, HELM_REPO_NAME_STABLE, HELM_REPO_NAME_TEST},
     helm,
@@ -19,6 +19,7 @@ use tracing::{Level, instrument};
 use crate::{
     args::{CommonFileArgs, CommonOperatorConfigsArgs, CommonRepoArgs},
     cmds::{cache, completions, debug, demo, operator, release, stack, stacklet},
+    config::UserConfig,
     constants::{
         DEMOS_REPOSITORY_DEMOS_SUBPATH, DEMOS_REPOSITORY_STACKS_SUBPATH, DEMOS_REPOSITORY_URL_BASE,
         ENV_KEY_DEMO_FILES, ENV_KEY_RELEASE_FILES, ENV_KEY_STACK_FILES, REMOTE_RELEASE_FILE,
@@ -55,6 +56,9 @@ pub enum Error {
 
     #[snafu(display("helm error"))]
     Helm { source: helm::Error },
+
+    #[snafu(display("failed to retrieve XDG directories"))]
+    RetrieveXdgDirectories,
 }
 
 #[derive(Debug, Parser)]
@@ -148,27 +152,29 @@ impl Cli {
         Ok(())
     }
 
-    pub fn cache_settings(&self) -> Result<Settings, CacheSettingsError> {
+    fn cache_settings(&self, cache_directory: &Path) -> Result<Settings, CacheSettingsError> {
         if self.no_cache {
             tracing::debug!("Cache disabled");
             Ok(Settings::disabled())
         } else {
-            let project_dir = ProjectDirs::from(
-                USER_DIR_QUALIFIER,
-                USER_DIR_ORGANIZATION_NAME,
-                USER_DIR_APPLICATION_NAME,
-            )
-            .ok_or(CacheSettingsError::UserDir)?;
-
-            let cache_dir = project_dir.cache_dir();
             tracing::debug!(
-                cache_dir = %cache_dir.to_string_lossy(),
+                cache_directory = %cache_directory.to_string_lossy(),
                 "Setting cache directory"
             );
-            Ok(Settings::disk(cache_dir))
+            Ok(Settings::disk(cache_directory))
         }
     }
 
+    #[allow(clippy::result_large_err)]
+    fn xdg_directories() -> Result<ProjectDirs, Error> {
+        ProjectDirs::from(
+            USER_DIR_QUALIFIER,
+            USER_DIR_ORGANIZATION_NAME,
+            USER_DIR_APPLICATION_NAME,
+        )
+        .context(RetrieveXdgDirectoriesSnafu)
+    }
+
     #[instrument(skip_all)]
     pub async fn run(&self) -> Result<String, Error> {
         // FIXME (Techassi): There might be a better way to handle this with
@@ -181,8 +187,16 @@ impl Cli {
             _ => self.add_helm_repos().context(HelmSnafu)?,
         }
 
+        let xdg_directories = Cli::xdg_directories()?;
+        let user_config_path = xdg_directories.config_dir().join("config.toml");
+
+        let _user_config = UserConfig::from_file(user_config_path)
+            .unwrap()
+            .unwrap_or_default();
+        dbg!(_user_config);
+
         let cache = self
-            .cache_settings()
+            .cache_settings(xdg_directories.cache_dir())
             .unwrap()
             .try_into_cache()
             .await

rust/stackablectl/Cargo.toml

@@ -0,0 +1,58 @@
+use std::path::{Path, PathBuf};
+
+use serde::Deserialize;
+use snafu::{ResultExt, Snafu};
+
+#[derive(Debug, Default, Deserialize)]
+pub struct UserConfig {
+    pub version: VersionOptions,
+}
+
+#[derive(Debug, Deserialize)]
+pub struct VersionOptions {
+    pub check_enabled: bool,
+}
+
+#[derive(Debug, Snafu)]
+pub enum Error {
+    #[snafu(display("failed to read config file from {path}", path = path.display()))]
+    Read {
+        source: std::io::Error,
+        path: PathBuf,
+    },
+
+    #[snafu(display("failed to deserialize config file located at {path} as TOML", path = path.display()))]
+    Deserialize {
+        source: toml::de::Error,
+        path: PathBuf,
+    },
+}
+
+impl UserConfig {
+    pub fn from_file<P>(path: P) -> Result<Option<Self>, Error>
+    where
+        P: AsRef<Path>,
+    {
+        let path = path.as_ref();
+
+        match std::fs::read_to_string(path) {
+            Ok(contents) => {
+                let config = toml::from_str(&contents).context(DeserializeSnafu { path })?;
+                Ok(Some(config))
+            }
+            Err(err) if err.kind() == std::io::ErrorKind::NotFound => Ok(None),
+            Err(err) => Err(Error::Read {
+                path: path.to_path_buf(),
+                source: err,
+            }),
+        }
+    }
+}
+
+impl Default for VersionOptions {
+    fn default() -> Self {
+        Self {
+            check_enabled: true,
+        }
+    }
+}

rust/stackablectl/src/cli/mod.rs

@@ -1,6 +1,7 @@
 pub mod args;
 pub mod cli;
 pub mod cmds;
+pub mod config;
 pub mod constants;
 pub mod output;
 pub mod utils;