@vincentzyuapps/winload 0.1.8-rc.7 → 0.1.8

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.
Files changed (2) hide show
  1. package/package.json +7 -7
  2. package/readme.md +51 -6
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vincentzyuapps/winload",
3
- "version": "0.1.8-rc.7",
3
+ "version": "0.1.8",
4
4
  "description": "Network Load Monitor — nload-like TUI tool for Windows/Linux/macOS (prebuilt Rust binary)",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -33,11 +33,11 @@
33
33
  "access": "public"
34
34
  },
35
35
  "optionalDependencies": {
36
- "@vincentzyuapps/winload-win32-x64": "0.1.8-rc.7",
37
- "@vincentzyuapps/winload-win32-arm64": "0.1.8-rc.7",
38
- "@vincentzyuapps/winload-linux-x64": "0.1.8-rc.7",
39
- "@vincentzyuapps/winload-linux-arm64": "0.1.8-rc.7",
40
- "@vincentzyuapps/winload-darwin-x64": "0.1.8-rc.7",
41
- "@vincentzyuapps/winload-darwin-arm64": "0.1.8-rc.7"
36
+ "@vincentzyuapps/winload-win32-x64": "0.1.8",
37
+ "@vincentzyuapps/winload-win32-arm64": "0.1.8",
38
+ "@vincentzyuapps/winload-linux-x64": "0.1.8",
39
+ "@vincentzyuapps/winload-linux-arm64": "0.1.8",
40
+ "@vincentzyuapps/winload-darwin-x64": "0.1.8",
41
+ "@vincentzyuapps/winload-darwin-arm64": "0.1.8"
42
42
  }
43
43
  }
