downsorter 0.1.0__tar.gz

downsorter-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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.

downsorter-0.1.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: downsorter
+Version: 0.1.0
+Summary: Organize files by extension into category folders from the command line.
+Author: Your Name
+License: MIT
+Keywords: downloads,file sorting,organization,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Downsorter
+
+A simple Python CLI tool to organize files in a folder by extension into category folders.
+
+## Install
+
+```bash
+pip install .
+```
+
+## Usage
+
+Preview mode:
+
+```bash
+downsorter --folder "C:\path\to\folder"
+```
+
+Apply mode:
+
+```bash
+downsorter --folder "C:\path\to\folder" --apply
+```
+
+## Options
+
+- `--folder`: Folder to organize (defaults to your Downloads folder)
+- `--apply`: Actually move files
+- `--min-age-days`: Only move files at least this many days old
+- `--log-file`: CSV file to write move logs

downsorter-0.1.0/README.md

@@ -0,0 +1,30 @@
+# Downsorter
+
+A simple Python CLI tool to organize files in a folder by extension into category folders.
+
+## Install
+
+```bash
+pip install .
+```
+
+## Usage
+
+Preview mode:
+
+```bash
+downsorter --folder "C:\path\to\folder"
+```
+
+Apply mode:
+
+```bash
+downsorter --folder "C:\path\to\folder" --apply
+```
+
+## Options
+
+- `--folder`: Folder to organize (defaults to your Downloads folder)
+- `--apply`: Actually move files
+- `--min-age-days`: Only move files at least this many days old
+- `--log-file`: CSV file to write move logs

downsorter-0.1.0/downsorter.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: downsorter
+Version: 0.1.0
+Summary: Organize files by extension into category folders from the command line.
+Author: Your Name
+License: MIT
+Keywords: downloads,file sorting,organization,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Downsorter
+
+A simple Python CLI tool to organize files in a folder by extension into category folders.
+
+## Install
+
+```bash
+pip install .
+```
+
+## Usage
+
+Preview mode:
+
+```bash
+downsorter --folder "C:\path\to\folder"
+```
+
+Apply mode:
+
+```bash
+downsorter --folder "C:\path\to\folder" --apply
+```
+
+## Options
+
+- `--folder`: Folder to organize (defaults to your Downloads folder)
+- `--apply`: Actually move files
+- `--min-age-days`: Only move files at least this many days old
+- `--log-file`: CSV file to write move logs

downsorter-0.1.0/downsorter.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+sorter.py
+downsorter.egg-info/PKG-INFO
+downsorter.egg-info/SOURCES.txt
+downsorter.egg-info/dependency_links.txt
+downsorter.egg-info/entry_points.txt
+downsorter.egg-info/top_level.txt

downsorter-0.1.0/downsorter.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

downsorter-0.1.0/downsorter.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+downsorter = sorter:main

downsorter-0.1.0/downsorter.egg-info/top_level.txt

@@ -0,0 +1 @@
+sorter

