mtcli 3.0.0.dev2__tar.gz → 3.2.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mtcli
-Version: 3.0.0.dev2
+Version: 3.2.0
 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.0.0.dev2 → mtcli-3.2.0}/mtcli/commands/bars.py

@@ -1,126 +1,118 @@
-"""Exibe o gráfico de barras."""
-
-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
-from mtcli.views.min_view import MinView
-from mtcli.views.ranges_view import RangesView
-from mtcli.views.volumes_view import VolumesView
-from mtcli.views.vars_view import VarsView
-from mtcli.views.rates_view import RatesView
-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.logger import setup_logger
-
-
-logger = setup_logger("mtcli")  # Cria o logger
-
-
-@click.command(
-    "bars",
-    help="Mostra o gráfico de candles em texto para o ativo e período especificados.",
-)
-@click.argument("symbol")
-@click.option(
-    "--view",
-    "-v",
-    type=click.Choice(
-        [
-            "ch",
-            "m",
-            "hl",
-            "f",
-            "full",
-            "r",
-            "range",
-            "v",
-            "volume",
-            "va",
-            "percentual",
-            "oh",
-            "ohlc",
-            "o",
-            "open",
-            "h",
-            "high",
-            "l",
-            "low",
-            "c",
-            "close",
-        ],
-        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",
-)
-@click.option(
-    "--period",
-    "-p",
-    type=click.Choice(conf.timeframes, case_sensitive=False),
-    default=conf.period,
-    help="Tempo grafico, default D1.",
-)
-@click.option(
-    "--count",
-    "-c",
-    type=int,
-    default=conf.periodos,
-    help="Quantidade de barras, default 20.",
-)
-@click.option(
-    "--date", "-d", default=conf.date, help="Data para intraday, formato AAAA-MM-DD."
-)
-@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.",
-)
-def bars(symbol, view, period, count, date, numerator, show_date, volume):
-    """Exibe o grafico do MetaTrader 5."""
-    period = period.lower()
-    view = view.lower()
-    logger.info(
-        f"Iniciando exibição do gráfico MT5: {symbol} view {view} no {period} data {date} numerador {numerator} data {show_date} volume {volume}."
-    )
-    rates = RatesModel(symbol, period, count).get_data()
-    bars = BarsModel(rates, date).get_bars()
-    views = []
-    if view in ["m", "ch", "hl"]:  # máximas e mínimas
-        views = MinView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["r", "range"]:  # ranges
-        views = RangesView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["oh", "ohlc"]:  # OHLC
-        views = RatesView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["va", "percentual"]:  # variações percentuais
-        views = VarsView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["o", "open"]:  # abertura
-        views = OpenView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["h", "high"]:  # máximas
-        views = HighView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["l", "low"]:  # mínimas
-        views = LowView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["c", "close"]:  # fechamentos
-        views = CloseView(bars, count, period, date, numerator, show_date).views()
-    elif view in ["v", "volume"]:  # volumes
-        views = VolumesView(
-            bars, count, period, date, numerator, show_date, volume
-        ).views()
-    else:  # completo
-        views = FullView(bars, count, period, date, numerator, show_date).views()
-    if views:
-        for view in views:
-            click.echo(view)
-    logger.info("Exibição do gráfico MT5 finalizada.")
-
-
-if __name__ == "__main__":
-    bars()
+"""Exibe o gráfico de barras."""
+
+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
+from mtcli.views.min_view import MinView
+from mtcli.views.ranges_view import RangesView
+from mtcli.views.volumes_view import VolumesView
+from mtcli.views.vars_view import VarsView
+from mtcli.views.rates_view import RatesView
+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
+
+
+@click.command(
+    "bars",
+    help="Mostra o gráfico de candles em texto para o ativo e período especificados.",
+)
+@click.argument("symbol")
+@click.option(
+    "--view",
+    "-v",
+    type=click.Choice(
+        [
+            "ch",
+            "m",
+            "hl",
+            "f",
+            "full",
+            "r",
+            "range",
+            "v",
+            "volume",
+            "va",
+            "percentual",
+            "oh",
+            "ohlc",
+            "o",
+            "open",
+            "h",
+            "high",
+            "l",
+            "low",
+            "c",
+            "close",
+        ],
+        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",
+)
+@click.option(
+    "--period",
+    "-p",
+    type=click.Choice(conf.timeframes, case_sensitive=False),
+    default=conf.period,
+    help="Tempo grafico, default D1.",
+)
+@click.option(
+    "--count",
+    "-c",
+    type=int,
+    default=conf.periodos,
+    help="Quantidade de barras, default 20.",
+)
+@click.option(
+    "--date", "-d", default=conf.date, help="Data para intraday, formato AAAA-MM-DD."
+)
+@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.",
+)
+def bars(symbol, view, period, count, date, numerator, show_date, volume):
+    """Exibe o grafico do MetaTrader 5."""
+    period = period.lower()
+    view = view.lower()
+    rates = RatesModel(symbol, period, count).get_data()
+    bars = BarsModel(rates, date).get_bars()
+    views = []
+    if view in ["m", "ch", "hl"]:  # máximas e mínimas
+        views = MinView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["r", "range"]:  # ranges
+        views = RangesView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["oh", "ohlc"]:  # OHLC
+        views = RatesView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["va", "percentual"]:  # variações percentuais
+        views = VarsView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["o", "open"]:  # abertura
+        views = OpenView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["h", "high"]:  # máximas
+        views = HighView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["l", "low"]:  # mínimas
+        views = LowView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["c", "close"]:  # fechamentos
+        views = CloseView(bars, count, period, date, numerator, show_date).views()
+    elif view in ["v", "volume"]:  # volumes
+        views = VolumesView(
+            bars, count, period, date, numerator, show_date, volume
+        ).views()
+    else:  # completo
+        views = FullView(bars, count, period, date, numerator, show_date).views()
+    if views:
+        for view in views:
+            click.echo(view)
+
+
+if __name__ == "__main__":
+    bars()

