dris-rt

dris-rt 是 dris 依赖注入（DI）代码生成器的运行时支持库，配合 dris-macros 与 dris-build 使用。

快速开始

[dependencies]
dris-rt = "0.1.0"

[build-dependencies]
dris-build = "0.1.0"

在 build.rs 中生成容器代码：

fn main() {
    dris_build::generate().unwrap();
}

声明组件与构造函数，并引入生成文件：

use dris_rt::{component, constructor};

#[component(singleton)]
pub struct AppConfig {
    pub port: u16,
}

impl AppConfig {
    #[constructor]
    pub fn new() -> Self {
        Self { port: 8080 }
    }
}

include!(concat!(env!("OUT_DIR"), "/dris_gen.rs"));

fn main() {
    let container = dris_gen::Container::build();
    let cfg = container.app_config(); // root getter
    println!("port={}", cfg.port);
}

注入类型（四种基本形态）

支持：

• T：按值注入（通常用于 Prototype）。
• &T：借用注入（零开销；推荐默认选择，借用关系交给 Rust 类型系统约束）。
• Rc<T>：单线程共享所有权。
• Arc<T>：跨线程共享所有权。

单例持有方式的推断

生成器会按“实际被注入的类型”推断单例在 Container 内部的持有方式：

• 只用到 &T → Container 内存 T（读路径零开销）。
• 某处需要 Rc<T> → Container 内存 Rc<T>。
• 某处需要 Arc<T> → Container 内存 Arc<T>。
• 同一类型同时要求 Rc<T> 与 Arc<T> → 直接报错（无法保证同一实例同时以两种指针形式存在）。

作用域（Prototype / Singleton）

• Prototype：每次获取都会构建新实例。
• Singleton：容器构建时只构建一次并复用。

常用方式：

• #[component(singleton)] 强制单例。
• #[constructor] 返回 Arc<Self>/Rc<Self> 也会被视为单例（并参与上面的持有方式推断）。

约束与建议

• 已移除函数 provider（#[bean] / #[component] fn）。第三方类型/值请用 newtype/struct 包装后再 #[component] + #[constructor]，这样后续加钩子/资源管理更可控。
• Arc/Rc<dyn Trait> 注入：当且仅当某个 trait 只有一个实现时可直接注入；多个实现请用 dris_rt::All<Arc/Rc<dyn Trait>>（或 dris_rt::All<(dris_rt::Type, Arc/Rc<dyn Trait>)>）。