addMultipartFormData method has been added

Author: Levent KARAGÖL

README.md

@@ -583,6 +583,8 @@ HttpRequest& setQueryString(const std::string& queryString) noexcept;
 
 HttpRequest& setPayload(const std::string& payload) noexcept;
 
+HttpRequest& addMultipartFormData(const std::string& name, const std::string& data, const std::optional<std::string>& mimeType = std::nullopt) noexcept;
+
 HttpRequest& returnAsBinary() noexcept;
 
 HttpRequest& addHeader(const std::string& key, const std::string& value) noexcept;

src/libcpp-http-client.hpp

@@ -1,7 +1,7 @@
 /*
 
 Modern, non-blocking and exception free HTTP Client library for C++ (17+)
-version 1.6.0
+version 1.7.0
 https://github.com/leventkaragol/libcpp-http-client
 
 If you encounter any issues, please submit a ticket at https://github.com/leventkaragol/libcpp-http-client/issues
@@ -38,6 +38,7 @@ SOFTWARE.
 #include <map>
 #include <memory>
 #include <mutex>
+#include <optional>
 #include <sstream>
 #include <curl/curl.h>
 
@@ -234,6 +235,20 @@ namespace lklibs
             return *this;
         }
 
+        /**
+         * @brief Set the file data to be sent with the request as multipart/form-data
+         *
+         * @param name: Name of the form field
+         * @param data: Path to the file to be sent
+         * @param mimeType: Optional MIME type of the file
+         */
+        HttpRequest& addMultipartFormData(const std::string& name, const std::string& data, const std::optional<std::string>& mimeType = std::nullopt) noexcept
+        {
+            this->formData[name] = FormData{data, mimeType};
+
+            return *this;
+        }
+
         /**
          * @brief Set the timeout for the request
          *
@@ -393,9 +408,16 @@ namespace lklibs
             "PATCH"
         };
 
+        struct FormData
+        {
+            std::string data;
+            std::optional<std::string> mimeType;
+        };
+
         std::string url;
         std::string method = "GET";
         std::string payload;
+        std::map<std::string, FormData> formData;
         std::string userAgent;
         bool sslErrorsWillBeIgnored = false;
         ReturnFormat returnFormat = ReturnFormat::TEXT;
@@ -479,6 +501,31 @@ namespace lklibs
                     curl_easy_setopt(curl.get(), CURLOPT_POSTFIELDS, this->payload.c_str());
                 }
 
+                const std::unique_ptr<curl_mime, decltype(&curl_mime_free)> mime(curl_mime_init(curl.get()), &curl_mime_free);
+
+                if (!this->formData.empty())
+                {
+                    for (const auto& [field, content] : this->formData)
+                    {
+                        std::unique_ptr<curl_mimepart, std::function<void(curl_mimepart*)>> part(
+                            curl_mime_addpart(mime.get()),
+                            [](curl_mimepart*) {});
+
+                        curl_mime_name(part.get(), field.c_str());
+                        if (content.mimeType.has_value())
+                        {
+                            curl_mime_filedata(part.get(), content.data.c_str());
+                            curl_mime_type(part.get(), content.mimeType->c_str());
+                        }
+                        else
+                        {
+                            curl_mime_data(part.get(), content.data.c_str(), CURL_ZERO_TERMINATED);
+                        }
+                    }
+
+                    curl_easy_setopt(curl.get(), CURLOPT_MIMEPOST, mime.get());
+                }
+
                 if (dataCallback)
                 {
                     curl_easy_setopt(curl.get(), CURLOPT_WRITEFUNCTION, streamingWriteCallback);

test/test.cpp

@@ -164,6 +164,30 @@ TEST(HttpPostTest, HttpPostRequestMustBeCompletedSuccessfullyInItsSimplestForm)
     ASSERT_EQ(data["form"]["param2"], "test") << "Payload is invalid";
 }
 
+TEST(HttpPostTest, HttpPostRequestMustBeCompletedSuccessfullyInItsFormData)
+{
+    HttpRequest httpRequest("https://httpbun.com/post");
+
+    auto response = httpRequest
+                    .setMethod(HttpMethod::POST)
+                    .addMultipartFormData("param1", "7")
+                    .addMultipartFormData("param2", "test")
+                    .send()
+                    .get();
+
+    ASSERT_TRUE(response.succeed) << "HTTP Request failed";
+    ASSERT_EQ(response.statusCode, 200) << "HTTP Status Code is not 200";
+    ASSERT_FALSE(response.textData.empty()) << "HTTP Response is empty";
+    ASSERT_TRUE(response.binaryData.empty()) << "Binary data is not empty";
+    ASSERT_TRUE(response.errorMessage.empty()) << "HTTP Error Message is not empty";
+
+    auto data = json::parse(response.textData);
+
+    ASSERT_EQ(data["method"], "POST") << "HTTP Method is invalid";
+    ASSERT_EQ(data["form"]["param1"], "7") << "Payload is invalid";
+    ASSERT_EQ(data["form"]["param2"], "test") << "Payload is invalid";
+}
+
 TEST(HttpPostTest, MultipleHttpPostRequestMustBeCompletedSuccessfullyInNonBlockingForm)
 {
     HttpRequest httpRequest1("https://httpbun.com/post");