Welcome to the Intelligent Data Organizer, where chaotic file systems transform into organized digital realms faster than you can say "where did I put that file?"
This Python application is a sophisticated, open-source toolkit designed to scan directories, categorize files, analyze relationships, and create organization plans that would make even the most meticulous librarian nod in approval. It's perfect for those looking to tame the wild beast that is their digital clutter and emerge with a zen-like file system.
This project brings together a fellowship of powerful components:
- FileScanner: The Directory Explorer, powered by Python's pathlib
- FileCategorizer: The Sorting Hat, empowered by mimetypes
- IntelligentOrganizer: The Master Planner, orchestrating the grand reorganization
- ActionEngine: The Task Executor, bringing plans to life with shutil
- ReportGenerator: The Chronicler, documenting the journey of your files using csv
Additional enchanted tools in our spellbook:
- argparse: The Command Interpreter, for parsing magical incantations (command-line arguments)
- unittest: The Test Wizard, ensuring our spells work as intended
- os: The System Whisperer, for low-level operating system sorcery
- collections: The Data Structurer, particularly the mighty
defaultdict
- File Detection Sorcery: Recursively scan and identify files in any directory 🕵️♂️
- Categorization Magic: Sort files into categories based on type and content 🎩
- Relationship Divination: Uncover hidden connections between your files 🔮
- Organization Enchantments: Create intelligent plans to restructure your digital realm 📊
- Action Spells: Execute reorganization with precision (or preview with a dry run) 🎭
- Report Conjuring: Generate comprehensive summaries of the organizing process 📜
To set up your own Intelligent Data Organizer sanctuary:
- Clone this arcane repository:
git clone https://github.com/OtenMoten/data-chaos-wizard.git - Enter the sacred circle:
cd data-chaos-wizard - Summon the required artifacts:
pip install -r requirements.txt
1.) Setup the data organization ritual:
python src/setup.py2.) Summon the data organization ritual:
python src/main.py /path/to/your/chaotic/directoryOptional: Perform a dry run and preview the magic without altering your realm:
python src/main.py /path/to/your/chaotic/directory --dry-runThis will analyze your files, generate an organization plan, and create a comprehensive report of the proposed changes.
To ensure your Intelligent Data Organizer is operating at peak magical efficiency:
python scripts/run_tests.py
This will execute a series of rigorous trials, testing each component of the organizer.
This project is licensed under the GPL3.0 License - see the LICENSE file for details.
- Kevin Ossenbrück - Lead Developer at Team Bitfuture - ossenbrück.de
- Website: team-bitfuture.de
- Email: info@team-bitfuture.de
May your files always be findable, and your directories always be tidy! 📂✨