cargo-macra 0.2.0

CLI for working with macro expansion and diagnostics in Rust projects.
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

#![allow(improper_ctypes_definitions)]

//! macra-hook: LD_PRELOAD/DYLD_INSERT_LIBRARIES library that intercepts
//! proc macro loading by rustc to capture macro inputs and outputs.
//!
//! When loaded via LD_PRELOAD (Linux) or DYLD_INSERT_LIBRARIES (macOS),
//! this library hooks `dlsym` to intercept `__rustc_proc_macro_decls_*`
//! symbol lookups. The returned proc macro tables are wrapped with
//! trampolines that capture the string representations of inputs/outputs
//! and log them to stderr with a `__MACRA_HOOK__:` prefix.

mod dispatch;
mod logging;
mod trampoline;
pub mod types;

#[cfg(target_os = "linux")]
mod hook_linux;

#[cfg(target_os = "macos")]
mod hook_macos;

#[cfg(target_os = "windows")]
mod hook_windows;

/// DllMain entry point for Windows DLL injection.
///
/// When this DLL is loaded into a rustc process by the RUSTC_WRAPPER,
/// DllMain calls `hook_windows::install_hook()` to patch the IAT.
#[cfg(target_os = "windows")]
#[unsafe(no_mangle)]
pub unsafe extern "system" fn DllMain(
    _dll_module: *mut u8,
    call_reason: u32,
    _reserved: *mut u8,
) -> i32 {
    const DLL_PROCESS_ATTACH: u32 = 1;
    if call_reason == DLL_PROCESS_ATTACH {
        hook_windows::install_hook();
    }
    1 // TRUE
}