procclean 1.2.0__py3-none-any.whl

procclean-1.2.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: procclean
+Version: 1.2.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
+Author-email: Kaj Kowalski <info@kajkowalski.nl>
+License-Expression: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Dist: psutil>=7.2.1
+Requires-Dist: tabulate>=0.9.0
+Requires-Dist: textual>=7.0.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://procclean.kjanat.com
+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">
+</p>
+
+<p align="center">
+  <em>Interactive TUI for exploring and cleaning up processes - find orphans, memory hogs, and kill them.</em>
+</p>
+
+<p align="center">
+  <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>
+  <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>
+
+## Features
+
+- **Memory overview** - Real-time total/used/free/swap display
+- **Multiple views** - All processes, Orphaned, Process Groups, High Memory
+  (>500MB)
+- **Orphan detection** - Finds processes whose parent died (PPID=1)
+- **Tmux awareness** - Won't flag tmux processes as orphan candidates
+- **Batch operations** - Select multiple processes and kill them at once
+- **Process grouping** - Find duplicate/similar processes consuming resources
+- **CLI mode** - Scriptable commands with JSON/CSV/Markdown output
+
+## Installation
+
+```bash
+uv tool install git+https://github.com/kjanat/procclean
+```
+
+Or run directly:
+
+```bash
+uvx git+https://github.com/kjanat/procclean
+```
+
+## Usage
+
+### TUI Mode (default)
+
+```bash
+procclean
+```
+
+### CLI Commands
+
+```bash
+procclean list                      # List processes (table)
+procclean list -f json|csv|md       # Different output formats
+procclean list -s mem|cpu|pid|name|cwd  # Sort by field
+procclean list -o                   # Orphans only
+procclean list -m                   # High memory only
+procclean list -k                   # Killable orphans only
+procclean list --cwd                # Filter by current directory
+procclean list --cwd /path/to/dir   # Filter by specific cwd
+
+procclean groups                    # Show process groups
+
+procclean kill <PID> [PID...]       # Kill process(es)
+procclean kill -f <PID>             # Force kill (SIGKILL)
+procclean kill --cwd /path -y       # Kill all in cwd (skip confirm)
+procclean kill -k -y                # Kill all killable orphans
+procclean kill -k --preview         # Preview what would be killed
+
+procclean mem                       # Show memory summary
+```
+
+## TUI Keybindings
+
+| Key     | Action                  |
+| ------- | ----------------------- |
+| `q`     | Quit                    |
+| `r`     | Refresh                 |
+| `k`     | Kill selected (SIGTERM) |
+| `K`     | Force kill (SIGKILL)    |
+| `o`     | Show orphans            |
+| `a`     | Show all                |
+| `g`     | Show groups             |
+| `w`     | Filter by selected cwd  |
+| `W`     | Clear cwd filter        |
+| `Space` | Toggle selection        |
+| `s`     | Select all visible      |
+| `c`     | Clear selection         |
+| `1`     | Sort by memory          |
+| `2`     | Sort by CPU             |
+| `3`     | Sort by PID             |
+| `4`     | Sort by name            |
+| `5`     | Sort by cwd             |
+| `!`     | Reverse sort order      |
+
+## Views
+
+- **All Processes** - All user processes sorted by memory usage
+- **Orphaned** - Processes with PPID=1 (parent died)
+- **Process Groups** - Similar processes grouped together
+- **High Memory** - Processes using >500MB RAM
+
+## Output Formats
+
+CLI supports multiple output formats via `-f`:
+
+- `table` - Human-readable table (default)
+- `json` - JSON array for scripting
+- `csv` - CSV for spreadsheets
+- `md` - Markdown table
+
+## Requirements
+
+- Python 3.14+
+- Linux (uses `/proc` filesystem)
+
+## Development
+
+```bash
+git clone https://github.com/kjanat/procclean
+cd procclean
+uv sync
+uv run pre-commit install
+```
+
+Run tests:
+
+```bash
+uv run pytest
+```
+
+## License
+
+[MIT][license]
+
+<!--link definitions-->
+
+[license]: https://github.com/kjanat/procclean/blob/master/LICENSE "MIT License"
+
+<!--markdownlint-disable-file MD033 MD041-->

