ploys 0.6.0

A utility to manage projects, packages, releases and deployments.
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use either::Either;
use toml_edit::{Array, Item, TableLike, Value};

use crate::repository::RepoSpec;

/// The project table.
pub struct Project<'a>(&'a dyn TableLike);

impl<'a> Project<'a> {
    /// Gets the project name.
    pub fn name(&self) -> &'a str {
        self.0.get("name").and_then(Item::as_str).expect("name")
    }

    /// Gets the project description.
    pub fn description(&self) -> Option<&'a str> {
        self.0.get("description").and_then(Item::as_str)
    }

    /// Gets the project repository.
    pub fn repository(&self) -> Option<RepoSpec> {
        self.0.get("repository")?.as_str()?.parse().ok()
    }

    /// Gets the project authors.
    pub fn authors(&self) -> impl Iterator<Item = &'a str> + use<'a> {
        match self.0.get("authors") {
            Some(item) => match item.as_array() {
                Some(arr) => Either::Right(arr.iter().filter_map(|value| value.as_str())),
                None => Either::Left(std::iter::empty()),
            },
            None => Either::Left(std::iter::empty()),
        }
    }
}

impl<'a> Project<'a> {
    /// Constructs the project section from a table.
    pub(super) fn from_table(table: &'a dyn TableLike) -> Option<Self> {
        table.get("name").and_then(Item::as_str)?;

        Some(Self(table))
    }
}

/// The mutable project table.
pub struct ProjectMut<'a>(&'a mut dyn TableLike);

impl ProjectMut<'_> {
    /// Gets the project name.
    pub fn name(&self) -> &str {
        self.0.get("name").and_then(Item::as_str).expect("name")
    }

    /// Sets the project name.
    pub fn set_name(&mut self, name: impl Into<String>) -> &mut Self {
        let item = self.0.entry("name").or_insert_with(Item::default);

        *item = Item::Value(Value::from(name.into()));

        self
    }

    /// Gets the project description.
    pub fn description(&self) -> Option<&str> {
        self.0.get("description").and_then(Item::as_str)
    }

    /// Sets the project description.
    pub fn set_description(&mut self, description: impl Into<String>) -> &mut Self {
        let item = self.0.entry("description").or_insert_with(Item::default);

        *item = Item::Value(Value::from(description.into()));

        self
    }

    /// Gets the project repository.
    pub fn repository(&self) -> Option<RepoSpec> {
        self.0.get("repository")?.as_str()?.parse().ok()
    }

    /// Sets the project repository.
    pub fn set_repository(&mut self, repo: impl Into<RepoSpec>) -> &mut Self {
        let item = self.0.entry("repository").or_insert_with(Item::default);

        *item = Item::Value(Value::from(repo.into().to_string()));

        self
    }

    /// Gets the project authors.
    pub fn authors(&self) -> impl Iterator<Item = &str> {
        match self.0.get("authors") {
            Some(item) => match item.as_array() {
                Some(arr) => Either::Right(arr.iter().filter_map(|value| value.as_str())),
                None => Either::Left(std::iter::empty()),
            },
            None => Either::Left(std::iter::empty()),
        }
    }

    /// Sets the project authors.
    pub fn set_authors(&mut self, authors: impl IntoIterator<Item = String>) -> &mut Self {
        let item = self.0.entry("authors").or_insert_with(Item::default);

        *item = Item::Value(Value::Array(Array::from_iter(authors)));

        self
    }
}

impl<'a> ProjectMut<'a> {
    /// Constructs the mutable project section from a mutable table.
    pub(super) fn from_table(table: &'a mut dyn TableLike) -> Option<Self> {
        table.get("name").and_then(Item::as_str)?;

        Some(Self(table))
    }
}