[style] add clang-tidy format

.clang-tidy

@@ -0,0 +1,24 @@
+---
+Checks: >
+  -*,
+  bugprone-argument-comment,
+  bugprone-too-small-loop-variable,
+  google-explicit-constructor,
+  google-readability-casting,
+  misc-include-cleaner,
+  misc-unused-using-decls,
+  modernize-loop-convert,
+  modernize-use-bool-literals,
+  modernize-use-equals-default,
+  modernize-use-equals-delete,
+  modernize-use-nullptr,
+  readability-avoid-const-params-in-decls,
+  readability-else-after-return,
+  readability-inconsistent-declaration-parameter-name,
+  readability-make-member-function-const,
+  readability-redundant-control-flow,
+  readability-redundant-member-init,
+  readability-simplify-boolean-expr,
+  readability-static-accessed-through-instance
+WarningsAsErrors: '*'
+HeaderFilterRegex: '(include|src|tests).*(?<!third_party.*repo)'

.clangd

@@ -0,0 +1,6 @@
+Diagnostics:
+  # for Include Cleaner, see https://clangd.llvm.org/design/include-cleaner
+  UnusedIncludes: Strict
+  MissingIncludes: Strict
+If:
+  PathExclude: third_party/.

.github/workflows/build.yml

@@ -47,8 +47,7 @@ jobs:
       - name: Bootstrap
         run: |
           sudo apt update
-          sudo apt --no-install-recommends install -y clang-format-14
-          python3 -m pip install yapf==0.29.0
+          script/bootstrap.sh
       - name: Check
         run: |
           script/make-pretty check

.gitignore

@@ -51,6 +51,7 @@ cmake-build-*
 #tools
 .vscode
 .idea
+.cache
 CMakeLists.txt.user
 
 #log

include/commissioner/commissioner.hpp

@@ -34,11 +34,11 @@
 #ifndef OT_COMM_COMMISSIONER_HPP_
 #define OT_COMM_COMMISSIONER_HPP_
 
+#include <cstdint>
 #include <functional>
+#include <memory>
 #include <string>
-
-#include <stddef.h>
-#include <stdint.h>
+#include <vector>
 
 #include <commissioner/defines.hpp>
 #include <commissioner/error.hpp>

include/commissioner/error.hpp

@@ -34,9 +34,9 @@
 #ifndef OT_COMM_ERROR_HPP_
 #define OT_COMM_ERROR_HPP_
 
-#include <memory>
 #include <ostream>
 #include <string>
+#include <utility>
 
 #include <commissioner/defines.hpp>
 
@@ -227,18 +227,9 @@ class OT_COMM_MUST_USE_RESULT Error
     std::string mMessage;
 };
 
-inline Error::Error(const Error &aError)
-    : mCode(aError.mCode)
-    , mMessage(aError.mMessage)
-{
-}
+inline Error::Error(const Error &aError) = default;
 
-inline Error &Error::operator=(const Error &aError)
-{
-    mCode    = aError.mCode;
-    mMessage = aError.mMessage;
-    return *this;
-}
+inline Error &Error::operator=(const Error &aError) = default;
 
 inline Error::Error(Error &&aError) noexcept
     : mCode(std::move(aError.mCode))

include/commissioner/network_data.hpp

@@ -34,9 +34,9 @@
 #ifndef OT_COMM_NETWORK_DATA_HPP_
 #define OT_COMM_NETWORK_DATA_HPP_
 
+#include <cstdint>
 #include <string>
-
-#include <stdint.h>
+#include <vector>
 
 #include <commissioner/defines.hpp>
 #include <commissioner/error.hpp>
@@ -69,10 +69,10 @@ struct XpanId
 
     bool operator==(const XpanId &aOther) const;
 
-    bool operator!=(const uint64_t aOther) const;
-    bool operator<(const XpanId aOther) const;
+    bool operator!=(const XpanId &aOther) const;
+    bool operator<(const XpanId &aOther) const;
 
