@devaloop/devalang 0.0.1-alpha.15 → 0.0.1-alpha.16

package/rust/utils/file.rs

@@ -1,35 +1,38 @@
-use std::{ fs::{ self }, path::Path };
-use include_dir::{ Dir, DirEntry };
-
-pub fn copy_dir_recursive(dir: &Dir, target_root: &Path, base_path: &Path) {
-    for entry in dir.entries() {
-        match entry {
-            DirEntry::Dir(subdir) => {
-                copy_dir_recursive(subdir, target_root, base_path);
-            }
-            DirEntry::File(file) => {
-                let rel_path = file.path().strip_prefix(base_path).unwrap();
-                let dest_path = target_root.join(rel_path);
-
-                if let Some(parent) = dest_path.parent() {
-                    fs::create_dir_all(parent).unwrap();
-                }
-
-                fs::write(&dest_path, file.contents()).expect("Error writing file");
-            }
-        }
-    }
-}
-
-pub fn format_file_size(bytes: u64) -> String {
-    const KB: u64 = 1024;
-    const MB: u64 = 1024 * 1024;
-
-    if bytes >= MB {
-        format!("{:.2} Mb", (bytes as f64) / (MB as f64))
-    } else if bytes >= KB {
-        format!("{:.2} Kb", (bytes as f64) / (KB as f64))
-    } else {
-        format!("{} bytes", bytes)
-    }
-}
+use include_dir::{Dir, DirEntry};
+use std::{
+    fs::{self},
+    path::Path,
+};
+
+pub fn copy_dir_recursive(dir: &Dir, target_root: &Path, base_path: &Path) {
+    for entry in dir.entries() {
+        match entry {
+            DirEntry::Dir(subdir) => {
+                copy_dir_recursive(subdir, target_root, base_path);
+            }
+            DirEntry::File(file) => {
+                let rel_path = file.path().strip_prefix(base_path).unwrap();
+                let dest_path = target_root.join(rel_path);
+
+                if let Some(parent) = dest_path.parent() {
+                    fs::create_dir_all(parent).unwrap();
+                }
+
+                fs::write(&dest_path, file.contents()).expect("Error writing file");
+            }
+        }
+    }
+}
+
+pub fn format_file_size(bytes: u64) -> String {
+    const KB: u64 = 1024;
+    const MB: u64 = 1024 * 1024;
+
+    if bytes >= MB {
+        format!("{:.2} Mb", (bytes as f64) / (MB as f64))
+    } else if bytes >= KB {
+        format!("{:.2} Kb", (bytes as f64) / (KB as f64))
+    } else {
+        format!("{} bytes", bytes)
+    }
+}

package/rust/utils/first_usage.rs

@@ -0,0 +1,76 @@
+use crossterm::style::{Attribute, SetAttribute};
+use std::fmt::Write;
+
+use crate::{
+    config::settings::{get_devalang_homedir, set_user_config_bool, write_user_config_file},
+    utils::signature::get_signature,
+};
+
+pub fn check_is_first_usage() {
+    if get_devalang_homedir()
+        .join("config.json")
+        .try_exists()
+        .is_ok()
+    {
+        // Do nothing
+    } else {
+        first_usage_welcome();
+        write_user_config_file();
+    }
+}
+
+pub fn first_usage_welcome() {
+    let version = env!("CARGO_PKG_VERSION");
+    print!("{}", get_signature(version));
+
+    let mut s = String::new();
+    let welcome_msg = format!(
+        "Welcome to Devalang ! \n\
+        It looks like this is your first time using the tool.\n\
+        A configuration file will be created in your home directory.\n\
+        ({})",
+        get_devalang_homedir().display()
+    );
+
+    write!(&mut s, "{}", SetAttribute(Attribute::Bold)).unwrap();
+    write!(&mut s, "{}", welcome_msg).unwrap();
+    write!(&mut s, "{}", SetAttribute(Attribute::Reset)).unwrap();
+
+    println!("");
+    println!("{}", s);
+    println!("");
+
+    first_usage_ask_for_telemetry();
+}
+
+pub fn first_usage_ask_for_telemetry() {
+    let telemetry_msg = "Would you like to enable anonymous telemetry ?";
+    let telemetry_desc = "This data helps us improve the tool. You can opt-out at any time.";
+
+    let telemetry_prompt = inquire::Confirm::new(telemetry_msg)
+        .with_help_message(telemetry_desc)
+        .with_default(false)
+        .prompt();
+
+    let telemetry_response = telemetry_prompt.unwrap_or(false);
+
+    write_user_config_file();
+
+    if telemetry_response == true {
+        println!("");
+        println!(
+            "Telemetry enabled. You can opt-out at any time by using 'devalang telemetry disable'"
+        );
+        println!("");
+
+        set_user_config_bool("telemetry", true);
+    } else {
+        println!("");
+        println!(
+            "Telemetry disabled. You can enable it at any time by using 'devalang telemetry enable'"
+        );
+        println!("");
+
+        set_user_config_bool("telemetry", false);
+    }
+}

