Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 24 days 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 (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-09-06T01:46:19.000Z (over 8 years ago)
- Last Synced: 2024-08-04T04:02:27.650Z (4 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
```