Parse C3 source code to extract NIF function metadata.

This module analyzes C3 source files to find NIF functions based on their signature pattern and extracts metadata from <* @nif ... *> doc comment annotations.

NIF Detection

NIF functions are detected by their signature pattern:

fn erl_nif::ErlNifTerm function_name(
    erl_nif::ErlNifEnv* env, CInt argc, erl_nif::ErlNifTerm* argv
) { ... }

Annotations

Metadata is extracted from C3's doc comment syntax (<* ... *>). We use nif: prefix (not @nif) to avoid conflicts with C3's contract syntax:

<* nif: arity = 2 *>
fn erl_nif::ErlNifTerm add(...) { ... }

<* nif: arity = 1, dirty = cpu *>
fn erl_nif::ErlNifTerm heavy_compute(...) { ... }

<* nif: name = "custom_name", arity = 2 *>
fn erl_nif::ErlNifTerm internal_name(...) { ... }

Callbacks

The following callbacks are auto-detected by function name and signature:

• on_load - fn CInt on_load(erl_nif::ErlNifEnv*, void**, erl_nif::ErlNifTerm)
• on_unload - fn void on_unload(erl_nif::ErlNifEnv*, void*)