Module configure 

Configure Command Presentation Module

This module implements the CLI presentation layer for the configure command, handling argument processing and user interaction.

Architecture

The configure command presentation layer follows the DDD pattern, orchestrating the application layer’s ConfigureCommandHandler while providing user-friendly output and error handling.

Components

• errors - Presentation layer error types with .help() methods
• handler - Main command handler orchestrating the workflow

Usage Example

Basic Usage

use std::path::Path;
use std::sync::Arc;
use torrust_tracker_deployer_lib::bootstrap::Container;
use torrust_tracker_deployer_lib::presentation::cli::dispatch::ExecutionContext;
use torrust_tracker_deployer_lib::presentation::cli::controllers::configure;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let container = Container::new(VerbosityLevel::Normal, Path::new("."));
let context = ExecutionContext::new(Arc::new(container), global_args);

// Call the configure handler
let result = context
    .container()
    .create_configure_controller()
    .execute("my-environment");

Direct Usage (For Testing)

use std::path::Path;
use std::sync::Arc;
use torrust_tracker_deployer_lib::bootstrap::Container;
use torrust_tracker_deployer_lib::presentation::cli::dispatch::ExecutionContext;
use torrust_tracker_deployer_lib::presentation::cli::controllers::configure;
use torrust_tracker_deployer_lib::presentation::cli::views::VerbosityLevel;

let container = Container::new(VerbosityLevel::Normal, Path::new("."));
let context = ExecutionContext::new(Arc::new(container), global_args);

if let Err(e) = context
    .container()
    .create_configure_controller()
    .execute("test-env")
{
    eprintln!("Configure failed: {e}");
    eprintln!("\n{}", e.help());
}

Direct Usage (For Testing)

use std::path::{Path, PathBuf};
use std::sync::Arc;
use std::time::Duration;
use parking_lot::ReentrantMutex;
use std::cell::RefCell;
use torrust_tracker_deployer_lib::presentation::cli::controllers::configure::handler::ConfigureCommandController;
use torrust_tracker_deployer_lib::presentation::cli::views::{UserOutput, VerbosityLevel};
use torrust_tracker_deployer_lib::infrastructure::persistence::file_repository_factory::FileRepositoryFactory;
use torrust_tracker_deployer_lib::shared::clock::SystemClock;

let output = Arc::new(ReentrantMutex::new(RefCell::new(UserOutput::new(VerbosityLevel::Normal))));
let data_dir = PathBuf::from("./data");
let file_repository_factory = FileRepositoryFactory::new(Duration::from_secs(30));
let repository = file_repository_factory.create(data_dir);
let clock = Arc::new(SystemClock);
if let Err(e) = ConfigureCommandController::new(repository, clock, output).execute("test-env") {
    eprintln!("Configure failed: {e}");
    eprintln!("\n{}", e.help());
}

Re-exports

pub use handler::ConfigureCommandController;

pub use errors::ConfigureSubcommandError;

Modules

errors

Error types for the Configure Subcommand

handler

Configure Command Handler