mtcli 3.5.0.dev3__tar.gz → 3.6.0.dev0__tar.gz

{mtcli-3.5.0.dev3 → mtcli-3.6.0.dev0}/PKG-INFO

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

mtcli-3.6.0.dev0/mtcli/cli.py

@@ -0,0 +1,32 @@
+"""
+Comando principal do mtcli.
+"""
+
+import click
+from mtcli.plugin_loader import load_plugins
+
+# --- CLI principal ---
+@click.group(context_settings={"max_content_width": 120})
+@click.version_option(package_name="mtcli")
+def mt():
+    """
+    MTCLI - CLI para gráficos candlestick screen reader friendly.
+
+    Comandos disponíveis:
+        - Subcomandos (bars, conf, logs)
+        - Plugins internos e externos
+    """
+    pass
+
+# --- Carrega subcomandos do mt e plugins ---
+# Os comandos do diretório commands são registrados aqui diretamente
+from mtcli.commands import bars
+
+mt.add_command(bars.bars, name="bars")
+
+# --- Carrega plugins internos e externos via plugin_loader ---
+load_plugins(mt)
+
+# --- Entry point para execução direta ---
+if __name__ == "__main__":
+    mt()

mtcli-3.6.0.dev0/mtcli/conf.py

@@ -0,0 +1,199 @@
+"""
+Configurações principais do mtcli.
+
+Este módulo centraliza a leitura de configurações provenientes de:
+
+1. Variáveis de ambiente
+2. Arquivo mtcli.ini
+
+As variáveis de ambiente sempre têm prioridade sobre o arquivo INI.
+
+Também fornece utilidades para obter o caminho de arquivos do
+terminal MetaTrader5 e selecionar a fonte de dados (CSV ou MT5).
+
+O acesso ao terminal MT5 é realizado apenas sob demanda para evitar
+efeitos colaterais durante a importação do módulo (import side effects),
+facilitando testes automatizados e execução em ambientes CI/CD.
+"""
+
+import os
+import configparser
+
+import MetaTrader5 as mt5
+
+from mtcli.mt5_context import mt5_conexao
+
+# ---------------------------------------------------------
+# Carregamento do arquivo de configuração
+# ---------------------------------------------------------
+
+CONFIG_FILE = "mtcli.ini"
+SECTION = "DEFAULT"
+
+config = configparser.ConfigParser()
+config.read(CONFIG_FILE)
+
+
+def get_config_value(key: str, cast=None, fallback=None):
+    """
+    Retorna um valor de configuração.
+
+    A prioridade de leitura é:
+    1. Variável de ambiente
+    2. Arquivo mtcli.ini
+    3. Valor fallback
+
+    Args:
+        key (str): Nome da chave de configuração.
+        cast (type | None): Tipo de conversão (ex: int, float).
+        fallback (Any): Valor padrão caso não encontrado.
+
+    Returns:
+        Any: valor convertido ou fallback.
+    """
+    value = os.getenv(key)
+
+    if value is None:
+        try:
+            if cast == int:
+                value = config.getint(SECTION, key, fallback=fallback)
+            elif cast == float:
+                value = config.getfloat(SECTION, key, fallback=fallback)
+            else:
+                value = config.get(SECTION, key, fallback=fallback)
+        except (configparser.NoOptionError, ValueError):
+            value = fallback
+    else:
+        if cast:
+            try:
+                value = cast(value)
+            except ValueError:
+                value = fallback
+
+    return value
+
+
+# ---------------------------------------------------------
+# Configurações gerais
+# ---------------------------------------------------------
+
+SYMBOL = get_config_value("symbol", fallback="WIN$N")
+DIGITOS = get_config_value("digitos", cast=int, fallback=2)
+PERIOD = get_config_value("period", fallback="D1")
+BARS = get_config_value("count", cast=int, fallback=999)
+
+VIEW = get_config_value("view", fallback="ch")
+VOLUME = get_config_value("volume", fallback="tick")
+DATE = get_config_value("date", fallback="")
+
+# ---------------------------------------------------------
+# Configurações de leitura de candles
+# ---------------------------------------------------------
+
+LATERAL = get_config_value("lateral", fallback="doji")
+ALTA = get_config_value("alta", fallback="verde")
+BAIXA = get_config_value("baixa", fallback="vermelho")
+
+ROMPIMENTO_ALTA = get_config_value("rompimento_alta", fallback="c")
+ROMPIMENTO_BAIXA = get_config_value("rompimento_baixa", fallback="v")
+
+PERCENTUAL_ROMPIMENTO = get_config_value(
+    "percentual_rompimento", cast=int, fallback=50
+)
+
+PERCENTUAL_DOJI = get_config_value(
+    "percentual_doji", cast=int, fallback=10
+)
+
+# ---------------------------------------------------------
+# Configurações de padrões de barra
+# ---------------------------------------------------------
+
+UP_BAR = get_config_value("up_bar", fallback="asc")
+DOWN_BAR = get_config_value("down_bar", fallback="desc")
+
+INSIDE_BAR = get_config_value("inside_bar", fallback="ib")
+OUTSIDE_BAR = get_config_value("outside_bar", fallback="ob")
+
+SOMBRA_SUPERIOR = get_config_value("sombra_superior", fallback="top")
+SOMBRA_INFERIOR = get_config_value("sombra_inferior", fallback="bottom")
+
+# ---------------------------------------------------------
+# Fonte de dados
+# ---------------------------------------------------------
+
+DATA_SOURCE = get_config_value("dados", fallback="mt5").lower()
+
+# caminho inicial (pode vir do ini/env)
+_INITIAL_CSV_PATH = get_config_value("mt5_pasta", fallback="")
+
+
+def get_csv_path():
+    """
+    Retorna o caminho da pasta de arquivos do MT5 ou CSV.
+
+    Se o caminho não estiver definido no mtcli.ini ou nas
+    variáveis de ambiente, o terminal MT5 é consultado para
+    descobrir automaticamente a pasta MQL5/Files.
+
+    Returns:
+        str: caminho normalizado da pasta de arquivos.
+    """
+    if _INITIAL_CSV_PATH:
+        path = _INITIAL_CSV_PATH
+    else:
+        with mt5_conexao():
+            terminal_info = mt5.terminal_info()
+
+            if terminal_info is None:
+                raise RuntimeError(
+                    "Não foi possível obter as informações do terminal MT5."
+                )
+
+        path = os.path.join(terminal_info.data_path, "MQL5", "Files")
+
+    return os.path.normpath(path) + os.sep
+
+
+# ---------------------------------------------------------
+# Factory de DataSource
+# ---------------------------------------------------------
+
+def get_data_source(source=None):
+    """
+    Retorna a fonte de dados configurada.
+
+    Args:
+        source (str | None): sobrescreve DATA_SOURCE se fornecido.
+
+    Returns:
+        CsvDataSource | MT5DataSource
+
+    Raises:
+        ValueError: se a fonte de dados não for reconhecida.
+    """
+    from mtcli.data import CsvDataSource, MT5DataSource
+
+    src = source.lower() if source else DATA_SOURCE
+
+    if src == "csv":
+        return CsvDataSource()
+
+    if src == "mt5":
+        return MT5DataSource()
+
+    raise ValueError(f"Fonte de dados desconhecida: {src}")
+
+
+# ---------------------------------------------------------
+# Timeframes suportados
+# ---------------------------------------------------------
+
+_HOURS = [12, 8, 6, 4, 3, 2, 1]
+_MINUTES = [30, 20, 15, 12, 10, 6, 5, 4, 3, 2, 1]
+
+TIMEFRAMES = (
+    ["mn1", "w1", "d1"]
+    + [f"h{i}" for i in _HOURS]
+    + [f"m{i}" for i in _MINUTES]
+)

