trellis-net 0.1.0

A simple networking library for Rust.
Documentation 
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


// ===== Imports =====
use std::{io::Error, net::SocketAddr};
use tokio::net::TcpListener;

use crate::{Address, connection::Connection};
// ===================

/// # Listener
/// I/O Object for listening to and accepting `Connection`s.
pub struct Listener {
  pub local_addr: Address,
  listener: TcpListener,
}

impl Listener {
  /// ## Constructor
  /// Creates a new `Listener` instance.
  pub async fn new(listen_at: Address) -> Result<Self, Error> {
    let listen_at: SocketAddr = listen_at.into();
    let listener = TcpListener::bind(listen_at).await?;
    let local_addr = listener.local_addr()?.into();
    Ok(Self { local_addr, listener })
  }

  /// ## Accept
  /// Accepts an incoming `Connection`.
  pub async fn accept(&self) -> Result<Connection, Error> {
    let (stream, _) = self.listener.accept().await?;
    let conn = Connection::try_from(stream)?;
    Ok(conn)
  }
}