Add C++ modules support

Author: mikomikotaishi

CMakeLists.txt

@@ -110,6 +110,7 @@ option(HTTPLIB_USE_CERTS_FROM_MACOSX_KEYCHAIN "Enable feature to load system cer
 option(HTTPLIB_USE_NON_BLOCKING_GETADDRINFO "Enables the non-blocking alternatives for getaddrinfo." ON)
 option(HTTPLIB_REQUIRE_ZSTD "Requires ZSTD to be found & linked, or fails build." OFF)
 option(HTTPLIB_USE_ZSTD_IF_AVAILABLE "Uses ZSTD (if available) to enable zstd support." ON)
+option(HTTPLIB_BUILD_MODULES "Build httplib modules (requires HTTPLIB_COMPILE to be ON)." OFF)
 # Defaults to static library but respects standard BUILD_SHARED_LIBS if set
 include(CMakeDependentOption)
 cmake_dependent_option(HTTPLIB_SHARED "Build the library as a shared library instead of static. Has no effect if using header-only."
@@ -365,3 +366,10 @@ if(HTTPLIB_TEST)
 	include(CTest)
 	add_subdirectory(test)
 endif()
+
+if(HTTPLIB_BUILD_MODULES)
+	if(NOT HTTPLIB_COMPILE)
+		message(FATAL_ERROR "HTTPLIB_BUILD_MODULES requires HTTPLIB_COMPILE to be ON.")
+	endif()
+	add_subdirectory(modules)
+endif()

README.md

@@ -1253,6 +1253,11 @@ $ ./split.py
 Wrote out/httplib.h and out/httplib.cc
 ```
 
+Build C++ Modules
+-----------------
+
+If using CMake, it is possible to build this as a C++20 module using the `HTTPLIB_BUILD_MODULES` option (which requires `HTTPLIB_COMPILE` to be enabled).
+
 Dockerfile for Static HTTP Server
 ---------------------------------
 

modules/CMakeLists.txt

@@ -0,0 +1,25 @@
+add_library(httplib_module)
+
+target_sources(httplib_module
+    PUBLIC
+        FILE_SET CXX_MODULES FILES
+            httplib.cppm
+)
+
+target_compile_features(httplib_module PUBLIC cxx_std_20)
+
+target_include_directories(httplib_module PUBLIC
+    $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>
+    $<INSTALL_INTERFACE:include>
+)
+
+add_library(httplib::module ALIAS httplib_module)
+
+# Installation
+install(TARGETS httplib_module
+    EXPORT ${PROJECT_NAME}Targets
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+    FILE_SET CXX_MODULES DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/httplib/modules
+)

modules/httplib.cppm

@@ -0,0 +1,93 @@
+//
+//  httplib.h
+//
+//  Copyright (c) 2025 Yuji Hirose. All rights reserved.
+//  MIT License
+//
+
+module;
+
+#include "../httplib.h"
+
+export module httplib;
+
+export namespace httplib {
+    using httplib::SSLVerifierResponse;
+    using httplib::StatusCode;
+    using httplib::Headers;
+    using httplib::Params;
+    using httplib::Match;
+    using httplib::DownloadProgress;
+    using httplib::UploadProgress;
+    using httplib::Response;
+    using httplib::ResponseHandler;
+    using httplib::FormData;
+    using httplib::FormField;
+    using httplib::FormFields;
+    using httplib::FormFiles;
+    using httplib::MultipartFormData;
+    using httplib::UploadFormData;
+    using httplib::UploadFormDataItems;
+    using httplib::DataSink;
+    using httplib::ContentProvider;
+    using httplib::ContentProviderWithoutLength;
+    using httplib::ContentProviderResourceReleaser;
+    using httplib::FormDataProvider;
+    using httplib::FormDataProviderItems;
+    using httplib::ContentReceiverWithProgress;
+    using httplib::ContentReceiver;
+    using httplib::FormDataHeader;
+    using httplib::ContentReader;
+    using httplib::Range;
+    using httplib::Ranges;
+    using httplib::Request;
+    using httplib::Response;
+    using httplib::Error;
+    using httplib::to_string;
+    using httplib::operator<<;
+    using httplib::Stream;
+    using httplib::TaskQueue;
+    using httplib::ThreadPool;
+    using httplib::Logger;
+    using httplib::ErrorLogger;
+    using httplib::SocketOptions;
+    using httplib::default_socket_options;
+    using httplib::status_message;
+    using httplib::get_bearer_token_auth;
+    using httplib::Server;
+    using httplib::Result;
+    using httplib::ClientConnection;
+    using httplib::ClientImpl;
+    using httplib::Client;
+
+    #ifdef CPPHTTPLIB_OPENSSL_SUPPORT
+    using httplib::SSLServer;
+    using httplib::SSLClient;
+    #endif
+
+    using httplib::hosted_at;
+    using httplib::encode_uri_component;
+    using httplib::encode_uri;
+    using httplib::decode_uri_component;
+    using httplib::decode_uri;
+    using httplib::encode_path_component;
+    using httplib::decode_path_component;
+    using httplib::encode_query_component;
+    using httplib::decode_query_component;
+    using httplib::append_query_params;
+    using httplib::make_range_header;
+    using httplib::make_basic_authentication_header;
+
+    using httplib::get_client_ip;
+
+    namespace stream {
+        using httplib::stream::Result;
+        using httplib::stream::Get;
+        using httplib::stream::Post;
+        using httplib::stream::Put;
+        using httplib::stream::Patch;
+        using httplib::stream::Delete;
+        using httplib::stream::Head;
+        using httplib::stream::Options;
+    }
+}