A CLI tool to organize files by their extensions into categorized folders.

• Automatically categorizes files based on their extensions
• Supports multiple file categories (images, documents, videos, etc.)
• Dry-run mode to preview changes before applying them
• Verbose output for detailed logging
• Error handling for permissions and file-in-use scenarios
• Progress display and summary reporting

cargo build --release

The binary will be available at target/release/file-organizer

Organize files in the current directory:

file-organizer

file-organizer --source /path/to/directory

file-organizer --source /path/to/source --output /path/to/output

Preview changes without moving files:

file-organizer --dry-run

Show detailed information about the organization process:

file-organizer --verbose

file-organizer --source ~/Downloads --output ~/Organized --dry-run --verbose

• -s, --source <PATH> - Source directory containing files to organize (default: current directory)
• -o, --output <PATH> - Output directory for organized files (default: source directory)
• -d, --dry-run - Preview changes without actually moving files
• -v, --verbose - Show verbose output
• -h, --help - Print help information
• -V, --version - Print version information

cargo test

cargo test --test integration_tests

• src/main.rs - CLI entry point and argument parsing
• src/categories.rs - File category definitions and mapping
• src/scanner.rs - Directory scanning logic
• src/organizer.rs - File organization and moving logic
• tests/integration_tests.rs - Integration tests

MIT