ai-virtual-mouse-controller 1.0.2__tar.gz → 1.0.4__tar.gz

{ai_virtual_mouse_controller-1.0.2 → ai_virtual_mouse_controller-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-virtual-mouse-controller
-Version: 1.0.2
+Version: 1.0.4
 Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
 Author: Guilherme Moraes Franco
 License: MIT
@@ -27,7 +27,7 @@ Requires-Python: <3.14,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: opencv-python<5.0.0,>=4.10.0
-Requires-Dist: mediapipe<0.11.0,>=0.10.18
+Requires-Dist: mediapipe<0.10.30,>=0.10.18
 Requires-Dist: pyautogui<1.0.0,>=0.9.54
 Requires-Dist: numpy<2.2.0,>=1.26.0
 Requires-Dist: moderngl>=5.10.0

{ai_virtual_mouse_controller-1.0.2 → ai_virtual_mouse_controller-1.0.4}/ai_virtual_mouse_controller.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-virtual-mouse-controller
-Version: 1.0.2
+Version: 1.0.4
 Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
 Author: Guilherme Moraes Franco
 License: MIT
@@ -27,7 +27,7 @@ Requires-Python: <3.14,>=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: opencv-python<5.0.0,>=4.10.0
-Requires-Dist: mediapipe<0.11.0,>=0.10.18
+Requires-Dist: mediapipe<0.10.30,>=0.10.18
 Requires-Dist: pyautogui<1.0.0,>=0.9.54
 Requires-Dist: numpy<2.2.0,>=1.26.0
 Requires-Dist: moderngl>=5.10.0

{ai_virtual_mouse_controller-1.0.2 → ai_virtual_mouse_controller-1.0.4}/ai_virtual_mouse_controller.egg-info/requires.txt

@@ -1,5 +1,5 @@
 opencv-python<5.0.0,>=4.10.0
-mediapipe<0.11.0,>=0.10.18
+mediapipe<0.10.30,>=0.10.18
 pyautogui<1.0.0,>=0.9.54
 numpy<2.2.0,>=1.26.0
 moderngl>=5.10.0

{ai_virtual_mouse_controller-1.0.2 → ai_virtual_mouse_controller-1.0.4}/core/__init__.py

@@ -10,5 +10,5 @@ Versao do pacote vive em `__version__` e e' a fonte unica de verdade
 
 from __future__ import annotations
 
-__version__ = "1.0.2"
+__version__ = "1.0.4"
 __all__ = ["__version__"]

ai_virtual_mouse_controller-1.0.4/main.py

@@ -0,0 +1,80 @@
+"""
+main.py
+=======
+
+Entry point do AI Virtual Mouse Controller.
+
+Uso:
+    python main.py
+
+Ou como modulo:
+    python -m main
+
+Sai com codigo:
+    0 = ok
+    1 = falha de webcam
+    2 = erro inesperado
+"""
+
+from __future__ import annotations
+
+import logging
+import sys
+
+
+def _check_environment() -> None:
+    """Verifica versoes criticas ANTES de qualquer import do projeto.
+
+    Mediapipe 0.11+ removeu mp.solutions.hands que esse projeto usa.
+    Se o usuario tem 0.11+ instalado globalmente, mostramos mensagem
+    clara com comando de fix em vez de AttributeError obscuro.
+    """
+    try:
+        import mediapipe as mp
+    except ImportError:
+        sys.stderr.write(
+            "\nERRO: mediapipe nao esta instalado.\n"
+            "Solucao: pip install ai-virtual-mouse-controller\n\n"
+        )
+        sys.exit(1)
+
+    if not hasattr(mp, "solutions") or not hasattr(mp.solutions, "hands"):
+        version = getattr(mp, "__version__", "desconhecida")
+        sys.stderr.write(
+            "\n" + "=" * 70 + "\n"
+            f"ERRO: mediapipe {version} nao tem mp.solutions.hands.\n"
+            "Esse projeto requer mediapipe 0.10.18 a 0.10.21 — o modulo\n"
+            "'solutions' foi removido a partir da 0.10.30.\n\n"
+            "Solucao rapida (copia e cola no terminal):\n\n"
+            '  pip install "mediapipe>=0.10.18,<0.10.30" --force-reinstall\n\n'
+            "Depois roda 'avmc' de novo.\n"
+            + "=" * 70 + "\n\n"
+        )
+        sys.exit(1)
+
+
+def _setup_logging() -> None:
+    import config
+    level = getattr(logging, config.LOG_LEVEL.upper(), logging.INFO)
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s | %(levelname)-7s | %(name)s | %(message)s",
+        datefmt="%H:%M:%S",
+    )
+
+
+def main() -> int:
+    # Check ANTES de importar service (que ja tocaria em mediapipe)
+    _check_environment()
+
+    _setup_logging()
+    logger = logging.getLogger("main")
+    logger.info("AI Virtual Mouse Controller — iniciando...")
+
+    from services.virtual_mouse_service import VirtualMouseService
+    service = VirtualMouseService.from_config()
+    return service.run()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{ai_virtual_mouse_controller-1.0.2 → ai_virtual_mouse_controller-1.0.4}/pyproject.toml

