refactor: remove runtime unsound codes

kclvm/runtime/src/_kcl_run.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 #![allow(clippy::missing_safety_doc)]
 
 use std::os::raw::c_char;

kclvm/runtime/src/_kclvm.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 // Auto generated, DONOT EDIT!!!
 

kclvm/runtime/src/_kclvm_addr.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 // Auto generated, DONOT EDIT!!!
 

kclvm/runtime/src/_kclvm_api_spec.rs

@@ -1,4 +1,4 @@
-// Copyright 2023 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 // Auto generated by <make gen-api-spec> command, DONOT EDIT!!!
 

kclvm/runtime/src/_kclvm_main_win.c

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+// Copyright The KCL Authors. All rights reserved.
 
 extern void* kclvm_main(void* ctx);
 

kclvm/runtime/src/api/error.rs

@@ -0,0 +1,16 @@
+//! Copyright The KCL Authors. All rights reserved.
+
+#[derive(Copy, Clone)]
+#[allow(non_camel_case_types)]
+pub enum RuntimeErrorType {
+    EvaluationError = 1,
+    RecursiveLoad = 2,
+    FloatOverflow = 3,
+    FloatUnderflow = 4,
+    IntOverflow = 5,
+    TypeError = 6,
+    AssertionError = 7,
+    Deprecated = 8,
+    DeprecatedWarning = 9,
+    SchemaCheckFailure = 10,
+}

kclvm/runtime/src/api/kclvm.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 #[allow(non_camel_case_types)]
 type kclvm_value_ref_t = crate::ValueRef;
@@ -37,8 +37,9 @@ pub struct KclError {
 }
 
 #[allow(non_camel_case_types)]
