hostpulse 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.
@@ -0,0 +1,10 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Yjunc
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6
+
7
+ The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8
+
9
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
10
+
@@ -0,0 +1,3 @@
1
+ include README.zh-CN.md
2
+ include README.zh-TW.md
3
+ include requirements.txt
@@ -0,0 +1,161 @@
1
+ Metadata-Version: 2.4
2
+ Name: hostpulse
3
+ Version: 0.1.0
4
+ Summary: A command-line tool for checking local system status
5
+ License-Expression: MIT
6
+ Requires-Python: >=3.14
7
+ Description-Content-Type: text/markdown
8
+ License-File: LICENSE
9
+ Requires-Dist: psutil==7.2.2
10
+ Dynamic: license-file
11
+
12
+ # HostPulse
13
+
14
+ [English](https://github.com/Yjuncc/hostpulse/blob/main/README.md) | [简体中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-CN.md) | [繁體中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-TW.md)
15
+
16
+ HostPulse is an open-source Python command-line tool for checking local system status.
17
+
18
+ It provides a quick overview of the operating system, CPU, memory, disk, and system uptime.
19
+
20
+ Each time HostPulse runs, it reads and displays the system status once and then exits automatically.
21
+
22
+ ## Features
23
+
24
+ HostPulse v0.1.0 provides the following features:
25
+
26
+ - **Operating system**: Display the operating system in use.
27
+ - **CPU architecture**: Display the processor architecture, such as ARM64 or x86_64.
28
+ - **Logical CPU count**: Display the number of logical CPUs detected by the system.
29
+ - **Hostname**: Display the computer's hostname.
30
+ - **CPU usage**: Display the current CPU usage percentage.
31
+ - **Memory information**: Display total memory and memory usage percentage.
32
+ - **Disk information**: Display the capacity and usage percentage of the filesystem containing the system root directory.
33
+ - **System uptime**: Display the time elapsed since the last system boot.
34
+
35
+ ## Requirements
36
+
37
+ - Python 3.14 or newer
38
+ - psutil 7.2.2
39
+
40
+ When HostPulse is installed through pip, the required psutil dependency is installed automatically.
41
+
42
+ ## Tested Environment
43
+
44
+ HostPulse v0.1.0 has completed local installation and execution testing in the following environment:
45
+
46
+ - **Operating system**: macOS (Apple Silicon)
47
+ - **Python**: 3.14
48
+ - **psutil**: 7.2.2
49
+
50
+ Python package building, local installation, command-line execution, and uninstallation tests have passed.
51
+
52
+ The program currently displays system information labels in Traditional Chinese.
53
+
54
+ ## Installation
55
+
56
+ HostPulse is distributed through PyPI (the Python Package Index) and can be installed using pip.
57
+
58
+ Using a Python virtual environment is recommended to avoid dependency conflicts with other projects.
59
+
60
+ **1. Create a virtual environment**
61
+
62
+ Run the following command in the macOS Terminal:
63
+
64
+ ```bash
65
+ python3.14 -m venv .venv
66
+ ```
67
+
68
+ **2. Activate the virtual environment**
69
+
70
+ ```bash
71
+ source .venv/bin/activate
72
+ ```
73
+
74
+ **3. Install HostPulse**
75
+
76
+ ```bash
77
+ python -m pip install hostpulse
78
+ ```
79
+
80
+ pip downloads and installs HostPulse and its required dependencies from PyPI.
81
+
82
+ ## Usage
83
+
84
+ After installation, run the following command in the activated Python virtual environment:
85
+
86
+ ```bash
87
+ hostpulse
88
+ ```
89
+
90
+ The program displays the current system information, including CPU, memory, disk usage, and system uptime.
91
+
92
+ It exits automatically after displaying the results and requires no additional configuration.
93
+
94
+ ## Running from Source
95
+
96
+ In addition to installing from PyPI, you can obtain the complete source code from GitHub.
97
+
98
+ **1. Clone the repository**
99
+
100
+ ```bash
101
+ git clone https://github.com/Yjuncc/hostpulse.git
102
+ ```
103
+
104
+ **2. Enter the project directory**
105
+
106
+ ```bash
107
+ cd hostpulse
108
+ ```
109
+
110
+ **3. Create and activate a virtual environment**
111
+
112
+ ```bash
113
+ python3.14 -m venv .venv
114
+ source .venv/bin/activate
115
+ ```
116
+
117
+ **4. Install dependencies**
118
+
119
+ ```bash
120
+ python -m pip install -r requirements.txt
121
+ ```
122
+
123
+ **5. Run HostPulse**
124
+
125
+ ```bash
126
+ python hostpulse.py
127
+ ```
128
+
129
+ You can also run the program from the project directory without activating the virtual environment:
130
+
131
+ ```bash
132
+ .venv/bin/python hostpulse.py
133
+ ```
134
+
135
+ ## Project and Releases
136
+
137
+ HostPulse uses Git for version control. Its source code is hosted on GitHub, and Python packages are distributed through PyPI.
138
+
139
+ - **GitHub repository**: [Yjuncc/hostpulse](https://github.com/Yjuncc/hostpulse)
140
+ - **GitHub Releases**: [View official releases](https://github.com/Yjuncc/hostpulse/releases)
141
+ - **PyPI**: [HostPulse package](https://pypi.org/project/hostpulse/)
142
+
143
+ GitHub provides the complete source code, project documentation, and version release history.
144
+
145
+ PyPI provides Python installation packages so users can install HostPulse through pip.
146
+
147
+ ## Current Version
148
+
149
+ **HostPulse v0.1.0 — Initial Release**
150
+
151
+ This version provides basic system status checking through a Python command-line interface.
152
+
153
+ ## Open Source License
154
+
155
+ HostPulse is licensed under the MIT License.
156
+
157
+ You may use, modify, and distribute the project's source code under the terms of the MIT License.
158
+
159
+ For the complete license terms, see [LICENSE](https://github.com/Yjuncc/hostpulse/blob/main/LICENSE).
160
+
161
+ Copyright (c) 2026 Yjunc
@@ -0,0 +1,150 @@
1
+ # HostPulse
2
+
3
+ [English](https://github.com/Yjuncc/hostpulse/blob/main/README.md) | [简体中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-CN.md) | [繁體中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-TW.md)
4
+
5
+ HostPulse is an open-source Python command-line tool for checking local system status.
6
+
7
+ It provides a quick overview of the operating system, CPU, memory, disk, and system uptime.
8
+
9
+ Each time HostPulse runs, it reads and displays the system status once and then exits automatically.
10
+
11
+ ## Features
12
+
13
+ HostPulse v0.1.0 provides the following features:
14
+
15
+ - **Operating system**: Display the operating system in use.
16
+ - **CPU architecture**: Display the processor architecture, such as ARM64 or x86_64.
17
+ - **Logical CPU count**: Display the number of logical CPUs detected by the system.
18
+ - **Hostname**: Display the computer's hostname.
19
+ - **CPU usage**: Display the current CPU usage percentage.
20
+ - **Memory information**: Display total memory and memory usage percentage.
21
+ - **Disk information**: Display the capacity and usage percentage of the filesystem containing the system root directory.
22
+ - **System uptime**: Display the time elapsed since the last system boot.
23
+
24
+ ## Requirements
25
+
26
+ - Python 3.14 or newer
27
+ - psutil 7.2.2
28
+
29
+ When HostPulse is installed through pip, the required psutil dependency is installed automatically.
30
+
31
+ ## Tested Environment
32
+
33
+ HostPulse v0.1.0 has completed local installation and execution testing in the following environment:
34
+
35
+ - **Operating system**: macOS (Apple Silicon)
36
+ - **Python**: 3.14
37
+ - **psutil**: 7.2.2
38
+
39
+ Python package building, local installation, command-line execution, and uninstallation tests have passed.
40
+
41
+ The program currently displays system information labels in Traditional Chinese.
42
+
43
+ ## Installation
44
+
45
+ HostPulse is distributed through PyPI (the Python Package Index) and can be installed using pip.
46
+
47
+ Using a Python virtual environment is recommended to avoid dependency conflicts with other projects.
48
+
49
+ **1. Create a virtual environment**
50
+
51
+ Run the following command in the macOS Terminal:
52
+
53
+ ```bash
54
+ python3.14 -m venv .venv
55
+ ```
56
+
57
+ **2. Activate the virtual environment**
58
+
59
+ ```bash
60
+ source .venv/bin/activate
61
+ ```
62
+
63
+ **3. Install HostPulse**
64
+
65
+ ```bash
66
+ python -m pip install hostpulse
67
+ ```
68
+
69
+ pip downloads and installs HostPulse and its required dependencies from PyPI.
70
+
71
+ ## Usage
72
+
73
+ After installation, run the following command in the activated Python virtual environment:
74
+
75
+ ```bash
76
+ hostpulse
77
+ ```
78
+
79
+ The program displays the current system information, including CPU, memory, disk usage, and system uptime.
80
+
81
+ It exits automatically after displaying the results and requires no additional configuration.
82
+
83
+ ## Running from Source
84
+
85
+ In addition to installing from PyPI, you can obtain the complete source code from GitHub.
86
+
87
+ **1. Clone the repository**
88
+
89
+ ```bash
90
+ git clone https://github.com/Yjuncc/hostpulse.git
91
+ ```
92
+
93
+ **2. Enter the project directory**
94
+
95
+ ```bash
96
+ cd hostpulse
97
+ ```
98
+
99
+ **3. Create and activate a virtual environment**
100
+
101
+ ```bash
102
+ python3.14 -m venv .venv
103
+ source .venv/bin/activate
104
+ ```
105
+
106
+ **4. Install dependencies**
107
+
108
+ ```bash
109
+ python -m pip install -r requirements.txt
110
+ ```
111
+
112
+ **5. Run HostPulse**
113
+
114
+ ```bash
115
+ python hostpulse.py
116
+ ```
117
+
118
+ You can also run the program from the project directory without activating the virtual environment:
119
+
120
+ ```bash
121
+ .venv/bin/python hostpulse.py
122
+ ```
123
+
124
+ ## Project and Releases
125
+
126
+ HostPulse uses Git for version control. Its source code is hosted on GitHub, and Python packages are distributed through PyPI.
127
+
128
+ - **GitHub repository**: [Yjuncc/hostpulse](https://github.com/Yjuncc/hostpulse)
129
+ - **GitHub Releases**: [View official releases](https://github.com/Yjuncc/hostpulse/releases)
130
+ - **PyPI**: [HostPulse package](https://pypi.org/project/hostpulse/)
131
+
132
+ GitHub provides the complete source code, project documentation, and version release history.
133
+
134
+ PyPI provides Python installation packages so users can install HostPulse through pip.
135
+
136
+ ## Current Version
137
+
138
+ **HostPulse v0.1.0 — Initial Release**
139
+
140
+ This version provides basic system status checking through a Python command-line interface.
141
+
142
+ ## Open Source License
143
+
144
+ HostPulse is licensed under the MIT License.
145
+
146
+ You may use, modify, and distribute the project's source code under the terms of the MIT License.
147
+
148
+ For the complete license terms, see [LICENSE](https://github.com/Yjuncc/hostpulse/blob/main/LICENSE).
149
+
150
+ Copyright (c) 2026 Yjunc
@@ -0,0 +1,150 @@
1
+ # HostPulse
2
+
3
+ [English](https://github.com/Yjuncc/hostpulse/blob/main/README.md) | [简体中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-CN.md) | [繁體中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-TW.md)
4
+
5
+ HostPulse 是一款使用 Python 开发的开源命令行系统状态检查工具。
6
+
7
+ 它可以快速查看本机的操作系统、CPU、内存、硬盘及系统运行时间等基本信息。
8
+
9
+ 每次执行时,HostPulse 会读取并显示一次系统状态,随后自动退出程序。
10
+
11
+ ## 功能
12
+
13
+ HostPulse v0.1.0 提供以下功能:
14
+
15
+ - **操作系统**:查看当前使用的操作系统。
16
+ - **处理器架构**:查看 CPU 架构,例如 ARM64、x86_64。
17
+ - **逻辑处理器数量**:查看系统识别的逻辑 CPU 数量。
18
+ - **主机名称**:查看电脑的主机名称。
19
+ - **CPU 使用率**:查看当前的 CPU 使用率。
20
+ - **内存信息**:查看内存总量和使用率。
21
+ - **硬盘信息**:查看系统根目录所在分区的容量和使用率。
22
+ - **系统运行时间**:查看距离上次开机经过的时间。
23
+
24
+ ## 系统要求
25
+
26
+ - Python 3.14 或更高版本
27
+ - psutil 7.2.2
28
+
29
+ 通过 pip 安装 HostPulse 时,会自动安装所需的 psutil 依赖。
30
+
31
+ ## 测试环境
32
+
33
+ HostPulse v0.1.0 已在以下环境完成本地安装与运行测试:
34
+
35
+ - **操作系统**:macOS(Apple Silicon)
36
+ - **Python**:3.14
37
+ - **psutil**:7.2.2
38
+
39
+ 已通过 Python 安装包构建、本地安装、命令行运行及卸载测试。
40
+
41
+ 目前程序输出的系统信息标签使用繁体中文。
42
+
43
+ ## 安装
44
+
45
+ HostPulse 通过 PyPI(Python 软件包索引)发布,可以使用 pip 安装。
46
+
47
+ 建议使用 Python 虚拟环境,避免与其他项目的依赖产生冲突。
48
+
49
+ **1. 创建虚拟环境**
50
+
51
+ 在 macOS 终端中执行:
52
+
53
+ ```bash
54
+ python3.14 -m venv .venv
55
+ ```
56
+
57
+ **2. 激活虚拟环境**
58
+
59
+ ```bash
60
+ source .venv/bin/activate
61
+ ```
62
+
63
+ **3. 安装 HostPulse**
64
+
65
+ ```bash
66
+ python -m pip install hostpulse
67
+ ```
68
+
69
+ pip 会从 PyPI 下载并安装 HostPulse 及其所需依赖。
70
+
71
+ ## 使用方法
72
+
73
+ 安装完成后,在已激活的 Python 虚拟环境中执行:
74
+
75
+ ```bash
76
+ hostpulse
77
+ ```
78
+
79
+ 程序会显示当前的系统信息,包括 CPU、内存、硬盘使用情况及系统运行时间。
80
+
81
+ 输出完成后,程序会自动退出,无需额外配置。
82
+
83
+ ## 从源代码运行
84
+
85
+ 除了通过 PyPI 安装,也可以从 GitHub 获取完整源代码。
86
+
87
+ **1. 克隆项目仓库**
88
+
89
+ ```bash
90
+ git clone https://github.com/Yjuncc/hostpulse.git
91
+ ```
92
+
93
+ **2. 进入项目目录**
94
+
95
+ ```bash
96
+ cd hostpulse
97
+ ```
98
+
99
+ **3. 创建并激活虚拟环境**
100
+
101
+ ```bash
102
+ python3.14 -m venv .venv
103
+ source .venv/bin/activate
104
+ ```
105
+
106
+ **4. 安装依赖**
107
+
108
+ ```bash
109
+ python -m pip install -r requirements.txt
110
+ ```
111
+
112
+ **5. 运行 HostPulse**
113
+
114
+ ```bash
115
+ python hostpulse.py
116
+ ```
117
+
118
+ 也可以在项目目录中,不激活虚拟环境,直接执行:
119
+
120
+ ```bash
121
+ .venv/bin/python hostpulse.py
122
+ ```
123
+
124
+ ## 项目与版本发布
125
+
126
+ HostPulse 使用 Git 进行版本控制,源代码托管于 GitHub,Python 安装包通过 PyPI 分发。
127
+
128
+ - **GitHub 项目**:[Yjuncc/hostpulse](https://github.com/Yjuncc/hostpulse)
129
+ - **GitHub Releases**:[查看正式发布版本](https://github.com/Yjuncc/hostpulse/releases)
130
+ - **PyPI**:[HostPulse 软件包](https://pypi.org/project/hostpulse/)
131
+
132
+ GitHub 提供完整源代码、项目文档和版本发布记录。
133
+
134
+ PyPI 提供 Python 安装包,方便用户通过 pip 安装。
135
+
136
+ ## 当前版本
137
+
138
+ **HostPulse v0.1.0 — 首个正式版本**
139
+
140
+ 此版本提供基础系统状态检查功能,采用 Python 命令行方式运行。
141
+
142
+ ## 开源许可证
143
+
144
+ HostPulse 采用 MIT 开源许可证。
145
+
146
+ 你可以根据 MIT License 条款使用、修改及分发本项目的源代码。
147
+
148
+ 完整许可证内容请参阅 [LICENSE](https://github.com/Yjuncc/hostpulse/blob/main/LICENSE)。
149
+
150
+ Copyright (c) 2026 Yjunc
@@ -0,0 +1,150 @@
1
+ # HostPulse
2
+
3
+ [English](https://github.com/Yjuncc/hostpulse/blob/main/README.md) | [简体中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-CN.md) | [繁體中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-TW.md)
4
+
5
+ HostPulse 是一款使用 Python 開發的開源命令行系統狀態檢查工具。
6
+
7
+ 它可以快速查看本機的操作系統、CPU、內存、硬盤及系統運行時間等基本資訊。
8
+
9
+ 每次執行時,HostPulse 會讀取並顯示一次系統狀態,隨後自動結束程序。
10
+
11
+ ## 功能
12
+
13
+ HostPulse v0.1.0 提供以下功能:
14
+
15
+ - **操作系統**:查看目前使用的操作系統。
16
+ - **處理器架構**:查看 CPU 架構,例如 ARM64、x86_64。
17
+ - **邏輯處理器數量**:查看系統識別的邏輯 CPU 數量。
18
+ - **主機名稱**:查看電腦的主機名稱。
19
+ - **CPU 使用率**:查看目前的 CPU 使用率。
20
+ - **內存資訊**:查看內存總量和使用率。
21
+ - **硬盤資訊**:查看系統根目錄所在分區的容量和使用率。
22
+ - **系統運行時間**:查看距離上次開機經過的時間。
23
+
24
+ ## 系統要求
25
+
26
+ - Python 3.14 或更高版本
27
+ - psutil 7.2.2
28
+
29
+ 透過 pip 安裝 HostPulse 時,會自動安裝所需的 psutil 依賴。
30
+
31
+ ## 測試環境
32
+
33
+ HostPulse v0.1.0 已在以下環境完成本地安裝與運行測試:
34
+
35
+ - **操作系統**:macOS(Apple Silicon)
36
+ - **Python**:3.14
37
+ - **psutil**:7.2.2
38
+
39
+ 已通過 Python 安裝包構建、本地安裝、命令行運行及卸載測試。
40
+
41
+ 目前程序輸出的系統資訊標籤使用繁體中文。
42
+
43
+ ## 安裝
44
+
45
+ HostPulse 透過 PyPI(Python 軟件包索引)發布,可以使用 pip 安裝。
46
+
47
+ 建議使用 Python 虛擬環境,避免與其他項目的依賴產生衝突。
48
+
49
+ **1. 建立虛擬環境**
50
+
51
+ 在 macOS 終端機中執行:
52
+
53
+ ```bash
54
+ python3.14 -m venv .venv
55
+ ```
56
+
57
+ **2. 啟用虛擬環境**
58
+
59
+ ```bash
60
+ source .venv/bin/activate
61
+ ```
62
+
63
+ **3. 安裝 HostPulse**
64
+
65
+ ```bash
66
+ python -m pip install hostpulse
67
+ ```
68
+
69
+ pip 會從 PyPI 下載並安裝 HostPulse 及其所需依賴。
70
+
71
+ ## 使用方法
72
+
73
+ 安裝完成後,在已啟用的 Python 虛擬環境中執行:
74
+
75
+ ```bash
76
+ hostpulse
77
+ ```
78
+
79
+ 程序會顯示目前的系統資訊,包括 CPU、內存、硬盤使用情況及系統運行時間。
80
+
81
+ 輸出完成後,程序會自動退出,無需額外配置。
82
+
83
+ ## 從源代碼運行
84
+
85
+ 除了透過 PyPI 安裝,也可以從 GitHub 取得完整源代碼。
86
+
87
+ **1. 克隆項目倉庫**
88
+
89
+ ```bash
90
+ git clone https://github.com/Yjuncc/hostpulse.git
91
+ ```
92
+
93
+ **2. 進入項目目錄**
94
+
95
+ ```bash
96
+ cd hostpulse
97
+ ```
98
+
99
+ **3. 建立並啟用虛擬環境**
100
+
101
+ ```bash
102
+ python3.14 -m venv .venv
103
+ source .venv/bin/activate
104
+ ```
105
+
106
+ **4. 安裝依賴**
107
+
108
+ ```bash
109
+ python -m pip install -r requirements.txt
110
+ ```
111
+
112
+ **5. 運行 HostPulse**
113
+
114
+ ```bash
115
+ python hostpulse.py
116
+ ```
117
+
118
+ 也可以在項目目錄中,不啟用虛擬環境,直接執行:
119
+
120
+ ```bash
121
+ .venv/bin/python hostpulse.py
122
+ ```
123
+
124
+ ## 項目與版本發布
125
+
126
+ HostPulse 使用 Git 進行版本控制,源代碼託管於 GitHub,Python 安裝包透過 PyPI 分發。
127
+
128
+ - **GitHub 項目**:[Yjuncc/hostpulse](https://github.com/Yjuncc/hostpulse)
129
+ - **GitHub Releases**:[查看正式發布版本](https://github.com/Yjuncc/hostpulse/releases)
130
+ - **PyPI**:[HostPulse 軟件包](https://pypi.org/project/hostpulse/)
131
+
132
+ GitHub 提供完整源代碼、項目文檔和版本發布記錄。
133
+
134
+ PyPI 提供 Python 安裝包,方便使用者透過 pip 安裝。
135
+
136
+ ## 當前版本
137
+
138
+ **HostPulse v0.1.0 — 首個正式版本**
139
+
140
+ 此版本提供基礎系統狀態檢查功能,採用 Python 命令行方式運行。
141
+
142
+ ## 開源許可證
143
+
144
+ HostPulse 採用 MIT 開源許可證。
145
+
146
+ 你可以根據 MIT License 條款使用、修改及分發本項目的源代碼。
147
+
148
+ 完整許可證內容請參閱 [LICENSE](https://github.com/Yjuncc/hostpulse/blob/main/LICENSE)。
149
+
150
+ Copyright (c) 2026 Yjunc
@@ -0,0 +1,161 @@
1
+ Metadata-Version: 2.4
2
+ Name: hostpulse
3
+ Version: 0.1.0
4
+ Summary: A command-line tool for checking local system status
5
+ License-Expression: MIT
6
+ Requires-Python: >=3.14
7
+ Description-Content-Type: text/markdown
8
+ License-File: LICENSE
9
+ Requires-Dist: psutil==7.2.2
10
+ Dynamic: license-file
11
+
12
+ # HostPulse
13
+
14
+ [English](https://github.com/Yjuncc/hostpulse/blob/main/README.md) | [简体中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-CN.md) | [繁體中文](https://github.com/Yjuncc/hostpulse/blob/main/README.zh-TW.md)
15
+
16
+ HostPulse is an open-source Python command-line tool for checking local system status.
17
+
18
+ It provides a quick overview of the operating system, CPU, memory, disk, and system uptime.
19
+
20
+ Each time HostPulse runs, it reads and displays the system status once and then exits automatically.
21
+
22
+ ## Features
23
+
24
+ HostPulse v0.1.0 provides the following features:
25
+
26
+ - **Operating system**: Display the operating system in use.
27
+ - **CPU architecture**: Display the processor architecture, such as ARM64 or x86_64.
28
+ - **Logical CPU count**: Display the number of logical CPUs detected by the system.
29
+ - **Hostname**: Display the computer's hostname.
30
+ - **CPU usage**: Display the current CPU usage percentage.
31
+ - **Memory information**: Display total memory and memory usage percentage.
32
+ - **Disk information**: Display the capacity and usage percentage of the filesystem containing the system root directory.
33
+ - **System uptime**: Display the time elapsed since the last system boot.
34
+
35
+ ## Requirements
36
+
37
+ - Python 3.14 or newer
38
+ - psutil 7.2.2
39
+
40
+ When HostPulse is installed through pip, the required psutil dependency is installed automatically.
41
+
42
+ ## Tested Environment
43
+
44
+ HostPulse v0.1.0 has completed local installation and execution testing in the following environment:
45
+
46
+ - **Operating system**: macOS (Apple Silicon)
47
+ - **Python**: 3.14
48
+ - **psutil**: 7.2.2
49
+
50
+ Python package building, local installation, command-line execution, and uninstallation tests have passed.
51
+
52
+ The program currently displays system information labels in Traditional Chinese.
53
+
54
+ ## Installation
55
+
56
+ HostPulse is distributed through PyPI (the Python Package Index) and can be installed using pip.
57
+
58
+ Using a Python virtual environment is recommended to avoid dependency conflicts with other projects.
59
+
60
+ **1. Create a virtual environment**
61
+
62
+ Run the following command in the macOS Terminal:
63
+
64
+ ```bash
65
+ python3.14 -m venv .venv
66
+ ```
67
+
68
+ **2. Activate the virtual environment**
69
+
70
+ ```bash
71
+ source .venv/bin/activate
72
+ ```
73
+
74
+ **3. Install HostPulse**
75
+
76
+ ```bash
77
+ python -m pip install hostpulse
78
+ ```
79
+
80
+ pip downloads and installs HostPulse and its required dependencies from PyPI.
81
+
82
+ ## Usage
83
+
84
+ After installation, run the following command in the activated Python virtual environment:
85
+
86
+ ```bash
87
+ hostpulse
88
+ ```
89
+
90
+ The program displays the current system information, including CPU, memory, disk usage, and system uptime.
91
+
92
+ It exits automatically after displaying the results and requires no additional configuration.
93
+
94
+ ## Running from Source
95
+
96
+ In addition to installing from PyPI, you can obtain the complete source code from GitHub.
97
+
98
+ **1. Clone the repository**
99
+
100
+ ```bash
101
+ git clone https://github.com/Yjuncc/hostpulse.git
102
+ ```
103
+
104
+ **2. Enter the project directory**
105
+
106
+ ```bash
107
+ cd hostpulse
108
+ ```
109
+
110
+ **3. Create and activate a virtual environment**
111
+
112
+ ```bash
113
+ python3.14 -m venv .venv
114
+ source .venv/bin/activate
115
+ ```
116
+
117
+ **4. Install dependencies**
118
+
119
+ ```bash
120
+ python -m pip install -r requirements.txt
121
+ ```
122
+
123
+ **5. Run HostPulse**
124
+
125
+ ```bash
126
+ python hostpulse.py
127
+ ```
128
+
129
+ You can also run the program from the project directory without activating the virtual environment:
130
+
131
+ ```bash
132
+ .venv/bin/python hostpulse.py
133
+ ```
134
+
135
+ ## Project and Releases
136
+
137
+ HostPulse uses Git for version control. Its source code is hosted on GitHub, and Python packages are distributed through PyPI.
138
+
139
+ - **GitHub repository**: [Yjuncc/hostpulse](https://github.com/Yjuncc/hostpulse)
140
+ - **GitHub Releases**: [View official releases](https://github.com/Yjuncc/hostpulse/releases)
141
+ - **PyPI**: [HostPulse package](https://pypi.org/project/hostpulse/)
142
+
143
+ GitHub provides the complete source code, project documentation, and version release history.
144
+
145
+ PyPI provides Python installation packages so users can install HostPulse through pip.
146
+
147
+ ## Current Version
148
+
149
+ **HostPulse v0.1.0 — Initial Release**
150
+
151
+ This version provides basic system status checking through a Python command-line interface.
152
+
153
+ ## Open Source License
154
+
155
+ HostPulse is licensed under the MIT License.
156
+
157
+ You may use, modify, and distribute the project's source code under the terms of the MIT License.
158
+
159
+ For the complete license terms, see [LICENSE](https://github.com/Yjuncc/hostpulse/blob/main/LICENSE).
160
+
161
+ Copyright (c) 2026 Yjunc
@@ -0,0 +1,14 @@
1
+ LICENSE
2
+ MANIFEST.in
3
+ README.md
4
+ README.zh-CN.md
5
+ README.zh-TW.md
6
+ hostpulse.py
7
+ pyproject.toml
8
+ requirements.txt
9
+ hostpulse.egg-info/PKG-INFO
10
+ hostpulse.egg-info/SOURCES.txt
11
+ hostpulse.egg-info/dependency_links.txt
12
+ hostpulse.egg-info/entry_points.txt
13
+ hostpulse.egg-info/requires.txt
14
+ hostpulse.egg-info/top_level.txt
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ hostpulse = hostpulse:main
@@ -0,0 +1 @@
1
+ psutil==7.2.2
@@ -0,0 +1 @@
1
+ hostpulse
@@ -0,0 +1,32 @@
1
+ import os
2
+ import platform
3
+ import time
4
+
5
+ import psutil
6
+
7
+ def main():
8
+ print("HostPulse 啟動成功!")
9
+ print("操作系統:", platform.system())
10
+ print("處理器架構:", platform.machine())
11
+ print("邏輯處理器數量:", os.cpu_count())
12
+
13
+ hostname = platform.node()
14
+ short_hostname = hostname.removesuffix(".local")
15
+ print("主機名稱:", short_hostname)
16
+
17
+ memory = psutil.virtual_memory()
18
+ print("內存總量 (GiB):", round(memory.total / (1024 ** 3), 2))
19
+ print("內存使用率:", memory.percent, "%")
20
+
21
+ disk = psutil.disk_usage("/")
22
+ print("硬盤容量(GiB):", round(disk.total / (1024 ** 3), 2))
23
+ print("硬盤使用率:", disk.percent, "%")
24
+
25
+ cpu_usage = psutil.cpu_percent(interval=1)
26
+ print("CPU 使用率:", cpu_usage, "%")
27
+
28
+ uptime_seconds = time.time() - psutil.boot_time()
29
+ print("距離上次開機(小時):", round(uptime_seconds / 3600, 1))
30
+
31
+ if __name__ == "__main__":
32
+ main()
@@ -0,0 +1,22 @@
1
+
2
+ [build-system]
3
+ requires = ["setuptools>=77.0.3"]
4
+ build-backend = "setuptools.build_meta"
5
+
6
+ [project]
7
+ name = "hostpulse"
8
+ version = "0.1.0"
9
+ license = "MIT"
10
+ license-files = ["LICENSE"]
11
+ description = "A command-line tool for checking local system status"
12
+ readme = "README.md"
13
+ requires-python = ">=3.14"
14
+ dependencies = [
15
+ "psutil==7.2.2",
16
+ ]
17
+
18
+ [project.scripts]
19
+ hostpulse = "hostpulse:main"
20
+
21
+ [tool.setuptools]
22
+ py-modules = ["hostpulse"]
@@ -0,0 +1 @@
1
+ psutil==7.2.2
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+