Skip to main content

swbt_bumble_backend/
lib.rs

1//! Bluetooth Classic HID backend extracted for `swbt-rs`.
2//!
3//! Bumble-derived protocol and transport types remain private behind the owned
4//! [`Session`] API.
5
6#![forbid(unsafe_code)]
7
8mod api;
9#[expect(
10    dead_code,
11    reason = "the private host retains tested helpers used by extracted protocol fixtures"
12)]
13mod classic_host;
14mod csr;
15mod hci;
16mod hid_service;
17#[expect(
18    dead_code,
19    reason = "the private HIDP codec retains tested message forms outside the session subset"
20)]
21mod hidp;
22mod identity;
23#[expect(
24    dead_code,
25    reason = "the private L2CAP codec retains tested ERTM paths outside the session subset"
26)]
27mod l2cap;
28#[expect(
29    dead_code,
30    reason = "the private SDP codec retains tested client paths outside the session subset"
31)]
32mod sdp;
33mod session;
34#[expect(
35    dead_code,
36    reason = "the private USB transport retains scripted test helpers outside the session subset"
37)]
38mod usb;
39mod values;
40
41pub use api::{
42    ActivityNotifier, AdapterSelector, BondStore, BondStoreError, Capabilities, Channel,
43    ControllerVersion, Error, ErrorKind, Event, HidSdpPolicy, HidServiceConfig, LocalIdentity,
44    OpenOptions, Session, SessionConfig, UsbAdapterMetadata,
45};
46pub use values::{AddressKind, BluetoothAddress, BluetoothUuid, ClassicBond, ValueError};
47
48/// Fixed Bumble fork revision used as the extraction baseline.
49pub const EXTRACTION_SOURCE_REVISION: &str = "cb55e2d98dc7b7b0227c43772c9ae184034dd9a1";
50
51#[cfg(test)]
52mod tests {
53    use super::EXTRACTION_SOURCE_REVISION;
54
55    #[test]
56    fn extraction_source_revision_is_a_full_git_object_id() {
57        assert_eq!(EXTRACTION_SOURCE_REVISION.len(), 40);
58        assert!(
59            EXTRACTION_SOURCE_REVISION
60                .bytes()
61                .all(|byte| byte.is_ascii_hexdigit())
62        );
63    }
64}