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
97
98

//! # 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 (uses libselect)
//!  - TCP-read/read-until/write (uses libselect)
//!  - StdIOE-read/read-write/write (uses libselect)
//!  - UDP-receive/send (uses libselect)
//!
//! 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::{
	fmt::{ Display, Formatter, Result as FmtResult }, time::{ Duration, Instant },
	io::{ Error as StdIoError, ErrorKind as IoErrorKind }
};


#[derive(Debug, Clone, Eq, PartialEq)]
/// An IO-error-wrapper
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) -> FmtResult {
		write!(f, "{:?}", self)
	}
}
impl From<StdIoError> for TimeoutIoError {
	fn from(error: StdIoError) -> Self {
		match error.kind() {
			IoErrorKind::Interrupted => TimeoutIoError::InterruptedSyscall,
			IoErrorKind::TimedOut | IoErrorKind::WouldBlock => TimeoutIoError::TimedOut,
			IoErrorKind::UnexpectedEof => TimeoutIoError::UnexpectedEof,
			IoErrorKind::BrokenPipe | IoErrorKind::ConnectionAborted | IoErrorKind::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 }
	}
}
/// Extends `std::time::Duration`
pub trait DurationExt {
	/// The duration in milliseconds
	fn as_ms(&self) -> u64;
}
impl DurationExt for Duration {
	fn as_ms(&self) -> u64 {
		(self.as_secs() * 1000) + (self.subsec_nanos() as u64 / 1_000_000)
	}
}