apis 0.5.13

Reactive, session-oriented, asynchronous process-calculus framework
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

use std;
use strum;
use crate::session;

// NOTE: Currently Global only refers to CTX::MID and Message only refers to
// CTX::GMSG and CTX::MID through the GMSG parameter. It would seem that we
// could use those two types as parameters directly, without needing a full
// context. The only problem is that when dealing with a concrete
// implementation of a session::Context, referring to these associated types
// must be "disambiguated" with the syntax:
//
//     Message <
//       <Mycontext as session::Context>::MID,
//       <Mycontext as session::Context>::GMSG> ... ,
//
// which is must more verbose than simply:
//
//     Message <Mycontext>

pub type IdReprType = u16;
/// Unique ID for each global message type used in a given session context.
pub trait Id : Clone + Ord + Into <usize> + TryFrom <IdReprType> + std::fmt::Debug
  + strum::IntoEnumIterator
{}

/// The global message type.
pub trait Global <CTX> where
  Self : Sized + std::fmt::Debug,
  CTX  : session::Context <GMSG=Self>
{
  fn id (&self) -> CTX::MID;
  /// Get the message name of the inner message type
  // TODO: due to difficulty in creating a match statement from the session
  // macro definition, we are relying on the strum Display proc macro to
  // generate a string of the message variant instead of returning a static
  // str
  fn inner_name (&self) -> String;
}

/// A local message type with partial mapping from global message type and
/// total mapping into global message type.
pub trait Message <CTX : session::Context> : Send + std::fmt::Debug
  + TryFrom <CTX::GMSG> + Into <CTX::GMSG>
{
  /// Get the message name
  // TODO: due to difficulty in creating a match statement from the session
  // macro definition, we are relying on the strum Display proc macro to
  // generate a string of the message variant instead of returning a static
  // str
  fn name (&self) -> String;
}

////////////////////////////////////////////////////////////////////////////////
//  functions
////////////////////////////////////////////////////////////////////////////////

pub fn report_sizes <_CTX : session::Context> () {
  println!("message report sizes...");
  /* nothing to report */
  println!("...message report sizes");
}