url.hpp

Go to the documentation of this file.

#pragma once

 
#include <cstdint>
#include <optional>
#include <string>
#include <string_view>
#include <utility>
#include <vector>
 
namespace pulp::runtime {

struct Url {
    std::string scheme;       // "http", "https", "file", ...
    std::string user;         // userinfo before optional :password
    std::string password;     // userinfo after optional :password (rare)
    std::string host;         // hostname or bracketed IPv6 literal
    uint16_t    port = 0;     // 0 if not specified
    std::string path;         // includes leading '/' if any
    std::string query;        // raw query string, NOT decoded, no '?'
    std::string fragment;     // raw fragment, NOT decoded, no '#'

    bool empty() const {
        return scheme.empty() && host.empty() && path.empty()
            && query.empty() && fragment.empty();
    }

    uint16_t default_port() const;

    uint16_t effective_port() const {
        return port != 0 ? port : default_port();
    }

    std::string to_string() const;

    static std::optional<Url> parse(std::string_view text);

    static bool is_valid(std::string_view text) {
        auto u = parse(text);
        return u.has_value() && !u->scheme.empty();
    }
};

std::string percent_encode(std::string_view s);

std::string percent_decode(std::string_view s);

std::string form_encode(std::string_view s);

std::string form_decode(std::string_view s);

std::vector<std::pair<std::string, std::string>>
parse_query(std::string_view query);

std::string build_query(
    const std::vector<std::pair<std::string, std::string>>& params);
 
}  // namespace pulp::runtime