pyruts 0.1.0

面向 Rust 工程实践的 proc_macro 工具集: Builder derive, c_wrap! FFI 包装, ensure!/bail!/throw! 错误宏, dict!/btree_dict! 容器字面量
Documentation
use pyruts::c_wrap;
use std::os::raw::c_char;

// ── 模拟 C 函数: 接收 buffer + len, 写入字符串, 返回实际长度 ──
mod native {
    use std::os::raw::c_char;

    #[no_mangle]
    pub extern "C" fn my_get_str(buf: *mut c_char, len: usize) -> usize {
        let msg = b"hello world";
        let n = msg.len().min(len.saturating_sub(1));
        unsafe {
            std::ptr::copy_nonoverlapping(msg.as_ptr() as *const c_char, buf, n);
            *buf.add(n) = 0;
        }
        n
    }

    #[no_mangle]
    pub extern "C" fn my_get_short(buf: *mut c_char, len: usize) -> usize {
        let msg = b"hi";
        let n = msg.len().min(len.saturating_sub(1));
        unsafe {
            std::ptr::copy_nonoverlapping(msg.as_ptr() as *const c_char, buf, n);
            *buf.add(n) = 0;
        }
        n
    }

    // 返回 i32 但仍是 buffer 模式 (返回值被忽略, 用 buffer 内容)
    #[no_mangle]
    pub extern "C" fn my_get_status(buf: *mut c_char, len: usize) -> i32 {
        let msg = b"OK";
        let n = msg.len().min(len.saturating_sub(1));
        unsafe {
            std::ptr::copy_nonoverlapping(msg.as_ptr() as *const c_char, buf, n);
            *buf.add(n) = 0;
        }
        0
    }

    // 接收额外参数 + buffer 对
    #[no_mangle]
    pub extern "C" fn my_get_prefixed(
        prefix: *const c_char,
        buf: *mut c_char,
        len: usize,
    ) -> usize {
        // 读 prefix 长度
        let mut plen = 0;
        unsafe {
            while *prefix.add(plen) != 0 {
                plen += 1;
            }
            // 复制 prefix
            std::ptr::copy_nonoverlapping(prefix, buf, plen);
        }
        let msg = b"+suffix";
        let total = plen + msg.len();
        let cap = len.saturating_sub(1);
        let n = total.min(cap);
        unsafe {
            let m = msg.len().min(n.saturating_sub(plen));
            std::ptr::copy_nonoverlapping(msg.as_ptr() as *const c_char, buf.add(plen), m);
            *buf.add(plen + m) = 0;
        }
        plen + msg.len().min(n.saturating_sub(plen))
    }
}

// ── c_wrap! 应用 ──
c_wrap! {
    extern "C" {
        fn my_get_str(buf: *mut c_char, len: usize) -> usize;
        fn my_get_short(buf: *mut c_char, len: usize) -> usize;
        fn my_get_status(buf: *mut c_char, len: usize) -> i32;
        fn my_get_prefixed(prefix: *const c_char, buf: *mut c_char, len: usize) -> usize;
    }
}

#[test]
fn c_wrap_buffer_basic() {
    assert_eq!(safe_my_get_str(), "hello world");
}

#[test]
fn c_wrap_buffer_short_string() {
    assert_eq!(safe_my_get_short(), "hi");
}

#[test]
fn c_wrap_buffer_ignores_int_return() {
    // 即使 C 函数返回 i32, buffer 模式下 safe_ 仍返回 String
    assert_eq!(safe_my_get_status(), "OK");
}

#[test]
fn c_wrap_buffer_with_extra_param() {
    // prefix 是 *const c_char → safe 函数接收 &str
    // buf+len 是 buffer 对 → safe 函数省略, 内部分配
    assert_eq!(safe_my_get_prefixed("pre"), "pre+suffix");
}

#[test]
fn c_wrap_buffer_returns_owned_string() {
    let s: String = safe_my_get_str();
    assert_eq!(s.len(), "hello world".len());
    assert!(s.capacity() >= s.len());
}

// ── 验证 buffer 模式下空字符串处理 ──
mod empty_native {
    use std::os::raw::c_char;
    #[no_mangle]
    pub extern "C" fn my_get_empty(buf: *mut c_char, _len: usize) -> usize {
        unsafe {
            *buf = 0;
        }
        0
    }
}

c_wrap! {
    extern "C" {
        fn my_get_empty(buf: *mut c_char, len: usize) -> usize;
    }
}

#[test]
fn c_wrap_buffer_empty_when_c_writes_nothing() {
    assert_eq!(safe_my_get_empty(), "");
}