grr-cli 0.4.0

Google tools from the terminal, at maximum performance: zero-config Gmail, Calendar, Drive, Contacts, Chat and Forms over HTTP/3
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

//! grr-core — the shared base for every grr service client.
//!
//! Service-agnostic: OAuth (keyring-backed), zero-config HTTP transport
//! with HTTP/3 and rate-limit-aware retry, config, and runtime probes.
//! Service modules (Gmail, Calendar, Drive, People, Chat, Forms) build typed
//! clients on [`HttpCore`].
//!
//! - HTTP/3 with QUIC (via reqwest unstable), always compiled
//! - Auto-tuned transport: zero config, adaptive pooling and backoff
//! - OS-keyring token storage with file fallback
//! - Parallel batch operations bounded by API rate limits, not threads
//! - Automatic io_uring detection on Linux

#![deny(unsafe_code)]
#![deny(clippy::unwrap_used)]
#![deny(clippy::expect_used)]
#![deny(clippy::panic)]

pub mod auth;
pub mod config;
pub mod config_loader;
pub mod error;
pub mod fs_io;
pub mod http;
mod pagination;
pub mod runtime;

pub(crate) use pagination::{Page, paginate};

pub use auth::{AuthConfigBuilder, DeviceAuthChallenge, GoogleAuth, TokenStorage};
pub use config::{GrrConfig, OAuthConfig};
pub use config_loader::ConfigLoader;
pub use error::{GrrError, Result};
pub use http::{
    HttpCore, TransportInfo, TransportMode, apply_transport_version, resolve_transport_mode,
};
pub use runtime::{RuntimeFeatures, detect_runtime_features};

/// Prelude for convenient imports
pub mod prelude {
    pub use crate::core::auth::{AuthConfigBuilder, DeviceAuthChallenge, GoogleAuth, TokenStorage};
    pub use crate::core::config::{GrrConfig, OAuthConfig};
    pub use crate::core::config_loader::ConfigLoader;
    pub use crate::core::error::{GrrError, Result};
    pub use crate::core::http::{
        HttpCore, TransportInfo, TransportMode, apply_transport_version, resolve_transport_mode,
    };
    pub use crate::core::runtime::{RuntimeFeatures, detect_runtime_features};
}