Debian Codegraph @

3rdparty/GetVersionFromGitTag.cmake

raw
1 #
2 # This cmake module sets the project version and partial version
3 # variables by analysing the git tag and commit history. It expects git
4 # tags defined with semantic versioning 2.0.0 (http://semver.org/).
5 #
6 # The module expects the PROJECT_NAME variable to be set, and recognizes
7 # the GIT_FOUND, GIT_EXECUTABLE and VERSION_UPDATE_FROM_GIT variables.
8 # If Git is found and VERSION_UPDATE_FROM_GIT is set to boolean TRUE,
9 # the project version will be updated using information fetched from the
10 # most recent git tag and commit. Otherwise, the module will try to read
11 # a VERSION file containing the full and partial versions. The module
12 # will update this file each time the project version is updated.
13 #
14 # Once done, this module will define the following variables:
15 #
16 # ${PROJECT_NAME}_VERSION_STRING - Version string without metadata
17 # such as "v2.0.0" or "v1.2.41-beta.1". This should correspond to the
18 # most recent git tag.
19 # ${PROJECT_NAME}_VERSION_STRING_FULL - Version string with metadata
20 # such as "v2.0.0+3.a23fbc" or "v1.3.1-alpha.2+4.9c4fd1"
21 # ${PROJECT_NAME}_VERSION - Same as ${PROJECT_NAME}_VERSION_STRING,
22 # without the preceding 'v', e.g. "2.0.0" or "1.2.41-beta.1"
23 # ${PROJECT_NAME}_VERSION_MAJOR - Major version integer (e.g. 2 in v2.3.1-RC.2+21.ef12c8)
24 # ${PROJECT_NAME}_VERSION_MINOR - Minor version integer (e.g. 3 in v2.3.1-RC.2+21.ef12c8)
25 # ${PROJECT_NAME}_VERSION_PATCH - Patch version integer (e.g. 1 in v2.3.1-RC.2+21.ef12c8)
26 # ${PROJECT_NAME}_VERSION_TWEAK - Tweak version string (e.g. "RC.2" in v2.3.1-RC.2+21.ef12c8)
27 # ${PROJECT_NAME}_VERSION_AHEAD - How many commits ahead of last tag (e.g. 21 in v2.3.1-RC.2+21.ef12c8)
28 # ${PROJECT_NAME}_VERSION_GIT_SHA - The git sha1 of the most recent commit (e.g. the "ef12c8" in v2.3.1-RC.2+21.ef12c8)
29 #
30 # This module is public domain, use it as it fits you best.
31 # from https://github.com/fakenmc/cmake-git-semver
32 #
33 # Author: Nuno Fachada
34
35 # Check if git is found...
36 if (GIT_EXECUTABLE)
37
38 # Get last tag from git
39 execute_process(COMMAND ${GIT_EXECUTABLE} describe --abbrev=0 --tags
40 WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
41 OUTPUT_VARIABLE ${PROJECT_NAME}_VERSION_STRING
42 OUTPUT_STRIP_TRAILING_WHITESPACE)
43
44 #How many commits since last tag
45 execute_process(COMMAND ${GIT_EXECUTABLE} rev-list master ${${PROJECT_NAME}_VERSION_STRING}^..HEAD --count
46 WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
47 OUTPUT_VARIABLE ${PROJECT_NAME}_VERSION_AHEAD
48 OUTPUT_STRIP_TRAILING_WHITESPACE)
49
50 # Get current commit SHA from git
51 execute_process(COMMAND ${GIT_EXECUTABLE} rev-parse --short HEAD
52 WORKING_DIRECTORY ${CMAKE_SOURCE_DIR}
53 OUTPUT_VARIABLE ${PROJECT_NAME}_VERSION_GIT_SHA
54 OUTPUT_STRIP_TRAILING_WHITESPACE)
55
56 # Get partial versions into a list
57 string(REGEX MATCHALL "-.*$|[0-9]+" ${PROJECT_NAME}_PARTIAL_VERSION_LIST
58 ${${PROJECT_NAME}_VERSION_STRING})
59
60 # Set the version numbers
61 list(GET ${PROJECT_NAME}_PARTIAL_VERSION_LIST
62 0 ${PROJECT_NAME}_VERSION_MAJOR)
63 list(GET ${PROJECT_NAME}_PARTIAL_VERSION_LIST
64 1 ${PROJECT_NAME}_VERSION_MINOR)
65 list(GET ${PROJECT_NAME}_PARTIAL_VERSION_LIST
66 2 ${PROJECT_NAME}_VERSION_PATCH)
67
68 # The tweak part is optional, so check if the list contains it
69 list(LENGTH ${PROJECT_NAME}_PARTIAL_VERSION_LIST
70 ${PROJECT_NAME}_PARTIAL_VERSION_LIST_LEN)
71 if (${PROJECT_NAME}_PARTIAL_VERSION_LIST_LEN GREATER 3)
72 list(GET ${PROJECT_NAME}_PARTIAL_VERSION_LIST 3 ${PROJECT_NAME}_VERSION_TWEAK)
73 string(SUBSTRING ${${PROJECT_NAME}_VERSION_TWEAK} 1 -1 ${PROJECT_NAME}_VERSION_TWEAK)
74 endif()
75
76 # Unset the list
77 unset(${PROJECT_NAME}_PARTIAL_VERSION_LIST)
78
79 # Set full project version string
80 set(${PROJECT_NAME}_VERSION_STRING_FULL
81 ${${PROJECT_NAME}_VERSION_STRING}+${${PROJECT_NAME}_VERSION_AHEAD}.${${PROJECT_NAME}_VERSION_GIT_SHA})
82 else()
83 # Git not available, use fake version
84 set(${PROJECT_NAME}_VERSION_STRING_FULL "v0.0.0-unknown+1.1234567")
85 set(${PROJECT_NAME}_VERSION_STRING "v0.0.0-unknown")
86 set(${PROJECT_NAME}_VERSION_MAJOR "0")
87 set(${PROJECT_NAME}_VERSION_MINOR "0")
88 set(${PROJECT_NAME}_VERSION_PATCH "0")
89 set(${PROJECT_NAME}_VERSION_TWEAK "0")
90 set(${PROJECT_NAME}_VERSION_AHEAD "0")
91 set(${PROJECT_NAME}_VERSION_GIT_SHA "1234567")
92 endif()
93
94
95 # Set project version (without the preceding 'v')
96 set(${PROJECT_NAME}_VERSION ${${PROJECT_NAME}_VERSION_MAJOR}.${${PROJECT_NAME}_VERSION_MINOR}.${${PROJECT_NAME}_VERSION_PATCH})
97 if (${PROJECT_NAME}_VERSION_TWEAK)
98 set(${PROJECT_NAME}_VERSION ${${PROJECT_NAME}_VERSION}-${${PROJECT_NAME}_VERSION_TWEAK})
99 endif()