Rename the major version from 4 to 5 (#88)

* Rename the v4 headers, namespace, and macros to v5

Move include/proxy/v4 to include/proxy/v5 and rename every
major-qualified name to 5: the inline namespace pro::v5, the module
proxy.v5, the PRO5_ and PRO5D_ macros, __msft_lib_proxy5, the
MSFT_PROXY_V5_ include guards, and the msft_proxy5 CMake and Meson
package, targets, and dependency. This lets Proxy 5 be installed and
included side by side with Proxy 4.

* Bump the version to 5.0.0

* Update documentation examples for Proxy 5

Author: mingxwa

CMakeLists.txt

@@ -1,9 +1,9 @@
 cmake_minimum_required(VERSION 3.28)
 
-project(msft_proxy4 VERSION 4.1.0 LANGUAGES CXX)
-add_library(msft_proxy4 INTERFACE)
-set_target_properties(msft_proxy4 PROPERTIES EXPORT_NAME proxy)
-add_library(msft_proxy4::proxy ALIAS msft_proxy4)
+project(msft_proxy5 VERSION 5.0.0 LANGUAGES CXX)
+add_library(msft_proxy5 INTERFACE)
+set_target_properties(msft_proxy5 PROPERTIES EXPORT_NAME proxy)
+add_library(msft_proxy5::proxy ALIAS msft_proxy5)
 
 # Do not enable building tests if proxy is consumed as
 # subdirectory (e.g. by CMake FetchContent_Declare).
@@ -39,74 +39,74 @@ endif()
 file(GLOB_RECURSE proxy_public_headers CONFIGURE_DEPENDS
      "${CMAKE_CURRENT_SOURCE_DIR}/include/proxy/*.h"
      "${CMAKE_CURRENT_SOURCE_DIR}/include/proxy/*.ixx")
-target_sources(msft_proxy4
+target_sources(msft_proxy5
   INTERFACE
     FILE_SET public_headers
     TYPE HEADERS
     BASE_DIRS include
     FILES ${proxy_public_headers}
 )
 
-target_compile_features(msft_proxy4 INTERFACE cxx_std_20)
+target_compile_features(msft_proxy5 INTERFACE cxx_std_20)
 target_include_directories(
-  msft_proxy4
+  msft_proxy5
   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)
-  set(msft_proxy4_INCLUDE_DIR include)
+  set(msft_proxy5_INCLUDE_DIR include)
   if(PROXY_BUILD_MODULES)
-    include(cmake/msft_proxy4ModuleTargets.cmake)
+    include(cmake/msft_proxy5ModuleTargets.cmake)
   endif()
 else()
   # Propagate the variable to the parent project
-  set(msft_proxy4_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/include PARENT_SCOPE)
+  set(msft_proxy5_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/include PARENT_SCOPE)
 endif()
 
 # install and export the project. project name - proxy
 
 include(GNUInstallDirs)
 
 install(
-  TARGETS msft_proxy4
-  EXPORT msft_proxy4Targets
+  TARGETS msft_proxy5
+  EXPORT msft_proxy5Targets
   FILE_SET public_headers DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
 )
 
 install(
-  EXPORT msft_proxy4Targets
-  NAMESPACE msft_proxy4::
-  DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy4
+  EXPORT msft_proxy5Targets
+  NAMESPACE msft_proxy5::
+  DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy5
 )
 export(
-  TARGETS msft_proxy4
-  NAMESPACE msft_proxy4::
-  FILE msft_proxy4Targets.cmake
+  TARGETS msft_proxy5
+  NAMESPACE msft_proxy5::
+  FILE msft_proxy5Targets.cmake
 )
 
 include(CMakePackageConfigHelpers)
 configure_package_config_file(
-  cmake/msft_proxy4Config.cmake.in
-  ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy4Config.cmake
-  INSTALL_DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy4
+  cmake/msft_proxy5Config.cmake.in
+  ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy5Config.cmake
+  INSTALL_DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy5
   PATH_VARS CMAKE_INSTALL_INCLUDEDIR
 )
 
 include(CMakePackageConfigHelpers)
 write_basic_package_version_file(
-  cmake/msft_proxy4ConfigVersion.cmake
+  cmake/msft_proxy5ConfigVersion.cmake
   COMPATIBILITY SameMajorVersion
   ARCH_INDEPENDENT
 )
 
 install(
   FILES
-    ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy4Config.cmake
-    ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy4ConfigVersion.cmake
-  DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy4
+    ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy5Config.cmake
+    ${CMAKE_CURRENT_BINARY_DIR}/cmake/msft_proxy5ConfigVersion.cmake
+  DESTINATION ${CMAKE_INSTALL_DATADIR}/msft_proxy5
 )
 
 # build tests if BUILD_TESTING is ON

MODULE.bazel

@@ -1,6 +1,6 @@
 module(
     name = "proxy",
-    version = "4.1.0",
+    version = "5.0.0",
 )
 
 bazel_dep(name = "platforms", version = "1.1.0")

README.md

@@ -242,12 +242,12 @@ Fetch via [CPM](https://github.com/cpm-cmake/CPM.cmake) (a thin wrapper over CMa
 
 ```cmake
 CPMAddPackage(
-  NAME msft_proxy4
-  GIT_TAG 4.1.0
+  NAME msft_proxy5
+  GIT_TAG 5.0.0
   GIT_REPOSITORY https://github.com/ngcpp/proxy.git
 )
 
-target_link_libraries(main PRIVATE msft_proxy4::proxy)
+target_link_libraries(main PRIVATE msft_proxy5::proxy)
 ```
 
 Or, if you already have a local clone, use `add_subdirectory(path/to/proxy)` instead of `CPMAddPackage`.
@@ -259,17 +259,17 @@ Place a wrap file at `subprojects/proxy.wrap` and Meson will fetch the source au
 ```ini
 [wrap-git]
 url = https://github.com/ngcpp/proxy.git
-revision = 4.1.0
+revision = 5.0.0
 
 [provide]
-dependency_names = msft_proxy4
+dependency_names = msft_proxy5
 ```
 
 Then in your `meson.build`:
 
 ```meson
-msft_proxy4_dep = dependency('msft_proxy4')
-executable('main', 'main.cpp', dependencies: msft_proxy4_dep)
+msft_proxy5_dep = dependency('msft_proxy5')
+executable('main', 'main.cpp', dependencies: msft_proxy5_dep)
 ```
 
 ### Bazel
@@ -279,7 +279,7 @@ The library is not yet published to the [Bazel Central Registry](https://registr
 With **Bzlmod** (Bazel 7+), add to your `MODULE.bazel`:
 
 ```python
-bazel_dep(name = "proxy", version = "4.1.0")
+bazel_dep(name = "proxy", version = "5.0.0")
 git_override(
     module_name = "proxy",
     remote = "https://github.com/ngcpp/proxy.git",
@@ -294,7 +294,7 @@ load("@bazel_tools//tools/build_defs/repo:git.bzl", "git_repository")
 git_repository(
     name = "proxy",
     remote = "https://github.com/ngcpp/proxy.git",
-    tag = "4.1.0",
+    tag = "5.0.0",
 )
 load("@proxy//:proxy_deps.bzl", "proxy_deps")
 proxy_deps()

benchmarks/CMakeLists.txt

@@ -28,7 +28,7 @@ add_executable(
 target_include_directories(msft_proxy_benchmarks PRIVATE .)
 target_link_libraries(
   msft_proxy_benchmarks
-  PRIVATE msft_proxy4::proxy benchmark::benchmark benchmark::benchmark_main
+  PRIVATE msft_proxy5::proxy benchmark::benchmark benchmark::benchmark_main
 )
 target_compile_options(
   msft_proxy_benchmarks

benchmarks/meson.build

@@ -8,7 +8,7 @@ benchmark(
       'proxy_operation_benchmark_context.cpp',
     ),
     implicit_include_directories: false,
-    dependencies: [msft_proxy4_dep, benchmark_dep],
+    dependencies: [msft_proxy5_dep, benchmark_dep],
     cpp_args: cxx.get_argument_syntax() == 'msvc' ? ['/bigobj'] : [],
   ),
 )

cmake/msft_proxy4Config.cmake.in

@@ -0,0 +1,5 @@
+@PACKAGE_INIT@
+
+include("${CMAKE_CURRENT_LIST_DIR}/msft_proxy5Targets.cmake")
+
+set(msft_proxy5_INCLUDE_DIR "@PACKAGE_CMAKE_INSTALL_INCLUDEDIR@")

cmake/msft_proxy4ModuleTargets.cmake

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

cmake/msft_proxy5Config.cmake.in

@@ -60,7 +60,7 @@ foreach(i RANGE 0 ${_last})
   add_executable(example_${_suffix} "${_cpp}")
   target_link_libraries(
     example_${_suffix}
-    PRIVATE msft_proxy4::proxy ${_dep_names}
+    PRIVATE msft_proxy5::proxy ${_dep_names}
   )
   target_compile_options(example_${_suffix} PRIVATE ${PROXY_BUILD_FLAGS})
   add_test(NAME example_${_suffix} COMMAND example_${_suffix})