driver-inspector 0.1.0__tar.gz

driver_inspector-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Your Name
+
+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.

driver_inspector-0.1.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: driver-inspector
+Version: 0.1.0
+Summary: Trace hardware -> kernel driver -> device node on Linux. Great for debugging 'why isn't my board detected'.
+Author-email: Maan Jain <maanjain25@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/driver-inspector
+Project-URL: Issues, https://github.com/yourusername/driver-inspector/issues
+Keywords: linux,kernel,driver,embedded,usb,serial,sysfs,diagnostics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# driver-inspector
+
+Trace hardware → kernel driver → device node, on Linux, from the command line.
+
+If you've ever plugged in a USB-serial adapter, an Arduino, or a dev board and
+wondered *"why isn't /dev/ttyUSB0 showing up"* or *"which kernel module is
+actually handling this thing"*, this is for you.
+
+It reads `/sys/class/tty`, `/sys/class/net`, and USB sysfs entries directly —
+no root required for read-only inspection.
+
+## Install
+
+```bash
+pip install driver-inspector
+```
+
+> Linux only — it depends on `/sys` and `/dev`, which don't exist on macOS/Windows.
+
+## Usage
+
+List all serial devices and the kernel driver behind each one:
+
+```bash
+driver-inspector list-serial
+```
+
+```
+device          driver
+--------------  ------------
+/dev/ttyUSB0    ftdi_sio
+/dev/ttyACM0    cdc_acm
+```
+
+Inspect one device in detail (kernel driver, sysfs path, USB vendor/product ID):
+
+```bash
+driver-inspector inspect /dev/ttyUSB0
+```
+
+```
+device_node: /dev/ttyUSB0
+exists: True
+sys_path: /sys/class/tty/ttyUSB0
+driver: ftdi_sio
+usb_vendor_id: 0403
+usb_product_id: 6001
+```
+
+List network interfaces and their drivers:
+
+```bash
+driver-inspector list-net
+```
+
+Show raw `lsusb` output for cross-reference:
+
+```bash
+driver-inspector usb
+```
+
+## Why
+
+Linux's hardware → driver → device-node chain (USB descriptor → kernel module
+via `lsmod`/`modinfo` → `udev` → `/dev/*`) is not obvious to newcomers, and
+even experienced developers reach for a half-remembered chain of `lsusb`,
+`dmesg`, and `readlink` commands. This wraps that chain into one command.
+
+## Development
+
+```bash
+git clone https://github.com/yourusername/driver-inspector
+cd driver-inspector
+pip install -e .
+driver-inspector list-serial
+```
+
+## Publishing to PyPI
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## License
+
+MIT

driver_inspector-0.1.0/README.md

@@ -0,0 +1,88 @@
+# driver-inspector
+
+Trace hardware → kernel driver → device node, on Linux, from the command line.
+
+If you've ever plugged in a USB-serial adapter, an Arduino, or a dev board and
+wondered *"why isn't /dev/ttyUSB0 showing up"* or *"which kernel module is
+actually handling this thing"*, this is for you.
+
+It reads `/sys/class/tty`, `/sys/class/net`, and USB sysfs entries directly —
+no root required for read-only inspection.
+
+## Install
+
+```bash
+pip install driver-inspector
+```
+
+> Linux only — it depends on `/sys` and `/dev`, which don't exist on macOS/Windows.
+
+## Usage
+
+List all serial devices and the kernel driver behind each one:
+
+```bash
+driver-inspector list-serial
+```
+
+```
+device          driver
+--------------  ------------
+/dev/ttyUSB0    ftdi_sio
+/dev/ttyACM0    cdc_acm
+```
+
+Inspect one device in detail (kernel driver, sysfs path, USB vendor/product ID):
+
+```bash
+driver-inspector inspect /dev/ttyUSB0
+```
+
+```
+device_node: /dev/ttyUSB0
+exists: True
+sys_path: /sys/class/tty/ttyUSB0
+driver: ftdi_sio
+usb_vendor_id: 0403
+usb_product_id: 6001
+```
+
+List network interfaces and their drivers:
+
+```bash
+driver-inspector list-net
+```
+
+Show raw `lsusb` output for cross-reference:
+
+```bash
+driver-inspector usb
+```
+
+## Why
+
+Linux's hardware → driver → device-node chain (USB descriptor → kernel module
+via `lsmod`/`modinfo` → `udev` → `/dev/*`) is not obvious to newcomers, and
+even experienced developers reach for a half-remembered chain of `lsusb`,
+`dmesg`, and `readlink` commands. This wraps that chain into one command.
+
+## Development
+
+```bash
+git clone https://github.com/yourusername/driver-inspector
+cd driver-inspector
+pip install -e .
+driver-inspector list-serial
+```
+
+## Publishing to PyPI
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## License
+
+MIT

