sortnest 0.1.0__tar.gz

sortnest-0.1.0/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 sortnest authors
+
+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.

sortnest-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: sortnest
+Version: 0.1.0
+Summary: Tidy a folder by file type, with preview and undo.
+License-Expression: MIT
+Keywords: organizer,files,cleanup,downloads,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# sortnest
+
+Tidy any folder by file type. It shows a preview first,
+and you can undo the last run at any time.
+
+## Features
+
+- Sorts files into folders: Images, Videos, Music, Documents,
+  Archives, Programs, Code and Others
+- Preview before anything is moved
+- One-step undo
+- Never overwrites: name clashes become `file (1).ext`
+- No dependencies, pure Python
+
+## Install
+
+```
+pip install sortnest
+```
+
+## Usage
+
+```
+sortnest
+```
+
+Or, without installing the command:
+
+```
+python -m sortnest
+```
+
+Then enter a folder path (press Enter for your Downloads
+folder) and choose:
+
+1. Organize files
+2. Undo last organize
+
+## Customize
+
+Open `src/sortnest/organizer.py` and edit the `CATEGORIES`
+dictionary to add your own file types.
+
+## License
+
+MIT

sortnest-0.1.0/README.md

@@ -0,0 +1,46 @@
+# sortnest
+
+Tidy any folder by file type. It shows a preview first,
+and you can undo the last run at any time.
+
+## Features
+
+- Sorts files into folders: Images, Videos, Music, Documents,
+  Archives, Programs, Code and Others
+- Preview before anything is moved
+- One-step undo
+- Never overwrites: name clashes become `file (1).ext`
+- No dependencies, pure Python
+
+## Install
+
+```
+pip install sortnest
+```
+
+## Usage
+
+```
+sortnest
+```
+
+Or, without installing the command:
+
+```
+python -m sortnest
+```
+
+Then enter a folder path (press Enter for your Downloads
+folder) and choose:
+
+1. Organize files
+2. Undo last organize
+
+## Customize
+
+Open `src/sortnest/organizer.py` and edit the `CATEGORIES`
+dictionary to add your own file types.
+
+## License
+
+MIT

sortnest-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sortnest"
+version = "0.1.0"
+description = "Tidy a folder by file type, with preview and undo."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["organizer", "files", "cleanup", "downloads", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Environment :: Console",
+    "Operating System :: OS Independent",
+    "Topic :: System :: Filesystems",
+    "Topic :: Utilities",
+]
+
+[project.scripts]
+sortnest = "sortnest.organizer:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

sortnest-0.1.0/setup.cfg

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

sortnest-0.1.0/src/sortnest/__init__.py

@@ -0,0 +1,3 @@
+"""sortnest - tidy a folder by file type, with preview and undo."""
+
+__version__ = "0.1.0"