@@ -11,7 +11,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-virtual-mouse-controller"
-version = "1.0.2"
+version = "1.0.4"
 description = "Controle de cursor por gestos da mao via webcam, com holograma 3D opcional."
 readme = "README.md"
 requires-python = ">=3.11,<3.14"
@@ -42,7 +42,11 @@ classifiers = [
 ]
 dependencies = [
     "opencv-python>=4.10.0,<5.0.0",
-    "mediapipe>=0.10.18,<0.11.0",
+    # CRITICAL: mediapipe 0.10.30+ removeu mp.solutions.hands que esse
+    # projeto usa. Range estreito 0.10.18-0.10.21 garante o modulo
+    # solutions presente. Quando migrarmos pro novo Task API podemos
+    # abrir esse range.
+    "mediapipe>=0.10.18,<0.10.30",
     "pyautogui>=0.9.54,<1.0.0",
     "numpy>=1.26.0,<2.2.0",
     # v1.0.2: holograma vira default — usuario que roda

{ai_virtual_mouse_controller-1.0.2 → ai_virtual_mouse_controller-1.0.4}/tests/test_hologram_overlay.py

@@ -162,6 +162,13 @@ class TestBurstFiring:
     not _PYSIDE_AVAILABLE,
     reason="PySide6 nao instalado",
 )
+@pytest.mark.skipif(
+    os.environ.get("CI") == "true",
+    reason=(
+        "Render real Qt+OpenGL crasha em CI sem display server "
+        "(offscreen platform nao garante GL context). Roda local."
+    ),
+)
 class TestRenderingNoCrash:
     """Garante que o paint roda sem crashar com varias configuracoes."""
 

ai_virtual_mouse_controller-1.0.2/main.py

@@ -1,47 +0,0 @@
-"""
-main.py
-=======
-
-Entry point do AI Virtual Mouse Controller.
-
-Uso:
-    python main.py
-
-Ou como modulo:
-    python -m main
-
-Sai com codigo:
-    0 = ok
-    1 = falha de webcam
-    2 = erro inesperado
-"""
-
-from __future__ import annotations
-
-import logging
-import sys
-
-import config
-from services.virtual_mouse_service import VirtualMouseService
-
-
-def _setup_logging() -> None:
-    level = getattr(logging, config.LOG_LEVEL.upper(), logging.INFO)
-    logging.basicConfig(
-        level=level,
-        format="%(asctime)s | %(levelname)-7s | %(name)s | %(message)s",
-        datefmt="%H:%M:%S",
-    )
-
-
-def main() -> int:
-    _setup_logging()
-    logger = logging.getLogger("main")
-    logger.info("AI Virtual Mouse Controller — iniciando...")
-
-    service = VirtualMouseService.from_config()
-    return service.run()
-
-
-if __name__ == "__main__":
-    sys.exit(main())