pyhw 0.12.5__tar.gz → 0.13.1__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.
Files changed (131) hide show
  1. {pyhw-0.12.5/src/pyhw.egg-info → pyhw-0.13.1}/PKG-INFO +49 -33
  2. {pyhw-0.12.5 → pyhw-0.13.1}/README.md +46 -29
  3. {pyhw-0.12.5 → pyhw-0.13.1}/pyproject.toml +3 -4
  4. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/__init__.py +1 -1
  5. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/__init__.py +1 -1
  6. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/macos.py +0 -3
  7. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/windows.py +0 -3
  8. {pyhw-0.12.5 → pyhw-0.13.1/src/pyhw.egg-info}/PKG-INFO +49 -33
  9. pyhw-0.13.1/src/pyhw.egg-info/requires.txt +1 -0
  10. pyhw-0.12.5/src/pyhw.egg-info/requires.txt +0 -1
  11. {pyhw-0.12.5 → pyhw-0.13.1}/LICENSE +0 -0
  12. {pyhw-0.12.5 → pyhw-0.13.1}/setup.cfg +0 -0
  13. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/__main__.py +0 -0
  14. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/__init__.py +0 -0
  15. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/backendBase.py +0 -0
  16. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/__init__.py +0 -0
  17. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/bsd.py +0 -0
  18. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/cpuBase.py +0 -0
  19. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/cpuInfo.py +0 -0
  20. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/linux.py +0 -0
  21. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/macos.py +0 -0
  22. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/cpu/windows.py +0 -0
  23. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/__init__.py +0 -0
  24. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/bsd.py +0 -0
  25. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/gpuBase.py +0 -0
  26. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/gpuInfo.py +0 -0
  27. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/linux.py +0 -0
  28. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/macos.py +0 -0
  29. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/gpu/windows.py +0 -0
  30. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/bsd.py +0 -0
  31. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/hostBase.py +0 -0
  32. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/hostInfo.py +0 -0
  33. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/host/linux.py +0 -0
  34. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/kernel/__init__.py +0 -0
  35. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/kernel/kernelBase.py +0 -0
  36. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/kernel/kernelInfo.py +0 -0
  37. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/kernel/unix.py +0 -0
  38. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/kernel/windows.py +0 -0
  39. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/__init__.py +0 -0
  40. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/bsd.py +0 -0
  41. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/linux.py +0 -0
  42. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/macos.py +0 -0
  43. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/memoryBase.py +0 -0
  44. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/memoryInfo.py +0 -0
  45. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/memory/windows.py +0 -0
  46. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/__init__.py +0 -0
  47. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/bsd.py +0 -0
  48. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/linux.py +0 -0
  49. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/macos.py +0 -0
  50. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/nicBase.py +0 -0
  51. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/nicInfo.py +0 -0
  52. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/nic/windows.py +0 -0
  53. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/__init__.py +0 -0
  54. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/bsd.py +0 -0
  55. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/linux.py +0 -0
  56. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/macos.py +0 -0
  57. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/npuBase.py +0 -0
  58. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/npuInfo.py +0 -0
  59. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/npu/windows.py +0 -0
  60. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/__init__.py +0 -0
  61. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/bsd.py +0 -0
  62. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/linux.py +0 -0
  63. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/macos.py +0 -0
  64. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/osBase.py +0 -0
  65. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/osInfo.py +0 -0
  66. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/os/windows.py +0 -0
  67. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/shell/__init__.py +0 -0
  68. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/shell/shellBase.py +0 -0
  69. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/shell/shellInfo.py +0 -0
  70. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/shell/unix.py +0 -0
  71. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/shell/windows.py +0 -0
  72. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/title/__init__.py +0 -0
  73. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/title/titleBase.py +0 -0
  74. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/title/titleInfo.py +0 -0
  75. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/title/unix.py +0 -0
  76. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/title/windows.py +0 -0
  77. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/__init__.py +0 -0
  78. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/bsd.py +0 -0
  79. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/linux.py +0 -0
  80. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/macos.py +0 -0
  81. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/uptimeBase.py +0 -0
  82. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/uptimeInfo.py +0 -0
  83. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/backend/uptime/windows.py +0 -0
  84. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/__init__.py +0 -0
  85. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/color/__init__.py +0 -0
  86. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/color/colorConfig.py +0 -0
  87. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/color/colorSet.py +0 -0
  88. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/color/colorUtil.py +0 -0
  89. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/frontendBase.py +0 -0
  90. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/__init__.py +0 -0
  91. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/alpine.pyhw +0 -0
  92. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/arch.pyhw +0 -0
  93. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/armbian.pyhw +0 -0
  94. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/centos.pyhw +0 -0
  95. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/debian.pyhw +0 -0
  96. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/fedora.pyhw +0 -0
  97. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/fedora_small.pyhw +0 -0
  98. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/freebsd.pyhw +0 -0
  99. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/kali.pyhw +0 -0
  100. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/linux.pyhw +0 -0
  101. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/linuxmint.pyhw +0 -0
  102. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/macOS.pyhw +0 -0
  103. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/opensuse-leap.pyhw +0 -0
  104. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/opensuse-tumbleweed.pyhw +0 -0
  105. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/raspbian.pyhw +0 -0
  106. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/rhel.pyhw +0 -0
  107. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/ubuntu.pyhw +0 -0
  108. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/ubuntu_small.pyhw +0 -0
  109. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/windows_10.pyhw +0 -0
  110. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/windows_11.pyhw +0 -0
  111. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/windows_2025.pyhw +0 -0
  112. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/ascii/windows_old.pyhw +0 -0
  113. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/frontend/logo/logoBase.py +0 -0
  114. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/lib/iokitCPULib.dylib +0 -0
  115. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/lib/iokitGPULib.dylib +0 -0
  116. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/lib/iokitHostLib.dylib +0 -0
  117. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/lib/nvmlGPULib_amd64.so +0 -0
  118. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/lib/nvmlGPULib_arm64.so +0 -0
  119. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/test/iokitHostLibTest.py +0 -0
  120. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/library/test/nvmlGPULibTest.py +0 -0
  121. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/pyhwException/__init__.py +0 -0
  122. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/pyhwException/pyhwException.py +0 -0
  123. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/pyhwUtil/__init__.py +0 -0
  124. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/pyhwUtil/cliUtil.py +0 -0
  125. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/pyhwUtil/pyhwUtil.py +0 -0
  126. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw/pyhwUtil/sysctlUtil.py +0 -0
  127. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw.egg-info/SOURCES.txt +0 -0
  128. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw.egg-info/dependency_links.txt +0 -0
  129. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw.egg-info/entry_points.txt +0 -0
  130. {pyhw-0.12.5 → pyhw-0.13.1}/src/pyhw.egg-info/top_level.txt +0 -0
  131. {pyhw-0.12.5 → pyhw-0.13.1}/test/test_cliUtil.py +0 -0
