Format code

Author: mingxwa

.gitattributes

@@ -1 +1 @@
-* text=auto
+* text=auto eol=lf

CMakeLists.txt

@@ -24,24 +24,29 @@ if(PROJECT_IS_TOP_LEVEL)
   )
 endif()
 
-target_sources(msft_proxy4
+target_sources(
+  msft_proxy4
   INTERFACE
     FILE_SET public_headers
-    TYPE HEADERS 
-    BASE_DIRS include
-    FILES
-      include/proxy/proxy.h
-      include/proxy/proxy_macros.h
-      include/proxy/proxy_fmt.h
-      include/proxy/v4/proxy.ixx
-      include/proxy/v4/proxy.h
-      include/proxy/v4/proxy_macros.h
-      include/proxy/v4/proxy_fmt.h
+      TYPE HEADERS
+      BASE_DIRS include
+      FILES
+        include/proxy/proxy.h
+        include/proxy/proxy_macros.h
+        include/proxy/proxy_fmt.h
+        include/proxy/v4/proxy.ixx
+        include/proxy/v4/proxy.h
+        include/proxy/v4/proxy_macros.h
+        include/proxy/v4/proxy_fmt.h
 )
 
 target_compile_features(msft_proxy4 INTERFACE cxx_std_20)
-target_include_directories(msft_proxy4 INTERFACE $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
-                                                $<INSTALL_INTERFACE:include>)
+target_include_directories(
+  msft_proxy4
+  INTERFACE
+    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
+    $<INSTALL_INTERFACE:include>
+)
 
 # Do not set the module target if proxy is consumed as a subdirectory.
 if(PROJECT_IS_TOP_LEVEL)
@@ -58,9 +63,10 @@ endif()
 
 include(GNUInstallDirs)
 
-install(TARGETS msft_proxy4
-        EXPORT msft_proxy4Targets
-        FILE_SET public_headers DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
+install(
+  TARGETS msft_proxy4
+  EXPORT msft_proxy4Targets
+  FILE_SET public_headers DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
 )
 
 install(
@@ -83,19 +89,21 @@ configure_package_config_file(
 )
 
 include(CMakePackageConfigHelpers)
-write_basic_package_version_file(cmake/msft_proxy4ConfigVersion.cmake
-                                 COMPATIBILITY SameMajorVersion
-                                 ARCH_INDEPENDENT)
+write_basic_package_version_file(
+  cmake/msft_proxy4ConfigVersion.cmake
+  COMPATIBILITY SameMajorVersion
+  ARCH_INDEPENDENT
+)
 
 install(
-  FILES 
+  FILES
     ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy4Config.cmake
     ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy4ConfigVersion.cmake
   DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy4
 )
 
 # build tests if BUILD_TESTING is ON
-if (BUILD_TESTING)
+if(BUILD_TESTING)
   include(CTest)
 
   include(FetchContent)
@@ -108,7 +116,8 @@ if (BUILD_TESTING)
   FetchContent_Declare(
     fmt
     URL https://github.com/fmtlib/fmt/archive/refs/tags/12.1.0.tar.gz
-    URL_HASH SHA256=ea7de4299689e12b6dddd392f9896f08fb0777ac7168897a244a6d6085043fea
+    URL_HASH
+      SHA256=ea7de4299689e12b6dddd392f9896f08fb0777ac7168897a244a6d6085043fea
     SYSTEM
   )
   FetchContent_MakeAvailable(fmt)
@@ -117,7 +126,13 @@ if (BUILD_TESTING)
     set(PROXY_BUILD_FLAGS /utf-8 /W4)
     set(PROXY_STRICT_WARNING_FLAGS ${PROXY_BUILD_FLAGS} /WX)
   else()
-    set(PROXY_BUILD_FLAGS -Wall -Wextra -Wpedantic $<$<CXX_COMPILER_ID:Clang>:-Wno-c++2b-extensions>)
+    set(
+      PROXY_BUILD_FLAGS
+      -Wall
+      -Wextra
+      -Wpedantic
+      $<$<CXX_COMPILER_ID:Clang>:-Wno-c++2b-extensions>
+    )
     set(PROXY_STRICT_WARNING_FLAGS ${PROXY_BUILD_FLAGS} -Werror)
   endif()
 

MODULE.bazel

@@ -6,13 +6,17 @@ module(
 bazel_dep(name = "platforms", version = "1.1.0")
 bazel_dep(name = "rules_cc", version = "0.2.18")
 bazel_dep(name = "bazel_skylib", version = "1.8.2")
+
 bazel_dep(name = "googletest", version = "1.17.0.bcr.2", dev_dependency = True)
 bazel_dep(name = "google_benchmark", version = "1.9.5", dev_dependency = True)
 bazel_dep(name = "fmt", version = "12.1.0", dev_dependency = True)
 bazel_dep(name = "rules_python", version = "2.0.2", dev_dependency = True)
 
 python = use_extension("@rules_python//python/extensions:python.bzl", "python", dev_dependency = True)
-python.toolchain(python_version = "3.12", is_default = True)
+python.toolchain(
+    is_default = True,
+    python_version = "3.12",
+)
 use_repo(python, bootstrap_python = "python_3_12_host")
 
 use_repo_rule("//tools:doc_examples.bzl", "doc_examples")(name = "doc_examples")

SUPPORT.md

@@ -1,16 +1,16 @@
-# Support
-
-## How to file issues and get help  
-
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing
-issues before filing new ones to avoid duplicates. For new issues, file your bug or feature request
-as a new issue.
-
-For help and questions about using this project, please use GitHub Discussions:
-
-- https://github.com/ngcpp/proxy/discussions
-
-## Support Policy
-
-Support for this project is provided on a best-effort basis by the community and maintainers via
-the resources listed above.
+# Support
+
+## How to file issues and get help  
+
+This project uses GitHub Issues to track bugs and feature requests. Please search the existing
+issues before filing new ones to avoid duplicates. For new issues, file your bug or feature request
+as a new issue.
+
+For help and questions about using this project, please use GitHub Discussions:
+
+- https://github.com/ngcpp/proxy/discussions
+
+## Support Policy
+
+Support for this project is provided on a best-effort basis by the community and maintainers via
+the resources listed above.

benchmarks/CMakeLists.txt

@@ -3,17 +3,35 @@ project(msft_proxy_benchmarks)
 FetchContent_Declare(
   benchmark
   URL https://github.com/google/benchmark/archive/refs/tags/v1.9.5.tar.gz
-  URL_HASH SHA256=9631341c82bac4a288bef951f8b26b41f69021794184ece969f8473977eaa340
+  URL_HASH
+    SHA256=9631341c82bac4a288bef951f8b26b41f69021794184ece969f8473977eaa340
+)
+set(
+  BENCHMARK_ENABLE_TESTING
+  OFF
+  CACHE BOOL
+  "Disable tests for google benchmark"
+)
+set(
+  BENCHMARK_ENABLE_GTEST_TESTS
+  OFF
+  CACHE BOOL
+  "Disable google benchmark unit tests"
 )
-set(BENCHMARK_ENABLE_TESTING OFF CACHE BOOL "Disable tests for google benchmark")
-set(BENCHMARK_ENABLE_GTEST_TESTS OFF CACHE BOOL "Disable google benchmark unit tests")
 FetchContent_MakeAvailable(benchmark)
 
-add_executable(msft_proxy_benchmarks
+add_executable(
+  msft_proxy_benchmarks
   proxy_creation_benchmark.cpp
   proxy_operation_benchmark_context.cpp
   proxy_operation_benchmark.cpp
 )
 target_include_directories(msft_proxy_benchmarks PRIVATE .)
-target_link_libraries(msft_proxy_benchmarks PRIVATE msft_proxy4::proxy benchmark::benchmark benchmark::benchmark_main)
-target_compile_options(msft_proxy_benchmarks PRIVATE ${PROXY_BUILD_FLAGS} $<$<BOOL:${MSVC}>:/bigobj>)
+target_link_libraries(
+  msft_proxy_benchmarks
+  PRIVATE msft_proxy4::proxy benchmark::benchmark benchmark::benchmark_main
+)
+target_compile_options(
+  msft_proxy_benchmarks
+  PRIVATE ${PROXY_BUILD_FLAGS} $<$<BOOL:${MSVC}>:/bigobj>
+)

cmake/msft_proxy4ModuleTargets.cmake

@@ -1,27 +1,34 @@
 if(NOT DEFINED msft_proxy4_INCLUDE_DIR)
-    message(FATAL_ERROR "`msft_proxy4_INCLUDE_DIR` must be defined to use this script.")
+  message(
+    FATAL_ERROR
+    "`msft_proxy4_INCLUDE_DIR` must be defined to use this script."
+  )
 endif()
 
-message(STATUS "Declaring `msft_proxy4::proxy_module` target for include path `${msft_proxy4_INCLUDE_DIR}`")
+message(
+  STATUS
+  "Declaring `msft_proxy4::proxy_module` target for include path `${msft_proxy4_INCLUDE_DIR}`"
+)
 
 add_library(msft_proxy4_module)
 set_target_properties(
   msft_proxy4_module
-  PROPERTIES
-    SYSTEM TRUE
-    EXCLUDE_FROM_ALL TRUE
+  PROPERTIES SYSTEM TRUE EXCLUDE_FROM_ALL TRUE
 )
 
 add_library(msft_proxy4::proxy_module ALIAS msft_proxy4_module)
-target_sources(msft_proxy4_module PUBLIC
-  FILE_SET CXX_MODULES
-  BASE_DIRS ${msft_proxy4_INCLUDE_DIR}
-  FILES
-    ${msft_proxy4_INCLUDE_DIR}/proxy/v4/proxy.ixx
+target_sources(
+  msft_proxy4_module
+  PUBLIC
+    FILE_SET CXX_MODULES
+      BASE_DIRS ${msft_proxy4_INCLUDE_DIR}
+      FILES ${msft_proxy4_INCLUDE_DIR}/proxy/v4/proxy.ixx
 )
 target_compile_features(msft_proxy4_module PUBLIC cxx_std_20)
-target_compile_options(msft_proxy4_module PRIVATE
-  $<$<CXX_COMPILER_ID:MSVC>:/utf-8>
-  $<$<CXX_COMPILER_ID:Clang>:-Wno-c++2b-extensions>
+target_compile_options(
+  msft_proxy4_module
+  PRIVATE
+    $<$<CXX_COMPILER_ID:MSVC>:/utf-8>
+    $<$<CXX_COMPILER_ID:Clang>:-Wno-c++2b-extensions>
 )
 target_link_libraries(msft_proxy4_module PUBLIC msft_proxy4::proxy)

docs/BUILD.bazel

@@ -1,6 +1,6 @@
+load("@doc_examples//:doc_examples.bzl", "DOC_EXAMPLES")
 load("@rules_cc//cc:defs.bzl", "cc_test")
 load("//:copts.bzl", "PROXY_BUILD_COPTS")
-load("@doc_examples//:doc_examples.bzl", "DOC_EXAMPLES")
 
 package(default_visibility = ["//visibility:private"])
 

docs/CMakeLists.txt

@@ -9,51 +9,59 @@ file(MAKE_DIRECTORY "${EXAMPLES_DIR}")
 
 # Re-run configure when any doc Markdown file or the generator script changes.
 file(GLOB_RECURSE _MD_FILES "${CMAKE_CURRENT_SOURCE_DIR}/*.md")
-set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS ${_MD_FILES} "${_GEN_SCRIPT}")
+set_property(
+  DIRECTORY
+  APPEND
+  PROPERTY CMAKE_CONFIGURE_DEPENDS ${_MD_FILES} "${_GEN_SCRIPT}"
+)
 
 # Generate the example list at configure time and capture JSON to a variable.
 execute_process(
-    COMMAND ${Python3_EXECUTABLE} "${_GEN_SCRIPT}" --format json
-    WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
-    OUTPUT_VARIABLE _doc_examples_json
-    ERROR_VARIABLE _gen_error
-    RESULT_VARIABLE _gen_result
+  COMMAND ${Python3_EXECUTABLE} "${_GEN_SCRIPT}" --format json
+  WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+  OUTPUT_VARIABLE _doc_examples_json
+  ERROR_VARIABLE _gen_error
+  RESULT_VARIABLE _gen_result
 )
 if(_gen_result)
-    message(FATAL_ERROR "gen_doc_examples.py failed:\n${_gen_error}")
+  message(FATAL_ERROR "gen_doc_examples.py failed:\n${_gen_error}")
 endif()
 
 # Parse JSON array: [{md: <path>, deps: [<cmake-target>, ...]}, ...]
 string(JSON _len LENGTH "${_doc_examples_json}")
 math(EXPR _last "${_len} - 1")
 foreach(i RANGE 0 ${_last})
-    string(JSON _md GET "${_doc_examples_json}" ${i} "md")
-    string(JSON _n_deps LENGTH "${_doc_examples_json}" ${i} "deps")
-
-    set(_dep_names "")
-    if(_n_deps GREATER 0)
-        math(EXPR _d_last "${_n_deps} - 1")
-        foreach(j RANGE 0 ${_d_last})
-            string(JSON _dep GET "${_doc_examples_json}" ${i} "deps" ${j})
-            list(APPEND _dep_names "${_dep}")
-        endforeach()
-    endif()
-
-    string(REPLACE "/" "_" _suffix "${_md}")
-    string(REPLACE ".md" "" _suffix "${_suffix}")
-    set(_cpp "${EXAMPLES_DIR}/${_suffix}.cpp")
-
-    add_custom_command(
-        OUTPUT "${_cpp}"
-        COMMAND ${Python3_EXECUTABLE} "${_EXTRACT_SCRIPT}"
-                "${CMAKE_CURRENT_SOURCE_DIR}/${_md}" "${_cpp}"
-        DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/${_md}" "${_EXTRACT_SCRIPT}"
-        VERBATIM
-    )
-    set_source_files_properties("${_cpp}" PROPERTIES GENERATED TRUE)
-
-    add_executable(example_${_suffix} "${_cpp}")
-    target_link_libraries(example_${_suffix} PRIVATE msft_proxy4::proxy ${_dep_names})
-    target_compile_options(example_${_suffix} PRIVATE ${PROXY_BUILD_FLAGS})
-    add_test(NAME example_${_suffix} COMMAND example_${_suffix})
+  string(JSON _md GET "${_doc_examples_json}" ${i} "md")
+  string(JSON _n_deps LENGTH "${_doc_examples_json}" ${i} "deps")
+
+  set(_dep_names "")
+  if(_n_deps GREATER 0)
+    math(EXPR _d_last "${_n_deps} - 1")
+    foreach(j RANGE 0 ${_d_last})
+      string(JSON _dep GET "${_doc_examples_json}" ${i} "deps" ${j})
+      list(APPEND _dep_names "${_dep}")
+    endforeach()
+  endif()
+
+  string(REPLACE "/" "_" _suffix "${_md}")
+  string(REPLACE ".md" "" _suffix "${_suffix}")
+  set(_cpp "${EXAMPLES_DIR}/${_suffix}.cpp")
+
+  add_custom_command(
+    OUTPUT "${_cpp}"
+    COMMAND
+      ${Python3_EXECUTABLE} "${_EXTRACT_SCRIPT}"
+      "${CMAKE_CURRENT_SOURCE_DIR}/${_md}" "${_cpp}"
+    DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/${_md}" "${_EXTRACT_SCRIPT}"
+    VERBATIM
+  )
+  set_source_files_properties("${_cpp}" PROPERTIES GENERATED TRUE)
+
+  add_executable(example_${_suffix} "${_cpp}")
+  target_link_libraries(
+    example_${_suffix}
+    PRIVATE msft_proxy4::proxy ${_dep_names}
+  )
+  target_compile_options(example_${_suffix} PRIVATE ${PROXY_BUILD_FLAGS})
+  add_test(NAME example_${_suffix} COMMAND example_${_suffix})
 endforeach()

docs/meson.build

@@ -2,7 +2,12 @@ extract_example = find_program('../tools/extract_example_code.py')
 gen_doc_examples = find_program('../tools/gen_doc_examples.py')
 
 # Generate the example list at configure time (txt format: "<md>" or "<md>:<var1>,...").
-_gen = run_command(gen_doc_examples, '--format', 'txt', check: true)
+_gen = run_command(
+  gen_doc_examples,
+  '--format',
+  'txt',
+  check: true,
+)
 
 examples = []
 
@@ -30,7 +35,11 @@ foreach line : _gen.stdout().split('\n')
       build_by_default: false,
     )
     examples += _ex
-    test(suffix, _ex, suite: 'ProxyExamples')
+    test(
+      suffix,
+      _ex,
+      suite: 'ProxyExamples',
+    )
   endif
 endforeach
 

docs/modules_support.md

@@ -91,7 +91,6 @@ int main() {
 ```
 
 - (1) This is a traditional header rather than a module. It should be declared in global fragment (after `module` and before `export module`).
-- (2) This makes all `PRO_DEF_` macros available. This header file contains only some macros and are therefore very fast to compile. 
+- (2) This makes all `PRO_DEF_` macros available. This header file contains only some macros and are therefore very fast to compile.
 - (3) `import proxy.v4;` makes all public interfaces from `pro::v4` namespace available in the current translation unit.
 - (4) As of 2025-05-11, clangd requires the accessor struct to be either `export`-ed, or be declared within an `extern "C++"` block, in order to have auto completion working.
-