package/rust/utils/logger.rs

@@ -1,143 +1,195 @@
-#[cfg(feature = "cli")]
-use crossterm::style::{Attribute, Color, ResetColor, SetAttribute, SetForegroundColor};
-use std::fmt::Write;
-
-#[derive(Debug, Clone, PartialEq)]
-pub enum LogLevel {
-    Success,
-    Error,
-    Info,
-    Print,
-    Warning,
-    Watcher,
-    Debug,
-}
-
-#[derive(Debug, Clone)]
-pub struct Logger;
-
-impl Logger {
-    pub fn new() -> Self {
-        Logger
-    }
-
-    // --- log_message ---
-
-    #[cfg(feature = "cli")]
-    pub fn log_message(&self, level: LogLevel, message: &str) {
-        let formatted_status = self.format_status(level);
-        println!("🦊 {} {} {}", self.language_signature(), formatted_status, message);
-    }
-
-    #[cfg(not(feature = "cli"))]
-    pub fn log_message(&self, _level: LogLevel, _message: &str) {
-        // no-op for WASM
-    }
-
-    // --- log_message_with_trace ---
-
-    #[cfg(feature = "cli")]
-    pub fn log_message_with_trace(&self, level: LogLevel, message: &str, trace: Vec<&str>) {
-        let formatted_status = self.format_status(level);
-        println!("🦊 {} {} {}", self.language_signature(), formatted_status, message);
-        for t in trace {
-            println!("     ↳ {}", t);
-        }
-    }
-
-    #[cfg(not(feature = "cli"))]
-    pub fn log_message_with_trace(&self, _level: LogLevel, _message: &str, _trace: Vec<&str>) {
-        // no-op for WASM
-    }
-
-    // --- log_error_with_stacktrace ---
-
-    #[cfg(feature = "cli")]
-    pub fn log_error_with_stacktrace(&self, message: &str, stacktrace: &str) {
-        let formatted_status = self.format_status(LogLevel::Error);
-        println!("🦊 {} {} {}", self.language_signature(), formatted_status, message);
-        println!("     ↳ {}", stacktrace);
-    }
-
-    #[cfg(not(feature = "cli"))]
-    pub fn log_error_with_stacktrace(&self, _message: &str, _stacktrace: &str) {
-        // no-op for WASM
-    }
-
-    // --- language_signature ---
-
-    #[cfg(feature = "cli")]
-    fn language_signature(&self) -> String {
-        let mut s = String::new();
-
-        write!(&mut s, "{}", SetForegroundColor(Color::Grey)).unwrap();
-        s.push('[');
-
-        write!(&mut s, "{}", SetForegroundColor(Color::Rgb { r: 29, g: 211, b: 176 })).unwrap();
-        write!(&mut s, "{}", SetAttribute(Attribute::Bold)).unwrap();
-        s.push_str("Devalang");
-        write!(&mut s, "{}", SetAttribute(Attribute::Reset)).unwrap();
-
-        write!(&mut s, "{}", SetForegroundColor(Color::Grey)).unwrap();
-        s.push(']');
-        write!(&mut s, "{}", ResetColor).unwrap();
-
-        s
-    }
-
-    #[cfg(not(feature = "cli"))]
-    fn language_signature(&self) -> String {
-        "[Devalang]".to_string()
-    }
-
-    // --- format_status ---
-
-    #[cfg(feature = "cli")]
-    fn format_status(&self, level: LogLevel) -> String {
-        let mut s = String::new();
-
-        let color = match level {
-            LogLevel::Success => Color::Rgb { r: 76, g: 175, b: 80 },
-            LogLevel::Error => Color::Rgb { r: 244, g: 67, b: 54 },
-            LogLevel::Info => Color::Rgb { r: 33, g: 150, b: 243 },
-            LogLevel::Warning => Color::Rgb { r: 255, g: 152, b: 0 },
-            LogLevel::Watcher => Color::Rgb { r: 156, g: 39, b: 176 },
-            LogLevel::Debug => Color::Rgb { r: 103, g: 58, b: 183 },
-            LogLevel::Print => Color::Rgb { r: 255, g: 255, b: 255 },
-        };
-
-        let status = match level {
-            LogLevel::Success => "SUCCESS",
-            LogLevel::Error => "ERROR",
-            LogLevel::Info => "INFO",
-            LogLevel::Warning => "WARNING",
-            LogLevel::Watcher => "WATCHER",
-            LogLevel::Debug => "DEBUG",
-            LogLevel::Print => "PRINT",
-        };
-
-        s.push('[');
-        write!(&mut s, "{}", SetForegroundColor(color)).unwrap();
-        write!(&mut s, "{}", SetAttribute(Attribute::Bold)).unwrap();
-        s.push_str(status);
-        write!(&mut s, "{}", SetAttribute(Attribute::Reset)).unwrap();
-        s.push(']');
-        write!(&mut s, "{}", ResetColor).unwrap();
-
-        s
-    }
-
-    #[cfg(not(feature = "cli"))]
-    fn format_status(&self, level: LogLevel) -> String {
-        match level {
-            LogLevel::Success => "[SUCCESS]",
-            LogLevel::Error => "[ERROR]",
-            LogLevel::Info => "[INFO]",
-            LogLevel::Warning => "[WARNING]",
-            LogLevel::Watcher => "[WATCHER]",
-            LogLevel::Debug => "[DEBUG]",
-            LogLevel::Print => "[PRINT]",
-        }
-        .to_string()
-    }
-}
+#[cfg(feature = "cli")]
+use crossterm::style::{Attribute, Color, ResetColor, SetAttribute, SetForegroundColor};
+use std::fmt::Write;
+
+#[derive(Debug, Clone, PartialEq)]
+pub enum LogLevel {
+    Success,
+    Error,
+    Info,
+    Print,
+    Warning,
+    Watcher,
+    Debug,
+}
+
+#[derive(Debug, Clone)]
+pub struct Logger;
+
+impl Logger {
+    pub fn new() -> Self {
+        Logger
+    }
+
+    // --- log_message ---
+
+    #[cfg(feature = "cli")]
+    pub fn log_message(&self, level: LogLevel, message: &str) {
+        let formatted_status = self.format_status(level);
+        println!(
+            "🦊 {} {} {}",
+            self.language_signature(),
+            formatted_status,
+            message
+        );
+    }
+
+    #[cfg(not(feature = "cli"))]
+    pub fn log_message(&self, _level: LogLevel, _message: &str) {
+        // no-op for WASM
+    }
+
+    // --- log_message_with_trace ---
+
+    #[cfg(feature = "cli")]
+    pub fn log_message_with_trace(&self, level: LogLevel, message: &str, trace: Vec<&str>) {
+        let formatted_status = self.format_status(level);
+        println!(
+            "🦊 {} {} {}",
+            self.language_signature(),
+            formatted_status,
+            message
+        );
+        for t in trace {
+            println!("     ↳ {}", t);
+        }
+    }
+
+    #[cfg(not(feature = "cli"))]
+    pub fn log_message_with_trace(&self, _level: LogLevel, _message: &str, _trace: Vec<&str>) {
+        // no-op for WASM
+    }
+
+    // --- log_error_with_stacktrace ---
+
+    #[cfg(feature = "cli")]
+    pub fn log_error_with_stacktrace(&self, message: &str, stacktrace: &str) {
+        let formatted_status = self.format_status(LogLevel::Error);
+        println!(
+            "🦊 {} {} {}",
+            self.language_signature(),
+            formatted_status,
+            message
+        );
+        println!("     ↳ {}", stacktrace);
+    }
+
+    #[cfg(not(feature = "cli"))]
+    pub fn log_error_with_stacktrace(&self, _message: &str, _stacktrace: &str) {
+        // no-op for WASM
+    }
+
+    // --- language_signature ---
+
+    #[cfg(feature = "cli")]
+    fn language_signature(&self) -> String {
+        let mut s = String::new();
+
+        write!(&mut s, "{}", SetForegroundColor(Color::Grey)).unwrap();
+        s.push('[');
+
+        write!(
+            &mut s,
+            "{}",
+            SetForegroundColor(Color::Rgb {
+                r: 29,
+                g: 211,
+                b: 176
+            })
+        )
+        .unwrap();
+        write!(&mut s, "{}", SetAttribute(Attribute::Bold)).unwrap();
+        s.push_str("Devalang");
+        write!(&mut s, "{}", SetAttribute(Attribute::Reset)).unwrap();
+
+        write!(&mut s, "{}", SetForegroundColor(Color::Grey)).unwrap();
+        s.push(']');
+        write!(&mut s, "{}", ResetColor).unwrap();
+
+        s
+    }
+
+    #[cfg(not(feature = "cli"))]
+    fn language_signature(&self) -> String {
+        "[Devalang]".to_string()
+    }
+
+    // --- format_status ---
+
+    #[cfg(feature = "cli")]
+    fn format_status(&self, level: LogLevel) -> String {
+        let mut s = String::new();
+
+        let color = match level {
+            LogLevel::Success => Color::Rgb {
+                r: 76,
+                g: 175,
+                b: 80,
+            },
+            LogLevel::Error => Color::Rgb {
+                r: 244,
+                g: 67,
+                b: 54,
+            },
+            LogLevel::Info => Color::Rgb {
+                r: 33,
+                g: 150,
+                b: 243,
+            },
+            LogLevel::Warning => Color::Rgb {
+                r: 255,
+                g: 152,
+                b: 0,
+            },
+            LogLevel::Watcher => Color::Rgb {
+                r: 156,
+                g: 39,
+                b: 176,
+            },
+            LogLevel::Debug => Color::Rgb {
+                r: 103,
+                g: 58,
+                b: 183,
+            },
+            LogLevel::Print => Color::Rgb {
+                r: 255,
+                g: 255,
+                b: 255,
+            },
+        };
+
+        let status = match level {
+            LogLevel::Success => "SUCCESS",
+            LogLevel::Error => "ERROR",
+            LogLevel::Info => "INFO",
+            LogLevel::Warning => "WARNING",
+            LogLevel::Watcher => "WATCHER",
+            LogLevel::Debug => "DEBUG",
+            LogLevel::Print => "PRINT",
+        };
+
+        s.push('[');
+        write!(&mut s, "{}", SetForegroundColor(color)).unwrap();
+        write!(&mut s, "{}", SetAttribute(Attribute::Bold)).unwrap();
+        s.push_str(status);
+        write!(&mut s, "{}", SetAttribute(Attribute::Reset)).unwrap();
+        s.push(']');
+        write!(&mut s, "{}", ResetColor).unwrap();
+
+        s
+    }
+
+    #[cfg(not(feature = "cli"))]
+    fn format_status(&self, level: LogLevel) -> String {
+        match level {
+            LogLevel::Success => "[SUCCESS]",
+            LogLevel::Error => "[ERROR]",
+            LogLevel::Info => "[INFO]",
+            LogLevel::Warning => "[WARNING]",
+            LogLevel::Watcher => "[WATCHER]",
+            LogLevel::Debug => "[DEBUG]",
+            LogLevel::Print => "[PRINT]",
+        }
+        .to_string()
+    }
+}

