# pypci-ng
[![Downloads](https://static.pepy.tech/badge/pypci-ng)](https://pepy.tech/project/pypci-ng)
![PyPI - Version](https://img.shields.io/pypi/v/pypci-ng?label=version)
![Static Badge](https://img.shields.io/badge/Linux-blue)
![Static Badge](https://img.shields.io/badge/Windows-yellow)
pypci-ng, a pciutils-like library for fetching system PCI/PCI-E devices but written mostly in python.
![demo0](https://files.catbox.moe/mku1dg.png)
![demo1](https://files.catbox.moe/scnd3j.png)
## Install
Just install it directly by pip.
```shell
pip install pypci-ng
```
To upgrade pypci:
```shell
pip install pypci-ng --upgrade
```
## Usage
### Use as a command line tool
You can use this tool directly from the command line with the following command, just like lspci.
```shell
pypci
```
Or use -d flag to print driver information.
```shell
pypci -d
```
For more command line flags, see:
```shell
pypci -h
```
Please note that the command line entry for __pypci__ 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__.
### Use as a Python Package
You can also use this package in Python, here is the demo:
```python
import pypci
pci = pypci.PCI()
vga_devices = pci.FindAllVGA()
nic_devices = pci.FindAllNIC()
```
More functionalities are under development.
## Supported (Tested) OS
* Linux
* Windows 10 and above
## Build from source
### Build tools
Make sure the following Python build tools are already installed.
* setuptools
* build
* twine
### Build package
clone the project, and run:
```shell
python -m build
```
After the build process, the source package and the binary whl package can be found in the dist folder.
Raw data
{
"_id": null,
"home_page": null,
"name": "pypci-ng",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "pci, system information, pciutils, python, lspci, hardware information, fetching, pcie",
"author": null,
"author_email": "Xiao Ran <xiaoran.007@icloud.com>",
"download_url": "https://files.pythonhosted.org/packages/4f/6e/579a4bc20427c683966964de2ef23205b4c5fc11e872769f5b8b3f11cf0b/pypci_ng-0.1.2.tar.gz",
"platform": null,
"description": "# pypci-ng\n[![Downloads](https://static.pepy.tech/badge/pypci-ng)](https://pepy.tech/project/pypci-ng)\n![PyPI - Version](https://img.shields.io/pypi/v/pypci-ng?label=version)\n\n![Static Badge](https://img.shields.io/badge/Linux-blue)\n![Static Badge](https://img.shields.io/badge/Windows-yellow)\n\n\npypci-ng, a pciutils-like library for fetching system PCI/PCI-E devices but written mostly in python.\n\n\n![demo0](https://files.catbox.moe/mku1dg.png)\n\n\n![demo1](https://files.catbox.moe/scnd3j.png)\n\n## Install\nJust install it directly by pip.\n```shell\npip install pypci-ng\n```\nTo upgrade pypci:\n```shell\npip install pypci-ng --upgrade\n```\n\n## Usage\n### Use as a command line tool\nYou can use this tool directly from the command line with the following command, just like lspci.\n```shell\npypci\n```\nOr use -d flag to print driver information.\n```shell\npypci -d\n```\nFor more command line flags, see:\n```shell\npypci -h\n```\nPlease note that the command line entry for __pypci__ 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__.\n\n### Use as a Python Package\nYou can also use this package in Python, here is the demo:\n```python\nimport pypci\npci = pypci.PCI()\nvga_devices = pci.FindAllVGA()\nnic_devices = pci.FindAllNIC()\n```\nMore functionalities are under development.\n\n## Supported (Tested) OS\n* Linux\n* Windows 10 and above\n\n\n## Build from source\n### Build tools\nMake sure the following Python build tools are already installed.\n* setuptools\n* build\n* twine\n\n### Build package\nclone the project, and run:\n```shell\npython -m build\n```\nAfter the build process, the source package and the binary whl package can be found in the dist folder.\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "pypci, a pciutils-like library for fetching system PCI/PCI-E information but written mostly in python.",
"version": "0.1.2",
"project_urls": {
"homepage": "https://github.com/xiaoran007/pypci"
},
"split_keywords": [
"pci",
" system information",
" pciutils",
" python",
" lspci",
" hardware information",
" fetching",
" pcie"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "182057a0a7263b136db3873f5a3025634cabd9f74b45d33938576d0ea0ef0148",
"md5": "669c9ddf7dfa248bb2a7ee38e5a88763",
"sha256": "e280603a54680ea794dd562c2fbcab33830e82944980286686e35285b1c02fc3"
},
"downloads": -1,
"filename": "pypci_ng-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "669c9ddf7dfa248bb2a7ee38e5a88763",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 1029074,
"upload_time": "2025-01-21T09:43:15",
"upload_time_iso_8601": "2025-01-21T09:43:15.454654Z",
"url": "https://files.pythonhosted.org/packages/18/20/57a0a7263b136db3873f5a3025634cabd9f74b45d33938576d0ea0ef0148/pypci_ng-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4f6e579a4bc20427c683966964de2ef23205b4c5fc11e872769f5b8b3f11cf0b",
"md5": "fef7f0348d623cd9d8c90ed7cbe2a997",
"sha256": "0aaefa5cc1ab10d0bf8a397225372021fab59a6649876df73ba82f73a3650e08"
},
"downloads": -1,
"filename": "pypci_ng-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "fef7f0348d623cd9d8c90ed7cbe2a997",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 995671,
"upload_time": "2025-01-21T09:43:19",
"upload_time_iso_8601": "2025-01-21T09:43:19.395303Z",
"url": "https://files.pythonhosted.org/packages/4f/6e/579a4bc20427c683966964de2ef23205b4c5fc11e872769f5b8b3f11cf0b/pypci_ng-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 09:43:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xiaoran007",
"github_project": "pypci",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pypci-ng"
}