narust-158 0.3.1

A Rust reimplementation of OpenNARS 1.5.8
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

//! 推理器的输入输出（通道）部分

use super::{InputChannel, OutputChannel};
use crate::vm::alpha::RuntimeAlpha;
use std::fmt::{Debug, Formatter};

/// 输入通道对象
pub(in super::super) type InputChannelObj = Box<dyn InputChannel>;

/// 输出通道对象
pub(in super::super) type OutputChannelObj = Box<dyn OutputChannel>;

/// 内部的「推理器通道」结构
/// * 🎯在内部实现中分离[推理器](Reasoner)的「输入输出」逻辑
///
/// * 🚩【2024-08-12 00:11:05】暂且搁置对「通道」的序列反序列化尝试
///   * 💭函数指针都够呛，特征对象就更难被序列化了……
#[derive(Default)]
pub(in super::super) struct ReasonerChannels {
    /// 所有输入通道
    pub input_channels: Vec<InputChannelObj>,

    /// 所有输出通道
    pub output_channels: Vec<OutputChannelObj>,
}

impl ReasonerChannels {
    pub(in super::super) fn new() -> Self {
        Self::default()
    }

    /// 模拟`ReasonerBatch.addInputChannel`
    /// * ⚠️若使用`impl XChannel`会出现生命周期问题
    ///
    /// # 📄OpenNARS
    ///
    /// 🈚
    pub fn add_input_channel(&mut self, channel: InputChannelObj) {
        self.input_channels.push(channel);
    }

    /// 模拟`ReasonerBatch.addOutputChannel`
    /// * ⚠️若使用`impl XChannel`会出现生命周期问题
    ///
    /// # 📄OpenNARS
    ///
    /// 🈚
    pub fn add_output_channel(&mut self, channel: OutputChannelObj) {
        self.output_channels.push(channel);
    }
}

/// 手动实现：输入输出通道 不一定实现了[`Debug`]
impl Debug for ReasonerChannels {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("ReasonerChannels")
            .field(
                "input_channels",
                &format!("[Box<dyn InputChannel>; {}]", self.input_channels.len()),
            )
            .field(
                "output_channels",
                &format!("[Box<dyn OutputChannel>; {}]", self.output_channels.len()),
            )
            .finish()
    }
}

/// 为「推理器」扩展方法
impl RuntimeAlpha {
    /* 通道相关 */

    /// 模拟`ReasonerBatch.addInputChannel`
    /// * ♻️【2024-08-14 21:14:49】现在直接调用通道结构的内部`impl`
    pub fn add_input_channel(&mut self, channel: InputChannelObj) {
        self.io_channels.add_input_channel(channel);
    }

    /// 模拟`ReasonerBatch.addOutputChannel`
    /// * ♻️【2024-08-14 21:14:49】现在直接调用通道结构的内部`impl`
    pub fn add_output_channel(&mut self, channel: OutputChannelObj) {
        self.io_channels.add_output_channel(channel);
    }

    // ! ❌不模拟`ReasonerBatch.removeInputChannel`
    //   * 📝OpenNARS中仅用于「请求推理器移除自身」
    //   * 🚩这实际上可以被「标记『待移除』，下次遍历到时直接删除」的方法替代
    //   * ✅同时避免了「循环引用」「动态判等」问题

    // ! ❌不模拟`ReasonerBatch.removeOutputChannel`
}