procclean 1.2.0__tar.gz → 1.3.0__tar.gz

{procclean-1.2.0 → procclean-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: procclean
-Version: 1.2.0
+Version: 1.3.0
 Summary: Interactive TUI for exploring and cleaning up processes - find orphans, memory hogs, and kill them
 Keywords: cleanup,kill,memory,orphan,process,terminal,tui
 Author: Kaj Kowalski
@@ -26,7 +26,7 @@ Project-URL: Repository, https://github.com/kjanat/procclean
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="logo/procclean-transparent.svg" alt="procclean" width="500">
+  <img src="https://raw.github.com/kjanat/procclean/master/logo/procclean-transparent.svg" alt="procclean" width="500">
 </p>
 
 <p align="center">
@@ -34,8 +34,9 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
+  <a href="https://pypi.org/project/procclean/"><img src="https://img.shields.io/pypi/v/procclean" alt="PyPI"></a>
   <a href="https://github.com/kjanat/procclean/blob/master/LICENSE"><img src="https://img.shields.io/github/license/kjanat/procclean" alt="License"></a>
-  <a href="https://github.com/kjanat/procclean/releases"><img src="https://img.shields.io/github/v/release/kjanat/procclean" alt="Release"></a>
+  <a href="https://procclean.kjanat.com"><img src="https://img.shields.io/badge/docs-mkdocs-blue" alt="Docs"></a>
   <img src="https://img.shields.io/badge/python-3.14%2B-blue" alt="Python 3.14+">
   <img src="https://img.shields.io/badge/platform-linux-lightgrey" alt="Linux">
 </p>
@@ -54,13 +55,19 @@ Description-Content-Type: text/markdown
 ## Installation
 
 ```bash
-uv tool install git+https://github.com/kjanat/procclean
+pip install procclean
 ```
 
-Or run directly:
+Or with [uv](https://docs.astral.sh/uv/):
 
 ```bash
-uvx git+https://github.com/kjanat/procclean
+uv tool install procclean
+```
+
+Run without installing:
+
+```bash
+uvx procclean
 ```
 
 ## Usage

{procclean-1.2.0 → procclean-1.3.0}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="logo/procclean-transparent.svg" alt="procclean" width="500">
+  <img src="https://raw.github.com/kjanat/procclean/master/logo/procclean-transparent.svg" alt="procclean" width="500">
 </p>
 
 <p align="center">
@@ -7,8 +7,9 @@
 </p>
 
 <p align="center">
+  <a href="https://pypi.org/project/procclean/"><img src="https://img.shields.io/pypi/v/procclean" alt="PyPI"></a>
   <a href="https://github.com/kjanat/procclean/blob/master/LICENSE"><img src="https://img.shields.io/github/license/kjanat/procclean" alt="License"></a>
-  <a href="https://github.com/kjanat/procclean/releases"><img src="https://img.shields.io/github/v/release/kjanat/procclean" alt="Release"></a>
+  <a href="https://procclean.kjanat.com"><img src="https://img.shields.io/badge/docs-mkdocs-blue" alt="Docs"></a>
   <img src="https://img.shields.io/badge/python-3.14%2B-blue" alt="Python 3.14+">
   <img src="https://img.shields.io/badge/platform-linux-lightgrey" alt="Linux">
 </p>
@@ -27,13 +28,19 @@
 ## Installation
 
 ```bash
-uv tool install git+https://github.com/kjanat/procclean
+pip install procclean
 ```
 
-Or run directly:
+Or with [uv](https://docs.astral.sh/uv/):
 
 ```bash
-uvx git+https://github.com/kjanat/procclean
+uv tool install procclean
+```
+
+Run without installing:
+
+```bash
+uvx procclean
 ```
 
 ## Usage

{procclean-1.2.0 → procclean-1.3.0}/pyproject.toml

@@ -3,7 +3,7 @@
 
 [project]
 name = "procclean"
-version = "1.2.0"
+version = "1.3.0"
 description = "Interactive TUI for exploring and cleaning up processes - find orphans, memory hogs, and kill them"
 readme = "README.md"
 requires-python = ">=3.14"
@@ -41,6 +41,7 @@ dev = [
   "pre-commit>=4.5.1",
 ]
 lint = [
+  "dprint-py>=0.51.1.0",
   "pylint>=4.0.4",
   "ruff>=0.14.10",
   "tombi>=0.7.14",

{procclean-1.2.0 → procclean-1.3.0}/src/procclean/core/__init__.py

@@ -15,12 +15,19 @@ from .filters import (
     filter_high_memory,
     filter_killable,
     filter_orphans,
+    filter_stale,
     is_system_service,
     sort_processes,
 )
 from .memory import get_memory_summary
 from .models import ProcessInfo
-from .process import find_similar_processes, get_cwd, get_process_list, get_tmux_env
+from .process import (
+    find_similar_processes,
+    get_cwd,
+    get_process_list,
+    get_tmux_env,
+    is_exe_deleted,
+)
 
 __all__ = [
     "CONFIRM_PREVIEW_LIMIT",
@@ -35,11 +42,13 @@ __all__ = [
     "filter_high_memory",
     "filter_killable",
     "filter_orphans",
+    "filter_stale",
     "find_similar_processes",
     "get_cwd",
     "get_memory_summary",
     "get_process_list",
     "get_tmux_env",
+    "is_exe_deleted",
     "is_system_service",
     "kill_process",
     "kill_processes",

{procclean-1.2.0 → procclean-1.3.0}/src/procclean/core/filters.py

@@ -69,6 +69,21 @@ def filter_high_memory(
     return [p for p in procs if p.rss_mb > threshold_mb]
 
 
+def filter_stale(procs: list[ProcessInfo]) -> list[ProcessInfo]:
+    """Filter to processes with deleted/updated executables.
+
+    These are processes running outdated binaries after a package update.
+    Common on rolling release distros (Arch, Manjaro) after system updates.
+
+    Args:
+        procs: List of processes to filter.
+
+    Returns:
+        Processes whose executable has been deleted or replaced.
+    """
+    return [p for p in procs if p.exe_deleted]
+
+
 def filter_by_cwd(procs: list[ProcessInfo], cwd_path: str) -> list[ProcessInfo]:
     """Filter processes by current working directory.
 

{procclean-1.2.0 → procclean-1.3.0}/src/procclean/core/models.py

@@ -20,6 +20,7 @@ class ProcessInfo:
     is_orphan: bool
     in_tmux: bool
     status: str
+    exe_deleted: bool = False  # True if executable was deleted/updated
 
     @property
     def is_orphan_candidate(self) -> bool:

{procclean-1.2.0 → procclean-1.3.0}/src/procclean/core/process.py

@@ -44,6 +44,26 @@ def get_cwd(pid: int) -> str:
         return "?"
 
 
+def is_exe_deleted(pid: int) -> bool:
+    """Check if process executable has been deleted or updated.
+
+    This happens when a package is updated while the process is running.
+    The process continues with the old binary in memory, but the exe symlink
+    shows "(deleted)" suffix.
+
+    Args:
+        pid: Process ID.
+
+    Returns:
+        True if the executable file was deleted/updated, False otherwise.
+    """
+    try:
+        exe_link = Path(f"/proc/{pid}/exe").readlink()
+        return str(exe_link).endswith("(deleted)")
+    except (PermissionError, FileNotFoundError, ProcessLookupError):
+        return False
+
+
 def get_process_list(
     sort_by: str = "memory",
     filter_user: str | None = None,
@@ -93,19 +113,22 @@ def get_process_list(
             except (psutil.NoSuchProcess, psutil.AccessDenied):
                 parent_name = "?"
 
-            # Check if orphaned (parent is init/systemd)
-            is_orphan = ppid == 1 or parent_name in {"systemd", "init"}
+            # Check if orphaned (reparented to PID 1 system init)
+            # Note:
+            #   ppid != 1 with parent "systemd" means user session service, NOT orphan
+            is_orphan = ppid == 1
 
             cmdline = " ".join(info["cmdline"] or [])[:200]
             if not cmdline:
                 cmdline = info["name"]
 
+            pid = info["pid"]
             processes.append(
                 ProcessInfo(
-                    pid=info["pid"],
+                    pid=pid,
                     name=info["name"],
                     cmdline=cmdline,
-                    cwd=get_cwd(info["pid"]),
+                    cwd=get_cwd(pid),
                     ppid=ppid,
                     parent_name=parent_name,
                     rss_mb=rss_mb,
@@ -113,8 +136,9 @@ def get_process_list(
                     username=info["username"],
                     create_time=info["create_time"] or 0,
                     is_orphan=is_orphan,
-                    in_tmux=get_tmux_env(info["pid"]) if is_orphan else False,
+                    in_tmux=get_tmux_env(pid) if is_orphan else False,
                     status=info["status"] or "?",
+                    exe_deleted=is_exe_deleted(pid),
                 )
             )
         except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):

{procclean-1.2.0 → procclean-1.3.0}/src/procclean/tui/app.py

@@ -32,7 +32,7 @@ from procclean.core import (
 from .screens import ConfirmKillScreen
 
 # Type aliases
-ViewType = Literal["all", "orphans", "groups", "high-mem"]
+ViewType = Literal["all", "orphans", "stale", "groups", "high-mem"]
 SortKey = Literal["memory", "cpu", "pid", "name", "cwd"]
 
 
@@ -53,6 +53,7 @@ class ProcessCleanerApp(App):
         Binding("k", "kill_selected", "Kill"),
         Binding("K", "force_kill_selected", "Force Kill"),
         Binding("o", "show_orphans", "Orphans"),
+        Binding("t", "show_stale", "Stale"),
         Binding("a", "show_all", "All"),
         Binding("g", "show_groups", "Groups"),
         Binding("w", "filter_cwd", "Filter CWD"),
@@ -93,6 +94,7 @@ class ProcessCleanerApp(App):
                 yield OptionList(
                     Option("All Processes", id="view-all"),
                     Option("Orphaned", id="view-orphans"),
+                    Option("Stale (Updated)", id="view-stale"),
                     Option("Process Groups", id="view-groups"),
                     Option("High Memory (>500MB)", id="view-high-mem"),
                     id="view-selector",
@@ -184,6 +186,8 @@ class ProcessCleanerApp(App):
 
         if self.current_view == "orphans":
             procs = [p for p in self.processes if p.is_orphan]
+        elif self.current_view == "stale":
+            procs = [p for p in self.processes if p.exe_deleted]
         elif self.current_view == "high-mem":
             procs = [p for p in self.processes if p.rss_mb > HIGH_MEMORY_THRESHOLD_MB]
         elif self.current_view == "groups":
@@ -205,7 +209,8 @@ class ProcessCleanerApp(App):
             selected = "[X]" if proc.pid in self.selected_pids else "[ ]"
             orphan_marker = " [orphan]" if proc.is_orphan else ""
             tmux_marker = " [tmux]" if proc.in_tmux else ""
-            status = f"{proc.status}{orphan_marker}{tmux_marker}"
+            stale_marker = " [stale]" if proc.exe_deleted else ""
+            status = f"{proc.status}{orphan_marker}{tmux_marker}{stale_marker}"
 
             cwd = proc.cwd or "?"
             if len(cwd) > CWD_MAX_WIDTH:
@@ -240,6 +245,7 @@ class ProcessCleanerApp(App):
         view_map: dict[str, ViewType] = {
             "view-all": "all",
             "view-orphans": "orphans",
+            "view-stale": "stale",
             "view-groups": "groups",
             "view-high-mem": "high-mem",
         }
@@ -306,6 +312,10 @@ class ProcessCleanerApp(App):
         """Switch to orphans view."""
         self.current_view = "orphans"
 
+    def action_show_stale(self) -> None:
+        """Switch to stale processes view (deleted/updated executables)."""
+        self.current_view = "stale"
+
     def action_show_all(self) -> None:
         """Switch to all processes view."""
         self.current_view = "all"