dimas 0.5.1

dimas - a framework for Distributed Multi Agent Systems
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

//! `DiMAS` liveliness example
//! Copyright © 2024 Stephan Kunz

// region:		--- modules
use dimas::prelude::*;
// endregion:	--- modules

#[derive(Debug, Default)]
struct AgentProps {
	num: u32,
}

async fn put_callback(ctx: Context<AgentProps>, id: String) -> Result<()> {
	println!("{id} is alive");
	let mut val = ctx.read()?.num;
	val += 1;
	ctx.write()?.num = val;
	println!("Number of agents is {val}");
	Ok(())
}

async fn delete_callback(ctx: Context<AgentProps>, id: String) -> Result<()> {
	println!("{id} died");
	let mut val = ctx.read()?.num;
	// take care of subtraction when num = 0
	val = val.saturating_sub(1);
	ctx.write()?.num = val;
	println!("Number of agents is {val}");
	Ok(())
}

#[dimas::main]
async fn main() -> Result<()> {
	// initialize tracing/logging
	init_tracing();

	// create & initialize agents properties
	let properties = AgentProps { num: 1 };

	// create an agent with the properties and the prefix 'examples'
	let mut agent = Agent::new(properties)
		.prefix("examples")
		.name("liveliness")
		.config(&Config::default())?;

	// add a liveliness subscriber to listen for other agents
	agent
		.liveliness_subscriber()
		.put_callback(put_callback)
		.delete_callback(delete_callback)
		.add()?;

	// activate sending liveliness signal
	agent.liveliness(true);
	agent.start().await?;

	Ok(())
}