Crates.io | tcp_typed |
lib.rs | tcp_typed |
version | 0.1.4 |
source | src |
created_at | 2018-08-03 13:17:14.393668 |
updated_at | 2019-08-22 20:49:06.476866 |
description | A wrapper around platform TCP socket APIs that leverages the type system to ensure correct usage. It's quite easy to accidentally misuse the Berkeley sockets or similar APIs, resulting in ECONNRESET/EPIPE/etc, data being lost on close, and potential hangs from non-exhaustive collection of edge-triggered events. This library aims to make it impossible to misuse in non-unsafe code. |
homepage | https://github.com/alecmocatta/tcp_typed |
repository | https://github.com/alecmocatta/tcp_typed |
max_upload_size | |
id | 77337 |
size | 71,730 |
A wrapper around platform TCP socket APIs that leverages the type system to ensure correct usage.
It's quite easy to accidentally misuse the Berkeley sockets or similar APIs, resulting in ECONNRESET/EPIPE/etc, data being lost on close, and potential hangs from non-exhaustive collection of events given edge-triggered notifications.
This library aims to make it impossible to misuse in non-unsafe code.
If you ever see a connection reset / ECONNRESET, EPIPE, data being lost on close, or panic, then it is a bug in this library! Please file an issue with as much info as possible.
It's designed to be used in conjunction with an implementer of the Notifier
trait – for example notifier
. As long as the Notifier
contract is fulfilled, then this library will collect all relevent events (connected, data in, data available to be written, remote closed, bytes acked, connection errors) upon each edge-triggered notification.
Currently doesn't support Windows.
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.