mtcli 3.2.0.dev2__tar.gz → 3.2.1__tar.gz

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mtcli
-Version: 3.2.0.dev2
+Version: 3.2.1
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 em texto acessível ao leitor de telas
 License: GPL-3.0
 Keywords: MetaTrader 5,trading,CLI

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/mtcli/commands/bars.py

@@ -2,7 +2,6 @@
 
 import click
 
-from mtcli import conf
 from mtcli.models.rates_model import RatesModel
 from mtcli.models.bars_model import BarsModel
 from mtcli.views.full_view import FullView
@@ -15,6 +14,14 @@ from mtcli.views.open_view import OpenView
 from mtcli.views.high_view import HighView
 from mtcli.views.low_view import LowView
 from mtcli.views.close_view import CloseView
+from mtcli.conf import (
+    VIEW,
+    PERIOD,
+    BARS,
+    DATE,
+    VOLUME,
+    TIMEFRAMES,
+)
 
 
 @click.command(
@@ -51,34 +58,56 @@ from mtcli.views.close_view import CloseView
         ],
         case_sensitive=False,
     ),
-    default=conf.view,
-    help="Formato de exibicao, default m. Opcoes: ch ou m - minima; f - completa; r - ranges; v - volumes; va - variações percentuais; oh - OHLC; o - aberturas; h - maximas; l - minimas; c - fechamentos",
+    default=VIEW,
+    show_default=True,
+    help="Formato de exibicao. Opcoes: minima ou HL - minima; f - completa; r - ranges; v - volumes; va - variações percentuais; oh - OHLC; o - aberturas; h - maximas; l - minimas; c - fechamentos.",
 )
 @click.option(
     "--period",
     "-p",
-    type=click.Choice(conf.timeframes, case_sensitive=False),
-    default=conf.period,
-    help="Tempo grafico, default D1.",
+    type=click.Choice(TIMEFRAMES, case_sensitive=False),
+    default=PERIOD,
+    show_default=True,
+    help="Timeframe das barras.",
 )
 @click.option(
     "--count",
     "-c",
     type=int,
-    default=conf.periodos,
-    help="Quantidade de barras, default 20.",
+    default=BARS,
+    show_default=True,
+    help="Numero de barras.",
+)
+@click.option(
+    "--date",
+    "-d",
+    default=DATE,
+    show_default=True,
+    help="Data para intraday, formato AAAA-MM-DD.",
+)
+@click.option(
+    "--numerator",
+    "-n",
+    is_flag=True,
+    default=False,
+    show_default=True,
+    help="Ativa a numeracao das barras.",
 )
 @click.option(
-    "--date", "-d", default=conf.date, help="Data para intraday, formato AAAA-MM-DD."
+    "--show-date",
+    "-sd",
+    is_flag=True,
+    default=False,
+    show_default=True,
+    help="Ativa a datacao das barras.",
 )
-@click.option("--numerator", "-n", is_flag=True, help="Ativa a numeracao das barras.")
-@click.option("--show-date", "-sd", is_flag=True, help="Ativa a datacao das barras.")
 @click.option(
     "--volume",
     "-vo",
     type=click.Choice(["tick", "real"], case_sensitive=False),
-    default=conf.volume,
-    help="Tipo de volume, default tick.",
+    default=VOLUME,
+    show_default=True,
+    help="Tipo de volume.",
 )
 def bars(symbol, view, period, count, date, numerator, show_date, volume):
     """Exibe o grafico do MetaTrader 5."""

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/mtcli/conecta.py