{mtcli-3.0.0.dev2 → mtcli-3.2.0}/mtcli/commands/conf.py

@@ -1,50 +1,50 @@
-"""Gerencia configurações registradas no mtcli.ini."""
-
-import os
-import click
-from mtcli.models.conf_model import ConfModel
-
-
-@click.command(
-    "conf",
-    help="Gerencia as configurações salvas no arquivo mtcli.ini (adicionar, editar, listar).",
-)
-@click.option("--list", "list_", is_flag=True, help="Lista todas as configurações.")
-@click.option("--set", "set_", nargs=2, help="Define o valor de uma configuração.")
-@click.option("--get", help="Exibe o valor de uma configuração.")
-@click.option("--reset", is_flag=True, help="Redefine as configurações padrão.")
-def conf(list_, set_, get, reset):
-    """Gerencia configurações registradas no mtcli.ini."""
-    conf = ConfModel("mtcli.ini")
-    config = conf.carregar()
-
-    if list_:
-        for key in config["DEFAULT"]:
-            click.echo(f"{key} = {config['DEFAULT'][key]}")
-
-    elif set_:
-        chave, valor = set_
-        config["DEFAULT"][chave] = valor
-        conf.salvar(config)
-        click.echo(f"Configuração '{chave}' definida como '{valor}'.")
-
-    elif get:
-        valor = config["DEFAULT"].get(get)
-        if valor is not None:
-            click.echo(f"{get} = {valor}")
-        else:
-            click.echo(f"Configuração '{get}' não encontrada.")
-
-    elif reset:
-        config["DEFAULT"].clear()
-        conf.salvar(config)
-        click.echo("Configurações redefinidas.")
-
-    else:
-        click.echo(
-            "Nenhuma opção fornecida. Use --help para ver as opções disponíveis."
-        )
-
-
-if __name__ == "__main__":
-    conf()
+"""Gerencia configurações registradas no mtcli.ini."""
+
+import os
+import click
+from mtcli.models.conf_model import ConfModel
+
+
+@click.command(
+    "conf",
+    help="Gerencia as configurações salvas no arquivo mtcli.ini (adicionar, editar, listar).",
+)
+@click.option("--list", "list_", is_flag=True, help="Lista todas as configurações.")
+@click.option("--set", "set_", nargs=2, help="Define o valor de uma configuração.")
+@click.option("--get", help="Exibe o valor de uma configuração.")
+@click.option("--reset", is_flag=True, help="Redefine as configurações padrão.")
+def conf(list_, set_, get, reset):
+    """Gerencia configurações registradas no mtcli.ini."""
+    conf = ConfModel("mtcli.ini")
+    config = conf.carregar()
+
+    if list_:
+        for key in config["DEFAULT"]:
+            click.echo(f"{key} = {config['DEFAULT'][key]}")
+
+    elif set_:
+        chave, valor = set_
+        config["DEFAULT"][chave] = valor
+        conf.salvar(config)
+        click.echo(f"Configuração '{chave}' definida como '{valor}'.")
+
+    elif get:
+        valor = config["DEFAULT"].get(get)
+        if valor is not None:
+            click.echo(f"{get} = {valor}")
+        else:
+            click.echo(f"Configuração '{get}' não encontrada.")
+
+    elif reset:
+        config["DEFAULT"].clear()
+        conf.salvar(config)
+        click.echo("Configurações redefinidas.")
+
+    else:
+        click.echo(
+            "Nenhuma opção fornecida. Use --help para ver as opções disponíveis."
+        )
+
+
+if __name__ == "__main__":
+    conf()

