Support for C++20/23 modules

.gitignore

@@ -21,6 +21,7 @@ bld/
 [Bb]in/
 [Oo]bj/
 [Ll]og/
+out/
 
 # Visual Studio 2015 cache/options directory
 .vs/

CMakeLists.txt

@@ -4,6 +4,8 @@ if(POLICY CMP0135) # DOWNLOAD_EXTRACT_TIMESTAMP
   cmake_policy(SET CMP0135 NEW)
 endif()
 
+set(CMAKE_EXPERIMENTAL_CXX_IMPORT_STD "451f2fe2-a8a2-47c3-bc32-94786d8fc91b")
+
 # HUNTER_ENABLED is always set if this package is included in a project using hunter (HunterGate sets it) In this case
 # we will use hunter as well to stay consistent. If not the use can supply it on configure to force using hunter.
 if(HUNTER_ENABLED)
@@ -20,6 +22,8 @@ option(JWT_BUILD_TESTS "Configure CMake to build tests (or not)" OFF)
 option(JWT_BUILD_DOCS "Adds a target for building the doxygen documentation" OFF)
 option(JWT_ENABLE_COVERAGE "Enable code coverage testing" OFF)
 option(JWT_ENABLE_FUZZING "Enable fuzz testing" OFF)
+option(JWT_ENABLE_MODULES "Build C++ modules" ON)
+option(JWT_USE_IMPORT_STD "Use import std" ON)
 
 option(JWT_DISABLE_PICOJSON "Do not provide the picojson template specialiaze" OFF)
 option(JWT_DISABLE_BASE64 "Do not include the base64 implementation from this library" OFF)
@@ -92,50 +96,95 @@ endif()
 
 set(JWT_INCLUDE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/include)
 set(JWT_HEADER_FILES ${JWT_INCLUDE_PATH}/jwt-cpp/jwt.h)
+set(JWT_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/modules)
 foreach(traits ${JWT_JSON_TRAITS_OPTIONS})
   list(APPEND JWT_HEADER_FILES ${JWT_INCLUDE_PATH}/jwt-cpp/traits/${traits}/defaults.h
        ${JWT_INCLUDE_PATH}/jwt-cpp/traits/${traits}/traits.h)
 endforeach()
 
 if(NOT JWT_DISABLE_BASE64)
-  list(APPEND JWT_HEADER_FILES ${JWT_INCLUDE_PATH}/jwt-cpp/base.h)
+    list(APPEND JWT_HEADER_FILES ${JWT_INCLUDE_PATH}/jwt-cpp/base.h)
 endif()
 
-add_library(jwt-cpp INTERFACE)
+if (JWT_ENABLE_MODULES)
+  if(CMAKE_VERSION VERSION_LESS "4.3")
+    message(FATAL_ERROR "CMake >= 4.3 is required to build with modules")
+  endif()
+
+  set(CMAKE_CXX_SCAN_FOR_MODULES ON)
+
+  if(JWT_USE_IMPORT_STD)
+    if(NOT CMAKE_GENERATOR MATCHES "Visual Studio")
+    set(CMAKE_CXX_MODULE_STD 1)
+    endif()
+  endif()
+endif()
+
+if (JWT_ENABLE_MODULES)
+  add_library(jwt-cpp STATIC)
+  set(JWT_LIBRARY_TYPE PUBLIC)
+else()
+  add_library(jwt-cpp INTERFACE)
+  set(JWT_LIBRARY_TYPE INTERFACE)
+endif()
 add_library(jwt-cpp::jwt-cpp ALIAS jwt-cpp) # To match export
-target_compile_features(jwt-cpp INTERFACE cxx_std_11)
+
+if(NOT JWT_ENABLE_MODULES)
+  target_compile_features(jwt-cpp ${JWT_LIBRARY_TYPE} cxx_std_11)
+else()
+  if(NOT JWT_USE_IMPORT_STD)
+      target_compile_features(jwt-cpp ${JWT_LIBRARY_TYPE} cxx_std_20)
+  else()
+      target_compile_features(jwt-cpp ${JWT_LIBRARY_TYPE} cxx_std_23)
+      target_compile_definitions(jwt-cpp PRIVATE JWT_USE_IMPORT_STD)
+  endif()
+    target_sources(jwt-cpp
+    PUBLIC
+      FILE_SET cxx_modules TYPE CXX_MODULES
+        BASE_DIRS ${JWT_MODULE_PATH}
+        FILES ${JWT_MODULE_PATH}/jwt.cppm
+    )
+endif()
+
 if(JWT_DISABLE_BASE64)
