refactor: organize create command into handler and subcommands

Co-authored-by: josecelano <58816+josecelano@users.noreply.github.com>

Author: Copilot

src/presentation/commands/create/handler.rs

@@ -0,0 +1,43 @@
+//! Create Command Handler
+//!
+//! This module handles the create command execution at the presentation layer,
+//! routing between different subcommands (environment creation or template generation).
+
+use std::path::Path;
+
+use crate::presentation::cli::commands::CreateAction;
+
+use super::errors::CreateSubcommandError;
+use super::subcommands;
+
+/// Handle the create command with its subcommands
+///
+/// This function routes between different create subcommands (environment or template).
+///
+/// # Arguments
+///
+/// * `action` - The create action to perform (environment creation or template generation)
+/// * `working_dir` - Root directory for environment data storage
+///
+/// # Returns
+///
+/// Returns `Ok(())` on success, or a `CreateSubcommandError` on failure.
+///
+/// # Errors
+///
+/// Returns an error if the subcommand execution fails.
+#[allow(clippy::result_large_err)] // Error contains detailed context for user guidance
+pub fn handle_create_command(
+    action: CreateAction,
+    working_dir: &Path,
+) -> Result<(), CreateSubcommandError> {
+    match action {
+        CreateAction::Environment { env_file } => {
+            subcommands::handle_environment_creation(&env_file, working_dir)
+        }
+        CreateAction::Template { output_path } => {
+            let template_path = output_path.unwrap_or_else(CreateAction::default_template_path);
+            subcommands::handle_template_generation(&template_path)
+        }
+    }
+}

src/presentation/commands/create/mod.rs

@@ -15,7 +15,8 @@
 //!
 //! - `config_loader` - Figment integration for JSON configuration loading
 //! - `errors` - Presentation layer error types with `.help()` methods
-//! - `subcommand` - Main command handler orchestrating the workflow
+//! - `handler` - Main command handler routing between subcommands
+//! - `subcommands` - Individual subcommand implementations (environment, template)
 //!
 //! ## Usage Example
 //!
@@ -36,12 +37,13 @@
 
 pub mod config_loader;
 pub mod errors;
-pub mod subcommand;
+pub mod handler;
+pub mod subcommands;
 
 #[cfg(test)]
 mod tests;
 
 // Re-export commonly used types for convenience
 pub use config_loader::ConfigLoader;
 pub use errors::{ConfigFormat, CreateSubcommandError};
-pub use subcommand::handle_create_command;
+pub use handler::handle_create_command;

…esentation/commands/create/subcommand.rs …mmands/create/subcommands/environment.rssrc/presentation/commands/create/subcommand.rs renamed to src/presentation/commands/create/subcommands/environment.rs src/presentation/commands/create/subcommand.rs renamed to src/presentation/commands/create/subcommands/environment.rs

@@ -1,8 +1,7 @@
-//! Create Subcommand Handler
+//! Environment Creation Subcommand
 //!
-//! This module handles the create subcommand execution at the presentation layer,
-//! including configuration file loading, argument processing, user interaction,
-//! and command execution.
+//! This module handles the environment creation subcommand for creating
+//! deployment environments from configuration files.
 
 use std::path::Path;
 use std::sync::Arc;
@@ -11,99 +10,11 @@ use std::time::Duration;
 use crate::application::command_handlers::create::CreateCommandHandler;
 use crate::domain::config::EnvironmentCreationConfig;
 use crate::infrastructure::persistence::repository_factory::RepositoryFactory;
-use crate::presentation::cli::commands::CreateAction;
 use crate::presentation::user_output::{UserOutput, VerbosityLevel};
 use crate::shared::{Clock, SystemClock};
 
