mtcli 3.8.0.dev2__tar.gz → 3.8.0.dev4__tar.gz

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/PKG-INFO

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

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/mtcli/cli.py

@@ -21,13 +21,6 @@ _tick_streamer = None
 
 
 def start_tick_capture():
-    """
-    Inicia captura contínua de ticks em background.
-
-    O símbolo deve ser definido via variável:
-
-        MTCLI_SYMBOL=WINJ26
-    """
 
     global _tick_streamer
 
@@ -65,9 +58,6 @@ def start_tick_capture():
 @click.version_option(package_name="mtcli")
 @click.pass_context
 def mt(ctx):
-    """
-    CLI principal do mtcli.
-    """
 
     start_tick_capture()
 
@@ -87,9 +77,6 @@ logger.info("Plugins carregados: %s", loaded_plugins)
 
 @mt.command(name="plugins")
 def list_plugins():
-    """
-    Lista os plugins carregados.
-    """
 
     if not loaded_plugins:
         click.echo("Nenhum plugin carregado.")

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/mtcli/conf.py

@@ -1,309 +1,315 @@
-"""
-Sistema central de configuração do mtcli.
-
-Fornece leitura de configuração a partir de:
-
-1. Variáveis de ambiente
-2. Arquivo mtcli.ini
-3. Valores default
-
-Também oferece utilidades usadas por plugins como:
-
-- descoberta do diretório MQL5/Files
-- seleção da fonte de dados (CSV ou MT5)
-
-Plugins novos devem acessar a configuração através do objeto global `conf`.
-
-Compatibilidade retroativa:
----------------------------
-Plugins antigos utilizavam:
-
-    from mtcli.conf import config
-
-onde `config` era um objeto `configparser.ConfigParser`.
-
-Para manter compatibilidade com plugins já publicados,
-o objeto `config` continua sendo exposto.
-
-Essa API é considerada **deprecated** e poderá ser removida
-em versões futuras do mtcli.
-"""
-
-import os
-import configparser
-
-import MetaTrader5 as mt5
-
-from mtcli.mt5_context import mt5_conexao
-
-
-class Config:
-    """
-    Gerenciador central de configurações do mtcli.
-
-    Permite acessar valores a partir de:
-
-    - variáveis de ambiente
-    - arquivo mtcli.ini
-    - valores default
-
-    Plugins devem preferencialmente usar:
-
-        from mtcli.conf import conf
-        conf.get(...)
-    """
-
-    def __init__(self, filename="mtcli.ini"):
-        self.config = configparser.ConfigParser()
-        self.config.read(filename)
-
-    # ---------------------------------------------------------
-    # leitura de valores
-    # ---------------------------------------------------------
-
-    def get(self, key, section="DEFAULT", cast=None, default=None):
-        """
-        Retorna um valor de configuração.
-
-        Prioridade:
-
-        1. Variável de ambiente SECTION_KEY
-        2. Variável de ambiente KEY
-        3. mtcli.ini [section]
-        4. mtcli.ini [DEFAULT]
-        5. default
-
-        Args:
-            key (str):
-                Nome da configuração.
-
-            section (str):
-                Seção do arquivo mtcli.ini.
-
-            cast (type | None):
-                Tipo para conversão do valor.
-
-            default (Any):
-                Valor padrão.
-
-        Returns:
-            Any
-        """
-
-        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
-
-    # ---------------------------------------------------------
-    # seção helper
-    # ---------------------------------------------------------
-
-    def section(self, section):
-        """
-        Retorna um helper para acessar uma seção específica.
-
-        Example:
-
-            renko = conf.section("renko")
-            brick = renko.get("brick", cast=int, default=10)
-        """
-
-        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)
-
-    # ---------------------------------------------------------
-    # caminho MT5
-    # ---------------------------------------------------------
-
-    def get_csv_path(self):
-        """
-        Retorna o caminho da pasta MQL5/Files do MetaTrader 5.
-
-        A prioridade é:
-
-        1. mtcli.ini -> mt5_pasta
-        2. descoberta automática via MT5
-
-        Returns:
-            str: caminho normalizado da pasta Files.
-        """
-
-        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
-
-    # ---------------------------------------------------------
-    # data source
-    # ---------------------------------------------------------
-
-    def get_data_source(self, source=None):
-        """
-        Retorna a fonte de dados configurada.
-
-        Args:
-            source (str | None):
-                Fonte explícita ("csv" ou "mt5").
-
-        Returns:
-            DataSource
-        """
-
-        from mtcli.data import CsvDataSource, MT5DataSource
-
-        src = (source or self.get("dados", default="mt5")).lower()
-
-        if src == "csv":
-            return CsvDataSource()
-
-        if src == "mt5":
-            return MT5DataSource()
-
-        raise ValueError(f"Fonte de dados desconhecida: {src}")
-
-
-# ---------------------------------------------------------
-# instância global usada por todo o sistema
-# ---------------------------------------------------------
-
-conf = Config()
-
-# ---------------------------------------------------------
-# compatibilidade com plugins antigos
-# ---------------------------------------------------------
-#
-# Plugins antigos utilizam:
-#
-#     from mtcli.conf import config
-#
-# onde `config` era um ConfigParser.
-#
-# Mantemos esse objeto apontando para o ConfigParser interno
-# para evitar quebra de compatibilidade.
-#
-# API DEPRECATED – usar `conf.get()` em novos plugins.
-#
-
-config = conf.config
-
-
-# ---------------------------------------------------------
-# 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]
-)
-
-# ---------------------------------------------------------
-# Configurações gerais
-# ---------------------------------------------------------
-
-SYMBOL = conf.get("symbol", default="WIN$N")
-DIGITOS = conf.get("digitos", cast=int, default=2)
-PERIOD = conf.get("period", default="D1")
-BARS = conf.get("count", cast=int, default=999)
-
-VIEW = conf.get("view", default="ch")
-VOLUME = conf.get("volume", default="tick")
-DATE = conf.get("date", default="")
-
-# ---------------------------------------------------------
-# Configurações de leitura de candles
-# ---------------------------------------------------------
-
-LATERAL = conf.get("lateral", default="doji")
-ALTA = conf.get("alta", default="verde")
-BAIXA = conf.get("baixa", default="vermelho")
-
-ROMPIMENTO_ALTA = conf.get("rompimento_alta", default="c")
-ROMPIMENTO_BAIXA = conf.get("rompimento_baixa", default="v")
-
-PERCENTUAL_ROMPIMENTO = conf.get(
-    "percentual_rompimento",
-    cast=int,
-    default=50,
-)
-
-PERCENTUAL_DOJI = conf.get(
-    "percentual_doji",
-    cast=int,
-    default=10,
-)
-
-# ---------------------------------------------------------
-# Configurações de padrões de barra
-# ---------------------------------------------------------
-
-UP_BAR = conf.get("up_bar", default="asc")
-DOWN_BAR = conf.get("down_bar", default="desc")
-
-INSIDE_BAR = conf.get("inside_bar", default="ib")
-OUTSIDE_BAR = conf.get("outside_bar", default="ob")
-
-SOMBRA_SUPERIOR = conf.get("sombra_superior", default="top")
-SOMBRA_INFERIOR = conf.get("sombra_inferior", default="bottom")
-
-# ---------------------------------------------------------
-# Fonte de dados
-# ---------------------------------------------------------
-
-DATA_SOURCE_NAME = conf.get("dados", default="mt5").lower()
-DATA_SOURCE = conf.get_data_source()
-
-# ---------------------------------------------------------
-# caminho inicial do CSV (pode vir do ini/env)
-# ---------------------------------------------------------
-
-_INITIAL_CSV_PATH = conf.get_csv_path()
+"""
+Sistema central de configuração do mtcli.
+
+Fornece leitura de configuração a partir de:
+
+1. Variáveis de ambiente
+2. Arquivo mtcli.ini
+3. Valores default
+
+Também oferece utilidades usadas por plugins como:
+
+- descoberta do diretório MQL5/Files
+- seleção da fonte de dados (CSV ou MT5)
+
+Plugins novos devem acessar a configuração através do objeto global `conf`.
+
+Compatibilidade retroativa:
+---------------------------
+Plugins antigos utilizavam:
+
+    from mtcli.conf import config
+
+onde `config` era um objeto `configparser.ConfigParser`.
+
+Para manter compatibilidade com plugins já publicados,
+o objeto `config` continua sendo exposto.
+
+Essa API é considerada **deprecated** e poderá ser removida
+em versões futuras do mtcli.
+"""
+
+import os
+import configparser
+
+import MetaTrader5 as mt5
+
+from mtcli.mt5_context import mt5_conexao
+
+
+class Config:
+    """
+    Gerenciador central de configurações do mtcli.
+
+    Permite acessar valores a partir de:
+
+    - variáveis de ambiente
+    - arquivo mtcli.ini
+    - valores default
+
+    Plugins devem preferencialmente usar:
+
+        from mtcli.conf import conf
+        conf.get(...)
+    """
+
+    def __init__(self, filename="mtcli.ini"):
+        self.config = configparser.ConfigParser()
+        self.config.read(filename)
+
+    # ---------------------------------------------------------
+    # leitura de valores
+    # ---------------------------------------------------------
+
+    def get(self, key, section="DEFAULT", cast=None, default=None):
+        """
+        Retorna um valor de configuração.
+
+        Prioridade:
+
+        1. Variável de ambiente SECTION_KEY
+        2. Variável de ambiente KEY
+        3. mtcli.ini [section]
+        4. mtcli.ini [DEFAULT]
+        5. default
+
+        Args:
+            key (str):
+                Nome da configuração.
+
+            section (str):
+                Seção do arquivo mtcli.ini.
+
+            cast (type | None):
+                Tipo para conversão do valor.
+
+            default (Any):
+                Valor padrão.
+
+        Returns:
+            Any
+        """
+
+        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
+
+    # ---------------------------------------------------------
+    # seção helper
+    # ---------------------------------------------------------
+
+    def section(self, section):
+        """
+        Retorna um helper para acessar uma seção específica.
+
+        Example:
+
+            renko = conf.section("renko")
+            brick = renko.get("brick", cast=int, default=10)
+        """
+
+        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)
+
+    # ---------------------------------------------------------
+    # caminho MT5
+    # ---------------------------------------------------------
+
+    def get_csv_path(self):
+        """
+        Retorna o caminho da pasta MQL5/Files do MetaTrader 5.
+
+        A prioridade é:
+
+        1. mtcli.ini -> mt5_pasta
+        2. descoberta automática via MT5
+
+        Returns:
+            str: caminho normalizado da pasta Files.
+        """
+
+        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
+
+    # ---------------------------------------------------------
+    # data source
+    # ---------------------------------------------------------
+
+    def get_data_source(self, source=None):
+        """
+        Retorna a fonte de dados configurada.
+
+        Args:
+            source (str | None):
+                Fonte explícita ("csv" ou "mt5").
+
+        Returns:
+            DataSource
+        """
+
+        from mtcli.data import CsvDataSource, MT5DataSource
+
+        src = (source or self.get("dados", default="mt5")).lower()
+
+        if src == "csv":
+            return CsvDataSource()
+
+        if src == "mt5":
+            return MT5DataSource()
+
+        raise ValueError(f"Fonte de dados desconhecida: {src}")
+
+
+# ---------------------------------------------------------
+# instância global usada por todo o sistema
+# ---------------------------------------------------------
+
+conf = Config()
+
+# ---------------------------------------------------------
+# compatibilidade com plugins antigos
+# ---------------------------------------------------------
+#
+# Plugins antigos utilizam:
+#
+#     from mtcli.conf import config
+#
+# onde `config` era um ConfigParser.
+#
+# Mantemos esse objeto apontando para o ConfigParser interno
+# para evitar quebra de compatibilidade.
+#
+# API DEPRECATED – usar `conf.get()` em novos plugins.
+#
+
+config = conf.config
+
+
+# ---------------------------------------------------------
+# 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]
+)
+
+# ---------------------------------------------------------
+# Configurações gerais
+# ---------------------------------------------------------
+
+SYMBOL = conf.get("symbol", default="WIN$N")
+DIGITOS = conf.get("digitos", cast=int, default=2)
+PERIOD = conf.get("period", default="D1")
+BARS = conf.get("count", cast=int, default=999)
+
+VIEW = conf.get("view", default="ch")
+VOLUME = conf.get("volume", default="tick")
+DATE = conf.get("date", default="")
+
+# ---------------------------------------------------------
+# Configurações de leitura de candles
+# ---------------------------------------------------------
+
+LATERAL = conf.get("lateral", default="doji")
+ALTA = conf.get("alta", default="verde")
+BAIXA = conf.get("baixa", default="vermelho")
+
+ROMPIMENTO_ALTA = conf.get("rompimento_alta", default="c")
+ROMPIMENTO_BAIXA = conf.get("rompimento_baixa", default="v")
+
+PERCENTUAL_ROMPIMENTO = conf.get(
+    "percentual_rompimento",
+    cast=int,
+    default=50,
+)
+
+PERCENTUAL_DOJI = conf.get(
+    "percentual_doji",
+    cast=int,
+    default=10,
+)
+
+# ---------------------------------------------------------
+# Configurações de padrões de barra
+# ---------------------------------------------------------
+
+UP_BAR = conf.get("up_bar", default="asc")
+DOWN_BAR = conf.get("down_bar", default="desc")
+
+INSIDE_BAR = conf.get("inside_bar", default="ib")
+OUTSIDE_BAR = conf.get("outside_bar", default="ob")
+
+SOMBRA_SUPERIOR = conf.get("sombra_superior", default="top")
+SOMBRA_INFERIOR = conf.get("sombra_inferior", default="bottom")
+
+# ---------------------------------------------------------
+# Fonte de dados
+# ---------------------------------------------------------
+
+DATA_SOURCE_NAME = conf.get("dados", default="mt5").lower()
+DATA_SOURCE = conf.get_data_source()
+
+# ---------------------------------------------------------
+# caminho inicial do CSV (pode vir do ini/env)
+# ---------------------------------------------------------
+
+_INITIAL_CSV_PATH = conf.get_csv_path()
+
+# ---------------------------------------------------------
+# nome do banco de dados de marketdata
+# ---------------------------------------------------------
+
+DB_NAME = conf.get("db_name", default="marketdata.db")

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/mtcli/database.py

