killpy 0.8.0__tar.gz

killpy-0.8.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.1
+Name: killpy
+Version: 0.8.0
+Summary: List all .venv directories and Conda environments 🐍 on your system and check how much space they are using. You can then choose which ones to delete in order to free up space 🧹.
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=13.9.4
+Requires-Dist: textual>=1.0.0
+
+<div align="center">
+
+</div>
+
+```plaintext
+█  ▄ ▄ █ █ ▄▄▄▄  ▄   ▄              ____
+█▄▀  ▄ █ █ █   █ █   █           .'`_ o `;__,
+█ ▀▄ █ █ █ █▄▄▄▀  ▀▀▀█ .       .'.'` '---'  '
+█  █ █ █ █ █     ▄   █  .`-...-'.'
+           ▀      ▀▀▀    `-...-' A tool to delete .venv directories and Conda envs
+```
+
+[![PyPI](https://img.shields.io/pypi/v/killpy.svg)](https://pypi.org/project/killpy/)
+[![Downloads](https://static.pepy.tech/personalized-badge/killpy?period=month&units=international_system&left_color=grey&right_color=blue&left_text=PyPi%20Downloads)](https://pepy.tech/project/killpy)
+[![Stars](https://img.shields.io/github/stars/Tlaloc-Es/killpy?color=yellow&style=flat)](https://github.com/Tlaloc-Es/killpy/stargazers)
+
+<div align="center">
+
+![killpy in action](show.gif)
+
+</div>
+
+# Delete .venv Directories
+
+`killpy` is a simple tool designed to locate and delete `.venv` directories from your projects (and Conda envs too). It can help you quickly clean up unnecessary virtual environments and save disk space.
+
+## Features
+
+- **Automatic search:** Finds all .venv directories and any folders containing a pyvenv.cfg file recursively from the current working directory, as they are considered virtual environment folders.
+- **Support for Conda**: Lists all available Conda environments.
+- **Safe deletion:** Lists the directories to be deleted and asks for confirmation.
+- **Fast and lightweight:** Minimal dependencies for quick execution.
+
+## Installation
+
+To install `killpy`, use pip:
+
+```bash
+pip install killpy
+```
+
+## Usage
+
+Run the following command to search for .venv directories and any folders containing a pyvenv.cfg file, as well as to list all Conda environments from the current directory and all its subdirectories recursively:
+
+```bash
+killpy
+```
+
+Or
+
+```bash
+pipx run --spec killpy killpy
+```
+
+- To **close the application**, press `Ctrl+Q`.
+- To **mark a virtual environment for deletion**, press `D`.
+- To **confirm deletion of marked virtual environments**, press `Ctrl+D`.
+- To **delete a virtual environment immediately**, press `Shift+Delete`.
+
+## Roadmap
+
+- [ ] Delete `__pycache__` Files
+- [ ] Remove `dist` Folders and Build Artifacts
+- [ ] Clean Up Installed Package Cache
+- [ ] Delete `.egg-info` and `.dist-info` Files
+- [ ] Analyze and Remove Unused Dependencies
+- [ ] Optimize Disk Space in Python Projects
+
+## Contributing
+
+Contributions are welcome! If you'd like to improve this tool, feel free to fork the repository and submit a pull request.
+
+1. Fork the repository
+1. Create a new branch for your feature: `git checkout -b my-feature`
+1. Commit your changes: `git commit -m 'Add my feature'`
+1. Push to the branch: `git push origin my-feature`
+1. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+______________________________________________________________________
+
+Thank you for using `killpy`! If you find it useful, please star the repository on GitHub!

killpy-0.8.0/README.md

@@ -0,0 +1,86 @@
+<div align="center">
+
+</div>
+
+```plaintext
+█  ▄ ▄ █ █ ▄▄▄▄  ▄   ▄              ____
+█▄▀  ▄ █ █ █   █ █   █           .'`_ o `;__,
+█ ▀▄ █ █ █ █▄▄▄▀  ▀▀▀█ .       .'.'` '---'  '
+█  █ █ █ █ █     ▄   █  .`-...-'.'
+           ▀      ▀▀▀    `-...-' A tool to delete .venv directories and Conda envs
+```
+
+[![PyPI](https://img.shields.io/pypi/v/killpy.svg)](https://pypi.org/project/killpy/)
+[![Downloads](https://static.pepy.tech/personalized-badge/killpy?period=month&units=international_system&left_color=grey&right_color=blue&left_text=PyPi%20Downloads)](https://pepy.tech/project/killpy)
+[![Stars](https://img.shields.io/github/stars/Tlaloc-Es/killpy?color=yellow&style=flat)](https://github.com/Tlaloc-Es/killpy/stargazers)
+
+<div align="center">
+
+![killpy in action](show.gif)
+
+</div>
+
+# Delete .venv Directories
+
+`killpy` is a simple tool designed to locate and delete `.venv` directories from your projects (and Conda envs too). It can help you quickly clean up unnecessary virtual environments and save disk space.
+
+## Features
+
+- **Automatic search:** Finds all .venv directories and any folders containing a pyvenv.cfg file recursively from the current working directory, as they are considered virtual environment folders.
+- **Support for Conda**: Lists all available Conda environments.
+- **Safe deletion:** Lists the directories to be deleted and asks for confirmation.
+- **Fast and lightweight:** Minimal dependencies for quick execution.
+
+## Installation
+
+To install `killpy`, use pip:
+
+```bash
+pip install killpy
+```
+
+## Usage
+
+Run the following command to search for .venv directories and any folders containing a pyvenv.cfg file, as well as to list all Conda environments from the current directory and all its subdirectories recursively:
+
+```bash
+killpy
+```
+
+Or
+
+```bash
+pipx run --spec killpy killpy
+```
+
+- To **close the application**, press `Ctrl+Q`.
+- To **mark a virtual environment for deletion**, press `D`.
+- To **confirm deletion of marked virtual environments**, press `Ctrl+D`.
+- To **delete a virtual environment immediately**, press `Shift+Delete`.
+
+## Roadmap
+
+- [ ] Delete `__pycache__` Files
+- [ ] Remove `dist` Folders and Build Artifacts
+- [ ] Clean Up Installed Package Cache
+- [ ] Delete `.egg-info` and `.dist-info` Files
+- [ ] Analyze and Remove Unused Dependencies
+- [ ] Optimize Disk Space in Python Projects
+
+## Contributing
+
+Contributions are welcome! If you'd like to improve this tool, feel free to fork the repository and submit a pull request.
+
+1. Fork the repository
+1. Create a new branch for your feature: `git checkout -b my-feature`
+1. Commit your changes: `git commit -m 'Add my feature'`
+1. Push to the branch: `git push origin my-feature`
+1. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+______________________________________________________________________
+
+Thank you for using `killpy`! If you find it useful, please star the repository on GitHub!

killpy-0.8.0/killpy/__main__.py

@@ -0,0 +1,165 @@
+import asyncio
+import shutil
+from enum import Enum
+from pathlib import Path
+
+from envs_handler import (
+    find_venvs,
+    find_venvs_with_pyvenv,
+    format_size,
+    list_conda_environments,
+    remove_conda_env,
+    remove_duplicates,
+)
+from textual.app import App, ComposeResult
+from textual.binding import Binding
+from textual.coordinate import Coordinate
+from textual.widgets import DataTable, Footer, Header, Label, Static
+
+
+class EnvStatus(Enum):
+    DELETED = "DELETED"
+    MARKED_TO_DELETE = "MARKED TO DELETE"
+
+
+class TableApp(App):
+    deleted_cells: Coordinate = []
+    bytes_release: int = 0
+
+    BINDINGS = [
+        Binding(key="ctrl+q", action="quit", description="Quit the app"),
+        Binding(
+            key="d",
+            action="mark_for_delete",
+            description="Mark .venv for deletion",
+            show=True,
+        ),
+        Binding(
+            key="ctrl+d",
+            action="confirm_delete",
+            description="Confirm deletion of marked .venv",
+            show=True,
+        ),
+        Binding(
+            key="shift+delete",
+            action="delete_now",
+            description="Delete the selected .venv immediately",
+            show=True,
+        ),
+    ]
+
+    CSS = """
+    #banner {
+        color: white;
+        border: heavy green;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        yield Header()
+        banner = Static(
+            """
+█  ▄ ▄ █ █ ▄▄▄▄  ▄   ▄              ____
+█▄▀  ▄ █ █ █   █ █   █           .'`_ o `;__,
+█ ▀▄ █ █ █ █▄▄▄▀  ▀▀▀█ .       .'.'` '---'  '
+█  █ █ █ █ █     ▄   █  .`-...-'.'
+           ▀      ▀▀▀    `-...-' A tool to delete .venv directories and Conda envs
+        """,
+            id="banner",
+        )
+        yield banner
+        yield Label("Searching for virtual environments...")
+        yield DataTable()
+        yield Footer()
+
+    async def on_mount(self) -> None:
+        self.title = """killpy"""
+        await self.find_venvs()
+
+    async def find_venvs(self):
+        current_directory = Path.cwd()
+
+        venvs = await asyncio.gather(
+            asyncio.to_thread(find_venvs, current_directory),
+            asyncio.to_thread(list_conda_environments),
+            asyncio.to_thread(find_venvs_with_pyvenv, current_directory),
+        )
+        venvs = [env for sublist in venvs for env in sublist]
+        venvs = remove_duplicates(venvs)
+
+        table = self.query_one(DataTable)
+        table.focus()
+        table.add_columns(
+            "Path", "Type", "Last Modified", "Size", "Size (Human Readable)", "Status"
+        )
+
+        for venv in venvs:
+            table.add_row(*venv)
+
+        table.cursor_type = "row"
+        table.zebra_stripes = True
+
+        self.query_one(Label).update(f"Found {len(venvs)} .venv directories")
+
+    def action_confirm_delete(self):
+        table = self.query_one(DataTable)
+        for row_index in range(table.row_count):
+            row_data = table.get_row_at(row_index)
+            current_status = row_data[5]
+            if current_status == EnvStatus.MARKED_TO_DELETE.value:
+                cursor_cell = Coordinate(row_index, 0)
+                if cursor_cell not in self.deleted_cells:
+                    path = row_data[0]
+                    self.bytes_release += row_data[3]
+                    env_type = row_data[1]
+                    self.delete_environment(path, env_type)
+                    table.update_cell_at((row_index, 5), EnvStatus.DELETED.value)
+                    self.deleted_cells.append(cursor_cell)
+        self.query_one(Label).update(f"{format_size(self.bytes_release)} deleted")
+        self.bell()
+
+    def action_mark_for_delete(self):
+        table = self.query_one(DataTable)
+        cursor_cell = table.cursor_coordinate
+        if cursor_cell:
+            row_data = table.get_row_at(cursor_cell.row)
+            current_status = row_data[5]
+            if current_status == EnvStatus.DELETED.value:
+                return
+            elif current_status == EnvStatus.MARKED_TO_DELETE.value:
+                table.update_cell_at((cursor_cell.row, 5), "")
+            else:
+                table.update_cell_at(
+                    (cursor_cell.row, 5), EnvStatus.MARKED_TO_DELETE.value
+                )
+
+    def action_delete_now(self):
+        table = self.query_one(DataTable)
+        cursor_cell = table.cursor_coordinate
+        if cursor_cell:
+            if cursor_cell in self.deleted_cells:
+                return
+            row_data = table.get_row_at(cursor_cell.row)
+            path = row_data[0]
+            self.bytes_release += row_data[3]
+            env_type = row_data[1]
+            self.delete_environment(path, env_type)
+            table.update_cell_at((cursor_cell.row, 5), EnvStatus.DELETED.value)
+            self.query_one(Label).update(f"{format_size(self.bytes_release)} deleted")
+            self.deleted_cells.append(cursor_cell)
+        self.bell()
+
+    def delete_environment(self, path, env_type):
+        if env_type in {".venv", "pyvenv.cfg"}:
+            shutil.rmtree(path)
+        else:
+            remove_conda_env(path)
+
+
+def main():
+    app = TableApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

killpy-0.8.0/killpy/envs_handler.py

@@ -0,0 +1,110 @@
+import subprocess
+from datetime import datetime
+from pathlib import Path
+
+
+def remove_duplicates(venvs):
+    seen_paths = set()
+    unique_venvs = []
+
+    for venv in venvs:
+        venv_path = venv[0]
+        if venv_path not in seen_paths:
+            unique_venvs.append(venv)
+            seen_paths.add(venv_path)
+
+    return unique_venvs
+
+
+def get_total_size(path: Path) -> int:
+    total_size = sum(f.stat().st_size for f in path.rglob("*") if f.is_file())
+    return total_size
+
+
+def format_size(size_in_bytes: int):
+    if size_in_bytes >= 1 << 30:
+        return f"{size_in_bytes / (1 << 30):.2f} GB"
+    elif size_in_bytes >= 1 << 20:
+        return f"{size_in_bytes / (1 << 20):.2f} MB"
+    elif size_in_bytes >= 1 << 10:
+        return f"{size_in_bytes / (1 << 10):.2f} KB"
+    else:
+        return f"{size_in_bytes} bytes"
+
+
+def find_venvs(base_directory: Path):
+    venvs = []
+    for dir_path in base_directory.rglob(".venv"):
+        last_modified_timestamp = dir_path.stat().st_mtime
+        last_modified = datetime.fromtimestamp(last_modified_timestamp).strftime(
+            "%d/%m/%Y"
+        )
+        size = get_total_size(dir_path)
+        size_to_show = format_size(size)
+        venvs.append((dir_path, ".venv", last_modified, size, size_to_show))
+        venvs.sort(key=lambda x: x[2], reverse=True)
+
+    return venvs
+
+
+def find_venvs_with_pyvenv(base_directory: Path):
+    venvs = []
+    for dir_path in base_directory.rglob("pyvenv.cfg"):
+        venv_dir = dir_path.parent
+        last_modified_timestamp = dir_path.stat().st_mtime
+        last_modified = datetime.fromtimestamp(last_modified_timestamp).strftime(
+            "%d/%m/%Y"
+        )
+        size = get_total_size(venv_dir)
+        size_to_show = format_size(size)
+        venvs.append((venv_dir, "pyvenv.cfg", last_modified, size, size_to_show))
+
+    venvs.sort(key=lambda x: x[2], reverse=True)
+    return venvs
+
+
+def remove_conda_env(env_name):
+    try:
+        subprocess.run(
+            ["conda", "env", "remove", "-n", env_name],
+            check=True,
+        )
+    except subprocess.CalledProcessError as e:
+        print(f"Error: {e}")
+
+
+def list_conda_environments():
+    try:
+        result = subprocess.run(
+            ["conda", "env", "list"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+
+        venvs = []
+        for line in result.stdout.splitlines():
+            if line.strip() and not line.startswith("#"):
+                env_info = line.strip().split()
+                env_name = env_info[0]
+
+                if "*" in env_info:
+                    continue
+
+                dir_path = Path(env_info[1])
+                last_modified_timestamp = dir_path.stat().st_mtime
+                last_modified = datetime.fromtimestamp(
+                    last_modified_timestamp
+                ).strftime("%d/%m/%Y")
+
+                size = get_total_size(dir_path)
+                size_to_show = format_size(size)
+                venvs.append((env_name, "Conda", last_modified, size, size_to_show))
+
+        venvs.sort(key=lambda x: x[3], reverse=True)
+        return venvs
+
+    except subprocess.CalledProcessError:
+        return []
+    except Exception:
+        return []

killpy-0.8.0/killpy.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.1
+Name: killpy
+Version: 0.8.0
+Summary: List all .venv directories and Conda environments 🐍 on your system and check how much space they are using. You can then choose which ones to delete in order to free up space 🧹.
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=13.9.4
+Requires-Dist: textual>=1.0.0
+
+<div align="center">
+
+</div>
+
+```plaintext
+█  ▄ ▄ █ █ ▄▄▄▄  ▄   ▄              ____
+█▄▀  ▄ █ █ █   █ █   █           .'`_ o `;__,
+█ ▀▄ █ █ █ █▄▄▄▀  ▀▀▀█ .       .'.'` '---'  '
+█  █ █ █ █ █     ▄   █  .`-...-'.'
+           ▀      ▀▀▀    `-...-' A tool to delete .venv directories and Conda envs
+```
+
+[![PyPI](https://img.shields.io/pypi/v/killpy.svg)](https://pypi.org/project/killpy/)
+[![Downloads](https://static.pepy.tech/personalized-badge/killpy?period=month&units=international_system&left_color=grey&right_color=blue&left_text=PyPi%20Downloads)](https://pepy.tech/project/killpy)
+[![Stars](https://img.shields.io/github/stars/Tlaloc-Es/killpy?color=yellow&style=flat)](https://github.com/Tlaloc-Es/killpy/stargazers)
+
+<div align="center">
+
+![killpy in action](show.gif)
+
+</div>
+
+# Delete .venv Directories
+
+`killpy` is a simple tool designed to locate and delete `.venv` directories from your projects (and Conda envs too). It can help you quickly clean up unnecessary virtual environments and save disk space.
+
+## Features
+
+- **Automatic search:** Finds all .venv directories and any folders containing a pyvenv.cfg file recursively from the current working directory, as they are considered virtual environment folders.
+- **Support for Conda**: Lists all available Conda environments.
+- **Safe deletion:** Lists the directories to be deleted and asks for confirmation.
+- **Fast and lightweight:** Minimal dependencies for quick execution.
+
+## Installation
+
+To install `killpy`, use pip:
+
+```bash
+pip install killpy
+```
+
+## Usage
+
+Run the following command to search for .venv directories and any folders containing a pyvenv.cfg file, as well as to list all Conda environments from the current directory and all its subdirectories recursively:
+
+```bash
+killpy
+```
+
+Or
+
+```bash
+pipx run --spec killpy killpy
+```
+
+- To **close the application**, press `Ctrl+Q`.
+- To **mark a virtual environment for deletion**, press `D`.
+- To **confirm deletion of marked virtual environments**, press `Ctrl+D`.
+- To **delete a virtual environment immediately**, press `Shift+Delete`.
+
+## Roadmap
+
+- [ ] Delete `__pycache__` Files
+- [ ] Remove `dist` Folders and Build Artifacts
+- [ ] Clean Up Installed Package Cache
+- [ ] Delete `.egg-info` and `.dist-info` Files
+- [ ] Analyze and Remove Unused Dependencies
+- [ ] Optimize Disk Space in Python Projects
+
+## Contributing
+
+Contributions are welcome! If you'd like to improve this tool, feel free to fork the repository and submit a pull request.
+
+1. Fork the repository
+1. Create a new branch for your feature: `git checkout -b my-feature`
+1. Commit your changes: `git commit -m 'Add my feature'`
+1. Push to the branch: `git push origin my-feature`
+1. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+______________________________________________________________________
+
+Thank you for using `killpy`! If you find it useful, please star the repository on GitHub!

killpy-0.8.0/killpy.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+killpy/__init__.py
+killpy/__main__.py
+killpy/envs_handler.py
+killpy.egg-info/PKG-INFO
+killpy.egg-info/SOURCES.txt
+killpy.egg-info/dependency_links.txt
+killpy.egg-info/entry_points.txt
+killpy.egg-info/requires.txt
+killpy.egg-info/top_level.txt

killpy-0.8.0/killpy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

killpy-0.8.0/killpy.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+killpy = killpy.__main__:main

killpy-0.8.0/killpy.egg-info/requires.txt

@@ -0,0 +1,2 @@
+rich>=13.9.4
+textual>=1.0.0

killpy-0.8.0/killpy.egg-info/top_level.txt

@@ -0,0 +1 @@
+killpy

killpy-0.8.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "killpy"
+version = "0.8.0"
+description = "List all .venv directories and Conda environments 🐍 on your system and check how much space they are using. You can then choose which ones to delete in order to free up space 🧹."
+readme = "README.md"
+classifiers = [
+  "Environment :: Console",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3.12"
+]
+dependencies = [
+    "rich>=13.9.4",
+    "textual>=1.0.0",
+]
+
+[tool.setuptools]
+license-files = []
+
+[dependency-groups]
+dev = [
+    "commitizen>=4.1.0",
+    "coverage>=7.6.10",
+    "mypy>=1.14.0",
+    "pre-commit>=4.0.1",
+    "pytest>=8.3.4",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.8.4",
+]
+
+
+[tool.uv.workspace]
+members = ["q"]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "0.8.0"
+version_files = [
+    "src/__version__.py",
+    "pyproject.toml:version"
+]
+
+[project.scripts]
+killpy = "killpy.__main__:main"

killpy-0.8.0/setup.cfg

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