feat: add built-in 'getattr' function

argon/vm/mod/builtins.cpp

@@ -113,6 +113,41 @@ ARGON_FUNCTION(builtins_eval, eval,
     return (ArObject *) result;
 }
 
+ARGON_FUNCTION(builtins_getattr, getattr,
+               "Access object attributes dynamically by providing the object and the attribute name as arguments.\n"
+               "\n"
+               "- Parameters:\n"
+               "  - obj: The object from which to retrieve the attribute.\n"
+               "  - name: A string representing the name of the attribute you want to access.\n"
+               "- KWParameters:\n"
+               "  - default: A default value to return if the attribute does not exist.\n"
+               "- Returns: If the attribute exists within the object, its value is returned, "
+               "otherwise the default value if defined is returned.\n",
+               ": obj, s: name", false, true) {
+    bool _static = false;
+
+    if (AR_GET_TYPE(*args) == type_type_)
+        _static = true;
+
+    auto *res = AttributeLoad(*args, args[1], _static);
+    if (res == nullptr) {
+        ArObject *def = nullptr;
+
+        if (kwargs != nullptr) {
+            def = DictLookup((Dict *) kwargs, "default");
+            if (def == nullptr && argon::vm::IsPanicking())
+                return nullptr;
+        }
+
+        if (def != nullptr)
+            argon::vm::DiscardLastPanic();
+
+        return def;
+    }
+
+    return res;
+}
+
 ARGON_FUNCTION(builtins_iscallable, iscallable,
                "Return true if argument appears callable, false otherwise.\n"
                "\n"
@@ -279,6 +314,7 @@ const ModuleEntry builtins_entries[] = {
         MODULE_EXPORT_FUNCTION(builtins_bind),
         MODULE_EXPORT_FUNCTION(builtins_exit),
         MODULE_EXPORT_FUNCTION(builtins_eval),
+        MODULE_EXPORT_FUNCTION(builtins_getattr),
         MODULE_EXPORT_FUNCTION(builtins_iscallable),
         MODULE_EXPORT_FUNCTION(builtins_implements),
         MODULE_EXPORT_FUNCTION(builtins_len),