bd-fileorganizer 0.0.1

Organize files in folders by type

🗂️ bd_fileorganizer

bd_fileorganizer is a simple yet powerful Python utility that helps you clean up cluttered folders by automatically moving files into categorized subfolders like images/, documents/, archives/, and more — all based on file extensions.

It’s perfect for tidying up your Downloads, Desktop, or project folders with just one command.

---

📦 Features

• 📁 Automatically sorts files into categories
• 🧠 Smart extension detection (.jpg → images, .pdf → documents, etc.)
• 🧪 Dry-run mode to preview changes
• 🐍 Easy-to-use Python API and CLI interface
• ✅ Beginner-friendly code and customizable

---

🚀 Installation

Install from source:

git clone https://github.com/your-username/fileorganizer.git
cd fileorganizer
pip install -e .

📌 Coming soon to PyPI!

---

🖥️ CLI Usage

fileorganizer /path/to/folder

Dry-run (preview only):

fileorganizer /path/to/folder --dry

---

🐍 Python API

from fileorganizer import organize_folder

organize_folder("/Users/you/Downloads", dry_run=False)

---

🧪 Running Tests

pytest

---

🗃️ Folder Structure Example

Before:

Downloads/
├── photo.jpg
├── report.pdf
├── backup.zip

After:

Downloads/
├── images/
│   └── photo.jpg
├── documents/
│   └── report.pdf
├── archives/
│   └── backup.zip

---

🔧 Extension Mapping

Category	Extensions
images/	.jpg, .jpeg, .png, .gif
documents/	.pdf, .docx, .txt
archives/	.zip, .tar, .gz, .rar
videos/	.mp4, .mov, .mkv
audio/	.mp3, .wav
others/	Everything else

---

📄 License

Licensed under the MIT License

---

🤝 Contributing

Contributions, feature ideas, and bug reports are welcome! Feel free to open an issue or a pull request.

---

👤 Author

Your Name GitHub: @your-username

---

🧹 Make your folders smarter, not messier — with fileorganizer 🗂️