6 releases (3 breaking)

0.5.0 Nov 21, 2023
0.4.0 Jul 25, 2023
0.3.0 Mar 21, 2023
0.2.3 Mar 13, 2023
0.1.2 Feb 11, 2023

#347 in Game dev

Download history 5/week @ 2023-10-14 3/week @ 2023-10-21 10/week @ 2023-10-28 2/week @ 2023-11-11 36/week @ 2023-11-18 12/week @ 2023-11-25 41/week @ 2023-12-02 8/week @ 2023-12-09 14/week @ 2023-12-16 42/week @ 2023-12-23 42/week @ 2023-12-30 29/week @ 2024-01-06 26/week @ 2024-01-13 5/week @ 2024-01-20 26/week @ 2024-01-27

93 downloads per month

MIT/Apache

4MB
1.5K SLoC

crates.io MIT/Apache 2.0 Bevy tracking docs.rs

About

pecs is a plugin for Bevy that allows you to execute code asynchronously by chaining multiple promises as part of Bevy's ecs environment.

pecs stands for Promise Entity Component System.

Resources:

Compatibility:

bevy pecs
0.12 0.5
0.11 0.4
0.10 0.3
0.9 0.2

Features

  • Promise chaining with then()/then_repeat()
  • State passing (state for promises is like self for items).
  • Complete type inference (the next promise knows the type of the previous result).
  • Out-of-the-box timer, UI and HTTP promises via stateless asyn mod and stateful state.asyn() method.
  • Custom promise registration (add any asynchronous function you want!).
  • System parameters fetching (promise asyn! functions accept the same parameters as Bevy systems do).
  • Nested promises (with chaining, obviously).
  • Combining promises with any/all for tuple/vec of promises via stateless Promise::any() /Promise::all() methods or stateful state.any()/state.all() methods.
  • State mapping via with(value)/map(func) (changes state type/value over chain calls).
  • Result mapping via with_result(value)/map_result(func) (changes result type/value over chain calls).

Example

There is the output of the above example, pay some attention to time stamps:

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

Work in Progress

This crate is pretty young. API could and will change. The app may crash. Some promises could silently drop. Documentation is incomplete.

But. But. Examples work like a charm. And this fact gives us a lot of hope.

License

The pecs is dual-licensed under either:

This means you can select the license you prefer! This dual-licensing approach is the de-facto standard in the Rust ecosystem and there are very good reasons to include both.

Dependencies

~28MB
~543K SLoC