base-endpoint 0.2.0

Runtime-independent binding and connecting through Base scheduler capabilities
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

// Released under the MIT License.
// Copyright, 2026, by Samuel Williams.

use super::TlsListener;
use crate::{BindEndpoint, BindOptions};
use base_scheduler::{Cancellation, OperationResult};

/// Compose binding with a configured TLS server provider. Binding wraps listeners; each accepted connection performs its own handshake. Wrap a composite endpoint here to support multiple listening addresses.
#[derive(Clone, Debug)]
pub struct TlsServerEndpoint<E, T> {
    endpoint: E,
    acceptor: T,
}

impl<E, T> TlsServerEndpoint<E, T> {
    /// Describe TLS listeners without performing I/O. The acceptor is cloned for each listener; providers can share immutable configuration internally.
    pub fn new(endpoint: E, acceptor: T) -> Self {
        Self { endpoint, acceptor }
    }

    /// The underlying endpoint description.
    pub fn endpoint(&self) -> &E {
        &self.endpoint
    }
}

impl<S, E, T> BindEndpoint<S> for TlsServerEndpoint<E, T>
where
    S: Sync + ?Sized,
    E: BindEndpoint<S>,
    T: Clone + Send + Sync,
{
    type Listener = TlsListener<E::Listener, T>;

    async fn bind(
        &self,
        scheduler: &S,
        options: BindOptions,
        cancellation: &Cancellation,
    ) -> OperationResult<Vec<Self::Listener>> {
        cancellation.check()?;
        let listeners = self.endpoint.bind(scheduler, options, cancellation).await?;
        Ok(listeners
            .into_iter()
            .map(|listener| TlsListener::new(listener, self.acceptor.clone()))
            .collect())
    }
}