Merge pull request #40 from Reim-developer/dev

Feat: Added Rust `ffi_rs` crates & unit test.
# Change Log:
commit 2fb96e4 (HEAD -> dev, origin/dev)
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 18:34:48 2025 +0700

    feat:
    + Added `free_c_str` for check is valid path
    + Addded test case for this function

commit 3bf446f
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 18:34:32 2025 +0700

    feat:
    + Added `free_c_str` for free `c_char`
    + Addded test case for this function

commit 47fcd01
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 18:33:55 2025 +0700

    Added `mod` list & linter

commit 5382cd2
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 18:33:42 2025 +0700

    Added `Bash` script for test FFI Rust -> C++

commit 0eb3f9f
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 18:33:24 2025 +0700

    Added test case with `fn` `is_valid_path` from Rust

commit 4a41584
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 18:33:03 2025 +0700

    Added `Cargo.lock` & `Cargo.toml` to `ffi_rs` crates.

commit 6f28482
Author: Reim-developer <contact.kaxtr@gmail.com>
Date:   Mon Jul 28 03:28:01 2025 +0700

    Added Bash script helper for test FFI Rust -> C++

Author: Reim-developer

ffi_rs/Cargo.lock

@@ -0,0 +1,12 @@
+[package]
+name = "ffi_rs"
+version = "0.1.0"
+edition = "2024"
+
+[lib]
+crate-type = ["staticlib"]
+
+[profile.dev]
+panic = "abort"
+
+[dependencies]

ffi_rs/Cargo.toml

@@ -0,0 +1,21 @@
+use std::ffi::{c_char, CString};
+
+#[unsafe(no_mangle)]
+pub unsafe extern "C" fn free_c_str(c_str: *mut c_char) { unsafe {
+    if !c_str.is_null() {
+        let _ = CString::from_raw(c_str);
+    }
+}}
+
+#[test]
+fn test_free_c_str() { unsafe {
+    use std::ffi::CString;
+    use std::ptr::null_mut;
+
+    let raw_str = CString
+        ::new("Reim-developer")
+        .map(|raw| raw.into_raw())
+        .unwrap_or(null_mut());
+
+    free_c_str(raw_str);
+}}

ffi_rs/src/alloc/memory.rs

@@ -0,0 +1,9 @@
+#![deny(clippy::all, clippy::pedantic, clippy::nursery, clippy::perf)]
+
+pub mod utils {
+    pub mod path;
+}
+
+pub mod alloc {
+    pub mod memory;
+}

ffi_rs/src/lib.rs

@@ -0,0 +1,42 @@
+use std::{ffi::{CStr}, os::raw::c_char, path::Path};
+
+#[unsafe(no_mangle)]
+pub unsafe extern "C" fn is_valid_path(path: *mut c_char) -> bool { unsafe {
+    if path.is_null() {
+        return false;
+    }
+
+    let c_str = match CStr::from_ptr(path).to_str() {
+        Ok(string) => string,
+        Err(_) => return false,
+    };
+
+    if c_str.is_empty() {
+        return false;
+    }
+
+    let path = Path::new(c_str);
+
+    path
+        .as_os_str()
+        .as_encoded_bytes()
+        .iter()
+        .all(|&char| char != 0)
+}}
+
+#[test]
+fn test_is_valid_path() {
+    use std::ffi::{CString};
+    use std::ptr::null_mut;
+    use crate::alloc::memory::free_c_str;
+
+    unsafe {
+        let c_string = CString
+            ::new("../../src/utils/path.rs") /* Path to some exits file ...*/
+            .map(|raw| raw.into_raw())
+            .unwrap_or(null_mut());
+
+        assert_eq!(true, is_valid_path(c_string));
+        free_c_str(c_string);
+    }
+}

ffi_rs/src/utils/path.rs

@@ -0,0 +1,17 @@
+#include <iostream>
+
+using std::cout;
+
+extern "C" {
+    bool is_valid_path(char *path);
+}
+
+int main() {
+    char path[] = "./src/lib.rs";
+    
+    auto result =  is_valid_path(path) ? "Valid path" : "Not valid path";
+
+    cout << result << "\n";
+
+    return 0;
+}

ffi_rs/test_lib.cxx

@@ -0,0 +1,16 @@
+#!/bin/bash
+
+function test_lib() {
+    if [ ! -d "build" ]; then 
+        mkdir -p "build"
+    fi
+
+    cargo build
+
+    local rust_lib="target/debug/libffi_rs.a"
+    clang++ "test_lib.cxx" "$rust_lib" -o "build/test_lib"
+
+    "./build/test_lib"
+}
+
+test_lib