mtcli 3.8.0.dev15__tar.gz → 3.8.0.dev16__tar.gz

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.8.0.dev15
+Version: 3.8.0.dev16
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
 License-Expression: MIT
 License-File: LICENSE
@@ -19,6 +19,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Topic :: Office/Business :: Financial :: Investment
 Requires-Dist: click (>=8.2.1,<9.0.0)
 Requires-Dist: metatrader5 (>=5.0.5260,<6.0.0)
+Requires-Dist: tzdata (>=2025.3,<2026.0)
 Project-URL: Documentation, https://mtcli.readthedocs.io/pt-br/latest
 Project-URL: Homepage, https://github.com:vfranca/mtcli
 Project-URL: Repository, https://github.com/vfranca/mtcli

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/mtcli/__main__.py

@@ -1,3 +1,3 @@
-from .cli import mt
-
-mt()
+from .cli import mt
+
+mt()

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/mtcli/cli.py

@@ -1,26 +1,9 @@
 """
 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
@@ -30,43 +13,42 @@ from .commands.doctor import doctor
 from .commands.ticks import ticks
 from .commands.backfill import backfill
 
-
 logger = setup_logger(__name__)
 
-_tick_engine = None
+_tick_engines = []
 
 
 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.
+    Inicia captura contínua de ticks em background se MTCLI_SYMBOL estiver definido.
     """
 
-    global _tick_engine
+    global _tick_engines
 
-    if _tick_engine:
+    if _tick_engines:
         return
 
-    symbol = os.getenv("MTCLI_SYMBOL")
+    symbols = os.getenv("MTCLI_SYMBOL")
 
-    if not symbol:
+    if not symbols:
         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)
+    if isinstance(symbols, str):
+        symbols = [symbols]
 
-    try:
+    logger.info("Iniciando captura contínua de ticks para %s", symbols)
 
-        # CORREÇÃO PRINCIPAL
-        _tick_engine = ensure_tick_engine([symbol])
+    try:
+        for symbol in symbols:
+            engine = ensure_tick_engine(symbol)
+            _tick_engines.append(engine)
+            # pode rodar em thread se quiser background
+            import threading
+            t = threading.Thread(target=engine.start, daemon=True)
+            t.start()
 
         logger.info("Captura de ticks iniciada em background.")
 
@@ -95,7 +77,6 @@ mt.add_command(ticks)
 mt.add_command(backfill, name="fill")
 
 loaded_plugins = load_plugins(mt)
-
 logger.info("Plugins carregados: %s", loaded_plugins)
 
 
@@ -110,7 +91,6 @@ def list_plugins():
         return
 
     click.echo("Plugins carregados:\n")
-
     for name in loaded_plugins:
         click.echo(f"  {name}")
 

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/mtcli/cli_dev.py

@@ -1,8 +1,8 @@
-import click
-from .commands_dev.migrate import migrate
-
-@click.group()
-def cli():
-    pass
-
-cli.add_command(migrate)
+import click
+from .commands_dev.migrate import migrate
+
+@click.group()
+def cli():
+    pass
+
+cli.add_command(migrate)

mtcli-3.8.0.dev16/mtcli/commands/backfill.py

@@ -0,0 +1,70 @@
+"""
+Comando CLI: backfill
+
+Carrega histórico de ticks do MetaTrader5
+para o banco SQLite do mtcli utilizando o BackfillEngine
+com filtro de trade ticks.
+
+Fluxo:
+
+BackfillEngine
+      ->
+raw_tick_bus
+      ->
+TradeTickFilter
+      ->
+trade_tick_bus
+      ->
+TickWriter / plugins
+      ->
+TickRepository
+      ->
+SQLite
+"""
+
+import click
+
+from mtcli.logger import setup_logger
+from mtcli.marketdata.tick_bus import TickBus
+from mtcli.marketdata.tick_repository import TickRepository
+from mtcli.marketdata.tick_writer import TickWriter
+from mtcli.marketdata.trade_tick_filter import TradeTickFilter
+from mtcli.marketdata.backfill_engine import BackfillEngine
+
+logger = setup_logger(__name__)
+
+
+@click.command()
+@click.argument("symbol")
+@click.option(
+    "--days",
+    default=5,
+    show_default=True,
+)
+def backfill(symbol: str, days: int):
+
+    raw_tick_bus = TickBus()
+    trade_tick_bus = TickBus()
+
+    repo = TickRepository()
+
+    raw_tick_bus.subscribe(
+        TradeTickFilter(trade_tick_bus)
+    )
+
+    writer = TickWriter(symbol, repo)
+
+    trade_tick_bus.subscribe(writer)
+
+    engine = BackfillEngine(
+        symbol,
+        raw_tick_bus,
+        repo,
+    )
+
+    engine.run(days)
+
+    logger.info(
+        "Backfill concluído (%s) — trade ticks gravados",
+        symbol,
+    )

mtcli-3.8.0.dev16/mtcli/commands/ticks.py

@@ -0,0 +1,58 @@
+"""
+Comando CLI para captura contínua de ticks.
+
+Exemplo:
+    mt ticks WIN$N
+    mt ticks WIN$N WDO$N PETR4
+"""
+
+import click
+import threading
+
+from mtcli.services.tick_service import ensure_tick_engine
+from mtcli.logger import setup_logger
+
+logger = setup_logger(__name__)
+
+
+@click.command()
+@click.argument("symbols", nargs=-1)
+def ticks(symbols):
+
+    if not symbols:
+
+        click.echo("Informe ao menos um símbolo.")
+        return
+
+    engines = []
+
+    for symbol in symbols:
+
+        engine = ensure_tick_engine(symbol)
+
+        t = threading.Thread(
+            target=engine.start,
+            daemon=True
+        )
+
+        t.start()
+
+        engines.append(engine)
+
+        click.echo(
+            f"Captura de ticks iniciada para {symbol}"
+        )
+
+    try:
+
+        while True:
+
+            for engine in engines:
+                pass
+
+    except KeyboardInterrupt:
+
+        click.echo("\nEncerrando captura...")
+
+        for engine in engines:
+            engine.stop()

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/mtcli/commands_dev/migrate.py

