1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

//! # About
//! This library provides a simple timeout-based API for IO-operations.
//!
//! It provides the following features:
//!  - DNS-resolution (currently uses a background-thread)
//!  - TCP-accept
//!  - TCP-read/read-until/write
//!  - StdIOE-read/read-until/write
//!  - UDP-receive/send
//!
//! All functions are defined as traits, so that you can easily wrap your own IO-channels without
//! breaking compatibility.
//!
//! _Note: We currently do not provide a function for timeout-based `connect`-calls; use
//! `std::net::TcpStream::connect_timeout` for TCP-connections or build sth. using `io::libselect`
//! (and feel free to commit if you do so 😇)_


// Mods
mod event;
mod reader;
mod writer;
mod acceptor;
mod resolver;


// Create re-exports
pub use crate::{
	acceptor::Acceptor, reader::Reader, writer::Writer,
	event::{ RawFd, EventMask, SelectSet, WaitForEvent },
	resolver::{ DnsResolvable, IpParseable }
};
use std::{
	error::Error,
	fmt::{ self, Display, Formatter },
	time::{ Duration, Instant },
	io::{
		self,
		ErrorKind::{
			Interrupted, TimedOut, WouldBlock, UnexpectedEof,
			BrokenPipe, ConnectionAborted, ConnectionReset
		}
	}
};


/// An IO-error-wrapper
#[derive(Debug, Clone, Eq, PartialEq)]
pub enum TimeoutIoError {
	InterruptedSyscall,
	TimedOut,
	UnexpectedEof,
	ConnectionLost,
	NotFound,
	InvalidInput,
	Other{ desc: String }
}
impl TimeoutIoError {
	pub fn should_retry(&self) -> bool {
		match self {
			TimeoutIoError::InterruptedSyscall | TimeoutIoError::TimedOut => true,
			_ => false
		}
	}
}
impl Display for TimeoutIoError {
	fn fmt(&self, f: &mut Formatter) -> fmt::Result {
		write!(f, "{:?}", self)
	}
}
impl Error for TimeoutIoError {}
impl From<io::Error> for TimeoutIoError {
	fn from(error: io::Error) -> Self {
		match error.kind() {
			Interrupted => TimeoutIoError::InterruptedSyscall,
			TimedOut | WouldBlock => TimeoutIoError::TimedOut,
			UnexpectedEof => TimeoutIoError::UnexpectedEof,
			BrokenPipe | ConnectionAborted | ConnectionReset => TimeoutIoError::ConnectionLost,
			_ => TimeoutIoError::Other{ desc: format!("{:#?}", error) }
		}
	}
}


/// Extends `std::time::Instant`
pub trait InstantExt {
	/// Computes the remaining time underflow-safe
	fn remaining(self) -> Duration;
}
impl InstantExt for Instant {
	fn remaining(self) -> Duration {
		let now = Instant::now();
		if now > self { Duration::from_secs(0) }
			else { self - now }
	}
}