flecs_ecs 0.2.2

Rust API for the C/CPP flecs ECS library <https://github.com/SanderMertens/flecs>
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
68
69
70
71
72
73
74
75
76
77
78

use crate::z_ignore_test_common::*;

use flecs_ecs::prelude::*;
// This example shows how queries can be used to match simple inheritance trees.

#[derive(Component)]
struct Unit;

#[derive(Component)]
struct CombatUnit;

#[derive(Component)]
struct MeleeUnit;

#[derive(Component)]
struct RangedUnit;

#[derive(Component)]
struct Warrior;

#[derive(Component)]
struct Wizard;

#[derive(Component)]
struct Marksman;

#[derive(Component)]
struct BuilderX;

fn main() {
    let world = World::new();

    // Make the ECS aware of the inheritance relationships. Note that IsA
    // relationship used here is the same as in the prefab example.
    world.component::<CombatUnit>().is_a(Unit);
    world.component::<MeleeUnit>().is_a(CombatUnit);
    world.component::<RangedUnit>().is_a(CombatUnit);

    world.component::<Warrior>().is_a(MeleeUnit);
    world.component::<Wizard>().is_a(RangedUnit);
    world.component::<Marksman>().is_a(RangedUnit);
    world.component::<BuilderX>().is_a(Unit);

    // Create a few units
    world.entity_named("warrior_1").add(Warrior);
    world.entity_named("warrior_2").add(Warrior);

    world.entity_named("marksman_1").add(Marksman);
    world.entity_named("marksman_2").add(Marksman);

    world.entity_named("wizard_1").add(Wizard);
    world.entity_named("wizard_2").add(Wizard);

    world.entity_named("builder_1").add(BuilderX);
    world.entity_named("builder_2").add(BuilderX);

    // Create a rule to find all ranged units
    let r = world.query::<()>().with(RangedUnit).build();

    // Iterate the rule
    r.each_entity(|e, rangedunit| {
        println!("Unit {} found", e.name());
    });

    // Output:
    //  Unit wizard_1 found
    //  Unit wizard_2 found
    //  Unit marksman_1 found
    //  Unit marksman_2 found
}

#[cfg(feature = "flecs_nightly_tests")]
#[test]
fn test() {
    let output_capture = OutputCapture::capture().unwrap();
    main();
    output_capture.test("query_component_inheritance".to_string());
}