Merge branch 'master' into compiler

1 files changed, 39 insertions, 0 deletions

diff --git a/crates/sloth_vm/src/sloth_std/misc.rs b/crates/sloth_vm/src/sloth_std/misc.rs
new file mode 100644
index 0000000..ca08d1d
--- /dev/null
+++ b/crates/sloth_vm/src/sloth_std/misc.rs
@@ -0,0 +1,39 @@
+use crate::native::{self, NativeFunction, NativeFunctionResult};
+use crate::value::{Object, ObjectType, Primitive};
+use crate::VM;
+
+fn get_doc(vm: &mut VM, args: &[Primitive]) -> NativeFunctionResult {
+    let Some(Primitive::Object(ptr)) = args.get(0).cloned() else {
+        return Err(native::Error::InvalidArgument);
+    };
+
+    let object = vm
+        .objects()
+        .get(ptr as usize)
+        .ok_or(native::Error::InvalidArgument)?;
+
+    let ObjectType::NativeFunction(fnc) = &object.typ else {
+        return Err(native::Error::InvalidArgument);
+    };
+
+    let docs = fnc
+        .doc
+        .expect("Oopsie Poopsie the stringy no worky")
+        .to_string();
+    let object = Object::new(ObjectType::String(docs));
+    let ptr = vm.objects_mut().allocate(object);
+
+    Ok(Primitive::Object(ptr as u32))
+}
+
+pub const DOCS: NativeFunction = NativeFunction {
+    name: "docs",
+    function: get_doc,
+    arity: 1,
+    returns_value: true,
+    doc: Some(
+        "NativeFunction docs: \n\targs: name (str)\n\tdesc: Returns documentaiton on a function \
+         with name <str>\n\tExample: `var doc = docs('wait'); # Returns the documentation of the \
+         'wait' function to doc`",
+    ),
+};