-use super::config_loader::ConfigLoader;
-use super::errors::CreateSubcommandError;
-
-/// Handle the create command with its subcommands
-///
-/// This function routes between different create subcommands (environment or template).
-///
-/// # Arguments
-///
-/// * `action` - The create action to perform (environment creation or template generation)
-/// * `working_dir` - Root directory for environment data storage
-///
-/// # Returns
-///
-/// Returns `Ok(())` on success, or a `CreateSubcommandError` on failure.
-///
-/// # Errors
-///
-/// Returns an error if the subcommand execution fails.
-#[allow(clippy::result_large_err)] // Error contains detailed context for user guidance
-pub fn handle_create_command(
-    action: CreateAction,
-    working_dir: &Path,
-) -> Result<(), CreateSubcommandError> {
-    match action {
-        CreateAction::Environment { env_file } => {
-            handle_environment_creation(&env_file, working_dir)
-        }
-        CreateAction::Template { output_path } => {
-            let template_path = output_path.unwrap_or_else(CreateAction::default_template_path);
-            handle_template_generation(&template_path)
-        }
-    }
-}
-
-/// Handle template generation
-///
-/// This function generates a configuration template file with placeholder values
-/// that users can edit to create their own environment configurations.
-///
-/// # Arguments
-///
-/// * `output_path` - Path where the template file should be created
-///
-/// # Returns
-///
-/// Returns `Ok(())` on success, or a `CreateSubcommandError` on failure.
-///
-/// # Errors
-///
-/// Returns an error if template file creation fails.
-#[allow(clippy::result_large_err)] // Error contains detailed context for user guidance
-fn handle_template_generation(output_path: &Path) -> Result<(), CreateSubcommandError> {
-    // Create user output for progress messages
-    let mut output = UserOutput::new(VerbosityLevel::Normal);
-
-    output.progress("Generating configuration template...");
-
-    // Call existing domain method - template generation implemented in PR #48
-    // This is async, so we need to use tokio runtime
-    tokio::runtime::Runtime::new()
-        .expect("Failed to create tokio runtime")
-        .block_on(async {
-            EnvironmentCreationConfig::generate_template_file(output_path)
-                .await
-                .map_err(CreateSubcommandError::TemplateGenerationFailed)
-        })?;
-
-    output.success(&format!(
-        "Configuration template generated: {}",
-        output_path.display()
-    ));
-    println!();
-    println!("Next steps:");
-    println!("1. Edit the template file and replace placeholder values:");
-    println!("   - REPLACE_WITH_ENVIRONMENT_NAME: Choose a unique environment name (e.g., 'dev', 'staging')");
-    println!("   - REPLACE_WITH_SSH_PRIVATE_KEY_PATH: Path to your SSH private key");
-    println!("   - REPLACE_WITH_SSH_PUBLIC_KEY_PATH: Path to your SSH public key");
-    println!("2. Review default values:");
-    println!("   - username: 'torrust' (can be changed if needed)");
-    println!("   - port: 22 (standard SSH port)");
-    println!("3. Create the environment:");
-    println!(
-        "   torrust-tracker-deployer create environment --env-file {}",
-        output_path.display()
-    );
-
-    Ok(())
-}
+use super::super::config_loader::ConfigLoader;
+use super::super::errors::CreateSubcommandError;
 
 /// Handle environment creation from configuration file
 ///
@@ -135,7 +46,7 @@ fn handle_template_generation(output_path: &Path) -> Result<(), CreateSubcommand
 /// loaded, parsed, validated, or if the create command execution fails.
 /// All errors include detailed context and actionable troubleshooting guidance.
 #[allow(clippy::result_large_err)] // Error contains detailed context for user guidance
-fn handle_environment_creation(
+pub fn handle_environment_creation(
     env_file: &Path,
     working_dir: &Path,
 ) -> Result<(), CreateSubcommandError> {
@@ -369,3 +280,4 @@ mod tests {
         );
     }
 }
+

src/presentation/commands/create/subcommands/mod.rs

@@ -0,0 +1,10 @@
+//! Create Subcommands Module
+//!
+//! This module contains the individual subcommands for the create command.
+
+pub mod environment;
+pub mod template;
+
+// Re-export subcommand handlers for convenience
+pub use environment::handle_environment_creation;
+pub use template::handle_template_generation;

src/presentation/commands/create/subcommands/template.rs

@@ -0,0 +1,66 @@
+//! Template Generation Subcommand
+//!
+//! This module handles the template generation subcommand for creating
+//! configuration file templates with placeholder values.
+
+use std::path::Path;
+
+use crate::domain::config::EnvironmentCreationConfig;
+use crate::presentation::user_output::{UserOutput, VerbosityLevel};
+
+use super::super::errors::CreateSubcommandError;
+
+/// Handle template generation
+///
+/// This function generates a configuration template file with placeholder values
+/// that users can edit to create their own environment configurations.
+///
+/// # Arguments
+///
+/// * `output_path` - Path where the template file should be created
+///
+/// # Returns
+///
+/// Returns `Ok(())` on success, or a `CreateSubcommandError` on failure.
+///
+/// # Errors
+///
+/// Returns an error if template file creation fails.
+#[allow(clippy::result_large_err)] // Error contains detailed context for user guidance
+pub fn handle_template_generation(output_path: &Path) -> Result<(), CreateSubcommandError> {
+    // Create user output for progress messages
+    let mut output = UserOutput::new(VerbosityLevel::Normal);
+
+    output.progress("Generating configuration template...");
+
+    // Call existing domain method - template generation implemented in PR #48
+    // This is async, so we need to use tokio runtime
+    tokio::runtime::Runtime::new()
+        .expect("Failed to create tokio runtime")
+        .block_on(async {
+            EnvironmentCreationConfig::generate_template_file(output_path)
+                .await
+                .map_err(CreateSubcommandError::TemplateGenerationFailed)
+        })?;
+
+    output.success(&format!(
+        "Configuration template generated: {}",
+        output_path.display()
+    ));
+    println!();
+    println!("Next steps:");
+    println!("1. Edit the template file and replace placeholder values:");
+    println!("   - REPLACE_WITH_ENVIRONMENT_NAME: Choose a unique environment name (e.g., 'dev', 'staging')");
+    println!("   - REPLACE_WITH_SSH_PRIVATE_KEY_PATH: Path to your SSH private key");
+    println!("   - REPLACE_WITH_SSH_PUBLIC_KEY_PATH: Path to your SSH public key");
+    println!("2. Review default values:");
+    println!("   - username: 'torrust' (can be changed if needed)");
+    println!("   - port: 22 (standard SSH port)");
+    println!("3. Create the environment:");
+    println!(
+        "   torrust-tracker-deployer create environment --env-file {}",
+        output_path.display()
+    );
+
+    Ok(())
+}