view release on metacpan or  search on metacpan

clib/README.md  view on Meta::CPAN

# Protocol-HTTP

Protocol-HTTP - very fast HTTP protocol incremental parser and serializer

Features: cookies, transparent (un)compression with `Gzip` or `Brotli`, transparent chunked transfer encoding for body streaming, respecting request's preferences when making response.

The module is a protocol implementation, by itself it does not perform any I/O activity. For HTTP library see [UniEvent-HTTP](https://github.com/CrazyPandaLimited/UniEvent-HTTP).

Currenly supported HTTP versions are 1.0 and 1.1

# Synopsis

```cpp
using namespace panda::protocol::http;
RequestSP request = Request::Builder()
    .method(Method::Get)
    .uri("http://crazypanda.ru/hello/world")
    .header("MyHeader", "my value")
    .header("MyAtherH", "val2")
    .cookie("coo1", "val2")
    .body("my body")
    .build();

string req_str = request->to_string(); // => GET /hello/world HTTP/1.1| ...

// server api - parse request
// my ($state, $position, $error);
RequestParser req_parser;
auto result = req_parser.parse(req_str);
if (result.state == State::done) {
    RequestSP request = result.request;
    std::cout << request->uri << "\n"
                << request->body;

    string next_req = req_str.substr(result.position);
}

// server api - make response
ResponseSP response = Response::Builder()
    .code(200)
    .header("Lang", "C++")
    .body("Lorem ipsum dolor")
    .build();

string res_str = response->to_string(request);

// client api - parse response
ResponseParser res_parser;
res_parser.set_context_request(request);
auto response_result = res_parser.parse(res_str);
if (response_result.state == State::done) {
    ResponseSP response = response_result.response;
    std::cout << response->code    // 200, 404, etc
                << response->message // status message, e.g OK
                << response->body;
}
// compression with chunks

request = Request::Builder()
    .method(Method::Post)
    .uri("https://images.example.com/upload")
    .compress(compression::Compression::GZIP)
    .chunked()
    .build();