dispose-derive：自动实现Drop trait的Rust资源管理插件库

dispose-derive是一个Rust派生宏库，它简化了资源管理代码，自动为你的类型实现Drop trait，确保资源得到正确清理。

主要功能

• 自动生成Drop trait实现
• 简化资源清理代码
• 支持自定义清理逻辑
• 减少手动实现Drop时的样板代码

使用方法

基本用法

use dispose_derive::Dispose;

#[derive(Dispose)]
struct MyResource {
    // 资源字段
    file: std::fs::File,
    buffer: Vec<u8>,
}

// 自动生成的Drop实现会按字段声明顺序调用它们的drop方法

自定义清理方法

use dispose_derive::Dispose;

#[derive(Dispose)]
struct DatabaseConnection {
    #[dispose(with = "close_connection")]
    connection: ConnectionHandle,
}

fn close_connection(conn: &mut ConnectionHandle) {
    println!("Closing database connection");
    conn.close();
}

忽略字段

use dispose_derive::Dispose;

#[derive(Dispose)]
struct Config {
    #[dispose(skip)]
    settings: HashMap<String, String>, // 这个字段不会被自动清理
    log_file: std::fs::File,
}

高级示例

use dispose_derive::Dispose;

#[derive(Dispose)]
struct GraphicsContext {
    #[dispose(with = "release_texture")]
    texture: TextureHandle,
    #[dispose(with = "release_shader")]
    shader: ShaderProgram,
    viewport: Viewport, // Viewport实现了Drop trait
}

fn release_texture(texture: &mut TextureHandle) {
    unsafe {
        gl::DeleteTextures(1, &texture.id);
    }
}

fn release_shader(shader: &mut ShaderProgram) {
    unsafe {
        gl::DeleteProgram(shader.id);
    }
}

完整示例demo

use dispose_derive::Dispose;
use std::fs::File;
use std::io::Write;

// 自定义资源类型
struct LogFile {
    file: File,
}

impl LogFile {
    fn new(name: &str) -> std::io::Result<Self> {
        let file = File::create(name)?;
        Ok(Self { file })
    }

    fn write(&mut self, msg: &str) -> std::io::Result<()> {
        writeln!(&mut self.file, "{}", msg)
    }
}

// 自定义清理函数
fn close_log(log: &mut LogFile) {
    println!("Closing log file");
    let _ = log.write("=== End of log ===");
}

#[derive(Dispose)]
struct Application {
    #[dispose(with = "close_log")]
    log: LogFile,
    #[dispose(skip)]
    config: String, // 不需要清理的配置字段
    temp_file: File, // 会自动清理的文件
}

fn main() -> std::io::Result<()> {
    let app = Application {
        log: LogFile::new("app.log")?,
        config: String::from("debug=true"),
        temp_file: File::create("temp.txt")?,
    };

    // 使用app...
    app.log.write("Application started")?;
    
    // 当app离开作用域时，会自动调用Drop实现
    // 1. 调用close_log清理log字段
    // 2. 忽略config字段
    // 3. 调用temp_file的drop方法
    Ok(())
}

安装

在Cargo.toml中添加依赖：

[dependencies]
dispose-derive = "0.1"  # 请检查最新版本

注意事项

1. 字段会按照声明顺序被清理
2. 默认情况下，所有字段都会被清理（除非标记#[dispose(skip)]）
3. 对于没有实现Drop的类型，可以使用#[dispose(with = "function")]指定清理函数
4. 清理函数必须接受&mut self参数

dispose-derive特别适合管理需要确定性释放的资源，如文件句柄、网络连接、图形API资源等。