A consistent starting point
Configure each transport through builders and use a shared asynchronous model. Change the connection without rebuilding your application around a different API.
SIMPLE, RELIABLE ASYNC COMMUNICATION
Connect devices and services with a consistent C++20 interface for Serial, TCP, UDP and UDS.
C++20 · Linux / macOS / Windows · Apache-2.0
A common API shape across four transport families.
01 / BUILT FOR CONNECTIONS
For applications that speak to serial sensors, TCP services and UDP telemetry feeds.
Configure each transport through builders and use a shared asynchronous model. Change the connection without rebuilding your application around a different API.
Choose line-delimited, start/end pattern or length-prefixed framing. Add your own IFramer when your protocol needs it.
Inspect runtime statistics and queue behavior. Callback-scoped data views make data ownership explicit; copy payloads when they need to outlive a callback.
02 / A FAMILIAR SHAPE
Set connection limits, attach a callback and build your client. The quick start shows a complete program and its lifecycle.
C++ quick start ↗auto client = wirestead::tcp_client("127.0.0.1", 8080)
.max_retries(3)
.connection_timeout(std::chrono::seconds(2))
.on_data([](const wirestead::MessageContext& ctx) {
std::cout << ctx.data().size() << " bytes\n";
})
.build();Builder excerpt. Includes, startup and shutdown are shown in the quick start.
03 / ALSO SPEAKS PYTHON
Use Wirestead through its Python bindings. Install from PyPI and explore the package API.
Explore Python bindings ↗INSTALL
pip install wiresteadCREATE A CLIENT
import wirestead
client = wirestead.TcpClient("127.0.0.1", 9000)Python bindings are experimental. Check the compatibility guide for supported wheels and matching core versions.
Compatibility guide ↗04 / START BUILDING
Start with vcpkg, or use CMake FetchContent and source builds.
Installation guide ↗Explore the API reference, callback lifetimes and error handling.
Read the docs ↗Find examples to help connect the library to your application.
Browse examples ↗