zaibatsu 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
zaibatsu-0.1.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Zaibatsu Contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,117 @@
1
+ Metadata-Version: 2.4
2
+ Name: zaibatsu
3
+ Version: 0.1.0
4
+ Summary: A cyberpunk-themed terminal 3D cityscape process monitor
5
+ Author: Zaibatsu Developers
6
+ License: MIT License
7
+
8
+ Copyright (c) 2026 Zaibatsu Contributors
9
+
10
+ Permission is hereby granted, free of charge, to any person obtaining a copy
11
+ of this software and associated documentation files (the "Software"), to deal
12
+ in the Software without restriction, including without limitation the rights
13
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
+ copies of the Software, and to permit persons to whom the Software is
15
+ furnished to do so, subject to the following conditions:
16
+
17
+ The above copyright notice and this permission notice shall be included in all
18
+ copies or substantial portions of the Software.
19
+
20
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26
+ SOFTWARE.
27
+
28
+ Project-URL: Homepage, https://github.com/DIIZZYFPS/Zaibatsu
29
+ Classifier: Programming Language :: Python :: 3
30
+ Classifier: License :: OSI Approved :: MIT License
31
+ Classifier: Operating System :: OS Independent
32
+ Classifier: Environment :: Console
33
+ Classifier: Topic :: System :: Monitoring
34
+ Requires-Python: >=3.8
35
+ Description-Content-Type: text/markdown
36
+ License-File: LICENSE
37
+ Requires-Dist: psutil>=5.9.0
38
+ Requires-Dist: rich>=13.0.0
39
+ Dynamic: license-file
40
+
41
+ # 🌆 Zaibatsu Cityscape Process Monitor
42
+
43
+ Zaibatsu is an interactive, retro-cyberpunk terminal-based process monitor that represents running system processes as a living city skyline. The height, density, and animation of the buildings directly reflect how active and full your computer is.
44
+
45
+ ---
46
+
47
+ ## 🎨 Visual Features
48
+
49
+ - **The Skyline (Processes)**: Each building represents a running process.
50
+ - **Height**: Proportional to the resource usage of the process (CPU % or Memory RSS).
51
+ - **Windows**: The density of lit windows and their blinking speed represent real-time CPU usage.
52
+ - **Top Chimneys**: Processes with high Disk I/O activity will release smoke or steam particles rising from their roofs.
53
+ - **Neon Signs**: The names of the processes are printed vertically down the center of the buildings.
54
+ - **The Sky (System Load)**:
55
+ - **Stars**: Twinkle dynamically.
56
+ - **Moon**: Displays phases (Crescent, Half, Gibbous, Full) and warning colors based on overall RAM consumption.
57
+ - **Clouds**: Scroll horizontally with speeds mapped to background activity.
58
+ - **Lightning**: Flashes across the sky when system-wide CPU load exceeds 80%.
59
+ - **The Street (I/O Traffic)**:
60
+ - Cars drive across the bottom lanes of the city.
61
+ - Car spawn rate and driving speed are mapped to overall Disk Read/Write and Network speeds.
62
+ - **The Dashboard (TUI Control Panel)**:
63
+ - Shows real-time CPU and RAM progress bars.
64
+ - Displays Disk and Network speeds in B/s, KB/s, or MB/s.
65
+ - Displays full detail statistics of the currently highlighted building/process.
66
+ - Displays a terminal text filter/search bar.
67
+
68
+ ---
69
+
70
+ ## 🎮 Keyboard Controls
71
+
72
+ | Key | Action |
73
+ | --- | --- |
74
+ | `←` / `→` / `↑` / `↓` or `W` / `A` / `S` / `D` | Target/Highlight a building in the 2D grid |
75
+ | `C` | Sort city buildings by **CPU usage** |
76
+ | `M` | Sort city buildings by **Memory usage** |
77
+ | `F` | Open process name filter (type query, press `Enter` to apply, `Esc` to cancel) |
78
+ | `Space` | Pause / Resume real-time metrics updates (city animations stay active) |
79
+ | `K` / `Delete` | **Demolish Building** — terminates the selected process with an explosion and collapse animation! |
80
+ | `Q` / `Esc` | Shutdown Zaibatsu monitor |
81
+
82
+ ---
83
+
84
+ ## 🚀 Setup & Launch
85
+
86
+ Zaibatsu runs on Windows (using Python's native `msvcrt` for keyboard polling) and requires a terminal that supports Unicode box characters and ANSI colors (e.g. Windows Terminal, VS Code, PowerShell, command prompt).
87
+
88
+ ### 1. Setup Virtual Environment
89
+ Initialize a Python virtual environment and install dependencies:
90
+ ```powershell
91
+ py -m venv venv
92
+ venv\Scripts\activate
93
+ pip install -r requirements.txt
94
+ ```
95
+
96
+ ### 2. Run Zaibatsu
97
+ Run the launcher:
98
+ ```powershell
99
+ python run.py
100
+ ```
101
+
102
+ ### 3. Customize Options
103
+ You can configure themes (`cyberpunk`, `matrix`, `sunset`) and refresh rates:
104
+ ```powershell
105
+ python run.py --theme matrix --interval 0.2
106
+ ```
107
+
108
+ ---
109
+
110
+ ## 🛠️ Project Structure
111
+
112
+ - [run.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/run.py): CLI launcher script.
113
+ - [zaibatsu/cli.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/cli.py): Main terminal screen layout controller.
114
+ - [zaibatsu/renderer.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/renderer.py): Cityscape layout drawing logic and animations.
115
+ - [zaibatsu/monitor.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/monitor.py): System and process stats gathering using `psutil`.
116
+ - [zaibatsu/input.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/input.py): Non-blocking keyboard event listening queue.
117
+ - [zaibatsu/config.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/config.py): Theme declarations and scaling parameters.
@@ -0,0 +1,77 @@
1
+ # 🌆 Zaibatsu Cityscape Process Monitor
2
+
3
+ Zaibatsu is an interactive, retro-cyberpunk terminal-based process monitor that represents running system processes as a living city skyline. The height, density, and animation of the buildings directly reflect how active and full your computer is.
4
+
5
+ ---
6
+
7
+ ## 🎨 Visual Features
8
+
9
+ - **The Skyline (Processes)**: Each building represents a running process.
10
+ - **Height**: Proportional to the resource usage of the process (CPU % or Memory RSS).
11
+ - **Windows**: The density of lit windows and their blinking speed represent real-time CPU usage.
12
+ - **Top Chimneys**: Processes with high Disk I/O activity will release smoke or steam particles rising from their roofs.
13
+ - **Neon Signs**: The names of the processes are printed vertically down the center of the buildings.
14
+ - **The Sky (System Load)**:
15
+ - **Stars**: Twinkle dynamically.
16
+ - **Moon**: Displays phases (Crescent, Half, Gibbous, Full) and warning colors based on overall RAM consumption.
17
+ - **Clouds**: Scroll horizontally with speeds mapped to background activity.
18
+ - **Lightning**: Flashes across the sky when system-wide CPU load exceeds 80%.
19
+ - **The Street (I/O Traffic)**:
20
+ - Cars drive across the bottom lanes of the city.
21
+ - Car spawn rate and driving speed are mapped to overall Disk Read/Write and Network speeds.
22
+ - **The Dashboard (TUI Control Panel)**:
23
+ - Shows real-time CPU and RAM progress bars.
24
+ - Displays Disk and Network speeds in B/s, KB/s, or MB/s.
25
+ - Displays full detail statistics of the currently highlighted building/process.
26
+ - Displays a terminal text filter/search bar.
27
+
28
+ ---
29
+
30
+ ## 🎮 Keyboard Controls
31
+
32
+ | Key | Action |
33
+ | --- | --- |
34
+ | `←` / `→` / `↑` / `↓` or `W` / `A` / `S` / `D` | Target/Highlight a building in the 2D grid |
35
+ | `C` | Sort city buildings by **CPU usage** |
36
+ | `M` | Sort city buildings by **Memory usage** |
37
+ | `F` | Open process name filter (type query, press `Enter` to apply, `Esc` to cancel) |
38
+ | `Space` | Pause / Resume real-time metrics updates (city animations stay active) |
39
+ | `K` / `Delete` | **Demolish Building** — terminates the selected process with an explosion and collapse animation! |
40
+ | `Q` / `Esc` | Shutdown Zaibatsu monitor |
41
+
42
+ ---
43
+
44
+ ## 🚀 Setup & Launch
45
+
46
+ Zaibatsu runs on Windows (using Python's native `msvcrt` for keyboard polling) and requires a terminal that supports Unicode box characters and ANSI colors (e.g. Windows Terminal, VS Code, PowerShell, command prompt).
47
+
48
+ ### 1. Setup Virtual Environment
49
+ Initialize a Python virtual environment and install dependencies:
50
+ ```powershell
51
+ py -m venv venv
52
+ venv\Scripts\activate
53
+ pip install -r requirements.txt
54
+ ```
55
+
56
+ ### 2. Run Zaibatsu
57
+ Run the launcher:
58
+ ```powershell
59
+ python run.py
60
+ ```
61
+
62
+ ### 3. Customize Options
63
+ You can configure themes (`cyberpunk`, `matrix`, `sunset`) and refresh rates:
64
+ ```powershell
65
+ python run.py --theme matrix --interval 0.2
66
+ ```
67
+
68
+ ---
69
+
70
+ ## 🛠️ Project Structure
71
+
72
+ - [run.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/run.py): CLI launcher script.
73
+ - [zaibatsu/cli.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/cli.py): Main terminal screen layout controller.
74
+ - [zaibatsu/renderer.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/renderer.py): Cityscape layout drawing logic and animations.
75
+ - [zaibatsu/monitor.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/monitor.py): System and process stats gathering using `psutil`.
76
+ - [zaibatsu/input.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/input.py): Non-blocking keyboard event listening queue.
77
+ - [zaibatsu/config.py](file:///c:/Users/DIIZZY/Documents/Code/Light%20Projects/Zaibatsu/zaibatsu/config.py): Theme declarations and scaling parameters.
@@ -0,0 +1,34 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "zaibatsu"
7
+ version = "0.1.0"
8
+ description = "A cyberpunk-themed terminal 3D cityscape process monitor"
9
+ readme = "README.md"
10
+ authors = [
11
+ { name = "Zaibatsu Developers" }
12
+ ]
13
+ license = { file = "LICENSE" }
14
+ classifiers = [
15
+ "Programming Language :: Python :: 3",
16
+ "License :: OSI Approved :: MIT License",
17
+ "Operating System :: OS Independent",
18
+ "Environment :: Console",
19
+ "Topic :: System :: Monitoring",
20
+ ]
21
+ requires-python = ">=3.8"
22
+ dependencies = [
23
+ "psutil>=5.9.0",
24
+ "rich>=13.0.0"
25
+ ]
26
+
27
+ [project.urls]
28
+ Homepage = "https://github.com/DIIZZYFPS/Zaibatsu"
29
+
30
+ [project.scripts]
31
+ zaibatsu = "zaibatsu.cli:main"
32
+
33
+ [tool.setuptools.packages.find]
34
+ include = ["zaibatsu*"]
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,5 @@
1
+ """
2
+ Zaibatsu - Interactive TUI Process Monitor
3
+ """
4
+
5
+ __version__ = "1.0.0"