mtcli 3.7.0.dev9__tar.gz → 3.8.0.dev0__tar.gz

{mtcli-3.7.0.dev9 → mtcli-3.8.0.dev0}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: mtcli
-Version: 3.7.0.dev9
+Version: 3.8.0.dev0
 Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
 License-Expression: MIT
 License-File: LICENSE
 Keywords: trading,candlestick,metatrader5,mt5,cli,price-action
-Author: Valmir França da Silva
+Author: Valmir França
 Author-email: vfranca3@gmail.com
 Requires-Python: >=3.10,<3.14.0
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Financial and Insurance Industry
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10

mtcli-3.8.0.dev0/mtcli/cli.py

@@ -0,0 +1,135 @@
+"""
+CLI principal do mtcli.
+
+Este módulo define o grupo principal `mt`
+e inicializa o carregamento de plugins.
+
+Também inicia a captura contínua de ticks para manter
+um histórico próprio independente do broker.
+"""
+
+import os
+import threading
+import click
+
+from mtcli.plugin_loader import load_plugins
+from mtcli.logger import setup_logger
+from mtcli.marketdata.tick_streamer import TickStreamer
+
+from .commands.bars import bars
+from .commands.doctor import doctor
+from .commands.migrate import migrate
+
+
+logger = setup_logger(__name__)
+
+
+# ---------------------------------------------------------
+# Configuração de captura de ticks
+# ---------------------------------------------------------
+
+_tick_streamer = None
+
+
+def start_tick_capture():
+    """
+    Inicia captura contínua de ticks em background.
+
+    O símbolo pode ser configurado via variável de ambiente:
+
+        MTCLI_SYMBOL=WINJ26
+    """
+
+    global _tick_streamer
+
+    if _tick_streamer:
+        return
+
+    symbol = os.getenv("SYMBOL")
+
+    if not symbol:
+        logger.info("Captura de ticks desativada (MTCLI_SYMBOL não definido).")
+        return
+
+    logger.info("Iniciando captura contínua de ticks para %s", symbol)
+
+    _tick_streamer = TickStreamer(symbol)
+
+    thread = threading.Thread(
+        target=_tick_streamer.start,
+        daemon=True,
+        name="mtcli-tick-streamer",
+    )
+
+    thread.start()
+
+    logger.info("Captura de ticks iniciada em background.")
+
+
+# ---------------------------------------------------------
+# CLI principal
+# ---------------------------------------------------------
+
+@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.
+
+    Exibe gráficos e informações de mercado
+    em formato textual compatível com leitores de tela.
+    """
+
+    # inicia captura de ticks
+    start_tick_capture()
+
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+# ---------------------------------------------------------
+# Comandos internos
+# ---------------------------------------------------------
+
+mt.add_command(doctor, name="doctor")
+mt.add_command(bars, name="bars")
+mt.add_command(doctor, name="dr")
+mt.add_command(migrate)
+
+
+# ---------------------------------------------------------
+# Carregamento de plugins
+# ---------------------------------------------------------
+
+loaded_plugins = load_plugins(mt)
+
+logger.info("Plugins carregados: %s", loaded_plugins)
+
+
+# ---------------------------------------------------------
+# Comando utilitário: listar plugins
+# ---------------------------------------------------------
+
+@mt.command(name="plugins")
+def list_plugins():
+    """
+    Lista os plugins atualmente 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}")
+
+
+# ---------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------
+
+if __name__ == "__main__":
+    mt()

{mtcli-3.7.0.dev9 → mtcli-3.8.0.dev0}/mtcli/commands/conf.py

@@ -1,44 +1,44 @@
-"""
-Comando para exibir configurações disponíveis.
-"""
-
-import click
-
-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(
-            f"{opt.section}.{opt.name} = {value} "
-            f"(default={opt.default})"
-        )
-
-        if opt.description:
-            click.echo(f"  {opt.description}")
-
-        click.echo()
+"""
+Comando para exibir configurações disponíveis.
+"""
+
+import click
+
+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(
+            f"{opt.section}.{opt.name} = {value} "
+            f"(default={opt.default})"
+        )
+
+        if opt.description:
+            click.echo(f"  {opt.description}")
+
+        click.echo()

{mtcli-3.7.0.dev9 → mtcli-3.8.0.dev0}/mtcli/commands/doctor.py

@@ -1,194 +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.")
+"""
+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.")

mtcli-3.8.0.dev0/mtcli/commands/migrate.py

@@ -0,0 +1,12 @@
+import click
+
+from mtcli.database import get_connection
+from mtcli.migrations.runner import run_migrations
+
+
+@click.command()
+def migrate():
+
+    conn = get_connection()
+
+    run_migrations(conn)