autoschematic-core 0.8.2

Core shared functionality for Autoschematic: workflow engine, state management, and Git integrations
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

use std::{path::Path, sync::Arc};

use documented::{Documented, DocumentedFields};

use crate::{
    config::{AutoschematicConfig, Connector, Prefix},
    connector::{DocIdent, FilterResponse, GetDocResponse},
    connector_cache::ConnectorCache,
    error::AutoschematicError,
    keystore::KeyStore,
};

pub fn get_system_docstring(path: &Path, ident: DocIdent) -> Result<Option<GetDocResponse>, AutoschematicError> {
    let Some(path) = path.to_str() else {
        return Ok(None);
    };

    match path {
        "autoschematic.ron" => match ident {
            DocIdent::Struct { name } => match name.as_str() {
                "AutoschematicConfig" => Ok(Some(AutoschematicConfig::DOCS.into())),
                "Prefix" => Ok(Some(Prefix::DOCS.into())),
                "Connector" => Ok(Some(Connector::DOCS.into())),
                _ => Ok(None),
            },
            DocIdent::Field { parent, name } => match parent.as_str() {
                "AutoschematicConfig" => Ok(Some(AutoschematicConfig::get_field_docs(name)?.into())),
                "Prefix" => Ok(Some(Prefix::get_field_docs(name)?.into())),
                "Connector" => Ok(Some(Connector::get_field_docs(name)?.into())),
                _ => Ok(None),
            },
        },
        // "autoschematic.rbac.ron" => match ident {
        //     DocIdent::Struct { name } => todo!(),
        //     DocIdent::Field { parent, name } => todo!(),
        // },
        _ => Ok(None),
    }
}

// TODO This is trivially cacheable!
pub async fn get_docstring(
    autoschematic_config: &AutoschematicConfig,
    connector_cache: &ConnectorCache,
    keystore: Option<Arc<dyn KeyStore>>,
    prefix: &Path,
    addr: &Path,
    ident: DocIdent,
) -> Result<Option<GetDocResponse>, AutoschematicError> {
    let Some(prefix_str) = prefix.to_str() else {
        return Ok(None);
    };

    let Some(prefix_def) = autoschematic_config.prefixes.get(prefix_str) else {
        return Ok(None);
    };

    for connector_def in &prefix_def.connectors {
        let (connector, _inbox) = connector_cache
            .get_or_spawn_connector(
                &connector_def.shortname,
                &connector_def.spec,
                prefix,
                &connector_def.env,
                keystore.clone(),
                false,
            )
            .await?;

        if connector.filter(addr).await?.intersects(FilterResponse::none())
            && let Some(doc) = connector.get_docstring(addr, ident.clone()).await?
        {
            return Ok(Some(doc));
        }
    }

    Ok(None)
}