kiriminaja 0.1.0

Official Rust SDK for the KiriminAja logistics API
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
77

//! # KiriminAja Rust SDK
//!
//! Async Rust client for the [KiriminAja](https://kiriminaja.com) logistics API.
//! API surface mirrors the official [Go SDK](https://github.com/kiriminaja/go).
//!
//! ## Quick start
//!
//! ```no_run
//! use kiriminaja::{Client, Config, Env};
//!
//! # async fn run() -> kiriminaja::Result<()> {
//! let client = Client::new(Config {
//!     env: Env::Sandbox,
//!     api_key: std::env::var("KIRIMINAJA_API_KEY").unwrap_or_default(),
//!     ..Default::default()
//! });
//!
//! let provinces = client.address.provinces().await?;
//! println!("{:?}", provinces);
//! # Ok(()) }
//! ```

pub mod config;
pub mod error;
pub mod http;
pub mod services;
pub mod types;
pub mod utils;

#[cfg(feature = "blocking")]
pub mod blocking;

use std::sync::Arc;

pub use config::{Config, Env};
pub use error::{Error, Result};
pub use http::HttpClient;

use services::address::AddressService;
use services::courier::CourierService;
use services::coverage_area::CoverageAreaService;
use services::credit::CreditService;
use services::order::OrderService;
use services::payment::PaymentService;
use services::pickup::PickupService;

/// Top-level KiriminAja client. Mirrors the Go `Client` struct: services are
/// exposed as public fields so callers write `client.address.provinces()` etc.
#[derive(Debug, Clone)]
pub struct Client {
    pub address: AddressService,
    pub courier: CourierService,
    pub coverage_area: CoverageAreaService,
    pub credit: CreditService,
    pub order: OrderService,
    pub payment: PaymentService,
    pub pickup: PickupService,

    #[allow(dead_code)]
    http: Arc<HttpClient>,
}

impl Client {
    pub fn new(cfg: Config) -> Self {
        let http = Arc::new(HttpClient::from_config(&cfg));
        Self {
            address: AddressService::new(http.clone()),
            courier: CourierService::new(http.clone()),
            coverage_area: CoverageAreaService::new(http.clone()),
            credit: CreditService::new(http.clone()),
            order: OrderService::new(http.clone()),
            payment: PaymentService::new(http.clone()),
            pickup: PickupService::new(http.clone()),
            http,
        }
    }
}