delphi-clean

Overview

delphi-clean is a PowerShell utility designed for Delphi developers to help remove build artifacts, intermediate files, and IDE-generated clutter.

---

Example Workflow

# Preview cleanup
pwsh -File .\delphi-clean.ps1 -WhatIf

# Perform cleanup
pwsh -File .\delphi-clean.ps1

# CI usage
pwsh -File .\delphi-clean.ps1 -Level full -Json

Features

• Three cleanup levels: lite, build, full
• CI-friendly output with optional JSON mode
• Optional structured output via -PassThru
• Supports the -WhatIf dry-run mode

---

PowerShell Compatibility

Runs on the widely available Windows PowerShell 5.1 (powershell.exe) and the newer PowerShell 7+ (pwsh).

---

Usage

Run the script from its directory, or provide a path explicitly.

Basic Usage

pwsh -File .\delphi-clean.ps1

Defaults to:

• Level: lite
• Root: parent directory of the script

---

Specify Level

pwsh -File .\delphi-clean.ps1 -Level lite
pwsh -File .\delphi-clean.ps1 -Level build
pwsh -File .\delphi-clean.ps1 -Level full

---

Specify Root Path

pwsh -File .\delphi-clean.ps1 -RootPath C:\code\my-project

---

Dry Run (Recommended First)

pwsh -File .\delphi-clean.ps1 -WhatIf

Shows what would be deleted without making changes.

---

Verbose Output

pwsh -File .\delphi-clean.ps1 -Verbose

---

PassThru (Structured Output)

pwsh -File .\delphi-clean.ps1 -PassThru

Returns objects describing each item processed.

---

JSON Output (CI-friendly)

pwsh -File .\delphi-clean.ps1 -Json

Outputs a JSON summary including:

• Files found
• Directories found
• Files deleted
• Directories deleted
• Item-level details

---

Exclude Directories

pwsh -File .\delphi-clean.ps1 -ExcludeDirectories .git,.vs,.idea

---

Clean Levels

• see: /docs/cleanup-levels.md for breakdown of each level

lite (default)

Safe cleanup of common transient files.

Includes:

• .dcu, .tmp, .bak, .identcache
• __history

---

build

Removes build outputs and generated artifacts.

Includes everything in lite, plus:

• Compiled binaries (.exe, .dll, .bpl, etc.)
• Debug and release folders
• Intermediate files

---

full

More aggressive cleanup

Includes everything in build, plus:

• Backup files (*.~*)
• FinalBuilder related files (logs, breakpoint, lock)
• TestInsight custom settings

---

Maturity

This repository is currently incubator and is under active development. It will graduate to stable once:

• At least one downstream consumer exists.

Until graduation, breaking changes may occur

Continuous-Delphi

This tool is part of the Continuous-Delphi ecosystem, focused on improving engineering discipline for long-lived Delphi systems.