Struct ConfigService 

pub struct ConfigService;

Implementations

impl ConfigService

pub async fn load_from(path: &Path) -> Result<ProjectConfig, Error>

Load project configuration from a specific path

Arguments

• path - Path to the mecha10.json file

Errors

Returns an error if:

• The file doesn’t exist
• The file cannot be read
• The JSON is invalid
• The configuration doesn’t match the expected schema

pub fn find_config() -> Result<PathBuf, Error>

Find mecha10.json in the current directory or any parent directory

Searches upward from the current working directory until it finds a mecha10.json file or reaches the root directory.

Returns

Returns the path to the found configuration file.

Errors

Returns an error if no mecha10.json file is found in the current directory or any parent directory.

pub fn find_config_from(start_dir: &Path) -> Result<PathBuf, Error>

Find mecha10.json starting from a specific directory

Arguments

• start_dir - Directory to start searching from

Returns

Returns the path to the found configuration file.

Errors

Returns an error if no mecha10.json file is found.

pub fn is_initialized(dir: &Path) -> bool

Check if a project is initialized in the given directory

Arguments

• dir - Directory to check

Returns

Returns true if mecha10.json exists in the directory.

pub fn is_initialized_here() -> bool

Check if a project is initialized in the current directory

pub async fn load_robot_id(path: &Path) -> Result<String, Error>

Load robot ID from configuration file

This is a convenience method that loads just the robot ID without parsing the entire configuration.

Arguments

• path - Path to the mecha10.json file

Errors

Returns an error if the file cannot be read or parsed.

pub fn validate(path: &Path) -> Result<(), Error>

Validate configuration file

Uses the mecha10-core schema validation to check if the configuration is valid according to the JSON schema and custom validation rules.

Arguments

• path - Path to the configuration file

Errors

Returns an error if validation fails with details about what’s wrong.

pub fn resolve_and_validate(path: Option<&Path>) -> Result<PathBuf, Error>

Resolve the config file to validate and validate it – the single implementation shared by mecha10 config validate and the config-validation step in mecha10 lint, so neither re-implements this logic locally.

• path is None (the default): finds the project’s mecha10.json via Self::find_config and validates it plus every node config it references (via mecha10_core::schema_validation::validate_project_config).
• path is Some: validates exactly that one file, auto-detecting whether it’s a project config or a node config (via mecha10_core::schema_validation::validate_config_file) – no recursion into other files. This is the mode a git hook uses to check only the files staged in a commit.

Every referenced node config, built-in or custom, resolves its declared schema via a <name>.schema.json file shipped alongside it (LAB-4388/LAB-4390) – a node with no declared schema hard-errors naming it (LAB-4066; there is no generic envelope to fall back to).

Returns

The path that was validated, so callers can report it.

Errors

Returns an error with the underlying schema-validation failure details if the target file doesn’t exist or fails validation.