mtcli 3.8.0.dev12__py3-none-any.whl → 3.8.0.dev13__py3-none-any.whl

mtcli/cli.py

@@ -1,119 +1,119 @@
-"""
-CLI principal do mtcli.
-
-Responsável por:
-
-- inicializar o ambiente do CLI
-- carregar plugins
-- iniciar captura automática de ticks (opcional)
-
-A captura automática é ativada se a variável de ambiente
-MTCLI_SYMBOL estiver definida.
-
-Exemplo:
-
-    MTCLI_SYMBOL=WIN$N mt bars
-
-Nesse caso o mtcli inicia um TickEngine em background
-para manter o histórico de ticks atualizado.
-"""
-
-import os
-import click
-
-from mtcli.plugin_loader import load_plugins
-from mtcli.logger import setup_logger
-from mtcli.services.tick_service import ensure_tick_engine
-
-from .commands.bars import bars
-from .commands.doctor import doctor
-from .commands.ticks import ticks
-from .commands.backfill import backfill
-
-
-logger = setup_logger(__name__)
-
-_tick_engine = None
-
-
-def start_tick_capture():
-    """
-    Inicia captura contínua de ticks em background.
-
-    Se a variável de ambiente MTCLI_SYMBOL estiver definida,
-    o mtcli iniciará automaticamente um TickEngine para
-    coletar ticks continuamente.
-
-    Isso permite manter um histórico próprio de ticks
-    independente do histórico do broker.
-    """
-
-    global _tick_engine
-
-    if _tick_engine:
-        return
-
-    symbol = os.getenv("MTCLI_SYMBOL")
-
-    if not symbol:
-        logger.info(
-            "Captura automática de ticks desativada (MTCLI_SYMBOL não definido)."
-        )
-        return
-
-    logger.info("Iniciando captura contínua de ticks para %s", symbol)
-
-    try:
-
-        # CORREÇÃO PRINCIPAL
-        _tick_engine = ensure_tick_engine([symbol])
-
-        logger.info("Captura de ticks iniciada em background.")
-
-    except Exception:
-        logger.exception("Falha ao iniciar captura de ticks")
-
-
-@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.
-    """
-
-    start_tick_capture()
-
-    if ctx.invoked_subcommand is None:
-        click.echo(ctx.get_help())
-
-
-mt.add_command(doctor, name="doctor")
-mt.add_command(bars, name="bars")
-mt.add_command(doctor, name="dr")
-mt.add_command(ticks)
-mt.add_command(backfill, name="fill")
-
-loaded_plugins = load_plugins(mt)
-
-logger.info("Plugins carregados: %s", loaded_plugins)
-
-
-@mt.command(name="plugins")
-def list_plugins():
-    """
-    Lista os plugins 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}")
-
-
-if __name__ == "__main__":
-    mt()
+"""
+CLI principal do mtcli.
+
+Responsável por:
+
+- inicializar o ambiente do CLI
+- carregar plugins
+- iniciar captura automática de ticks (opcional)
+
+A captura automática é ativada se a variável de ambiente
+MTCLI_SYMBOL estiver definida.
+
+Exemplo:
+
+    MTCLI_SYMBOL=WIN$N mt bars
+
+Nesse caso o mtcli inicia um TickEngine em background
+para manter o histórico de ticks atualizado.
+"""
+
+import os
+import click
+
+from mtcli.plugin_loader import load_plugins
+from mtcli.logger import setup_logger
+from mtcli.services.tick_service import ensure_tick_engine
+
+from .commands.bars import bars
+from .commands.doctor import doctor
+from .commands.ticks import ticks
+from .commands.backfill import backfill
+
+
+logger = setup_logger(__name__)
+
+_tick_engine = None
+
+
+def start_tick_capture():
+    """
+    Inicia captura contínua de ticks em background.
+
+    Se a variável de ambiente MTCLI_SYMBOL estiver definida,
+    o mtcli iniciará automaticamente um TickEngine para
+    coletar ticks continuamente.
+
+    Isso permite manter um histórico próprio de ticks
+    independente do histórico do broker.
+    """
+
+    global _tick_engine
+
+    if _tick_engine:
+        return
+
+    symbol = os.getenv("MTCLI_SYMBOL")
+
+    if not symbol:
+        logger.info(
+            "Captura automática de ticks desativada (MTCLI_SYMBOL não definido)."
+        )
+        return
+
+    logger.info("Iniciando captura contínua de ticks para %s", symbol)
+
+    try:
+
+        # CORREÇÃO PRINCIPAL
+        _tick_engine = ensure_tick_engine([symbol])
+
+        logger.info("Captura de ticks iniciada em background.")
+
+    except Exception:
+        logger.exception("Falha ao iniciar captura de ticks")
+
+
+@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.
+    """
+
+    start_tick_capture()
+
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+mt.add_command(doctor, name="doctor")
+mt.add_command(bars, name="bars")
+mt.add_command(doctor, name="dr")
+mt.add_command(ticks)
+mt.add_command(backfill, name="fill")
+
+loaded_plugins = load_plugins(mt)
+
+logger.info("Plugins carregados: %s", loaded_plugins)
+
+
+@mt.command(name="plugins")
+def list_plugins():
+    """
+    Lista os plugins 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}")
+
+
+if __name__ == "__main__":
+    mt()

