mtcli 3.8.0.dev17__tar.gz → 4.0.0.dev1__tar.gz

{mtcli-3.8.0.dev17 → mtcli-4.0.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.8.0.dev17
+Version: 4.0.0.dev1
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
 License-Expression: MIT
 License-File: LICENSE

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

@@ -0,0 +1,75 @@
+"""
+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-4.0.0.dev1/mtcli/conf.py

@@ -0,0 +1,125 @@
+"""
+Sistema central de configuração do mtcli.
+"""
+
+import os
+import configparser
+import MetaTrader5 as mt5
+
+from mtcli.mt5_context import mt5_conexao
+
+
+class Config:
+    def __init__(self, filename="mtcli.ini"):
+        self.config = configparser.ConfigParser()
+        self.config.read(filename)
+
+    def get(self, key, section="DEFAULT", cast=None, default=None):
+        env_key = f"{section.upper()}_{key.upper()}"
+        value = os.getenv(env_key) or os.getenv(key.upper())
+
+        if value is None:
+            if self.config.has_option(section, key):
+                value = self.config.get(section, key)
+            elif self.config.has_option("DEFAULT", key):
+                value = self.config.get("DEFAULT", key)
+            else:
+                value = default
+
+        if cast and value is not None:
+            try:
+                if cast is bool:
+                    value = str(value).lower() in ("1", "true", "yes")
+                else:
+                    value = cast(value)
+            except ValueError:
+                value = default
+
+        return value
+
+    def section(self, section):
+        class Section:
+            def __init__(self, parent, section):
+                self.parent = parent
+                self.section = section
+
+            def get(self, key, cast=None, default=None):
+                return self.parent.get(key, self.section, cast, default)
+
+        return Section(self, section)
+
+    def get_csv_path(self):
+        path = self.get("mt5_pasta")
+
+        if path:
+            return os.path.normpath(path) + os.sep
+
+        with mt5_conexao():
+            info = mt5.terminal_info()
+
+            if info is None:
+                raise RuntimeError(
+                    "Não foi possível obter informações do terminal MT5."
+                )
+
+        path = os.path.join(info.data_path, "MQL5", "Files")
+        return os.path.normpath(path) + os.sep
+
+
+# instância global
+conf = Config()
+
+# compatibilidade retroativa
+config = conf.config
+
+# ----------------------------
+# CONFIGURAÇÕES
+# ----------------------------
+
+DATA_SOURCE_NAME = conf.get("dados", default="mt5").lower()
+
+SYMBOL = conf.get("symbol", default="WIN$N")
+DIGITS = conf.get("digits", cast=int, default=0)
+TIMEFRAME = conf.get("timeframe", default="M5")
+MAX_BARS = conf.get("max_bars", cast=int, default=20)
+VIEW = conf.get("view", default="hl")
+VOLUME_TYPE = conf.get("volume", default="tick")
+DATE = conf.get("date", default="")
+
+PERCENTUAL_BREAKOUT = conf.get("percentual_breakout", cast=int, default=50)
+PERCENTUAL_DOJI = conf.get("percentual_doji", cast=int, default=10)
+
+_INITIAL_CSV_PATH = conf.get_csv_path()
+
+# ----------------------------
+# LABELS
+# ----------------------------
+
+DOJI = conf.get("lateral", default="doji")
+UP = conf.get("up", default="verde")
+DOWN = conf.get("down", default="vermelho")
+
+ASCENDING = conf.get("ascending", default="asc")
+DESCENDING = conf.get("descending", default="desc")
+INTERNAL = conf.get("internal", default="int")
+EXTERNAL = conf.get("external", default="ext")
+UNKNOW = conf.get("unknow", default="unk")
+
+UPPER_WICK = conf.get("upper_wick", default="upper")
+LOWER_WICK = conf.get("lower_wick", default="lower")
+
+# ----------------------------
+# PROCESSOS
+# ----------------------------
+
+RUN_DIR = os.path.join(
+    os.getenv("APPDATA", os.path.expanduser("~")),
+    "mtcli",
+    "run"
+)
+
+os.makedirs(RUN_DIR, exist_ok=True)
+
+PID_FILE = os.path.join(RUN_DIR, "risco.pid")
+STOP_FILE = os.path.join(RUN_DIR, "risco.stop")
+HEARTBEAT_FILE = os.path.join(RUN_DIR, "risco.heartbeat")

mtcli-4.0.0.dev1/mtcli/controllers/bars_controller.py

@@ -0,0 +1,75 @@
+"""
+Controller do comando `bars`.
+
+Orquestra o fluxo principal:
+- coleta dados via DataSource
+- converte para DTO
+- transforma em BarsModel
+- delega renderização para View
+
+Não contém lógica de apresentação nem acesso direto à CLI.
+"""
+
+from ..logger import setup_logger
+from ..models.rate_model import RateDTO
+from ..models.bars_model import BarsModel
+from ..views.factory_view import ViewFactory
+from ..data.base import DataSourceBase
+
+log = setup_logger(__name__)
+
+
+class BarsController:
+    """
+    Controller responsável pela execução do comando `bars`.
+    """
+
+    def __init__(self, data_source: DataSourceBase):
+        """
+        Args:
+            data_source (DataSourceBase): Fonte de dados (MT5, CSV, etc)
+        """
+        self.data_source = data_source
+
+    def execute(
+        self,
+        symbol: str,
+        period: str,
+        count: int,
+        date: str | None,
+        view: str,
+        numerator: bool,
+        show_date: bool,
+        volume: str | None,
+    ) -> list[str]:
+        """
+        Executa o fluxo completo do comando.
+
+        Returns:
+            list[str]: Linhas prontas para impressão
+        """
+        log.info(
+            "bars | symbol=%s period=%s count=%s view=%s date=%s",
+            symbol,
+            period,
+            count,
+            view,
+            date,
+        )
+
+        raw_rates = self.data_source.get_data(symbol, period, count)
+
+        rates = [RateDTO.from_list(rate) for rate in raw_rates]
+
+        bars = BarsModel(rates, date_filter=date).build()
+
+        view_instance = ViewFactory.create(
+            name=view,
+            bars=bars,
+            period=period,
+            numerator=numerator,
+            show_date=show_date,
+            volume=volume,
+        )
+
+        return view_instance.render()

mtcli-4.0.0.dev1/mtcli/data/base.py

@@ -0,0 +1,20 @@
+"""
+Módulo da classe base para coleta de dados.
+"""
+
+from typing import List
+
+
+class DataSourceBase:
+    """
+    Interface base para fontes de dados.
+
+    Todas as implementações devem retornar:
+
+        List[
+            [timestamp, open, high, low, close, tick_volume, real_volume]
+        ]
+    """
+
+    def get_data(self, symbol: str, period: str, count: int = 100) -> List[list]:
+        raise NotImplementedError("O método get_data deve ser implementado.")

mtcli-4.0.0.dev1/mtcli/data/csv.py

@@ -0,0 +1,63 @@
+"""
+Módulo fonte de dados via CSV.
+"""
+
+import csv
+import os
+
+from mtcli.conf import conf
+from mtcli.logger import setup_logger
+from .base import DataSourceBase
+
+logger = setup_logger(__name__)
+
+
+class CsvDataSource(DataSourceBase):
+    """Fonte de dados via CSV."""
+
+    def __init__(self, base_path: str | None = None):
+        """
+        Args:
+            base_path: caminho opcional para sobrescrever pasta padrão
+        """
+        self.base_path = base_path or conf.get_csv_path()
+
+    def get_data(self, symbol, period, count=100):
+        """
+        Retorna dados CSV em formato padrão mtcli.
+
+        Args:
+            symbol (str)
+            period (str)
+            count (int)
+        """
+        file_path = os.path.join(self.base_path, f"{symbol}{period}.csv")
+
+        logger.info("CSV | lendo arquivo: %s", file_path)
+
+        csv_data = []
+
+        try:
+            with open(file_path, encoding="utf-16", newline="") as f:
+                reader = csv.reader(f, delimiter=",", quotechar="'")
+
+                for row in reader:
+                    if not row:
+                        continue
+                    csv_data.append(row)
+
+        except FileNotFoundError:
+            logger.warning("Arquivo não encontrado: %s", file_path)
+            return []
+
+        except Exception as e:
+            logger.exception("Erro ao ler CSV: %s", file_path)
+            raise e
+
+        # mantém apenas as últimas N barras (igual MT5)
+        if count:
+            csv_data = csv_data[-count:]
+
+        logger.info("CSV | %s registros carregados", len(csv_data))
+
+        return csv_data

mtcli-4.0.0.dev1/mtcli/data/factory.py

@@ -0,0 +1,29 @@
+"""
+Factory de DataSources.
+
+Responsável por instanciar fontes de dados sem acoplamento
+e evitando import circular.
+"""
+
+
+def create_data_source(name: str):
+    """
+    Cria uma fonte de dados a partir do nome.
+
+    Args:
+        name (str): "mt5" ou "csv"
+
+    Returns:
+        DataSourceBase
+    """
+    name = (name or "mt5").lower()
+
+    if name == "mt5":
+        from mtcli.data.mt5 import MT5DataSource
+        return MT5DataSource()
+
+    if name == "csv":
+        from mtcli.data.csv import CsvDataSource
+        return CsvDataSource()
+
+    raise ValueError(f"Fonte de dados desconhecida: {name}")

mtcli-4.0.0.dev1/mtcli/data/mt5.py

@@ -0,0 +1,148 @@
+"""
+Módulo fonte de dados via API do MetaTrader 5.
+"""
+
+from datetime import datetime
+
+import MetaTrader5 as mt5
+
+from mtcli.logger import setup_logger
+from mtcli.mt5_context import mt5_conexao
+from .base import DataSourceBase
+
+log = setup_logger(__name__)
+
+
+# ---------------------------------------------------------
+# Timeframes suportados (constante global)
+# ---------------------------------------------------------
+
+TF_MAP = {
+    "M1": mt5.TIMEFRAME_M1,
+    "M2": mt5.TIMEFRAME_M2,
+    "M3": mt5.TIMEFRAME_M3,
+    "M4": mt5.TIMEFRAME_M4,
+    "M5": mt5.TIMEFRAME_M5,
+    "M6": mt5.TIMEFRAME_M6,
+    "M10": mt5.TIMEFRAME_M10,
+    "M12": mt5.TIMEFRAME_M12,
+    "M15": mt5.TIMEFRAME_M15,
+    "M20": mt5.TIMEFRAME_M20,
+    "M30": mt5.TIMEFRAME_M30,
+    "H1": mt5.TIMEFRAME_H1,
+    "H2": mt5.TIMEFRAME_H2,
+    "H3": mt5.TIMEFRAME_H3,
+    "H4": mt5.TIMEFRAME_H4,
+    "H6": mt5.TIMEFRAME_H6,
+    "H8": mt5.TIMEFRAME_H8,
+    "H12": mt5.TIMEFRAME_H12,
+    "D1": mt5.TIMEFRAME_D1,
+    "W1": mt5.TIMEFRAME_W1,
+    "MN1": mt5.TIMEFRAME_MN1,
+}
+
+
+# ---------------------------------------------------------
+# DataSource
+# ---------------------------------------------------------
+
+class MT5DataSource(DataSourceBase):
+    """Fonte de dados via API do MetaTrader 5."""
+
+    CORRETORAS_B3 = (
+        "clear",
+        "xp",
+        "rico",
+        "modal",
+        "terra",
+        "btg",
+        "toro",
+    )
+
+    def _normalize_symbol(self, symbol: str) -> str:
+        """
+        Normaliza símbolo dependendo da corretora.
+        """
+        info = mt5.account_info()
+
+        if info is None:
+            log.warning("Não foi possível obter account_info do MT5.")
+            return symbol
+
+        company = (info.company or "").lower()
+
+        if any(c in company for c in self.CORRETORAS_B3):
+            return symbol.upper()
+
+        return symbol
+
+    def _convert_time(self, timestamp) -> str:
+        """
+        Converte timestamp do MT5 para string padrão mtcli.
+        """
+        # MT5 geralmente retorna epoch (int)
+        if isinstance(timestamp, (int, float)):
+            dt = datetime.fromtimestamp(timestamp)
+        else:
+            # fallback seguro
+            dt = datetime.fromtimestamp(int(timestamp))
+
+        return dt.strftime("%Y.%m.%d %H:%M:%S")
+
+    def get_data(self, symbol, period, count=100):
+        """
+        Retorna uma lista de listas no formato padrão mtcli.
+        """
+
+        period = period.upper()
+
+        if period not in TF_MAP:
+            log.error("Timeframe inválido: %s", period)
+            raise ValueError(f"Timeframe '{period}' inválido.")
+
+        log.info(
+            "MT5 | coleta iniciada | symbol=%s period=%s count=%s",
+            symbol,
+            period,
+            count,
+        )
+
+        with mt5_conexao():
+            symbol_normalized = self._normalize_symbol(symbol)
+
+            log.info("MT5 | símbolo normalizado: %s", symbol_normalized)
+
+            rates = mt5.copy_rates_from_pos(
+                symbol_normalized,
+                TF_MAP[period],
+                0,
+                count,
+            )
+
+            if rates is None:
+                error = mt5.last_error()
+                log.error("MT5 | erro ao obter dados: %s", error)
+                raise RuntimeError(f"Erro MT5: {error}")
+
+        result = []
+
+        for r in rates:
+            try:
+                result.append(
+                    [
+                        self._convert_time(r["time"]),
+                        float(r["open"]),
+                        float(r["high"]),
+                        float(r["low"]),
+                        float(r["close"]),
+                        int(r["tick_volume"]) if r["tick_volume"] is not None else None,
+                        int(r["real_volume"]) if r["real_volume"] is not None else None,
+                    ]
+                )
+            except Exception:
+                log.exception("Erro ao converter rate: %s", r)
+                continue
+
+        log.info("MT5 | coleta finalizada | %s registros", len(result))
+
+        return result

mtcli-4.0.0.dev1/mtcli/domain/bar.py

@@ -0,0 +1,40 @@
+from dataclasses import dataclass
+from datetime import datetime
+
+
+@dataclass(frozen=True)
+class Bar:
+    """
+    Representa um candle OHLCV independente de fonte de dados.
+
+    - tick_volume: quantidade de ticks (atividade)
+    - real_volume: volume negociado (quando disponível)
+    """
+
+    time: datetime
+    open: float
+    high: float
+    low: float
+    close: float
+    tick_volume: float
+    real_volume: float | None = None
+
+    def is_bull(self) -> bool:
+        return self.close > self.open
+
+    def is_bear(self) -> bool:
+        return self.close < self.open
+
+    def body(self) -> float:
+        return abs(self.close - self.open)
+
+    def range(self) -> float:
+        return self.high - self.low
+
+    def volume(self) -> float:
+        """
+        Volume preferencial:
+        - usa real_volume se disponível
+        - fallback para tick_volume
+        """
+        return self.real_volume or self.tick_volume

mtcli-4.0.0.dev1/mtcli/domain/calculations.py

@@ -0,0 +1,6 @@
+def body_size(bar):
+    return abs(bar.close - bar.open)
+
+
+def is_inside_bar(prev, curr):
+    return curr.high <= prev.high and curr.low >= prev.low

mtcli-4.0.0.dev1/mtcli/domain/config.py

@@ -0,0 +1,4 @@
+@dataclass(frozen=True)
+class TradingConfig:
+    risk_per_trade: float
+    max_positions: int

mtcli-4.0.0.dev1/mtcli/domain/pattern.py

@@ -0,0 +1,10 @@
+from enum import Enum
+
+
+class Pattern(Enum):
+    H1 = "H1"
+    H2 = "H2"
+    L1 = "L1"
+    L2 = "L2"
+    BRF = "BRF"
+    BLF = "BLF"

mtcli-4.0.0.dev1/mtcli/domain/price.py

@@ -0,0 +1,13 @@
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class Price:
+    value: float
+    digits: int
+
+    def normalize(self) -> float:
+        return round(self.value, self.digits)
+
+    def points(self, other: "Price") -> float:
+        return (self.value - other.value) * (10 ** self.digits)

mtcli-4.0.0.dev1/mtcli/domain/result.py

@@ -0,0 +1,8 @@
+from dataclasses import dataclass
+
+
+@dataclass
+class Result:
+    success: bool
+    data: any = None
+    error: str | None = None