jenkins_api 0.8.0

Bindings for the Jenkins JSON API
Documentation
use serde::{Serialize, Serializer};

/// Jenkins tree query parameter
#[derive(Debug)]
pub struct TreeQueryParam {
    /// Name of the key at the root of this tree
    keyname: Option<String>,
    /// Children keys
    subkeys: Vec<TreeQueryParam>,
}
impl Serialize for TreeQueryParam {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        serializer.serialize_str(&self.to_string())
    }
}
impl ToString for TreeQueryParam {
    fn to_string(&self) -> String {
        match (self.keyname.as_ref(), self.subkeys.len()) {
            (Some(keyname), 0) => keyname.clone(),
            (Some(keyname), _) => format!(
                "{}[{}]",
                keyname,
                self.subkeys
                    .iter()
                    .map(TreeQueryParam::to_string)
                    .collect::<Vec<_>>()
                    .join(",")
            ),
            (None, _) => self
                .subkeys
                .iter()
                .map(TreeQueryParam::to_string)
                .collect::<Vec<_>>()
                .join(","),
        }
    }
}

/// Helper to build a `TreeQueryParam`
///
/// ```
/// jenkins_api::client::TreeBuilder::object("builds")
///     .with_subfield("url")
///     .with_subfield("result")
///     .with_subfield(
///         jenkins_api::client::TreeBuilder::object("actions").with_subfield("causes"),
///     )
///     .build();
/// ```
#[derive(Debug)]
pub struct TreeBuilder {
    tree: TreeQueryParam,
}
impl TreeBuilder {
    /// Build a new empty `TreeBuilder`
    pub fn new() -> Self {
        TreeBuilder {
            tree: TreeQueryParam {
                keyname: None,
                subkeys: vec![],
            },
        }
    }
    /// Add a field to the `TreeQueryParam`
    pub fn with_field<T: Into<TreeQueryParam>>(mut self, subfield: T) -> Self {
        self.tree.subkeys.push(subfield.into());
        self
    }
    /// Create a parent `TreeQueryParam`
    pub fn object(name: &str) -> Self {
        TreeBuilder {
            tree: TreeQueryParam {
                keyname: Some(name.to_string()),
                subkeys: vec![],
            },
        }
    }
    /// Add a subfield to the `TreeQueryParam`
    pub fn with_subfield<T: Into<TreeQueryParam>>(self, subfield: T) -> Self {
        self.with_field(subfield)
    }
    /// Build the `TreeQueryParam`
    pub fn build(self) -> TreeQueryParam {
        self.tree
    }
}
impl Into<TreeQueryParam> for TreeBuilder {
    fn into(self) -> TreeQueryParam {
        self.build()
    }
}
impl<'a> Into<TreeQueryParam> for &'a str {
    fn into(self) -> TreeQueryParam {
        TreeQueryParam {
            keyname: Some(self.to_string()),
            subkeys: vec![],
        }
    }
}
impl Into<Option<super::AdvancedQuery>> for TreeQueryParam {
    fn into(self) -> Option<super::AdvancedQuery> {
        Some(super::AdvancedQuery::Tree(self))
    }
}
impl Default for TreeBuilder {
    fn default() -> Self {
        Self::new()
    }
}