Struct InitService 

pub struct InitService;

Service for initializing new Mecha10 projects

Examples

use mecha10_cli::services::InitService;

let service = InitService::new();

// Create project structure
service.create_project_directories(&project_path).await?;

// Add example nodes
service.add_example_node(&project_path, "speaker").await?;

Implementations

impl InitService

pub fn new() -> InitService

Create a new InitService

pub async fn create_project_directories(&self, path: &Path) -> Result<(), Error>

Create project directory structure

Creates all the necessary directories for a new Mecha10 project:

• nodes/ - Custom node implementations
• drivers/ - Hardware driver implementations
• types/ - Shared type definitions
• configs/behaviors/ - Behavior tree definitions (LAB-2072: nested under configs/ so mecha10 config push syncs them)
• config/ - Configuration files
• logs/ - Runtime logs
• models/ - ML/AI models (ONNX, etc.) for remote nodes
• simulation/ - Simulation environments
• simulation/models/ - Robot physical models
• assets/ - Static assets for simulation and visualization
• assets/images/ - Image assets for simulation textures, UI, etc.

pub async fn add_example_node( &self, project_root: &Path, component_name: &str, ) -> Result<(), Error>

Add an example node from the catalog to the project

This method:

1. Searches the component catalog for the component
2. Generates component files from templates (if any)
3. Updates Cargo.toml (workspace members or dependencies)
4. Updates mecha10.json configuration

Arguments

• project_root - Root path of the project
• component_name - Name of the component to add (e.g., “speaker”, “listener”)

Trait Implementations

impl Default for InitService

fn default() -> InitService

Returns the “default value” for a type.