cloacina 0.4.0

A Rust library for resilient task execution and orchestration.
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

/*
 *  Copyright 2025-2026 Colliery Software
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

//! Symbol validation for dynamic libraries.

use libloading::Library;
use std::path::Path;

use super::types::ValidationResult;
use super::PackageValidator;

impl PackageValidator {
    /// Validate required symbols are present.
    pub(super) async fn validate_symbols(
        &self,
        package_path: &Path,
        result: &mut ValidationResult,
    ) {
        match unsafe { Library::new(package_path) } {
            Ok(lib) => {
                for symbol in &self.required_symbols {
                    match unsafe { lib.get::<unsafe extern "C" fn()>(symbol.as_bytes()) } {
                        Ok(_) => {
                            result.compatibility.required_symbols.push(symbol.clone());
                        }
                        Err(_) => {
                            result.compatibility.missing_symbols.push(symbol.clone());
                            result
                                .errors
                                .push(format!("Required symbol '{}' not found", symbol));
                        }
                    }
                }

                // Check for common optional symbols
                let optional_symbols = [
                    "cloacina_get_version",
                    "cloacina_get_author",
                    "cloacina_get_description",
                ];

                for symbol in &optional_symbols {
                    if unsafe { lib.get::<unsafe extern "C" fn()>(symbol.as_bytes()).is_ok() } {
                        result
                            .compatibility
                            .required_symbols
                            .push(symbol.to_string());
                    }
                }
            }
            Err(e) => {
                result
                    .errors
                    .push(format!("Cannot load library for symbol validation: {}", e));
            }
        }
    }
}