mod.rs

//! 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
//!
//! ```ignore
//! 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)
//!
//! ```ignore
//! 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)
//!
//! ```ignore
//! 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;
//!
//! # #[tokio::main]
//! # async fn main() {
//! 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());
//! }
//! # }
//! ```

pub mod errors;
pub mod handler;
pub use handler::ConfigureCommandController;

#[cfg(test)]
mod tests;

// Re-export commonly used types for convenience
pub use errors::ConfigureSubcommandError;