https://github.com/fetisov/httpio

Stand-Alone Cross Platform request parser and response generator for the HTTP protocol
https://github.com/fetisov/httpio

Last synced: about 2 months ago
JSON representation

Stand-Alone Cross Platform request parser and response generator for the HTTP protocol

• Host: GitHub
• URL: https://github.com/fetisov/httpio
• Owner: fetisov
• License: mit
• Created: 2016-09-05T17:22:36.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2016-09-06T01:46:19.000Z (about 8 years ago)
• Last Synced: 2024-06-24T01:01:54.579Z (3 months ago)
• Language: C
• Homepage:
• Size: 21.5 KB
• Stars: 5
• Watchers: 4
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-embedded-software - httpio - Stand-Alone Cross Platform request parser and response generator for the HTTP protocol. (Protocols / Network protocols)

README

        
# httpio

Cross Platform parser and response generator for the HTTP protocol.

Library has the simple API to embed to the custom systems.

Parser functions:

- Parses the HTTP stream on the fly

- Does not use the dynamic allocation (uses predefined connection buffer as the simple pool)

- Not used space of the connection buffer can be used as the network receiving buffer

- Supports the keep-alive multiple requests and various types of POST request

Generator functions:

- As well as the parser it does not use the dynamic allocation

- Organized by a ring buffer

- Supports the chunked transfer encoding

# Parser example (stdin instead the socket)

```c

#include 

#include "httpio.h"

static char in_pool[1024];

int main(int argc, const char **argv)

{

    FILE *f;

    httpi_t *in;

    f = argc == 2 ? fopen(argv[1], "rb") : stdin;

    in = httpi_init(in_pool, 1024);

    while (1)

    {

        int size;

        char *data;

        int status = httpi_pull(in);

        switch (status)

        {

        case HTTP_IN_NODATA:

            /* data input */

            httpi_get_state(in, &data, &size);

            size = fread(data, 1, size, f);

            httpi_push(in, data, size);

            if (size == 0) return 0;

            continue;

        case HTTP_IN_REQUEST:

            printf("page %s requested\n", httpi_request(in)->uri);

            continue;

        case HTTP_IN_POSTDATA:

            printf("new chunk of POST data \"%s\"\n", httpi_posted(in)->name);

            continue;

        case HTTP_IN_FINISHED:

            printf("request finished\n");

            continue;

        default:

            printf("invalid request!\n");

            return 0;

        }

    }

}

```

Example input:

```http

POST /cgi-bin/login.cgi HTTP/1.1

Host: www.tutorialspoint.com

Content-Type: application/x-www-form-urlencoded

Content-Length: 35

Accept-Language: en-us

Accept-Encoding: gzip, deflate

Connection: Keep-Alive

login=Petya%20Vasechkin&password=qq

```

Example output:

```

page /cgi-bin/login.cgi requested

new chunk of POST data "login"

new chunk of POST data "password"

request finished

```

# Response generator example (stdout instead the socket)

```c

#include 

#include "httpio.h"

static char out_pool[1024];

int main(int argc, const char **argv)

{

    FILE *f;

    httpo_t *out;

    http_resp_t resp;

    char *data;

    int size;

    out = httpo_init(out_pool, 1024);

    http_resp_init(&resp, 200, MIME_TEXT_HTML, RESPF_KEEPALIVE | RESPF_CHUNKED | RESPF_NOCACH);

    httpo_write_resp(out, &resp);

    httpo_write_data(out, "first data chunk", 16);

    httpo_write_data(out, "the second data chunk", 21);

    httpo_finished(out);

    httpo_state(out, &data, &size);

    fwrite(data, 1, size, stdout);

    return 0;

}

```

Example output:

```http

HTTP/1.1 200 OK

Content-Language: en

Content-Type: text/html

Connection: keep-alive

Cache-Control: no-store, no-cache

Transfer-Encoding: chunked

10

first data chunk

15

the second data chunk

0

```