mtcli 3.2.0.dev0__py3-none-any.whl → 3.2.0.dev1__py3-none-any.whl

mtcli/conecta.py

@@ -1,18 +1,41 @@
-"""Módulo de conexão com o MetaTrader 5."""
+"""
+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
 
-logger = setup_logger()
+log = setup_logger()
 
 
-def conectar():
+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 conexão com MetaTrader 5...")
+
     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()
+        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("Conexão com MetaTrader 5 estabelecida com sucesso.")
     return True
 
 
 def shutdown():
-    mt5.shutdown()
+    """
+    Encerra a conexão com o MetaTrader 5 de forma segura.
+    """
+    try:
+        mt5.shutdown()
+        log.debug("Conexão com MetaTrader 5 encerrada.")
+    except Exception as e:
+        log.error(f"Erro ao encerrar conexão com MetaTrader 5: {e}")

{mtcli-3.2.0.dev0.dist-info → mtcli-3.2.0.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mtcli
-Version: 3.2.0.dev0
+Version: 3.2.0.dev1
 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.dev0.dist-info → mtcli-3.2.0.dev1.dist-info}/RECORD

@@ -3,7 +3,7 @@ mtcli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mtcli/commands/bars.py,sha256=BxhrN_EQY9ummTHhav7gX7HrJCE7t5ltcI-Ld88TPJ0,4274
 mtcli/commands/conf.py,sha256=25YGs4laxx8Ss85LRST90QDehCMPomhz6U8Qb9aVwak,1549
 mtcli/commands/logs.py,sha256=yTg9dOvzw2iK6fhasd34ZNhcUfWRf7DKk86vxDILAqw,1349
-mtcli/conecta.py,sha256=XmW5f-JqjTXhj4cWm4KISoo69KMVZ7lRTHfBoynVtsk,409
+mtcli/conecta.py,sha256=LHesQwxRRzvP5rpZ_4b9tpNERDwHSoPD-cM2vfQMJmM,1118
 mtcli/conf.py,sha256=wvgCirMKnrmhknwGrvAIp9DOOz3LR8xCGvUYHdLnUck,3057
 mtcli/data/__init__.py,sha256=NMzgUoiyY5OUFJkmR-OCFF2fOTY9vp-64z8-bh7HEcs,64
 mtcli/data/base.py,sha256=Hv1r1IlIhFVEhINWz90FZptYIdhyBKxhMBn5odJfT_8,314
@@ -63,8 +63,8 @@ mtcli/views/ranges_view.py,sha256=FmRUhq_8JSPODv3wT7Jlvh9p9TWSJpDtj4WNfFBVQZQ,13
 mtcli/views/rates_view.py,sha256=vaWIa9oPeIR2mdouyFCU1pk-T1Zc4eiK17LFsqldDQs,1214
 mtcli/views/vars_view.py,sha256=wQ1-gJYFii2w0BDt10y9Cgw-y0iqVjDKbLvhcOH-zus,1770
 mtcli/views/volumes_view.py,sha256=dk_CMATbnQdHGuNuZ1xONToC31eUhLCbuXtewZ9FE-w,1602
-mtcli-3.2.0.dev0.dist-info/entry_points.txt,sha256=5R3VOurhCTctnZKSA673LWLkB2mklJl_PobPwpe35EM,204
-mtcli-3.2.0.dev0.dist-info/LICENSE,sha256=vZGn4wXWr9Tty92CJcj-dxw_S6mjZAhtsYVJ5VLSTUg,726
-mtcli-3.2.0.dev0.dist-info/METADATA,sha256=LxcghdeRdkLFA2I7BJdaImEGPzCJ8Gu1y65JmXa_eWQ,3468
-mtcli-3.2.0.dev0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-mtcli-3.2.0.dev0.dist-info/RECORD,,
+mtcli-3.2.0.dev1.dist-info/entry_points.txt,sha256=5R3VOurhCTctnZKSA673LWLkB2mklJl_PobPwpe35EM,204
+mtcli-3.2.0.dev1.dist-info/LICENSE,sha256=vZGn4wXWr9Tty92CJcj-dxw_S6mjZAhtsYVJ5VLSTUg,726
+mtcli-3.2.0.dev1.dist-info/METADATA,sha256=DZTkCwNnxCET4Kx5zjiSuYw5oTYc-4H0rc5gC-w7Mik,3468
+mtcli-3.2.0.dev1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+mtcli-3.2.0.dev1.dist-info/RECORD,,