govctl 0.9.0

Project governance CLI for RFC, ADR, and Work Item management
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
121
122
123

use super::adapter::{DocAdapter, LoadedDoc, display_scope_for_dir};
use crate::config::Config;
use crate::diagnostic::{Diagnostic, DiagnosticCode, DiagnosticResult};
use crate::load::{find_clause_toml, find_rfc_toml};
use crate::model::{ClauseSpec, RfcSpec};
use crate::write::{WriteOp, read_clause, read_rfc, write_clause, write_rfc};
use std::path::{Path, PathBuf};

fn load_doc_with<T, F, R>(
    config: &Config,
    id: &str,
    finder: F,
    scope_path: PathBuf,
    missing_code: DiagnosticCode,
    missing_label: &str,
    read: R,
) -> DiagnosticResult<LoadedDoc<T>>
where
    F: Fn(&Config, &str) -> Option<PathBuf>,
    R: Fn(&Config, &Path) -> DiagnosticResult<T>,
{
    let scope = display_scope_for_dir(config, scope_path);
    let path = finder(config, id).ok_or_else(|| {
        Diagnostic::new(
            missing_code,
            format!("{missing_label} not found: {id}"),
            &scope,
        )
    })?;
    let data = read(config, &path)?;
    Ok(LoadedDoc { path, data })
}

fn load_rfc_with<F>(config: &Config, id: &str, finder: F) -> DiagnosticResult<LoadedDoc<RfcSpec>>
where
    F: Fn(&Config, &str) -> Option<PathBuf>,
{
    load_doc_with(
        config,
        id,
        finder,
        config.rfc_dir(),
        DiagnosticCode::E0102RfcNotFound,
        "RFC",
        read_rfc,
    )
}

fn write_rfc_doc(config: &Config, doc: &LoadedDoc<RfcSpec>, op: WriteOp) -> DiagnosticResult<()> {
    write_rfc(
        &doc.path,
        &doc.data,
        op,
        Some(&config.display_path(&doc.path)),
    )
}

fn clause_scope_path(config: &Config, id: &str) -> PathBuf {
    id.split(':')
        .next()
        .map(|rfc_id| config.clause_dir(rfc_id))
        .unwrap_or_else(|| config.rfc_dir())
}

fn load_clause_with<F>(
    config: &Config,
    id: &str,
    finder: F,
) -> DiagnosticResult<LoadedDoc<ClauseSpec>>
where
    F: Fn(&Config, &str) -> Option<PathBuf>,
{
    load_doc_with(
        config,
        id,
        finder,
        clause_scope_path(config, id),
        DiagnosticCode::E0202ClauseNotFound,
        "Clause",
        read_clause,
    )
}

fn write_clause_doc(
    config: &Config,
    doc: &LoadedDoc<ClauseSpec>,
    op: WriteOp,
) -> DiagnosticResult<()> {
    write_clause(
        &doc.path,
        &doc.data,
        op,
        Some(&config.display_path(&doc.path)),
    )
}

pub struct RfcTomlAdapter;

impl DocAdapter for RfcTomlAdapter {
    type Data = RfcSpec;

    fn load(config: &Config, id: &str) -> DiagnosticResult<LoadedDoc<Self::Data>> {
        load_rfc_with(config, id, find_rfc_toml)
    }

    fn write(config: &Config, doc: &LoadedDoc<Self::Data>, op: WriteOp) -> DiagnosticResult<()> {
        write_rfc_doc(config, doc, op)
    }
}

pub struct ClauseTomlAdapter;

impl DocAdapter for ClauseTomlAdapter {
    type Data = ClauseSpec;

    fn load(config: &Config, id: &str) -> DiagnosticResult<LoadedDoc<Self::Data>> {
        load_clause_with(config, id, find_clause_toml)
    }

    fn write(config: &Config, doc: &LoadedDoc<Self::Data>, op: WriteOp) -> DiagnosticResult<()> {
        write_clause_doc(config, doc, op)
    }
}