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
59
60
61
62
63

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

use dimas::prelude::*;

#[derive(Debug)]
struct AgentProps {
	count: u128,
}

/// common structure for publisher and subscriber
#[derive(Debug, Encode, Decode)]
pub struct PubSubMessage {
	/// counter
	pub count: u128,
	/// text
	pub text: String,
}

async fn hello_publishing(ctx: Context<AgentProps>, message: Message) -> Result<()> {
	let message: PubSubMessage = message.decode()?;
	let count = ctx.read()?.count;
	if message.count > count {
		println!("missed {} messages", message.count - count);
		ctx.write()?.count = message.count;
	}
	println!("Received {} [{}]", message.text, message.count);
	ctx.write()?.count += 1;
	Ok(())
}

async fn hello_deletion(ctx: Context<AgentProps>) -> Result<()> {
	let _value = ctx.read()?.count;
	println!("Shall delete 'hello' message");
	Ok(())
}

#[dimas::main]
async fn main() -> Result<()> {
	// create & initialize agents properties
	let properties = AgentProps { count: 0 };

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

	// listen for 'hello' messages
	agent
		.subscriber()
		.topic("hello")
		.put_callback(hello_publishing)
		.delete_callback(hello_deletion)
		.add()?;

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

	Ok(())
}