-    operator std::string() const;
+    explicit operator std::string() const;
 
     /**
      * Decodes hexadecimal string.
@@ -257,12 +257,14 @@ struct PanId
     static constexpr uint64_t kEmptyPanId = 0;
 
     uint16_t mValue;
-    PanId(uint16_t aValue);
+    explicit PanId(uint16_t aValue);
+    PanId(const PanId &aOther) = default;
     PanId();
 
-    PanId &operator=(uint16_t aValue);
-           operator uint16_t() const;
-           operator std::string() const;
+    PanId   &operator=(const PanId &aValue) = default;
+    PanId   &operator=(uint16_t aValue);
+    explicit operator uint16_t() const;
+    explicit operator std::string() const;
 
     Error FromHex(const std::string &aInput);
 };

script/bootstrap.sh

@@ -92,7 +92,7 @@ if [ "$(uname)" = "Linux" ]; then
                          lcov \
                          jsonlint
 
-    sudo apt-get --no-install-recommends install -y clang-format-14 || echo 'WARNING: could not install clang-format-14, which is useful if you plan to contribute C/C++ code to the OpenThread project.'
+    sudo apt-get --no-install-recommends install -y clang-format-14 clang-tidy-14 || echo 'WARNING: could not install clang-format-14 and clang-tidy-14, which is useful if you plan to contribute C/C++ code to the OpenThread project.'
     python3 -m pip install yapf==0.29.0 || echo 'WARNING: could not install yapf, which is useful if you plan to contribute python code to the OpenThread project.'
 
     ## Install newest CMake
@@ -118,8 +118,12 @@ elif [ "$(uname)" = "Darwin" ]; then
                  swig@4 \
                  lcov && true
 
-    brew install llvm@14 && sudo ln -s "$(brew --prefix llvm@14)/bin/clang-format" /usr/local/bin/clang-format-14 \
-    || echo 'WARNING: could not install clang-format-14, which is useful if you plan to contribute C/C++ code to the OpenThread project.'
+    brew install llvm@14 && \
+    sudo ln -s "$(brew --prefix llvm@14)/bin/clang-format" /usr/local/bin/clang-format-14 && \
+    sudo ln -s "$(brew --prefix llvm@14)/bin/clang-tidy" /usr/local/bin/clang-tidy-14 && \
+    sudo ln -s "$(brew --prefix llvm@14)/bin/clang-apply-replacements" /usr/local/bin/clang-apply-replacements-14 && \
+    sudo ln -s "$(brew --prefix llvm@14)/bin/run-clang-tidy" /usr/local/bin/run-clang-tidy-14 || \
+    echo 'WARNING: could not install clang-format-14, which is useful if you plan to contribute C/C++ code to the OpenThread project.'
 
     ## Install latest cmake
     match_version "$(cmake --version | grep -E -o '[0-9].*')" "${MIN_CMAKE_VERSION}" || {

script/clang-tidy

@@ -0,0 +1,86 @@
+#!/bin/bash
+#
+#  Copyright (c) 2020, The OpenThread Authors.
+#  All rights reserved.
+#
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+#  1. Redistributions of source code must retain the above copyright
+#     notice, this list of conditions and the following disclaimer.
+#  2. Redistributions in binary form must reproduce the above copyright
+#     notice, this list of conditions and the following disclaimer in the
+#     documentation and/or other materials provided with the distribution.
+#  3. Neither the name of the copyright holder nor the
+#     names of its contributors may be used to endorse or promote products
+#     derived from this software without specific prior written permission.
+#
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+
+CLANG_TIDY_VERSION="LLVM version 14.0"
+CLANG_APPLY_REPLACEMENTS_VERSION="clang-apply-replacements version 14.0"
+
+die()
+{
+    echo " *** ERROR: $*"
+    exit 1
+}
+
+# Search for clang-tidy-14
+if command -v clang-tidy-14 >/dev/null; then
+    clang_tidy=$(command -v clang-tidy-14)
+elif command -v clang-tidy >/dev/null; then
+    clang_tidy=$(command -v clang-tidy)
+    case "$($clang_tidy --version)" in
+        *"$CLANG_TIDY_VERSION"*) ;;
+
+        *)
+            die "$($clang_tidy --version); $CLANG_TIDY_VERSION required"
+            ;;
+    esac
+else
+    die "clang-tidy 14.0 required"
+fi
+
+# Search for clang-apply-replacements-14
+if command -v clang-apply-replacements-14 >/dev/null; then
+    clang_apply_replacements=$(command -v clang-apply-replacements-14)
+elif command -v clang-apply-replacements >/dev/null; then
+    clang_apply_replacements=$(command -v clang-apply-replacements)
+    case "$($clang_apply_replacements --version)" in
+        "$CLANG_APPLY_REPLACEMENTS_VERSION"*) ;;
+
+        *)
+            die "$($clang_apply_replacements --version); $CLANG_APPLY_REPLACEMENTS_VERSION required"
+            ;;
+    esac
+else
+    die "clang-apply-replacements 14.0 required"
+fi
+
+# Search for run-clang-tidy-14.py
+if command -v run-clang-tidy-14.py >/dev/null; then
+    run_clang_tidy=$(command -v run-clang-tidy-14.py)
+elif command -v run-clang-tidy-14 >/dev/null; then
+    run_clang_tidy=$(command -v run-clang-tidy-14)
+elif command -v run-clang-tidy.py >/dev/null; then
+    run_clang_tidy=$(command -v run-clang-tidy.py)
+elif command -v run-clang-tidy >/dev/null; then
+    run_clang_tidy=$(command -v run-clang-tidy)
+else
+    die "run-clang-tidy.py 14.0 required"
+fi
+
+$run_clang_tidy -clang-tidy-binary "$clang_tidy" -clang-apply-replacements-binary "$clang_apply_replacements" "$@" || die
+
+exit 0

script/make-pretty

@@ -37,6 +37,7 @@
 # Format c/c++ only:
 #
 #     script/make-pretty clang
+#     script/make-pretty clang-tidy
 #
 # Format markdown only:
 #
@@ -49,18 +50,27 @@
 # Check only:
 #
 #     script/make-pretty check clang
+#     script/make-pretty check clang-tidy
 #     script/make-pretty check markdown
 #     script/make-pretty check python
 #
 
 set -euo pipefail
 
+readonly OT_COMM_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )/.." &> /dev/null && pwd )
+
 readonly OT_BUILD_JOBS=$(getconf _NPROCESSORS_ONLN)
 readonly OT_EXCLUDE_DIRS=(third_party)
 
 readonly OT_CLANG_SOURCES=('*.c' '*.cc' '*.cpp' '*.h' '*.hpp')
 readonly OT_MARKDOWN_SOURCES=('*.md')
 readonly OT_PYTHON_SOURCES=('*.py')
+readonly OT_CLANG_TIDY_FIX_DIRS=("${OT_COMM_DIR}/include" "${OT_COMM_DIR}/src" "${OT_COMM_DIR}/tests")
+
+OT_CLANG_TIDY_BUILD_OPTS=(
+    '-DCMAKE_EXPORT_COMPILE_COMMANDS=ON'
+)
+readonly OT_CLANG_TIDY_BUILD_OPTS
 
 do_clang_format()
 {
@@ -82,6 +92,30 @@ do_clang_check()
         | xargs -n3 -P"${OT_BUILD_JOBS}" script/clang-format-check
 }
 
+do_clang_tidy_fix()
+{
+    echo -e '========================================'
+    echo -e '     format c/c++ (clang-tidy)'
+    echo -e '========================================'
+
+    (mkdir -p ./build/cmake-tidy \
+        && cd ./build/cmake-tidy \
+        && cmake "${OT_CLANG_TIDY_BUILD_OPTS[@]}" ../.. \
+        && ../../script/clang-tidy -j"$OT_BUILD_JOBS" "${OT_CLANG_TIDY_FIX_DIRS[@]}" -fix)
+}
+
+do_clang_tidy_check()
+{
+    echo -e '========================================'
+    echo -e '     check c/c++ (clang-tidy)'
+    echo -e '========================================'
+
+    (mkdir -p ./build/cmake-tidy \
+        && cd ./build/cmake-tidy \
+        && cmake "${OT_CLANG_TIDY_BUILD_OPTS[@]}" ../.. \
+        && ../../script/clang-tidy -j"$OT_BUILD_JOBS" "${OT_CLANG_TIDY_FIX_DIRS[@]}")
+}
+
 do_markdown_format()
 {
     echo -e '======================'
@@ -126,10 +160,13 @@ do_check()
 {
     if [ $# == 0 ]; then
         do_clang_check
+        do_clang_tidy_check
         do_markdown_check
         do_python_check
     elif [ "$1" == 'clang' ]; then
         do_clang_check
+    elif [ "$1" == 'clang-tidy' ]; then
+        do_clang_tidy_check
     elif [ "$1" == 'markdown' ]; then
         do_markdown_check
     elif [ "$1" == 'python' ]; then
@@ -149,6 +186,8 @@ main()
         do_python_format
     elif [ "$1" == 'clang' ]; then
         do_clang_format
+    elif [ "$1" == 'clang-tidy' ]; then
+        do_clang_tidy_fix
     elif [ "$1" == 'markdown' ]; then
         do_markdown_format
     elif [ "$1" == 'python' ]; then