Rust DAG渲染库sapling-renderdag的使用，高效可视化有向无环图结构与依赖关系

安装

在项目目录中运行以下Cargo命令：

cargo add sapling-renderdag

或者在Cargo.toml中添加以下行：

sapling-renderdag = "0.1.0"

使用示例

下面是一个完整的示例，展示如何使用sapling-renderdag库来创建和可视化DAG(有向无环图):

use sapling_renderdag::{RenderDag, Node, Edge};

fn main() {
    // 创建DAG结构
    let mut dag = RenderDag::new();
    
    // 添加节点
    let node1 = dag.add_node(Node::new("Task A".to_string()));
    let node2 = dag.add_node(Node::new("Task B".to_string()));
    let node3 = dag.add_node(Node::new("Task C".to_string()));
    let node4 = dag.add_node(Node::new("Task D".to_string()));
    
    // 添加边表示依赖关系
    dag.add_edge(Edge::new(node1, node2)); // Task A -> Task B
    dag.add_edge(Edge::new(node1, node3)); // Task A -> Task C
    dag.add_edge(Edge::new(node2, node4)); // Task B -> Task D
    dag.add_edge(Edge::new(node3, node4)); // Task C -> Task D
    
    // 渲染DAG
    let svg = dag.render().unwrap();
    
    // 将SVG输出到文件
    std::fs::write("dag_output.svg", svg).unwrap();
    
    println!("DAG已成功渲染到dag_output.svg文件");
}

完整示例代码

以下是一个更完整的示例，展示了如何自定义节点样式和处理更复杂的DAG结构：

use sapling_renderdag::{RenderDag, Node, Edge, NodeStyle};

fn main() {
    // 创建DAG结构
    let mut dag = RenderDag::new();
    
    // 自定义节点样式
    let success_style = NodeStyle {
        fill: Some("#4CAF50".to_string()),  // 绿色
        stroke: Some("#2E7D32".to_string()), // 深绿色边框
        ..Default::default()
    };
    
    let running_style = NodeStyle {
        fill: Some("#2196F3".to_string()),  // 蓝色
        stroke: Some("#0D47A1".to_string()), // 深蓝色边框
        ..Default::default()
    };
    
    let failed_style = NodeStyle {
        fill: Some("#F44336".to_string()),  // 红色
        stroke: Some("#B71C1C".to_string()), // 深红色边框
        ..Default::default()
    };
    
    // 添加节点并应用样式
    let node1 = dag.add_node(Node::new("Initialize".to_string()).with_style(&success_style));
    let node2 = dag.add_node(Node::new("Load Data".to_string()).with_style(&success_style));
    let node3 = dag.add_node(Node::new("Process".to_string()).with_style(&running_style));
    let node4 = dag.add_node(Node::new("Validate".to_string()));
    let node5 = dag.add_node(Node::new("Failed Task".to_string()).with_style(&failed_style));
    let node6 = dag.add_node(Node::new("Finalize".to_string()));
    
    // 添加边表示依赖关系
    dag.add_edge(Edge::new(node1, node2)); // Initialize -> Load Data
    dag.add_edge(Edge::new(node2, node3)); // Load Data -> Process
    dag.add_edge(Edge::new(node3, node4)); // Process -> Validate
    dag.add_edge(Edge::new(node4, node6)); // Validate -> Finalize
    dag.add_edge(Edge::new(node3, node5)); // Process -> Failed Task
    
    // 添加并行列
    let node7 = dag.add_node(Node::new("Parallel Task 1".to_string()));
    let node8 = dag.add_node(Node::new("Parallel Task 2".to_string()));
    dag.add_edge(Edge::new(node2, node7)); // Load Data -> Parallel Task 1
    dag.add_edge(Edge::new(node2, node8)); // Load Data -> Parallel Task 2
    dag.add_edge(Edge::new(node7, node6)); // Parallel Task 1 -> Finalize
    dag.add_edge(Edge::new(node8, node6)); // Parallel Task 2 -> Finalize
    
    // 渲染DAG
    match dag.render() {
        Ok(svg) => {
            std::fs::write("complex_dag.svg", svg).unwrap();
            println!("复杂DAG已成功渲染到complex_dag.svg文件");
        }
        Err(e) => eprintln!("渲染DAG时出错: {}", e),
    }
}

这个库由Facebook团队维护，适合需要可视化任务依赖关系、工作流或任何DAG结构的应用场景。通过简单的API，开发者可以快速创建专业的图表来展示复杂的关系网络。