mapepire 0.4.0

Async Rust client for Mapepire — Db2 for IBM i over secure WebSockets
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

#![cfg_attr(docsrs, feature(doc_cfg))]
#![doc = include_str!("../README.md")]
//!
//! ---
//!
//! ## Building a `DaemonServer`
//!
//! ```
//! use mapepire::{DaemonServer, TlsConfig};
//!
//! let server = DaemonServer::builder()
//!     .host("ibmi.example.com")
//!     .user("DCURTIS")
//!     .password("hunter2".to_string())
//!     .tls(TlsConfig::Verified)
//!     .build()
//!     .expect("missing required field");
//!
//! assert_eq!(server.port, DaemonServer::DEFAULT_PORT);
//! ```
//!
//! ## Encoding a request
//!
//! ```
//! use mapepire::protocol::request::Request;
//!
//! let r = Request::Sql {
//!     id: "1".into(),
//!     sql: "SELECT 1 FROM SYSIBM.SYSDUMMY1".into(),
//!     rows: None,
//!     parameters: None,
//! };
//! let json = serde_json::to_string(&r).expect("Request serializes to JSON");
//! assert!(json.contains(r#""type":"sql""#));
//! ```

#[cfg(not(any(feature = "rustls-tls", feature = "native-tls")))]
compile_error!(
    "mapepire requires one of: feature `rustls-tls` (default) or feature `native-tls`. \
     Disable default features only when explicitly enabling another TLS backend."
);

pub mod config;
pub mod error;
pub mod password;
pub mod protocol;

pub mod executor;
pub mod from_row;
pub mod job;
pub(crate) mod job_helpers;
#[cfg(feature = "metrics")]
#[cfg_attr(docsrs, doc(cfg(feature = "metrics")))]
pub mod observability;
pub mod pool;
pub mod query;
pub(crate) mod transport;

pub use crate::config::{BuilderError, DaemonServer, DaemonServerBuilder, TlsConfig};
#[cfg(feature = "serde-config")]
#[cfg_attr(docsrs, doc(cfg(feature = "serde-config")))]
pub use crate::config::{DaemonServerSpec, SpecError, TlsConfigSpec};
pub use crate::error::{
    DecodeError, DiagnosticItem, Error, ProtocolError, Result, ServerError, TransportError,
};
pub use crate::executor::Executor;
pub use crate::from_row::FromRow;
pub use crate::job::{Job, TraceLevel};
pub use crate::password::Password;
pub use crate::pool::{ParameterLogging, Pool, PoolBuilder, PoolStatus, RecyclingMethod, Reserved};
pub use crate::protocol::{
    ClMessage, Column, ErrorResponse, IdAllocator, QueryMetaData, QueryResult, Request, RequestId,
    Response,
};
pub use crate::query::{Query, Row, Rows};