Struct CreateSchemaCommandHandler 

pub struct CreateSchemaCommandHandler;

Handler for creating JSON Schema from configuration types

This handler orchestrates schema generation and output handling, supporting both stdout and file output.

Architecture

• No Step layer needed (single operation)
• Delegates schema generation to SchemaGenerator (Infrastructure)
• Handles output routing (stdout vs file)

Examples

use torrust_tracker_deployer_lib::application::command_handlers::create::schema::CreateSchemaCommandHandler;
use std::path::PathBuf;
use tempfile::TempDir;

// Generate to stdout
let schema = CreateSchemaCommandHandler::execute(None)?;
println!("{}", schema);

// Generate to file (use temp directory to avoid leaving artifacts)
let temp_dir = TempDir::new()?;
let schema_path = temp_dir.path().join("schema.json");
CreateSchemaCommandHandler::execute(Some(schema_path))?;

Implementations

impl CreateSchemaCommandHandler

pub fn execute( output_path: Option<PathBuf>, ) -> Result<String, CreateSchemaCommandHandlerError>

Executes the create schema command

Generates JSON Schema for EnvironmentCreationConfig and either writes it to a file or returns it as a string.

Arguments

• output_path - Optional path to write schema file. If None, returns schema as string.

Returns

• Ok(String) - The generated schema (for stdout output or testing)
• Err(CreateSchemaCommandHandlerError) - If generation or file writing fails

Output Behavior

• No path: Returns schema string (caller handles stdout)
• With path: Writes to file and returns the schema string

Examples

use torrust_tracker_deployer_lib::application::command_handlers::create::schema::CreateSchemaCommandHandler;
use std::path::PathBuf;
use tempfile::TempDir;

// Output to stdout (caller prints the returned string)
let schema = CreateSchemaCommandHandler::execute(None)?;
println!("{}", schema);

// Output to file (use temp directory to avoid leaving artifacts)
let temp_dir = TempDir::new()?;
let schema_path = temp_dir.path().join("schema.json");
let schema = CreateSchemaCommandHandler::execute(Some(schema_path))?;
// File is written, schema string also returned for confirmation

Errors

Returns error if:

• Schema generation fails (infrastructure error)
• Parent directory creation fails (when writing to file)
• File write fails (when writing to file)