Add and use python for formatting. More cross platform than shell script.

Author: larshg

.ci/azure-pipelines/formatting.yaml

@@ -7,7 +7,7 @@ jobs:
       - checkout: self
         # find the commit hash on a quick non-forced update too
         fetchDepth: 10
-      - script: ./.dev/format.sh $(which clang-format) .
+      - script: python ./.dev/format.py .
         displayName: 'Run clang-format'
       - script: git diff > formatting.patch
         displayName: 'Compute diff'

.dev/format.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+import subprocess
+
+WHITELIST = [
+    "apps/cloud_composer/include/pcl/apps/cloud_composer",
+    "apps/cloud_composer/src/point_selectors",
+    "apps/cloud_composer/tools",
+    "apps/cloud_composer/src/cloud_composer.cpp",
+    "apps/cloud_composer/src/cloud_viewer.cpp",
+    "apps/cloud_composer/src/commands.cpp",
+    "apps/cloud_composer/src/item_inspector.cpp",
+    "apps/cloud_composer/src/items/cloud_composer_item.cpp",
+    "apps/cloud_composer/src/items/fpfh_item.cpp",
+    "apps/cloud_composer/src/main.cpp",
+    "apps/cloud_composer/src/merge_selection.cpp",
+    "apps/cloud_composer/src/properties_model.cpp",
+    "apps/cloud_composer/src/signal_multiplexer.cpp",
+    "apps/cloud_composer/src/tool_interface/abstract_tool.cpp",
+    "apps/cloud_composer/src/toolbox_model.cpp",
+    "apps/cloud_composer/src/transform_clouds.cpp",
+    "apps/cloud_composer/src/work_queue.cpp",
+    "apps/3d_rec_framework",
+    "apps/in_hand_scanner",
+    "apps/include",
+    "apps/modeler",
+    "apps/src",
+    "benchmarks",
+    "2d",
+    "geometry",
+    "ml",
+    "octree",
+    "simulation",
+    "stereo",
+    "tracking",
+    "registration",
+    "gpu/containers",
+    "gpu/segmentation"
+]
+
+EXTENSIONS = (".c", ".h", ".cpp", ".hpp", ".cxx", ".hxx", ".cu")
+
+def find_files(path):
+    if os.path.isfile(path):
+        if path.endswith(EXTENSIONS):
+            yield path
+    elif os.path.isdir(path):
+        for root, _, files in os.walk(path):
+            for file in files:
+                if file.endswith(EXTENSIONS):
+                    yield os.path.join(root, file)
+
+def main():
+    if len(sys.argv) != 2:
+        print("Usage: format.py <PCL_SOURCE_DIR>")
+        sys.exit(1)
+
+    pcl_dir = sys.argv[1]
+
+    if not os.path.isfile(os.path.join(pcl_dir, ".dev/format.py")):
+        print("Please ensure that PCL_SOURCE_DIR is passed as the argument")
+        sys.exit(166)
+
+    all_files = []
+    for rel_path in WHITELIST:
+        abs_path = os.path.join(pcl_dir, rel_path)
+        all_files.extend(find_files(abs_path))
+
+    if not all_files:
+        print("No files found to format.")
+        sys.exit(0)
+
+    clang_format_cmd = ["pipx", "run", "clang-format==14.0.3", "-i", "-style=file"] + all_files
+    subprocess.run(clang_format_cmd)
+
+if __name__ == "__main__":
+    main()