githash

Compile git revision info into Haskell projects

https://github.com/snoyberg/githash#readme

Version on this page:	0.1.6.2
LTS Haskell 20.16:	0.1.6.3
Stackage Nightly 2023-03-30:	0.1.6.3
Latest on Hackage:	0.1.6.3

See all snapshots githash appears in

BSD-3-Clause licensed by Michael Snoyman, Adam C. Foltzer

Maintained by michael@snoyman.com

This version can be pinned in stack with:githash-0.1.6.2@sha256:9a136fa54b3e71e7a90d9dcb62259ffe6d55d083556ab2f15027dd4a4109d41d,1527

Module documentation for 0.1.6.2

GitHash

Depends on 7 packages(full list with versions):

base, bytestring, directory, filepath, process, template-haskell, th-compat

Used by 3 packages in lts-18.28(full list with versions):

optparse-simple, stack, yesod-gitrev

githash

Some handy Template Haskell splices for including the current git hash and branch in the code of your project. Useful for including in panic messages, --version output, or diagnostic info for more informative bug reports.

Most of the complication in the GitHash module is due to the various places the current git hash might be stored:

Detached HEAD: the hash is in .git/HEAD
On a branch or tag: the hash is in a file pointed to by .git/HEAD in a location like .git/refs/heads
On a branch or tag but in a repository with packed refs: the hash is in .git/packed-refs

These situations all arise under normal development workflows, but there might be further scenarios that cause problems. Let me know if you run into them!

Changes

ChangeLog for githash

0.1.6.2

Fixed bugs; now this library’s Template Haskell functions are much more likely on recompilation to detect Git update that doesn’t affect workspace: e.g. git switch -c <new_branch> (equivalently git checkout -b <new_branch>) and git commit --amend --only. Implemented in #23.

0.1.6.1

Support template-haskell 2.17

0.1.6.0

Always include patchlevel and hash in git-describe output
Don’t let user’s configured initial branch name break tests

0.1.5.0

Add git tag output via git-describe

0.1.4.0

Add git-describe output

0.1.3.3

Add git-worktree support #13

0.1.3.2

Test suite works outside of a Git repo #12

0.1.3.1

Clean up some warnings (addresses fpco/optparse-simple#11)

0.1.3.0

Catch exceptions thrown by readCreateProcessWithExitCode to deal with missing git executable #7

0.1.2.0

Add tGitInfoTry and tGitInfoCwdTry

0.1.1.0

Add message of the most recent commit

0.1.0.1

Update the test suite

0.1.0.0

Initial release