turn_server_proto/
lib.rs

1// Copyright (C) 2025 Matthew Waters <matthew@centricular.com>
2//
3// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
4// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
5// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
6// option. This file may not be copied, modified, or distributed
7// except according to those terms.
8
9//! # turn-server-proto
10//!
11//! `turn-server-proto` provides a sans-IO API for a TURN server communicating with many TURN client.
12//!
13//! Relevant standards:
14//! - [RFC5766]
15//!
16//! [RFC5766]: https://datatracker.ietf.org/doc/html/rfc5766
17
18#![deny(missing_debug_implementations)]
19#![deny(missing_docs)]
20
21mod server;
22
23pub use server::{TurnServer, TurnServerPollRet};
24pub use stun_proto as stun;
25pub use turn_types as types;
26
27#[cfg(test)]
28mod tests {
29    use tracing::subscriber::DefaultGuard;
30    use tracing_subscriber::layer::SubscriberExt;
31    use tracing_subscriber::Layer;
32
33    pub fn test_init_log() -> DefaultGuard {
34        turn_types::debug_init();
35        let level_filter = std::env::var("TURN_LOG")
36            .or(std::env::var("RUST_LOG"))
37            .ok()
38            .and_then(|var| var.parse::<tracing_subscriber::filter::Targets>().ok())
39            .unwrap_or(
40                tracing_subscriber::filter::Targets::new().with_default(tracing::Level::TRACE),
41            );
42        let registry = tracing_subscriber::registry().with(
43            tracing_subscriber::fmt::layer()
44                .with_file(true)
45                .with_line_number(true)
46                .with_level(true)
47                .with_target(false)
48                .with_test_writer()
49                .with_filter(level_filter),
50        );
51        tracing::subscriber::set_default(registry)
52    }
53}