Surf

Surf the web

API Docs | Contributing | Chat

_{Built with 🌊 by The Rust Async Ecosystem WG}

About

Surf is the Rust HTTP client we've always wanted. It's completely modular, and built directly for async/await. Whether it's a quick script, or a cross-platform SDK, Surf will make it work.

• Multi-platform out of the box
• Extensible through a powerful middleware system
• Reuses connections through the Client interface
• Fully streaming requests and responses
• TLS/SSL enabled by default
• Swappable HTTP backends (hyper (default), libcurl (wip), fetch (wip))

Examples

let mut res = surf::get("https://google.com").await?;
dbg!(res.body_string().await?);

Installation

$ cargo add surf

Safety

This crate uses #![deny(unsafe_code)] to ensure everything is implemented in 100% Safe Rust.

Contributing

Want to join us? Check out our "Contributing" guide and take a look at some of these issues:

• Issues labeled "good first issue"
• Issues labeled "help wanted"

See Also

• rustasync/http-client
• rustasync/http-service
• rustasync/tide

License

MIT OR Apache-2.0