semvec/pypi-packages huggingface dataset:
auto-file-organizer 1.0.0
A smart Python script to automatically organize files by type, date, and more with undo and ignore support.
License: MIT
Requires Python: <4.0,>=3.8

# 🗂️ Auto File Organizer

A smart, customizable file organization tool for your local directories. Sort files by **type**, **date**, or **filename patterns**, with full support for **undo**, **exceptions**, and intelligent folder cleanup.

---

## 🚀 Features

- 📁 **Sort by Type, Date, or Pattern**
- 🔁 **Undo** any sorting operation with one command
- ⚠️ **Ignore** specific files or patterns using wildcards or regex
- 🧠 **Folder cleanup** based on smart rules (no accidental user folder deletions)
- 🔒 Prevents accidental file overwrites
- 🛠️ Clean CLI interface

---

## 🔧 Installation

```bash
git clone https://github.com/your-username/auto-file-organizer.git
cd auto-file-organizer
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt  # if you add any external deps
```