@@ -1,41 +1,41 @@
-"""
-Gerencia a conexão direta com o terminal MetaTrader 5.
-Usado internamente pelo contexto mt5_conexao().
-"""
-
-import MetaTrader5 as mt5
-from mtcli.logger import setup_logger
-
-log = setup_logger()
-
-
-def conectar() -> bool:
-    """
-    Inicializa a conexão com o MetaTrader 5.
-
-    Retorna:
-        bool: True se conectado com sucesso, False caso contrário.
-
-    Levanta:
-        ConnectionError: se a inicialização do MT5 falhar.
-    """
-    log.debug("Tentando inicializar conexao com MetaTrader 5...")
-
-    if not mt5.initialize():
-        erro = mt5.last_error()
-        log.error(f"Erro ao conectar ao MetaTrader 5: {erro}")
-        raise ConnectionError(f"Falha ao conectar ao MetaTrader 5: {erro}")
-
-    log.info("Conexao com MetaTrader 5 estabelecida com sucesso.")
-    return True
-
-
-def shutdown():
-    """
-    Encerra a conexão com o MetaTrader 5 de forma segura.
-    """
-    try:
-        mt5.shutdown()
-        log.debug("Conexao com MetaTrader 5 encerrada.")
-    except Exception as e:
-        log.error(f"Erro ao encerrar conexao com MetaTrader 5: {e}")
+"""
+Gerencia a conexão direta com o terminal MetaTrader 5.
+Usado internamente pelo contexto mt5_conexao().
+"""
+
+import MetaTrader5 as mt5
+from mtcli.logger import setup_logger
+
+log = setup_logger()
+
+
+def conectar() -> bool:
+    """
+    Inicializa a conexão com o MetaTrader 5.
+
+    Retorna:
+        bool: True se conectado com sucesso, False caso contrário.
+
+    Levanta:
+        ConnectionError: se a inicialização do MT5 falhar.
+    """
+    log.debug("Tentando inicializar conexao com MetaTrader 5...")
+
+    if not mt5.initialize():
+        erro = mt5.last_error()
+        log.error(f"Erro ao conectar ao MetaTrader 5: {erro}")
+        raise ConnectionError(f"Falha ao conectar ao MetaTrader 5: {erro}")
+
+    log.info("Conexao com MetaTrader 5 estabelecida com sucesso.")
+    return True
+
+
+def shutdown():
+    """
+    Encerra a conexão com o MetaTrader 5 de forma segura.
+    """
+    try:
+        mt5.shutdown()
+        log.debug("Conexao com MetaTrader 5 encerrada.")
+    except Exception as e:
+        log.error(f"Erro ao encerrar conexao com MetaTrader 5: {e}")

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/mtcli/conf.py

