downsweep 0.1.0__py3-none-any.whl

downsweep/cli.py

@@ -0,0 +1,83 @@
+import argparse
+import shutil
+from pathlib import Path
+
+CATEGORIES = {
+    "Images": [".jpg", ".jpeg", ".png", ".gif", ".webp", ".bmp", ".svg", ".avif", ".jfif"],
+    "Videos": [".mp4", ".mkv", ".avi", ".mov", ".webm"],
+    "Audio": [".mp3", ".wav", ".flac", ".m4a"],
+    "PDFs": [".pdf"],
+    "Documents": [".doc", ".docx", ".txt", ".ppt", ".pptx", ".xls", ".xlsx", ".csv"],
+    "Archives": [".zip", ".rar", ".7z", ".tar", ".gz"],
+    "Programs": [".exe", ".msi"],
+    "Code": [".py", ".js", ".html", ".htm", ".css", ".java", ".cpp", ".ipynb"],
+}
+
+# Files still being downloaded - never touch these
+SKIP = {".crdownload", ".part", ".tmp", ".ini", ".lnk"}
+
+
+def get_category(file):
+    ext = file.suffix.lower()
+    for name, extensions in CATEGORIES.items():
+        if ext in extensions:
+            return name
+    return "Other"
+
+
+def unique_path(path):
+    # If a file with the same name exists, add (1), (2)... instead of overwriting
+    if not path.exists():
+        return path
+    counter = 1
+    while True:
+        new_path = path.with_name(f"{path.stem} ({counter}){path.suffix}")
+        if not new_path.exists():
+            return new_path
+        counter += 1
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Sort a messy folder into neat sub-folders by file type."
+    )
+    parser.add_argument(
+        "folder",
+        nargs="?",
+        default=str(Path.home() / "Downloads"),
+        help="Folder to clean (default: your Downloads folder)",
+    )
+    parser.add_argument(
+        "--preview",
+        action="store_true",
+        help="Show what would move, without moving anything",
+    )
+    args = parser.parse_args()
+
+    folder = Path(args.folder)
+    if not folder.is_dir():
+        print(f"Folder not found: {folder}")
+        return
+
+    count = 0
+    for item in folder.iterdir():
+        if not item.is_file() or item.suffix.lower() in SKIP:
+            continue
+        category = get_category(item)
+        if args.preview:
+            print(f"Would move: {item.name}  ->  {category}")
+        else:
+            target_dir = folder / category
+            target_dir.mkdir(exist_ok=True)
+            shutil.move(str(item), str(unique_path(target_dir / item.name)))
+            print(f"Moved: {item.name}  ->  {category}")
+        count += 1
+
+    if args.preview:
+        print(f"\n{count} file(s) would be moved. Nothing was changed.")
+    else:
+        print(f"\nDone! {count} file(s) sorted.")
+
+
+if __name__ == "__main__":
+    main()

downsweep-0.1.0.dist-info/METADATA

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: downsweep
+Version: 0.1.0
+Summary: Sort a messy Downloads folder into neat folders with one command.
+Author: Hari Prasath S
+Keywords: downloads,organizer,cleaner,files,cli
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# downsweep
+
+Sort a messy Downloads folder into neat folders with one command.
+
+## Install
+
+    pip install downsweep
+
+## Use
+
+Clean your Downloads folder:
+
+    downsweep
+
+See what would move first, without changing anything:
+
+    downsweep --preview
+
+Clean any other folder:
+
+    downsweep "C:\path\to\folder"
+
+## What it does
+
+Files are moved into folders like Images, Videos, Audio, PDFs, Documents,
+Archives, Programs, Code and Other. Files still being downloaded are skipped,
+and existing files are never overwritten.

downsweep-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+downsweep/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+downsweep/cli.py,sha256=la_wgflbxIoEkg4OgiR_u3Rgzoq2Sh88RRqv8mqxnG8,2574
+downsweep-0.1.0.dist-info/METADATA,sha256=b0klKceY1MMfor9Ev6DVEZ_8iZaB82erZ6dXVeCW9wM,822
+downsweep-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+downsweep-0.1.0.dist-info/entry_points.txt,sha256=1e4DaXkZkbyy7yPBehfaVbmQycci7vohekKZVkbAg7o,49
+downsweep-0.1.0.dist-info/top_level.txt,sha256=iGkb1dewIQsT2toORVatPUfAzFSQCa7NQ2_YFiofBa0,10
+downsweep-0.1.0.dist-info/RECORD,,

downsweep-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

downsweep-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+downsweep = downsweep.cli:main

downsweep-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+downsweep