#injection #thruster #quick #jab

thruster-jab

Quick and simple dependency injection

1 unstable release

0.1.0 Oct 22, 2021

#12 in #thruster

Download history 54/week @ 2024-04-14 89/week @ 2024-04-21 130/week @ 2024-04-28 72/week @ 2024-05-05 83/week @ 2024-05-12 148/week @ 2024-05-19 92/week @ 2024-05-26 34/week @ 2024-06-02 90/week @ 2024-06-09 77/week @ 2024-06-16 37/week @ 2024-06-23 20/week @ 2024-06-30 34/week @ 2024-07-07 34/week @ 2024-07-14 20/week @ 2024-07-21

109 downloads per month
Used in thruster

MIT license

12KB
131 lines

Thruster Jab

Because this is a dependency injection library, and shots are injected, and shots are called jabs in the UK.

What is this?

Thruster Jab is a dependency injection library for your service injection needs. It works using dynamic dispatch via Box<dyn Any>. If you're looking to make something that will need mocks in order to test (say, an API that makes external calls, or a service that is very expensive) then Jab might be helpful to you.

Example

Although built for thruster, Jab can be used independently. A simple example would be:

struct A(i32);

trait C {}

impl C for A {}

let mut jab = JabDI::default();

let a = A(0);

provide!(jab, dyn C, a);
let something = fetch!(jab, dyn C); // This is the original a that we passed in, now as a C trait.

A slightly longer, but more "copy pasta" example (taken from our tests because I'm lazy) would be:

// Just making two structs that impl two traits
#[derive(Debug, PartialEq)]
struct A(i32);

#[derive(Debug, PartialEq)]
struct B(i32);

trait C {
    fn valc(&self) -> i32;
}
trait D {
    fn vald(&self) -> i32;
}

impl C for A {
    fn valc(&self) -> i32 {
        self.0
    }
}

impl D for B {
    fn vald(&self) -> i32 {
        self.0
    }
}

// This is the good part
let mut jab = JabDI::default();

let a = A(0);
let b = B(1);

provide!(jab, dyn C, a);
provide!(jab, dyn D, b);

assert_eq!(
    0,
    fetch!(jab, dyn C).valc(),
    "it should correctly find struct A for trait C"
);

assert_eq!(
    1,
    fetch!(jab, dyn D).vald(),
    "it should correctly find struct B for trait D"
);

For use with actual tests, check out our hello_world.rs example.

No runtime deps