1#!/bin/bash 2# 3# Copyright (c) 2019, The OpenThread Authors. 4# All rights reserved. 5# 6# Redistribution and use in source and binary forms, with or without 7# modification, are permitted provided that the following conditions are met: 8# 1. Redistributions of source code must retain the above copyright 9# notice, this list of conditions and the following disclaimer. 10# 2. Redistributions in binary form must reproduce the above copyright 11# notice, this list of conditions and the following disclaimer in the 12# documentation and/or other materials provided with the distribution. 13# 3. Neither the name of the copyright holder nor the 14# names of its contributors may be used to endorse or promote products 15# derived from this software without specific prior written permission. 16# 17# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 18# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 21# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27# POSSIBILITY OF SUCH DAMAGE. 28# 29 30# 31# The script to check or format source code of OpenThread. 32# 33# Format c/c++, markdown, python, and shell: 34# 35# script/make-pretty 36# 37# Format c/c++ only: 38# 39# script/make-pretty clang 40# script/make-pretty clang-format 41# script/make-pretty clang-tidy 42# 43# Format markdown only: 44# 45# script/make-pretty markdown 46# 47# Format python only: 48# 49# script/make-pretty python 50# 51# Format shell only: 52# 53# script/make-pretty shell 54# 55# Check only: 56# 57# script/make-pretty check clang 58# script/make-pretty check clang-format 59# script/make-pretty check clang-tidy 60# script/make-pretty check markdown 61# script/make-pretty check python 62# script/make-pretty check shell 63# 64 65set -euo pipefail 66 67OT_BUILD_JOBS=$(getconf _NPROCESSORS_ONLN) 68readonly OT_BUILD_JOBS 69 70OT_EXCLUDE_DIRS=(third_party doc/site) 71readonly OT_EXCLUDE_DIRS 72 73OT_CLANG_SOURCES=('*.c' '*.cc' '*.cpp' '*.h' '*.hpp') 74readonly OT_CLANG_SOURCES 75 76OT_MARKDOWN_SOURCES=('*.md') 77readonly OT_MARKDOWN_SOURCES 78 79OT_PYTHON_SOURCES=('*.py') 80readonly OT_PYTHON_SOURCES 81 82OT_CLANG_TIDY_FIX_DIRS=('examples' 'include' 'src' 'tests') 83readonly OT_CLANG_TIDY_FIX_DIRS 84 85OT_CLANG_TIDY_BUILD_OPTS=( 86 '-DCMAKE_EXPORT_COMPILE_COMMANDS=ON' 87 '-DOT_ANYCAST_LOCATOR=ON' 88 '-DOT_APP_RCP=OFF' 89 '-DOT_MTD=OFF' 90 '-DOT_RCP=OFF' 91 '-DOT_PLATFORM=simulation' 92 '-DOT_BACKBONE_ROUTER=ON' 93 '-DOT_BORDER_AGENT=ON' 94 '-DOT_BORDER_ROUTER=ON' 95 '-DOT_BORDER_ROUTING=ON' 96 '-DOT_BORDER_ROUTING_DHCP6_PD=ON' 97 '-DOT_CHANNEL_MANAGER=ON' 98 '-DOT_CHANNEL_MONITOR=ON' 99 '-DOT_COAP=ON' 100 '-DOT_COAP_BLOCK=ON' 101 '-DOT_COAP_OBSERVE=ON' 102 '-DOT_COAPS=ON' 103 '-DOT_COMMISSIONER=ON' 104 '-DOT_CSL_RECEIVER=ON' 105 '-DOT_DATASET_UPDATER=ON' 106 '-DOT_DHCP6_CLIENT=ON' 107 '-DOT_DHCP6_SERVER=ON' 108 '-DOT_DIAGNOSTIC=ON' 109 '-DOT_DNS_CLIENT=ON' 110 '-DOT_DNS_DSO=ON' 111 '-DOT_DNS_UPSTREAM_QUERY=ON' 112 '-DOT_DNSSD_SERVER=ON' 113 '-DOT_DUA=ON' 114 '-DOT_MLR=ON' 115 '-DOT_ECDSA=ON' 116 '-DOT_HISTORY_TRACKER=ON' 117 '-DOT_IP6_FRAGM=ON' 118 '-DOT_JAM_DETECTION=ON' 119 '-DOT_JOINER=ON' 120 '-DOT_LINK_RAW=ON' 121 '-DOT_LINK_METRICS_INITIATOR=ON' 122 '-DOT_LINK_METRICS_SUBJECT=ON' 123 '-DOT_MAC_FILTER=ON' 124 '-DOT_MESH_DIAG=ON' 125 '-DOT_NAT64_BORDER_ROUTING=ON' 126 '-DOT_NAT64_TRANSLATOR=ON' 127 '-DOT_NETDATA_PUBLISHER=ON' 128 '-DOT_NETDIAG_CLIENT=ON' 129 '-DOT_PING_SENDER=ON' 130 '-DOT_REFERENCE_DEVICE=ON' 131 '-DOT_SERVICE=ON' 132 '-DOT_SLAAC=ON' 133 '-DOT_SNTP_CLIENT=ON' 134 '-DOT_SRP_CLIENT=ON' 135 '-DOT_SRP_SERVER=ON' 136 '-DOT_THREAD_VERSION=1.3' 137 '-DOT_TREL=ON' 138 '-DOT_COVERAGE=ON' 139 '-DOT_LOG_LEVEL_DYNAMIC=ON' 140 '-DOT_COMPILE_WARNING_AS_ERROR=ON' 141 '-DOT_UPTIME=ON' 142) 143readonly OT_CLANG_TIDY_BUILD_OPTS 144 145do_clang_format() 146{ 147 echo -e '========================================' 148 echo -e ' format c/c++ (clang-format)' 149 echo -e '========================================' 150 151 git ls-files "${OT_CLANG_SOURCES[@]}" | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 152 | xargs -n3 -P"$OT_BUILD_JOBS" script/clang-format -style=file -i -verbose 153} 154 155do_clang_format_check() 156{ 157 echo -e '========================================' 158 echo -e ' check c/c++ (clang-format)' 159 echo -e '========================================' 160 161 git ls-files "${OT_CLANG_SOURCES[@]}" | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 162 | xargs -n3 -P"$OT_BUILD_JOBS" script/clang-format-check 163} 164 165do_clang_tidy_fix() 166{ 167 echo -e '========================================' 168 echo -e ' format c/c++ (clang-tidy)' 169 echo -e '========================================' 170 171 (mkdir -p ./build/cmake-tidy \ 172 && cd ./build/cmake-tidy \ 173 && THREAD_VERSION=1.3 cmake "${OT_CLANG_TIDY_BUILD_OPTS[@]}" ../.. \ 174 && ../../script/clang-tidy -j"$OT_BUILD_JOBS" "${OT_CLANG_TIDY_FIX_DIRS[@]}" -fix) 175} 176 177do_clang_tidy_check() 178{ 179 echo -e '========================================' 180 echo -e ' check c/c++ (clang-tidy)' 181 echo -e '========================================' 182 183 (mkdir -p ./build/cmake-tidy \ 184 && cd ./build/cmake-tidy \ 185 && THREAD_VERSION=1.3 cmake "${OT_CLANG_TIDY_BUILD_OPTS[@]}" ../.. \ 186 && ../../script/clang-tidy -j"$OT_BUILD_JOBS" "${OT_CLANG_TIDY_FIX_DIRS[@]}") 187} 188 189do_markdown_format() 190{ 191 echo -e '========================================' 192 echo -e ' format markdown' 193 echo -e '========================================' 194 195 git ls-files "${OT_MARKDOWN_SOURCES[@]}" | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 196 | xargs -n10 -P"$OT_BUILD_JOBS" npx prettier@2.0.4 --write 197} 198 199do_markdown_check() 200{ 201 echo -e '========================================' 202 echo -e ' check markdown' 203 echo -e '========================================' 204 205 git ls-files "${OT_MARKDOWN_SOURCES[@]}" | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 206 | xargs -n10 -P"$OT_BUILD_JOBS" npx prettier@2.0.4 --check 207} 208 209do_python_format() 210{ 211 echo -e '========================================' 212 echo -e ' format python' 213 echo -e '========================================' 214 215 git ls-files "${OT_PYTHON_SOURCES[@]}" | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 216 | xargs -n10 -P"$OT_BUILD_JOBS" python3 -m yapf --verbose --style '{based_on_style: google, column_limit: 119}' -ipr 217} 218 219do_python_check() 220{ 221 echo -e '========================================' 222 echo -e ' check python' 223 echo -e '========================================' 224 225 git ls-files "${OT_PYTHON_SOURCES[@]}" | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 226 | xargs -n10 -P"$OT_BUILD_JOBS" python3 -m yapf --verbose --style '{based_on_style: google, column_limit: 119}' -dpr 227} 228 229do_shell_format() 230{ 231 echo -e '========================================' 232 echo -e ' format shell' 233 echo -e '========================================' 234 235 git ls-files | xargs shfmt -f | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 236 | xargs -n10 -P"$OT_BUILD_JOBS" shfmt -i 4 -bn -ci -fn -s -w 237} 238 239do_shell_check() 240{ 241 echo -e '========================================' 242 echo -e ' check shell' 243 echo -e '========================================' 244 245 git ls-files | xargs shfmt -f | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 246 | xargs -n10 -P"$OT_BUILD_JOBS" shfmt -i 4 -bn -ci -fn -s -d 247 248 git ls-files | xargs shfmt -f | grep -v -E "^($(echo "${OT_EXCLUDE_DIRS[@]}" | tr ' ' '|'))" \ 249 | xargs -n10 -P"$OT_BUILD_JOBS" shellcheck 250} 251 252do_check() 253{ 254 if [ $# == 0 ]; then 255 do_clang_format_check 256 do_clang_tidy_check 257 do_markdown_check 258 do_python_check 259 do_shell_check 260 elif [ "$1" == 'clang' ]; then 261 do_clang_format_check 262 do_clang_tidy_check 263 elif [ "$1" == 'clang-format' ]; then 264 do_clang_format_check 265 elif [ "$1" == 'clang-tidy' ]; then 266 do_clang_tidy_check 267 elif [ "$1" == 'markdown' ]; then 268 do_markdown_check 269 elif [ "$1" == 'python' ]; then 270 do_python_check 271 elif [ "$1" == 'shell' ]; then 272 do_shell_check 273 else 274 echo >&2 "Unsupported check: $1. Supported: clang, markdown, python, shell" 275 # 128 for Invalid arguments 276 exit 128 277 fi 278} 279 280main() 281{ 282 if [ $# == 0 ]; then 283 do_clang_tidy_fix 284 do_clang_format 285 do_markdown_format 286 do_python_format 287 do_shell_format 288 elif [ "$1" == 'clang' ]; then 289 do_clang_tidy_fix 290 do_clang_format 291 elif [ "$1" == 'clang-format' ]; then 292 do_clang_format 293 elif [ "$1" == 'clang-tidy' ]; then 294 do_clang_tidy_fix 295 elif [ "$1" == 'markdown' ]; then 296 do_markdown_format 297 elif [ "$1" == 'python' ]; then 298 do_python_format 299 elif [ "$1" == 'shell' ]; then 300 do_shell_format 301 elif [ "$1" == 'check' ]; then 302 shift 303 do_check "$@" 304 else 305 echo >&2 "Unsupported action: $1. Supported: clang, markdown, python, shell" 306 # 128 for Invalid arguments 307 exit 128 308 fi 309 310} 311 312main "$@" 313