mtcli/commands/backfill.py

@@ -1,68 +1,68 @@
-"""
-Comando CLI: backfill
-
-Responsável por carregar histórico de ticks do MetaTrader5
-para o banco SQLite do mtcli utilizando o BackfillEngine.
-
-Fluxo:
-
-BackfillEngine
-      ↓
-TickRepository
-      ↓
-SQLite
-
-Opcionalmente os ticks também podem ser publicados no TickBus
-para que plugins consumam o fluxo histórico.
-"""
-
-import click
-
-from mtcli.marketdata.backfill_engine import BackfillEngine
-from mtcli.marketdata.tick_bus import TickBus
-from mtcli.marketdata.tick_repository import TickRepository
-
-
-@click.command()
-@click.argument("symbol")
-@click.option(
-    "--days",
-    default=5,
-    show_default=True,
-    help="Número de dias de histórico a carregar caso não exista histórico local.",
-)
-def backfill(symbol: str, days: int):
-    """
-    Executa backfill histórico de ticks.
-
-    Este comando baixa ticks históricos diretamente do MetaTrader5
-    e os grava no banco local SQLite do mtcli.
-
-    O processo é incremental:
-
-    - se já existirem ticks no banco, o backfill continua do último tick
-    - caso contrário, carrega o número de dias definido em --days
-
-    Examples
-    --------
-
-    Carregar 5 dias:
-
-        mt fill WINJ26
-
-    Carregar 30 dias:
-
-        mt fill WINJ26 --days 30
-    """
-
-    # Event bus (permite que plugins consumam os ticks históricos)
-    bus = TickBus()
-
-    # Repositório de persistência
-    repo = TickRepository()
-
-    # Engine de backfill
-    engine = BackfillEngine(symbol, bus, repo)
-
-    # Executa o carregamento histórico
-    engine.run(days)
+"""
+Comando CLI: backfill
+
+Responsável por carregar histórico de ticks do MetaTrader5
+para o banco SQLite do mtcli utilizando o BackfillEngine.
+
+Fluxo:
+
+BackfillEngine
+      ↓
+TickRepository
+      ↓
+SQLite
+
+Opcionalmente os ticks também podem ser publicados no TickBus
+para que plugins consumam o fluxo histórico.
+"""
+
+import click
+
+from mtcli.marketdata.backfill_engine import BackfillEngine
+from mtcli.marketdata.tick_bus import TickBus
+from mtcli.marketdata.tick_repository import TickRepository
+
+
+@click.command()
+@click.argument("symbol")
+@click.option(
+    "--days",
+    default=5,
+    show_default=True,
+    help="Número de dias de histórico a carregar caso não exista histórico local.",
+)
+def backfill(symbol: str, days: int):
+    """
+    Executa backfill histórico de ticks.
+
+    Este comando baixa ticks históricos diretamente do MetaTrader5
+    e os grava no banco local SQLite do mtcli.
+
+    O processo é incremental:
+
+    - se já existirem ticks no banco, o backfill continua do último tick
+    - caso contrário, carrega o número de dias definido em --days
+
+    Examples
+    --------
+
+    Carregar 5 dias:
+
+        mt fill WINJ26
+
+    Carregar 30 dias:
+
+        mt fill WINJ26 --days 30
+    """
+
+    # Event bus (permite que plugins consumam os ticks históricos)
+    bus = TickBus()
+
+    # Repositório de persistência
+    repo = TickRepository()
+
+    # Engine de backfill
+    engine = BackfillEngine(symbol, bus, repo)
+
+    # Executa o carregamento histórico
+    engine.run(days)

mtcli/commands/ticks.py