driver_inspector-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "driver-inspector"
+version = "0.1.0"
+description = "Trace hardware -> kernel driver -> device node on Linux. Great for debugging 'why isn't my board detected'."
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+authors = [
+    { name = "Maan Jain", email = "maanjain25@gmail.com" }
+]
+keywords = ["linux", "kernel", "driver", "embedded", "usb", "serial", "sysfs", "diagnostics"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Hardware",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/driver-inspector"
+Issues = "https://github.com/yourusername/driver-inspector/issues"
+
+[project.scripts]
+driver-inspector = "driver_inspector.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

driver_inspector-0.1.0/setup.cfg

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

driver_inspector-0.1.0/src/driver_inspector/__init__.py

@@ -0,0 +1,3 @@
+"""driver-inspector — trace hardware -> kernel driver -> device node on Linux."""
+
+__version__ = "0.1.0"

driver_inspector-0.1.0/src/driver_inspector/cli.py

@@ -0,0 +1,174 @@
+"""Core logic and CLI entry point for driver-inspector.
+
+Reads Linux's /sys and /dev to answer: for a given device, which kernel
+driver claimed it, and what does its sysfs entry look like.
+"""
+
+import argparse
+import os
+import subprocess
+import sys
+
+SYS_TTY = "/sys/class/tty"
+SYS_NET = "/sys/class/net"
+
+
+def get_driver_for_device(device_dir: str):
+    """Given a sysfs device directory, resolve the 'driver' symlink to a name."""
+    driver_link = os.path.join(device_dir, "driver")
+    if os.path.islink(driver_link):
+        target = os.readlink(driver_link)
+        return os.path.basename(target)
+    return None
+
+
+def find_usb_ids(start_path: str):
+    """Walk up the sysfs tree from a device path looking for idVendor/idProduct."""
+    vendor = product = None
+    current = start_path
+    for _ in range(8):
+        vendor_file = os.path.join(current, "idVendor")
+        product_file = os.path.join(current, "idProduct")
+        if os.path.isfile(vendor_file) and os.path.isfile(product_file):
+            with open(vendor_file) as f:
+                vendor = f.read().strip()
+            with open(product_file) as f:
+                product = f.read().strip()
+            break
+        parent = os.path.dirname(current)
+        if parent == current:
+            break
+        current = parent
+    return vendor, product
+
+
+def list_serial_devices():
+    """List every device under /sys/class/tty that has a real backing device."""
+    results = []
+    if not os.path.isdir(SYS_TTY):
+        return results
+    for name in sorted(os.listdir(SYS_TTY)):
+        device_dir = os.path.join(SYS_TTY, name, "device")
+        if os.path.exists(device_dir):
+            driver = get_driver_for_device(device_dir)
+            results.append({"name": name, "driver": driver})
+    return results
+
+
+def list_network_devices():
+    """List every device under /sys/class/net and its driver."""
+    results = []
+    if not os.path.isdir(SYS_NET):
+        return results
+    for name in sorted(os.listdir(SYS_NET)):
+        device_dir = os.path.join(SYS_NET, name, "device")
+        driver = get_driver_for_device(device_dir) if os.path.exists(device_dir) else None
+        results.append({"name": name, "driver": driver})
+    return results
+
+
+def inspect_device(path: str):
+    """Inspect a /dev/... node: does it exist, what claimed it, what's its USB ID."""
+    name = os.path.basename(path)
+    info = {"device_node": path, "exists": os.path.exists(path)}
+
+    candidates = [
+        os.path.join(SYS_TTY, name),
+        os.path.join(SYS_NET, name),
+        f"/sys/class/block/{name}",
+    ]
+    sys_path = next((c for c in candidates if os.path.isdir(c)), None)
+
+    if sys_path is None:
+        info["error"] = (
+            f"No matching entry found under /sys/class for '{name}'. "
+            "It may not be a tty/net/block device, or may not exist."
+        )
+        return info
+
+    device_dir = os.path.join(sys_path, "device")
+    real_device_dir = os.path.realpath(device_dir) if os.path.exists(device_dir) else None
+
+    info["sys_path"] = os.path.realpath(sys_path)
+    info["driver"] = get_driver_for_device(device_dir) if real_device_dir else None
+
+    if real_device_dir:
+        vendor, product = find_usb_ids(real_device_dir)
+        info["usb_vendor_id"] = vendor
+        info["usb_product_id"] = product
+
+    return info
+
+
+def run_lsusb():
+    try:
+        out = subprocess.run(["lsusb"], capture_output=True, text=True, timeout=5)
+        return out.stdout
+    except FileNotFoundError:
+        return None
+
+
+def print_table(rows, columns):
+    widths = [max(len(str(r.get(c, ""))) for r in rows + [dict(zip(columns, columns))]) for c in columns]
+    header = "  ".join(c.ljust(w) for c, w in zip(columns, widths))
+    print(header)
+    print("  ".join("-" * w for w in widths))
+    for r in rows:
+        print("  ".join(str(r.get(c, "") or "unknown").ljust(w) for c, w in zip(columns, widths)))
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="driver-inspector",
+        description="Trace hardware -> kernel driver -> device node on Linux.",
+    )
+    sub = parser.add_subparsers(dest="command")
+
+    sub.add_parser("list-serial", help="List tty/serial devices and their kernel drivers")
+    sub.add_parser("list-net", help="List network interfaces and their kernel drivers")
+
+    inspect_p = sub.add_parser("inspect", help="Inspect a specific device node")
+    inspect_p.add_argument("device", help="Device path, e.g. /dev/ttyUSB0")
+
+    sub.add_parser("usb", help="Show raw lsusb output")
+
+    args = parser.parse_args()
+
+    if sys.platform != "linux":
+        print("driver-inspector only supports Linux (it reads /sys and /dev directly).")
+        sys.exit(1)
+
+    if args.command == "list-serial":
+        devices = list_serial_devices()
+        if not devices:
+            print("No tty devices with a backing sysfs device found.")
+            return
+        print_table(
+            [{"device": f"/dev/{d['name']}", "driver": d["driver"]} for d in devices],
+            ["device", "driver"],
+        )
+    elif args.command == "list-net":
+        devices = list_network_devices()
+        if not devices:
+            print("No network devices found.")
+            return
+        print_table(
+            [{"interface": d["name"], "driver": d["driver"]} for d in devices],
+            ["interface", "driver"],
+        )
+    elif args.command == "inspect":
+        info = inspect_device(args.device)
+        for key, value in info.items():
+            print(f"{key}: {value}")
+    elif args.command == "usb":
+        out = run_lsusb()
+        if out:
+            print(out, end="")
+        else:
+            print("lsusb not found. Install usbutils: sudo apt-get install usbutils")
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