procclean-1.2.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+procclean/__init__.py,sha256=YyRVnhYdw4MxUN8Udy1pstiFvk4a8Jmhddcqb7G1GEA,285
+procclean/__main__.py,sha256=pdGAWxkFy_Z_nNhidh9byADmjaeG-V9XYnAP4xB3lmY,484
+procclean/cli/__init__.py,sha256=I53tbb-1yS5UYDOYLjoPU7noWLpXQkCmM2lAsEGG7_w,508
+procclean/cli/commands.py,sha256=K39jPVDrbL7nB9DVM_g8XtFjlWtaxiOs9XPkb_uUplM,6273
+procclean/cli/docs.py,sha256=96WREAqXj8H58UTNiC0nhjcE9k-wGX1g1NZPGBWW7CQ,6914
+procclean/cli/parser.py,sha256=WSs1KuUVI1_oX6tQLqR_vk7rDd33i_14IVa3287RVTE,7288
+procclean/core/__init__.py,sha256=W0IRYS8YZ520BbF6ilJLsJAgdh8VuakZYZojVrI5OWA,1101
+procclean/core/actions.py,sha256=Nng-JH7V9siKESKCNHK0ry5FQdnva1Kuk0MLrA-rstQ,1355
+procclean/core/constants.py,sha256=FmK3AclNks7mfiEPc_ZVD5oicjV-4IkenL_QMtCWGUc,1153
+procclean/core/filters.py,sha256=-OdApU9-AImoaE4iSOr7Fvu3xYR7JiCUYniBhfvVCBY,3615
+procclean/core/memory.py,sha256=5gxklhSKuO2Lj8yE3kpLKEwrUI662vtt5upFtMWWICc,612
+procclean/core/models.py,sha256=W-yf8vqQmw9uPmmgeJUKgVEelFEP_vL4-BHHhtv6Pc8,543
+procclean/core/process.py,sha256=_N0NAKAJ-8cFqxtNyU-grOjhTMjB-rds_NTVRMbBy7g,4776
+procclean/formatters/__init__.py,sha256=mM_0CsmGSLRWVEas8em4V7sO-K5_jFh8saAYSSV2Zjc,543
+procclean/formatters/columns.py,sha256=0_31LHuBmAvfBeJhYnROEJWSQB_na1sFc9Y80PTb_Qk,3746
+procclean/formatters/output.py,sha256=S96aBExjaweiM5AZs_xElfNk2mbkI_H6fVevHUb8jOs,4219
+procclean/tui/__init__.py,sha256=42e6Okz0AFJcufor6JU2sdz6HLXe1F0t1vNyYoFzxQI,164
+procclean/tui/app.py,sha256=kB6K4upeHz_1xJbLm_Gk3eUdMAm09qfQ3_S-E8D4aJQ,14373
+procclean/tui/app.tcss,sha256=-NSXg36SElKI13SK1gODEtpCGUUA2VidDHFinM0nsME,1193
+procclean/tui/screens.py,sha256=-9qEnNh0vFBwbCiy-AGc6KHqiCcd4cVeCMwPuGwRyRU,2835
+procclean-1.2.0.dist-info/WHEEL,sha256=RRVLqVugUmFOqBedBFAmA4bsgFcROUBiSUKlERi0Hcg,79
+procclean-1.2.0.dist-info/entry_points.txt,sha256=DxGPdOkSb5p08m6jwChimklZbBs9ZksG9HRIi50cmzM,46
+procclean-1.2.0.dist-info/METADATA,sha256=07lgCDa7tr6iw6a0w6mvwPotWl4vazQ3MVEN9wK6ivg,5099
+procclean-1.2.0.dist-info/RECORD,,

procclean-1.2.0.dist-info/WHEEL

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

procclean-1.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+procclean = procclean:main
+