git warp-time

一个 CLI 工具（和 Rust 库），可以将 Git 仓库工作目录中文件的最后修改时间重置为最后修改每个文件的提交的确切时间戳。

作为 Rust 库使用时，请在您的 Cargo.toml 文件中包含它，并按照 crates.io 列表 中的说明使用，并按照 API 文档 使用。

作为 CLI 工具使用时，首先检查您的发行版是否有软件包（例如 Arch Linux）。否则，您可以使用 nix run github:alerque/git-warp-time 以 Nix Flake 运行此存储库，使用 cargo install git-warp-time 安装纯二进制文件，或下载最新的源代码版本并使用 ./configure; make; make install 进行完整安装，包括 Zsh、Bash、Fish、Elvish 和 PowerShell 的自动完成。

CLI 使用方法

在克隆后、任何切换分支的操作后、rebase 等，都可以在任何 Git 工作目录中运行。

$ git clone ‹your project›
$ cd ‹your project›
$ git-warp-time

有关更多信息，请参阅 --help 输出

$ git-warp-time --help
CLI utility that resets the timestamps of files in a Git repository working
directory to the exact timestamp of the last commit which modified each file

Usage: git-warp-time [OPTIONS] [PATHS]...

Arguments:
  [PATHS]...  Optional list of paths to operate on instead of default which is
              all files tracked by Git

Options:
  -d, --dirty         Include files tracked by Git but modifications in the
                      working tee
  -i, --ignored       Include files tracked by Git but also ignored
  -o, --ignore-older  Only touch files that are newer than their history, ignore
                      ones that are older
  -q, --quiet         Don't print any output about files touched or skipped
  -h, --help          Print help
  -V, --version       Print version

库使用方法

在您的 Cargo.toml 文件中。

[dependencies]
git-warp-time = "0.8"

然后，在您的项目中使用类似以下方式使用 crate 函数和类型

use git_warp_time::{get_repo, reset_mtimes};
use git_warp_time::{FileSet, Options};

let repo = get_repo().unwrap();
let mut paths = FileSet::new();
paths.insert("foo.txt".into());
let mut opts = Options::new();
opts.verbose(true).paths(Some(paths));
let files = reset_mtimes(repo, opts).unwrap();
println!("Actioned files: {:?}", files);

CI 使用方法

该程序可以在几乎所有CI平台上运行，无论是作为二进制文件还是使用GitHub容器注册表中找到的Docker容器（docker run ghcr.io/alerque/git-warp-time:latest）。需要注意的是，Git仓库必须以深度检出。浅克隆会导致所有时间戳都和新克隆的最早提交一样新，即比实际时间更晚。

对于GitHub Actions，看起来是这样的

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Git Warp Time
        uses: alerque/git-warp-time:latest

情况概述

无论何时你使用git clone克隆一个项目或使用git checkout检出不同的分支，Git都会在运行Git命令的那一刻将所有相关文件写入你的系统。这是合乎逻辑的。Git正在做正确的事情。对于大多数用例，文件的最新修改时间戳与你在磁盘上更改其状态的时间相同是没有什么问题的。

然而，许多构建系统依赖于文件修改时间戳来理解何时需要重新构建。GNU Make就是一个完全依赖于时间戳的例子，但还有许多其他例子。一些依赖于校验和（例如SCons）并保持一个独立的“上次看到”的文件状态数据库，但由于这需要额外的存储空间，大多数构建系统都使用可用的资源。没有构建系统存储其自身状态的情况下，可用的资源是你的文件系统的元数据。

当你利用Git的低成本分叉模型时，问题就出现了。许多工作流程早期分叉并且频繁分叉。每次你使用git checkout <branch>检查出一个分支时，你的本地工作树都会更新为检查出的时间。在某些情况下，这会导致不必要的重建。