netshow 0.1.2__tar.gz → 0.2.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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: netshow
3
- Version: 0.1.2
3
+ Version: 0.2.0
4
4
  Summary: A real-time network connection monitor with friendly service names
5
5
  Author: Taylor Wilsdon
6
6
  License: MIT
@@ -50,6 +50,15 @@ Description-Content-Type: text/markdown
50
50
 
51
51
  ---
52
52
 
53
+ ### A quick plug for AI-Enhanced Docs
54
+
55
+ > **This README was crafted with AI assistance, and here's why that matters**
56
+ >
57
+ > As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. Using agentic dev tools like **Roo** & **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
58
+ >
59
+ > In this case, Sonnet 4 took a pass & a human (me) verified them 6/28/25.
60
+
61
+
53
62
  ## ✨ **Features**
54
63
 
55
64
  <table style="width: 100%; border-collapse: collapse;">
@@ -74,6 +83,18 @@ Description-Content-Type: text/markdown
74
83
  <td>Uses <code>psutil</code> (root) for full fidelity, falls back to <code>lsof</code> if run as a regular user</td>
75
84
  </tr>
76
85
  <tr>
86
+ <td style="font-weight: bold;">📊 Real-time metrics</td>
87
+ <td>Live connection counts, bandwidth monitoring with per-interface selection</td>
88
+ </tr>
89
+ <tr>
90
+ <td style="font-weight: bold;">🔍 Advanced filtering</td>
91
+ <td>Regex-powered search with live filtering across all connection fields</td>
92
+ </tr>
93
+ <tr>
94
+ <td style="font-weight: bold;">🔄 Smart sorting</td>
95
+ <td>Sort by status or process name with optimized rendering for large datasets</td>
96
+ </tr>
97
+ <tr>
77
98
  <td style="font-weight: bold;">🎨 Modern Textual UI</td>
78
99
  <td>Smooth scrolling, dark theme, status bar with connection count & data source</td>
79
100
  </tr>
@@ -120,6 +141,33 @@ netshow [--interval 1.0] [--no-colors]
120
141
  | **↵ / Click** | Open detail view |
121
142
  | **Esc / ←** | Back to list |
122
143
  | **q** | Quit NetShow |
144
+ | **Ctrl+C** | Force quit (hard quit) |
145
+ | **Ctrl+R** | Force refresh |
146
+ | **f** | Toggle filter input |
147
+ | **/** | Quick search (focus filter) |
148
+ | **s** | Sort by connection status |
149
+ | **p** | Sort by process name |
150
+ | **i** | Cycle network interface for bandwidth monitoring |
151
+
152
+ ### **Advanced Features**
153
+
154
+ **🔍 Filtering & Search**
155
+ - Press `f` or `/` to open the filter input
156
+ - Supports regex patterns for advanced matching
157
+ - Filters across process names, addresses, and connection status
158
+ - Live updates as you type (with debouncing)
159
+
160
+ **📊 Bandwidth Monitoring**
161
+ - Real-time bandwidth display in the metrics bar
162
+ - Press `i` to cycle through network interfaces (`all`, `eth0`, `wlan0`, etc.)
163
+ - Accurate per-interface monitoring for multi-NIC hosts
164
+ - Automatic fallback to global stats if interface unavailable
165
+
166
+ **🔄 Smart Performance**
167
+ - Optimized table rendering for large connection sets (5k+ connections)
168
+ - In-place cell updates to prevent flicker during sorting
169
+ - Preserves scroll position and cursor during refreshes
170
+ - Debounced filter input to avoid excessive updates
123
171
 
124
172
  ---
125
173
 
@@ -18,6 +18,15 @@
18
18
 
19
19
  ---
20
20
 
21
+ ### A quick plug for AI-Enhanced Docs
22
+
23
+ > **This README was crafted with AI assistance, and here's why that matters**
24
+ >
25
+ > As a solo developer building open source tools that may only ever serve my own needs, comprehensive documentation often wouldn't happen without AI help. Using agentic dev tools like **Roo** & **Claude Code** that understand the entire codebase, AI doesn't just regurgitate generic content - it extracts real implementation details and creates accurate, specific documentation.
26
+ >
27
+ > In this case, Sonnet 4 took a pass & a human (me) verified them 6/28/25.
28
+
29
+
21
30
  ## ✨ **Features**
22
31
 
23
32
  <table style="width: 100%; border-collapse: collapse;">
@@ -42,6 +51,18 @@
42
51
  <td>Uses <code>psutil</code> (root) for full fidelity, falls back to <code>lsof</code> if run as a regular user</td>
43
52
  </tr>
44
53
  <tr>
54
+ <td style="font-weight: bold;">📊 Real-time metrics</td>
55
+ <td>Live connection counts, bandwidth monitoring with per-interface selection</td>
56
+ </tr>
57
+ <tr>
58
+ <td style="font-weight: bold;">🔍 Advanced filtering</td>
59
+ <td>Regex-powered search with live filtering across all connection fields</td>
60
+ </tr>
61
+ <tr>
62
+ <td style="font-weight: bold;">🔄 Smart sorting</td>
63
+ <td>Sort by status or process name with optimized rendering for large datasets</td>
64
+ </tr>
65
+ <tr>
45
66
  <td style="font-weight: bold;">🎨 Modern Textual UI</td>
46
67
  <td>Smooth scrolling, dark theme, status bar with connection count & data source</td>
47
68
  </tr>
@@ -88,6 +109,33 @@ netshow [--interval 1.0] [--no-colors]
88
109
  | **↵ / Click** | Open detail view |
89
110
  | **Esc / ←** | Back to list |
90
111
  | **q** | Quit NetShow |
112
+ | **Ctrl+C** | Force quit (hard quit) |
113
+ | **Ctrl+R** | Force refresh |
114
+ | **f** | Toggle filter input |
115
+ | **/** | Quick search (focus filter) |
116
+ | **s** | Sort by connection status |
117
+ | **p** | Sort by process name |
118
+ | **i** | Cycle network interface for bandwidth monitoring |
119
+
120
+ ### **Advanced Features**
121
+
122
+ **🔍 Filtering & Search**
123
+ - Press `f` or `/` to open the filter input
124
+ - Supports regex patterns for advanced matching
125
+ - Filters across process names, addresses, and connection status
126
+ - Live updates as you type (with debouncing)
127
+
128
+ **📊 Bandwidth Monitoring**
129
+ - Real-time bandwidth display in the metrics bar
130
+ - Press `i` to cycle through network interfaces (`all`, `eth0`, `wlan0`, etc.)
131
+ - Accurate per-interface monitoring for multi-NIC hosts
132
+ - Automatic fallback to global stats if interface unavailable
133
+
134
+ **🔄 Smart Performance**
135
+ - Optimized table rendering for large connection sets (5k+ connections)
136
+ - In-place cell updates to prevent flicker during sorting
137
+ - Preserves scroll position and cursor during refreshes
138
+ - Debounced filter input to avoid excessive updates
91
139
 
92
140
  ---
93
141