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

mtcli/__main__.py

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

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/commands/bars.py

@@ -1,153 +1,75 @@
-"""Exibe o gráfico de barras."""
-
-import click
-
-from mtcli.conf import (
-    DATE,
-    PERIOD,
-    PERIODOS,
-    SYMBOL,
-    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(
-    help="Mostra o gráfico de candles em texto para o ativo e período especificados.",
-)
-@click.option(
-    "--symbol",
-    "-s",
-    default=SYMBOL,
-    show_default=True,
-    help="Codigo ou ticker do ativo.",
-)
-@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 do grafico.",
-)
-@click.option(
-    "--count",
-    "-c",
-    type=int,
-    default=PERIODOS,
-    show_default=True,
-    help="Quantidade de periodos a serem exibidos.",
-)
-@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()
+"""
+Comando CLI `bars`.
+
+Responsável por:
+- receber parâmetros via terminal (Click)
+- instanciar a fonte de dados
+- delegar execução ao BarsController
+- imprimir saída no terminal
+
+Este comando é a camada de entrada (CLI) no padrão MVC do mtcli.
+"""
+
+import click
+
+from ..controllers.bars_controller import BarsController
+from ..conf import (
+    DATA_SOURCE_NAME,
+    SYMBOL,
+    TIMEFRAME,
+    MAX_BARS,
+    VIEW,
+    VOLUME_TYPE,
+)
+from ..data.factory import create_data_source
+
+
+@click.command()
+@click.option("--symbol", "-s", default=SYMBOL, show_default=True, help="Código do ativo (ex: WINM26)")
+@click.option("--timeframe", "-t", "period", default=TIMEFRAME, show_default=True, help="Timeframe (ex: M1, M5, D1)")
+@click.option("--max-bars", "-mb", "count", default=MAX_BARS, show_default=True, help="Quantidade de barras")
+@click.option("--view", "-v", default=VIEW, show_default=True, help="Formato da view (hl_view, full_view, etc)")
+@click.option("--date", "-d", default=None, show_default=True, help="Filtrar pregão (YYYY-MM-DD)")
+@click.option("--numerator", "-n", is_flag=True, show_default=True, help="Numerar barras")
+@click.option("--show-date", "-sd", is_flag=True, show_default=True, help="Exibir data/hora")
+@click.option("--volume-type", "-vt", "volume", default=VOLUME_TYPE, show_default=True, help="Tipo de volume (tick/real)")
+@click.option("--data-source", "-ds", "source", default=None, show_default=True, help="Fonte de dados (mt5/csv)")
+def bars(symbol, period, count, view, date, numerator, show_date, volume, source):
+    """
+    Executa o comando `bars`.
+
+    Fluxo:
+    1. Resolve fonte de dados
+    2. Executa controller
+    3. Renderiza saída linha a linha
+
+    Args:
+        symbol (str): Ativo
+        period (str): Timeframe
+        count (int): Quantidade de barras
+        view (str): Nome da view
+        date (str | None): Filtro de pregão
+        numerator (bool): Numerar barras
+        show_date (bool): Mostrar timestamp
+        volume (str | None): Tipo de volume
+        source (str | None): Fonte de dados
+    """
+
+    source_name = source or DATA_SOURCE_NAME
+    data_source = create_data_source(source_name)
+
+    controller = BarsController(data_source)
+
+    lines = controller.execute(
+        symbol=symbol,
+        period=period,
+        count=count,
+        date=date,
+        view=view,
+        numerator=numerator,
+        show_date=show_date,
+        volume=volume,
+    )
+
+    for line in lines:
+        click.echo(line)

mtcli/commands/conf.py

@@ -1,50 +1,44 @@
-"""Gerencia configurações registradas no mtcli.ini."""
+"""
+Comando para exibir configurações disponíveis.
+"""
 
 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.")
+from mtcli.config_registry import registry
+from mtcli.conf import conf
 
+
+@click.command()
+@click.argument("section", required=False)
+def conf_cmd(section):
+    """
+    Exibe configurações disponíveis.
+
+    Exemplos:
+
+        mt conf
+        mt conf renko
+    """
+
+    if section:
+        options = registry.get_section(section)
     else:
+        options = registry.get_all()
+
+    if not options:
+        click.echo("Nenhuma configuração registrada.")
+        return
+
+    for opt in options:
+
+        value = conf.get(opt.name, section=opt.section, default=opt.default)
+
         click.echo(
-            "Nenhuma opção fornecida. Use --help para ver as opções disponíveis."
+            f"{opt.section}.{opt.name} = {value} "
+            f"(default={opt.default})"
         )
 
+        if opt.description:
+            click.echo(f"  {opt.description}")
 
-if __name__ == "__main__":
-    conf()
+        click.echo()

mtcli/commands/doctor.py