mtcli-3.2.0/mtcli/conecta.py

@@ -0,0 +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}")

{mtcli-3.0.0.dev2 → mtcli-3.2.0}/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 = 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",
+]

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

@@ -5,11 +5,11 @@ from datetime import datetime
 import MetaTrader5 as mt5
 
 from mtcli.logger import setup_logger
-from mtcli.conecta import conectar, shutdown
+from mtcli.mt5_context import mt5_conexao
 
 from .base import DataSourceBase
 
-logger = setup_logger()
+log = setup_logger()
 
 
 class MT5DataSource(DataSourceBase):
@@ -18,8 +18,8 @@ class MT5DataSource(DataSourceBase):
     def get_data(self, symbol, period, count=100):
         """Retorna uma lista de lista de cotações do MetaTrader."""
         period = period.upper()
-        logger.info(
-            f"Iniciando coleta de dados via API MT5: {symbol} no período {period}."
+        log.info(
+            f"Iniciando coleta de dados via API MT5: {symbol} no timeframe {period}"
         )
         tf_map = {
             "M1": mt5.TIMEFRAME_M1,
@@ -46,12 +46,9 @@ class MT5DataSource(DataSourceBase):
         }
 
         if period.upper() not in tf_map:
-            logger.error(f"Timeframe inválido: {period}.")
+            log.error(f"Timeframe inválido: {period}.")
             raise ValueError(f"Timeframe '{period}' inválido.")
 
-        conectar()
-
-        # Verifica corretoras B3 e aplica tratamento a symbol
         corretoras_b3 = [
             "clear",
             "xp",
@@ -61,21 +58,22 @@ class MT5DataSource(DataSourceBase):
             "btg",
             "toro",
         ]
-        for corretora in corretoras_b3:
-            symbol = (
-                symbol.upper()
-                if corretora in mt5.account_info().company.lower()
-                else symbol
+
+        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}."
             )
-        logger.info(
-            f"Finalizada verificação da corretora para tratar symbol: {symbol}."
-        )
 
-        rates = mt5.copy_rates_from_pos(symbol, tf_map[period], 0, count)
-        shutdown()
+            rates = mt5.copy_rates_from_pos(symbol, tf_map[period], 0, count)
 
         if rates is None:
-            logger.warning("Nenum dado retornado da API MT5.")
+            log.warning("Nenum dado retornado da API MT5.")
             raise ValueError("Nenhum dado retornado da API MT5.")
 
         result = []
@@ -95,5 +93,5 @@ class MT5DataSource(DataSourceBase):
                 ]
             )
 
