casdoor-sdk-rust 1.1.0

A Casdoor SDK (contain APIs) with more complete interfaces and better usability.
Documentation
use std::fmt::{Debug, Display};

use serde::{de::DeserializeOwned, Deserialize, Serialize};

pub trait Model: Debug + Clone + DeserializeOwned + Serialize {
    /// Model identifier, used for splicing URLs.
    fn ident() -> &'static str;
    /// Models identifier, used for splicing URLs.
    fn plural_ident() -> &'static str;
    /// Indicate whether this model currently supports updating individual columns one by one.
    fn support_update_columns() -> bool;
    fn owner(&self) -> &str;
    fn name(&self) -> &str;
    fn id(&self) -> String {
        format!("{}/{}", self.owner(), self.name())
    }
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub struct ModelModifyArgs<M> {
    pub action: ModelAction,
    pub model: M,
    pub columns: Option<Vec<String>>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub struct ModelAddArgs<M> {
    pub model: M,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub struct ModelUpdateArgs<M> {
    pub model: M,
    pub columns: Vec<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub struct ModelDeleteArgs<M> {
    pub model: M,
}


#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub enum ModelAction {
    Add,
    Delete,
    Update,
}

impl Display for ModelAction {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            ModelAction::Add => write!(f, "add"),
            ModelAction::Delete => write!(f, "delete"),
            ModelAction::Update => write!(f, "update"),
        }
    }
}


#[derive(Debug, Default, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
pub enum ModelActionAffect {
    #[default]
    Affected,
    Unaffected,
}

impl Display for ModelActionAffect {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::Affected => write!(f, "Affected"),
            Self::Unaffected => write!(f, "Unaffected"),
        }
    }
}

impl ModelActionAffect {
    pub fn is_affected(&self) -> bool {
        matches!(self, ModelActionAffect::Affected)
    }
}

#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq, Eq)]
pub struct QueryArgs {
    #[serde(rename = "pageSize", skip_serializing_if = "Option::is_none")]
    pub page_size: Option<i32>,
    #[serde(rename = "p", skip_serializing_if = "Option::is_none")]
    pub page: Option<i32>,
    #[serde(rename = "field", skip_serializing_if = "Option::is_none")]
    pub field: Option<String>,
    #[serde(rename = "value", skip_serializing_if = "Option::is_none")]
    pub value: Option<String>,
    #[serde(rename = "sortField", skip_serializing_if = "Option::is_none")]
    pub sort_field: Option<String>,
    #[serde(rename = "sortOrder", skip_serializing_if = "Option::is_none")]
    pub sort_order: Option<String>,
}

pub(crate) trait IsQueryArgs: Serialize {}

impl IsQueryArgs for QueryArgs {}


#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct QueryResult<M> {
    items: Vec<M>,
    total: i64,
}

impl<M> From<(Vec<M>, i64)> for QueryResult<M> {
    #[inline(always)]
    fn from(value: (Vec<M>, i64)) -> Self {
        Self {
            items: value.0,
            total: value.1,
        }
    }
}