-#[derive(Clone, PartialEq, Debug)]
+#[derive(Clone, PartialEq, Debug, Default)]
 pub enum Type {
+    #[default]
     any_type,
     bool_type,
     bool_lit_type(bool),
@@ -55,12 +56,6 @@ pub enum Type {
     func_type(FuncType),
 }
 
-impl Default for Type {
-    fn default() -> Self {
-        Type::any_type
-    }
-}
-
 #[derive(PartialEq, Clone, Default, Debug)]
 pub struct ListType {
     pub elem_type: Box<Type>,
@@ -461,19 +456,14 @@ pub enum Kind {
     Func = 18,
 }
 
-#[derive(Clone, PartialEq, Eq, Debug, Hash)]
+#[derive(Clone, PartialEq, Eq, Debug, Hash, Default)]
 pub enum ConfigEntryOperationKind {
+    #[default]
     Union = 0,
     Override = 1,
     Insert = 2,
 }
 
-impl Default for ConfigEntryOperationKind {
-    fn default() -> Self {
-        ConfigEntryOperationKind::Union
-    }
-}
-
 impl ConfigEntryOperationKind {
     pub fn from_i32(v: i32) -> Self {
         match v {

kclvm/runtime/src/api/mod.rs

@@ -1,10 +1,10 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 pub mod kclvm;
 pub use self::kclvm::*;
 
 pub mod utils;
 pub use self::utils::*;
 
-pub mod err_type;
-pub use self::err_type::*;
+pub mod error;
+pub use self::error::*;

kclvm/runtime/src/api/utils.rs

@@ -1,11 +1,12 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
-#![allow(clippy::missing_safety_doc)]
+//! Copyright The KCL Authors. All rights reserved.
 
 use std::os::raw::c_char;
 
 use crate::{Context, ValueRef};
 
 /// New a mutable raw pointer.
+/// Safety: The caller must ensure that `ctx` lives longer than the returned pointer
+/// and that the pointer is properly deallocated by calling `free_mut_ptr`.
 pub fn new_mut_ptr(ctx: &mut Context, x: ValueRef) -> *mut ValueRef {
     let ptr = Box::into_raw(Box::new(x));
     // Store the object pointer address to
@@ -15,6 +16,7 @@ pub fn new_mut_ptr(ctx: &mut Context, x: ValueRef) -> *mut ValueRef {
 }
 
 /// Free a mutable raw pointer.
+/// Safety: The caller must ensure `p` is a valid pointer obtained from `new_mut_ptr`.
 pub(crate) fn free_mut_ptr<T>(p: *mut T) {
     if !p.is_null() {
         unsafe {
@@ -24,19 +26,22 @@ pub(crate) fn free_mut_ptr<T>(p: *mut T) {
 }
 
 /// Convert a const raw pointer to a immutable borrow.
+/// Safety: The caller must ensure that `p` is valid for the lifetime `'a`.
 pub(crate) fn ptr_as_ref<'a, T>(p: *const T) -> &'a T {
     assert!(!p.is_null());
     unsafe { &*p }
 }
 
 /// Convert a mutable raw pointer to a mutable borrow.
+/// Safety: The caller must ensure that `p` is valid for the lifetime `'a`.
 pub(crate) fn mut_ptr_as_ref<'a, T>(p: *mut T) -> &'a mut T {
     assert!(!p.is_null());
 
     unsafe { &mut *p }
 }
 
 /// Convert a C str pointer to a Rust &str.
+/// Safety: The caller must ensure that `s` is a valid null-terminated C string.
 pub(crate) fn c2str<'a>(s: *const c_char) -> &'a str {
     let s = unsafe { std::ffi::CStr::from_ptr(s) }.to_str().unwrap();
     s

kclvm/runtime/src/base64/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 extern crate base64;
 use base64::{decode, encode};
@@ -21,7 +21,7 @@ pub extern "C" fn kclvm_base64_encode(
             return ValueRef::str(s.as_str()).into_raw(ctx);
         }
         _ => {
-            ctx.set_err_type(&ErrType::TypeError_Runtime_TYPE);
+            ctx.set_err_type(&RuntimeErrorType::TypeError);
 
             panic!("a bytes-like object is required, not '{}'", p.as_str());
         }
@@ -44,7 +44,7 @@ pub extern "C" fn kclvm_base64_decode(
             return ValueRef::str(std::str::from_utf8(&de_str).unwrap()).into_raw(ctx);
         }
         _ => {
-            ctx.set_err_type(&ErrType::TypeError_Runtime_TYPE);
+            ctx.set_err_type(&RuntimeErrorType::TypeError);
 
             panic!(
                 "argument should be a bytes-like object or ASCII string, not '{}'",

kclvm/runtime/src/collection/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 use crate::*;
 

kclvm/runtime/src/context/api.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 #![allow(clippy::missing_safety_doc)]
 
 use crate::*;

kclvm/runtime/src/context/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 pub mod api;
 pub use api::*;
@@ -45,7 +45,7 @@ impl PanicInfo {
             Err(_) => PanicInfo {
                 __kcl_PanicInfo__: true,
                 message: s.to_string(),
-                err_type_code: crate::ErrType::CompileError_TYPE as i32,
+                err_type_code: crate::RuntimeErrorType::EvaluationError as i32,
                 ..Default::default()
             },
         }
@@ -162,7 +162,7 @@ impl crate::Context {
         }
     }
 
-    pub fn set_err_type(&mut self, err_type: &crate::ErrType) {
+    pub fn set_err_type(&mut self, err_type: &crate::RuntimeErrorType) {
         self.panic_info.__kcl_PanicInfo__ = true;
         self.panic_info.err_type_code = *err_type as i32;
     }

kclvm/runtime/src/crypto/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 extern crate md5;
 extern crate sha1;

kclvm/runtime/src/datetime/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 extern crate chrono;
 

kclvm/runtime/src/json/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 use crate::*;
 

kclvm/runtime/src/lib.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 use kclvm_runtime_internal_macros::runtime_fn;
 

kclvm/runtime/src/manifests/mod.rs

@@ -51,7 +51,7 @@ type kclvm_value_ref_t = ValueRef;
 /// TODO: more options on the function `yaml_stream`.
 #[no_mangle]
 #[runtime_fn]
-pub unsafe extern "C" fn kclvm_manifests_yaml_stream(
+pub extern "C" fn kclvm_manifests_yaml_stream(
     ctx: *mut kclvm_context_t,
     args: *const kclvm_value_ref_t,
     kwargs: *const kclvm_value_ref_t,

kclvm/runtime/src/manifests/tests.rs

@@ -76,9 +76,7 @@ fn test_kclvm_manifests_yaml_stream() {
             ConfigEntryOperationKind::Override,
             -1,
         );
-        unsafe {
-            kclvm_manifests_yaml_stream(&mut ctx, &args, &kwargs);
-        }
+        kclvm_manifests_yaml_stream(&mut ctx, &args, &kwargs);
         assert_eq!(
             Some(yaml_str.to_string()),
             ctx.buffer.custom_manifests_output
@@ -97,9 +95,7 @@ fn test_kclvm_manifests_yaml_stream_invalid() {
             let mut ctx = Context::new();
             let args = ValueRef::list(None).into_raw(&mut ctx);
             let kwargs = ValueRef::dict(None).into_raw(&mut ctx);
-            unsafe {
-                kclvm_manifests_yaml_stream(ctx.into_raw(), args, kwargs);
-            }
+            kclvm_manifests_yaml_stream(ctx.into_raw(), args, kwargs);
         },
     );
     assert_panic(
@@ -109,9 +105,7 @@ fn test_kclvm_manifests_yaml_stream_invalid() {
             let args = ValueRef::list(None).into_raw(&mut ctx);
             let kwargs = ValueRef::dict(Some(&[("opts", &ValueRef::str("invalid_kwarg"))]))
                 .into_raw(&mut ctx);
-            unsafe {
-                kclvm_manifests_yaml_stream(ctx.into_raw(), args, kwargs);
-            }
+            kclvm_manifests_yaml_stream(ctx.into_raw(), args, kwargs);
         },
     );
     assert_panic(
@@ -120,9 +114,7 @@ fn test_kclvm_manifests_yaml_stream_invalid() {
             let mut ctx = Context::new();
             let args = ValueRef::list(None).into_raw(&mut ctx);
             let kwargs = ValueRef::dict(Some(&[("opts", &ValueRef::none())])).into_raw(&mut ctx);
-            unsafe {
-                kclvm_manifests_yaml_stream(ctx.into_raw(), args, kwargs);
-            }
+            kclvm_manifests_yaml_stream(ctx.into_raw(), args, kwargs);
         },
     );
     std::panic::set_hook(prev_hook);

kclvm/runtime/src/math/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 extern crate num_integer;
 

kclvm/runtime/src/net/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 use std::net::Ipv4Addr;
 use std::net::Ipv6Addr;
@@ -171,17 +171,14 @@ pub extern "C" fn kclvm_net_is_IP(
     let args = ptr_as_ref(args);
 
     if let Some(ip) = args.arg_i_str(0, None) {
-        if let Ok(..) = Ipv4Addr::from_str(ip.as_ref()) {
-            return kclvm_value_True(ctx);
-        }
-        if let Ok(..) = Ipv6Addr::from_str(ip.as_ref()) {
-            return kclvm_value_True(ctx);
+        if Ipv4Addr::from_str(ip.as_ref()).is_ok() || Ipv6Addr::from_str(ip.as_ref()).is_ok() {
+            kclvm_value_True(ctx)
+        } else {
+            kclvm_value_False(ctx)
         }
-
-        return kclvm_value_False(ctx);
+    } else {
+        panic!("is_IP() missing 1 required positional argument: 'ip'");
     }
-
-    panic!("is_IP() missing 1 required positional argument: 'ip'");
 }
 
 // is_loopback_IP(ip: str) -> bool

kclvm/runtime/src/regex/mod.rs

@@ -1,4 +1,4 @@
-// Copyright 2021 The KCL Authors. All rights reserved.
+//! Copyright The KCL Authors. All rights reserved.
 
 extern crate fancy_regex;