theredfoxlee/async_http

Deadly simple C API for making asynchronous HTTP requests.

async_http

async_http - deadly simple C API for making asynchronous HTTP requests.

requirements

• libcurl (at least in version 7.28.0; see how to get curl on your distro)
• gcc (tested on version 10.2.0)

docs for API

• async_http_request_t - async request "class"
• async_http_attr_t - attributes

usage

#include "async_http.h"

#include <stdio.h>

int
main(int argc, char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "usage: %s <url>\n", argv[0]);
        return 1;
    }

    async_http_attr_t *attr = async_http_attr_init();
    async_http_attr_seturl(attr, argv[1]);

    async_http_request_t *request = async_http_request_init(attr);
    async_http_request_state_t state = async_http_request_start(request);

    while (ASYNC_HTTP_REQUEST_RUNNING == state) {
        // do things in the meantime
        state = async_http_request_wait(request, 10);
    }

    if (ASYNC_HTTP_REQUEST_DONE == state) {
        fprintf(stderr, "response code: %ld\n", async_http_request_getresponsecode(request));
        fprintf(stderr, "response: %s\n", async_http_request_getresponse(request));
        fprintf(stderr, "total time: %g\n", async_http_request_gettotaltime(request));
        fprintf(stderr, "server ip: %s\n", async_http_request_gethostip(request));
    } else {
        fprintf(stderr, "async_http failed with state: %d\n", state);
    }

    async_http_request_destroy(request);
    async_http_attr_destroy(attr);
}

notes

async_http API uses abort() policy when memory fails to be allocated in some glib functions or some libcurl internal error happens.

It's a bad design decision if you'd like to perform recovery from that state, but it simplifies an API a lot.

While using most of async_http_* functions, you can be sure that they succeed (no error checking/propagation is required).