nle-cloud-sdk 0.1.1

Unofficial asynchronous Rust SDK for the NLECloud (新大陆物联网云平台) IoT platform
Documentation
use serde::{Deserialize, Serialize};

/// Paged collection returned by NLECloud queries (`ListPagerSet<T>`).
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[serde(rename_all = "PascalCase")]
pub struct ListPagerSet<T> {
    /// Total number of pages.
    pub page_count: i32,

    /// Current page index (1-based).
    pub page_index: i32,

    /// Number of items per page.
    pub page_size: i32,

    /// Total number of records across all pages.
    pub record_count: i32,

    /// Data items for the current page.
    #[serde(default = "Vec::new")]
    pub page_set: Vec<T>,
}

impl<T> ListPagerSet<T> {
    /// Returns true if the page set has records.
    pub fn is_empty(&self) -> bool {
        self.page_set.is_empty()
    }

    /// Returns the number of records on the current page.
    pub fn len(&self) -> usize {
        self.page_set.len()
    }
}

/// Base parameters for paginated queries.
#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
#[serde(rename_all = "PascalCase")]
pub struct ApiPagingQueryBase {
    /// 1-based page index (defaults to 1).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub page_index: Option<i32>,

    /// Items per page (defaults to 20, max 100).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub page_size: Option<i32>,

    /// Start date (YYYY-MM-DD or YYYY-MM-DD HH:mm:ss).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub start_date: Option<String>,

    /// End date (YYYY-MM-DD or YYYY-MM-DD HH:mm:ss).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub end_date: Option<String>,
}