collective 0.7.0

A CLI to automate work around Polkadot collective work reports.
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

// SPDX-License-Identifier: GPL-3.0-only
// SPDX-FileCopyrightText: Oliver Tale-Yazdi <oliver@tasty.limo>

use crate::{prompt::Prompt, types::prelude::*};
use core::fmt::Debug;
use derivative::Derivative;
use serde::{Deserialize, Serialize};
use std::borrow::Cow;

/// Info about an existing or aspiring member of a collective.
// TODO split into member and ranked-member
#[derive(Serialize, Deserialize, Derivative, schemars::JsonSchema)]
#[derivative(Debug(bound = "C::Rank: Debug"))]
#[derivative(Clone(bound = "C::Rank: Clone"))]
#[schemars(bound = "", rename = "Member")]
pub struct GenericMember<C: CollectiveTrait> {
	/// Legal name or pseudonym of the member.
	pub name: String,
	/// On-chain address of the member.
	///
	/// Can be a Substrate, Polkadot or Collectives Address.
	pub address: String,
	/// Email address of the member.
	pub email: String,
	/// GitHub handle of the member.
	pub github: String,
	/// Matrix chat handle.
	pub matrix: String,
	/// Current rank of the member.
	pub rank: C::Rank,
}

impl<C: CollectiveTrait> MemberTrait for GenericMember<C> {
	fn matrix(&self) -> &str {
		&self.matrix
	}

	fn email(&self) -> &str {
		&self.email
	}

	fn github(&self) -> &str {
		&self.github
	}

	fn address(&self) -> &str {
		&self.address
	}

	fn rank(&self) -> &dyn RankBaseTrait {
		&self.rank
	}
}

impl<C: CollectiveTrait> Named for GenericMember<C> {
	fn name(&self) -> Cow<'static, str> {
		self.name.clone().into()
	}
}

impl<C: CollectiveTrait> Query for GenericMember<C> {
	fn query(title: Option<&str>, _key: Option<&str>, prompt: &mut Prompt) -> anyhow::Result<Self> {
		let name = prompt.query_cached_text::<String>(
			"reporter_legal_name",
			"legal name or pseudonym",
			None,
		)?;

		let address = prompt.query_cached_text::<String>(
			"reporter_address",
			"your Polkadot address",
			None,
		)?;

		let email =
			prompt.query_cached_text::<String>("reporter_email", "your email address", None)?;

		let github = prompt
			.query_cached_text::<String>("reporter_github", "your GitHub handle", None)?
			.replace('@', " ");

		let matrix = prompt.query_cached_text::<String>(
			"reporter_matrix",
			"your Matrix chat handle",
			None,
		)?;

		let rank_title =
			if let Some(title) = title { format!("Rank {title}") } else { "Rank".into() };
		let rank = C::Rank::query(Some(&rank_title), None, prompt)?;

		Ok(Self { name, address, email, github, matrix, rank })
	}
}