hostpulse 0.1.0__py3-none-any.whl

hostpulse-0.1.0.dist-info/METADATA

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: hostpulse
+Version: 0.1.0
+Summary: A command-line tool for checking local system status
+License-Expression: MIT
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil==7.2.2
+Dynamic: license-file
+
+# HostPulse
+
+[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)
+
+HostPulse is an open-source Python command-line tool for checking local system status.
+
+It provides a quick overview of the operating system, CPU, memory, disk, and system uptime.
+
+Each time HostPulse runs, it reads and displays the system status once and then exits automatically.
+
+## Features
+
+HostPulse v0.1.0 provides the following features:
+
+- **Operating system**: Display the operating system in use.
+- **CPU architecture**: Display the processor architecture, such as ARM64 or x86_64.
+- **Logical CPU count**: Display the number of logical CPUs detected by the system.
+- **Hostname**: Display the computer's hostname.
+- **CPU usage**: Display the current CPU usage percentage.
+- **Memory information**: Display total memory and memory usage percentage.
+- **Disk information**: Display the capacity and usage percentage of the filesystem containing the system root directory.
+- **System uptime**: Display the time elapsed since the last system boot.
+
+## Requirements
+
+- Python 3.14 or newer
+- psutil 7.2.2
+
+When HostPulse is installed through pip, the required psutil dependency is installed automatically.
+
+## Tested Environment
+
+HostPulse v0.1.0 has completed local installation and execution testing in the following environment:
+
+- **Operating system**: macOS (Apple Silicon)
+- **Python**: 3.14
+- **psutil**: 7.2.2
+
+Python package building, local installation, command-line execution, and uninstallation tests have passed.
+
+The program currently displays system information labels in Traditional Chinese.
+
+## Installation
+
+HostPulse is distributed through PyPI (the Python Package Index) and can be installed using pip.
+
+Using a Python virtual environment is recommended to avoid dependency conflicts with other projects.
+
+**1. Create a virtual environment**
+
+Run the following command in the macOS Terminal:
+
+```bash
+python3.14 -m venv .venv
+```
+
+**2. Activate the virtual environment**
+
+```bash
+source .venv/bin/activate
+```
+
+**3. Install HostPulse**
+
+```bash
+python -m pip install hostpulse
+```
+
+pip downloads and installs HostPulse and its required dependencies from PyPI.
+
+## Usage
+
+After installation, run the following command in the activated Python virtual environment:
+
+```bash
+hostpulse
+```
+
+The program displays the current system information, including CPU, memory, disk usage, and system uptime.
+
+It exits automatically after displaying the results and requires no additional configuration.
+
+## Running from Source
+
+In addition to installing from PyPI, you can obtain the complete source code from GitHub.
+
+**1. Clone the repository**
+
+```bash
+git clone https://github.com/Yjuncc/hostpulse.git
+```
+
+**2. Enter the project directory**
+
+```bash
+cd hostpulse
+```
+
+**3. Create and activate a virtual environment**
+
+```bash
+python3.14 -m venv .venv
+source .venv/bin/activate
+```
+
+**4. Install dependencies**
+
+```bash
+python -m pip install -r requirements.txt
+```
+
+**5. Run HostPulse**
+
+```bash
+python hostpulse.py
+```
+
+You can also run the program from the project directory without activating the virtual environment:
+
+```bash
+.venv/bin/python hostpulse.py
+```
+
+## Project and Releases
+
+HostPulse uses Git for version control. Its source code is hosted on GitHub, and Python packages are distributed through PyPI.
+
+- **GitHub repository**: [Yjuncc/hostpulse](https://github.com/Yjuncc/hostpulse)
+- **GitHub Releases**: [View official releases](https://github.com/Yjuncc/hostpulse/releases)
+- **PyPI**: [HostPulse package](https://pypi.org/project/hostpulse/)
+
+GitHub provides the complete source code, project documentation, and version release history.
+
+PyPI provides Python installation packages so users can install HostPulse through pip.
+
+## Current Version
+
+**HostPulse v0.1.0 — Initial Release**
+
+This version provides basic system status checking through a Python command-line interface.
+
+## Open Source License
+
+HostPulse is licensed under the MIT License.
+
+You may use, modify, and distribute the project's source code under the terms of the MIT License.
+
+For the complete license terms, see [LICENSE](https://github.com/Yjuncc/hostpulse/blob/main/LICENSE).
+
+Copyright (c) 2026 Yjunc

hostpulse-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+hostpulse.py,sha256=FlDBuDj5Dxrp--t-I0kJ-TzYjms3XaqrqRjAwabFLVM,976
+hostpulse-0.1.0.dist-info/licenses/LICENSE,sha256=J5s2lQC0UGG4keEeH3jXXlv1a_Y697eWPySnzmmLbyk,1071
+hostpulse-0.1.0.dist-info/METADATA,sha256=TKNglGXjZ_ur5LFD30fnxZLbo-FRZghTKIlMYrWSGUc,4634
+hostpulse-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+hostpulse-0.1.0.dist-info/entry_points.txt,sha256=DDU1ReqTZR_VmzPjUVbnJBQruO_Z-vxEWUzxCw2Hod4,45
+hostpulse-0.1.0.dist-info/top_level.txt,sha256=qsWh0zwhIQ3j0KO3HqN3_ruSvyw6DTKiRemBFNpKLJY,10
+hostpulse-0.1.0.dist-info/RECORD,,

hostpulse-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hostpulse-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hostpulse = hostpulse:main

hostpulse-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,10 @@
+MIT License
+
+Copyright (c) 2026 Yjunc
+
+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:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+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.
+

hostpulse-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hostpulse

hostpulse.py

@@ -0,0 +1,32 @@
+import os
+import platform
+import time
+
+import psutil
+
+def main():
+    print("HostPulse 啟動成功！")
+    print("操作系統：", platform.system())
+    print("處理器架構：", platform.machine())
+    print("邏輯處理器數量：", os.cpu_count())
+
+    hostname = platform.node()
+    short_hostname = hostname.removesuffix(".local")
+    print("主機名稱：", short_hostname)
+
+    memory = psutil.virtual_memory()
+    print("內存總量 (GiB)：", round(memory.total / (1024 ** 3), 2))
+    print("內存使用率：", memory.percent, "%")
+
+    disk = psutil.disk_usage("/")
+    print("硬盤容量(GiB)：", round(disk.total / (1024 ** 3), 2))
+    print("硬盤使用率：", disk.percent, "%")
+
+    cpu_usage = psutil.cpu_percent(interval=1)
+    print("CPU 使用率：", cpu_usage, "%")
+
+    uptime_seconds = time.time() - psutil.boot_time()
+    print("距離上次開機（小時）：", round(uptime_seconds / 3600, 1))
+
+if __name__ == "__main__":
+    main()