dingding 0.1.1

DingTalk SDK and bot framework for Rust.
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
73
74
75
76

#![forbid(unsafe_code)]
#![warn(missing_docs)]
#![warn(rustdoc::broken_intra_doc_links)]

//! DingTalk SDK and bot framework.
//!
//! The crate keeps the public surface small:
//! - [`DingTalk`] is the SDK entry point.
//! - `webhook` sends custom robot and session webhook messages when the `webhook` feature is enabled.
//! - `bot` routes incoming robot events when the `bot` feature is enabled.
//! - `stream` runs enterprise application robots over DingTalk Stream when the `stream` feature is enabled.

#[cfg(not(any(
    feature = "async-tls-rustls-ring",
    feature = "async-tls-rustls-aws-lc-rs",
    feature = "async-tls-native"
)))]
compile_error!(
    "Enable exactly one async TLS feature: \
     `async-tls-rustls-ring`, `async-tls-rustls-aws-lc-rs`, or `async-tls-native`."
);

#[cfg(all(
    feature = "async-tls-rustls-ring",
    feature = "async-tls-rustls-aws-lc-rs"
))]
compile_error!("`async-tls-rustls-ring` and `async-tls-rustls-aws-lc-rs` are mutually exclusive.");

#[cfg(all(feature = "async-tls-rustls-ring", feature = "async-tls-native"))]
compile_error!("`async-tls-rustls-ring` and `async-tls-native` are mutually exclusive.");

#[cfg(all(feature = "async-tls-rustls-aws-lc-rs", feature = "async-tls-native"))]
compile_error!("`async-tls-rustls-aws-lc-rs` and `async-tls-native` are mutually exclusive.");

#[cfg(not(any(feature = "webhook", feature = "openapi", feature = "bot")))]
compile_error!("Enable at least one capability feature: `webhook`, `openapi`, or `bot`.");

mod client;
mod error;
#[cfg(feature = "webhook")]
mod signature;
mod transport;
mod util;

/// Authentication credentials and token cache helpers.
pub mod auth;

#[cfg(feature = "bot")]
/// Bot callback routing, typed message contexts, and webhook callback verification.
pub mod bot;
#[cfg(feature = "openapi")]
/// Typed OpenAPI helpers for enterprise application robots and interactive cards.
pub mod openapi;
#[cfg(feature = "stream")]
/// DingTalk Stream client, robot runner, subscriptions, and Stream callback frames.
pub mod stream;
#[cfg(feature = "webhook")]
/// Custom robot and session webhook message sender.
pub mod webhook;

/// Common imports for building DingTalk robot applications.
pub mod prelude;
/// Public type re-exports grouped by capability.
pub mod types;

pub use client::{DingTalk, DingTalkBuilder};
pub use error::{Error, ErrorKind, Result};
pub use reqx::advanced::ClientProfile;
pub use reqx::prelude::RetryPolicy;
pub use transport::BodySnippetConfig;

#[cfg(feature = "macros")]
pub use dingding_macros::handler;

/// Backward-friendly alias for the main SDK client.
pub type Client = DingTalk;