tls_api_security_framework/
lib.rs

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
//! [`tls_api`] implementation for `security_framework`.
//!
//! This crate is available on non-iOS or non-macOS, but most operations
//! simply return error. So code depending on this crate can be typechecked
//! without cargo target-specific setup and conditional compilation.

#![deny(rustdoc::broken_intra_doc_links)]
#![cfg_attr(not(any(target_os = "macos", target_os = "ios")), allow(dead_code))]

mod stream;

mod acceptor;
mod connector;
mod error;
mod handshake;

use tls_api::ImplInfo;

pub use acceptor::SecureTransportTlsAcceptorBuilder;
pub use acceptor::TlsAcceptor;
pub use acceptor::TlsAcceptorBuilder;
pub use connector::TlsConnector;
pub use connector::TlsConnectorBuilder;

pub(crate) use error::Error;

#[cfg(any(target_os = "macos", target_os = "ios"))]
pub(crate) use stream::TlsStream;
#[cfg(not(any(target_os = "macos", target_os = "ios")))]
pub(crate) use tls_api_stub::TlsStream;

#[allow(dead_code)]
pub(crate) fn not_ios_or_macos<T>() -> anyhow::Result<T> {
    Err(Error::NotIosOrMacos.into())
}

pub(crate) fn info() -> ImplInfo {
    ImplInfo {
        name: "security-framework",
        version: {
            #[cfg(any(target_os = "macos", target_os = "ios"))]
            {
                "unknown"
            }
            #[cfg(not(any(target_os = "macos", target_os = "ios")))]
            {
                "not iOS or macOS"
            }
        },
    }
}

#[cfg(any(target_os = "macos", target_os = "ios"))]
pub(crate) const IMPLEMENTED: bool = true;
#[cfg(not(any(target_os = "macos", target_os = "ios")))]
pub(crate) const IMPLEMENTED: bool = false;