devalang 0.2.0

Write music with code. Devalang is a domain-specific language (DSL) for sound designers and music hackers. Compose, automate, and control sound — in plain text.
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

#![cfg(feature = "cli")]

use anyhow::Result;
use serde::{Deserialize, Serialize};
use std::fs;
use std::io::Write;
use std::path::PathBuf;

/// Devalang user configuration
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct UserConfig {
    /// Session token for authentication
    pub session: String,
    /// Telemetry configuration
    #[serde(default)]
    pub telemetry: TelemetryConfig,
}

/// Telemetry configuration
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TelemetryConfig {
    /// User's unique UUID
    pub uuid: String,
    /// Telemetry enabled or not
    pub enabled: bool,
    /// Telemetry level
    pub level: String,
    /// Statistics enabled or not
    pub stats: bool,
}

impl Default for UserConfig {
    fn default() -> Self {
        Self {
            session: String::new(),
            telemetry: TelemetryConfig::default(),
        }
    }
}

impl Default for TelemetryConfig {
    fn default() -> Self {
        Self {
            uuid: uuid::Uuid::new_v4().to_string(),
            enabled: false,
            level: "basic".to_string(),
            stats: false,
        }
    }
}

/// Gets the user's home directory
pub fn get_home_dir() -> Option<PathBuf> {
    dirs::home_dir()
}

/// Gets the Devalang configuration directory
pub fn get_devalang_homedir() -> PathBuf {
    if let Some(home_dir) = get_home_dir() {
        home_dir.join(".devalang")
    } else {
        PathBuf::from("~/.devalang")
    }
}

/// Gets the path to the user configuration file
pub fn get_user_config_path() -> PathBuf {
    get_devalang_homedir().join("config.json")
}

/// Loads the user configuration
pub fn get_user_config() -> Option<UserConfig> {
    let config_path = get_user_config_path();

    if !config_path.exists() {
        return None;
    }

    let file = fs::File::open(config_path).ok()?;
    serde_json::from_reader(file).ok()
}

/// Saves the user configuration
pub fn write_user_config(config: &UserConfig) -> Result<()> {
    let config_path = get_user_config_path();

    // Create parent directory if necessary
    if let Some(parent) = config_path.parent() {
        fs::create_dir_all(parent)?;
    }

    // Atomic write via temporary file
    let tmp_path = config_path.with_extension("json.tmp");
    let config_json = serde_json::to_string_pretty(config)?;

    let mut tmp_file = fs::File::create(&tmp_path)?;
    tmp_file.write_all(config_json.as_bytes())?;
    tmp_file.sync_all()?;

    fs::rename(&tmp_path, config_path)?;

    Ok(())
}

/// Ensures the configuration file exists
pub fn ensure_user_config_exists() -> Result<()> {
    let config_path = get_user_config_path();

    if !config_path.exists() {
        let config = UserConfig::default();
        write_user_config(&config)?;
    }

    Ok(())
}

/// Updates the session token
pub fn set_session_token(token: String) -> Result<()> {
    let mut config = get_user_config().unwrap_or_default();
    config.session = token;
    write_user_config(&config)?;
    Ok(())
}

/// Gets the session token
pub fn get_session_token() -> Option<String> {
    get_user_config().and_then(|cfg| {
        let token = cfg.session.trim();
        if token.is_empty() {
            None
        } else {
            Some(token.to_string())
        }
    })
}

/// Removes the session token (logout)
pub fn clear_session_token() -> Result<()> {
    let mut config = get_user_config().unwrap_or_default();
    config.session = String::new();
    write_user_config(&config)?;
    Ok(())
}