-  target_compile_definitions(jwt-cpp INTERFACE JWT_DISABLE_BASE64)
+  target_compile_definitions(jwt-cpp ${JWT_LIBRARY_TYPE} JWT_DISABLE_BASE64)
 endif()
 if(JWT_DISABLE_PICOJSON)
-  target_compile_definitions(jwt-cpp INTERFACE JWT_DISABLE_PICOJSON)
+  target_compile_definitions(jwt-cpp ${JWT_LIBRARY_TYPE} JWT_DISABLE_PICOJSON)
 endif()
 
+
+source_group( 
+  TREE "${JWT_INCLUDE_PATH}"
+  PREFIX "Implementation files"
+  FILES ${JWT_HEADER_FILES}
+)
+
 include(GNUInstallDirs)
 include(CMakePackageConfigHelpers)
-target_include_directories(jwt-cpp INTERFACE $<BUILD_INTERFACE:${JWT_INCLUDE_PATH}>
+target_include_directories(jwt-cpp ${JWT_LIBRARY_TYPE} $<BUILD_INTERFACE:${JWT_INCLUDE_PATH}>
                                              $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>)
 
 if(${JWT_SSL_LIBRARY} MATCHES "OpenSSL")
-  target_link_libraries(jwt-cpp INTERFACE OpenSSL::SSL OpenSSL::Crypto)
+  target_link_libraries(jwt-cpp ${JWT_LIBRARY_TYPE} OpenSSL::SSL OpenSSL::Crypto)
 endif()
 
 if(${JWT_SSL_LIBRARY} MATCHES "LibreSSL")
-  target_link_libraries(jwt-cpp INTERFACE LibreSSL::TLS)
+  target_link_libraries(jwt-cpp ${JWT_LIBRARY_TYPE} LibreSSL::TLS)
 endif()
 
 if(${JWT_SSL_LIBRARY} MATCHES "wolfSSL")
-  target_link_libraries(jwt-cpp INTERFACE PkgConfig::wolfssl)
+  target_link_libraries(jwt-cpp ${JWT_LIBRARY_TYPE} PkgConfig::wolfssl)
   # This is required to access OpenSSL compatibility API
-  target_include_directories(jwt-cpp INTERFACE ${wolfssl_INCLUDE_DIRS})
-  # This flag is required to have the mandatory header included automatically
+  target_include_directories(jwt-cpp ${JWT_LIBRARY_TYPE} ${wolfssl_INCLUDE_DIRS})
+  # This flag is required to have the mandatory header included automatically 
   # https://github.com/Thalhammer/jwt-cpp/pull/352#discussion_r1627971786
   # https://github.com/wolfSSL/wolfssl/blob/3b74a6402998a8b8839e25e31ba8ac74749aa9b0/wolfssl/wolfcrypt/settings.h#L58
-  target_compile_definitions(jwt-cpp INTERFACE EXTERNAL_OPTS_OPENVPN)
+  target_compile_definitions(jwt-cpp ${JWT_LIBRARY_TYPE} EXTERNAL_OPTS_OPENVPN)
 endif()
 
 if(NOT JWT_DISABLE_PICOJSON AND JWT_EXTERNAL_PICOJSON)
-  target_link_libraries(jwt-cpp INTERFACE picojson::picojson)
+  target_link_libraries(jwt-cpp ${JWT_LIBRARY_TYPE} picojson::picojson)
 endif()
 
 # Hunter needs relative paths so the files are placed correctly
@@ -146,18 +195,22 @@ endif()
 configure_package_config_file(
   ${CMAKE_CURRENT_LIST_DIR}/cmake/jwt-cpp-config.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config.cmake
   INSTALL_DESTINATION ${JWT_CMAKE_FILES_INSTALL_DIR})
-write_basic_package_version_file(${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config-version.cmake VERSION 0.7.2
-                                 COMPATIBILITY ExactVersion)
-
-install(TARGETS jwt-cpp EXPORT jwt-cpp-targets PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+write_basic_package_version_file(${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config-version.cmake VERSION 0.7.2 COMPATIBILITY ExactVersion)
+if (JWT_ENABLE_MODULES)
+  install(TARGETS jwt-cpp EXPORT jwt-cpp-targets
+          PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
+          FILE_SET cxx_modules DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/modules)
+else()
+  install(TARGETS jwt-cpp EXPORT jwt-cpp-targets
+          PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+endif()
 install(EXPORT jwt-cpp-targets NAMESPACE jwt-cpp:: FILE jwt-cpp-targets.cmake
         DESTINATION ${JWT_CMAKE_FILES_INSTALL_DIR})
 install(DIRECTORY ${JWT_INCLUDE_PATH}/jwt-cpp DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
 if(NOT JWT_EXTERNAL_PICOJSON AND NOT JWT_DISABLE_PICOJSON)
   install(FILES ${JWT_INCLUDE_PATH}/picojson/picojson.h DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/picojson)
 endif()
-install(FILES ${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config.cmake ${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config-version.cmake
-        DESTINATION ${JWT_CMAKE_FILES_INSTALL_DIR})
+install(FILES ${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config.cmake ${CMAKE_CURRENT_BINARY_DIR}/jwt-cpp-config-version.cmake DESTINATION ${JWT_CMAKE_FILES_INSTALL_DIR})
 
 if(JWT_BUILD_EXAMPLES)
   add_subdirectory(example)

example/CMakeLists.txt

@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.14)
+cmake_minimum_required(VERSION 3.15)
 project(jwt-cpp-examples)
 
 if(NOT TARGET jwt-cpp)
@@ -14,25 +14,43 @@ endif()
 add_executable(print-claims print-claims.cpp)
 target_link_libraries(print-claims jwt-cpp::jwt-cpp)
 add_custom_target(print-claims-run COMMAND print-claims)
+if (JWT_ENABLE_MODULES) 
+  target_compile_definitions(print-claims PRIVATE JWT_ENABLE_MODULES)
+endif()
 
 add_executable(private-claims private-claims.cpp)
 target_link_libraries(private-claims jwt-cpp::jwt-cpp)
 add_custom_target(private-claims-run COMMAND private-claims)
+if (JWT_ENABLE_MODULES) 
+  target_compile_definitions(private-claims PRIVATE JWT_ENABLE_MODULES)
+endif()
 
 add_executable(rsa-create rsa-create.cpp)
 target_link_libraries(rsa-create jwt-cpp::jwt-cpp)
 add_custom_target(rsa-create-run COMMAND rsa-create)
+if (JWT_ENABLE_MODULES) 
+  target_compile_definitions(rsa-create PRIVATE JWT_ENABLE_MODULES)
+endif()
 
 add_executable(rsa-verify rsa-verify.cpp)
 target_link_libraries(rsa-verify jwt-cpp::jwt-cpp)
 add_custom_target(rsa-verify-run COMMAND rsa-verify)
+if (JWT_ENABLE_MODULES) 
+  target_compile_definitions(rsa-verify PRIVATE JWT_ENABLE_MODULES)
+endif()
 
 add_executable(jwks-verify jwks-verify.cpp)
 target_link_libraries(jwks-verify jwt-cpp::jwt-cpp)
 add_custom_target(jwks-verify-run COMMAND jwks-verify)
+if (JWT_ENABLE_MODULES) 
+  target_compile_definitions(jwks-verify PRIVATE JWT_ENABLE_MODULES)
+endif()
 
 add_executable(es256k es256k.cpp)
 target_link_libraries(es256k jwt-cpp::jwt-cpp)
+if (JWT_ENABLE_MODULES) 
+  target_compile_definitions(es256k PRIVATE JWT_ENABLE_MODULES)
+endif()
 
 add_executable(partial-claim-verifier partial-claim-verifier.cpp)
 target_link_libraries(partial-claim-verifier jwt-cpp::jwt-cpp nlohmann_json::nlohmann_json)

example/es256k.cpp

@@ -1,6 +1,18 @@
 /// @file es256k.cpp
+
+#ifndef JWT_ENABLE_MODULES
+#include <chrono>
 #include <iostream>
 #include <jwt-cpp/jwt.h>
+#else
+#ifdef JWT_USE_IMPORT_STD
+import std;
+#else
+#include <chrono>
+#include <iostream>
+#endif
+import jwt_cpp;
+#endif
 
 int main() {
 	// openssl ecparam -name secp256k1 -genkey -noout -out ec-secp256k1-priv-key.pem

example/jwks-verify.cpp

@@ -4,9 +4,21 @@
  * Novel example using a JWT's "key ID" to match with a JWK Set
  * and using the corresponding x5c from the JWK to verify the token
  */
+#include <openssl/rand.h>
+
+#ifndef JWT_ENABLE_MODULES
 #include <iostream>
+#include <string>
 #include <jwt-cpp/jwt.h>
-#include <openssl/rand.h>
+#else
+#ifdef JWT_USE_IMPORT_STD
+import std;
+#else
+#include <iostream>
+#include <string>
+#endif
+import jwt_cpp;
+#endif
 
 int main() {
 	std::string raw_jwks =

example/partial-claim-verifier.cpp

@@ -1,8 +1,8 @@
 /// @file partial-claim-verifier.cpp
-#include "jwt-cpp/traits/nlohmann-json/defaults.h"
-
 #include <iostream>
 
+#include "jwt-cpp/traits/nlohmann-json/defaults.h"
+
 int main() {
 	std::string const rsa_priv_key = R"(-----BEGIN PRIVATE KEY-----
 MIIEvwIBADANBgkqhkiG9w0BAQEFAASCBKkwggSlAgEAAoIBAQC4ZtdaIrd1BPIJ

example/print-claims.cpp

@@ -1,6 +1,16 @@
 /// @file print-claims.cpp
+
+#ifndef JWT_ENABLE_MODULES
 #include <iostream>
 #include <jwt-cpp/jwt.h>
+#else
+#ifdef JWT_USE_IMPORT_STD
+import std;
+#else
+#include <iostream>
+#endif
+import jwt_cpp;
+#endif
 
 int main() {
 	const std::string token =

example/private-claims.cpp

@@ -1,8 +1,20 @@
 /// @file private-claims.cpp
-#include <jwt-cpp/jwt.h>
 
+#ifndef JWT_ENABLE_MODULES
+#include <chrono>
+#include <iostream>
+#include <sstream>
+#include <jwt-cpp/jwt.h>
+#else
+#ifdef JWT_USE_IMPORT_STD
+import std;
+#else
+#include <chrono>
 #include <iostream>
 #include <sstream>
+#endif
+import jwt_cpp;
+#endif
 
 using sec = std::chrono::seconds;
 using min = std::chrono::minutes;
@@ -13,7 +25,7 @@ int main() {
 	iss >> from_raw_json;
 
 	jwt::claim::set_t list{"once", "twice"};
-	std::vector<int64_t> big_numbers{727663072ULL, 770979831ULL, 427239169ULL, 525936436ULL};
+	std::vector<std::int64_t> big_numbers{727663072ULL, 770979831ULL, 427239169ULL, 525936436ULL};
 
 	const auto time = jwt::date::clock::now();
 	const auto token = jwt::create()
@@ -24,7 +36,7 @@ int main() {
 						   .set_not_before(time - sec{15})
 						   .set_expires_at(time + sec{15} + min{2})
 						   .set_payload_claim("boolean", picojson::value(true))
-						   .set_payload_claim("integer", picojson::value(int64_t{12345}))
+						   .set_payload_claim("integer", picojson::value(std::int64_t{12345}))
 						   .set_payload_claim("precision", picojson::value(12.345))
 						   .set_payload_claim("strings", jwt::claim(list))
 						   .set_payload_claim("array", jwt::claim(big_numbers.begin(), big_numbers.end()))

example/rsa-create.cpp

@@ -1,6 +1,18 @@
 /// @file rsa-create.cpp
+
+#ifndef JWT_ENABLE_MODULES
+#include <chrono>
 #include <iostream>
 #include <jwt-cpp/jwt.h>
+#else
+#ifdef JWT_USE_IMPORT_STD
+import std;
+#else
+#include <chrono>
+#include <iostream>
+#endif
+import jwt_cpp;
+#endif
 
 int main() {
 	std::string const rsa_priv_key = R"(-----BEGIN PRIVATE KEY-----

example/rsa-verify.cpp

@@ -1,6 +1,18 @@
 /// \file rsa-verify.cpp
+
+#ifndef JWT_ENABLE_MODULES
+#include <chrono>
 #include <iostream>
 #include <jwt-cpp/jwt.h>
+#else
+#ifdef JWT_USE_IMPORT_STD
+import std;
+#else
+#include <chrono>
+#include <iostream>
+#endif
+import jwt_cpp;
+#endif
 
 int main() {
 	const std::string rsa_pub_key = R"(-----BEGIN PUBLIC KEY-----

example/traits/boost-json.cpp

@@ -1,9 +1,9 @@
-#include "jwt-cpp/traits/boost-json/traits.h"
-
 // #include <boost/json/src.hpp> // You may require this if you are not building it elsewhere
 #include <iostream>
 #include <sstream>
 
+#include "jwt-cpp/traits/boost-json/traits.h"
+
 int main() {
 	using sec = std::chrono::seconds;
 	using min = std::chrono::minutes;

example/traits/danielaparker-jsoncons.cpp

@@ -1,8 +1,8 @@
-#include "jwt-cpp/traits/danielaparker-jsoncons/traits.h"
-
 #include <iostream>
 #include <sstream>
 
+#include "jwt-cpp/traits/danielaparker-jsoncons/traits.h"
+
 int main() {
 	using sec = std::chrono::seconds;
 	using min = std::chrono::minutes;

example/traits/kazuho-picojson.cpp

@@ -1,8 +1,8 @@
-#include "jwt-cpp/traits/kazuho-picojson/traits.h"
-
 #include <iostream>
 #include <sstream>
 
+#include "jwt-cpp/traits/kazuho-picojson/traits.h"
+
 int main() {
 	using sec = std::chrono::seconds;
 	using min = std::chrono::minutes;