package/rust/utils/mod.rs

@@ -1,7 +1,9 @@
-pub mod version;
-pub mod signature;
-pub mod spinner;
-pub mod watcher;
-pub mod file;
-pub mod logger;
-pub mod error;
+pub mod error;
+pub mod file;
+pub mod first_usage;
+pub mod logger;
+pub mod signature;
+pub mod spinner;
+pub mod telemetry;
+pub mod version;
+pub mod watcher;

package/rust/utils/signature.rs

@@ -1,17 +1,19 @@
-pub fn get_signature(version: &str) -> String {
-    let signature =
-        format!(r#"
-   /|_/|                    
-  / ^ ^(_o                  🦊 Devalang
- /    __.'                  
- /     \                    A programming language for music and sound.
-/  _   \_                   Part of Devaloop project.
-(_) (_) '._                 
-  '.__     '. .-''-'.       https://devaloop.com
-     ( '.   ('.____.''
-     _) )'_, )              v{}
-    (__/ (__/
-"#, version);
-
-    signature
-}
+pub fn get_signature(version: &str) -> String {
+    let signature = format!(
+        r#"
+   /|_/|                    
+  / ^ ^(_o                  🦊 Devalang
+ /    __.'                  
+ /     \                    A programming language for music and sound.
+/  _   \_                   Part of the Devaloop project.
+(_) (_) '._                 
+  '.__     '. .-''-'.       https://devalang.com
+     ( '.   ('.____.''
+     _) )'_, )              v{}
+    (__/ (__/
+"#,
+        version
+    );
+
+    signature
+}

package/rust/utils/spinner.rs

@@ -1,19 +1,22 @@
-#[cfg(feature = "cli")]
-use indicatif::{ ProgressBar, ProgressStyle };
-use std::{ time::Duration };
-
-#[cfg(feature = "cli")]
-pub fn with_spinner<T, F>(start_msg: &str, f: F) -> ProgressBar where F: FnOnce() -> T {
-    let spinner = ProgressBar::new_spinner();
-    spinner.set_style(
-        ProgressStyle::with_template("{spinner:.green} {msg}")
-            .unwrap()
-            .tick_strings(&["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"])
-    );
-    spinner.set_message(start_msg.to_string());
-    spinner.enable_steady_tick(Duration::from_millis(80));
-
-    let _ = f();
-
-    spinner
-}
+#[cfg(feature = "cli")]
+use indicatif::{ProgressBar, ProgressStyle};
+use std::time::Duration;
+
+#[cfg(feature = "cli")]
+pub fn with_spinner<T, F>(start_msg: &str, f: F) -> ProgressBar
+where
+    F: FnOnce() -> T,
+{
+    let spinner = ProgressBar::new_spinner();
+    spinner.set_style(
+        ProgressStyle::with_template("{spinner:.green} {msg}")
+            .unwrap()
+            .tick_strings(&["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]),
+    );
+    spinner.set_message(start_msg.to_string());
+    spinner.enable_steady_tick(Duration::from_millis(80));
+
+    let _ = f();
+
+    spinner
+}