https://github.com/kickhead13/ptt.h
A compact and easy-to-use HTTP C library for the web.
https://github.com/kickhead13/ptt.h
c http http-server web-library
Last synced: 10 months ago
JSON representation
A compact and easy-to-use HTTP C library for the web.
- Host: GitHub
- URL: https://github.com/kickhead13/ptt.h
- Owner: kickhead13
- License: gpl-3.0
- Created: 2025-06-20T23:48:12.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-23T12:23:39.000Z (10 months ago)
- Last Synced: 2025-06-23T13:20:50.003Z (10 months ago)
- Topics: c, http, http-server, web-library
- Language: C
- Homepage:
- Size: 45.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ptt.h
> [!WARNING]
> This library is NOT production ready (yet). Please only use it for fun. :)
## Description
`ptt.h` is a simple and easy-to-use HTTP library for C, that will get you past the boredom of initial setups and right into implementing web services... (currently under developement).
## Examples
A simple server that on GET requests to /example responds with a HTML page that displays a friendly message and a button :).
```c
#include "ptt.h"
#include
ptth_response_t get_func(ptth_request_t _, ptth_shared_t *__) {
PTTH_RESPONDE_HTML(
""
""
""
"HI! :)"
"CLICK ME!"
"")
}
int main() {
ptth_server_t server;
ptth_init_server(&server);
ptth_add_service(&server, PTTH_GET, "/example", &get_func);
ptth_bind_server(&server, "127.0.0.1", 8081);
ptth_start(server);
}
```
You're endpoints don't have to be static, you can set up variable names for URL segments and retrieve them at run time. Here is an example where when you access `/hi//` the web server will display the message `"Hi, ! :3"` in the browser.
```c
#include "ptt.h"
#include
ptth_response_t get_func(ptth_request_t req, ptth_shared_t *__) {
char *test = ptth_map_get_value(*(req.mpath), "var_name");
char message[100];
message[0] = '\0';
strcat(message, "Hi, ");
strcat(message, test);
strcat(message, "! :3");
PTTH_RESPONDE_HTML(message)
}
int main() {
ptth_server_t server;
ptth_init_server(&server);
ptth_add_service(&server, PTTH_GET, "/hi/{var_name}/", &get_func);
ptth_bind_server(&server, "127.0.0.1", 8081);
ptth_start(server);
}
```
Here is what the browser displays:
## Installation and Usage
To install and use ptt.h you should simply clone this repository and copy the header in your working directory.
```sh
$ git clone 'https://github.com/kickhead/ptt.h.git'
$ cp ./ptt.h/ptt.h ./../myWorkingDir
```
After that you can use it as any other header library... include it in your porjects :).
```c
#include "ptt.h"
```