rasgapdf 0.1.0

Blazing-fast spatial 2D PDF parser in pure Rust with multi-language bindings (Python, Node.js, Go, C#)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

use std::ffi::{CStr, CString};
use std::os::raw::c_char;
use crate::types::ParserOptions;
use crate::spatial::{parse_file, parse_raw_file};

/// Processa um arquivo PDF e retorna o JSON espacial estruturado como string C.
/// O chamador deve liberar a memória chamando `rasgapdf_free_string`.
#[no_mangle]
pub extern "C" fn rasgapdf_parse_file(path_ptr: *const c_char) -> *mut c_char {
    rasgapdf_parse_file_options(path_ptr, std::ptr::null())
}

/// Modo 1: Retorna exclusivamente a lista plana de coordenadas brutas X/Y
#[no_mangle]
pub extern "C" fn rasgapdf_parse_raw(path_ptr: *const c_char) -> *mut c_char {
    if path_ptr.is_null() {
        return create_error_json("Path pointer is null");
    }

    let path_str = match unsafe { CStr::from_ptr(path_ptr) }.to_str() {
        Ok(s) => s,
        Err(_) => return create_error_json("Invalid UTF-8 in path"),
    };

    match parse_raw_file(path_str) {
        Ok(doc) => match serde_json::to_string(&doc) {
            Ok(json_str) => match CString::new(json_str) {
                Ok(c_str) => c_str.into_raw(),
                Err(_) => create_error_json("Failed to create CString"),
            },
            Err(e) => create_error_json(&format!("JSON serialization error: {}", e)),
        },
        Err(e) => create_error_json(&format!("Parse error: {}", e)),
    }
}

/// Processa um PDF com opções JSON customizadas
#[no_mangle]
pub extern "C" fn rasgapdf_parse_file_options(path_ptr: *const c_char, options_json_ptr: *const c_char) -> *mut c_char {
    if path_ptr.is_null() {
        return create_error_json("Path pointer is null");
    }

    let path_str = match unsafe { CStr::from_ptr(path_ptr) }.to_str() {
        Ok(s) => s,
        Err(_) => return create_error_json("Invalid UTF-8 in path"),
    };

    let options: ParserOptions = if !options_json_ptr.is_null() {
        match unsafe { CStr::from_ptr(options_json_ptr) }.to_str() {
            Ok(opts_str) => serde_json::from_str(opts_str).unwrap_or_default(),
            Err(_) => ParserOptions::default(),
        }
    } else {
        ParserOptions::default()
    };

    if options.mode == "raw" {
        return rasgapdf_parse_raw(path_ptr);
    }

    match parse_file(path_str, &options) {
        Ok(doc) => match serde_json::to_string(&doc) {
            Ok(json_str) => match CString::new(json_str) {
                Ok(c_str) => c_str.into_raw(),
                Err(_) => create_error_json("Failed to create CString"),
            },
            Err(e) => create_error_json(&format!("JSON serialization error: {}", e)),
        },
        Err(e) => create_error_json(&format!("Parse error: {}", e)),
    }
}

/// Libera a string alocada pelo Rust
#[no_mangle]
pub extern "C" fn rasgapdf_free_string(ptr: *mut c_char) {
    if !ptr.is_null() {
        unsafe {
            let _ = CString::from_raw(ptr);
        }
    }
}

/// Retorna a versão da biblioteca
#[no_mangle]
pub extern "C" fn rasgapdf_version() -> *const c_char {
    static VERSION: &[u8] = b"0.1.0\0";
    VERSION.as_ptr() as *const c_char
}

fn create_error_json(err_msg: &str) -> *mut c_char {
    let err_obj = serde_json::json!({
        "error": true,
        "message": err_msg
    });
    let s = serde_json::to_string(&err_obj).unwrap_or_else(|_| "{\"error\":true}".to_string());
    CString::new(s).unwrap().into_raw()
}