agent-tk 0.4.0

`agent-tk` (`agent toolkit/tasks-knowledge`) is a crate for the development of autonomous agents using Rust, with an emphasis on tasks and knowledge based agents. This project is part of the [auKsys](http://auksys.org) project.
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
79

//! This module allows to represent goals.

use crate::uuid;
use serde::{Deserialize, Serialize};
use std::collections::BTreeMap;

use crate::definitions::misc_structures::GeoPoint;

/// Represent a delivery goal
#[derive(Serialize, Deserialize, Debug, Clone, Default)]
pub struct DeliveryGoal {}

/// Represent a visitation goal
#[derive(Serialize, Deserialize, Debug, Clone, Default)]
pub struct VisitGoal
{
  /// Position of the goal to visit
  #[serde(flatten)]
  pub position: GeoPoint,
}

/// Represent a set of goals
#[derive(Serialize, Deserialize, Debug, Clone, Default)]
pub struct Goal
{
  /// Unique identifier for the goal
  pub uuid: uuid::Uuid,
  #[serde(default = "Default::default")]
  /// Delivery goals
  pub deliver: BTreeMap<String, DeliveryGoal>,
  /// Visit goals
  #[serde(default = "Default::default")]
  pub visit: BTreeMap<String, VisitGoal>,
}

impl Goal
{
  /// Convenient function to convert a node to a JSON string
  pub fn to_json_string(&self) -> serde_json::Result<String>
  {
    serde_json::to_string(self)
  }
  /// Convenient function to convert a JSON string to a node
  pub fn from_json_string(def: impl AsRef<str>) -> serde_json::Result<Goal>
  {
    serde_json::from_str(def.as_ref())
  }
}

#[cfg(test)]
mod tests
{
  use super::*;
  fn mgp(longitude: f64, latitude: f64, altitude: f64) -> GeoPoint
  {
    GeoPoint {
      longitude,
      latitude,
      altitude,
    }
  }
  #[test]
  fn parse_test_goals()
  {
    let message = include_str!("../../../../data/test_goal.json");
    let goal: super::Goal = serde_json::from_str(message).unwrap();

    assert!(goal.deliver.is_empty());
    assert_eq!(goal.visit.len(), 2);
    assert_eq!(
      goal.visit.get("loc1").unwrap().position,
      mgp(16.679423811351608, 57.75966551794022, 0.0)
    );
    assert_eq!(
      goal.visit.get("loc2").unwrap().position,
      mgp(16.677721987885022, 57.75937792909685, 0.0)
    );
  }
}