基于Rust构建一个Git提交历史可视化工具

// 核心数据结构
pub struct CommitNode {
    pub id: String,           // 提交短哈希
    pub author: String,       // 作者
    pub email: String,        // 邮箱
    pub timestamp: i64,       // 时间戳
    pub message_summary: String,  // 提交摘要
    pub is_merge: bool,       // 是否为合并提交
}

pub struct CommitGraph {
    pub nodes: Vec<CommitNode>,
    pub edges: Vec<Edge>,     // parent -> child 关系
}

// 获取拓扑排序的提交历史
let mut args = vec![
    "rev-list".into(), 
    "--topo-order".into(), 
    "--date-order".into(), 
    "--parents".into()
];

// 智能过滤支持
if let Some(since) = &opts.since { 
    args.push(format!("--since={}", since)); 
}
if let Some(max) = opts.max_commits { 
    args.push(format!("--max-count={}", max)); 
}

// 确保所有边都指向存在的节点
let ids: HashSet<String> = graph.nodes.iter()
    .map(|n| n.id.clone())
    .collect();
graph.edges.retain(|e| ids.contains(&e.from) && ids.contains(&e.to));

// DOT 输出中，合并提交用特殊样式标识
if node.is_merge {
    attrs.push_str(", shape=box, style=filled, fillcolor=lightgray");
}

// 在程序早期就检查必要的环境条件
run_git(&["rev-parse".into(), "--git-dir".into()])?;

#[derive(Parser, Debug)]
pub struct Args {
    #[arg(long, help = "Only include commits since this date")]
    pub since: Option<String>,
    
    #[arg(long, help = "Branch to traverse")]
    pub branch: Option<String>,
    
    #[arg(long, required = true, help = "Output file path")]
    pub output: String,
}

# 每周自动生成主干分支的提交图
0 9 * * 1 cd /path/to/repo && git-graph-rs \
    --since "1 week ago" \
    --branch main \
    --output /var/reports/weekly_commits.dot

# 分析最近一个月的主干分支历史
git-graph-rs --since "2024-01-01" --branch main --output main_history.dot

# 使用Graphviz渲染
dot -Tpng main_history.dot -o main_history.png

{
  "nodes": [
    {
      "id": "d2c322e",
      "author": "Tester",
      "email": "tester@example.com",
      "timestamp": 1763102276,
      "message_summary": "feat: dev",
      "is_merge": false
    },
    {
      "id": "6c8bb7a",
      "author": "Tester",
      "email": "tester@example.com",
      "timestamp": 1763102276,
      "message_summary": "feat: second",
      "is_merge": false
    },
    {
      "id": "00e0bc0",
      "author": "Tester",
      "email": "tester@example.com",
      "timestamp": 1763102276,
      "message_summary": "feat: first",
      "is_merge": false
    },
    {
      "id": "a1b2c3d",
      "author": "Developer",
      "email": "developer@example.com",
      "timestamp": 1763188676,
      "message_summary": "feat(ui): step1",
      "is_merge": false
    },
    {
      "id": "b2c3d4e",
      "author": "Developer",
      "email": "developer@example.com",
      "timestamp": 1763189676,
      "message_summary": "feat(ui): step2",
      "is_merge": false
    },
    {
      "id": "c3d4e5f",
      "author": "Maintainer",
      "email": "maintainer@example.com",
      "timestamp": 1763275076,
      "message_summary": "merge: feat/ui into main",
      "is_merge": true
    }
  ],
  "edges": [
    { "from": "00e0bc0", "to": "6c8bb7a" },
    { "from": "6c8bb7a", "to": "d2c322e" },
    { "from": "00e0bc0", "to": "a1b2c3d" },
    { "from": "a1b2c3d", "to": "b2c3d4e" },
    { "from": "d2c322e", "to": "c3d4e5f" },
    { "from": "b2c3d4e", "to": "c3d4e5f" }
  ]
}

cargo install git-graph-rs
cd your-git-repo
git-graph-rs --output history.dot