@@ -13,29 +13,25 @@ Responsável por:
 import sqlite3
 from pathlib import Path
 from datetime import datetime
+from .conf import DB_NAME
 
-DB_PATH = Path.home() / ".mtcli" / "marketdata.db"
+
+DB_PATH = Path.home() / ".mtcli" / DB_NAME
 BACKUP_DIR = Path.home() / ".mtcli" / "backups"
 
+_connection = None
+
 
 def get_connection():
     """
-    Cria ou retorna uma conexão SQLite otimizada para ingestão
-    contínua de ticks de mercado.
-
-    Configurações aplicadas:
+    Retorna conexão singleton SQLite otimizada para ingestão
+    contínua de ticks.
+    """
 
-    - WAL (Write Ahead Logging)
-    - synchronous=NORMAL
-    - temp_store em memória
-    - mmap para leitura rápida
-    - cache expandido
+    global _connection
 
-    Returns
-    -------
-    sqlite3.Connection
-        Conexão ativa com o banco SQLite.
-    """
+    if _connection:
+        return _connection
 
     DB_PATH.parent.mkdir(parents=True, exist_ok=True)
     BACKUP_DIR.mkdir(parents=True, exist_ok=True)
@@ -49,6 +45,9 @@ def get_connection():
     conn.execute("PRAGMA cache_size=-200000")
     conn.execute("PRAGMA journal_size_limit=67108864")
 
+    # checkpoint automático
+    conn.execute("PRAGMA wal_autocheckpoint=1000")
+
     conn.execute("""
     CREATE TABLE IF NOT EXISTS schema_migrations(
         version INTEGER PRIMARY KEY,
@@ -58,22 +57,9 @@ def get_connection():
 
     conn.commit()
 
-    return conn
-
+    _connection = conn
 
-# ==========================================================
-# CHECKPOINT
-# ==========================================================
-
-def wal_checkpoint(conn):
-    """
-    Executa checkpoint do WAL.
-
-    Move os dados do arquivo `.wal` para o banco principal
-    e reduz seu tamanho.
-    """
-
-    conn.execute("PRAGMA wal_checkpoint(TRUNCATE)")
+    return conn
 
 
 # ==========================================================
@@ -83,9 +69,6 @@ def wal_checkpoint(conn):
 def backup_database(conn):
     """
     Realiza backup diário seguro do banco SQLite.
-
-    O backup utiliza a API nativa do SQLite,
-    permitindo cópia consistente mesmo com o banco em uso.
     """
 
     now = datetime.now().strftime("%Y%m%d")

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/mtcli/marketdata/tick_repository.py

@@ -5,13 +5,13 @@ Responsável por:
 
 - Persistir ticks no SQLite
 - Sincronizar histórico inicial
-- Consultas rápidas para engines (Renko etc)
+- Consultas rápidas para engines
 """
 
 import MetaTrader5 as mt5
 from datetime import datetime, timedelta
 
-from ..database import get_connection, wal_checkpoint, backup_database
+from ..database import get_connection, backup_database
 from .tick_cache import TickCache
 from mtcli.mt5_context import mt5_conexao
 
@@ -25,7 +25,6 @@ class TickRepository:
         self.conn = get_connection()
         self.cache = TickCache()
 
-        self.insert_counter = 0
         self.last_backup_day = None
 
     # ==========================================================
@@ -33,9 +32,6 @@ class TickRepository:
     # ==========================================================
 
     def sync(self, symbol: str, days_back: int = 1):
-        """
-        Sincroniza histórico de ticks a partir do broker.
-        """
 
         total_inserted = 0
 
@@ -84,6 +80,8 @@ class TickRepository:
                 self.conn.rollback()
                 raise
 
+        self._daily_backup()
+
         return total_inserted
 
     # ==========================================================
@@ -119,23 +117,7 @@ class TickRepository:
             data,
         )
 
-        inserted = len(data)
-
-        self.insert_counter += inserted
-
-        if self.insert_counter >= 200000:
-
-            wal_checkpoint(self.conn)
-            self.insert_counter = 0
-
-        today = datetime.now().date()
-
-        if self.last_backup_day != today:
-
-            backup_database(self.conn)
-            self.last_backup_day = today
-
-        return inserted
+        return len(data)
 
     # ==========================================================
     # CONSULTAS
@@ -199,3 +181,12 @@ class TickRepository:
         result = cursor.fetchone()
 
         return result[0] if result and result[0] else None
+
+    def _daily_backup(self):
+
+        today = datetime.now().date()
+
+        if self.last_backup_day != today:
+
+            backup_database(self.conn)
+            self.last_backup_day = today

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/mtcli/marketdata/tick_streamer.py

@@ -1,10 +1,5 @@
 """
 Captura contínua de ticks.
-
-Objetivo:
-
-- eliminar dependência do histórico do broker
-- manter histórico próprio
 """
 
 import time
@@ -21,13 +16,9 @@ class TickStreamer:
 
         self.symbol = symbol
         self.repo = TickRepository()
-
         self.running = False
 
     def start(self):
-        """
-        Inicia captura contínua de ticks.
-        """
 
         self.running = True
 
@@ -69,7 +60,3 @@ class TickStreamer:
                     self.repo.conn.rollback()
 
                 start = int(ticks[-1]["time_msc"]) + 1
-
-    def stop(self):
-
-        self.running = False

{mtcli-3.8.0.dev2 → mtcli-3.8.0.dev4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli"
-version = "3.8.0.dev2"
+version = "3.8.0.dev4"
 description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly"
 authors = [
     {name = "Valmir França",email = "vfranca3@gmail.com"}