Lib.rs

ReArch = 重新构想的应用设计和架构方法

我们必须定义概念并提供数据优先级和描述。我们必须陈述关系，而不是程序。

-- 格雷丝·穆雷·霍珀，管理和未来的计算机 (1962)

特性

具体来说，ReArch 是以下方面的创新解决方案：

• ⚡️ 状态管理
• 🧮 增量计算
• 🧱 基于组件的软件工程

而有了这些，我们得到

• 通过声明式代码实现响应式
• 松散耦合和高可测试性
• 通过功能化的依赖反转方法实现应用程序级可组合性
• 通过 副作用 实现功能组合

简而言之

在顶层定义你的 "胶囊"（封装的状态片段）

// Capsules are simply functions that consume a CapsuleHandle.
// The CapsuleHandle lets you get the state of other capsules,
// in addition to using a large variety of side effects.

// This capsule provides the count and a way to increment that count.
fn count_manager(CapsuleHandle { register, .. }: CapsuleHandle) -> (u8, impl CData + Fn()) {
    let (count, set_count) = register(effects::state::<Cloned<_>>(0));
    let increment_count = move || set_count(count + 1);
    (count, increment_count)
}

// This capsule provides the count, plus one.
fn count_plus_one_capsule(CapsuleHandle { mut get, .. }: CapsuleHandle) -> u8 {
    let (count, _increment_count) = get(count_manager);
    count + 1
}

let container = Container::new();

let ((count, increment_count), count_plus_one) =
    container.read((count_manager, count_plus_one_capsule));
assert_eq!(count, 0);
assert_eq!(count_plus_one, 1);

increment_count();

let ((count, _), count_plus_one) =
    container.read((count_manager, count_plus_one_capsule));
assert_eq!(count, 1);
assert_eq!(count_plus_one, 2);

入门指南

只需运行： cargo add rearch rearch-effects

然后，为你的应用程序创建一个容器

use rearch::*;
use rearch_effects as effects;

fn main() {
  let container = Container::new();
  // Use the container.
}

并查看 示例 以了解如何创建自己的胶囊！

文档

此外，还有一些 WIP 文档，这些文档将帮助你了解 ReArch 的核心概念！

最低支持的 Rust 版本 (MSRV)

rearch 的当前 MSRV 为 1.75.0，并可能在任何新的 ReArch 版本/发布中更改。本仓库中其他 crate 的 MSRV 将是可预见的未来的最新稳定版。

此外，上文在“概览”中展示的示例需要每晚构建unboxed_closures和fn_traits，这些功能在experimental-api特性下被功能门控。一旦unboxed_closures和fn_traits稳定下来，这种夜间构建的语法将成为首选语法，并且将不再受功能门控的限制。（如果没有夜间构建，您必须调用稍微有点冗长的get.as_ref(some_capsule).clone()和register.register(effect())。）

需要帮助！

尽管我在ReArch上已经做了很多工作，但似乎总还有更多的事情要做。一个人的力量是有限的！

如果您想贡献力量，以下是我非常希望得到帮助的一些领域！

• 文档（特别是内联文档！）
  • 如果您能添加代码示例/提高清晰度，将非常感激。
• 新的副作用！
  • 我已经根据需要创建了很多，但能有更多会更好。
  • 如果您发现自己反复使用自定义副作用，请考虑提交PR！其他开发者也可能用到它。

赞助商

您可以通过这里成为我的工作赞助商：这里！