@@ -1,23 +1,22 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pyhw
3
- Version: 0.12.5
3
+ Version: 0.13.1
4
4
  Summary: PyHw, a neofetch-like command line tool for fetching system information but written mostly in python.
5
5
  Author: Xiao Ran
6
6
  Maintainer-email: Xiao Ran <xiaoran.007@icloud.com>
7
- License: BSD-3-Clause
7
+ License-Expression: BSD-3-Clause
8
8
  Project-URL: homepage, https://github.com/xiaoran007/pyhw
9
9
  Keywords: neofetch,system information,command line tool,python,hardware information,fastfetch,fetching
10
10
  Classifier: Development Status :: 4 - Beta
11
11
  Classifier: Programming Language :: Python :: 3
12
- Classifier: License :: OSI Approved :: BSD License
13
12
  Classifier: Operating System :: OS Independent
14
13
  Requires-Python: >=3.9
15
14
  Description-Content-Type: text/markdown
16
15
  License-File: LICENSE
17
- Requires-Dist: pypci-ng>=0.2.2
16
+ Requires-Dist: pypci-ng>=0.2.4
18
17
  Dynamic: license-file
19
18
 
20
- # PyHw
19
+ # PyHw, a neofetch-like system information fetching tool
21
20
  [![Downloads](https://static.pepy.tech/badge/pyhw)](https://pepy.tech/project/pyhw)
22
21
  ![PyPI - Version](https://img.shields.io/pypi/v/pyhw?label=version)
23
22
  ![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
40
39
 
41
40
  [//]: # (![demo]&#40;https://i2.imgs.ovh/d/BQACAgUAAx0EUvSR8wACMvpmyFVohzKxLcUdLiJaEa3wlo_OrQACuw4AAoX-QVaSpG0-rTAeRTUE&#41;)
42
41
  [//]: # (![demo]&#40;https://files.catbox.moe/xx58xy.jpg&#41;)
43
- ![demo](https://files.catbox.moe/2d21fu.jpg)
42
+ [//]: # (![demo]&#40;https://files.catbox.moe/2d21fu.jpg&#41;)
44
43
 
44
+ ![demo](https://files.catbox.moe/ik4ioi.png)
45
45
 
46
46
 
47
+ - [1. Install](#1-install)
48
+ - [2. Usability](#2-usability)
49
+ - [3. Add Logo](#3-add-logo)
50
+ - [4. Build from source](#4-build-from-source)
51
+ - [5. Test Package](#5-test-package)
52
+ - [6. Troubleshooting](#6-troubleshooting)
53
+
47
54
 
48
55
  ## 1. Install
49
56
  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
80
87
  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__.
81
88
 
82
89
 
83
- ### 1.3 Important note about debian 12:
84
- If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
85
- ```text
86
- error: externally-managed-environment
87
-
88
- × This environment is externally managed
89
- ╰─> To install Python packages system-wide, try apt install
90
- python3-xyz, where xyz is the package you are trying to
91
- install.
92
-
93
- If you wish to install a non-Debian-packaged Python package,
94
- create a virtual environment using python3 -m venv path/to/venv.
95
- Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
96
- sure you have python3-full installed.
97
-
98
- For more information visit http://rptl.io/venv
90
+ ## 2. Usability
91
+ ### Tested Platform
92
+ The following platforms have been tested and are known to work with this package:
93
+ * macOS: arm64, x86_64
94
+ * Linux: arm64, x86_64, riscv64, ppc64le, mips64el, s390x
95
+ * FreeBSD: arm64, x86_64
96
+ * Windows 10: x86_64
97
+ * Windows 11: arm64, x86_64
99
98
 
100
- 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.
101
- hint: See PEP 668 for the detailed specification.
102
- ```
103
- 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).
99
+ For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
104
100
 
105
- ## 2. Tested OS
106
- * macOS arm64, x86_64
107
- * Linux arm64, x86_64, riscv64
108
- * FreeBSD arm64
109
- * Windows 10 x86_64
110
- * Windows 11 arm64, x86_64
101
+ Please note that this package requires `Python 3.9`, so very old versions of Linux may not be supported.
111
102
 
112
- For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
103
+ ### Features
104
+ The functionality of this package varies slightly on different operating systems and architectures, please refer to [this](docs/functionality.md) documentation for details.
113
105
 
114
106
  ## 3. Add Logo
115
107
  1. Create a file named **\<os>.pyhw** in **logo/ascii** folder
116
108
  2. Modify **colorConfig.py** file to add a new logo style
117
109
  3. Update **pyhwUtil.py** to enable new logo style.
110
+ 4. You may create a new `PR` to add your logo style to the main repository.
118
111
 
119
112
  ## 4. Build from source
120
113
 
@@ -158,3 +151,26 @@ If you have docker installed, you can test this package through docker by type:
158
151
  make test # local build
159
152
  make test-pypi # release version
160
153
  ```
154
+
155
+ ## 6. Troubleshooting
156
+ ### 6.1 Important note about debian 12:
157
+ If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
158
+ ```text
159
+ error: externally-managed-environment
160
+
161
+ × This environment is externally managed
162
+ ╰─> To install Python packages system-wide, try apt install
163
+ python3-xyz, where xyz is the package you are trying to
164
+ install.
165
+
166
+ If you wish to install a non-Debian-packaged Python package,
167
+ create a virtual environment using python3 -m venv path/to/venv.
168
+ Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
169
+ sure you have python3-full installed.
170
+
171
+ For more information visit http://rptl.io/venv
172
+
173
+ 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.
174
+ hint: See PEP 668 for the detailed specification.
175
+ ```
176
+ 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).
@@ -1,4 +1,4 @@
1
- # PyHw
1
+ # PyHw, a neofetch-like system information fetching tool
2
2
  [![Downloads](https://static.pepy.tech/badge/pyhw)](https://pepy.tech/project/pyhw)
3
3
  ![PyPI - Version](https://img.shields.io/pypi/v/pyhw?label=version)
4
4
  ![Static Badge](https://img.shields.io/badge/Python-3.9%2B-green)
@@ -21,10 +21,18 @@ This project is a Python reimplementation of [neofetch](https://github.com/dylan
21
21
 
22
22
  [//]: # (![demo]&#40;https://i2.imgs.ovh/d/BQACAgUAAx0EUvSR8wACMvpmyFVohzKxLcUdLiJaEa3wlo_OrQACuw4AAoX-QVaSpG0-rTAeRTUE&#41;)
23
23
  [//]: # (![demo]&#40;https://files.catbox.moe/xx58xy.jpg&#41;)
24
- ![demo](https://files.catbox.moe/2d21fu.jpg)
24
+ [//]: # (![demo]&#40;https://files.catbox.moe/2d21fu.jpg&#41;)
25
25
 
26
+ ![demo](https://files.catbox.moe/ik4ioi.png)
26
27
 
27
28
 
29
+ - [1. Install](#1-install)
30
+ - [2. Usability](#2-usability)
31
+ - [3. Add Logo](#3-add-logo)
32
+ - [4. Build from source](#4-build-from-source)
33
+ - [5. Test Package](#5-test-package)
34
+ - [6. Troubleshooting](#6-troubleshooting)
35
+
28
36
 
29
37
  ## 1. Install
30
38
  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.
@@ -61,41 +69,27 @@ python -m pyhw
61
69
  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__.
62
70
 
63
71
 
64
- ### 1.3 Important note about debian 12:
65
- If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
66
- ```text
67
- error: externally-managed-environment
68
-
69
- × This environment is externally managed
70
- ╰─> To install Python packages system-wide, try apt install
71
- python3-xyz, where xyz is the package you are trying to
72
- install.
73
-
74
- If you wish to install a non-Debian-packaged Python package,
75
- create a virtual environment using python3 -m venv path/to/venv.
76
- Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
77
- sure you have python3-full installed.
78
-
79
- For more information visit http://rptl.io/venv
72
+ ## 2. Usability
73
+ ### Tested Platform
74
+ The following platforms have been tested and are known to work with this package:
75
+ * macOS: arm64, x86_64
76
+ * Linux: arm64, x86_64, riscv64, ppc64le, mips64el, s390x
77
+ * FreeBSD: arm64, x86_64
78
+ * Windows 10: x86_64
79
+ * Windows 11: arm64, x86_64
80
80
 
81
- 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.
82
- hint: See PEP 668 for the detailed specification.
83
- ```
84
- 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).
81
+ For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
85
82
 
86
- ## 2. Tested OS
87
- * macOS arm64, x86_64
88
- * Linux arm64, x86_64, riscv64
89
- * FreeBSD arm64
90
- * Windows 10 x86_64
91
- * Windows 11 arm64, x86_64
83
+ Please note that this package requires `Python 3.9`, so very old versions of Linux may not be supported.
92
84
 
93
- For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
85
+ ### Features
86
+ The functionality of this package varies slightly on different operating systems and architectures, please refer to [this](docs/functionality.md) documentation for details.
94
87
 
95
88
  ## 3. Add Logo
96
89
  1. Create a file named **\<os>.pyhw** in **logo/ascii** folder
97
90
  2. Modify **colorConfig.py** file to add a new logo style
98
91
  3. Update **pyhwUtil.py** to enable new logo style.
92
+ 4. You may create a new `PR` to add your logo style to the main repository.
99
93
 
100
94
  ## 4. Build from source
101
95
 
@@ -139,3 +133,26 @@ If you have docker installed, you can test this package through docker by type:
139
133
  make test # local build
140
134
  make test-pypi # release version
141
135
  ```
136
+
137
+ ## 6. Troubleshooting
138
+ ### 6.1 Important note about debian 12:
139
+ If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
140
+ ```text
141
+ error: externally-managed-environment
142
+
143
+ × This environment is externally managed
144
+ ╰─> To install Python packages system-wide, try apt install
145
+ python3-xyz, where xyz is the package you are trying to
146
+ install.
147
+
148
+ If you wish to install a non-Debian-packaged Python package,
149
+ create a virtual environment using python3 -m venv path/to/venv.
150
+ Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
151
+ sure you have python3-full installed.
152
+
153
+ For more information visit http://rptl.io/venv
154
+
155
+ 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.
156
+ hint: See PEP 668 for the detailed specification.
157
+ ```
158
+ 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).
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "pyhw"
7
- version = "0.12.5"
7
+ version = "0.13.1"
8
8
  description = "PyHw, a neofetch-like command line tool for fetching system information but written mostly in python."
9
9
  keywords = ["neofetch", "system information", "command line tool", "python", "hardware information", "fastfetch", "fetching"]
10
10
  authors = [
@@ -14,15 +14,14 @@ maintainers = [
14
14
  {name = "Xiao Ran", email="xiaoran.007@icloud.com"},
15
15
  ]
16
16
  readme = "README.md"
17
- license = {text = "BSD-3-Clause"}
17
+ license = "BSD-3-Clause"
18
18
  requires-python = ">=3.9"
19
19
  dependencies = [
20
- "pypci-ng>=0.2.2"
20
+ "pypci-ng>=0.2.4"
21
21
  ]
22
22
  classifiers = [
23
23
  "Development Status :: 4 - Beta",
24
24
  "Programming Language :: Python :: 3",
25
- "License :: OSI Approved :: BSD License",
26
25
  "Operating System :: OS Independent"
27
26
  ]
28
27
  urls = {homepage = "https://github.com/xiaoran007/pyhw"}
@@ -1,2 +1,2 @@
1
- __version__ = '0.12.5'
1
+ __version__ = '0.13.1'
2
2
  __author__ = 'xiaoran007'
@@ -1,3 +1,3 @@
1
1
  from .hostBase import HostDetect
2
2
 
3
- __all__ = ["HostDetect"]
3
+ __all__ = ["HostDetect"]
@@ -1,6 +1,3 @@
1
- """
2
- In dev.
3
- """
4
1
  from .hostInfo import HostInfo
5
2
  from ...pyhwUtil import sysctlGetString
6
3
  import ctypes
@@ -1,6 +1,3 @@
1
- """
2
- In dev.
3
- """
4
1
  from ...pyhwUtil import getArch
5
2
  from ...pyhwException import BackendException
6
3
  from .hostInfo import HostInfo
@@ -1,23 +1,22 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: pyhw
3
- Version: 0.12.5
3
+ Version: 0.13.1
4
4
  Summary: PyHw, a neofetch-like command line tool for fetching system information but written mostly in python.
5
5
  Author: Xiao Ran
6
6
  Maintainer-email: Xiao Ran <xiaoran.007@icloud.com>
7
- License: BSD-3-Clause
7
+ License-Expression: BSD-3-Clause
8
8
  Project-URL: homepage, https://github.com/xiaoran007/pyhw
9
9
  Keywords: neofetch,system information,command line tool,python,hardware information,fastfetch,fetching
10
10
  Classifier: Development Status :: 4 - Beta
11
11
  Classifier: Programming Language :: Python :: 3
12
- Classifier: License :: OSI Approved :: BSD License
13
12
  Classifier: Operating System :: OS Independent
14
13
  Requires-Python: >=3.9
15
14
  Description-Content-Type: text/markdown
16
15
  License-File: LICENSE
17
- Requires-Dist: pypci-ng>=0.2.2
16
+ Requires-Dist: pypci-ng>=0.2.4
18
17
  Dynamic: license-file
19
18
 
20
- # PyHw
19
+ # PyHw, a neofetch-like system information fetching tool
21
20
  [![Downloads](https://static.pepy.tech/badge/pyhw)](https://pepy.tech/project/pyhw)
22
21
  ![PyPI - Version](https://img.shields.io/pypi/v/pyhw?label=version)
23
22
  ![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
40
39
 
41
40
  [//]: # (![demo]&#40;https://i2.imgs.ovh/d/BQACAgUAAx0EUvSR8wACMvpmyFVohzKxLcUdLiJaEa3wlo_OrQACuw4AAoX-QVaSpG0-rTAeRTUE&#41;)
42
41
  [//]: # (![demo]&#40;https://files.catbox.moe/xx58xy.jpg&#41;)
43
- ![demo](https://files.catbox.moe/2d21fu.jpg)
42
+ [//]: # (![demo]&#40;https://files.catbox.moe/2d21fu.jpg&#41;)
44
43
 
44
+ ![demo](https://files.catbox.moe/ik4ioi.png)
45
45
 
46
46
 
47
+ - [1. Install](#1-install)
48
+ - [2. Usability](#2-usability)
49
+ - [3. Add Logo](#3-add-logo)
50
+ - [4. Build from source](#4-build-from-source)
51
+ - [5. Test Package](#5-test-package)
52
+ - [6. Troubleshooting](#6-troubleshooting)
53
+
47
54
 
48
55
  ## 1. Install
49
56
  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
80
87
  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__.
81
88
 
82
89
 
83
- ### 1.3 Important note about debian 12:
84
- If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
85
- ```text
86
- error: externally-managed-environment
87
-
88
- × This environment is externally managed
89
- ╰─> To install Python packages system-wide, try apt install
90
- python3-xyz, where xyz is the package you are trying to
91
- install.
92
-
93
- If you wish to install a non-Debian-packaged Python package,
94
- create a virtual environment using python3 -m venv path/to/venv.
95
- Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
96
- sure you have python3-full installed.
97
-
98
- For more information visit http://rptl.io/venv
90
+ ## 2. Usability
91
+ ### Tested Platform
92
+ The following platforms have been tested and are known to work with this package:
93
+ * macOS: arm64, x86_64
94
+ * Linux: arm64, x86_64, riscv64, ppc64le, mips64el, s390x
95
+ * FreeBSD: arm64, x86_64
96
+ * Windows 10: x86_64
97
+ * Windows 11: arm64, x86_64
99
98
 
100
- 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.
101
- hint: See PEP 668 for the detailed specification.
102
- ```
103
- 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).
99
+ For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
104
100
 
105
- ## 2. Tested OS
106
- * macOS arm64, x86_64
107
- * Linux arm64, x86_64, riscv64
108
- * FreeBSD arm64
109
- * Windows 10 x86_64
110
- * Windows 11 arm64, x86_64
101
+ Please note that this package requires `Python 3.9`, so very old versions of Linux may not be supported.
111
102
 
112
- For more detailed information, please refer to [Tested Platform](docs/tested_platform.md).
103
+ ### Features
104
+ The functionality of this package varies slightly on different operating systems and architectures, please refer to [this](docs/functionality.md) documentation for details.
113
105
 
114
106
  ## 3. Add Logo
115
107
  1. Create a file named **\<os>.pyhw** in **logo/ascii** folder
116
108
  2. Modify **colorConfig.py** file to add a new logo style
117
109
  3. Update **pyhwUtil.py** to enable new logo style.
110
+ 4. You may create a new `PR` to add your logo style to the main repository.
118
111
 
119
112
  ## 4. Build from source
120
113
 
@@ -158,3 +151,26 @@ If you have docker installed, you can test this package through docker by type:
158
151
  make test # local build
159
152
  make test-pypi # release version
160
153
  ```
154
+
155
+ ## 6. Troubleshooting
156
+ ### 6.1 Important note about debian 12:
157
+ If you use system pip to install pyhw, you will encounter this problem on debian12 and some related distributions (like Ubuntu 24.04):
158
+ ```text
159
+ error: externally-managed-environment
160
+
161
+ × This environment is externally managed
162
+ ╰─> To install Python packages system-wide, try apt install
163
+ python3-xyz, where xyz is the package you are trying to
164
+ install.
165
+
166
+ If you wish to install a non-Debian-packaged Python package,
167
+ create a virtual environment using python3 -m venv path/to/venv.
168
+ Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make
169
+ sure you have python3-full installed.
170
+
171
+ For more information visit http://rptl.io/venv
172
+
173
+ 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.
174
+ hint: See PEP 668 for the detailed specification.
175
+ ```
176
+ 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).
@@ -0,0 +1 @@
1
+ pypci-ng>=0.2.4
@@ -1 +0,0 @@
1
- pypci-ng>=0.2.2
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes