pyhw 0.12.5__py3-none-any.whl → 0.13.1__py3-none-any.whl

pyhw/__init__.py

@@ -1,2 +1,2 @@
-__version__ = '0.12.5'
+__version__ = '0.13.1'
 __author__ = 'xiaoran007'

pyhw/backend/host/__init__.py

@@ -1,3 +1,3 @@
 from .hostBase import HostDetect
 
-__all__ = ["HostDetect"]
+__all__ = ["HostDetect"]

pyhw/backend/host/macos.py

@@ -1,6 +1,3 @@
-"""
-    In dev.
-"""
 from .hostInfo import HostInfo
 from ...pyhwUtil import sysctlGetString
 import ctypes

pyhw/backend/host/windows.py

@@ -1,6 +1,3 @@
-"""
-    In dev.
-"""
 from ...pyhwUtil import getArch
 from ...pyhwException import BackendException
 from .hostInfo import HostInfo

{pyhw-0.12.5.dist-info → pyhw-0.13.1.dist-info}/METADATA

@@ -1,23 +1,22 @@
 Metadata-Version: 2.4
 Name: pyhw
-Version: 0.12.5
+Version: 0.13.1
 Summary: PyHw, a neofetch-like command line tool for fetching system information but written mostly in python.
 Author: Xiao Ran
 Maintainer-email: Xiao Ran <xiaoran.007@icloud.com>
-License: BSD-3-Clause
+License-Expression: BSD-3-Clause
 Project-URL: homepage, https://github.com/xiaoran007/pyhw
 Keywords: neofetch,system information,command line tool,python,hardware information,fastfetch,fetching
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pypci-ng>=0.2.2
+Requires-Dist: pypci-ng>=0.2.4
 Dynamic: license-file
 
