Struct Monocore 

pub struct Monocore { /* private fields */ }

The monocore configuration.

Implementations

impl Monocore

pub fn merge(&self, other: &Monocore) -> MonocoreResult<Monocore>

Merges two Monocore configurations, producing a new configuration that combines both. This is used for updating running configurations while maintaining consistency.

The merge follows these rules:

• Services and groups from both configs are combined
• If a service exists in both configs, the newer version (from other) takes precedence
• If a group exists in both configs, the newer version takes precedence
• Validates that the merged configuration maintains consistency

pub fn get_changed_services<'a>( &'a self, other: &'a Monocore, ) -> Vec<&'a Service>

Gets a list of services that were either added or modified in the merged configuration compared to the original configuration.

A service is considered modified if either:

• The service itself has changed
• The group the service belongs to has changed

Returns

A vector of references to services that were either added or modified

impl Monocore

pub const MAX_DEPENDENCY_DEPTH: usize = 32usize

The maximum service dependency chain length.

pub fn builder() -> MonocoreBuilder

Creates a new builder for a Monocore configuration.

This builder provides a fluent interface for configuring and creating a Monocore configuration. The builder validates the configuration during build to ensure it is valid.

Examples

use monocore::config::Monocore;

let monocore = Monocore::builder()
    .services(vec![])
    .groups(vec![])
    .build()
    .unwrap();

pub fn default_num_vcpus() -> u8

Returns the default number of vCPUs.

pub fn default_ram_mib() -> u32

Returns the default amount of RAM in MiB.

pub fn get_group(&self, group_name: &str) -> Option<&Group>

Get a group by name in this configuration

pub fn get_groups(&self) -> &[Group]

Get all groups in this configuration

pub fn get_service(&self, service_name: &str) -> Option<&Service>

Get a service by name in this configuration

pub fn get_services(&self) -> &[Service]

Get all services in this configuration

pub fn remove_services(&mut self, names: &[String])

Removes specified services from the configuration in place. If service_names is None, removes all services. Groups are preserved unless all services are removed.

Arguments

• names - The set of service names to remove.

pub fn get_ordered_services(&self) -> Vec<&Service>

Gets all services ordered by their dependencies, such that dependencies come before dependents. This is useful for starting services in the correct order.

Returns

A vector of service references ordered by dependencies (dependencies first)

Note

This method assumes the configuration has already been validated (no circular dependencies). The validation is performed during configuration building.

pub fn get_group_for_service<'a>( &'a self, service_name: &str, ) -> MonocoreResult<Option<&'a Group>>

Gets the group for a service by name.

Arguments

• service_name - The name of the service to get the group for

Returns

• Ok(Some(group)) if the service exists and has a valid group configuration
• Ok(None) if the service exists but:
  • Has no group specified
  • References a non-existent group
• Err(_) if the service doesn’t exist

impl Monocore

pub fn validate(&self) -> MonocoreResult<()>

Performs comprehensive validation of the Monocore configuration. This includes checking for:

• Unique service and group names
• Valid group references
• Valid volume and environment references
• Service dependencies
• Service-specific configuration requirements
• Circular dependencies in the service graph
• Volume conflicts between groups
• Port conflicts within groups

pub fn check_circular_dependencies(&self) -> MonocoreResult<()>

Detects circular dependencies in the service dependency graph. A circular dependency occurs when services form a dependency cycle, which would prevent proper service startup ordering.

Trait Implementations

impl Clone for Monocore

fn clone(&self) -> Monocore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Monocore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Monocore

fn default() -> Monocore

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Monocore

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Monocore

fn eq(&self, other: &Monocore) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Monocore

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Monocore