mtcli 3.7.2__tar.gz → 3.7.3__tar.gz

{mtcli-3.7.2 → mtcli-3.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.7.2
+Version: 3.7.3
 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.7.3/mtcli/__main__.py

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

mtcli-3.7.3/mtcli/cli.py

@@ -0,0 +1,51 @@
+"""
+CLI principal do mtcli.
+"""
+
+import os
+import click
+from .plugin_loader import load_plugins
+from .logger import setup_logger
+
+from .commands.bars import bars
+from .commands.doctor import doctor
+
+logger = setup_logger(__name__)
+
+
+@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.
+    """
+
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+mt.add_command(doctor, name="doctor")
+mt.add_command(bars, name="bars")
+
+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-3.7.2 → mtcli-3.7.3}/mtcli/conf.py

@@ -309,8 +309,37 @@ DATA_SOURCE = conf.get_data_source()
 _INITIAL_CSV_PATH = conf.get_csv_path()
 
 # ---------------------------------------------------------
-# controle de processo em execução
+# Gestão de processos (daemon / serviços mtcli)
 # ---------------------------------------------------------
+#
+# Define caminhos para arquivos de controle utilizados por
+# processos em background (ex: ticks, risco, etc.).
+#
+# Conceitos:
+#
+# PID FILE
+#     Armazena o PID do processo ativo.
+#     Usado para garantir instância única e controle externo.
+#
+# STOP FILE
+#     Arquivo sentinela para sinalizar encerramento gracioso.
+#     O processo monitora sua existência periodicamente.
+#
+# HEARTBEAT FILE
+#     Atualizado continuamente pelo processo.
+#     Permite verificar se o serviço está vivo ou travado.
+#
+# Diretório base:
+#     %APPDATA%/mtcli/run (Windows)
+#     ~/.mtcli/run        (fallback)
+#
+# Cada serviço define seus próprios arquivos (ex: ticks, risco).
+#
+# Exemplo:
+#     ticks.pid
+#     ticks.stop
+#     ticks.heartbeat
+#
 
 RUN_DIR = os.path.join(
     os.getenv("APPDATA", os.path.expanduser("~")),

mtcli-3.7.3/mtcli/logger.py

@@ -0,0 +1,136 @@
+"""
+Sistema central de logging do mtcli.
+
+Versão corrigida para evitar duplicação de logs em cenários com:
+
+- múltiplos plugins
+- múltiplos loggers
+- integração com pytest (caplog)
+- uso de logging básico por libs externas
+
+Estratégia adotada
+------------------
+
+- Um único handler é configurado no ROOT logger
+- Todos os loggers filhos propagam para o root
+- Nenhum handler é anexado diretamente aos loggers de módulo
+
+Isso elimina completamente duplicação de logs.
+
+API permanece 100% compatível.
+"""
+
+import logging
+from logging.handlers import RotatingFileHandler
+import os
+from pathlib import Path
+
+
+# ==========================================================
+# DIRETÓRIO DE LOG
+# ==========================================================
+
+base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
+
+LOG_DIR = Path(base_dir) / "mtcli" / "logs"
+LOG_DIR.mkdir(parents=True, exist_ok=True)
+
+
+# ==========================================================
+# RESOLUÇÃO DO ARQUIVO
+# ==========================================================
+
+def _resolve_log_file() -> Path:
+    log_name = os.getenv("MTCLI_LOG_NAME", "mtcli")
+    per_process = os.getenv("MTCLI_LOG_PER_PROCESS")
+
+    if per_process:
+        return LOG_DIR / f"{log_name}-{os.getpid()}.log"
+
+    return LOG_DIR / f"{log_name}.log"
+
+
+LOG_FILE = _resolve_log_file()
+
+
+# ==========================================================
+# CONTROLE GLOBAL (ANTI DUPLICAÇÃO)
+# ==========================================================
+
+_MTCLI_LOGGER_CONFIGURED = False
+
+
+# ==========================================================
+# SETUP
+# ==========================================================
+
+def setup_logger(name: str = "mtcli") -> logging.Logger:
+    """
+    Retorna logger configurado.
+
+    A configuração real ocorre apenas uma vez no ROOT logger.
+
+    Parameters
+    ----------
+    name : str
+        Nome do logger.
+
+    Returns
+    -------
+    logging.Logger
+    """
+
+    global _MTCLI_LOGGER_CONFIGURED
+
+    root = logging.getLogger()
+
+    # ------------------------------------------------------
+    # CONFIGURAÇÃO GLOBAL (executa uma única vez)
+    # ------------------------------------------------------
+
+    if not _MTCLI_LOGGER_CONFIGURED:
+
+        root.setLevel(logging.DEBUG)
+
+        formatter = logging.Formatter(
+            "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
+            datefmt="%Y-%m-%d %H:%M:%S",
+        )
+
+        # remove handlers existentes (evita duplicação externa)
+        for h in list(root.handlers):
+            root.removeHandler(h)
+
+        file_handler = RotatingFileHandler(
+            LOG_FILE,
+            maxBytes=2_000_000,
+            backupCount=3,
+            encoding="utf-8",
+            delay=True,
+        )
+
+        file_handler.setFormatter(formatter)
+
+        root.addHandler(file_handler)
+
+        _MTCLI_LOGGER_CONFIGURED = True
+
+    # ------------------------------------------------------
+    # LOGGER FILHO (sem handler próprio)
+    # ------------------------------------------------------
+
+    logger = logging.getLogger(name)
+
+    logger.setLevel(logging.DEBUG)
+
+    # 🔥 CRÍTICO: não anexar handler aqui
+    logger.propagate = True
+
+    return logger
+
+
+# ==========================================================
+# LOGGER PADRÃO
+# ==========================================================
+
+log = setup_logger()

mtcli-3.7.3/mtcli/utils/time.py

@@ -0,0 +1,65 @@
+"""
+Utilitários de conversão de tempo para o mtcli.
+
+Este módulo fornece funções para:
+- Obter o horário atual em UTC
+- Converter datas de UTC para o timezone da B3 (Brasil)
+- Converter datas da B3 para UTC
+
+Todas as funções trabalham com objetos datetime timezone-aware.
+"""
+
+from datetime import datetime
+from zoneinfo import ZoneInfo
+
+
+# Timezones padrão
+UTC = ZoneInfo("UTC")
+B3_TZ = ZoneInfo("America/Sao_Paulo")
+
+
+def now_utc():
+    """
+    Retorna o horário atual em UTC.
+
+    Returns:
+        datetime: Data/hora atual com timezone UTC (aware).
+    """
+    return datetime.now(tz=UTC)
+
+
+def utc_to_b3(dt):
+    """
+    Converte um datetime em UTC para o timezone da B3.
+
+    Caso o datetime seja naive (sem timezone), assume-se que ele já está em UTC.
+
+    Args:
+        dt (datetime): Data/hora em UTC (aware ou naive).
+
+    Returns:
+        datetime: Data/hora convertida para o timezone da B3.
+    """
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=UTC)
+
+    return dt.astimezone(B3_TZ)
+
+
+def b3_to_utc(dt):
+    """
+    Converte um datetime do timezone da B3 para UTC.
+
+    Caso o datetime seja naive (sem timezone), assume-se que ele já está
+    no horário da B3 (America/Sao_Paulo).
+
+    Args:
+        dt (datetime): Data/hora no timezone da B3 (aware ou naive).
+
+    Returns:
+        datetime: Data/hora convertida para UTC.
+    """
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=B3_TZ)
+
+    return dt.astimezone(UTC)

{mtcli-3.7.2 → mtcli-3.7.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli"
-version = "3.7.2"
+version = "3.7.3"
 description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly"
 authors = [
     {name = "Valmir França",email = "vfranca3@gmail.com"}
@@ -34,6 +34,7 @@ classifiers = [
 dependencies = [
     "click (>=8.2.1,<9.0.0)",
     "metatrader5 (>=5.0.5260,<6.0.0)",
+    "tzdata (>=2025.3,<2026.0)",
 ]
 
 [project.urls]
@@ -45,6 +46,7 @@ issues = "https://github.com/vfranca/mtcli/issues"
 [project.scripts]
 mtcli = "mtcli.cli:mt"
 mt = "mtcli.cli:mt"
+mtdev = "mtcli.cli_dev:cli"
 
 [project.entry-points."mtcli.plugins"]
 internals = "mtcli.plugin:register"

mtcli-3.7.2/mtcli/cli.py

@@ -1,74 +0,0 @@
-"""
-CLI principal do mtcli.
-
-Este módulo define o grupo principal `mt`
-e inicializa o carregamento de plugins.
-"""
-
-import click
-
-from mtcli.plugin_loader import load_plugins
-from mtcli.logger import setup_logger
-
-from .commands.bars import bars
-from .commands.doctor import doctor
-
-logger = setup_logger(__name__)
-
-
-@click.group(context_settings={"max_content_width": 120})
-@click.version_option(package_name="mtcli")
-def mt():
-    """
-    CLI principal do mtcli.
-
-    Exibe gráficos e informações de mercado
-    em formato textual compatível com leitores de tela.
-    """
-    pass
-
-
-# ---------------------------------------------------------
-# Comandos internos
-# ---------------------------------------------------------
-
-mt.add_command(doctor, name="doctor")
-mt.add_command(bars, name="bars")
-mt.add_command(doctor, name="dr")
-
-
-# ---------------------------------------------------------
-# 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.7.2/mtcli/database.py

@@ -1,54 +0,0 @@
-"""
-Database core para mtcli.
-
-Responsável por:
-- Criar conexão SQLite
-- Ativar WAL
-- Garantir schema
-"""
-
-import sqlite3
-from pathlib import Path
-
-
-DB_PATH = Path.home() / ".mtcli" / "marketdata.db"
-
-
-def get_connection():
-    """
-    Retorna conexão SQLite configurada.
-    """
-    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
-
-    conn = sqlite3.connect(DB_PATH)
-    conn.execute("PRAGMA journal_mode=WAL;")
-    conn.execute("PRAGMA synchronous=NORMAL;")
-
-    _ensure_schema(conn)
-    return conn
-
-
-def _ensure_schema(conn):
-    conn.execute(
-        """
-        CREATE TABLE IF NOT EXISTS ticks (
-            symbol TEXT NOT NULL,
-            time INTEGER NOT NULL,
-            bid REAL,
-            ask REAL,
-            last REAL,
-            volume REAL,
-            flags INTEGER,
-            PRIMARY KEY (symbol, time)
-        );
-        """
-    )
-
-    conn.execute(
-        """
-        CREATE INDEX IF NOT EXISTS idx_ticks_symbol_time
-        ON ticks(symbol, time);
-        """
-    )
-
-    conn.commit()

mtcli-3.7.2/mtcli/logger.py

@@ -1,178 +0,0 @@
-"""
-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/
-
-* 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).
-
-* Suporte opcional a logs por processo (multi-process safe)
-
-Variáveis de ambiente
----------------------
-
-MTCLI_LOG_PER_PROCESS=1
-    cria arquivos separados por PID
-    exemplo: mtcli-1234.log
-
-MTCLI_LOG_NAME=risco
-    define nome base do arquivo de log
-
-Observação
-----------
-
-Os logs **não são exibidos no console**.
-Toda saída é direcionada exclusivamente para arquivo.
-"""
-
-import logging
-from logging.handlers import RotatingFileHandler
-import os
-from pathlib import Path
-
-
-# ==========================================================
-# DIRETÓRIO DE LOG
-# ==========================================================
-
-base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
-
-LOG_DIR = Path(base_dir) / "mtcli" / "logs"
-
-LOG_DIR.mkdir(parents=True, exist_ok=True)
-
-
-# ==========================================================
-# RESOLUÇÃO DO NOME DO LOG
-# ==========================================================
-
-def _resolve_log_file() -> Path:
-    """
-    Resolve dinamicamente o caminho do arquivo de log.
-
-    Mantém compatibilidade com versões anteriores
-    mas permite novos modos via variáveis de ambiente.
-    """
-
-    log_name = os.getenv("MTCLI_LOG_NAME", "mtcli")
-
-    per_process = os.getenv("MTCLI_LOG_PER_PROCESS")
-
-    if per_process:
-        pid = os.getpid()
-        filename = f"{log_name}-{pid}.log"
-    else:
-        filename = f"{log_name}.log"
-
-    return LOG_DIR / filename
-
-
-LOG_FILE = _resolve_log_file()
-
-
-# ==========================================================
-# 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 (silencia console)
-    # ======================================================
-
-    for handler in list(logger.handlers):
-
-        if isinstance(handler, logging.StreamHandler) and not isinstance(
-            handler, RotatingFileHandler
-        ):
-            logger.removeHandler(handler)
-
-    # ======================================================
-    # EVITA DUPLICAÇÃO DE FILE HANDLER
-    # ======================================================
-
-    for handler in logger.handlers:
-
-        if isinstance(handler, RotatingFileHandler):
-
-            try:
-                if Path(handler.baseFilename) == LOG_FILE:
-                    return logger
-            except Exception:
-                pass
-
-    # ======================================================
-    # FILE HANDLER ROTATIVO
-    # ======================================================
-
-    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
-# ==========================================================
-
-log = setup_logger()

mtcli-3.7.2/mtcli/marketdata/tick_cache.py

@@ -1,24 +0,0 @@
-"""
-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()