@@ -0,0 +1,194 @@
+"""
+Comando de diagnóstico do mtcli.
+
+Este comando executa uma série de verificações básicas para ajudar
+a identificar problemas de instalação, configuração ou carregamento
+de plugins no ambiente do mtcli.
+
+As verificações incluem:
+
+- Versão do Python
+- Instalação do mtcli
+- Fonte de dados configurada
+- Caminho de dados CSV
+- Conexão com MetaTrader5
+- Descoberta e carregamento de plugins
+
+Caso algum plugin falhe ao carregar, o erro é exibido e registrado
+no sistema de logs.
+"""
+
+import sys
+import click
+import traceback
+
+from importlib.metadata import version, PackageNotFoundError
+
+import MetaTrader5 as mt5
+
+from mtcli.logger import setup_logger
+from mtcli.conf import conf, DATA_SOURCE_NAME
+from mtcli.mt5_context import mt5_conexao
+from mtcli.plugin_loader import discover_plugins
+
+
+logger = setup_logger(__name__)
+
+
+def status(ok: bool) -> str:
+    """
+    Retorna um marcador visual simples de status.
+
+    Parameters
+    ----------
+    ok : bool
+        Indica se o teste foi bem sucedido.
+
+    Returns
+    -------
+    str
+        Texto representando o status.
+    """
+    return "OK " if ok else "ERRO"
+
+
+@click.command()
+def doctor():
+    """
+    Executa diagnóstico do ambiente mtcli.
+
+    O comando verifica se os componentes essenciais do ambiente
+    estão funcionando corretamente e apresenta um relatório simples
+    no terminal.
+    """
+
+    click.echo("Diagnóstico do ambiente mtcli\n")
+
+    # ---------------------------------------------------------
+    # Python
+    # ---------------------------------------------------------
+
+    python_ok = sys.version_info >= (3, 10)
+
+    click.echo(f"{status(python_ok)} Python: {sys.version.split()[0]}")
+
+    if not python_ok:
+        click.echo("   Versão mínima recomendada: Python 3.10")
+
+    # ---------------------------------------------------------
+    # mtcli
+    # ---------------------------------------------------------
+
+    try:
+
+        mtcli_version = version("mtcli")
+
+        click.echo(f"{status(True)} mtcli: {mtcli_version}")
+
+    except PackageNotFoundError:
+
+        click.echo(f"{status(False)} mtcli não encontrado")
+
+        logger.error("Pacote mtcli não encontrado no ambiente.")
+
+    # ---------------------------------------------------------
+    # Fonte de dados
+    # ---------------------------------------------------------
+
+    click.echo(f"{status(True)} Data source: {DATA_SOURCE_NAME}")
+
+    # ---------------------------------------------------------
+    # CSV path
+    # ---------------------------------------------------------
+
+    try:
+
+        path = conf.get_csv_path()
+
+        click.echo(f"{status(True)} CSV path: {path}")
+
+    except Exception as exc:
+
+        click.echo(f"{status(False)} CSV path inválido")
+
+        logger.exception("Erro ao obter CSV path: %s", exc)
+
+    # ---------------------------------------------------------
+    # MT5 conexão
+    # ---------------------------------------------------------
+
+    try:
+
+        with mt5_conexao():
+
+            info = mt5.terminal_info()
+
+            if info:
+
+                click.echo(f"{status(True)} MetaTrader5 conectado")
+
+            else:
+
+                click.echo(f"{status(False)} MetaTrader5 não respondeu")
+
+    except Exception as exc:
+
+        click.echo(f"{status(False)} Falha na conexão MT5")
+
+        logger.exception("Erro ao conectar MT5: %s", exc)
+
+    # ---------------------------------------------------------
+    # Plugins
+    # ---------------------------------------------------------
+
+    click.echo("\nPlugins:")
+
+    try:
+
+        entry_points = list(discover_plugins())
+
+        if not entry_points:
+
+            click.echo("   Nenhum plugin encontrado.")
+            return
+
+        ok_count = 0
+        fail_count = 0
+
+        for ep in entry_points:
+
+            plugin_name = ep.name
+
+            try:
+
+                ep.load()
+
+                click.echo(f"   OK  {plugin_name}")
+
+                ok_count += 1
+
+            except Exception as exc:
+
+                click.echo(f"   ERRO {plugin_name}")
+
+                click.echo(f"       {exc}")
+
+                logger.error(
+                    "Erro ao carregar plugin %s\n%s",
+                    plugin_name,
+                    traceback.format_exc(),
+                )
+
+                fail_count += 1
+
+        click.echo(
+            f"\nResumo: {ok_count} plugins OK | {fail_count} com erro"
+        )
+
+    except Exception as exc:
+
+        click.echo(f"{status(False)} Falha ao descobrir plugins")
+
+        logger.exception("Erro ao descobrir plugins: %s", exc)
+
+    click.echo("\nDiagnóstico concluído.")