file-backup-organizer v1.0.0 -- Intelligent File Backup & Organizer

Core Functions

| Feature | Description | |---------|-------------| | Recursive Scan | Scans source folder and all subdirectories | | Smart Categorization | Auto-classifies by extension (Word, Excel, PDF, Images, etc.) | | Flexible Filtering | Supports excluding specific file types (e.g. .tmp, .log, .cache) | | Duplicate Handling | Auto-appends sequential numbers to avoid overwriting | | Detailed Reports | Generates backup inventory and deletion lists | | Risk Warnings | Flags files that may break without directory structure |

How to Use

The main script is scripts/backup_files.py. It provides Python functions:

from scripts.backup_files import backup_files, organize_by_type

backup_files(source_path, exclude_extensions=None)

• source_path: Source folder path (e.g. "D:\Projects")
• exclude_extensions: List of extensions to exclude (e.g. [".tmp", ".log"])
• Returns: dict with success status, file counts, categories, backup directory

organize_by_type(source_path)

• source_path: Source folder path
• Returns: same as backup_files (without exclusion)

Execution

Run via Python:

python scripts/backup_files.py

Or import and call functions directly in your workflow.

Supported File Types

| Category | Extensions | |----------|-----------| | Word | .doc, .docx, .docm, .odt, .rtf | | Excel | .xls, .xlsx, .xlsm, .csv, .ods | | PDF | .pdf | | PPT | .ppt, .pptx, .pptm, .ppsx | | Images | .jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .psd | | Videos | .mp4, .avi, .mkv, .mov | | Audio | .mp3, .wav, .flac | | Archives | .zip, .rar, .7z | | Code | .py, .js, .html, .css, .java, .cpp, .php, .json, .xml | | Text | .txt, .md, .log |

Output

Backup creates a folder named {source}_backup with:

• Subfolders per file type
• backup_report.txt -- full inventory with file counts and names
• exclusion_list.txt -- list of excluded files (only if exclude_extensions used)

Warnings

These file types may break without original directory structure:

• Web files: .html, .htm, .css, .js
• Server scripts: .php, .asp, .aspx, .jsp
• Config files: .json, .xml, .yaml, .ini

Such files are flagged in the backup report.

Dependencies

None -- uses Python standard library only (os, shutil, pathlib, collections, datetime).