driver_inspector-0.1.0/src/driver_inspector.egg-info/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: driver-inspector
+Version: 0.1.0
+Summary: Trace hardware -> kernel driver -> device node on Linux. Great for debugging 'why isn't my board detected'.
+Author-email: Maan Jain <maanjain25@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/driver-inspector
+Project-URL: Issues, https://github.com/yourusername/driver-inspector/issues
+Keywords: linux,kernel,driver,embedded,usb,serial,sysfs,diagnostics
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# driver-inspector
+
+Trace hardware → kernel driver → device node, on Linux, from the command line.
+
+If you've ever plugged in a USB-serial adapter, an Arduino, or a dev board and
+wondered *"why isn't /dev/ttyUSB0 showing up"* or *"which kernel module is
+actually handling this thing"*, this is for you.
+
+It reads `/sys/class/tty`, `/sys/class/net`, and USB sysfs entries directly —
+no root required for read-only inspection.
+
+## Install
+
+```bash
+pip install driver-inspector
+```
+
+> Linux only — it depends on `/sys` and `/dev`, which don't exist on macOS/Windows.
+
+## Usage
+
+List all serial devices and the kernel driver behind each one:
+
+```bash
+driver-inspector list-serial
+```
+
+```
+device          driver
+--------------  ------------
+/dev/ttyUSB0    ftdi_sio
+/dev/ttyACM0    cdc_acm
+```
+
+Inspect one device in detail (kernel driver, sysfs path, USB vendor/product ID):
+
+```bash
+driver-inspector inspect /dev/ttyUSB0
+```
+
+```
+device_node: /dev/ttyUSB0
+exists: True
+sys_path: /sys/class/tty/ttyUSB0
+driver: ftdi_sio
+usb_vendor_id: 0403
+usb_product_id: 6001
+```
+
+List network interfaces and their drivers:
+
+```bash
+driver-inspector list-net
+```
+
+Show raw `lsusb` output for cross-reference:
+
+```bash
+driver-inspector usb
+```
+
+## Why
+
+Linux's hardware → driver → device-node chain (USB descriptor → kernel module
+via `lsmod`/`modinfo` → `udev` → `/dev/*`) is not obvious to newcomers, and
+even experienced developers reach for a half-remembered chain of `lsusb`,
+`dmesg`, and `readlink` commands. This wraps that chain into one command.
+
+## Development
+
+```bash
+git clone https://github.com/yourusername/driver-inspector
+cd driver-inspector
+pip install -e .
+driver-inspector list-serial
+```
+
+## Publishing to PyPI
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+## License
+
+MIT

driver_inspector-0.1.0/src/driver_inspector.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/driver_inspector/__init__.py
+src/driver_inspector/cli.py
+src/driver_inspector.egg-info/PKG-INFO
+src/driver_inspector.egg-info/SOURCES.txt
+src/driver_inspector.egg-info/dependency_links.txt
+src/driver_inspector.egg-info/entry_points.txt
+src/driver_inspector.egg-info/top_level.txt

driver_inspector-0.1.0/src/driver_inspector.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

driver_inspector-0.1.0/src/driver_inspector.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+driver-inspector = driver_inspector.cli:main

driver_inspector-0.1.0/src/driver_inspector.egg-info/top_level.txt

@@ -0,0 +1 @@
+driver_inspector