summaryrefslogtreecommitdiff
path: root/.gitattributes
diff options
context:
space:
mode:
authorDimitri Staessens <dimitri@ouroboros.rocks>2026-02-15 18:54:42 +0100
committerSander Vrijders <sander@ouroboros.rocks>2026-02-18 08:02:26 +0100
commitb6b0b754d99dc2298930cb5db42950bf7c08cc08 (patch)
treea0f9da590f7a40f4af8b818f26241fa973fa4e97 /.gitattributes
parent03b3f0c5345e4ddc4cdfad050e9b28e79ffa6721 (diff)
downloadouroboros-b6b0b754d99dc2298930cb5db42950bf7c08cc08.tar.gz
ouroboros-b6b0b754d99dc2298930cb5db42950bf7c08cc08.zip
build: Automatically parse version from tag
The build will now parse tags so the git tag is now the single source of truth for a version. We do not need to manually maintain the version header. The VERSION file uses git's export-subst feature. When git archive creates a snapshot (e.g. cgit), git substitutes the $Format:...$ placeholder with the output of git describe, embedding the version string directly in the archive. This requires the export-subst attribute to be set for the VERSION file in the repository's .gitattributes. The version is resolved in the following order: - git describe (inside a git repository with tags) - the VERSION file (archives/snapshots) - 0.0.0 (fallback) The build system will warn when it can't set a correct version, such as in a git repo without tags, or an archive without VERSION. Signed-off-by: Dimitri Staessens <dimitri@ouroboros.rocks> Signed-off-by: Sander Vrijders <sander@ouroboros.rocks>
Diffstat (limited to '.gitattributes')
-rw-r--r--.gitattributes1
1 files changed, 1 insertions, 0 deletions
diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 00000000..5f72683f
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+VERSION export-subst