Struct PurgeCommandHandler 

pub struct PurgeCommandHandler { /* private fields */ }

PurgeCommandHandler orchestrates the removal of all local environment data

This command handler removes all local files associated with an environment:

1. Removes the data/{env-name}/ directory (environment state, configs, etc.)
2. Removes the build/{env-name}/ directory (generated templates, artifacts)
3. Removes the environment entry from the repository

State Management

Unlike other commands, purge does not transition environment state:

• Works on environments in any state
• Removes all local data regardless of current state
• Does not persist state after purge (the environment data is removed)

Idempotency

The purge operation is idempotent. Running it multiple times on the same environment will:

• Succeed if the directories are already removed
• Not fail due to missing resources
• Report appropriate status to the user

Important Notes

• Does NOT destroy infrastructure: Only removes local files
• Irreversible operation: All local environment data is permanently deleted
• Works in any state: Can purge environments that are Created, Provisioned, Running, etc.

Implementations

impl PurgeCommandHandler

pub fn new( repository: Arc<dyn EnvironmentRepository + Send + Sync>, working_dir: PathBuf, ) -> Self

Create a new PurgeCommandHandler

Arguments

• repository - Repository for accessing environment data
• working_dir - Root directory containing data/ and build/ subdirectories

pub fn execute( &self, env_name: &EnvironmentName, ) -> Result<(), PurgeCommandHandlerError>

Execute the complete purge workflow

Arguments

• env_name - The name of the environment to purge

Errors

Returns an error if:

• Environment not found in repository
• Unable to remove data directory due to permissions or I/O errors
• Unable to remove build directory due to permissions or I/O errors
• Unable to remove environment from repository

If directories are already removed, the operation succeeds (idempotent).