http.hpp

Go to the documentation of this file.

#pragma once
#include "kcurl/easy.hpp"
#include "kcurl/http_status.hpp"
#include <string_view>
 
namespace kcurl::http {
enum class Verb : std::int8_t { Get, Post };
 
struct Query {
    std::string key{};
    std::string value{};
};
 
struct Error {
    [[nodiscard]] static auto from_response(Status status, std::string_view error_text) -> Error;
 
    CurlCode curl_code{};
    Status status{};
    std::string text{};
};
 
struct Request {
    using Flag = easy::Request::Flag;
 
    std::string base_url{};
 
    std::string user_agent{};
    std::vector<Query> queries{};
    std::vector<Query> headers{};
    Verb verb{Verb::Get};
    Flag flags{};
};
 
template <typename Type>
struct Response;
 
template <>
struct Response<void> {
    [[nodiscard]] auto rewrap_as_error(std::string_view const error_text) const -> Error {
        return Error::from_response(status, error_text);
    }
 
    Status status{};
};
 
template <typename Type>
struct Response {
    template <typename T>
    [[nodiscard]] auto rewrap_as(T payload) const -> Response<T> {
        return Response<T>{.payload = std::move(payload), .status = status};
    }
 
    [[nodiscard]] auto rewrap_as_void() const -> Response<void> { return Response<void>{.status = status}; }
 
    [[nodiscard]] auto rewrap_as_error(std::string_view const error_text) const -> Error {
        return Error::from_response(status, error_text);
    }
 
    Type payload{};
    Status status{};
};
 
template <typename Type>
using Result = std::expected<Response<Type>, Error>;
 
[[nodiscard]] auto escape(std::string_view text) -> std::string;
[[nodiscard]] auto unescape(std::string_view escaped) -> std::string;
 
[[nodiscard]] auto to_easy_request(Request request) -> easy::Request;
 
[[nodiscard]] auto perform(easy::Request const& request) -> Result<ByteArray>;
 
[[nodiscard]] inline auto fetch(Request request) -> Result<ByteArray> {
    return http::perform(to_easy_request(std::move(request)));
}
} // namespace kcurl::http