-# PyHw
+# PyHw, a neofetch-like system information fetching tool
 [![Downloads](https://static.pepy.tech/badge/pyhw)](https://pepy.tech/project/pyhw)
 ![PyPI - Version](https://img.shields.io/pypi/v/pyhw?label=version)
 ![Static Badge](https://img.shields.io/badge/Python-3.9%2B-green)
@@ -40,10 +39,18 @@ This project is a Python reimplementation of [neofetch](https://github.com/dylan
 
 [//]: # (![demo]&#40;https://i2.imgs.ovh/d/BQACAgUAAx0EUvSR8wACMvpmyFVohzKxLcUdLiJaEa3wlo_OrQACuw4AAoX-QVaSpG0-rTAeRTUE&#41;)
 [//]: # (![demo]&#40;https://files.catbox.moe/xx58xy.jpg&#41;)
-![demo](https://files.catbox.moe/2d21fu.jpg)
+[//]: # (![demo]&#40;https://files.catbox.moe/2d21fu.jpg&#41;)
 
+![demo](https://files.catbox.moe/ik4ioi.png)
 
 
+- [1. Install](#1-install)
+- [2. Usability](#2-usability)
+- [3. Add Logo](#3-add-logo)
+- [4. Build from source](#4-build-from-source)
+- [5. Test Package](#5-test-package)
+- [6. Troubleshooting](#6-troubleshooting)
+
 
 ## 1. Install
 There are already a lot of similar tools so you can choose any of them; they're all essentially no different. If you want to try this tool, There are two convenient ways to install it.
@@ -80,41 +87,27 @@ python -m pyhw
 Please note that the command line entry for __pyhw__ is created by pip, and depending on the user, this entry may not in the __system PATH__. If you encounter this problem, pip will give you a prompt, follow the prompts to add entry to the __system PATH__.
 
 
-### 1.3 Important note about debian 12:
-If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
-```text
-error: externally-managed-environment
-
-× This environment is externally managed
-╰─> To install Python packages system-wide, try apt install
-    python3-xyz, where xyz is the package you are trying to
-    install.
-    
-    If you wish to install a non-Debian-packaged Python package,
-    create a virtual environment using python3 -m venv path/to/venv.
-    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
-    sure you have python3-full installed.
-    
-    For more information visit http://rptl.io/venv
+## 2. Usability
+### Tested Platform
+The following platforms have been tested and are known to work with this package:
+* macOS: arm64, x86_64
+* Linux: arm64, x86_64, riscv64, ppc64le, mips64el, s390x
+* FreeBSD: arm64, x86_64
+* Windows 10: x86_64
+* Windows 11: arm64, x86_64
 
-note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
-hint: See PEP 668 for the detailed specification.
-```
-This is due to the fact that system python is not supposed to be managed by pip. You can simply use **pipx** to install **pyhw**. Or you can use a virtual environment (venv), conda environment or force remove this restriction (not recommended).
+For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
 
-## 2. Tested OS
-* macOS arm64, x86_64
-* Linux arm64, x86_64, riscv64
-* FreeBSD arm64
-* Windows 10 x86_64
-* Windows 11 arm64, x86_64
+Please note that this package requires `Python 3.9`, so very old versions of Linux may not be supported.
 
-For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
+### Features
+The functionality of this package varies slightly on different operating systems and architectures, please refer to [this](docs/functionality.md) documentation for details.
 
 ## 3. Add Logo
 1. Create a file named **\<os>.pyhw** in **logo/ascii** folder
 2. Modify **colorConfig.py** file to add a new logo style
 3. Update **pyhwUtil.py** to enable new logo style.
+4. You may create a new `PR` to add your logo style to the main repository.
 
 ## 4. Build from source
 
@@ -158,3 +151,26 @@ If you have docker installed, you can test this package through docker by type:
 make test # local build
 make test-pypi # release version
 ```
+
+## 6. Troubleshooting
+### 6.1 Important note about debian 12:
+If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
+```text
+error: externally-managed-environment
+
+× This environment is externally managed
+╰─> To install Python packages system-wide, try apt install
+    python3-xyz, where xyz is the package you are trying to
+    install.
+    
+    If you wish to install a non-Debian-packaged Python package,
+    create a virtual environment using python3 -m venv path/to/venv.
+    Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
+    sure you have python3-full installed.
+    
+    For more information visit http://rptl.io/venv
+
+note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
+hint: See PEP 668 for the detailed specification.
+```
+This is due to the fact that system python is not supposed to be managed by pip. You can simply use **pipx** to install **pyhw**. Or you can use a virtual environment (venv), conda environment or force remove this restriction (not recommended).

{pyhw-0.12.5.dist-info → pyhw-0.13.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-pyhw/__init__.py,sha256=faUs0tNZKI8zIxX-HDS9VUhJDeK8pDVQnHIopYeWQJA,49
+pyhw/__init__.py,sha256=LL9z_-DbQQS5lyyJjmes2IiQLVljZt3nxn-vbj1FN4s,49
 pyhw/__main__.py,sha256=oZpFtvSyYTM8cMsulvi51zJV0gtmw3OCQVdgoaHbtxc,4977
 pyhw/backend/__init__.py,sha256=X1D1D28lSojDrUzUolgJvmbuctwBh_UxG3FwUeL8adA,51
 pyhw/backend/backendBase.py,sha256=mloo8mPEbgbIdmyQ3I4vdEXMSSjxWi_wnwACmzvHbEo,506
@@ -16,13 +16,13 @@ pyhw/backend/gpu/gpuInfo.py,sha256=d_z_z5DiZAg85wP0VOBQEU0QHdaK3qFqA2Tp9Eq8-Zs,1
 pyhw/backend/gpu/linux.py,sha256=DQMayZINcQLJe4_Gm_SYWhG8gL1T0YcyP97TfEwYVis,3010
 pyhw/backend/gpu/macos.py,sha256=s-GZk_Q7K58nSOYuOIAYLRvLafwHyQtsWrPVe3CuXac,4068
 pyhw/backend/gpu/windows.py,sha256=9VlObAdcOXJyFFxHKHSnFdL07xiGZHNHwn6C843TfNg,1170
-pyhw/backend/host/__init__.py,sha256=Efaj7-Oya7H8HdpZHQCLrwn-mcfPb-d6yfh4dzsE_7I,58
+pyhw/backend/host/__init__.py,sha256=OmlSGjg3crlFcGz2FhBDyd35R7H0rriy3eq57y8h0_s,59
 pyhw/backend/host/bsd.py,sha256=xePlHfVYv7PSWMU1a7mTbMK3mzl2ssttkI13Xi5s00w,381
 pyhw/backend/host/hostBase.py,sha256=gM49SY6rEaxec_0bUOMk7QlEfR7vjfWp3BXEUqgdncc,762
 pyhw/backend/host/hostInfo.py,sha256=YUISVT-tumsU4M_b6tmeAq5-RBrW0K0c4_WoyR7xTeA,451
 pyhw/backend/host/linux.py,sha256=xvbZrwlKN--tKMf4_YyN20cGTSIcV5yLG3Gez7M15Pk,3157
-pyhw/backend/host/macos.py,sha256=RgDjvi8RsAs9i-bHkcSdK--TaeyaxYzLXFZFMl8T6Eo,16295
-pyhw/backend/host/windows.py,sha256=qn2QiTK2wIijyyw_QKdiSizY3teyS-9RNBu5RxEPRSw,1185
+pyhw/backend/host/macos.py,sha256=VYuO6zpEmBfII9FGLtqa10m-YwxrdCCSSsYp9G9AtWw,16275
+pyhw/backend/host/windows.py,sha256=RRsR8Ejlym66uJ3FopOCcPzZAkDKQu3Inq4KJ8kl0SI,1165
 pyhw/backend/kernel/__init__.py,sha256=fGjwjpOhwA_PnsWbwoq102hwhTay2ufYKaTqxjSV2-I,65
 pyhw/backend/kernel/kernelBase.py,sha256=3ZmkRkvwoWk3R-by2cgBlZnMSQzVjTC8Owmv53Pm4II,539
 pyhw/backend/kernel/kernelInfo.py,sha256=Nkumd0McbimCjc7yJrvz6bcwpWu1Tdo_LKomjZr7Jgk,341
@@ -116,9 +116,9 @@ pyhw/pyhwUtil/__init__.py,sha256=n3jWo-q-jSouXvUHMg45DOHS5xLRG64E02A9rDQb44M,323
 pyhw/pyhwUtil/cliUtil.py,sha256=_zNrhzQvrtqUp6xyZ0JTs_KyL1wvLji-nBmU65XA1aI,2342
 pyhw/pyhwUtil/pyhwUtil.py,sha256=_eUOHcuUqPHYuecDf0nEdF2GRuRJhW99MqYSJyZ4KUA,8270
 pyhw/pyhwUtil/sysctlUtil.py,sha256=S-rUvqi7ZrMyMouIhxlyHEQ4agM7sCT1Y7uzs3Hu5-o,841
-pyhw-0.12.5.dist-info/licenses/LICENSE,sha256=hJs6RBqSVCexbTsalkMLNFI5t06kekQEsSVaOt_-yLs,1497
-pyhw-0.12.5.dist-info/METADATA,sha256=MHtvwKQ2cyBZ648vAVq6QmbCt4tbfUIiCeKqHvEzFVI,6780
-pyhw-0.12.5.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-pyhw-0.12.5.dist-info/entry_points.txt,sha256=q-AB8im_QahpmNrmy4aPTJRGi0LlbNlnI3kF7s6pKss,44
-pyhw-0.12.5.dist-info/top_level.txt,sha256=7Inxvxt1TngEricKZEex9_WJZS3DbKYFUXDz4v5WHYU,5
-pyhw-0.12.5.dist-info/RECORD,,
+pyhw-0.13.1.dist-info/licenses/LICENSE,sha256=hJs6RBqSVCexbTsalkMLNFI5t06kekQEsSVaOt_-yLs,1497
+pyhw-0.13.1.dist-info/METADATA,sha256=Mq4S_h2DDMz3dvqSoa3Aawyl-C8nb0qBaw46ZgnloeY,7600
+pyhw-0.13.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyhw-0.13.1.dist-info/entry_points.txt,sha256=q-AB8im_QahpmNrmy4aPTJRGi0LlbNlnI3kF7s6pKss,44
+pyhw-0.13.1.dist-info/top_level.txt,sha256=7Inxvxt1TngEricKZEex9_WJZS3DbKYFUXDz4v5WHYU,5
+pyhw-0.13.1.dist-info/RECORD,,

{pyhw-0.12.5.dist-info → pyhw-0.13.1.dist-info}/WHEEL

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