@@ -1,48 +1,48 @@
-"""
-Comando CLI para execução das migrations do banco de dados.
-
-Este comando aplica todas as migrations pendentes no banco
-utilizado pelo mtcli.
-
-Fluxo de execução:
-
-1. Abre conexão com o banco SQLite
-2. Executa o migration runner
-3. Aplica migrations ainda não executadas
-
-Uso:
-
-    mtcli migrate
-
-Este comando é implementado utilizando o framework
-:contentReference[oaicite:1]{index=1} para construção de aplicações CLI.
-"""
-
-import click
-
-from mtcli.database import get_connection
-from mtcli.migrations.runner import run_migrations
-
-
-@click.command()
-def migrate():
-    """
-    Executa as migrations pendentes do banco de dados.
-
-    O comando conecta ao banco configurado no mtcli
-    e executa o migration runner responsável por:
-
-    - detectar migrations disponíveis
-    - identificar a versão atual do schema
-    - aplicar migrations pendentes
-    - registrar migrations aplicadas
-
-    Este comando é normalmente executado:
-
-    - na primeira inicialização do sistema
-    - após atualização de versão do mtcli
-    """
-
-    conn = get_connection()
-
-    run_migrations(conn)
+"""
+Comando CLI para execução das migrations do banco de dados.
+
+Este comando aplica todas as migrations pendentes no banco
+utilizado pelo mtcli.
+
+Fluxo de execução:
+
+1. Abre conexão com o banco SQLite
+2. Executa o migration runner
+3. Aplica migrations ainda não executadas
+
+Uso:
+
+    mtcli migrate
+
+Este comando é implementado utilizando o framework
+:contentReference[oaicite:1]{index=1} para construção de aplicações CLI.
+"""
+
+import click
+
+from mtcli.database import get_connection
+from mtcli.migrations.runner import run_migrations
+
+
+@click.command()
+def migrate():
+    """
+    Executa as migrations pendentes do banco de dados.
+
+    O comando conecta ao banco configurado no mtcli
+    e executa o migration runner responsável por:
+
+    - detectar migrations disponíveis
+    - identificar a versão atual do schema
+    - aplicar migrations pendentes
+    - registrar migrations aplicadas
+
+    Este comando é normalmente executado:
+
+    - na primeira inicialização do sistema
+    - após atualização de versão do mtcli
+    """
+
+    conn = get_connection()
+
+    run_migrations(conn)

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/mtcli/conf.py

@@ -313,3 +313,19 @@ _INITIAL_CSV_PATH = conf.get_csv_path()
 # ---------------------------------------------------------
 
 DB_NAME = conf.get("db_name", default="marketdata.db")
+
+# ---------------------------------------------------------
+# gestão de  múltiplos processos
+# ---------------------------------------------------------
+
+RUN_DIR = os.path.join(
+    os.getenv("APPDATA", os.path.expanduser("~")),
+    "mtcli",
+    "run"
+)
+
+os.makedirs(RUN_DIR, exist_ok=True)
+
+PID_FILE = os.path.join(RUN_DIR, "risco.pid")
+STOP_FILE = os.path.join(RUN_DIR, "risco.stop")
+HEARTBEAT_FILE = os.path.join(RUN_DIR, "risco.heartbeat")

{mtcli-3.8.0.dev15 → mtcli-3.8.0.dev16}/mtcli/database.py

@@ -1,137 +1,137 @@
-"""
-Core de acesso ao banco SQLite do mtcli.
-
-Responsável por:
-
-- criar conexão SQLite
-- aplicar otimizações
-- executar migrations automaticamente
-- backup automático
-"""
-
-import sqlite3
-from pathlib import Path
-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.
-    """
-
-    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)
-
-    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")
-    conn.execute("PRAGMA mmap_size=30000000000")
-    conn.execute("PRAGMA cache_size=-200000")
-    conn.execute("PRAGMA journal_size_limit=67108864")
-    conn.execute("PRAGMA wal_autocheckpoint=5000")
-    conn.execute("PRAGMA foreign_keys=ON")
-
-    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
-
-
-# ==========================================================
-# BACKUP
-# ==========================================================
-
-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
-
-    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()
-
-        log.info("Backup concluído com sucesso.")
-
-    except Exception:
-        log.exception("Falha durante backup do banco.")
-        raise
+"""
+Core de acesso ao banco SQLite do mtcli.
+
+Responsável por:
+
+- criar conexão SQLite
+- aplicar otimizações
+- executar migrations automaticamente
+- backup automático
+"""
+
+import sqlite3
+from pathlib import Path
+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.
+    """
+
+    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)
+
+    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")
+    conn.execute("PRAGMA mmap_size=30000000000")
+    conn.execute("PRAGMA cache_size=-200000")
+    conn.execute("PRAGMA journal_size_limit=67108864")
+    conn.execute("PRAGMA wal_autocheckpoint=5000")
+    conn.execute("PRAGMA foreign_keys=ON")
+
+    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
+
+
+# ==========================================================
+# BACKUP
+# ==========================================================
+
+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
+
+    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()
+
+        log.info("Backup concluído com sucesso.")
+
+    except Exception:
+        log.exception("Falha durante backup do banco.")
+        raise