downsorter-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "downsorter"
+version = "0.1.0"
+description = "Organize files by extension into category folders from the command line."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Your Name" }
+]
+keywords = ["downloads", "file sorting", "organization", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+downsorter = "sorter:main"
+
+[tool.setuptools]
+py-modules = ["sorter"]

downsorter-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

downsorter-0.1.0/sorter.py

@@ -0,0 +1,160 @@
+from __future__ import annotations
+
+
+import argparse 
+import csv
+import shutil
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+from pathlib import Path
+
+
+CATEGORIES = {
+    "Images": {".jpg" , ".jpeg" , ".png" , ".webp" , ".bmp"},
+    "PDFs" : {".pdf"},
+    "Documents" : {".doc" , ".docx" , ".txt" , ".md" , ".rtf"},
+    "Spreadsheets" : {".xls" , ".xlsx" , ".csv" , ".tsv"},
+    "PPTs" : {".ppt" , ".pptx"},
+    "archives" : {".rar" , ".zip" ,".7z" , ".tar" , ".gz"},
+    "installers" : {".exe" , ".msi"},
+    "Code" : {".py" , ".js" , ".html" , ".css" , ".json" , ".xml" , ".cpp" , ".java"},
+    "Audio" : {".mp3" , ".wav" , ".flac" , ".aac" , ".ogg"},
+    "Videos" : {".mp4" , ".gif" , ".mov" , ".mkv" , ".avi" , ".webm"}
+}
+IGNORE_NAMES = {
+    "desktop.ini",
+    "thumbs.db",
+}
+
+
+@dataclass(frozen=True)
+class MovePlan:
+    source: Path
+    destination: Path
+
+def default_downloads_folder():
+    return Path.home()/ "Downloads"
+
+
+def category_in(file_path: Path):
+    suffix = file_path.suffix.lower()
+    for category, extensions in CATEGORIES.items():
+        if suffix in extensions:
+            return category
+    return "Other"
+
+def agecheck(file_path: Path, minimum_days: int):
+    if minimum_days <= 0:
+        return True
+    mod_time = datetime.fromtimestamp(file_path.stat().st_mtime)
+    return mod_time <= datetime.now() - timedelta(days= minimum_days)
+
+def unique_des(des: Path):
+    if not des.exists():
+        return des
+    counter = 1
+    while True:
+        candidate=des.with_name(
+            f"{des.stem} ({counter}){des.suffix}"
+        )
+        if not candidate.exists():
+            return candidate
+        counter = counter + 1
+
+def BUILD_plan(downloads_folder:Path , minimum_days:int):
+    plans: list[MovePlan] = []
+    for item in downloads_folder.iterdir():
+        if not item.is_file():
+            continue
+        if item.name.lower() in IGNORE_NAMES:
+            continue
+        if not agecheck(item,minimum_days):
+            continue
+        
+        category = category_in(item)
+        des = unique_des(downloads_folder / category / item.name)
+        plans.append(MovePlan(source=item , destination=des))
+    return plans
+
+def PRINT_plan(plans :list[MovePlan] , apply : bool):
+    if not plans:
+        print("Nothing to clean , your folder is already tidy lmao")
+        return
+    action = "Moving" if apply else "Would move"
+    for plan in plans:
+        file_name = plan.source.name
+        destination = plan.destination.parent.name + "\\" + plan.destination.name
+        print(action + ": " + file_name + " -> " + destination)
+    
+def WRITE_log(log_file: Path , completed_changes : list[MovePlan]):
+    log_file.parent.mkdir(parents=True, exist_ok=True)
+    file_exists=log_file.exists()
+    with log_file.open("a" , newline="",encoding="utf-8") as f:
+        writer = csv.writer(f)
+        if not file_exists:
+            writer.writerow(["moved at", "source", "destination"])
+        moved_at = datetime.now().isoformat(timespec="seconds")
+        for move in completed_changes:
+            writer.writerow([moved_at, str(move.source) , str(move.destination)])
+
+def APPLY_plan(plans : list[MovePlan] , log_file: Path):
+    completed_changes : list[MovePlan] = []
+
+    for plan in plans:
+        plan.destination.parent.mkdir(parents=True , exist_ok=True)
+        shutil.move(str(plan.source) , str(plan.destination))
+        completed_changes.append(plan)
+    if completed_changes:
+        WRITE_log(log_file,completed_changes)
+
+def parse_args():
+    parser = argparse.ArgumentParser(
+        description="Safely organize your downloads folder by file type"
+    )
+    parser.add_argument(
+        "--folder",
+        type=Path,
+        default=default_downloads_folder(),
+        help="Folder to clean . By default downloads folder"
+    )
+    parser.add_argument(
+        "--apply",
+        action="store_true",
+        help="Actually move files. Without this flag, the script only previews changes.",
+    )
+    parser.add_argument(
+        "--min-age-days",
+        type=int,
+        default=0,
+        help="Only move files at least this many days old. can be edited",
+    )
+    parser.add_argument(
+        "--log-file",
+        type=Path,
+        default=Path("movelogs.csv"),
+        help="CSV file where completed moves are recorded.",
+    )
+    return parser.parse_args()
+
+def main():
+    args = parse_args()
+    downloads_folder = args.folder.expanduser().resolve()
+    
+    if not downloads_folder.exists():
+        raise SystemExit(f"Folder does not exist: {downloads_folder}")
+    if not downloads_folder.is_dir():
+        raise SystemExit(f"Not a folder: {downloads_folder}")
+    if args.min_age_days < 0:
+        raise SystemExit(f"--min-age-days cannot be NEGATIVE")
+        
+    plans = BUILD_plan(downloads_folder, args.min_age_days)
+    PRINT_plan(plans , args.apply)
+
+    if args.apply and plans:
+        APPLY_plan(plans , args.log_file)
+        print(f"Done. Move log written to {args.log_file.resolve()}")
+    elif plans:
+        print("Preview only. Run again with --apply to move these files")
+
+if __name__=="__main__":
+    main()