mtcli 3.7.1__tar.gz → 3.8.0.dev0__tar.gz

{mtcli-3.7.1 → mtcli-3.8.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.7.1
+Version: 3.8.0.dev0
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
 License-Expression: MIT
 License-File: LICENSE

mtcli-3.8.0.dev0/mtcli/cli.py

@@ -0,0 +1,135 @@
+"""
+CLI principal do mtcli.
+
+Este módulo define o grupo principal `mt`
+e inicializa o carregamento de plugins.
+
+Também inicia a captura contínua de ticks para manter
+um histórico próprio independente do broker.
+"""
+
+import os
+import threading
+import click
+
+from mtcli.plugin_loader import load_plugins
+from mtcli.logger import setup_logger
+from mtcli.marketdata.tick_streamer import TickStreamer
+
+from .commands.bars import bars
+from .commands.doctor import doctor
+from .commands.migrate import migrate
+
+
+logger = setup_logger(__name__)
+
+
+# ---------------------------------------------------------
+# Configuração de captura de ticks
+# ---------------------------------------------------------
+
+_tick_streamer = None
+
+
+def start_tick_capture():
+    """
+    Inicia captura contínua de ticks em background.
+
+    O símbolo pode ser configurado via variável de ambiente:
+
+        MTCLI_SYMBOL=WINJ26
+    """
+
+    global _tick_streamer
+
+    if _tick_streamer:
+        return
+
+    symbol = os.getenv("SYMBOL")
+
+    if not symbol:
+        logger.info("Captura de ticks desativada (MTCLI_SYMBOL não definido).")
+        return
+
+    logger.info("Iniciando captura contínua de ticks para %s", symbol)
+
+    _tick_streamer = TickStreamer(symbol)
+
+    thread = threading.Thread(
+        target=_tick_streamer.start,
+        daemon=True,
+        name="mtcli-tick-streamer",
+    )
+
+    thread.start()
+
+    logger.info("Captura de ticks iniciada em background.")
+
+
+# ---------------------------------------------------------
+# CLI principal
+# ---------------------------------------------------------
+
+@click.group(context_settings={"max_content_width": 120}, invoke_without_command=True)
+@click.version_option(package_name="mtcli")
+@click.pass_context
+def mt(ctx):
+    """
+    CLI principal do mtcli.
+
+    Exibe gráficos e informações de mercado
+    em formato textual compatível com leitores de tela.
+    """
+
+    # inicia captura de ticks
+    start_tick_capture()
+
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+# ---------------------------------------------------------
+# Comandos internos
+# ---------------------------------------------------------
+
+mt.add_command(doctor, name="doctor")
+mt.add_command(bars, name="bars")
+mt.add_command(doctor, name="dr")
+mt.add_command(migrate)
+
+
+# ---------------------------------------------------------
+# Carregamento de plugins
+# ---------------------------------------------------------
+
+loaded_plugins = load_plugins(mt)
+
+logger.info("Plugins carregados: %s", loaded_plugins)
+
+
+# ---------------------------------------------------------
+# Comando utilitário: listar plugins
+# ---------------------------------------------------------
+
+@mt.command(name="plugins")
+def list_plugins():
+    """
+    Lista os plugins atualmente carregados no mtcli.
+    """
+
+    if not loaded_plugins:
+        click.echo("Nenhum plugin carregado.")
+        return
+
+    click.echo("Plugins carregados:\n")
+
+    for name in loaded_plugins:
+        click.echo(f"  {name}")
+
+
+# ---------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------
+
+if __name__ == "__main__":
+    mt()

mtcli-3.8.0.dev0/mtcli/commands/migrate.py

@@ -0,0 +1,12 @@
+import click
+
+from mtcli.database import get_connection
+from mtcli.migrations.runner import run_migrations
+
+
+@click.command()
+def migrate():
+
+    conn = get_connection()
+
+    run_migrations(conn)

mtcli-3.8.0.dev0/mtcli/database.py

@@ -0,0 +1,66 @@
+import sqlite3
+from pathlib import Path
+from datetime import datetime
+
+DB_PATH = Path.home() / ".mtcli" / "marketdata.db"
+BACKUP_DIR = Path.home() / ".mtcli" / "backups"
+
+
+def get_connection():
+
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+    BACKUP_DIR.mkdir(parents=True, exist_ok=True)
+
+    conn = sqlite3.connect(DB_PATH, check_same_thread=False)
+
+    conn.execute("PRAGMA journal_mode=WAL")
+    conn.execute("PRAGMA synchronous=NORMAL")
+    conn.execute("PRAGMA temp_store=MEMORY")
+    conn.execute("PRAGMA mmap_size=30000000000")
+    conn.execute("PRAGMA cache_size=-200000")
+
+    conn.execute("""
+    CREATE TABLE IF NOT EXISTS schema_migrations(
+        version INTEGER PRIMARY KEY,
+        applied_at TEXT NOT NULL
+    )
+    """)
+
+    conn.commit()
+
+    return conn
+
+
+# ==========================================================
+# CHECKPOINT
+# ==========================================================
+
+def wal_checkpoint(conn):
+    """
+    Reduz tamanho do WAL e mantém banco saudável.
+    """
+    conn.execute("PRAGMA wal_checkpoint(TRUNCATE)")
+
+
+# ==========================================================
+# BACKUP
+# ==========================================================
+
+def backup_database(conn):
+    """
+    Backup diário seguro do banco SQLite.
+    """
+
+    now = datetime.now().strftime("%Y%m%d")
+
+    backup_path = BACKUP_DIR / f"marketdata_{now}.db"
+
+    if backup_path.exists():
+        return
+
+    backup_conn = sqlite3.connect(backup_path)
+
+    with backup_conn:
+        conn.backup(backup_conn)
+
+    backup_conn.close()

{mtcli-3.7.1 → mtcli-3.8.0.dev0}/mtcli/logger.py

@@ -1,136 +1,136 @@
-"""
-Sistema central de logging do mtcli.
-
-Este módulo fornece uma função única `setup_logger()` utilizada por todo
-o ecossistema de plugins do mtcli para configurar logging consistente.
-
-Características principais
---------------------------
-
-✔ Arquivo de log rotativo em:
-  %APPDATA%/mtcli/logs/mtcli.log
-
-✔ Rotação automática:
-  - tamanho máximo: 2 MB
-  - até 3 arquivos de backup
-
-✔ Proteção contra duplicação de handlers quando plugins
-  inicializam o logger múltiplas vezes.
-
-✔ Encoding UTF-8 garantido (evita problemas de acentuação
-  no Windows).
-
-✔ Compatível com pytest (caplog).
-
-Observação
-----------
-
-Os logs **não são exibidos no console**.
-Toda saída é direcionada exclusivamente para o arquivo de log.
-"""
-
-import logging
-from logging.handlers import RotatingFileHandler
-import os
-
-
-# ==========================================================
-# DIRETÓRIO DE LOG
-# ==========================================================
-
-base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
-
-LOG_DIR = os.path.join(base_dir, "mtcli", "logs")
-
-os.makedirs(LOG_DIR, exist_ok=True)
-
-LOG_FILE = os.path.join(LOG_DIR, "mtcli.log")
-
-
-# ==========================================================
-# LOGGER SETUP
-# ==========================================================
-
-def setup_logger(name: str = "mtcli") -> logging.Logger:
-    """
-    Cria ou retorna um logger configurado para o mtcli.
-
-    O logger utiliza **apenas um handler de arquivo rotativo**.
-    Nenhuma saída é enviada ao console.
-
-    A função é **idempotente**, ou seja, pode ser chamada
-    múltiplas vezes sem duplicar handlers.
-
-    Parameters
-    ----------
-    name : str
-        Nome do logger (normalmente `__name__`).
-
-    Returns
-    -------
-    logging.Logger
-        Instância configurada do logger.
-    """
-
-    logger = logging.getLogger(name)
-
-    logger.setLevel(logging.DEBUG)
-
-    formatter = logging.Formatter(
-        "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
-        datefmt="%Y-%m-%d %H:%M:%S",
-    )
-
-    # ======================================================
-    # REMOVE STREAM HANDLERS (garante silêncio no console)
-    # ======================================================
-
-    for handler in list(logger.handlers):
-        if isinstance(handler, logging.StreamHandler) and not isinstance(handler, RotatingFileHandler):
-            logger.removeHandler(handler)
-
-    # ======================================================
-    # FILE HANDLER ROTATIVO
-    # ======================================================
-
-    file_handler_exists = any(
-        isinstance(h, RotatingFileHandler) for h in logger.handlers
-    )
-
-    if not file_handler_exists:
-
-        file_handler = RotatingFileHandler(
-            LOG_FILE,
-            maxBytes=2_000_000,
-            backupCount=3,
-            encoding="utf-8",
-            delay=True,
-        )
-
-        file_handler.setFormatter(formatter)
-
-        logger.addHandler(file_handler)
-
-    # ======================================================
-    # PROPAGATION
-    # ======================================================
-
-    # Permite que pytest caplog capture logs
-    logger.propagate = True
-
-    return logger
-
-
-# ==========================================================
-# LOGGER PADRÃO DO MTCLI
-# ==========================================================
-
-"""
-Logger padrão utilizado por módulos internos do mtcli.
-
-Plugins geralmente criam seu próprio logger usando:
-
-    setup_logger(__name__)
-"""
-
-log = setup_logger()
+"""
+Sistema central de logging do mtcli.
+
+Este módulo fornece uma função única `setup_logger()` utilizada por todo
+o ecossistema de plugins do mtcli para configurar logging consistente.
+
+Características principais
+--------------------------
+
+✔ Arquivo de log rotativo em:
+  %APPDATA%/mtcli/logs/mtcli.log
+
+✔ Rotação automática:
+  - tamanho máximo: 2 MB
+  - até 3 arquivos de backup
+
+✔ Proteção contra duplicação de handlers quando plugins
+  inicializam o logger múltiplas vezes.
+
+✔ Encoding UTF-8 garantido (evita problemas de acentuação
+  no Windows).
+
+✔ Compatível com pytest (caplog).
+
+Observação
+----------
+
+Os logs **não são exibidos no console**.
+Toda saída é direcionada exclusivamente para o arquivo de log.
+"""
+
+import logging
+from logging.handlers import RotatingFileHandler
+import os
+
+
+# ==========================================================
+# DIRETÓRIO DE LOG
+# ==========================================================
+
+base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
+
+LOG_DIR = os.path.join(base_dir, "mtcli", "logs")
+
+os.makedirs(LOG_DIR, exist_ok=True)
+
+LOG_FILE = os.path.join(LOG_DIR, "mtcli.log")
+
+
+# ==========================================================
+# LOGGER SETUP
+# ==========================================================
+
+def setup_logger(name: str = "mtcli") -> logging.Logger:
+    """
+    Cria ou retorna um logger configurado para o mtcli.
+
+    O logger utiliza **apenas um handler de arquivo rotativo**.
+    Nenhuma saída é enviada ao console.
+
+    A função é **idempotente**, ou seja, pode ser chamada
+    múltiplas vezes sem duplicar handlers.
+
+    Parameters
+    ----------
+    name : str
+        Nome do logger (normalmente `__name__`).
+
+    Returns
+    -------
+    logging.Logger
+        Instância configurada do logger.
+    """
+
+    logger = logging.getLogger(name)
+
+    logger.setLevel(logging.DEBUG)
+
+    formatter = logging.Formatter(
+        "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+    # ======================================================
+    # REMOVE STREAM HANDLERS (garante silêncio no console)
+    # ======================================================
+
+    for handler in list(logger.handlers):
+        if isinstance(handler, logging.StreamHandler) and not isinstance(handler, RotatingFileHandler):
+            logger.removeHandler(handler)
+
+    # ======================================================
+    # FILE HANDLER ROTATIVO
+    # ======================================================
+
+    file_handler_exists = any(
+        isinstance(h, RotatingFileHandler) for h in logger.handlers
+    )
+
+    if not file_handler_exists:
+
+        file_handler = RotatingFileHandler(
+            LOG_FILE,
+            maxBytes=2_000_000,
+            backupCount=3,
+            encoding="utf-8",
+            delay=True,
+        )
+
+        file_handler.setFormatter(formatter)
+
+        logger.addHandler(file_handler)
+
+    # ======================================================
+    # PROPAGATION
+    # ======================================================
+
+    # Permite que pytest caplog capture logs
+    logger.propagate = True
+
+    return logger
+
+
+# ==========================================================
+# LOGGER PADRÃO DO MTCLI
+# ==========================================================
+
+"""
+Logger padrão utilizado por módulos internos do mtcli.
+
+Plugins geralmente criam seu próprio logger usando:
+
+    setup_logger(__name__)
+"""
+
+log = setup_logger()

{mtcli-3.7.1 → mtcli-3.8.0.dev0}/mtcli/marketdata/tick_cache.py

@@ -1,24 +1,38 @@
-"""
-Cache de ticks em memória.
-"""
-
-from collections import deque
-
-
-class TickCache:
-    """
-    Mantém janela recente de ticks em memória.
-    """
-
-    def __init__(self, max_size=10000):
-        self.buffer = deque(maxlen=max_size)
-
-    def add_many(self, ticks):
-        for t in ticks:
-            self.buffer.append(t)
-
-    def get_all(self):
-        return list(self.buffer)
-
-    def clear(self):
-        self.buffer.clear()
+"""
+Cache de ticks em memória.
+"""
+
+from collections import deque
+
+
+class TickCache:
+    """
+    Mantém janela recente de ticks em memória.
+    """
+
+    def __init__(self, max_size=10000):
+        self.buffer = deque(maxlen=max_size)
+
+    def add_many(self, ticks):
+
+        for t in ticks:
+            self.buffer.append(t)
+
+    def add(self, tick):
+
+        self.buffer.append(tick)
+
+    def get_all(self):
+
+        return list(self.buffer)
+
+    def get_last(self):
+
+        if self.buffer:
+            return self.buffer[-1]
+
+        return None
+
+    def clear(self):
+
+        self.buffer.clear()