downsweep 0.1.0__tar.gz → 0.2.0__tar.gz

downsweep-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hari Prasath S
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

downsweep-0.2.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: downsweep
+Version: 0.2.0
+Summary: Sort a messy Downloads folder into neat folders with one command. Includes preview and undo.
+Author: Hari Prasath S
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/stonefrozen096-collab/downsweep
+Project-URL: Source, https://github.com/stonefrozen096-collab/downsweep
+Project-URL: Issues, https://github.com/stonefrozen096-collab/downsweep/issues
+Keywords: downloads,organizer,cleaner,files,cli,undo
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+\# downsweep
+
+
+
+\*\*Sort a messy Downloads folder into neat folders with one command. Changed your mind? Undo it.\*\*
+
+
+
+!\[PyPI](https://img.shields.io/pypi/v/downsweep) !\[License](https://img.shields.io/pypi/l/downsweep) !\[Python](https://img.shields.io/pypi/pyversions/downsweep)
+
+
+
+Your Downloads folder is full of PDFs, installers, screenshots and zip files
+
+all mixed together. `downsweep` sorts them into Images, PDFs, Documents,
+
+Programs and more in a few seconds, and lets you reverse it if you don't like
+
+the result.
+
+
+
+\## Install
+
+
+
+    pip install downsweep
+
+
+
+\## Quick start
+
+
+
+See what would happen first. Nothing is moved:
+
+
+
+    downsweep --preview
+
+
+
+Clean your Downloads folder:
+
+
+
+    downsweep
+
+
+
+Changed your mind? Move everything back:
+
+
+
+    downsweep --undo
+
+
+
+Clean any other folder:
+
+
+
+    downsweep "C:\\path\\to\\folder"
+
+
+
+\## What you will see
+
+
+
+    Moved: report.pdf  ->  PDFs
+
+    Moved: photo.jpg  ->  Images
+
+    Moved: setup.exe  ->  Programs
+
+
+
+    Summary
+
+    -------
+
+    PDFs         40
+
+    Programs     30
+
+    Images       12
+
+    Total        82
+
+
+
+    Done! Changed your mind? Run: downsweep --undo
+
+
+
+\## Features
+
+
+
+| Feature | What it does |
+
+| --- | --- |
+
+| Preview mode | Shows what would move, changes nothing |
+
+| Undo | Moves the last cleanup's files back where they were |
+
+| Summary | Prints how many files went into each folder |
+
+| Safe by design | Never overwrites a file, adds (1), (2) to duplicate names |
+
+| Download-aware | Skips files still downloading, like .crdownload and .part |
+
+| Zero dependencies | Only uses Python's standard library |
+
+
+
+\## Folders it creates
+
+
+
+Images, Videos, Audio, PDFs, Documents, Archives, Programs, Code and Other.
+
+
+
+\## Good to know
+
+
+
+\- Undo reverses the \*\*last\*\* cleanup of a folder only.
+
+\- After a cleanup, a small file called `.downsweep\_log.json` is saved inside the
+
+  folder. That is how undo remembers what moved. Please don't delete it if you
+
+  want to undo.
+
+\- Only files directly inside the folder are sorted. Existing sub-folders are
+
+  left alone.
+
+
+
+\## License
+
+
+
+MIT
+

downsweep-0.2.0/README.md

@@ -0,0 +1,150 @@
+\# downsweep
+
+
+
+\*\*Sort a messy Downloads folder into neat folders with one command. Changed your mind? Undo it.\*\*
+
+
+
+!\[PyPI](https://img.shields.io/pypi/v/downsweep) !\[License](https://img.shields.io/pypi/l/downsweep) !\[Python](https://img.shields.io/pypi/pyversions/downsweep)
+
+
+
+Your Downloads folder is full of PDFs, installers, screenshots and zip files
+
+all mixed together. `downsweep` sorts them into Images, PDFs, Documents,
+
+Programs and more in a few seconds, and lets you reverse it if you don't like
+
+the result.
+
+
+
+\## Install
+
+
+
+    pip install downsweep
+
+
+
+\## Quick start
+
+
+
+See what would happen first. Nothing is moved:
+
+
+
+    downsweep --preview
+
+
+
+Clean your Downloads folder:
+
+
+
+    downsweep
+
+
+
+Changed your mind? Move everything back:
+
+
+
+    downsweep --undo
+
+
+
+Clean any other folder:
+
+
+
+    downsweep "C:\\path\\to\\folder"
+
+
+
+\## What you will see
+
+
+
+    Moved: report.pdf  ->  PDFs
+
+    Moved: photo.jpg  ->  Images
+
+    Moved: setup.exe  ->  Programs
+
+
+
+    Summary
+
+    -------
+
+    PDFs         40
+
+    Programs     30
+
+    Images       12
+
+    Total        82
+
+
+
+    Done! Changed your mind? Run: downsweep --undo
+
+
+
+\## Features
+
+
+
+| Feature | What it does |
+
+| --- | --- |
+
+| Preview mode | Shows what would move, changes nothing |
+
+| Undo | Moves the last cleanup's files back where they were |
+
+| Summary | Prints how many files went into each folder |
+
+| Safe by design | Never overwrites a file, adds (1), (2) to duplicate names |
+
+| Download-aware | Skips files still downloading, like .crdownload and .part |
+
+| Zero dependencies | Only uses Python's standard library |
+
+
+
+\## Folders it creates
+
+
+
+Images, Videos, Audio, PDFs, Documents, Archives, Programs, Code and Other.
+
+
+
+\## Good to know
+
+
+
+\- Undo reverses the \*\*last\*\* cleanup of a folder only.
+
+\- After a cleanup, a small file called `.downsweep\_log.json` is saved inside the
+
+  folder. That is how undo remembers what moved. Please don't delete it if you
+
+  want to undo.
+
+\- Only files directly inside the folder are sorted. Existing sub-folders are
+
+  left alone.
+
+
+
+\## License
+
+
+
+MIT
+

downsweep-0.2.0/downsweep/cli.py

@@ -0,0 +1,143 @@
+import argparse
+import json
+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, or system files - never touch these
+SKIP = {".crdownload", ".part", ".tmp", ".ini", ".lnk"}
+
+# Hidden file where the last cleanup is remembered, so it can be undone
+LOG_NAME = ".downsweep_log.json"
+
+
+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 print_summary(counts):
+    print("\nSummary")
+    print("-------")
+    for name, number in sorted(counts.items(), key=lambda pair: -pair[1]):
+        print(f"{name:<12} {number}")
+    print(f"{'Total':<12} {sum(counts.values())}")
+
+
+def clean(folder, preview):
+    moves = []
+    counts = {}
+    for item in sorted(folder.iterdir()):
+        if not item.is_file() or item.suffix.lower() in SKIP or item.name == LOG_NAME:
+            continue
+        category = get_category(item)
+        counts[category] = counts.get(category, 0) + 1
+        if preview:
+            print(f"Would move: {item.name}  ->  {category}")
+        else:
+            target_dir = folder / category
+            target_dir.mkdir(exist_ok=True)
+            target = unique_path(target_dir / item.name)
+            shutil.move(str(item), str(target))
+            moves.append({"from": str(item), "to": str(target)})
+            print(f"Moved: {item.name}  ->  {category}")
+
+    if not counts:
+        print("Nothing to sort here.")
+        return
+
+    print_summary(counts)
+    if preview:
+        print("\nNothing was changed.")
+    else:
+        (folder / LOG_NAME).write_text(json.dumps(moves, indent=2), encoding="utf-8")
+        print("\nDone! Changed your mind? Run: downsweep --undo")
+
+
+def undo(folder):
+    log_file = folder / LOG_NAME
+    if not log_file.exists():
+        print("Nothing to undo.")
+        return
+
+    moves = json.loads(log_file.read_text(encoding="utf-8"))
+    restored = 0
+    for move in moves:
+        source = Path(move["to"])
+        destination = Path(move["from"])
+        if source.exists():
+            shutil.move(str(source), str(unique_path(destination)))
+            restored += 1
+        else:
+            print(f"Could not find, skipped: {source.name}")
+    log_file.unlink()
+
+    # Remove category folders that are now empty
+    for name in list(CATEGORIES) + ["Other"]:
+        category_dir = folder / name
+        if category_dir.is_dir() and not any(category_dir.iterdir()):
+            category_dir.rmdir()
+
+    print(f"Undone! {restored} file(s) moved back.")
+
+
+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",
+    )
+    parser.add_argument(
+        "--undo",
+        action="store_true",
+        help="Move files back to where they were (undo the last cleanup)",
+    )
+    args = parser.parse_args()
+
+    folder = Path(args.folder)
+    if not folder.is_dir():
+        print(f"Folder not found: {folder}")
+        return
+
+    if args.undo:
+        undo(folder)
+    else:
+        clean(folder, args.preview)
+
+
+if __name__ == "__main__":
+    main()

downsweep-0.2.0/downsweep.egg-info/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: downsweep
+Version: 0.2.0
+Summary: Sort a messy Downloads folder into neat folders with one command. Includes preview and undo.
+Author: Hari Prasath S
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/stonefrozen096-collab/downsweep
+Project-URL: Source, https://github.com/stonefrozen096-collab/downsweep
+Project-URL: Issues, https://github.com/stonefrozen096-collab/downsweep/issues
+Keywords: downloads,organizer,cleaner,files,cli,undo
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+\# downsweep
+
+
+
+\*\*Sort a messy Downloads folder into neat folders with one command. Changed your mind? Undo it.\*\*
+
+
+
+!\[PyPI](https://img.shields.io/pypi/v/downsweep) !\[License](https://img.shields.io/pypi/l/downsweep) !\[Python](https://img.shields.io/pypi/pyversions/downsweep)
+
+
+
+Your Downloads folder is full of PDFs, installers, screenshots and zip files
+
+all mixed together. `downsweep` sorts them into Images, PDFs, Documents,
+
+Programs and more in a few seconds, and lets you reverse it if you don't like
+
+the result.
+
+
+
+\## Install
+
+
+
+    pip install downsweep
+
+
+
+\## Quick start
+
+
+
+See what would happen first. Nothing is moved:
+
+
+
+    downsweep --preview
+
+
+
+Clean your Downloads folder:
+
+
+
+    downsweep
+
+
+
+Changed your mind? Move everything back:
+
+
+
+    downsweep --undo
+
+
+
+Clean any other folder:
+
+
+
+    downsweep "C:\\path\\to\\folder"
+
+
+
+\## What you will see
+
+
+
+    Moved: report.pdf  ->  PDFs
+
+    Moved: photo.jpg  ->  Images
+
+    Moved: setup.exe  ->  Programs
+
+
+
+    Summary
+
+    -------
+
+    PDFs         40
+
+    Programs     30
+
+    Images       12
+
+    Total        82
+
+
+
+    Done! Changed your mind? Run: downsweep --undo
+
+
+
+\## Features
+
+
+
+| Feature | What it does |
+
+| --- | --- |
+
+| Preview mode | Shows what would move, changes nothing |
+
+| Undo | Moves the last cleanup's files back where they were |
+
+| Summary | Prints how many files went into each folder |
+
+| Safe by design | Never overwrites a file, adds (1), (2) to duplicate names |
+
+| Download-aware | Skips files still downloading, like .crdownload and .part |
+
+| Zero dependencies | Only uses Python's standard library |
+
+
+
+\## Folders it creates
+
+
+
+Images, Videos, Audio, PDFs, Documents, Archives, Programs, Code and Other.
+
+
+
+\## Good to know
+
+
+
+\- Undo reverses the \*\*last\*\* cleanup of a folder only.
+
+\- After a cleanup, a small file called `.downsweep\_log.json` is saved inside the
+
+  folder. That is how undo remembers what moved. Please don't delete it if you
+
+  want to undo.
+
+\- Only files directly inside the folder are sorted. Existing sub-folders are
+
+  left alone.
+
+
+
+\## License
+
+
+
+MIT
+

{downsweep-0.1.0 → downsweep-0.2.0}/downsweep.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 downsweep/__init__.py

downsweep-0.2.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "downsweep"
+version = "0.2.0"
+description = "Sort a messy Downloads folder into neat folders with one command. Includes preview and undo."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Hari Prasath S" }]
+keywords = ["downloads", "organizer", "cleaner", "files", "cli", "undo"]
+classifiers = [
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/stonefrozen096-collab/downsweep"
+Source = "https://github.com/stonefrozen096-collab/downsweep"
+Issues = "https://github.com/stonefrozen096-collab/downsweep/issues"
+
+[project.scripts]
+downsweep = "downsweep.cli:main"
+
+[tool.setuptools]
+packages = ["downsweep"]

downsweep-0.1.0/PKG-INFO

@@ -1,36 +0,0 @@
-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/README.md

@@ -1,27 +0,0 @@
-# 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/downsweep/cli.py

@@ -1,83 +0,0 @@
-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/downsweep.egg-info/PKG-INFO

@@ -1,36 +0,0 @@
-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/pyproject.toml

@@ -1,18 +0,0 @@
-[build-system]
-requires = ["setuptools>=68"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "downsweep"
-version = "0.1.0"
-description = "Sort a messy Downloads folder into neat folders with one command."
-readme = "README.md"
-requires-python = ">=3.8"
-authors = [{ name = "Hari Prasath S" }]
-keywords = ["downloads", "organizer", "cleaner", "files", "cli"]
-
-[project.scripts]
-downsweep = "downsweep.cli:main"
-
-[tool.setuptools]
-packages = ["downsweep"]