{mtcli-3.5.0.dev3 → mtcli-3.6.0.dev0}/mtcli/data/csv.py

@@ -16,7 +16,7 @@ class CsvDataSource(DataSourceBase):
 
     def get_data(self, symbol, period, count=100):
         """Retorna dados CSV em uma lista de lista."""
-        file_path = os.path.join(conf.csv_path, f"{symbol}{period}.csv")
+        file_path = os.path.join(conf._INITIAL_CSV_PATH, f"{symbol}{period}.csv")
         logger.info(f"Iniciando coleta de dados via CSV: {file_path}.")
         csv_data = []
         try:

{mtcli-3.5.0.dev3 → mtcli-3.6.0.dev0}/mtcli/database.py

@@ -1,54 +1,54 @@
-"""
-Database core para mtcli.
-
-Responsável por:
-- Criar conexão SQLite
-- Ativar WAL
-- Garantir schema
-"""
-
-import sqlite3
-from pathlib import Path
-
-
-DB_PATH = Path.home() / ".mtcli" / "marketdata.db"
-
-
-def get_connection():
-    """
-    Retorna conexão SQLite configurada.
-    """
-    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
-
-    conn = sqlite3.connect(DB_PATH)
-    conn.execute("PRAGMA journal_mode=WAL;")
-    conn.execute("PRAGMA synchronous=NORMAL;")
-
-    _ensure_schema(conn)
-    return conn
-
-
-def _ensure_schema(conn):
-    conn.execute(
-        """
-        CREATE TABLE IF NOT EXISTS ticks (
-            symbol TEXT NOT NULL,
-            time INTEGER NOT NULL,
-            bid REAL,
-            ask REAL,
-            last REAL,
-            volume REAL,
-            flags INTEGER,
-            PRIMARY KEY (symbol, time)
-        );
-        """
-    )
-
-    conn.execute(
-        """
-        CREATE INDEX IF NOT EXISTS idx_ticks_symbol_time
-        ON ticks(symbol, time);
-        """
-    )
-
-    conn.commit()
+"""
+Database core para mtcli.
+
+Responsável por:
+- Criar conexão SQLite
+- Ativar WAL
+- Garantir schema
+"""
+
+import sqlite3
+from pathlib import Path
+
+
+DB_PATH = Path.home() / ".mtcli" / "marketdata.db"
+
+
+def get_connection():
+    """
+    Retorna conexão SQLite configurada.
+    """
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+
+    conn = sqlite3.connect(DB_PATH)
+    conn.execute("PRAGMA journal_mode=WAL;")
+    conn.execute("PRAGMA synchronous=NORMAL;")
+
+    _ensure_schema(conn)
+    return conn
+
+
+def _ensure_schema(conn):
+    conn.execute(
+        """
+        CREATE TABLE IF NOT EXISTS ticks (
+            symbol TEXT NOT NULL,
+            time INTEGER NOT NULL,
+            bid REAL,
+            ask REAL,
+            last REAL,
+            volume REAL,
+            flags INTEGER,
+            PRIMARY KEY (symbol, time)
+        );
+        """
+    )
+
+    conn.execute(
+        """
+        CREATE INDEX IF NOT EXISTS idx_ticks_symbol_time
+        ON ticks(symbol, time);
+        """
+    )
+
+    conn.commit()

