sluice-rs 0.1.2

Pure-Rust parser for the Maven Central binary index format.
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

use super::field::Field;

/// An index document: an ordered list of fields.
///
/// Order follows the on-wire layout. Documents average ~10 fields, so the
/// linear-scan `find` helper is fine.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize))]
pub struct Document {
    fields: Vec<Field>,
}

impl Document {
    /// Construct a `Document` from an ordered list of fields.
    #[must_use]
    pub fn new(fields: Vec<Field>) -> Self {
        Self { fields }
    }

    /// All fields in on-wire order.
    #[must_use]
    pub fn fields(&self) -> &[Field] {
        &self.fields
    }

    /// Return the value of the first field whose name equals `key`.
    #[must_use]
    pub fn find(&self, key: &str) -> Option<&str> {
        self.fields
            .iter()
            .find(|f| f.name == key)
            .map(|f| f.value.as_str())
    }

    /// Return `true` if any field's name equals `key`.
    #[must_use]
    pub fn has(&self, key: &str) -> bool {
        self.fields.iter().any(|f| f.name == key)
    }
}