cu29-derive 1.3.1

This is the copper project runtime generator. It cannot be used independently from the copper project.
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

//! Clock-reference wiring resolved against the compiled resource graph.

use super::*;

fn reference_factory(
    config: &CuConfig,
    mission: &str,
    sim_mode: bool,
) -> CuResult<proc_macro2::TokenStream> {
    let clock = config
        .runtime
        .as_ref()
        .and_then(|runtime| runtime.clock_sync_config());
    if sim_mode {
        return Ok(quote! { Ok(None) });
    }
    let Some(clock) = clock else {
        return Ok(quote! {
            if config.runtime.as_ref().and_then(|runtime| runtime.clock_sync_config()).is_some() {
                return Err(CuError::from("Clock parent differs from compiled configuration"));
            }
            Ok(None)
        });
    };
    let (bundle, slot) = parse_resource_path(&clock.parent)?;
    let bundles = build_bundle_specs(config, mission)?;
    let index = bundles
        .iter()
        .position(|spec| spec.id == bundle)
        .ok_or_else(|| {
            CuError::from(format!(
                "Clock parent bundle '{bundle}' is unavailable in mission '{mission}'"
            ))
        })?;
    let provider = &bundles[index].provider_path;
    let parent = &clock.parent;
    Ok(quote! {
        let cfg = config.runtime.as_ref().and_then(|runtime| runtime.clock_sync_config())
            .ok_or(CuError::from("Compiled clock parent is missing"))?;
        if cfg.parent != #parent { return Err(CuError::from("Clock parent differs from compiled configuration")); }
        cfg.validate()?;
        const KEY: cu29::resource::ResourceKey<()> = cu29::resource::ResourceKey::<()>::new(
            cu29::resource::BundleIndex::new(#index),
            cu29::resource::resource_index_by_name::<#provider>(#slot),
        );
        let key = KEY.typed::<<#provider as cu29::clock_sync::ClockReferenceBundle>::Reference>();
        let reference = resources.take(key)?.0;
        Ok(Some((Box::new(reference), cfg.maintenance())))
    })
}

pub(super) fn factory(
    config: &CuConfig,
    mission: &str,
    sim_mode: bool,
) -> CuResult<proc_macro2::TokenStream> {
    let body = reference_factory(config, mission, sim_mode)?;
    Ok(quote! {
        #[doc(hidden)]
        pub fn clock_reference_instanciator(
            config: &CuConfig, resources: &mut ResourceManager,
        ) -> CuResult<Option<(Box<dyn cu29::clock_sync::ClockReference>, cu29::clock_sync::MaintenanceConfig)>> {
            let _ = (&config, &resources);
            #body
        }
    })
}