looprs 0.4.0

Concise coding assistant REPL — core library
Documentation 
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

//! App-managed state (e.g. onboarding flags). Stored in `.looprs/state.json`.
//! User-owned config lives in `.looprs/config.json` and is never written by the app.

use serde::{Deserialize, Serialize};
use std::fs;
use std::path::Path;

const DEFAULT_STATE_PATH: &str = ".looprs/state.json";

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(default)]
pub struct AppState {
    pub onboarding: OnboardingState,
}

#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(default)]
pub struct OnboardingState {
    pub demo_seen: bool,
}

impl AppState {
    pub fn load() -> anyhow::Result<Self> {
        Self::load_at(Path::new(DEFAULT_STATE_PATH))
    }

    // qual:allow(iosp) reason: "I/O boundary — reads state file and deserializes"
    pub fn load_at(path: &Path) -> anyhow::Result<Self> {
        if !path.exists() {
            return Ok(Self::default());
        }
        let content = fs::read_to_string(path)?;
        let state: Self = serde_json::from_str(&content)?;
        Ok(state)
    }

    /// Set onboarding.demo_seen and persist to state file only (never touches config.json).
    pub fn set_onboarding_demo_seen(value: bool) -> anyhow::Result<()> {
        Self::set_onboarding_demo_seen_at(Path::new(DEFAULT_STATE_PATH), value)
    }

    pub fn set_onboarding_demo_seen_at(path: &Path, value: bool) -> anyhow::Result<()> {
        let mut state = Self::load_at(path)?;
        state.onboarding.demo_seen = value;
        let parent = path.parent().unwrap_or_else(|| Path::new("."));
        fs::create_dir_all(parent)?;
        let content = serde_json::to_string_pretty(&state)?;
        fs::write(path, content)?;
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use tempfile::TempDir;

    #[test]
    fn load_missing_returns_default() {
        let tmp = TempDir::new().unwrap();
        let path = tmp.path().join("state.json");
        let state = AppState::load_at(&path).unwrap();
        assert!(!state.onboarding.demo_seen);
    }

    #[test]
    fn set_onboarding_demo_seen_persists() {
        let tmp = TempDir::new().unwrap();
        let path = tmp.path().join("state.json");
        AppState::set_onboarding_demo_seen_at(&path, true).unwrap();
        let state = AppState::load_at(&path).unwrap();
        assert!(state.onboarding.demo_seen);
    }

    #[test]
    fn set_creates_parent_dir() {
        let tmp = TempDir::new().unwrap();
        let path = tmp.path().join("nested/.looprs/state.json");
        AppState::set_onboarding_demo_seen_at(&path, true).unwrap();
        assert!(path.exists());
        let state = AppState::load_at(&path).unwrap();
        assert!(state.onboarding.demo_seen);
    }
}