🗂️ File Management Automation

A Python-powered CLI tool to automatically organize files inside any target folder.
Built with clean architecture principles for flexibility, scalability, and ease of maintenance.

Overview

This project automates file organization by scanning a specified folder and sorting files into subfolders based on file types.
It is designed for one-click execution — run it once to declutter, run it again anytime to maintain order.

Requirements

• os module — for file and folder operations
• shutil — for safe copying and moving of files
• pathlib — for robust path handling (cross-platform)

No external packages required — pure Python.

Workflow

1. Load Config:
   Reads settings from a config.json file (path and sorting rules).

2. Scan Folder:
   Lists all files in the target directory.

3. Process Files:
   For each file:

   • Detect file type
   • Decide target subfolder
   • Create subfolder if needed
   • Move the file

4. Log Result:
   Prints each operation for full transparency.

5. Done!

---

Below is the high-level workflow of the automation logic:

Project Structure

file-automation/ ├── file_manager.py ├── config.example.json # Template config file — copy this to create your own config ├── .gitignore └── README.md

Features

1. Automated Sorting — Classifies and relocates files into structured directories based on configurable rules.

2. Robust Logging — Generates detailed logs for all operations and errors, ensuring traceability.

3. One-Command Execution — Simple, single-run script to maintain folder integrity.

4. Lightweight & Configurable — Pure Python solution with flexible JSON-based settings.