Lib.rs

关于

pecs 是一个用于 Bevy 的插件，允许您通过将多个承诺作为Bevy的 ecs 环境的一部分链接起来来异步执行代码。

pecs 代表 Promise Entity Component System。

资源

• 文档
• 示例
• 报告问题
• 提供想法

兼容性

特性

• 使用 then()/then_repeat() 进行承诺链式调用
• 状态传递（承诺的状态类似于项的状态中的 self）。
• 完全类型推断（下一个承诺知道前一个结果的数据类型）。
• 提供开箱即用的定时器、UI和HTTP承诺，通过无状态的 asyn 模块和有状态的 state.asyn() 方法。
• 自定义承诺注册（添加您想要的任何异步函数！）。
• 获取 系统参数（承诺 asyn! 函数接受与Bevy系统相同的参数）。
• 嵌套承诺（显然是通过链式调用）。
• 通过无状态的 Promise::any() /Promise::all() 方法或状态性的 state.any()/state.all() 方法来将承诺与 any/all 结合，以处理承诺元组/vec。
• 通过 with(value)/map(func) 进行状态映射（在链式调用中改变状态类型/值）。
• 通过 with_result(value)/map_result(func) 进行结果映射（在链式调用中改变结果类型/值）。

示例

use bevy::prelude::*;
use pecs::prelude::*;
fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(PecsPlugin)
        .add_systems(Startup, setup)
        .run();
}

fn setup(mut commands: Commands, time: Res<Time>) {
    let start = time.elapsed_seconds();
    commands
        // create PromiseLike chainable commands
        // with the current time as state
        .promise(|| start)
        // will be executed right after current stage
        .then(asyn!(state => {
            info!("Wait a second..");
            state.asyn().timeout(1.0)
        }))
        // will be executed after in a second after previous call
        .then(asyn!(state => {
            info!("How large is is the Bevy main web page?");
            state.asyn().http().get("https://bevy.rust-lang.net.cn")
        }))
        // will be executed after request completes
        .then(asyn!(state, result => {
            match result {
                Ok(response) => info!("It is {} bytes!", response.bytes.len()),
                Err(err) => info!("Ahhh... something goes wrong: {err}")
            }
            state.pass()
        }))
        // will be executed right after the previous one
        .then(asyn!(state, time: Res<Time> => {
            let duration = time.elapsed_seconds() - state.value;
            info!("It took {duration:0.2}s to do this job.");
            info!("Exiting now");
            asyn::app::exit()
        }));
}

以下是上述示例的输出，请注意时间戳

18.667 INFO bevy_render::renderer: AdapterInfo { ... }
18.835 INFO simple: Wait a second..
19.842 INFO simple: How large is is the Bevy main web page?
19.924 INFO simple: It is 17759 bytes!
19.924 INFO simple: It tooks 1.09s to do this job.
19.924 INFO simple: Exiting now

进行中

这个crate比较年轻。API可能会变化。应用可能会崩溃。一些承诺可能会无声地丢弃。文档不完整。

但是。但是。示例工作得非常好。这个事实给了我们很多希望。

许可

pecs 可以选择以下任意一种双许可协议

• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)
• Apache 许可证，版本 2.0 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)

这意味着您可以选择您喜欢的许可协议！这种双许可协议是Rust生态系统中的事实标准，并且有很好的理由包含两者。