1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
|
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
# file LICENSE.rst or https://cmake.org/licensing for details.
#[=======================================================================[.rst:
FindSubversion
--------------
Finds a Subversion command-line client executable (``svn``) and provides
commands for extracting information from a Subversion working copy:
.. code-block:: cmake
find_package(Subversion [<version>] [...])
Result Variables
^^^^^^^^^^^^^^^^
This module defines the following variables:
``Subversion_FOUND``
Boolean indicating whether (the requested version of) Subversion command-line
client is found. For backward compatibility, the ``SUBVERSION_FOUND``
variable is also set to the same value.
``Subversion_VERSION_SVN``
Version of the ``svn`` command-line client found.
Cache Variables
^^^^^^^^^^^^^^^
The following cache variables may also be set:
``Subversion_SVN_EXECUTABLE``
Path to the ``svn`` command-line client.
Commands
^^^^^^^^
This module provides the following commands if the Subversion command-line
client is found:
.. command:: Subversion_WC_INFO
Extracts information from a Subversion working copy located at a specified
directory:
.. code-block:: cmake
Subversion_WC_INFO(<dir> <var-prefix> [IGNORE_SVN_FAILURE])
This command defines the following variables if running Subversion's ``info``
subcommand on ``<dir>`` succeeds; otherwise a ``SEND_ERROR`` message is
generated:
``<var-prefix>_WC_URL``
URL of the repository (at ``<dir>``).
``<var-prefix>_WC_ROOT``
Root URL of the repository.
``<var-prefix>_WC_REVISION``
Current revision.
``<var-prefix>_WC_LAST_CHANGED_AUTHOR``
Author of last commit.
``<var-prefix>_WC_LAST_CHANGED_DATE``
Date of last commit.
``<var-prefix>_WC_LAST_CHANGED_REV``
Revision of last commit.
``<var-prefix>_WC_INFO``
Output of the command ``svn info <dir>``
The options are:
``IGNORE_SVN_FAILURE``
.. versionadded:: 3.13
When specified, errors from Subversion operation will not trigger a
``SEND_ERROR`` message. In case of an error, the ``<var-prefix>_*``
variables remain undefined.
.. command:: Subversion_WC_LOG
Retrieves the log message of the base revision of a Subversion working copy at
a given location:
.. code-block:: cmake
Subversion_WC_LOG(<dir> <var-prefix>)
This command defines the following variable if running Subversion's ``log``
subcommand on ``<dir>`` succeeds; otherwise a ``SEND_ERROR`` message is
generated:
``<var-prefix>_LAST_CHANGED_LOG``
Last log of the base revision of a Subversion working copy located at
``<dir>``.
Examples
^^^^^^^^
Examples: Finding Subversion
""""""""""""""""""""""""""""
Finding Subversion:
.. code-block:: cmake
find_package(Subversion)
Or, finding Subversion and specifying a minimum required version:
.. code-block:: cmake
find_package(Subversion 1.4)
Or, finding Subversion and making it required (if not found, processing stops
with an error message):
.. code-block:: cmake
find_package(Subversion REQUIRED)
Example: Using Subversion
"""""""""""""""""""""""""
Finding Subversion and retrieving information about the current project's
working copy:
.. code-block:: cmake
find_package(Subversion)
if(Subversion_FOUND)
Subversion_WC_INFO(${PROJECT_SOURCE_DIR} Project)
message("Current revision is ${Project_WC_REVISION}")
Subversion_WC_LOG(${PROJECT_SOURCE_DIR} Project)
message("Last changed log is ${Project_LAST_CHANGED_LOG}")
endif()
#]=======================================================================]
find_program(Subversion_SVN_EXECUTABLE svn
PATHS
[HKEY_LOCAL_MACHINE\\Software\\TortoiseSVN;Directory]/bin
DOC "subversion command line client")
mark_as_advanced(Subversion_SVN_EXECUTABLE)
if(Subversion_SVN_EXECUTABLE)
# the subversion commands should be executed with the C locale, otherwise
# the message (which are parsed) may be translated, Alex
set(_Subversion_SAVED_LC_ALL "$ENV{LC_ALL}")
set(ENV{LC_ALL} C)
execute_process(COMMAND ${Subversion_SVN_EXECUTABLE} --version
OUTPUT_VARIABLE Subversion_VERSION_SVN
ERROR_VARIABLE _Subversion_VERSION_STDERR
RESULT_VARIABLE _Subversion_VERSION_RESULT
OUTPUT_STRIP_TRAILING_WHITESPACE)
# restore the previous LC_ALL
set(ENV{LC_ALL} ${_Subversion_SAVED_LC_ALL})
if(_Subversion_VERSION_RESULT EQUAL 0)
string(REGEX REPLACE "^(.*\n)?svn, version ([.0-9]+).*"
"\\2" Subversion_VERSION_SVN "${Subversion_VERSION_SVN}")
else()
unset(Subversion_VERSION_SVN)
if(_Subversion_VERSION_STDERR MATCHES "svn: error: The subversion command line tools are no longer provided by Xcode")
set(Subversion_SVN_EXECUTABLE Subversion_SVN_EXECUTABLE-NOTFOUND)
endif()
endif()
macro(Subversion_WC_INFO dir prefix)
cmake_parse_arguments(
"Subversion_WC_INFO"
"IGNORE_SVN_FAILURE"
"" ""
${ARGN}
)
# the subversion commands should be executed with the C locale, otherwise
# the message (which are parsed) may be translated, Alex
set(_Subversion_SAVED_LC_ALL "$ENV{LC_ALL}")
set(ENV{LC_ALL} C)
execute_process(COMMAND ${Subversion_SVN_EXECUTABLE} info ${dir}
OUTPUT_VARIABLE ${prefix}_WC_INFO
ERROR_VARIABLE Subversion_svn_info_error
RESULT_VARIABLE Subversion_svn_info_result
OUTPUT_STRIP_TRAILING_WHITESPACE)
if(${Subversion_svn_info_result} EQUAL 0)
string(REGEX REPLACE "^(.*\n)?URL: ([^\n]+).*"
"\\2" ${prefix}_WC_URL "${${prefix}_WC_INFO}")
string(REGEX REPLACE "^(.*\n)?Repository Root: ([^\n]+).*"
"\\2" ${prefix}_WC_ROOT "${${prefix}_WC_INFO}")
string(REGEX REPLACE "^(.*\n)?Revision: ([^\n]+).*"
"\\2" ${prefix}_WC_REVISION "${${prefix}_WC_INFO}")
string(REGEX REPLACE "^(.*\n)?Last Changed Author: ([^\n]+).*"
"\\2" ${prefix}_WC_LAST_CHANGED_AUTHOR "${${prefix}_WC_INFO}")
string(REGEX REPLACE "^(.*\n)?Last Changed Rev: ([^\n]+).*"
"\\2" ${prefix}_WC_LAST_CHANGED_REV "${${prefix}_WC_INFO}")
string(REGEX REPLACE "^(.*\n)?Last Changed Date: ([^\n]+).*"
"\\2" ${prefix}_WC_LAST_CHANGED_DATE "${${prefix}_WC_INFO}")
elseif(NOT Subversion_WC_INFO_IGNORE_SVN_FAILURE)
message(SEND_ERROR "Command \"${Subversion_SVN_EXECUTABLE} info ${dir}\" failed with output:\n${Subversion_svn_info_error}")
endif()
# restore the previous LC_ALL
set(ENV{LC_ALL} ${_Subversion_SAVED_LC_ALL})
endmacro()
macro(Subversion_WC_LOG dir prefix)
# This macro can block if the certificate is not signed:
# svn ask you to accept the certificate and wait for your answer
# This macro requires a svn server network access (Internet most of the time)
# and can also be slow since it access the svn server
execute_process(COMMAND
${Subversion_SVN_EXECUTABLE} --non-interactive log -r BASE ${dir}
OUTPUT_VARIABLE ${prefix}_LAST_CHANGED_LOG
ERROR_VARIABLE Subversion_svn_log_error
RESULT_VARIABLE Subversion_svn_log_result
OUTPUT_STRIP_TRAILING_WHITESPACE)
if(NOT ${Subversion_svn_log_result} EQUAL 0)
message(SEND_ERROR "Command \"${Subversion_SVN_EXECUTABLE} log -r BASE ${dir}\" failed with output:\n${Subversion_svn_log_error}")
endif()
endmacro()
endif()
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(Subversion REQUIRED_VARS Subversion_SVN_EXECUTABLE
VERSION_VAR Subversion_VERSION_SVN )
# for compatibility
set(Subversion_SVN_FOUND ${Subversion_FOUND})
|