@@ -1,101 +1,101 @@
-import os
-import MetaTrader5 as mt5
-from mtcli.conecta import conectar, shutdown
-from mtcli.models.conf_model import ConfModel
-
-
-config = ConfModel("mtcli.ini").carregar()
-
-section = "DEFAULT"
-symbol = os.getenv("SYMBOL", config[section].get("symbol", fallback="WIN$N"))
-digitos = int(os.getenv("DIGITOS", config[section].getint("digitos", fallback=2)))
-period = os.getenv("PERIOD", config[section].get("period", fallback="D1"))
-periodos = count = int(
-    os.getenv("COUNT", config[section].getint("count", fallback=999))
-)
-view = os.getenv("VIEW", config[section].get("view", fallback="ch"))
-volume = os.getenv("VOLUME", config[section].get("volume", fallback="tick"))
-date = os.getenv("DATE", config[section].get("date", fallback=""))
-
-lateral = os.getenv("LATERAL", config[section].get("lateral", fallback="doji"))
-alta = os.getenv("ALTA", config[section].get("alta", fallback="verde"))
-baixa = os.getenv("BAIXA", config[section].get("baixa", fallback="vermelho"))
-rompimento_alta = os.getenv(
-    "ROMPIMENTO_ALTA", config[section].get("rompimento_alta", fallback="c")
-)
-rompimento_baixa = os.getenv(
-    "ROMPIMENTO_BAIXA", config[section].get("rompimento_baixa", fallback="v")
-)
-percentual_rompimento = int(
-    os.getenv(
-        "PERCENTUAL_ROMPIMENTO",
-        config[section].getint("percentual_rompimento", fallback=50),
-    )
-)
-percentual_doji = int(
-    os.getenv("PERCENTUAL_DOJI", config[section].getint("percentual_doji", fallback=10))
-)
-up_bar = os.getenv("UP_BAR", config[section].get("up_bar", fallback="asc"))
-down_bar = os.getenv("DOWN_BAR", config[section].get("down_bar", fallback="desc"))
-inside_bar = os.getenv("INSIDE_BAR", config[section].get("inside_bar", fallback="ib"))
-outside_bar = os.getenv(
-    "OUTSIDE_BAR", config[section].get("outside_bar", fallback="ob")
-)
-sombra_superior = os.getenv(
-    "SOMBRA_SUPERIOR", config[section].get("sombra_superior", fallback="top")
-)
-sombra_inferior = os.getenv(
-    "SOMBRA_INFERIOR", config[section].get("sombra_inferior", fallback="bottom")
-)
-data_source = dados = os.getenv("DADOS", config[section].get("dados", fallback="mt5"))
-csv_path = mt5_pasta = os.getenv(
-    "MT5_PASTA", config[section].get("mt5_pasta", fallback="")
-)
-
-
-def get_data_source():
-    from mtcli.data import CsvDataSource, MT5DataSource
-
-    if data_source.lower() == "csv":
-        return CsvDataSource()
-    elif data_source.lower() == "mt5":
-        return MT5DataSource()
-    else:
-        raise ValueError(f"Fonte de dados desconhecida: {data_source}")
-
-
-if not csv_path:
-    conectar()
-    terminal_info = mt5.terminal_info()
-    if terminal_info is None:
-        raise RuntimeError("Não foi possível obter as informações do terminal.")
-
-    csv_path = terminal_info.data_path + "/MQL5/Files"
-    shutdown()
-
-csv_path = csv_path.replace("\\", "/")
-csv_path += "/"
-
-timeframes = [
-    "mn1",
-    "w1",
-    "d1",
-    "h12",
-    "h8",
-    "h6",
-    "h4",
-    "h3",
-    "h2",
-    "h1",
-    "m30",
-    "m20",
-    "m15",
-    "m12",
-    "m10",
-    "m6",
-    "m5",
-    "m4",
-    "m3",
-    "m2",
-    "m1",
-]
+import os
+import MetaTrader5 as mt5
+from mtcli.conecta import conectar, shutdown
+from mtcli.models.conf_model import ConfModel
+
+
+config = ConfModel("mtcli.ini").carregar()
+
+section = "DEFAULT"
+symbol = os.getenv("SYMBOL", config[section].get("symbol", fallback="WIN$N"))
+digitos = int(os.getenv("DIGITOS", config[section].getint("digitos", fallback=2)))
+PERIOD = period = os.getenv("PERIOD", config[section].get("period", fallback="D1"))
+BARS = periodos = count = int(
+    os.getenv("COUNT", config[section].getint("count", fallback=999))
+)
+VIEW = view = os.getenv("VIEW", config[section].get("view", fallback="ch"))
+VOLUME = volume = os.getenv("VOLUME", config[section].get("volume", fallback="tick"))
+DATE = date = os.getenv("DATE", config[section].get("date", fallback=""))
+
+lateral = os.getenv("LATERAL", config[section].get("lateral", fallback="doji"))
+alta = os.getenv("ALTA", config[section].get("alta", fallback="verde"))
+baixa = os.getenv("BAIXA", config[section].get("baixa", fallback="vermelho"))
+rompimento_alta = os.getenv(
+    "ROMPIMENTO_ALTA", config[section].get("rompimento_alta", fallback="c")
+)
+rompimento_baixa = os.getenv(
+    "ROMPIMENTO_BAIXA", config[section].get("rompimento_baixa", fallback="v")
+)
+percentual_rompimento = int(
+    os.getenv(
+        "PERCENTUAL_ROMPIMENTO",
+        config[section].getint("percentual_rompimento", fallback=50),
+    )
+)
+percentual_doji = int(
+    os.getenv("PERCENTUAL_DOJI", config[section].getint("percentual_doji", fallback=10))
+)
+up_bar = os.getenv("UP_BAR", config[section].get("up_bar", fallback="asc"))
+down_bar = os.getenv("DOWN_BAR", config[section].get("down_bar", fallback="desc"))
+inside_bar = os.getenv("INSIDE_BAR", config[section].get("inside_bar", fallback="ib"))
+outside_bar = os.getenv(
+    "OUTSIDE_BAR", config[section].get("outside_bar", fallback="ob")
+)
+sombra_superior = os.getenv(
+    "SOMBRA_SUPERIOR", config[section].get("sombra_superior", fallback="top")
+)
+sombra_inferior = os.getenv(
+    "SOMBRA_INFERIOR", config[section].get("sombra_inferior", fallback="bottom")
+)
+data_source = dados = os.getenv("DADOS", config[section].get("dados", fallback="mt5"))
+csv_path = mt5_pasta = os.getenv(
+    "MT5_PASTA", config[section].get("mt5_pasta", fallback="")
+)
+
+
+def get_data_source():
+    from mtcli.data import CsvDataSource, MT5DataSource
+
+    if data_source.lower() == "csv":
+        return CsvDataSource()
+    elif data_source.lower() == "mt5":
+        return MT5DataSource()
+    else:
+        raise ValueError(f"Fonte de dados desconhecida: {data_source}")
+
+
+if not csv_path:
+    conectar()
+    terminal_info = mt5.terminal_info()
+    if terminal_info is None:
+        raise RuntimeError("Não foi possível obter as informações do terminal.")
+
+    csv_path = terminal_info.data_path + "/MQL5/Files"
+    shutdown()
+
+csv_path = csv_path.replace("\\", "/")
+csv_path += "/"
+
+TIMEFRAMES = timeframes = [
+    "mn1",
+    "w1",
+    "d1",
+    "h12",
+    "h8",
+    "h6",
+    "h4",
+    "h3",
+    "h2",
+    "h1",
+    "m30",
+    "m20",
+    "m15",
+    "m12",
+    "m10",
+    "m6",
+    "m5",
+    "m4",
+    "m3",
+    "m2",
+    "m1",
+]

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/mtcli/data/mt5.py

