5 releases
0.2.3 | Jun 27, 2024 |
---|---|
0.2.2 | Mar 24, 2024 |
0.2.1 | Mar 24, 2024 |
0.2.0 | Feb 14, 2024 |
0.1.0 | Feb 10, 2024 |
#1739 in Network programming
71KB
1.5K
SLoC
Atlas HTTP -
Clean, simplistic, easy to use HTTP client. Features:
- Asynchronous and synchronous clients.
- Straight forward functions to download files, and send GET< POST, PUT< DELETE< HEAD, OPTIONS requests.
- Modelled after PHP's PSR-7 standard.
- HTTP and SOCKS5 proxy support
- Automated management of cookie jar
Examples
use atlas_http::{HttpClient, HttpRequest, HttpBody, ProxyType};
// Simple GET request emulating web browser, utilizing cookies.txt as cookie jar
let mut http = HttpClient::builder()
.browser()
.cookie_jar("/path/to/cookies.txt")
.build_sync();
let res = http.get("https://www.google.com/").unwrap();
println!("Status: {}\nBody:\n\n{}", res.status_code(), res.body());
// POST request
let body = HttpBody::from_string("name=John Smith&email=john@example.com&country=CA");
let res = http.post("https://domain.com/register", &body).unwrap();
println!("Status: {}\nBody:\n\n{}", res.status_code(), res.body());
// Normal PSR-7 style POST, with upload file
let mut body = HttpBody::empty();
body.set_param("name", "John SMith");
body.set_param("email", "john@example.com");
body.upload_file("document", "/path/to/document.pdf");
let headers = vec![
"Site-User: myuser",
"Site-API-Key: abc12345"
];
let req = HttpRequest::new("POST", "https://example.com/form", &headers, &body);
let res = http.send(&req).unwrap();
println!("Status: {}\nBody:\n\n{}", res.status_code(), res.body());
// Download file
let res = http.download("https://example.com/path/to/file.tar.gz", "/home/me/file.tar.gz").unwrap();
if res.status_code() == 200 {
println!("GOt file!");
}
/// Send over SOCKS5 proxy at 192.168.0.24:1080
let mut http = HttpClient::builder()
.browser()
.cookie_jar("/path/to/cookies.txt")
.proxy("192.168.0.24", 1080)
.proxy_auth("myuser", "mypassword")
.proxy_type(ProxyType::SOCKS5)
.build_sync();
let res = http.get("https://some-domain.com/").unwrap();
println!("Status: {}\nBody:\n\n{}", res.status_code(), res.body());
/// Asynchronous example
let mut http = HttpClient::builder().browser().build_async();
let res = http.get("https://www.google.com/").await.unwrap();
println!("Status: {}\nBody:\n\n{}", res.status_code(), res.body());
// Async works exactly the same as syncronous. The only
// difference is you call ".build_async()" at the end of
// the builder instead of ".build_sync()". That's it.
Contact
If you need any assistance or software development done, contact me via e-mail at matt@apexpl.io.
Coming shortly, almost done.
Dependencies
~12–20MB
~379K SLoC