tools: add repo-version to print a package version from git references

Author: illwieckz

tools/repo-version/repo-version

@@ -0,0 +1,117 @@
+#! /usr/bin/env python3
+
+# Daemon BSD Source Code
+# Copyright (c) 2024, Daemon Developers
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#  * Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+#  * Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+#  * Neither the name of the <organization> nor the
+#    names of its contributors may be used to endorse or promote products
+#    derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+# DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+import argparse
+import datetime
+import os
+import subprocess
+import sys
+import time
+
+class RepoVersion():
+	git_short_ref_length = 7
+
+	def __init__(self, repository_dir, is_permissive=False, is_quiet=False):
+		if not os.path.isdir(repository_dir):
+			raise(ValueError, "not a directory")
+
+		self.is_permissive = is_permissive
+		self.process_stderr = None
+
+		if is_quiet:
+			self.process_stderr = subprocess.DEVNULL
+
+		self.git_command_list = ["git", "-C", repository_dir]
+
+	def runGitCommand(self, command_list, is_permissive=False):
+		command_list = self.git_command_list + command_list
+
+		process_check = not ( self.is_permissive or is_permissive )
+
+		process = subprocess.run(command_list,
+			stdout=subprocess.PIPE, stderr=self.process_stderr, check=process_check, text=True)
+
+		return process.stdout.rstrip(), process.returncode
+
+	def getDateString(self, timestamp):
+		return datetime.datetime.utcfromtimestamp(timestamp).strftime('%Y%m%d-%H%M%S')
+
+	def getVersionString(self):
+		tag_string="0"
+		date_string="-" + self.getDateString(time.time())
+		ref_string="-0"
+		dirt_string="+dirty"
+
+		git_last_commit_string, git_last_commit_returncode \
+			= self.runGitCommand(["rev-parse", "HEAD", "--"])
+
+		if git_last_commit_returncode == 0:
+			git_last_commit_short_string = git_last_commit_string[:self.git_short_ref_length]
+			ref_string = "-" + git_last_commit_short_string
+
+			git_last_commit_timestamp_string, git_last_commit_timestamp_returncode \
+				= self.runGitCommand(["log", "-1", "--pretty=format:%ct"])
+
+			if git_last_commit_timestamp_returncode == 0:
+				date_string = "-" + self.getDateString(int(git_last_commit_timestamp_string))
+
+			git_closest_tag_string, git_closest_tag_returncode \
+				= self.runGitCommand(["describe", "--tags", "--abbrev=0", "--match", "v[0-9].*"])
+
+			if git_closest_tag_returncode == 0:
+				git_closest_tag_version_string = git_closest_tag_string[1:]
+				tag_string = git_closest_tag_version_string
+
+				git_describe_tag_string, git_describe_tag_returncode \
+					= self.runGitCommand(["describe", "--tags", "--match", "v[0-9].*"])
+				git_describe_version_string = git_describe_tag_string[1:]
+
+				if git_describe_tag_returncode == 0:
+					if git_closest_tag_version_string == git_describe_version_string:
+						date_string = ""
+						ref_string = ""
+
+			git_diff_quiet_string, git_diff_quiet_returncode \
+				= self.runGitCommand(["diff", "--quiet"], is_permissive=True)
+
+			if git_diff_quiet_returncode == 0:
+				dirt_string = ""
+
+		return tag_string + date_string + ref_string + dirt_string
+
+if __name__ == "__main__":
+	parser = argparse.ArgumentParser(description="Print repository version string")
+
+	parser.add_argument("-p", "--permissive", dest="is_permissive", help="ignore Git errors", action="store_true")
+	parser.add_argument("-q", "--quiet", dest="is_quiet", help="silence Git errors", action="store_true")
+	parser.add_argument(dest="repository_dir", nargs="?", metavar="DIRNAME", default=".", help="repository path")
+
+	args = parser.parse_args()
+
+	repoVersion = RepoVersion(args.repository_dir, is_permissive=args.is_permissive, is_quiet=args.is_quiet)
+	print(repoVersion.getVersionString())