thanos-cli 0.1.0__py3-none-any.whl

thanos_cli/__init__.py

@@ -0,0 +1,4 @@
+"""Top-level package for thanos_cli."""
+
+__author__ = """Soldatov Serhii"""
+__email__ = "soldatov.own@gmail.com"

thanos_cli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+if __name__ == "__main__":
+    app()

thanos_cli/cli.py

@@ -0,0 +1,126 @@
+"""Console script for thanos_cli."""
+
+import random
+from typing import Annotated, Optional
+
+import typer
+from rich.console import Console
+
+from .utils import get_files
+
+app = typer.Typer(
+    name="thanos",
+    help="🫰 Thanos - Eliminate half of all files with a snap. Perfectly balanced, as all things should be.",
+    add_completion=False,
+)
+console = Console()
+
+
+def snap(directory: str = ".", recursive: bool = False, dry_run: bool = False):
+    """
+    The Snap - Eliminates half of all files randomly.
+
+    Args:
+        directory: Target directory (default: current directory)
+        recursive: Include subdirectories
+        dry_run: Show what would be deleted without actually deleting
+    """
+    print("🫰 Initiating the Snap...")
+
+    files = get_files(directory, recursive)
+    total_files = len(files)
+
+    if total_files == 0:
+        print("No files found. The universe is empty.")
+        return
+
+    # Calculate how many files to eliminate
+    files_to_eliminate = total_files // 2
+
+    # Randomly select files for elimination
+    eliminated = random.sample(files, files_to_eliminate)
+
+    print("\n📊 Balance Assessment:")
+    print(f"   Total files: {total_files}")
+    print(f"   Files to eliminate: {files_to_eliminate}")
+    print(f"   Survivors: {total_files - files_to_eliminate}")
+
+    if dry_run:
+        print("\n🔍 DRY RUN - These files would be eliminated:")
+        for file in eliminated:
+            print(f"   💀 {file}")
+        print("\n⚠️  This was a dry run. No files were harmed.")
+        return
+
+    # Confirm before destruction
+    print("\n⚠️  WARNING: This will permanently delete files!")
+    confirm = input("Type 'snap' to proceed: ")
+
+    if confirm.lower() != "snap":
+        print("Snap cancelled. The universe remains unchanged.")
+        return
+
+    # Execute the snap
+    print("\n💥 Snapping...")
+    eliminated_count = 0
+
+    for file in eliminated:
+        try:
+            file.unlink()
+            eliminated_count += 1
+            print(f"   💀 {file}")
+        except Exception as e:
+            print(f"   ❌ Failed to eliminate {file}: {e}")
+
+    print("\n✨ The snap is complete.")
+    print(f"   {eliminated_count} files eliminated.")
+    print("   Perfectly balanced, as all things should be.")
+
+
+@app.command()
+def main(
+    directory: Annotated[
+        Optional[str],
+        typer.Argument(
+            help="Target directory to snap (default: current directory)",
+            show_default=False,
+        ),
+    ] = ".",
+    recursive: Annotated[
+        bool, typer.Option("--recursive", "-r", help="Include files in subdirectories recursively")
+    ] = False,
+    dry_run: Annotated[
+        bool, typer.Option("--dry-run", "-d", help="Preview what would be deleted without actually deleting")
+    ] = False,
+):
+    """
+    🫰 Eliminate half of all files in a directory with a snap.
+
+    Thanos randomly selects and deletes exactly half of the files in the specified
+    directory. Use with caution - deleted files cannot be recovered!
+
+    Examples:
+
+        # Snap current directory (dry run first!)
+        $ thanos --dry-run
+
+        # Snap a specific directory
+        $ thanos /path/to/directory
+
+        # Include subdirectories recursively
+        $ thanos --recursive
+
+        # Snap a directory and its subdirectories
+        $ thanos /path/to/directory --recursive
+    """
+    try:
+        snap(directory, recursive, dry_run)
+    except Exception as e:
+        print(f"❌ Error: {e}")
+        return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    app()

thanos_cli/utils.py

@@ -0,0 +1,19 @@
+from pathlib import Path
+
+
+def get_files(directory: str, recursive: bool = False) -> list[Path]:
+    """Get all files in the directory."""
+    path = Path(directory)
+
+    if not path.exists():
+        raise FileNotFoundError(f"Directory '{directory}' does not exist")
+
+    if not path.is_dir():
+        raise NotADirectoryError(f"'{directory}' is not a directory")
+
+    if recursive:
+        files = [f for f in path.rglob("*") if f.is_file()]
+    else:
+        files = [f for f in path.iterdir() if f.is_file()]
+
+    return files