@@ -1,97 +1,97 @@
-"""Módulo fonte de dados via API do MetaTrader 5."""
-
-from datetime import datetime
-
-import MetaTrader5 as mt5
-
-from mtcli.logger import setup_logger
-from mtcli.mt5_context import mt5_conexao
-
-from .base import DataSourceBase
-
-log = setup_logger()
-
-
-class MT5DataSource(DataSourceBase):
-    """Fonte de dados via API do MetaTrader 5."""
-
-    def get_data(self, symbol, period, count=100):
-        """Retorna uma lista de lista de cotações do MetaTrader."""
-        period = period.upper()
-        log.info(
-            f"Iniciando coleta de dados via API MT5: {symbol} no timeframe {period}"
-        )
-        tf_map = {
-            "M1": mt5.TIMEFRAME_M1,
-            "M2": mt5.TIMEFRAME_M2,
-            "M3": mt5.TIMEFRAME_M3,
-            "M4": mt5.TIMEFRAME_M4,
-            "M5": mt5.TIMEFRAME_M5,
-            "M6": mt5.TIMEFRAME_M6,
-            "M10": mt5.TIMEFRAME_M10,
-            "M12": mt5.TIMEFRAME_M12,
-            "M15": mt5.TIMEFRAME_M15,
-            "M20": mt5.TIMEFRAME_M20,
-            "M30": mt5.TIMEFRAME_M30,
-            "H1": mt5.TIMEFRAME_H1,
-            "H2": mt5.TIMEFRAME_H2,
-            "H3": mt5.TIMEFRAME_H3,
-            "H4": mt5.TIMEFRAME_H4,
-            "H6": mt5.TIMEFRAME_H6,
-            "H8": mt5.TIMEFRAME_H8,
-            "H12": mt5.TIMEFRAME_H12,
-            "D1": mt5.TIMEFRAME_D1,
-            "W1": mt5.TIMEFRAME_W1,
-            "MN1": mt5.TIMEFRAME_MN1,
-        }
-
-        if period.upper() not in tf_map:
-            log.error(f"Timeframe inválido: {period}.")
-            raise ValueError(f"Timeframe '{period}' inválido.")
-
-        corretoras_b3 = [
-            "clear",
-            "xp",
-            "rico",
-            "modal",
-            "terra",
-            "btg",
-            "toro",
-        ]
-
-        with mt5_conexao():
-            for corretora in corretoras_b3:
-                symbol = (
-                    symbol.upper()
-                    if corretora in mt5.account_info().company.lower()
-                    else symbol
-                )
-            log.info(
-                f"Finalizada verificacao da corretora para tratar symbol: {symbol}."
-            )
-
-            rates = mt5.copy_rates_from_pos(symbol, tf_map[period], 0, count)
-
-        if rates is None:
-            log.warning("Nenum dado retornado da API MT5.")
-            raise ValueError("Nenhum dado retornado da API MT5.")
-
-        result = []
-        for r in rates:
-            dt_str = (
-                r["time"].astype("datetime64[s]").item().strftime("%Y.%m.%d %H:%M:%S")
-            )
-            result.append(
-                [
-                    dt_str,
-                    r["open"],
-                    r["high"],
-                    r["low"],
-                    r["close"],
-                    r["tick_volume"],
-                    r["real_volume"],
-                ]
-            )
-
-        log.info("Coleta de dados via API MT5 finalizada.")
-        return result
+"""Módulo fonte de dados via API do MetaTrader 5."""
+
+from datetime import datetime
+
+import MetaTrader5 as mt5
+
+from mtcli.logger import setup_logger
+from mtcli.mt5_context import mt5_conexao
+
+from .base import DataSourceBase
+
+log = setup_logger()
+
+
+class MT5DataSource(DataSourceBase):
+    """Fonte de dados via API do MetaTrader 5."""
+
+    def get_data(self, symbol, period, count=100):
+        """Retorna uma lista de lista de cotações do MetaTrader."""
+        period = period.upper()
+        log.info(
+            f"Iniciando coleta de dados via API MT5: {symbol} no timeframe {period}"
+        )
+        tf_map = {
+            "M1": mt5.TIMEFRAME_M1,
+            "M2": mt5.TIMEFRAME_M2,
+            "M3": mt5.TIMEFRAME_M3,
+            "M4": mt5.TIMEFRAME_M4,
+            "M5": mt5.TIMEFRAME_M5,
+            "M6": mt5.TIMEFRAME_M6,
+            "M10": mt5.TIMEFRAME_M10,
+            "M12": mt5.TIMEFRAME_M12,
+            "M15": mt5.TIMEFRAME_M15,
+            "M20": mt5.TIMEFRAME_M20,
+            "M30": mt5.TIMEFRAME_M30,
+            "H1": mt5.TIMEFRAME_H1,
+            "H2": mt5.TIMEFRAME_H2,
+            "H3": mt5.TIMEFRAME_H3,
+            "H4": mt5.TIMEFRAME_H4,
+            "H6": mt5.TIMEFRAME_H6,
+            "H8": mt5.TIMEFRAME_H8,
+            "H12": mt5.TIMEFRAME_H12,
+            "D1": mt5.TIMEFRAME_D1,
+            "W1": mt5.TIMEFRAME_W1,
+            "MN1": mt5.TIMEFRAME_MN1,
+        }
+
+        if period.upper() not in tf_map:
+            log.error(f"Timeframe inválido: {period}.")
+            raise ValueError(f"Timeframe '{period}' inválido.")
+
+        corretoras_b3 = [
+            "clear",
+            "xp",
+            "rico",
+            "modal",
+            "terra",
+            "btg",
+            "toro",
+        ]
+
+        with mt5_conexao():
+            for corretora in corretoras_b3:
+                symbol = (
+                    symbol.upper()
+                    if corretora in mt5.account_info().company.lower()
+                    else symbol
+                )
+            log.info(
+                f"Finalizada verificacao da corretora para tratar symbol: {symbol}."
+            )
+
+            rates = mt5.copy_rates_from_pos(symbol, tf_map[period], 0, count)
+
+        if rates is None:
+            log.warning("Nenum dado retornado da API MT5.")
+            raise ValueError("Nenhum dado retornado da API MT5.")
+
+        result = []
+        for r in rates:
+            dt_str = (
+                r["time"].astype("datetime64[s]").item().strftime("%Y.%m.%d %H:%M:%S")
+            )
+            result.append(
+                [
+                    dt_str,
+                    r["open"],
+                    r["high"],
+                    r["low"],
+                    r["close"],
+                    r["tick_volume"],
+                    r["real_volume"],
+                ]
+            )
+
+        log.info("Coleta de dados via API MT5 finalizada.")
+        return result

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/mtcli/logger.py

