【rust cfg 条件编译 feature 与集成测试】

#![cfg(…)]

在Rust中，#![cfg(...)] 是一种元编程特性，它允许我们根据编译时的条件来有条件地编译代码。


all()和any()函数可以用来组合多个条件。


如果测试feature是否开启，你可以使用std::option::Option::is_some方法来检查feature是否存在。

1.案例

案例1

#![cfg(all(feature = "some_feature", feature = "another_feature"))]
fn main() {
    println!("Both features are enabled!");
}

• 在这个例子中，只有当some_feature和another_feature两个特性都开启时，才会编译和运行main()函数。

案例2

#![cfg(any(feature = "some_feature", feature = "another_feature"))]
fn main() {
    println!("At least one of the features is enabled!");
}

• 在这个例子中，只要some_feature或another_feature中的任何一个被开启，就会编译和运行main()函数。

案例3

fn main() {
    if cfg!(feature = "some_feature") {
        println!("The 'some_feature' feature is enabled!");
    } else {
        println!("The 'some_feature' feature is not enabled!");
    }
}

• 在这个例子中，我们使用cfg!宏来在运行时检查特性是否开启。

2.开启feature

在实际的Rust项目中，特性（features）通常在Cargo.toml文件中开启，而不是在代码中使用#![cfg(...)]。

• Cargo.toml

[features]
some_feature = []
another_feature = []

[features]
local-tunnel=[]
server=[]

3.条件编译或条件测试

• 编译项目，并开启some_feature特性。

cargo build --features "some_feature"

• 集成测试 : 对使用 local-tunnel 和 server 特征的测试包进行测试并捕获输出

tunnel.rs 文件开头:
#![cfg(all(feature = "local-tunnel", feature = "server"))]

cargo test --features="local-tunnel,server" -- --nocapture

$ cargo build --release --target=x86_64-pc-windows-gnu -p ss --bin sslocal --features="local"