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 +21 -0
- zaibatsu-0.1.0/PKG-INFO +117 -0
- zaibatsu-0.1.0/README.md +77 -0
- zaibatsu-0.1.0/pyproject.toml +34 -0
- zaibatsu-0.1.0/setup.cfg +4 -0
- zaibatsu-0.1.0/zaibatsu/__init__.py +5 -0
- zaibatsu-0.1.0/zaibatsu/cli.py +544 -0
- zaibatsu-0.1.0/zaibatsu/config.py +95 -0
- zaibatsu-0.1.0/zaibatsu/input.py +204 -0
- zaibatsu-0.1.0/zaibatsu/monitor.py +334 -0
- zaibatsu-0.1.0/zaibatsu/renderer.py +1228 -0
- zaibatsu-0.1.0/zaibatsu.egg-info/PKG-INFO +117 -0
- zaibatsu-0.1.0/zaibatsu.egg-info/SOURCES.txt +15 -0
- zaibatsu-0.1.0/zaibatsu.egg-info/dependency_links.txt +1 -0
- zaibatsu-0.1.0/zaibatsu.egg-info/entry_points.txt +2 -0
- zaibatsu-0.1.0/zaibatsu.egg-info/requires.txt +2 -0
- zaibatsu-0.1.0/zaibatsu.egg-info/top_level.txt +1 -0
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.
|
zaibatsu-0.1.0/PKG-INFO
ADDED
|
@@ -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.
|
zaibatsu-0.1.0/README.md
ADDED
|
@@ -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*"]
|
zaibatsu-0.1.0/setup.cfg
ADDED