@@ -1,45 +1,45 @@
-import logging
-from logging.handlers import RotatingFileHandler
-import os
-
-LOG_DIR = os.path.join(os.path.expanduser("~"), ".mtcli")
-os.makedirs(LOG_DIR, exist_ok=True)
-LOG_FILE = os.path.join(LOG_DIR, "mtcli.log")
-
-
-def setup_logger(name: str = "mtcli") -> logging.Logger:
-    """Configura logger rotativo com saída em arquivo e console.
-
-    - Escreve logs em ~/.mtcli/mtcli.log (máx. 2 MB, 3 backups).
-    - Mostra logs também no console (stdout), capturáveis via pytest/caplog.
-    - Evita duplicar handlers.
-    """
-
-    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",
-    )
-
-    # === File handler rotativo ===
-    if not any(isinstance(h, RotatingFileHandler) for h in logger.handlers):
-        file_handler = RotatingFileHandler(LOG_FILE, maxBytes=2_000_000, backupCount=3)
-        file_handler.setFormatter(formatter)
-        logger.addHandler(file_handler)
-
-    # === Stream handler (console) ===
-    if not any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
-        console_handler = logging.StreamHandler()
-        console_handler.setFormatter(formatter)
-        logger.addHandler(console_handler)
-
-    # Permite que pytest caplog capture logs
-    logger.propagate = True
-
-    return logger
-
-
-# Inicializa logger padrão
-log = setup_logger()
+import logging
+from logging.handlers import RotatingFileHandler
+import os
+
+LOG_DIR = os.path.join(os.path.expanduser("~"), ".mtcli")
+os.makedirs(LOG_DIR, exist_ok=True)
+LOG_FILE = os.path.join(LOG_DIR, "mtcli.log")
+
+
+def setup_logger(name: str = "mtcli") -> logging.Logger:
+    """Configura logger rotativo com saída em arquivo e console.
+
+    - Escreve logs em ~/.mtcli/mtcli.log (máx. 2 MB, 3 backups).
+    - Mostra logs também no console (stdout), capturáveis via pytest/caplog.
+    - Evita duplicar handlers.
+    """
+
+    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",
+    )
+
+    # === File handler rotativo ===
+    if not any(isinstance(h, RotatingFileHandler) for h in logger.handlers):
+        file_handler = RotatingFileHandler(LOG_FILE, maxBytes=2_000_000, backupCount=3)
+        file_handler.setFormatter(formatter)
+        logger.addHandler(file_handler)
+
+    # === Stream handler (console) ===
+    if not any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
+        console_handler = logging.StreamHandler()
+        console_handler.setFormatter(formatter)
+        logger.addHandler(console_handler)
+
+    # Permite que pytest caplog capture logs
+    logger.propagate = True
+
+    return logger
+
+
+# Inicializa logger padrão
+log = setup_logger()

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/mtcli/mt5_context.py