sortnest-0.1.0/src/sortnest/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running the tool with: python -m sortnest"""
+
+from sortnest.organizer import main
+
+main()

sortnest-0.1.0/src/sortnest/organizer.py

@@ -0,0 +1,146 @@
+"""
+File Organizer
+
+Sorts the files in a folder into sub-folders by type.
+Shows a preview first, and can undo the last run.
+
+Usage:  python organizer.py
+"""
+
+import json
+import shutil
+from pathlib import Path
+
+# Folder name -> file extensions that belong in it.
+CATEGORIES = {
+    "Images": {".jpg", ".jpeg", ".png", ".gif", ".webp", ".bmp"},
+    "Videos": {".mp4", ".mkv", ".avi", ".mov", ".wmv"},
+    "Music": {".mp3", ".wav", ".flac", ".m4a"},
+    "Documents": {
+        ".pdf", ".doc", ".docx", ".txt",
+        ".xls", ".xlsx", ".ppt", ".pptx", ".csv",
+    },
+    "Archives": {".zip", ".rar", ".7z", ".tar", ".gz"},
+    "Programs": {".exe", ".msi"},
+    "Code": {".py", ".js", ".html", ".css", ".json"},
+}
+
+# Unfinished downloads are left alone.
+SKIP_EXTENSIONS = {".crdownload", ".part", ".tmp"}
+
+# History file used by Undo.
+LOG_NAME = ".organizer_log.json"
+
+
+def get_category(file):
+    """Return the category name for a file."""
+    ext = file.suffix.lower()
+    for category, extensions in CATEGORIES.items():
+        if ext in extensions:
+            return category
+    return "Others"
+
+
+def unique_path(path):
+    """Add (1), (2), ... if the file name is already taken."""
+    if not path.exists():
+        return path
+    counter = 1
+    while True:
+        name = f"{path.stem} ({counter}){path.suffix}"
+        new_path = path.with_name(name)
+        if not new_path.exists():
+            return new_path
+        counter += 1
+
+
+def plan_moves(folder):
+    """List (source, destination) pairs. Moves nothing."""
+    moves = []
+    for item in folder.iterdir():
+        if not item.is_file():
+            continue
+        if item.name == LOG_NAME:
+            continue
+        if item.suffix.lower() in SKIP_EXTENSIONS:
+            continue
+        target = folder / get_category(item) / item.name
+        moves.append((item, unique_path(target)))
+    return moves
+
+
+def organize(folder):
+    """Preview, ask for confirmation, then move the files."""
+    moves = plan_moves(folder)
+    if not moves:
+        print("Nothing to organize here.")
+        return
+
+    print(f"\nPreview ({len(moves)} files):")
+    for src, dst in moves:
+        print(f"  {src.name}  ->  {dst.parent.name}/")
+
+    answer = input("\nProceed? (y/n): ").strip().lower()
+    if answer != "y":
+        print("Cancelled. Nothing was changed.")
+        return
+
+    log = []
+    for src, dst in moves:
+        dst.parent.mkdir(exist_ok=True)
+        shutil.move(str(src), str(dst))
+        log.append({"from": str(src), "to": str(dst)})
+
+    log_file = folder / LOG_NAME
+    log_file.write_text(json.dumps(log, indent=2), encoding="utf-8")
+    print(f"\nDone! Moved {len(log)} files.")
+
+
+def undo(folder):
+    """Move files back and remove empty category folders."""
+    log_file = folder / LOG_NAME
+    if not log_file.exists():
+        print("No previous run found to undo.")
+        return
+
+    log = json.loads(log_file.read_text(encoding="utf-8"))
+    restored = 0
+    for entry in reversed(log):
+        src = Path(entry["from"])
+        dst = Path(entry["to"])
+        if not dst.exists():
+            continue
+        shutil.move(str(dst), str(unique_path(src)))
+        restored += 1
+        if not any(dst.parent.iterdir()):
+            dst.parent.rmdir()
+
+    log_file.unlink()
+    print(f"Undo complete. Restored {restored} files.")
+
+
+def main():
+    """Ask for a folder, then organize it or undo the last run."""
+    default = Path.home() / "Downloads"
+    text = input(f"Folder path (Enter = {default}): ")
+    text = text.strip().strip('"')
+    folder = Path(text) if text else default
+
+    if not folder.is_dir():
+        print("That folder does not exist.")
+        return
+
+    print("\n1) Organize files")
+    print("2) Undo last organize")
+    choice = input("Choose 1 or 2: ").strip()
+
+    if choice == "1":
+        organize(folder)
+    elif choice == "2":
+        undo(folder)
+    else:
+        print("Invalid choice.")
+
+
+if __name__ == "__main__":
+    main()

sortnest-0.1.0/src/sortnest.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: sortnest
+Version: 0.1.0
+Summary: Tidy a folder by file type, with preview and undo.
+License-Expression: MIT
+Keywords: organizer,files,cleanup,downloads,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# sortnest
+
+Tidy any folder by file type. It shows a preview first,
+and you can undo the last run at any time.
+
+## Features
+
+- Sorts files into folders: Images, Videos, Music, Documents,
+  Archives, Programs, Code and Others
+- Preview before anything is moved
+- One-step undo
+- Never overwrites: name clashes become `file (1).ext`
+- No dependencies, pure Python
+
+## Install
+
+```
+pip install sortnest
+```
+
+## Usage
+
+```
+sortnest
+```
+
+Or, without installing the command:
+
+```
+python -m sortnest
+```
+
+Then enter a folder path (press Enter for your Downloads
+folder) and choose:
+
+1. Organize files
+2. Undo last organize
+
+## Customize
+
+Open `src/sortnest/organizer.py` and edit the `CATEGORIES`
+dictionary to add your own file types.
+
+## License
+
+MIT

sortnest-0.1.0/src/sortnest.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/sortnest/__init__.py
+src/sortnest/__main__.py
+src/sortnest/organizer.py
+src/sortnest.egg-info/PKG-INFO
+src/sortnest.egg-info/SOURCES.txt
+src/sortnest.egg-info/dependency_links.txt
+src/sortnest.egg-info/entry_points.txt
+src/sortnest.egg-info/top_level.txt

sortnest-0.1.0/src/sortnest.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sortnest-0.1.0/src/sortnest.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sortnest = sortnest.organizer:main

sortnest-0.1.0/src/sortnest.egg-info/top_level.txt

@@ -0,0 +1 @@
+sortnest