Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install special-git-commit

It will make the special-git-commit command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall special-git-commit uninstalls.

Back to the crate overview.

Readme

special-git-commit

A command line tool for generating commit hashes with specified prefixes.

Simple and readable
Using libgit2 API instead of calling git xxx commands
Using multiple threads

Installation

Cargo install

cargo install special-git-commit

Build from source

git clone https://github.com/OmmyZhang/special-git-commit-hash.git
cd special-git-commit-hash
cargo build --release

Download from releases

Executable files for Linux, Mac and Windows.

Releases

Usage

special-git-commit <target-prefix>

special-git-commit

It will amend the HEAD commit with the target prefix. If no prefix is provided, the default prefix 0000000 will be used.

How it works

Let the result of git cat-file commit HEAD be contents.

$ git cat-file commit HEAD                                                                                                                                                    master
tree 66b5178f6feba85812818aeaca5a86b07cdd106f
parent 0000004a2eddb98c4b005362dd4fe37636633b3f
author Tdxdxoz <tdxdxoz@gmail.com> 1711436406 +0800
committer Tdxdxoz <tdxdxoz@gmail.com> 1711436919 +0800

update README

The hash of this commit (HEAD) is sha128("commit {contents.len()}\0{content}").

commit 216\0tree 66b5178f6feba85812818aeaca5a86b07cdd106f
parent 0000004a2eddb98c4b005362dd4fe37636633b3f
author Tdxdxoz <tdxdxoz@gmail.com> 1711436406 +0800
committer Tdxdxoz <tdxdxoz@gmail.com> 1711436919 +0800

update README

A prefix will be added to the committer's name, and checked if the new sha128 result matches.

You can ...

use it to

have fun
help find potential vulnerabilities of tools that use git commit hashes
- only use short hashes
- incorrectly interpret commit hashes as integers instead of strings (for example, in YAML)
- ...

and not use it

in production