mtcli 3.8.0.dev17__py3-none-any.whl → 4.0.0.dev1__py3-none-any.whl

mtcli/cli.py

@@ -4,57 +4,14 @@ CLI principal do mtcli.
 
 import os
 import click
-from mtcli.plugin_loader import load_plugins
-from mtcli.logger import setup_logger
-from mtcli.services.tick_service import ensure_tick_engine
+from .plugin_loader import load_plugins
+from .logger import setup_logger
 
 from .commands.bars import bars
 from .commands.doctor import doctor
-from .commands.ticks import ticks
-from .commands.backfill import backfill
 
 logger = setup_logger(__name__)
 
-_tick_engines = []
-
-
-def start_tick_capture():
-    """
-    Inicia captura contínua de ticks em background se MTCLI_SYMBOL estiver definido.
-    """
-
-    global _tick_engines
-
-    if _tick_engines:
-        return
-
-    symbols = os.getenv("MTCLI_SYMBOL")
-
-    if not symbols:
-        logger.info(
-            "Captura automática de ticks desativada (MTCLI_SYMBOL não definido)."
-        )
-        return
-
-    if isinstance(symbols, str):
-        symbols = [symbols]
-
-    logger.info("Iniciando captura contínua de ticks para %s", symbols)
-
-    try:
-        for symbol in symbols:
-            engine = ensure_tick_engine(symbol)
-            _tick_engines.append(engine)
-            # pode rodar em thread se quiser background
-            import threading
-            t = threading.Thread(target=engine.start, daemon=True)
-            t.start()
-
-        logger.info("Captura de ticks iniciada em background.")
-
-    except Exception:
-        logger.exception("Falha ao iniciar captura de ticks")
-
 
 @click.group(context_settings={"max_content_width": 120}, invoke_without_command=True)
 @click.version_option(package_name="mtcli")
@@ -64,17 +21,12 @@ def mt(ctx):
     CLI principal do mtcli.
     """
 
-    start_tick_capture()
-
     if ctx.invoked_subcommand is None:
         click.echo(ctx.get_help())
 
 
 mt.add_command(doctor, name="doctor")
 mt.add_command(bars, name="bars")
-mt.add_command(doctor, name="dr")
-mt.add_command(ticks)
-mt.add_command(backfill, name="fill")
 
 loaded_plugins = load_plugins(mt)
 logger.info("Plugins carregados: %s", loaded_plugins)

mtcli/commands/bars.py

@@ -1,147 +1,75 @@
-"""Exibe o gráfico de barras."""
+"""
+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 mtcli.conf import (
-    BARS,
-    DATE,
-    PERIOD,
-    TIMEFRAMES,
+from ..controllers.bars_controller import BarsController
+from ..conf import (
+    DATA_SOURCE_NAME,
+    SYMBOL,
+    TIMEFRAME,
+    MAX_BARS,
     VIEW,
-    VOLUME,
+    VOLUME_TYPE,
 )
-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
+from ..data.factory import create_data_source
 
 
-@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)
+@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,
+    )
 
-if __name__ == "__main__":
-    bars()
+    for line in lines:
+        click.echo(line)