blob: 7889fde0423532ea0a7c0baeb7b78a0192dc378d (
plain)
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
|
#.rst:
# KDEClangFormat
# --------------------
#
# This module provides a functionality to format the source
# code of your repository according to a predefined KDE
# clang-format file.
#
# This module provides the following function:
#
# ::
#
# kde_clang_format(<files>)
#
# Using this function will create a clang-format target that will format all
# ``<files>`` passed to the function with the predefined KDE clang-format style.
# To format the files you have to invoke the target with ``make clang-format`` or ``ninja clang-format``.
# Once the project is formatted it is recommended to enforce the formatting using a pre-commit hook,
# this can be done using :kde-module:`KDEGitCommitHooks`.
#
# The ``.clang-format`` file from ECM will be copied to the source directory. This file should not be
# added to version control. It is recommended to add it to the ``.gitignore`` file: ``/.clang-format``.
#
# Since 5.79: If the source folder already contains a .clang-format file it is not overwritten.
# Since version 5.80 this function is called by default in KDEFrameworkCompilerSettings. If directories should be excluded from
# the formatting a .clang-format file with "DisableFormat: true" and "SortIncludes: false" should be created.
#
# Example usage:
#
# .. code-block:: cmake
#
# include(KDEClangFormat)
# file(GLOB_RECURSE ALL_CLANG_FORMAT_SOURCE_FILES *.cpp *.h)
# kde_clang_format(${ALL_CLANG_FORMAT_SOURCE_FILES})
#
# To exclude directories from the formatting add a ``.clang-format``
# file in the directory with the following contents:
#
# .. code-block:: yaml
#
# DisableFormat: true
# SortIncludes: false
#
# Since 5.64
#=============================================================================
# SPDX-FileCopyrightText: 2019 Christoph Cullmann <cullmann@kde.org>
# SPDX-FileCopyrightText: 2021 Alexander Lohnau <alexander.lohnau@gmx.de>
#
# SPDX-License-Identifier: BSD-3-Clause
# try to find clang-format in path
find_program(KDE_CLANG_FORMAT_EXECUTABLE clang-format)
# instantiate our clang-format file, must be in source directory for tooling if we have the tool
if(KDE_CLANG_FORMAT_EXECUTABLE)
set(CLANG_FORMAT_FILE ${CMAKE_CURRENT_SOURCE_DIR}/.clang-format)
if (EXISTS ${CLANG_FORMAT_FILE})
file(READ ${CLANG_FORMAT_FILE} CLANG_FORMAT_CONTENTS LIMIT 128)
string(FIND "${CLANG_FORMAT_CONTENTS}" "SPDX-FileCopyrightText: 2019 Christoph Cullmann" matchres)
if(${matchres} EQUAL -1)
message(WARNING "The .clang-format file already exists. Please remove it in order to use the file provided by ECM")
else()
configure_file(${CMAKE_CURRENT_LIST_DIR}/clang-format.cmake ${CLANG_FORMAT_FILE} @ONLY)
endif()
else()
configure_file(${CMAKE_CURRENT_LIST_DIR}/clang-format.cmake ${CLANG_FORMAT_FILE} @ONLY)
endif()
endif()
# formatting target
function(KDE_CLANG_FORMAT)
if (TARGET clang-format)
message(WARNING "the kde_clang_format function was already called")
return()
endif()
# add target without specific commands first, we add the real calls file-per-file to avoid command line length issues
add_custom_target(clang-format COMMENT "Formatting sources in ${CMAKE_CURRENT_SOURCE_DIR} with ${KDE_CLANG_FORMAT_EXECUTABLE}...")
# run clang-format only if available, else signal the user what is missing
if(KDE_CLANG_FORMAT_EXECUTABLE)
get_filename_component(_binary_dir ${CMAKE_BINARY_DIR} REALPATH)
foreach(_file ${ARGV})
# check if the file is inside the build directory => ignore such files
get_filename_component(_full_file_path ${_file} REALPATH)
string(FIND ${_full_file_path} ${_binary_dir} _index)
if(NOT _index EQUAL 0)
add_custom_command(TARGET clang-format
COMMAND
${KDE_CLANG_FORMAT_EXECUTABLE}
-style=file
-i
${_full_file_path}
WORKING_DIRECTORY
${CMAKE_CURRENT_SOURCE_DIR}
COMMENT
"Formatting ${_full_file_path}..."
)
endif()
endforeach()
else()
add_custom_command(TARGET clang-format
COMMAND
${CMAKE_COMMAND} -E echo "Could not set up the clang-format target as the clang-format executable is missing."
)
endif()
endfunction()
|