thanos_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: thanos-cli
+Version: 0.1.0
+Summary: 🫰 Thanos - Eliminate half of all files with a snap. Perfectly balanced, as all things should be.
+Project-URL: homepage, https://github.com/soldatov-ss/thanos
+Project-URL: bugs, https://github.com/soldatov-ss/thanos/issues
+Project-URL: changelog, https://github.com/soldatov-ss/thanos/blob/master/CHANGELOG.md
+Project-URL: documentation, https://github.com/soldatov-ss/thanos/blob/master/docs/usage.md
+Author-email: Soldatov Serhii <soldatov.own@gmail.com>
+Maintainer-email: Soldatov Serhii <soldatov.own@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cleanup,cli,files,thanos,utility
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: typer
+Provides-Extra: test
+Requires-Dist: coverage; extra == 'test'
+Requires-Dist: ipdb; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: ruff; extra == 'test'
+Requires-Dist: ty; extra == 'test'
+Description-Content-Type: text/markdown
+
+# 🫰 Thanos
+
+> *"Perfectly balanced, as all things should be."*
+
+A Python CLI tool that randomly eliminates half of the files in a directory with a snap. Inspired by Marvel's Thanos and his infamous snap.
+
+[![Test Python application](https://github.com/soldatov-ss/thanos/actions/workflows/test.yml/badge.svg)](https://github.com/soldatov-ss/thanos/actions/workflows/test.yml)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Coverage Status](https://coveralls.io/repos/github/soldatov-ss/thanos/badge.svg?branch=master)](https://coveralls.io/github/soldatov-ss/thanos?branch=master)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ⚠️ Warning
+
+**This tool permanently deletes files!** Use `--dry-run` first to preview what would be deleted. Deleted files cannot be recovered. Use at your own risk!
+
+## ✨ Features
+
+- 🎲 **Random Selection**: Eliminates exactly half of all files randomly
+- 🔒 **Safety First**: Requires confirmation before deletion
+- 👁️ **Dry Run Mode**: Preview what would be deleted without actually deleting
+- 📁 **Recursive Support**: Optionally include files in subdirectories
+- 🎨 **Beautiful CLI**: Colorful output with emojis and clear status messages
+- 🧪 **Well Tested**: Comprehensive test suite with pytest
+
+## 📦 Installation
+
+### Using uv (recommended)
+
+```bash
+uv add thanos-cli
+```
+
+### Using pip
+
+```bash
+pip install thanos-cli
+```
+
+
+## 🚀 Quick Start
+
+```bash
+# Always start with a dry run to see what would be deleted
+thanos --dry-run
+
+# Snap the current directory (requires confirmation)
+thanos
+
+# Snap a specific directory
+thanos /path/to/directory
+
+# Include subdirectories recursively
+thanos --recursive
+
+# Dry run on a specific directory with subdirectories
+thanos /path/to/directory --recursive --dry-run
+```
+
+## 📖 Usage
+
+```bash
+thanos [OPTIONS] [DIRECTORY]
+```
+
+### Arguments
+
+- `DIRECTORY` - Target directory to snap (default: current directory)
+
+### Options
+
+- `-r, --recursive` - Include files in subdirectories recursively
+- `-d, --dry-run` - Preview what would be deleted without actually deleting
+- `--help` - Show help message and exit
+
+### Examples
+
+```bash
+# See what would happen in current directory
+thanos --dry-run
+
+# Snap current directory
+thanos
+
+# Snap specific directory
+thanos /tmp/test-files
+
+# Snap with subdirectories
+thanos ~/old-projects --recursive
+```
+
+For detailed usage instructions, see [USAGE.md](docs/usage.md).
+
+
+## 📝 License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## 🤔 FAQ
+
+**Q: Can I recover deleted files?**
+A: No, files are permanently deleted. Always use `--dry-run` first!
+
+**Q: How are files selected?**
+A: Files are selected completely randomly using Python's `random.sample()`.
+
+**Q: Does it delete directories?**
+A: No, only files are affected. Empty directories may remain.
+
+**Q: What if I have an odd number of files?**
+A: If you have 11 files, 5 will be deleted (11 // 2 = 5) and 6 will remain.
+
+## 🙏 Acknowledgments
+
+- Built with [Typer](https://typer.tiangolo.com/) for the beautiful CLI
+- Tested with [pytest](https://pytest.org/)
+- Inspired by the Marvel Cinematic Universe
+
+---
+
+**Remember**: With great power comes great responsibility. Use Thanos wisely! 🫰

thanos_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+thanos_cli/__init__.py,sha256=Xfb862S5SHdhq99Rr1q0QttMX7lzihzb0fwmlIlPjlk,113
+thanos_cli/__main__.py,sha256=Qd-f8z2Q2vpiEP2x6PBFsJrpACWDVxFKQk820MhFmHo,59
+thanos_cli/cli.py,sha256=kQlB0qgdihtmrKb5ng_XCXgA31B2W9fUIorqVQo7Xkw,3566
+thanos_cli/utils.py,sha256=t6fk6T4RUTaQEsRtl1iwGk_E7T-TP_E3FvjMGq7r3bQ,531
+thanos_cli-0.1.0.dist-info/METADATA,sha256=CWz-qZLdnRFvNg13NbyRtrSVOhEJ8oPajbOv03ucmyY,4958
+thanos_cli-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+thanos_cli-0.1.0.dist-info/entry_points.txt,sha256=wjVOsPWiPvNmgcglWZHcq9_zOM5eZ1Szc7hX1lsyvW0,46
+thanos_cli-0.1.0.dist-info/licenses/LICENSE,sha256=nQEsw9GKmnfxl9MVlhvyAKzqtopAWSeV5daOAMPQTvw,1073
+thanos_cli-0.1.0.dist-info/RECORD,,

thanos_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

thanos_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+thanos = thanos_cli.cli:app

thanos_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025, Soldatov Serhii
+
+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.