#parallel #systems #resources #ecs

shred

Dispatches systems in parallel which need read access to some resources, and write access to others

35 releases

✓ Uses Rust 2018 edition

0.10.2 Feb 12, 2020
0.10.0 Dec 31, 2019
0.9.4 Nov 15, 2019
0.9.2 Jun 28, 2019
0.4.3 Jun 21, 2017

#6 in Concurrency

Download history 1058/week @ 2019-12-17 1450/week @ 2019-12-24 1621/week @ 2019-12-31 1851/week @ 2020-01-07 1783/week @ 2020-01-14 1484/week @ 2020-01-21 1354/week @ 2020-01-28 1416/week @ 2020-02-04 1660/week @ 2020-02-11 1778/week @ 2020-02-18 1435/week @ 2020-02-25 1291/week @ 2020-03-03 1228/week @ 2020-03-10 1948/week @ 2020-03-17 1331/week @ 2020-03-24 1448/week @ 2020-03-31

6,672 downloads per month
Used in 133 crates (14 directly)

MIT/Apache

155KB
3K SLoC

shred - Shared resource dispatcher

Build Status Crates.io MIT/Apache Docs.rs LoC

This library allows to dispatch systems, which can have interdependencies, shared and exclusive resource access, in parallel.

Usage

extern crate shred;

use shred::{DispatcherBuilder, Read, Resource, ResourceId, System, SystemData, World, Write};

#[derive(Debug, Default)]
struct ResA;

#[derive(Debug, Default)]
struct ResB;

#[derive(SystemData)] // Provided with `shred-derive` feature
struct Data<'a> {
    a: Read<'a, ResA>,
    b: Write<'a, ResB>,
}

struct EmptySystem;

impl<'a> System<'a> for EmptySystem {
    type SystemData = Data<'a>;

    fn run(&mut self, bundle: Data<'a>) {
        println!("{:?}", &*bundle.a);
        println!("{:?}", &*bundle.b);
    }
}

fn main() {
    let mut world = World::empty();
    let mut dispatcher = DispatcherBuilder::new()
        .with(EmptySystem, "empty", &[])
        .build();
    world.insert(ResA);
    world.insert(ResB);

    dispatcher.dispatch(&mut world);
}

Please see the benchmark for a bigger (and useful) example.

Required Rust version

1.38 stable

Features

  • lock-free
  • no channels or similar functionality used (-> less overhead)
  • allows both automated parallelization and fine-grained control

Contribution

Contribution is highly welcome! If you'd like another feature, just create an issue. You can also help out if you want to; just pick a "help wanted" issue. If you need any help, feel free to ask!

All contributions are assumed to be dual-licensed under MIT/Apache-2.

License

shred is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT.

Dependencies

~1.6–2.2MB
~46K SLoC