sizespy 0.1.0

A Python package for analyzing and visualizing file sizes.

🕵️ sizespy

sizespy is a powerful Python CLI tool to inspect folders, discover disk usage, find large files, and analyze storage directly from your terminal.

Perfect for developers, power users, and anyone wondering:

"What is eating my disk space?"

---

🚀 Features

✅ Scan folder sizes instantly
✅ Show largest files
✅ Tree view with folder sizes
✅ Sort by biggest items
✅ Export report to CSV
✅ Safe file delete option
✅ Clean terminal output
✅ Cross-platform (Windows / Linux / macOS)

---

📦 Installation

pip install sizespy

---

⚡ Basic Usage

Scan current folder:

sizespy

Scan specific folder:

sizespy "C:\Users\KUMAR\Downloads"

Linux/macOS:

sizespy /home/user/Downloads

---

📊 Examples

Show Top 10 Largest Items

sizespy . --top 10

---

📁 Tree View

sizespy . --tree

Custom depth:

sizespy . --tree --depth 3

---

🔥 Largest Files

Show top 10 largest files:

sizespy . --largest 10

---

🔄 Smallest First

sizespy . --reverse

---

📄 Export CSV Report

sizespy . --export

Output:

sizespy_report.csv

---

🗑 Safe Delete File

sizespy --delete largefile.zip

(asks confirmation before deleting)

---

💻 Example Output

📊 SIZE REPORT
--------------------------------------------------
📁     5.42 GB | Videos
📁     2.18 GB | Downloads
📄   850.32 MB | movie.mkv
📄   120.45 MB | project.zip
--------------------------------------------------
Items: 4

---

🛠 Options

Command	Description
sizespy	Scan current folder
sizespy path	Scan specific path
--top N	Show top N items
--reverse	Smallest first
--tree	Tree view
--depth N	Tree depth
--largest N	Largest files
--export	Export CSV
--delete file	Delete file safely

---

🌍 Supported Platforms

✅ Windows
✅ Linux
✅ macOS

---

📌 Why sizespy?

Most disk tools are heavy GUI apps.

sizespy is:

• Fast ⚡
• Lightweight 🪶
• Developer friendly 💻
• Terminal based 🖥
• Scriptable 🔥

---

🤝 Contributing

Pull requests are welcome.

Ideas for future versions:

• Duplicate file finder
• Color themes
• Interactive mode
• Progress bar scanner
• Auto cleanup mode

---

📜 License

MIT License

---

⭐ Support

If you like this project:

⭐ Star the GitHub repo
⭐ Share with developers
⭐ Follow future updates

---

🕵️ sizespy

Spy on your storage. Find the truth.