{mtcli-3.5.0.dev3 → mtcli-3.6.0.dev0}/mtcli/marketdata/tick_cache.py

@@ -1,24 +1,24 @@
-"""
-Cache de ticks em memória.
-"""
-
-from collections import deque
-
-
-class TickCache:
-    """
-    Mantém janela recente de ticks em memória.
-    """
-
-    def __init__(self, max_size=10000):
-        self.buffer = deque(maxlen=max_size)
-
-    def add_many(self, ticks):
-        for t in ticks:
-            self.buffer.append(t)
-
-    def get_all(self):
-        return list(self.buffer)
-
-    def clear(self):
-        self.buffer.clear()
+"""
+Cache de ticks em memória.
+"""
+
+from collections import deque
+
+
+class TickCache:
+    """
+    Mantém janela recente de ticks em memória.
+    """
+
+    def __init__(self, max_size=10000):
+        self.buffer = deque(maxlen=max_size)
+
+    def add_many(self, ticks):
+        for t in ticks:
+            self.buffer.append(t)
+
+    def get_all(self):
+        return list(self.buffer)
+
+    def clear(self):
+        self.buffer.clear()

{mtcli-3.5.0.dev3 → mtcli-3.6.0.dev0}/mtcli/marketdata/tick_repository.py

@@ -1,142 +1,142 @@
-"""
-TickRepository profissional com:
-
-- Paginação automática
-- Sincronização incremental robusta
-- Integração com mt5_conexao
-- Proteção contra loops infinitos
-"""
-
-import MetaTrader5 as mt5
-from datetime import datetime, timedelta
-
-from ..database import get_connection
-from .tick_cache import TickCache
-from mtcli.mt5_context import mt5_conexao
-
-
-class TickRepository:
-
-    BATCH_SIZE = 200000  # tamanho seguro por lote
-
-    def __init__(self):
-        self.conn = get_connection()
-        self.cache = TickCache()
-
-    # ============================================================
-    # SINCRONIZAÇÃO COM PAGINAÇÃO
-    # ============================================================
-
-    def sync(self, symbol: str, days_back: int = 1):
-        """
-        Sincroniza banco com MT5 usando paginação.
-
-        Busca todos os ticks disponíveis desde o último timestamp.
-        """
-
-        total_inserted = 0
-
-        with mt5_conexao():
-
-            last_time = self._get_last_tick_time(symbol)
-
-            if last_time:
-                start = datetime.fromtimestamp(last_time + 1)
-            else:
-                start = datetime.now() - timedelta(days=days_back)
-
-            while True:
-
-                ticks = mt5.copy_ticks_from(
-                    symbol,
-                    start,
-                    self.BATCH_SIZE,
-                    mt5.COPY_TICKS_ALL,
-                )
-
-                if ticks is None or len(ticks) == 0:
-                    break
-
-                inserted = self._insert_ticks(symbol, ticks)
-                total_inserted += inserted
-
-                self.cache.add_many(ticks)
-
-                # Atualiza início para próximo tick
-                ultimo_timestamp = int(ticks[-1]["time"])
-                novo_start = datetime.fromtimestamp(ultimo_timestamp + 1)
-
-                # Proteção contra loop infinito
-                if novo_start <= start:
-                    break
-
-                start = novo_start
-
-                # Se retornou menos que o batch, acabou histórico
-                if len(ticks) < self.BATCH_SIZE:
-                    break
-
-        return total_inserted
-
-    # ============================================================
-    # INSERÇÃO
-    # ============================================================
-
-    def _insert_ticks(self, symbol, ticks):
-
-        cursor = self.conn.cursor()
-
-        data = [
-            (
-                symbol,
-                int(t["time"]),
-                float(t["bid"]),
-                float(t["ask"]),
-                float(t["last"]),
-                float(t["volume"]),
-                int(t["flags"]),
-            )
-            for t in ticks
-        ]
-
-        cursor.executemany(
-            """
-            INSERT OR IGNORE INTO ticks
-            VALUES (?, ?, ?, ?, ?, ?, ?)
-            """,
-            data,
-        )
-
-        self.conn.commit()
-        return cursor.rowcount
-
-    # ============================================================
-    # CONSULTAS
-    # ============================================================
-
-    def get_ticks_between(self, symbol, start_ts, end_ts):
-        cursor = self.conn.cursor()
-        cursor.execute(
-            """
-            SELECT time, bid, ask, last, volume, flags
-            FROM ticks
-            WHERE symbol = ?
-            AND time BETWEEN ? AND ?
-            ORDER BY time ASC
-            """,
-            (symbol, start_ts, end_ts),
-        )
-        return cursor.fetchall()
-
-    def _get_last_tick_time(self, symbol):
-        cursor = self.conn.cursor()
-        cursor.execute(
-            """
-            SELECT MAX(time)
-            FROM ticks
-            WHERE symbol = ?
-            """,
-            (symbol,),
-        )
-        result = cursor.fetchone()
-        return result[0] if result and result[0] else None
+"""
+TickRepository profissional com:
+
+- Paginação automática
+- Sincronização incremental robusta
+- Integração com mt5_conexao
+- Proteção contra loops infinitos
+"""
+
+import MetaTrader5 as mt5
+from datetime import datetime, timedelta
+
+from ..database import get_connection
+from .tick_cache import TickCache
+from mtcli.mt5_context import mt5_conexao
+
+
+class TickRepository:
+
+    BATCH_SIZE = 200000  # tamanho seguro por lote
+
+    def __init__(self):
+        self.conn = get_connection()
+        self.cache = TickCache()
+
+    # ============================================================
+    # SINCRONIZAÇÃO COM PAGINAÇÃO
+    # ============================================================
+
+    def sync(self, symbol: str, days_back: int = 1):
+        """
+        Sincroniza banco com MT5 usando paginação.
+
+        Busca todos os ticks disponíveis desde o último timestamp.
+        """
+
+        total_inserted = 0
+
+        with mt5_conexao():
+
+            last_time = self._get_last_tick_time(symbol)
+
+            if last_time:
+                start = datetime.fromtimestamp(last_time + 1)
+            else:
+                start = datetime.now() - timedelta(days=days_back)
+
+            while True:
+
+                ticks = mt5.copy_ticks_from(
+                    symbol,
+                    start,
+                    self.BATCH_SIZE,
+                    mt5.COPY_TICKS_ALL,
+                )
+
+                if ticks is None or len(ticks) == 0:
+                    break
+
+                inserted = self._insert_ticks(symbol, ticks)
+                total_inserted += inserted
+
+                self.cache.add_many(ticks)
+
+                # Atualiza início para próximo tick
+                ultimo_timestamp = int(ticks[-1]["time"])
+                novo_start = datetime.fromtimestamp(ultimo_timestamp + 1)
+
+                # Proteção contra loop infinito
+                if novo_start <= start:
+                    break
+
+                start = novo_start
+
+                # Se retornou menos que o batch, acabou histórico
+                if len(ticks) < self.BATCH_SIZE:
+                    break
+
+        return total_inserted
+
+    # ============================================================
+    # INSERÇÃO
+    # ============================================================
+
+    def _insert_ticks(self, symbol, ticks):
+
+        cursor = self.conn.cursor()
+
+        data = [
+            (
+                symbol,
+                int(t["time"]),
+                float(t["bid"]),
+                float(t["ask"]),
+                float(t["last"]),
+                float(t["volume"]),
+                int(t["flags"]),
+            )
+            for t in ticks
+        ]
+
+        cursor.executemany(
+            """
+            INSERT OR IGNORE INTO ticks
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+            """,
+            data,
+        )
+
+        self.conn.commit()
+        return cursor.rowcount
+
+    # ============================================================
+    # CONSULTAS
+    # ============================================================
+
+    def get_ticks_between(self, symbol, start_ts, end_ts):
+        cursor = self.conn.cursor()
+        cursor.execute(
+            """
+            SELECT time, bid, ask, last, volume, flags
+            FROM ticks
+            WHERE symbol = ?
+            AND time BETWEEN ? AND ?
+            ORDER BY time ASC
+            """,
+            (symbol, start_ts, end_ts),
+        )
+        return cursor.fetchall()
+
+    def _get_last_tick_time(self, symbol):
+        cursor = self.conn.cursor()
+        cursor.execute(
+            """
+            SELECT MAX(time)
+            FROM ticks
+            WHERE symbol = ?
+            """,
+            (symbol,),
+        )
+        result = cursor.fetchone()
+        return result[0] if result and result[0] else None