Merge pull request sumanth-0#798 from akashadsare/add-folder-size-calculator

sumanth-0 · web-flow · commit 8243a36138f1 · 2025-10-12T21:02:39.000+05:30
Add Folder Size Calculator - Issue sumanth-0#786
diff --git a/Folder_Size_Calculator/README.md b/Folder_Size_Calculator/README.md
@@ -0,0 +1,83 @@
+# Folder Size Calculator
+
+A minimal Python script that calculates and displays the size of each folder in a directory in human-readable format.
+
+## Features
+
+- **Recursive Size Calculation**: Calculates total size including all subdirectories
+- **Human-Readable Format**: Displays sizes in B, KB, MB, GB, TB, PB
+- **Sorted Results**: Shows folders sorted by size (largest first)
+- **Total Summary**: Displays total size of all folders
+- **Error Handling**: Gracefully handles permission errors and missing files
+
+## Usage
+
+### Command Line
+```bash
+python folder_size_calculator.py [directory]
+```
+
+### Interactive Mode
+```bash
+python folder_size_calculator.py
+```
+
+## Example Output
+
+```
+Folder Size Calculator
+=========================
+
+Calculating folder sizes in: /home/user/projects
+
+Folder sizes in: /home/user/projects
+--------------------------------------------------
+Folder Name                    Size           
+--------------------------------------------------
+large_project                  1.2 GB         
+media_files                    856.3 MB       
+documents                      45.7 MB        
+scripts                        2.1 MB         
+configs                        156.8 KB       
+--------------------------------------------------
+Total                          2.1 GB         
+```
+
+## Size Units
+
+| Unit | Description |
+|------|-------------|
+| B    | Bytes |
+| KB   | Kilobytes (1,024 B) |
+| MB   | Megabytes (1,024 KB) |
+| GB   | Gigabytes (1,024 MB) |
+| TB   | Terabytes (1,024 GB) |
+| PB   | Petabytes (1,024 TB) |
+
+## Use Cases
+
+- **Disk Space Analysis**: Identify which folders consume most space
+- **Cleanup Planning**: Find large directories for cleanup
+- **Storage Management**: Monitor folder growth over time
+- **System Administration**: Quick directory size overview
+
+## Requirements
+
+- Python 3.6+
+- No external dependencies
+
+## Error Handling
+
+- Permission denied folders are skipped silently
+- Missing or inaccessible files don't break the calculation
+- Invalid directories show appropriate error messages
+
+## Performance
+
+- Efficiently walks directory trees
+- Handles large directories with many files
+- Minimal memory usage during calculation
+
+## Author
+
+Created for issue #786 - 100 Lines of Python Code Project
diff --git a/Folder_Size_Calculator/folder_size_calculator.py b/Folder_Size_Calculator/folder_size_calculator.py
@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+import os
+import sys
+
+
+def get_size(path):
+    """Get total size of directory in bytes."""
+    total = 0
+    try:
+        for dirpath, dirnames, filenames in os.walk(path):
+            for filename in filenames:
+                filepath = os.path.join(dirpath, filename)
+                try:
+                    total += os.path.getsize(filepath)
+                except (OSError, FileNotFoundError):
+                    pass
+    except (OSError, PermissionError):
+        pass
+    return total
+
+
+def format_size(bytes_size):
+    """Convert bytes to human-readable format."""
+    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
+        if bytes_size < 1024.0:
+            return f"{bytes_size:.1f} {unit}"
+        bytes_size /= 1024.0
+    return f"{bytes_size:.1f} PB"
+
+
+def calculate_folder_sizes(directory):
+    """Calculate sizes of all folders in directory."""
+    folder_sizes = []
+    
+    try:
+        items = os.listdir(directory)
+        for item in items:
+            item_path = os.path.join(directory, item)
+            if os.path.isdir(item_path):
+                size = get_size(item_path)
+                folder_sizes.append((item, size))
+    except (OSError, PermissionError) as e:
+        print(f"Error accessing directory: {e}")
+        return []
+    
+    return sorted(folder_sizes, key=lambda x: x[1], reverse=True)
+
+
+def display_results(folder_sizes, directory):
+    """Display folder sizes in formatted table."""
+    if not folder_sizes:
+        print("No folders found or permission denied")
+        return
+    
+    print(f"\nFolder sizes in: {directory}")
+    print("-" * 50)
+    print(f"{'Folder Name':<30} {'Size':<15}")
+    print("-" * 50)
+    
+    total_size = 0
+    for folder, size in folder_sizes:
+        formatted_size = format_size(size)
+        print(f"{folder:<30} {formatted_size:<15}")
+        total_size += size
+    
+    print("-" * 50)
+    print(f"{'Total':<30} {format_size(total_size):<15}")
+
+
+def main():
+    """Main function."""
+    print("Folder Size Calculator")
+    print("=" * 25)
+    
+    if len(sys.argv) > 1:
+        directory = sys.argv[1]
+    else:
+        directory = input("Enter directory path (or . for current): ").strip()
+        if not directory:
+            directory = "."
+    
+    if not os.path.exists(directory):
+        print(f"Directory not found: {directory}")
+        return
+    
+    if not os.path.isdir(directory):
+        print(f"Not a directory: {directory}")
+        return
+    
+    print(f"\nCalculating folder sizes in: {os.path.abspath(directory)}")
+    folder_sizes = calculate_folder_sizes(directory)
+    display_results(folder_sizes, directory)
+
+
+if __name__ == "__main__":
+    main()
