mtcli 3.2.0.dev2__tar.gz → 3.3.0__tar.gz

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

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

@@ -1,118 +1,147 @@
-"""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()
+"""Exibe o gráfico de barras."""
+
+import click
+
+from mtcli.conf import (
+    BARS,
+    DATE,
+    PERIOD,
+    TIMEFRAMES,
+    VIEW,
+    VOLUME,
+)
+from mtcli.models.bars_model import BarsModel
+from mtcli.models.rates_model import RatesModel
+from mtcli.views.close_view import CloseView
+from mtcli.views.full_view import FullView
+from mtcli.views.high_view import HighView
+from mtcli.views.low_view import LowView
+from mtcli.views.min_view import MinView
+from mtcli.views.open_view import OpenView
+from mtcli.views.ranges_view import RangesView
+from mtcli.views.rates_view import RatesView
+from mtcli.views.vars_view import VarsView
+from mtcli.views.volumes_view import VolumesView
+
+
+@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=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(TIMEFRAMES, case_sensitive=False),
+    default=PERIOD,
+    show_default=True,
+    help="Timeframe das barras.",
+)
+@click.option(
+    "--count",
+    "-c",
+    type=int,
+    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(
+    "--show-date",
+    "-sd",
+    is_flag=True,
+    default=False,
+    show_default=True,
+    help="Ativa a datacao das barras.",
+)
+@click.option(
+    "--volume",
+    "-vo",
+    type=click.Choice(["tick", "real"], case_sensitive=False),
+    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."""
+    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.2.0.dev2 → mtcli-3.3.0}/mtcli/commands/conf.py

@@ -1,7 +1,7 @@
 """Gerencia configurações registradas no mtcli.ini."""
 
-import os
 import click
+
 from mtcli.models.conf_model import ConfModel
 
 

{mtcli-3.2.0.dev2 → mtcli-3.3.0}/mtcli/commands/logs.py

@@ -1,40 +1,42 @@
-"""Comando logs para exibição dos logs."""
-
-import os
-import click
-from mtcli.logger import setup_logger
-
-
-@click.command("logs", help="Exibe ou limpa os logs de execução do mtcli.")
-@click.option("--clear", is_flag=True, help="Limpa o arquivo de log.")
-@click.option("--tail", default=0, type=int, help="Mostra apenas as últimas N linhas.")
-@click.option("--grep", default="", help="Filtra o log por uma palavra-chave.")
-def logs(clear, tail, grep):
-    """Exibe ou limpa os registros de log do mtcli."""
-    logger = setup_logger()
-    log_file = logger.handlers[0].baseFilename
-
-    if clear:
-        if os.path.exists(log_file):
-            open(log_file, "w", encoding="utf-8").close()
-            click.echo("Log limpo com sucesso.")
-        else:
-            click.echo("Nenhum log para limpar.")
-        return
-
-    if not os.path.exists(log_file):
-        click.echo("Nenhum log encontrado.")
-        return
-
-    with open(log_file, encoding="utf-8", errors="ignore") as f:
-        linhas = f.readlines()
-
-    if tail > 0:
-        linhas = linhas[-tail:]
-    if grep:
-        linhas = [linha for linha in linhas if grep.lower() in linha.lower()]
-
-    if not linhas:
-        click.echo("Nenhuma linha encontrada com os filtros aplicados.")
-    else:
-        click.echo_via_pager("".join(linhas))
+"""Comando logs para exibição dos logs."""
+
+import os
+
+import click
+
+from mtcli.logger import setup_logger
+
+
+@click.command("logs", help="Exibe ou limpa os logs de execução do mtcli.")
+@click.option("--clear", is_flag=True, help="Limpa o arquivo de log.")
+@click.option("--tail", default=0, type=int, help="Mostra apenas as últimas N linhas.")
+@click.option("--grep", default="", help="Filtra o log por uma palavra-chave.")
+def logs(clear, tail, grep):
+    """Exibe ou limpa os registros de log do mtcli."""
+    logger = setup_logger()
+    log_file = logger.handlers[0].baseFilename
+
+    if clear:
+        if os.path.exists(log_file):
+            open(log_file, "w", encoding="utf-8").close()
+            click.echo("Log limpo com sucesso.")
+        else:
+            click.echo("Nenhum log para limpar.")
+        return
+
+    if not os.path.exists(log_file):
+        click.echo("Nenhum log encontrado.")
+        return
+
+    with open(log_file, encoding="utf-8", errors="ignore") as f:
+        linhas = f.readlines()
+
+    if tail > 0:
+        linhas = linhas[-tail:]
+    if grep:
+        linhas = [linha for linha in linhas if grep.lower() in linha.lower()]
+
+    if not linhas:
+        click.echo("Nenhuma linha encontrada com os filtros aplicados.")
+    else:
+        click.echo_via_pager("".join(linhas))

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

@@ -1,41 +1,42 @@
-"""
-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.3.0}/mtcli/conf.py

@@ -1,21 +1,22 @@
 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(
+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 = 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=""))
+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"))
@@ -76,7 +77,7 @@ if not csv_path:
 csv_path = csv_path.replace("\\", "/")
 csv_path += "/"
 
-timeframes = [
+TIMEFRAMES = timeframes = [
     "mn1",
     "w1",
     "d1",