#!/usr/bin/env python import argparse import os import sys import subprocess import re parser = argparse.ArgumentParser(description="""Extract version info from git and generate a version header file. The working directory is expected to be the root of Firmware.""") parser.add_argument('filename', metavar='version.h', help='Header output file') parser.add_argument('--git_tag', help='git tag string') parser.add_argument('-v', '--verbose', dest='verbose', action='store_true', help='Verbose output', default=False) parser.add_argument('--validate', dest='validate', action='store_true', help='Validate the tag format', default=False) args = parser.parse_args() filename = args.filename verbose = args.verbose validate = args.validate try: fp_header = open(filename, 'r') old_header = fp_header.read() except: old_header = '' # Generate the header file content header = """ /* Auto Magically Generated file */ /* Do not edit! */ #pragma once """ # PX4 if args.git_tag: git_tag = args.git_tag else: git_describe_cmd = 'git describe --exclude ext/* --match v[0-9]*.[0-9]*.[0-9]* --abbrev=0 --tags' git_tag = subprocess.check_output(git_describe_cmd.split(), stderr=subprocess.STDOUT).decode('utf-8').strip() try: # get the tag if we're on a tagged commit tag_or_branch = subprocess.check_output((git_describe_cmd+' --exact-match').split(), stderr=subprocess.STDOUT).decode('utf-8').strip() except: tag_or_branch = None if validate: if verbose: print("testing git tag: "+git_tag) # remove optional '-dirty' at the end git_tag_test = re.sub(r'-dirty$', '', git_tag) # remove optional --g at the end (in case we are not on a tagged commit) git_tag_test = re.sub(r'-[0-9]+-g[0-9a-fA-F]+$', '', git_tag_test) # now check the version format m = re.match(r'v([0-9]+)\.([0-9]+)\.[0-9]+(((-dev)|(-alpha[0-9]+)|(-beta[0-9]+)|(-rc[0-9]+))|'\ r'(-[0-9]+\.[0-9]+\.[0-9]+((-dev)|(-alpha[0-9]+)|(-beta[0-9]+)|([-]?rc[0-9]+))?))?$', git_tag_test) if not m: print("") print("Error: the git tag '{:}' does not match the expected format.".format(git_tag_test)) print("") print("The expected format is 'v[-]'") print(" : v..[-rc|-beta|-alpha|-dev]") print(" : ..[-rc|-beta|-alpha|-dev]") print("Examples:") print(" v1.9.0-rc3 (preferred)") print(" v1.9.0-beta1") print(" v1.9.0-1.0.0") print(" v1.9.0-1.0.0-alpha2") print("See also https://docs.px4.io/main/en/dev_setup/building_px4.html#building-for-nuttx") print("") sys.exit(1) git_version = subprocess.check_output('git rev-parse --verify HEAD'.split(), stderr=subprocess.STDOUT).decode('utf-8').strip() try: git_branch_name = subprocess.check_output('git symbolic-ref -q --short HEAD'.split(), stderr=subprocess.STDOUT).decode('utf-8').strip() except: git_branch_name = '' git_version_short = git_version[0:16] # OEM version try: oem_tag = subprocess.check_output('git describe --match ext/oem-* --tags'.split(), stderr=subprocess.STDOUT).decode('utf-8').strip() oem_tag = oem_tag[8:] except: oem_tag = '' if tag_or_branch is None: # replace / so it can be used as directory name tag_or_branch = git_branch_name.replace('/', '-') # either a release or main branch (used for metadata) if not tag_or_branch.startswith('release-'): tag_or_branch = 'main' header += f""" #define PX4_GIT_VERSION_STR "{git_version}" #define PX4_GIT_VERSION_BINARY 0x{git_version_short} #define PX4_GIT_TAG_STR "{git_tag}" #define PX4_GIT_BRANCH_NAME "{git_branch_name}" #define PX4_GIT_OEM_VERSION_STR "{oem_tag}" #define PX4_GIT_TAG_OR_BRANCH_NAME "{tag_or_branch}" // special variable: git tag, release or main branch """ # Mavlink if (os.path.exists('src/modules/mavlink/mavlink/.git')): mavlink_git_version = subprocess.check_output('git rev-parse --verify HEAD'.split(), cwd='src/modules/mavlink/mavlink', stderr=subprocess.STDOUT).decode('utf-8').strip() mavlink_git_version_short = mavlink_git_version[0:16] header += f""" #define MAVLINK_LIB_GIT_VERSION_STR "{mavlink_git_version}" #define MAVLINK_LIB_GIT_VERSION_BINARY 0x{mavlink_git_version_short} """ # NuttX if (os.path.exists('platforms/nuttx/NuttX/nuttx/.git')): nuttx_git_tags = subprocess.check_output('git -c versionsort.suffix=- tag --sort=v:refname'.split(), cwd='platforms/nuttx/NuttX/nuttx', stderr=subprocess.STDOUT).decode('utf-8').strip() nuttx_git_tag = re.findall(r'nuttx-[0-9]+\.[0-9]+\.[0-9]+', nuttx_git_tags)[-1].replace("nuttx-", "v") nuttx_git_tag = re.sub('-.*', '.0', nuttx_git_tag) nuttx_git_version = subprocess.check_output('git rev-parse --verify HEAD'.split(), cwd='platforms/nuttx/NuttX/nuttx', stderr=subprocess.STDOUT).decode('utf-8').strip() nuttx_git_version_short = nuttx_git_version[0:16] header += f""" #define NUTTX_GIT_VERSION_STR "{nuttx_git_version}" #define NUTTX_GIT_VERSION_BINARY 0x{nuttx_git_version_short} #define NUTTX_GIT_TAG_STR "{nuttx_git_tag}" """ if old_header != header: if verbose: print('Updating header {}'.format(filename)) fp_header = open(filename, 'w') fp_header.write(header)