alef 0.63.0

Opinionated polyglot binding generator for Rust libraries
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

use super::*;

/// Regression: PHP standalone functions carrying a source `cfg` predicate must NOT be wrapped in
/// `#[cfg(...)]` at all in the generated `#[php_impl]` facade — neither a plain
/// `#[cfg(feature = "X")]` nor a self-cancelling `any(X, not(X))`.
///
/// ext-php-rs's `#[php_impl]` derive (verified against the pinned `ext-php-rs-derive 0.11.14`
/// source) walks every `syn::ImplItem::Fn` in the block and unconditionally emits a
/// `FunctionBuilder` registration entry referencing the method by its Rust identifier — it does
/// not consult `#[cfg]` at all. A plain per-method `#[cfg(feature = "X")]` therefore breaks the
/// build with feature `X` off (E0599/E0425: the registration array still references a method
/// that no longer exists), while the old `any(X, not(X))` wrapper broke it with `X` off in a
/// different way (E0433: the always-compiled body calls a core-crate symbol that itself is
/// cfg'd away). Per-method cfg inside `#[php_impl]` is not expressible either way, so PHP must
/// emit the method unconditionally and let `scaffold_php_cargo` require the underlying core
/// feature(s) unconditionally instead (see `cfg_gate.rs`'s sibling scaffold test).
#[test]
fn php_standalone_function_never_wraps_body_in_cfg() {
    let backend = PhpBackend;
    let api = ApiSurface {
        crate_name: "test-lib".to_string(),
        version: "0.1.0".to_string(),
        types: vec![],
        functions: vec![FunctionDef {
            name: "count_tokens".to_string(),
            rust_path: "test_lib::count_tokens".to_string(),
            params: vec![ParamDef {
                name: "text".to_string(),
                ty: TypeRef::String,
                ..ParamDef::default()
            }],
            return_type: TypeRef::Primitive(PrimitiveType::U32),
            cfg: Some(r#"feature = "tokenizer""#.to_string()),
            ..FunctionDef::default()
        }],
        enums: vec![],
        errors: vec![],
        excluded_type_paths: ::std::collections::HashMap::new(),
        excluded_trait_names: ::std::collections::HashSet::new(),
        services: vec![],
        handler_contracts: vec![],
        unsupported_public_items: Vec::new(),
    };

    let files = backend.generate_bindings(&api, &make_config()).unwrap();
    let lib = files
        .iter()
        .find(|f| f.path.to_string_lossy().ends_with("lib.rs"))
        .expect("lib.rs generated");

    assert!(
        lib.content.contains("fn count_tokens"),
        "facade method must always be emitted (ext-php-rs's #[php_impl] can't tolerate a\
         cfg'd-out method), got:\n{}",
        lib.content
    );
    assert!(
        !lib.content.contains("#[cfg("),
        "facade method must never be cfg-gated, got:\n{}",
        lib.content
    );
    assert!(
        !lib.content.contains("not("),
        "must never reintroduce a self-cancelling any(X, not(X)) predicate, got:\n{}",
        lib.content
    );
}