fix version 1.88.0.beta1 handling

fix version 1.88.0.beta1 handling

updated docs

updated year of copyright

updated version to 3.7.2

Author: Arniiiii

CMakeLists.txt

@@ -4,7 +4,7 @@ cmake_minimum_required(VERSION 3.14...3.22)
 
 # ---- Project ----
 
-set(AddBoost.cmake_VERSION 3.7.1)
+set(AddBoost.cmake_VERSION 3.7.2)
 
 option(${PROJECT_NAME}_INSTALL "Install the script at local system?" NO)
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Arni
+Copyright (c) 2025 Arniiiii [email protected]
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -2,7 +2,7 @@
 
 ## Find or download Boost from CMake. 
 
-Versions tested: from 1.79.0 upto 1.87.0 .
+Versions tested: from 1.79.0 upto 1.88.0.beta1 .
 
 ## Examples
 
@@ -11,18 +11,18 @@ Versions tested: from 1.79.0 upto 1.87.0 .
 ## How to use:
 
 1. Add [CPM.cmake](https://github.com/cpm-cmake/CPM.cmake?tab=readme-ov-file#adding-cpm) in your project.
-2. Download `AddBoost.CMake` via CPM:
+2. Download `AddBoost.CMake` via CPM: (or install AddBoost.cmake system-wide, check [Features section](#features) of the document)
 
 ```cmake
 CPMAddPackage(
   NAME AddBoost.CMake
-  GIT_TAG 3.3
+  GIT_TAG 3.7.2
   GITHUB_REPOSITORY Arniiiii/AddBoost.cmake
 )
 ```
-3. Use the `add_boost` macro. Notice *NOT* wrapping variables like TRY_BOOST_VERSION and so on in `${}` when sending arguments to the macro
+3. Use the `add_boost` macro. Notice *NOT* wrapping variables like TRY_BOOST_VERSION and so on in `"${}"` when sending arguments to the macro
 ```cmake
-set(TRY_BOOST_VERSION "1.86.0")
+set(TRY_BOOST_VERSION "1.88.0.beta1")
 set(BOOST_MY_OPTIONS "BOOST_ENABLE_PYTHON ON;")
 set(BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED "thread;system")
 set(BOOST_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED "asio;beast;uuid;container;cobalt")
@@ -62,7 +62,7 @@ packageProject(
 
 ```
 
-## Features:  
+## Features
 
  - [x] Finds local Boost ( you can set `-DCPM_USE_LOCAL_PACKAGES=1` for "looking for local Boost. if failed: download" mode. Set `-DCPM_LOCAL_PACKAGES_ONLY=1` to only look for installed Boost and emit error if failed to find)
  - [x] Downloads boost, if `-DCPM_USE_LOCAL_PACKAGES=1` and there's installed Boost with lower version than needed or if installed Boost doesn't exist on the system or if `-DCPM_DOWNLOAD_ALL=1` is set.
@@ -76,8 +76,11 @@ packageProject(
  - [x] If you want, you can link Boost libs yourself, since the code is macro, not a function: copy and paste some last parts of the main CMakeLists.txt of the project and adjust for yourself.
  - [x] You can link Boost libs automagically to multiple targets just by adding them to the end of the `add_boost(...)` macro.
  - [x] You can use `ADDBOOSTCMAKE_LINK_TYPE` to override default behaviour of linking: if target is INTERFACE, use INTERFACE, if else: PUBLIC
+ - [x] Correctly handles attempts to get beta versions like `boost-1.88.0.beta1`, since `find_package` considers such version as incorrect, but we understand what you mean ^_^
+ - [x] You can install the AddBoost.cmake on your SYSTEM !!! Use `-DAddBoost.cmake_INSTALL=ON` command line option and enjoy! And yes, it supports versioning!
  - [ ] Internally, this uses my fork of CPM with better logging handling. Waiting until PRs for CPM are going to be reviewed...
-- [x] You can install it as a utility module. Use `AddBoost.cmake_INSTALL` option at configuring and use `find_package(AddBoost.cmake)`
+ - [ ] Cannot check existence of header only components of installed Boost, since it relies on functionality of `find_package(Boost ${VERSION} ${COMPONENTS})`. Therefore, set version of Boost you need so that it have the library.
+ - [x] You can install it as a utility module. Use `AddBoost.cmake_INSTALL` option at configuring and use `find_package(AddBoost.cmake)`
  - [x] You can apply your patches to Boost. Before calling the ~~function~~ macro `add_boost(...)`, define variable `BOOST_ADD_MY_PATCHES` to be a path to folder in which there's  `*.patch` in such layout:
 ```
 patches/

cmake/AddBoost.cmake/AddBoost.cmakeConfig.cmake.in

@@ -54,6 +54,12 @@ macro(add_boost TRY_BOOST_VERSION BOOST_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED
     set(boost_is_old TRUE)
   endif()
 
+  if("${${TRY_BOOST_VERSION}}" MATCHES "\\.beta1")
+    string(REGEX REPLACE "\\.beta." "" boost_find_package_version "${${TRY_BOOST_VERSION}}")
+  else()
+    set(boost_find_package_version "${${TRY_BOOST_VERSION}}")
+  endif()
+
   set(patches_for_boost "")
 
   file(GLOB global_patches_for_boost CONFIGURE_DEPENDS
@@ -104,31 +110,31 @@ macro(add_boost TRY_BOOST_VERSION BOOST_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED
   if(DEFINED BOOST_USE_MY_BOOST_DIRECTORY)
     CPMAddPackage(
       NAME Boost
-      VERSION ${${TRY_BOOST_VERSION}}
+      VERSION "${boost_find_package_version}"
       SOURCE_DIR ${BOOST_USE_MY_BOOST_DIRECTORY} PATCHES ${patches_for_boost}
       FIND_PACKAGE_ARGUMENTS "COMPONENTS ${ESCAPED_BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED}"
       OPTIONS "BOOST_ENABLE_CMAKE ON;BOOST_SKIP_INSTALL_RULES OFF;${BOOST_MY_OPTIONS}"
     )
   elseif(patches_for_boost AND NOT boost_is_old) # is it 1.80.0 < x < 1.84.0
     CPMAddPackage(
       NAME Boost
-      VERSION ${${TRY_BOOST_VERSION}}
+      VERSION "${boost_find_package_version}"
       URL ${BOOST_URL} PATCHES ${patches_for_boost}
       FIND_PACKAGE_ARGUMENTS "COMPONENTS ${ESCAPED_BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED}"
       OPTIONS "BOOST_ENABLE_CMAKE ON;BOOST_SKIP_INSTALL_RULES OFF;${BOOST_MY_OPTIONS}"
     )
   elseif(NOT boost_is_old) # is it 1.85.0+ ?
     CPMAddPackage(
       NAME Boost
-      VERSION ${${TRY_BOOST_VERSION}}
+      VERSION "${boost_find_package_version}"
       URL ${BOOST_URL}
       FIND_PACKAGE_ARGUMENTS "COMPONENTS ${ESCAPED_BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED}"
       OPTIONS "BOOST_ENABLE_CMAKE ON;BOOST_SKIP_INSTALL_RULES OFF;${BOOST_MY_OPTIONS}"
     )
   else() # is it <1.80.0 ?
     CPMAddPackage(
       NAME Boost
-      VERSION ${${TRY_BOOST_VERSION}}
+      VERSION "${boost_find_package_version}"
       GIT_REPOSITORY "https://github.com/boostorg/boost"
       GIT_TAG "boost-${${TRY_BOOST_VERSION}}" PATCHES ${patches_for_boost}
       FIND_PACKAGE_ARGUMENTS "COMPONENTS ${ESCAPED_BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED}"
@@ -170,10 +176,8 @@ macro(add_boost TRY_BOOST_VERSION BOOST_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED
     endforeach()
   endforeach()
   if(Boost_LOCAL STREQUAL "YES")
-    set(ADDBOOSTCMAKE_PACKAGEPROJECT_INSTALL_TARGETS
-        "Boost ${${TRY_BOOST_VERSION}} REQUIRED"
-    )
-    foreach(dep  ${${BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED}})
+    set(ADDBOOSTCMAKE_PACKAGEPROJECT_INSTALL_TARGETS "Boost ${boost_find_package_version} REQUIRED")
+    foreach(dep ${${BOOST_NOT_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED}})
       string(APPEND ADDBOOSTCMAKE_PACKAGEPROJECT_INSTALL_TARGETS " ${dep}")
     endforeach()
   else()
@@ -183,7 +187,7 @@ macro(add_boost TRY_BOOST_VERSION BOOST_HEADER_ONLY_COMPONENTS_THAT_YOU_NEED
     )
     foreach(dep ${BOOST_ALL_DEPENDENCIES})
       string(APPEND ADDBOOSTCMAKE_PACKAGEPROJECT_INSTALL_TARGETS
-             "boost_${dep} ${${TRY_BOOST_VERSION}};"
+             "boost_${dep} ${boost_find_package_version};"
       )
     endforeach()
     string(LENGTH "${ADDBOOSTCMAKE_PACKAGEPROJECT_INSTALL_TARGETS}"