quickspec 0.1.0__tar.gz

quickspec-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Henry Lok
+
+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.

quickspec-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: quickspec
+Version: 0.1.0
+Summary: 快速顯示電腦硬體規格的 CLI 工具
+Author: HenryLok0
+Requires-Python: >=3.7
+License-File: LICENSE
+Requires-Dist: psutil
+Requires-Dist: py-cpuinfo
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

quickspec-0.1.0/README.md

@@ -0,0 +1,110 @@
+
+
+# quickspec
+
+[![Code Size](https://img.shields.io/github/languages/code-size/HenryLok0/Quickspec?style=flat-square&logo=github)](https://github.com/HenryLok0/Quickspec)
+![PyPI - Version](https://img.shields.io/pypi/v/quickspec)
+[![MIT License](https://img.shields.io/github/license/HenryLok0/Quickspec?style=flat-square)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/HenryLok0/Quickspec?style=flat-square)](https://github.com/HenryLok0/Quickspec/stargazers)
+
+Instantly display your computer hardware specs in the terminal. Supports Windows/macOS/Linux. One command shows CPU, memory, disk, GPU, motherboard, BIOS, and more.
+
+## Features
+
+- One command for all major hardware specs
+- `--detail` flag shows motherboard, BIOS, network adapters, display resolution, boot time, cache, virtualization, battery, and more (Windows only)
+- Cross-platform: Windows, macOS, Linux
+- Minimal dependencies, easy installation
+
+## Installation
+
+```bash
+pip install quickspec
+```
+
+## Quick Start
+
+```bash
+# Install
+pip install quickspec
+
+# Show main hardware specs
+quickspec
+
+# Show all detailed hardware info (Windows)
+quickspec --detail
+```
+
+## Usage
+
+```bash
+# Basic usage
+quickspec
+
+# Show detailed info
+quickspec --detail
+```
+
+## Options
+
+| Option         | Description |
+|----------------|-------------|
+| `--detail`     | Show motherboard, BIOS, network adapters, display resolution, boot time, cache, virtualization, battery, and more (Windows only) |
+
+## Examples
+
+```bash
+# Show main hardware specs
+quickspec
+
+# Show all detailed hardware info
+quickspec --detail
+```
+
+## Comparison
+
+| Feature         | quickspec | lshw | inxi | dmidecode |
+|-----------------|-----------|------|------|-----------|
+| CPU/Memory/Disk | Yes       | Yes  | Yes  | Yes       |
+| GPU             | Yes       | Yes  | Yes  | No        |
+| Motherboard/BIOS| Yes (Win) | Yes  | Yes  | Yes       |
+| Battery         | Yes (Win) | No   | Yes  | No        |
+| One-line install| Yes       | No   | No   | No        |
+| Cross-platform  | Yes       | Partial| Partial| No    |
+
+## Why quickspec?
+
+- Instantly get all major hardware info for quick checks, reports, or sharing
+- Advanced details on Windows: motherboard, BIOS, battery, etc.
+- Minimal dependencies, easy install, no admin required
+- Cross-platform, works in any environment
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=HenryLok0/Quickspec&type=Date)](https://star-history.com/#HenryLok0/Quickspec&Date)
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+## Support
+
+If you have questions or suggestions, please open an issue on GitHub.
+
+Thanks to all contributors and the open-source community for your support!
+
+---
+
+## Troubleshooting
+
+- Command not found: try `python -m quickspec`.
+- Windows path/encoding issues: run from a local folder and ensure UTF-8 console.
+- Permission issues: if install or run fails, try running as administrator.

quickspec-0.1.0/quickspec/__init__.py

@@ -0,0 +1 @@
+# quickspec 套件初始化檔案

quickspec-0.1.0/quickspec/main.py

@@ -0,0 +1,177 @@
+import sys
+from datetime import datetime
+def get_detail():
+    detail = {}
+    if wmi:
+        c = wmi.WMI()
+        # 主機板型號
+        try:
+            board = c.Win32_BaseBoard()[0]
+            detail['Motherboard'] = f"{board.Manufacturer} {board.Product}"
+        except Exception:
+            detail['Motherboard'] = 'Unknown'
+        # BIOS 版本
+        try:
+            bios = c.Win32_BIOS()[0]
+            detail['BIOS'] = f"{bios.Manufacturer} {bios.SMBIOSBIOSVersion} ({bios.ReleaseDate})"
+        except Exception:
+            detail['BIOS'] = 'Unknown'
+        # 網路卡資訊
+        try:
+            nics = c.Win32_NetworkAdapter()
+            nic_list = [nic.Name for nic in nics if nic.PhysicalAdapter]
+            detail['Network Adapters'] = ', '.join(nic_list) if nic_list else 'None'
+        except Exception:
+            detail['Network Adapters'] = 'Unknown'
+        # 顯示器解析度
+        try:
+            screens = c.Win32_DesktopMonitor()
+            res_list = [f"{s.ScreenWidth}x{s.ScreenHeight}" for s in screens if s.ScreenWidth and s.ScreenHeight]
+            detail['Display Resolution'] = ', '.join(res_list) if res_list else 'Unknown'
+        except Exception:
+            detail['Display Resolution'] = 'Unknown'
+        # 系統開機時間
+        try:
+            os = c.Win32_OperatingSystem()[0]
+            boot_time = datetime.strptime(os.LastBootUpTime.split('.')[0], "%Y%m%d%H%M%S")
+            uptime = datetime.now() - boot_time
+            detail['Boot Time'] = boot_time.strftime('%Y-%m-%d %H:%M:%S')
+            detail['Uptime'] = str(uptime).split('.')[0]
+        except Exception:
+            detail['Boot Time'] = 'Unknown'
+            detail['Uptime'] = 'Unknown'
+        # 處理器快取（L2/L3）
+        try:
+            cpu = c.Win32_Processor()[0]
+            detail['CPU Cache'] = f"L2: {cpu.L2CacheSize} KB, L3: {cpu.L3CacheSize} KB"
+        except Exception:
+            detail['CPU Cache'] = 'Unknown'
+        # 虛擬化支援
+        try:
+            cpu = c.Win32_Processor()[0]
+            detail['Virtualization'] = 'Enabled' if getattr(cpu, 'VirtualizationFirmwareEnabled', False) else 'Disabled'
+        except Exception:
+            detail['Virtualization'] = 'Unknown'
+        # 電池資訊（筆電）
+        try:
+            batteries = c.Win32_Battery()
+            if batteries:
+                bat = batteries[0]
+                detail['Battery'] = f"{bat.Name}, {bat.EstimatedChargeRemaining}%"
+            else:
+                detail['Battery'] = 'No Battery'
+        except Exception:
+            detail['Battery'] = 'Unknown'
+    else:
+        detail['Detail'] = 'WMI not available on this system.'
+    return detail
+def print_detail():
+    detail = get_detail()
+    print("=== Computer Detail Information ===")
+    for k, v in detail.items():
+        print(f"{k}: {v}")
+import platform
+import psutil
+
+try:
+    import cpuinfo
+except ImportError:
+    cpuinfo = None
+import importlib
+GPUtil = None
+gputil_import_error = None
+try:
+    GPUtil = importlib.import_module('GPUtil')
+except Exception as e:
+    gputil_import_error = str(e)
+
+# WMI for Windows GPU detection
+wmi = None
+wmi_import_error = None
+try:
+    wmi = importlib.import_module('wmi')
+except Exception as e:
+    wmi_import_error = str(e)
+
+def get_spec():
+    info = {}
+    info['OS'] = platform.platform()
+    if cpuinfo:
+        cpu = cpuinfo.get_cpu_info()
+        cpu_name = cpu.get('brand_raw', 'Unknown')
+    else:
+        cpu_name = platform.processor() or 'Unknown'
+    cpu_cores = psutil.cpu_count(logical=False)
+    cpu_threads = psutil.cpu_count(logical=True)
+    info['CPU'] = f"{cpu_name} ({cpu_cores} Cores + {cpu_threads} Threads)"
+    info['CPU Frequency'] = f"{psutil.cpu_freq().current:.2f} MHz" if psutil.cpu_freq() else 'Unknown'
+    mem = psutil.virtual_memory()
+    mem_used = mem.used / (1024**3)
+    mem_total = mem.total / (1024**3)
+    mem_percent = mem.percent
+    info['Memory'] = f"{mem_used:.2f} GB / {mem_total:.2f} GB ({mem_percent:.1f}%)"
+
+    disk = psutil.disk_usage('/')
+    disk_total = disk.total / (1024**3)
+    disk_free = disk.free / (1024**3)
+    disk_used = disk_total - disk_free
+    disk_percent = disk.percent
+    info['Disk'] = f"{disk_used:.2f} GB / {disk_total:.2f} GB ({disk_percent:.1f}%)"
+    # GPU 資訊（優先使用 wmi，支援所有 Windows 顯示卡）
+    gpu_list = []
+    if wmi:
+        try:
+            c = wmi.WMI()
+            for gpu in c.Win32_VideoController():
+                name = gpu.Name
+                ram = int(gpu.AdapterRAM) // (1024**2) if gpu.AdapterRAM else 'Unknown'
+                gpu_list.append(f"{name} ({ram}MB)")
+        except Exception as e:
+            gpu_list.append(f"WMI error: {e}")
+    elif wmi_import_error:
+        gpu_list.append(f"WMI import error: {wmi_import_error}")
+    # 若 wmi 無法使用，則用 GPUtil
+    elif GPUtil:
+        gpus = GPUtil.getGPUs()
+        if gpus:
+            for idx, gpu in enumerate(gpus):
+                gpu_list.append(f"{gpu.name} ({gpu.driver}) {gpu.memoryTotal}MB")
+        else:
+            gpu_list.append('No GPU detected')
+    elif gputil_import_error:
+        gpu_list.append(f'GPUtil import error: {gputil_import_error}')
+    else:
+        gpu_list.append('No GPU detected')
+    # 顯示所有 GPU
+    for idx, gpu_info in enumerate(gpu_list):
+        info[f'GPU {idx+1}'] = gpu_info
+    return info
+
+def print_spec():
+    spec = get_spec()
+    print("=== Computer Specification ===")
+    # 顯示順序：OS, CPU, CPU Frequency, GPU, Memory, Disk
+    order = [
+        'OS',
+        'CPU',
+        'CPU Frequency',
+    ]
+    # GPU 可能有多個
+    gpu_keys = [k for k in spec.keys() if k.startswith('GPU')]
+    order.extend(gpu_keys)
+    order.extend([
+        'Memory',
+        'Disk',
+    ])
+    for k in order:
+        if k in spec:
+            print(f"{k}: {spec[k]}")
+
+if __name__ == "__main__":
+    if '--detail' in sys.argv:
+        print_spec()
+        print()
+        print_detail()
+        print()
+    else:
+        print_spec()

quickspec-0.1.0/quickspec.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: quickspec
+Version: 0.1.0
+Summary: 快速顯示電腦硬體規格的 CLI 工具
+Author: HenryLok0
+Requires-Python: >=3.7
+License-File: LICENSE
+Requires-Dist: psutil
+Requires-Dist: py-cpuinfo
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

quickspec-0.1.0/quickspec.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+setup.py
+quickspec/__init__.py
+quickspec/main.py
+quickspec.egg-info/PKG-INFO
+quickspec.egg-info/SOURCES.txt
+quickspec.egg-info/dependency_links.txt
+quickspec.egg-info/entry_points.txt
+quickspec.egg-info/requires.txt
+quickspec.egg-info/top_level.txt

quickspec-0.1.0/quickspec.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

quickspec-0.1.0/quickspec.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+quickspec = quickspec.main:print_spec

quickspec-0.1.0/quickspec.egg-info/requires.txt

@@ -0,0 +1,2 @@
+psutil
+py-cpuinfo

quickspec-0.1.0/quickspec.egg-info/top_level.txt

@@ -0,0 +1 @@
+quickspec

quickspec-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

quickspec-0.1.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name='quickspec',
+    version='0.1.0',
+    description='快速顯示電腦硬體規格的 CLI 工具',
+    author='HenryLok0',
+    packages=find_packages(),
+    install_requires=[
+        'psutil',
+        'py-cpuinfo',
+    ],
+    entry_points={
+        'console_scripts': [
+            'quickspec=quickspec.main:print_spec',
+        ],
+    },
+    python_requires='>=3.7',
+)