Overview:
Aria's C HTTP Client is a simple HTTP client library for the C programming language. The library allows users to easily send HTTP requests and handle responses. Please note that the project is still in development and may undergo further enhancements.
Features:
- HTTP Request Parsing: The library provides functionality to parse HTTP requests and generate request strings.
- HTTP Response Parsing: Users can parse HTTP responses and extract relevant information.
- TCP-based Client: A basic TCP client is included for sending HTTP requests and receiving responses.
Usage:
-
HTTP Request:
- To create an HTTP request, use the
HTTPRequeststructure to specify the method, path, headers, and body.
Example:
HashTable *headers = createhash(); HTTPRequest *request = malloc(sizeof(HTTPRequest)); request->body = "test body"; request->method = "GET"; request->path = "/"; request->headers = headers; addtohash(headers, "key1", "val1");
- To create an HTTP request, use the
-
HTTP Response:
- The library supports parsing HTTP responses using the
parse_responsefunction. - The parsed response is stored in the
HTTPResponsestructure, providing access to status codes, headers, and the response body.
Example:
char *response_string = "HTTP/1.1 200 OK\nContent-Type: text/html\n\n<html><body>Hello, World!</body></html>"; HTTPResponse *response = parse_response(response_string);
- The library supports parsing HTTP responses using the
-
TCP Client:
- Use the
shttpfunction to send an HTTP request to a specified server and port using a TCP socket. - The function returns an
HTTPResponsestructure containing the parsed response.
Example:
HTTPResponse *response = shttp(request, "127.0.0.1", 8080, 0);
- Use the
-
Full Usage:
// Create and mount the request
HashTable *headers = createhash();
HTTPRequest *request = malloc(sizeof(HTTPRequest));
request->body = "test body";
request->method = "GET";
request->path = "/";
request->headers = headers;
addtohash(headers, "key1", "val1");
// Call the target server
HTTPResponse *response = shttp(request, "127.0.0.1", 8080, 0);
// Use the response
printf("%s\n", response->body);
printf("%d\n", response->status);
kv = (KeyValue *)getfromindex(response->headers, 0);
printf("key: %s\n", kv->key);
printf("val: %s\n", kv->value);
free(request);
destroy_response(response);- Full Usage With SSL
// Incluse SSL libraries
#include <openssl/ssl.h>
#include <openssl/evp.h>
...
// Create and mount the request
HashTable *headers = createhash();
HTTPRequest *request = malloc(sizeof(HTTPRequest));
request->body = "test body";
request->method = "GET";
request->path = "/";
request->headers = headers;
addtohash(headers, "key1", "val1");
// Call the target server
HTTPResponse *response = shttp(request, "127.0.0.1", 8080, 1);
// Use the response
printf("%s\n", response->body);
printf("%d\n", response->status);
kv = (KeyValue *)getfromindex(response->headers, 0);
printf("key: %s\n", kv->key);
printf("val: %s\n", kv->value);
destroy_response(response);
free(request);Don't forget to link -lcrypto and -lss when compiling.
Building:
The library can be integrated into your C project by including the necessary header files and source files.
Next Steps and Improvements:
- Support for TLS/SSL Security: Enhance the library to support secure communication using TLS/SSL.
- Support for Encoded Responses: Implement support for decoding various content encodings in HTTP responses.
- Support for Cache: Integrate caching mechanisms to improve performance and reduce redundant requests.
Contributions:
Contributions to the project are welcome. If you find any issues, have feature requests, or want to contribute to the development, please create an issue or submit a pull request.
License:
This project is licensed under the MIT License.
Disclaimer:
Aria's C HTTP Client is still in development, and its features may be subject to change. Use it at your own discretion.