add error.rs

src/error.rs

@@ -0,0 +1,111 @@
+use alloc::string::String;
+use wasm_bindgen::JsValue;
+
+#[derive(Debug)] // todo: get rid of this once all expects are gone
+pub struct HQError {
+    pub err_type: HQErrorType,
+    pub msg: String,
+    pub file: String,
+    pub line: u32,
+    pub column: u32,
+}
+#[derive(Debug)] // todo: get rid of this once all expects are gone
+pub enum HQErrorType {
+    MalformedProject,
+    InternalError,
+    Unimplemented,
+}
+
+impl Into<JsValue> for HQError {
+    fn into(self: Self) -> JsValue {
+        JsValue::from_str(match self.err_type {
+            HQErrorType::Unimplemented => format!("todo: {}<br>at {}:{}:{}<br>this is a bug or missing feature that is known and will be fixed or implemented in a future update", self.msg, self.file, self.line, self.column),
+            HQErrorType::InternalError => format!("error: {}<br>at {}:{}:{}<br>this is probably a bug with HyperQuark itself. Please report this bug, with this error message, at <a href=\"https://github.com/hyperquark/hyperquark/issues/new\">https://github.com/hyperquark/hyperquark/issues/new</a>", self.msg, self.file, self.line, self.column),
+            HQErrorType::MalformedProject => format!("error: {}<br>at {}:{}:{}<br>this is probably a problem with the project itself, but if it works in vanilla scratch then this is a bug; please report it, by creating an issue at <a href=\"https://github.com/hyperquark/hyperquark/issues/new\">https://github.com/hyperquark/hyperquark/issues/new</a>, including this error message", self.msg, self.file, self.line, self.column),
+        }.as_str())
+    }
+}
+
+#[macro_export]
+macro_rules! hq_todo {
+    ($($args:tt)+) => {{
+        use crate::alloc::string::ToString;
+        return Err(crate::HQError {
+            err_type: crate::HQErrorType::Unimplemented,
+            msg: format!("{}", format_args!($($args)*)),
+            file: file!().to_string(),
+            line: line!(),
+            column: column!()
+        });
+    }};
+}
+
+#[macro_export]
+macro_rules! hq_bug {
+    ($($args:tt)+) => {{
+        use crate::alloc::string::ToString;
+        return Err(crate::HQError {
+            err_type: crate::HQErrorType::InternalError,
+            msg: format!("{}", format_args!($($args)*)),
+            file: file!().to_string(),
+            line: line!(),
+            column: column!()
+        });
+    }};
+}
+
+#[macro_export]
+macro_rules! hq_bad_proj {
+    ($($args:tt)+) => {{
+        use crate::alloc::string::ToString;
+        return Err(crate::HQError {
+            err_type: crate::HQErrorType::MalformedProject,
+            msg: format!("{}", format_args!($($args)*)),
+            file: file!().to_string(),
+            line: line!(),
+            column: column!()
+        });
+    }};
+}
+
+#[macro_export]
+macro_rules! make_hq_todo {
+    ($($args:tt)+) => {{
+        use crate::alloc::string::ToString;
+        crate::HQError {
+            err_type: crate::HQErrorType::Unimplemented,
+            msg: format!("{}", format_args!($($args)*)),
+            file: file!().to_string(),
+            line: line!(),
+            column: column!()
+        }
+    }};
+}
+
+#[macro_export]
+macro_rules! make_hq_bug {
+    ($($args:tt)+) => {{
+        use crate::alloc::string::ToString;
+        crate::HQError {
+            err_type: crate::HQErrorType::InternalError,
+            msg: format!("{}", format_args!($($args)*)),
+            file: file!().to_string(),
+            line: line!(),
+            column: column!()
+        }
+    }};
+}
+
+#[macro_export]
+macro_rules! make_hq_bad_proj {
+    ($($args:tt)+) => {{
+        use crate::alloc::string::ToString;
+        crate::HQError {
+            err_type: crate::HQErrorType::MalformedProject,
+            msg: format!("{}", format_args!($($args)*)),
+            file: file!().to_string(),
+            line: line!(),
+            column: column!()
+        }
+    }};
+}