bytehound-opc-da-client 0.2.0

Backend-agnostic OPC DA client library for Rust — async, trait-based, with transparent COM management
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

#![allow(unsafe_code, unreachable_pub)]
#![doc = include_str!("../README.md")]
//! # opc-da-client
//!
//! Backend-agnostic OPC DA client library for Rust — async, trait-based,
//! with transparent COM management.
//!
//! ## Quick Start
//!
//! ```no_run
//! # use anyhow::Result;
//! use opc_da_client::{OpcDaClient, OpcProvider};
//!
//! # #[tokio::main]
//! # async fn main() -> Result<()> {
//! let client = OpcDaClient::default();
//! let servers = client.list_servers("localhost").await?;
//! # Ok(())
//! # }
//! ```
//!
//! ## Feature Flags
//!
//! | Flag | Default | Effect |
//! |------|---------|--------|
//! | `opc-da-backend` | ✅ | Native OPC DA backend via `windows-rs` |
//! | `test-support` | ❌ | Enables `MockOpcProvider` via `mockall` |
//!
//! ## Platform
//!
//! **Windows only** — OPC DA is built on COM/DCOM.

mod com_guard;
pub use com_guard::ComGuard;
mod helpers;
#[cfg(feature = "opc-da-backend")]
mod native_browse;
mod provider;

#[cfg(feature = "opc-da-backend")]
#[allow(warnings)]
mod bindings;
pub mod com_worker;

#[cfg(feature = "opc-da-backend")]
#[allow(warnings)]
mod opc_da;

#[cfg(feature = "opc-da-backend")]
mod backend;

// Stable public API
pub use helpers::{format_hresult, friendly_com_hint, log_opc_error};
pub use provider::{
    BrowseCapabilities, BrowseNamespace, BrowseNode, BrowseNodeFilter, BrowseNodeKind,
    BrowseNodeToken, BrowsePage, BrowsePageRequest, BrowsePageToken, BrowseSessionToken,
    OpcProvider, OpcValue, TagValue, WriteResult,
};

#[cfg(feature = "opc-da-backend")]
pub use opc_da::{
    errors::{OpcError, OpcResult},
    typedefs::{GroupHandle, ItemHandle},
};

// Backend re-exports (conditional)
#[cfg(feature = "opc-da-backend")]
pub use backend::{connector::ComConnector, opc_da::OpcDaClient};

// Test support re-export
#[cfg(feature = "test-support")]
pub use provider::MockOpcProvider;