Refactor logging in CLI for NanoKVM devices

.gitignore

@@ -1,7 +1,13 @@
 .venv/
 __pycache__/
 *.pyc
-*.pyo
-*.pyd
-*.pyw
-*.pyz
+.pytest_cache/
+.ruff_cache/
+.vscode/
+.idea/
+.DS_Store
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local

docs/API.md

@@ -1,6 +1,6 @@
 # nanokvm API Reference
 
-**Version:** 0.1.2
+**Version:** 0.1.3
 **License:** MIT
 **Python:** >= 3.12
 

main.py

@@ -1,26 +1,29 @@
 """Quick CLI to list available NanoKVM devices and test connectivity."""
 
 from nanokvm import SerialConnection, VideoCapture
+from nanokvm._logger import get_logger
+
+logger = get_logger(__name__)
 
 
 def main() -> None:
-    print("=== Available Serial Ports ===")
+    logger.info("=== Available Serial Ports ===")
     ports = SerialConnection.list_ports()
     if ports:
         for p in ports:
-            print(f"  {p.device}: {p.description} [{p.hwid}]")
+            logger.info(f"  {p.device}: {p.description} [{p.hwid}]")
     else:
-        print("  (none found)")
+        logger.info("  (none found)")
 
-    print("\n=== Available Video Devices ===")
+    logger.info("\n=== Available Video Devices ===")
     devices = VideoCapture.list_devices()
     if devices:
         for d in devices:
-            print(
+            logger.info(
                 f"  Index {d['index']}: {d['width']}x{d['height']} @ {d['fps']}fps ({d['backend']})"
             )
     else:
-        print("  (none found)")
+        logger.info("  (none found)")
 
 
 if __name__ == "__main__":

nanokvm/__init__.py

@@ -26,7 +26,7 @@
 from .serial_conn import SerialConnection
 from .video import VideoCapture
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"
 
 __all__ = [
     "NanoKVM",

nanokvm/__main__.py

@@ -1,26 +1,29 @@
 """Quick CLI to list available NanoKVM devices and test connectivity."""
 
 from nanokvm import SerialConnection, VideoCapture
+from nanokvm._logger import get_logger
+
+logger = get_logger(__name__)
 
 
 def main() -> None:
-    print("=== Available Serial Ports ===")
+    logger.info("=== Available Serial Ports ===")
     ports = SerialConnection.list_ports()
     if ports:
         for p in ports:
-            print(f"  {p.device}: {p.description} [{p.hwid}]")
+            logger.info(f"  {p.device}: {p.description} [{p.hwid}]")
     else:
-        print("  (none found)")
+        logger.info("  (none found)")
 
-    print("\n=== Available Video Devices ===")
+    logger.info("\n=== Available Video Devices ===")
     devices = VideoCapture.list_devices()
     if devices:
         for d in devices:
-            print(
+            logger.info(
                 f"  Index {d['index']}: {d['width']}x{d['height']} @ {d['fps']}fps ({d['backend']})"
             )
     else:
-        print("  (none found)")
+        logger.info("  (none found)")
 
 
 if __name__ == "__main__":

nanokvm/_logger.py

@@ -0,0 +1,11 @@
+import logging
+
+
+def get_logger(name: str) -> logging.Logger:
+    logger = logging.getLogger(name)
+    if not logger.handlers:
+        logging.basicConfig(
+            level=logging.INFO,
+            format="%(name)s: %(message)s",
+        )
+    return logger

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nanokvm"
-version = "0.1.2"
+version = "0.1.3"
 description = "Python library for controlling machines via NanoKVM-USB — serial HID + UVC video capture for AI agents"
 readme = "README.md"
 requires-python = ">=3.12"