package/readme.md CHANGED
@@ -26,6 +26,7 @@
26
26
  [![AUR](https://img.shields.io/badge/AUR-1793D1?style=for-the-badge&logo=archlinux&logoColor=white)](https://aur.archlinux.org/packages/winload-rust-bin)
27
27
  [![APT](https://img.shields.io/badge/APT-E95420?style=for-the-badge&logo=debian&logoColor=white)](https://github.com/VincentZyuApps/winload/releases)
28
28
  [![RPM](https://img.shields.io/badge/RPM-CB1626?style=for-the-badge&logo=redhat&logoColor=white)](https://github.com/VincentZyuApps/winload/releases)
29
+ [![Homebrew](https://img.shields.io/badge/Homebrew-FBB040?style=for-the-badge&logo=homebrew&logoColor=black)](https://github.com/VincentZyuApps/homebrew-tap/blob/main/Formula/winload.rb)
29
30
 
30
31
  > **[📖 Build Docs](.github/workflows/build.md)**
31
32
 
@@ -49,6 +50,27 @@ https://github.com/rolandriegel/nload
49
50
 
50
51
  ![Winload Benchmark](docs/benchmark/benchmark.svg)
51
52
 
53
+ ## 🔧 Run from Source
54
+
55
+ ### Python
56
+ ```bash
57
+ git clone https://github.com/VincentZyuApps/winload.git
58
+ # or clone from Gitee (faster in China Mainland):
59
+ # git clone https://gitee.com/vincent-zyu/winload.git
60
+ cd winload/py
61
+ pip install -r requirements.txt
62
+ python main.py
63
+ ```
64
+
65
+ ### Rust
66
+ ```bash
67
+ git clone https://github.com/VincentZyuApps/winload.git
68
+ cd winload/rust
69
+ cargo run --release
70
+ cargo run --release -- --help # Show help
71
+ cargo run --release -- --version # Show version
72
+ ```
73
+
52
74
  ## 🐍 Python Edition Installation
53
75
  > 💡 **Implementation Note**: Only PyPI and GitHub/Gitee provide Python edition.
54
76
  > Only Cargo provides Rust source code for local compilation.
@@ -59,7 +81,7 @@ pip install winload
59
81
  # recommend use uv:
60
82
  # https://docs.astral.sh/uv/getting-started/installation/
61
83
  # https://gitee.com/wangnov/uv-custom/releases
62
- uv venv
84
+ uv venv --python 3.13
63
85
  uv pip install winload
64
86
  uv run winload
65
87
  uv run python -c "import shutil; print(shutil.which('winload'))"
@@ -85,8 +107,13 @@ cargo install winload
85
107
  cargo install --list
86
108
  ```
87
109
  ### Windows (Scoop)
110
+ > 📄 [Scoop Bucket (GitHub)](https://github.com/VincentZyuApps/scoop-bucket/blob/main/bucket/winload.json)
111
+ > 📄 [Scoop Bucket (Gitee)](https://gitee.com/vincent-zyu/scoop-bucket/blob/main/bucket/winload.json)
88
112
  ```powershell
89
113
  scoop bucket add vincentzyu https://github.com/VincentZyuApps/scoop-bucket
114
+ # or from Gitee:
115
+ # scoop bucket add vincentzyu https://gitee.com/vincent-zyu/scoop-bucket
116
+ scoop update # optional: manually refresh bucket list before install
90
117
  scoop install winload
91
118
  # execute bin file
92
119
  win-nload
@@ -99,6 +126,7 @@ where win-nload # CMD
99
126
  > scoop install windows-terminal-preview
100
127
  > wtp
101
128
  > ```
129
+ > 💡 **All builds require Windows 10+** (Rust 1.77+ dropped Windows 7/8 support). Scoop provides only **MSVC + Npcap** for **x86_64** and **ARM64**. For other variants (MinGW, non-Npcap, i686) or older Windows, download from [GitHub Releases](https://github.com/VincentZyuApps/winload/releases).
102
130
 
103
131
  ### Arch Linux (AUR):
104
132
  ```bash
@@ -123,7 +151,19 @@ which winload
123
151
  ```
124
152
  > 📄 [View Gitee install script](https://gitee.com/vincent-zyu/winload/blob/main/docs/install_scripts/install_gitee.sh)
125
153
 
126
- > ⚠️ These install scripts only support systems with **apt or dnf** package managers on **x86_64 / aarch64** architectures. For other platforms, use **npm** (`npm install -g @vincentzyuapps/winload`) or **Cargo** (`cargo install winload`) instead.
154
+ > ⚠️ The two `curl ... | bash` install scripts above support **x86_64 / aarch64** systems with **apt** (Debian/Ubuntu), **dnf** (Fedora/RHEL), or **Termux** (Android). For other platforms, use **npm** (`npm install -g @vincentzyuapps/winload`) or **Cargo** (`cargo install winload`) instead.
155
+
156
+ ### macOS / Linux (Homebrew)
157
+ > 📄 [Homebrew Formula (GitHub)](https://github.com/VincentZyuApps/homebrew-tap/blob/main/Formula/winload.rb)
158
+ > 📄 [Homebrew Formula (Gitee)](https://gitee.com/vincent-zyu/homebrew-tap/blob/main/Formula/winload.rb)
159
+ ```bash
160
+ brew tap vincentzyuapps/tap
161
+ # or from Gitee (manual tap clone):
162
+ # git clone https://gitee.com/vincent-zyu/homebrew-tap.git "$(brew --prefix)/Library/Taps/vincentzyuapps/homebrew-tap"
163
+ brew update && brew install winload
164
+ which winload
165
+ ```
166
+ > 💡 Homebrew supports **macOS** (Intel & Apple Silicon) and **Linux** (x86_64 & ARM64).
127
167
 
128
168
  <details>
129
169
  <summary>Manual install</summary>
@@ -131,15 +171,15 @@ which winload
131
171
  **DEB (Debian/Ubuntu):**
132
172
  ```bash
133
173
  # Download the latest .deb from GitHub Releases
134
- sudo dpkg -i ./winload_*_amd64.deb
174
+ sudo dpkg -i ./winload*.deb
135
175
  # or use apt (auto-resolves dependencies)
136
- sudo apt install ./winload_*_amd64.deb
176
+ sudo apt install ./winload*.deb
137
177
  which winload
138
178
  ```
139
179
 
140
180
  **RPM (Fedora/RHEL):**
141
181
  ```bash
142
- sudo dnf install ./winload-*-1.x86_64.rpm
182
+ sudo dnf install ./winload*.rpm
143
183
  which winload
144
184
  ```
145
185
 
@@ -228,13 +268,18 @@ On Linux and macOS, loopback traffic works out of the box — no extra flags nee
228
268
  ##### Rust Edition Preview GIF
229
269
  ![docs/preview-rust.gif](docs/preview-rust.gif)
230
270
 
271
+ ##### Terminal Recording
272
+ <a href="https://asciinema.org/a/1030894?startAt=30" target="_blank"><img src="https://asciinema.org/a/1030894.svg" alt="winload demo" width="100%" /></a>
273
+
274
+ > ↑ Recorded by [asciinema](https://github.com/asciinema/asciinema)
275
+
231
276
  ## 📦 Dependencies
232
277
 
233
278
  ### Python Edition
234
279
 
235
280
  | Package | Version | Description |
236
281
  |:---|:---|:---|
237
- | [![Python](https://img.shields.io/badge/Python-3.12.12-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org/) | 3.12.12 | Programming language |
282
+ | [![Python](https://img.shields.io/badge/Python-3.13.11-3776AB?style=flat-square&logo=python&logoColor=white)](https://python.org/) | 3.13.11 | Programming language |
238
283
  | [![psutil](https://img.shields.io/badge/psutil-≥7.0-FFD43B?style=flat-square&logo=python&logoColor=white)](https://github.com/giampaolo/psutil) | ≥7.0 | Process and system utilities |
239
284
  | [![windows-curses](https://img.shields.io/badge/windows--curses-≥2.0-FFD43B?style=flat-square&logo=python&logoColor=white)](https://github.com/zhirui2020/windows-curses) | ≥2.0 | Windows curses support |
240
285