📂 File Organizer Script

A simple yet powerful Python script to automatically organize files in a directory by moving them into subfolders based on their file extension.
This helps keep your folders — like Downloads, Documents, or Desktop — clean and tidy.

The project includes a full suite of unit tests to ensure the script's logic is reliable and bug-free.

---

✨ Features

• 🧠 Automatic Sorting: Sorts files into categories like Images, Documents, Videos, etc.
• ⚙️ Customizable: Easily add new file extensions or change folder names by editing the file_extentions_map dictionary.
• 🛡️ Safe: Skips directories and only moves files.
• 🪄 Intelligent: Creates destination folders if they don't already exist.
• 💡 Lightweight: Uses only Python’s standard libraries — no external packages needed.
• ✅ Well-Tested: Comes with unittest support to verify all functions work correctly.

---

🧰 Prerequisites

Make sure you have Python 3.x installed.

You can verify your Python version with:

python --version

🚀 How to Use

1. Save the main script file as organizer.py.
2. Open your terminal or command prompt.
3. Navigate to the folder containing organizer.py.
4. Run the script by passing the path of the folder you want to organize as a command-line argument.

Syntax:

python organizer.py /path/to/your/folder

Example:

To organize your Downloads folder:

bash Copy code python organizer.py "C:/Users/YourName/Downloads"

📁 Example — Before & After

Before:

Downloads/
├── vacation.jpg
├── quarterly-report.docx
├── project.zip
├── resume.pdf
├── funny-cat.mp4
└── install_notes.txt

After running the script:

Downloads/
├── Archives/
│   └── project.zip
├── Documents/
│   ├── quarterly-report.docx
│   ├── resume.pdf
│   └── install_notes.txt
├── Images/
│   └── vacation.jpg
└── Videos/
    └── funny-cat.mp4

🛠️ Customization

The logic for sorting files is handled by the file_extentions_map dictionary inside organizer.py. You can modify it to add or change categories easily.

Example:

file_extentions_map = {
    "Images": [".jpg", ".jpeg", ".png", ".gif", ".bmp", ".tiff", ".svg", ".webp"],
    "Documents": [".pdf", ".docx", ".txt", ".pptx", ".xlsx"],
    "Videos": [".mp4", ".mkv", ".mov", ".avi"],
    "Archives": [".zip", ".rar", ".7z", ".tar"],
}

Add your own extensions or categories as needed — the script will automatically create those folders and sort files accordingly.

✅ Running the Tests A test suite is included to ensure the sorting logic works correctly. This is especially useful if you’ve customized the script.

Save the test file as test_organizer.py in the same directory as organizer.py.

Run the tests with:

python test_organizer.py

Expected output:

Ran 1 test in 0.001s 

OK If all tests pass — your organizer is working perfectly ✅

📦 Folder Structure

📂 File-Organizer/
├── organizer.py
├── test_organizer.py
└── README.md

💡 Tips

Run this script on folders like Downloads, Desktop, or Projects for instant cleanup. You can schedule it using Windows Task Scheduler or macOS Automator to run periodically. Works seamlessly across Windows, macOS, and Linux.