mtcli-3.7.2/mtcli/marketdata/tick_repository.py

@@ -1,142 +0,0 @@
-"""
-TickRepository profissional com:
-
-- Paginação automática
-- Sincronização incremental robusta
-- Integração com mt5_conexao
-- Proteção contra loops infinitos
-"""
-
-import MetaTrader5 as mt5
-from datetime import datetime, timedelta
-
-from ..database import get_connection
-from .tick_cache import TickCache
-from mtcli.mt5_context import mt5_conexao
-
-
-class TickRepository:
-
-    BATCH_SIZE = 200000  # tamanho seguro por lote
-
-    def __init__(self):
-        self.conn = get_connection()
-        self.cache = TickCache()
-
-    # ============================================================
-    # SINCRONIZAÇÃO COM PAGINAÇÃO
-    # ============================================================
-
-    def sync(self, symbol: str, days_back: int = 1):
-        """
-        Sincroniza banco com MT5 usando paginação.
-
-        Busca todos os ticks disponíveis desde o último timestamp.
-        """
-
-        total_inserted = 0
-
-        with mt5_conexao():
-
-            last_time = self._get_last_tick_time(symbol)
-
-            if last_time:
-                start = datetime.fromtimestamp(last_time + 1)
-            else:
-                start = datetime.now() - timedelta(days=days_back)
-
-            while True:
-
-                ticks = mt5.copy_ticks_from(
-                    symbol,
-                    start,
-                    self.BATCH_SIZE,
-                    mt5.COPY_TICKS_ALL,
-                )
-
-                if ticks is None or len(ticks) == 0:
-                    break
-
-                inserted = self._insert_ticks(symbol, ticks)
-                total_inserted += inserted
-
-                self.cache.add_many(ticks)
-
-                # Atualiza início para próximo tick
-                ultimo_timestamp = int(ticks[-1]["time"])
-                novo_start = datetime.fromtimestamp(ultimo_timestamp + 1)
-
-                # Proteção contra loop infinito
-                if novo_start <= start:
-                    break
-
-                start = novo_start
-
-                # Se retornou menos que o batch, acabou histórico
-                if len(ticks) < self.BATCH_SIZE:
-                    break
-
-        return total_inserted
-
-    # ============================================================
-    # INSERÇÃO
-    # ============================================================
-
-    def _insert_ticks(self, symbol, ticks):
-
-        cursor = self.conn.cursor()
-
-        data = [
-            (
-                symbol,
-                int(t["time"]),
-                float(t["bid"]),
-                float(t["ask"]),
-                float(t["last"]),
-                float(t["volume"]),
-                int(t["flags"]),
-            )
-            for t in ticks
-        ]
-
-        cursor.executemany(
-            """
-            INSERT OR IGNORE INTO ticks
-            VALUES (?, ?, ?, ?, ?, ?, ?)
-            """,
-            data,
-        )
-
-        self.conn.commit()
-        return cursor.rowcount
-
-    # ============================================================
-    # CONSULTAS
-    # ============================================================
-
-    def get_ticks_between(self, symbol, start_ts, end_ts):
-        cursor = self.conn.cursor()
-        cursor.execute(
-            """
-            SELECT time, bid, ask, last, volume, flags
-            FROM ticks
-            WHERE symbol = ?
-            AND time BETWEEN ? AND ?
-            ORDER BY time ASC
-            """,
-            (symbol, start_ts, end_ts),
-        )
-        return cursor.fetchall()
-
-    def _get_last_tick_time(self, symbol):
-        cursor = self.conn.cursor()
-        cursor.execute(
-            """
-            SELECT MAX(time)
-            FROM ticks
-            WHERE symbol = ?
-            """,
-            (symbol,),
-        )
-        result = cursor.fetchone()
-        return result[0] if result and result[0] else None