HttpClient.h

Go to the documentation of this file.

/*
    MetaImGUI
    Copyright (C) 2026  A P Nicholson
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.
*/
 
#pragma once
 
#include <chrono>
#include <stop_token>
#include <string>
 
namespace MetaImGUI {
 
enum class HttpStatus {
    Ok,           
    RateLimited,  
    NetworkError, 
    Cancelled     
};
 
struct HttpResponse {
    HttpStatus status = HttpStatus::NetworkError;
    long httpCode = 0;
    std::string body;
};
 
struct HttpRequest {
    std::string url;
    std::string userAgent = "MetaImGUI/1.0";
    std::chrono::seconds timeout{10};
    bool followRedirects = true;
    int maxRetries = 0; 
};
 
class HttpClient {
public:
    HttpClient() = default;
    ~HttpClient() = default;
 
    HttpClient(const HttpClient&) = delete;
    HttpClient& operator=(const HttpClient&) = delete;
    HttpClient(HttpClient&&) = default;
    HttpClient& operator=(HttpClient&&) = default;
 
    [[nodiscard]] HttpResponse Get(const HttpRequest& request, const std::stop_token& stopToken) const;
 
    [[nodiscard]] HttpResponse Get(const HttpRequest& request) const;
 
private:
    [[nodiscard]] HttpResponse PerformOnce(const HttpRequest& request, const std::stop_token& stopToken) const;
};
 
} // namespace MetaImGUI