Skip to main content

open_net/
lib.rs

1// Keep shared implementation sources in libs/common while shipping one crate.
2#[path = "../libs/common/src/mod.rs"]
3pub(crate) mod common;
4
5// Share validated retry logic across transports while publishing one crate.
6#[path = "../libs/retry/src/mod.rs"]
7pub(crate) mod retry_core;
8
9pub mod api;
10
11// Unit-test clients use an application-owned provider, just like downstream
12// applications. This initializer and its dependency are never part of the SDK.
13#[cfg(test)]
14#[cfg(any(feature = "ws-client", feature = "http-client"))]
15#[ctor::ctor]
16fn install_unit_test_crypto_provider() {
17    if rustls_openssl::default_provider()
18        .install_default()
19        .is_err()
20    {
21        eprintln!("unit-test TLS provider was already installed; retaining the existing provider");
22    }
23}
24pub(crate) mod inner;
25pub(crate) mod module;
26
27// Keep existing import paths as re-exports of the canonical API modules.
28#[cfg(any(feature = "ws-client", feature = "http-client"))]
29pub use api::tls;
30pub use api::{config, error, network, retry, subscription};
31#[cfg(feature = "net-status")]
32pub use api::{
33    net_status, IpStack, MonitorState, NetStatusClient, NetworkEvent, NetworkEventKind,
34    NetworkEventOptions, NetworkIpStackSource, NetworkNameObserver, NetworkNameOptions,
35    NetworkNameSnapshot, NetworkNameSource, NetworkNameState, NetworkObservation,
36    NetworkRefreshResult, NetworkSnapshot, NetworkStatus,
37};
38#[cfg(feature = "ws-client")]
39pub use api::{ws, WebSocketClient};
40pub use api::{
41    BoxError, Bytes, EnqueueError, HeaderMap, HeaderName, HeaderValue, LogDropStats, LogInfo,
42    LogLevel, LogListener, LogSubscription, LogSubscriptionOptions, LogType, Metadata, NetError,
43    OpenNet, OpenNetConfig, OpenNetLogger, Result, SharedLogListener, StatusCode,
44};
45#[cfg(feature = "http-client")]
46pub use async_trait::async_trait;
47#[cfg(feature = "ws-client")]
48pub(crate) use network::{NetworkConfig, NetworkStatusPolicy, ProxyConfig};
49
50// Exported macros must resolve their helpers from downstream crates.
51#[doc(hidden)]
52pub use serde_json as __serde_json;
53
54#[doc(hidden)]
55pub mod __log {
56    pub use crate::common::log::log_def::on_log;
57    pub use crate::common::log::summary::error as error_summary;
58}