-        logger.info("Coleta de dados via API MT5 finalizada.")
+        log.info("Coleta de dados via API MT5 finalizada.")
         return result

mtcli-3.2.0/mtcli/logger.py

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

{mtcli-3.0.0.dev2 → mtcli-3.2.0}/mtcli/models/conf_model.py

@@ -1,33 +1,33 @@
-"""Modelo de configurações."""
-
-import os
-import configparser
-from configparser import MissingSectionHeaderError
-
-
-class ConfigFormatError(Exception):
-    pass
-
-
-class ConfModel:
-
-    def __init__(self, configuracoes):
-        self.CONFIG_PATH = os.path.abspath(configuracoes)
-
-    def carregar(self):
-        config = configparser.ConfigParser()
-        if os.path.exists(self.CONFIG_PATH):
-            try:
-                config.read(self.CONFIG_PATH)
-            except MissingSectionHeaderError:
-                raise ConfigFormatError(
-                    f"Erro: o arquivo '{self.CONFIG_PATH}' não contém seções válidas.\n"
-                    "Certifique-se de que ele está no formato correto:\n[padrao]\nCHAVE=valor"
-                )
-        else:
-            config["DEFAULT"] = {}
-        return config
-
-    def salvar(self, config):
-        with open(self.CONFIG_PATH, "w") as f:
-            config.write(f)
+"""Modelo de configurações."""
+
+import os
+import configparser
+from configparser import MissingSectionHeaderError
+
+
+class ConfigFormatError(Exception):
+    pass
+
+
+class ConfModel:
+
+    def __init__(self, configuracoes):
+        self.CONFIG_PATH = os.path.abspath(configuracoes)
+
+    def carregar(self):
+        config = configparser.ConfigParser()
+        if os.path.exists(self.CONFIG_PATH):
+            try:
+                config.read(self.CONFIG_PATH)
+            except MissingSectionHeaderError:
+                raise ConfigFormatError(
+                    f"Erro: o arquivo '{self.CONFIG_PATH}' não contém seções válidas.\n"
+                    "Certifique-se de que ele está no formato correto:\n[padrao]\nCHAVE=valor"
+                )
+        else:
+            config["DEFAULT"] = {}
+        return config
+
+    def salvar(self, config):
+        with open(self.CONFIG_PATH, "w") as f:
+            config.write(f)

mtcli-3.2.0/mtcli/mt5_context.py

@@ -0,0 +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}")

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

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli"
-version = "3.0.0.dev2"
+version = "3.2.0"
 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"}

mtcli-3.0.0.dev2/mtcli/conecta.py

@@ -1,18 +0,0 @@
-"""Módulo de conexão com o MetaTrader 5."""
-
-import MetaTrader5 as mt5
-from mtcli.logger import setup_logger
-
-logger = setup_logger()
-
-
-def conectar():
-    if not mt5.initialize():
-        click.echo(f"❌ Erro ao conectar ao MT5: {mt5.last_error()}")
-        logger.error(f"Erro ao conectar ao MT5: {mt5.last_error()}")
-        exit()
-    return True
-
-
-def shutdown():
-    mt5.shutdown()

mtcli-3.0.0.dev2/mtcli/logger.py

@@ -1,29 +0,0 @@
-"""Módulo de logging."""
-
-import os
-import logging
-from logging.handlers import RotatingFileHandler
-
-
-def setup_logger(name="mtcli"):
-    if os.name == "nt":
-        base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
-        log_dir = os.path.join(base_dir, name, "logs")
-    else:
-        base_dir = os.path.expanduser("~/.local/share")
-        log_dir = os.path.join(base_dir, name, "logs")
-
-    os.makedirs(log_dir, exist_ok=True)
-    log_path = os.path.join(log_dir, f"{name}.log")
-
-    handler = RotatingFileHandler(log_path, maxBytes=1_000_000, backupCount=3)
-    formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
-    handler.setFormatter(formatter)
-
-    logger = logging.getLogger(name)
-    logger.setLevel(logging.DEBUG)
-    if not logger.handlers:
-        logger.addHandler(handler)
-    logger.propagate = False
-
-    return logger