Struct ProjectTemplateService 

pub struct ProjectTemplateService { /* private fields */ }

Service for generating project template files

Examples

use mecha10_cli::services::ProjectTemplateService;

let service = ProjectTemplateService::new();

// Generate all project files
service.create_readme(&project_path, "my-robot").await?;
service.create_cargo_toml(&project_path, "my-robot").await?;

Implementations

impl ProjectTemplateService

pub fn new() -> ProjectTemplateService

Create a new ProjectTemplateService

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

Create README.md for the project

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

Create .gitignore for the project

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

Create Cargo.toml for the project

Arguments

• path - Project root path
• project_name - Name of the project

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

Create src/main.rs for the project

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

Create build.rs for the project

This build script generates:

1. node_registry.rs - Node dispatcher based on mecha10.json

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

Create .env.example for the project

Arguments

• path - Project root path
• project_name - Name of the project

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

Create rustfmt.toml for the project

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

Create docker-compose.yml for the project

Generates a Docker Compose file with Redis and optional PostgreSQL services for local development and deployment.

Arguments

• path - Project root path
• project_name - Name of the project (used for container naming)

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

Create remote node Docker files

Creates docker-compose.remote.yml and Dockerfile.remote for running AI/ML nodes in containers. These are used when nodes are configured in targets.remote in mecha10.json.

Arguments

• path - Project root path

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

Create package.json for npm dependencies

Includes @mecha10/simulation-models and @mecha10/simulation-environments dependencies, resolved via node_modules/@mecha10/* (requires npm install).

Arguments

• path - Project root path
• project_name - Name of the project

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

Create requirements.txt for Python dependencies

Includes Python packages needed for AI nodes (onnx, onnxruntime). Install with: mecha10 setup or pip install -r requirements.txt

Arguments

• path - Project root path

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

Create the standard RL training bundle (LAB-1743, Kestra flows added in LAB-1765) for a rover template project

Bundles the Phase 2 rover env / ppo algorithm (packages/rl-trainer, packages/rl-task-runner, registered via the mecha10_rl.envs/mecha10_rl.algorithms entry-points registry, LAB-1732/1733) into three pieces:

• configs/rl/local.yml - the default sentinel-override config for the combination (LAB-1734’s rl_task_runner.local_config pattern).
• requirements.txt - appended with the two packages’ dependencies, since both already register their entry points in their own pyproject.toml (nothing else to declare).
• kestra/README.md and kestra/flows/ml-pipeline/*.yml - the real train/tune/ tune-then-train/train-from-tune/resume-run Kestra flows (LAB-1745), embedded and bundled by LAB-1765 so new projects get working flows out of the box.

Callers should invoke create_requirements_txt first — this appends to that file rather than creating it.

Arguments

• path - Project root path

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

Create simulation/models/model.json

Generates the rover robot physical model configuration from embedded template.

Arguments

• path - Project root directory

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

Create simulation/environments/basic_arena/environment.json

Generates the basic arena environment configuration from embedded template.

Arguments

• path - Project root directory

Trait Implementations

impl Default for ProjectTemplateService

fn default() -> ProjectTemplateService

Returns the “default value” for a type.