righvalor 0.1.0

RighValor: AI Infrastructure and Applications Framework for the Far Edge
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

use std::path::PathBuf;

use anyhow::{anyhow, Result};
use righ_dm_rs::RighVersion;
use serde::{Deserialize, Serialize};

use crate::{
    runtime::ValorRuntimeEngine,
    service::{ValorServiceEntity, ValorServiceId},
};

/// # Valor Righ Device Classification Service
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ValorRighDeviceClassificationService {
    runtime: ValorRuntimeEngine,
    version: RighVersion,
    metadata: Vec<u8>,
    model_path: Option<PathBuf>,
}

impl ValorRighDeviceClassificationService {
    /// Create a new builder for `ValorRighDeviceClassificationService`.
    #[must_use]
    pub fn builder() -> ValorRighDeviceClassificationServiceBuilder {
        ValorRighDeviceClassificationServiceBuilder::default()
    }
}

/// Builder for ValorRighDeviceClassificationService.
///
/// Required fields: id, name, runtime, version.
/// Optional fields: metadata (default empty), model_path (optional).
/// Constraint: at least one of `metadata` (non-empty) or `model_path` must be provided.
#[derive(Debug, Default, Clone)]
pub struct ValorRighDeviceClassificationServiceBuilder {
    runtime: Option<ValorRuntimeEngine>,
    version: Option<RighVersion>,
    metadata: Option<Vec<u8>>,
    model_path: Option<PathBuf>,
}

impl ValorRighDeviceClassificationServiceBuilder {
    /// Set the runtime engine (required).
    pub fn runtime(mut self, runtime: ValorRuntimeEngine) -> Self {
        self.runtime = Some(runtime);
        self
    }

    /// Set the version (required).
    pub fn version(mut self, version: RighVersion) -> Self {
        self.version = Some(version);
        self
    }

    /// Set the metadata (optional, default empty).
    pub fn metadata<M: Into<Vec<u8>>>(mut self, metadata: M) -> Self {
        self.metadata = Some(metadata.into());
        self
    }

    /// Set the model path (optional).
    pub fn model_path<P: Into<PathBuf>>(mut self, model_path: P) -> Self {
        self.model_path = Some(model_path.into());
        self
    }

    /// Build the service, validating required fields and constraints.
    pub fn build(self) -> Result<ValorRighDeviceClassificationService> {
        let runtime = self.runtime.ok_or_else(|| anyhow!("runtime is required"))?;
        let version = self.version.ok_or_else(|| anyhow!("version is required"))?;
        let metadata = self.metadata.unwrap_or_default();
        let model_path: Option<PathBuf> = self.model_path;

        // At least one must be present: non-empty metadata or model_path
        // ensure!(
        //     !metadata.is_empty() || model_path.is_some(),
        //     "either non-empty metadata or model_path must be provided",
        // );

        Ok(ValorRighDeviceClassificationService {
            runtime,
            version,
            metadata,
            model_path,
        })
    }
}

impl ValorServiceEntity for ValorRighDeviceClassificationService {
    fn service_id(&self) -> ValorServiceId {
        ValorServiceId::righ_device_classification()
    }

    fn runtime(&self) -> ValorRuntimeEngine {
        self.runtime.clone()
    }

    fn version(&self) -> RighVersion {
        self.version.clone()
    }

    fn metadata(&self) -> Option<&[u8]> {
        Some(&self.metadata)
    }

    fn model_path(&self) -> Option<&PathBuf> {
        self.model_path.as_ref()
    }
}