@@ -1,33 +1,33 @@
-"""
-Gerencia o ciclo de conexão com o MetaTrader 5.
-Fornece o contexto 'mt5_conexao' para uso seguro em blocos with.
-"""
-
-from contextlib import contextmanager
-from mtcli.logger import setup_logger
-from mtcli.conecta import conectar, shutdown
-
-log = setup_logger()
-
-
-@contextmanager
-def mt5_conexao():
-    """
-    Context manager para conexão com o MetaTrader 5.
-    - Chama `conectar()` ao entrar no contexto.
-    - Chama `shutdown()` ao sair.
-    - Loga falhas e garante fechamento seguro.
-    """
-    try:
-        log.debug("Inicializando conexao com MetaTrader 5...")
-        conectar()
-        yield
-    except Exception as e:
-        log.error(f"Erro ao conectar ao MetaTrader 5: {e}")
-        raise
-    finally:
-        try:
-            shutdown()
-            log.debug("Conexao com MetaTrader 5 encerrada.")
-        except Exception as e:
-            log.error(f"Erro ao encerrar conexao MT5: {e}")
+"""
+Gerencia o ciclo de conexão com o MetaTrader 5.
+Fornece o contexto 'mt5_conexao' para uso seguro em blocos with.
+"""
+
+from contextlib import contextmanager
+from mtcli.logger import setup_logger
+from mtcli.conecta import conectar, shutdown
+
+log = setup_logger()
+
+
+@contextmanager
+def mt5_conexao():
+    """
+    Context manager para conexão com o MetaTrader 5.
+    - Chama `conectar()` ao entrar no contexto.
+    - Chama `shutdown()` ao sair.
+    - Loga falhas e garante fechamento seguro.
+    """
+    try:
+        log.debug("Inicializando conexao com MetaTrader 5...")
+        conectar()
+        yield
+    except Exception as e:
+        log.error(f"Erro ao conectar ao MetaTrader 5: {e}")
+        raise
+    finally:
+        try:
+            shutdown()
+            log.debug("Conexao com MetaTrader 5 encerrada.")
+        except Exception as e:
+            log.error(f"Erro ao encerrar conexao MT5: {e}")

{mtcli-3.2.0.dev2 → mtcli-3.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli"
-version = "3.2.0-dev2"
+version = "3.2.1"
 description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 em texto acessível ao leitor de telas"
 authors = [
     {name = "Valmir França da Silva",email = "vfranca3@gmail.com"}