http_utils.h

Go to the documentation of this file.

/*
 * SNode.C - A Slim Toolkit for Network Communication
 * Copyright (C) 2020, 2021 Volker Christian <me@vchrist.at>
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */
 
/*
 * MIT License
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
 
#ifndef WEB_HTTP_UTILS_H
#define WEB_HTTP_UTILS_H
 
#ifndef DOXYGEN_SHOULD_SKIP_THIS
 
namespace web::http {
    class CookieOptions;
    template <typename ValueT>
    class CiStringMap;
} // namespace web::http
 
#include <ctime>
#include <map>
#include <string>
#include <utility>
#include <vector>
 
// IWYU pragma: no_include <iterator>
// IWYU pragma: no_include <bits/types/struct_tm.h>
 
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
 
namespace httputils {
 
    std::string url_decode(const std::string& text);
 
    std::string url_encode(const std::string& text);
 
    std::string& str_trimm(std::string& text);
 
    std::pair<std::string, std::string> str_split(const std::string& base, char c_middle);
 
    std::pair<std::string, std::string> str_split_last(const std::string& base, char c_middle);
 
    std::string to_http_date(struct tm* tm = nullptr);
 
    struct tm from_http_date(const std::string& http_date);
 
    std::string file_mod_http_date(const std::string& filePath);
 
    std::string::iterator to_lower(std::string& string);
 
    std::string toString(const std::string& method,
                         const std::string& url,
                         const std::string& version,
                         const std::map<std::string, std::string>& queries,
                         const web::http::CiStringMap<std::string>& header,
                         const web::http::CiStringMap<std::string>& trailer,
                         const web::http::CiStringMap<std::string>& cookies,
                         const std::vector<char>& body);
 
    std::string toString(const std::string& version,
                         const std::string& statusCode,
                         const std::string& reason,
                         const web::http::CiStringMap<std::string>& header,
                         const web::http::CiStringMap<web::http::CookieOptions>& cookies,
                         const std::vector<char>& body);
 
} // namespace httputils
 
#endif // WEB_HTTP_UTILS_H