@@ -1,44 +1,44 @@
-"""
-Comando CLI para captura contínua de ticks.
-
-Permite iniciar o serviço de captura de ticks
-para um ou mais símbolos.
-
-Exemplo:
-
-    mt ticks WIN$N
-    mt ticks WIN$N WDO$N PETR4
-"""
-
-import time
-import click
-
-from mtcli.services.tick_service import ensure_tick_engine
-
-
-@click.command()
-@click.argument("symbols", nargs=-1)
-def ticks(symbols):
-    """
-    Inicia captura contínua de ticks.
-    """
-
-    if not symbols:
-        click.echo("Informe ao menos um símbolo.")
-        return
-
-    # atualmente o engine suporta apenas 1 símbolo
-    symbol = symbols[0]
-
-    engine = ensure_tick_engine(symbol)
-
-    click.echo(f"Captura de ticks iniciada para {symbol}")
-
-    try:
-        # inicia engine
-        engine.start()
-
-    except KeyboardInterrupt:
-
-        click.echo("\nEncerrando captura de ticks...")
-        engine.stop()
+"""
+Comando CLI para captura contínua de ticks.
+
+Permite iniciar o serviço de captura de ticks
+para um ou mais símbolos.
+
+Exemplo:
+
+    mt ticks WIN$N
+    mt ticks WIN$N WDO$N PETR4
+"""
+
+import time
+import click
+
+from mtcli.services.tick_service import ensure_tick_engine
+
+
+@click.command()
+@click.argument("symbols", nargs=-1)
+def ticks(symbols):
+    """
+    Inicia captura contínua de ticks.
+    """
+
+    if not symbols:
+        click.echo("Informe ao menos um símbolo.")
+        return
+
+    # atualmente o engine suporta apenas 1 símbolo
+    symbol = symbols[0]
+
+    engine = ensure_tick_engine(symbol)
+
+    click.echo(f"Captura de ticks iniciada para {symbol}")
+
+    try:
+        # inicia engine
+        engine.start()
+
+    except KeyboardInterrupt:
+
+        click.echo("\nEncerrando captura de ticks...")
+        engine.stop()

mtcli/database.py

@@ -15,14 +15,30 @@ from datetime import datetime
 
 from .conf import DB_NAME
 from .migrations.runner import run_migrations
+from .logger import setup_logger
 
 
+# ==========================================================
+# LOGGER
+# ==========================================================
+
+log = setup_logger(__name__)
+
+
+# ==========================================================
+# PATHS
+# ==========================================================
+
 DB_PATH = Path.home() / ".mtcli" / DB_NAME
 BACKUP_DIR = Path.home() / ".mtcli" / "backups"
 
 _connection = None
 
 
+# ==========================================================
+# CONNECTION
+# ==========================================================
+
 def get_connection():
     """
     Retorna conexão singleton SQLite.
@@ -31,14 +47,26 @@ def get_connection():
     global _connection
 
     if _connection:
+        log.debug("Reutilizando conexão SQLite existente.")
         return _connection
 
+    log.debug("Inicializando conexão SQLite.")
+
     DB_PATH.parent.mkdir(parents=True, exist_ok=True)
     BACKUP_DIR.mkdir(parents=True, exist_ok=True)
 
+    log.debug("Diretórios garantidos: db=%s backups=%s", DB_PATH.parent, BACKUP_DIR)
+
     conn = sqlite3.connect(DB_PATH, check_same_thread=False)
 
-    # otimizações
+    log.debug("Conexão SQLite criada em %s", DB_PATH)
+
+    # ======================================================
+    # PRAGMAS DE OTIMIZAÇÃO
+    # ======================================================
+
+    log.debug("Aplicando otimizações PRAGMA.")
+
     conn.execute("PRAGMA journal_mode=WAL")
     conn.execute("PRAGMA synchronous=NORMAL")
     conn.execute("PRAGMA temp_store=MEMORY")
@@ -48,11 +76,25 @@ def get_connection():
     conn.execute("PRAGMA wal_autocheckpoint=5000")
     conn.execute("PRAGMA foreign_keys=ON")
 
-    # executa migrations automaticamente
-    run_migrations(conn)
+    log.debug("PRAGMAs aplicadas com sucesso.")
+
+    # ======================================================
+    # MIGRATIONS
+    # ======================================================
+
+    log.debug("Executando migrations do banco de dados.")
+
+    try:
+        run_migrations(conn)
+        log.info("Migrations executadas/verificadas com sucesso.")
+    except Exception:
+        log.exception("Erro ao executar migrations.")
+        raise
 
     _connection = conn
 
+    log.debug("Conexão SQLite inicializada e armazenada como singleton.")
+
     return conn
 
 
@@ -61,17 +103,35 @@ def get_connection():
 # ==========================================================
 
 def backup_database(conn):
+    """
+    Cria backup diário do banco de dados SQLite.
+
+    O backup é realizado apenas uma vez por dia.
+    """
 
     now = datetime.now().strftime("%Y%m%d")
 
     backup_path = BACKUP_DIR / f"marketdata_{now}.db"
 
+    log.debug("Verificando necessidade de backup diário: %s", backup_path)
+
     if backup_path.exists():
+        log.debug("Backup diário já existe. Ignorando backup.")
         return
 
-    backup_conn = sqlite3.connect(backup_path)
+    log.info("Iniciando backup do banco para %s", backup_path)
+
+    try:
+
+        backup_conn = sqlite3.connect(backup_path)
+
+        with backup_conn:
+            conn.backup(backup_conn)
+
+        backup_conn.close()
 
-    with backup_conn:
-        conn.backup(backup_conn)
+        log.info("Backup concluído com sucesso.")
 
-    backup_conn.close()
+    except Exception:
+        log.exception("Falha durante backup do banco.")
+        raise