Readonly

此 crate 提供了一个属性宏，用于暴露那些在模块内可读可写但在模块外只可读的结构体字段。

[dependencies]
readonly = "0.2"

语法

在花括号结构体或元组结构体上放置 #[readonly::make]，这将使结构体的所有字段根据它们的各自可见性说明符公开可读，但不能从其他模块写入。

mod m {
    #[readonly::make]
    pub struct S {
        pub n: i32,
    }

    impl S {
        pub fn demo(&mut self) {
            // Can read and write from inside the same module.
            println!("{}", self.n);
            self.n += 1;
        }
    }
}

fn demo(s: &mut m::S) {
    // From outside the module, can only read.
    println!("{}", s.n);

    // Does not compile:
    //s.n += 1;
}

错误将显示如下。

error[E0594]: cannot assign to data in a dereference of `m::S`
  --> readme.rs:21:5
   |
21 |     s.n += 1;
   |     ^^^^^^^^ cannot assign

可选地，在单个结构体字段上放置 #[readonly]，仅使那些字段公开可读，而不会影响结构体的其他字段。

#[readonly::make]
pub struct S {
    // This field can be read (but not written) by super.
    #[readonly]
    pub(super) readable: i32,

    // This field can be neither read nor written by other modules.
    private: i32,
}

许可