rinf 8.10.0

Rust for native business logic, Flutter for flexible and beautiful GUI
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
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! This module provides functionality for defining and handling signals
//! in a type-safe way, ensuring that all structs and enums
//! require their inner structs and enums to implement the signal trait.

use crate::channel::SignalReceiver;
use crate::interface::DartSignalPack;
use serde::{Deserialize, Serialize};
use std::collections::{BTreeMap, BTreeSet, HashMap, HashSet};

/// Capability of sending signals from Rust to Dart.
pub trait RustSignal: Serialize {
  /// Sends a signal to Dart.
  /// Passing data from Dart to Rust is a zero-copy operation.
  fn send_signal_to_dart(&self);
}

/// Capability of sending signals from Rust to Dart with binary data.
pub trait RustSignalBinary: Serialize {
  /// Sends a signal to Dart with separate binary data.
  /// Passing data from Dart to Rust is a zero-copy operation.
  fn send_signal_to_dart(&self, binary: Vec<u8>);
}

/// Capability of sending signals from Dart to Rust.
pub trait DartSignal: for<'a> Deserialize<'a> {
  /// Returns the receiver that listens for signals from Dart.
  /// If this function is called multiple times,
  /// only the most recent receiver remains active,
  /// and all previous ones become inactive after receiving `None`.
  fn get_dart_signal_receiver() -> SignalReceiver<DartSignalPack<Self>>;
}

/// Capability of sending signals from Dart to Rust with binary data.
pub trait DartSignalBinary: for<'a> Deserialize<'a> {
  /// Returns the receiver that listens for signals from Dart.
  /// If this function is called multiple times,
  /// only the most recent receiver remains active,
  /// and all previous ones become inactive after receiving `None`.
  fn get_dart_signal_receiver() -> SignalReceiver<DartSignalPack<Self>>;
}

/// Enables a type to be nested within a signal struct or enum.
pub trait SignalPiece {
  /// This function is a no-op.
  /// It's purely used for checking that
  /// a field implements the `SignalPiece` trait.
  #[doc(hidden)]
  fn be_signal_piece(&self) {}
}

// Implement the trait for simple primitives.
impl SignalPiece for i8 {}
impl SignalPiece for i16 {}
impl SignalPiece for i32 {}
impl SignalPiece for i64 {}
impl SignalPiece for i128 {}
impl SignalPiece for u8 {}
impl SignalPiece for u16 {}
impl SignalPiece for u32 {}
impl SignalPiece for u64 {}
impl SignalPiece for u128 {}
impl SignalPiece for f32 {}
impl SignalPiece for f64 {}
impl SignalPiece for bool {}
impl SignalPiece for char {}
impl SignalPiece for String {}
impl SignalPiece for &str {}

// Implement the trait for container types.
impl<T> SignalPiece for Box<T> where T: SignalPiece {}
impl<T> SignalPiece for Option<T> where T: SignalPiece {}

// Implement the trait for collection types.
impl<T, const N: usize> SignalPiece for [T; N] where T: SignalPiece {}
impl<T> SignalPiece for Vec<T> where T: SignalPiece {}
impl<T> SignalPiece for HashSet<T> where T: SignalPiece {}
impl<T> SignalPiece for BTreeSet<T> where T: SignalPiece {}
impl<K, V> SignalPiece for HashMap<K, V>
where
  K: SignalPiece,
  V: SignalPiece,
{
}
impl<K, V> SignalPiece for BTreeMap<K, V>
where
  K: SignalPiece,
  V: SignalPiece,
{
}

// Implement the trait for tuples.
impl SignalPiece for () {}
impl<T1> SignalPiece for (T1,) where T1: SignalPiece {}
impl<T1, T2> SignalPiece for (T1, T2)
where
  T1: SignalPiece,
  T2: SignalPiece,
{
}
impl<T1, T2, T3> SignalPiece for (T1, T2, T3)
where
  T1: SignalPiece,
  T2: SignalPiece,
  T3: SignalPiece,
{
}
impl<T1, T2, T3, T4> SignalPiece for (T1, T2, T3, T4)
where
  T1: SignalPiece,
  T2: SignalPiece,
  T3: SignalPiece,
  T4: SignalPiece,
{
}