mtcli 3.6.0.dev0__tar.gz → 3.6.0.dev1__tar.gz

{mtcli-3.6.0.dev0 → mtcli-3.6.0.dev1}/PKG-INFO

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

mtcli-3.6.0.dev1/mtcli/cli.py

@@ -0,0 +1,34 @@
+"""
+CLI principal do mtcli.
+
+Este módulo define o grupo principal `mt`
+e inicializa o carregamento de plugins.
+"""
+
+import click
+
+from mtcli.plugin_loader import load_plugins
+from .commands.bars import bars
+
+
+@click.group(context_settings={"max_content_width": 120})
+@click.version_option(package_name="mtcli")
+def mt():
+    """
+    CLI principal do mtcli.
+
+    Exibe gráficos e informações de mercado
+    em formato textual compatível com leitores de tela.
+    """
+    pass
+
+
+mt.add_command(bars, name="bars")
+
+
+# Carrega plugins automaticamente
+load_plugins(mt)
+
+
+if __name__ == "__main__":
+    mt()

mtcli-3.6.0.dev1/mtcli/plugin_loader.py

@@ -0,0 +1,97 @@
+"""
+Sistema de carregamento de plugins do mtcli.
+
+Este módulo carrega automaticamente:
+
+1. Plugins internos localizados em `mtcli.plugins`
+2. Plugins externos registrados via entry points `mtcli.plugins`
+
+Plugins devem expor uma função:
+
+    register(cli)
+
+onde `cli` é o grupo principal do Click.
+"""
+
+import importlib
+import pkgutil
+
+import click
+
+try:
+    from importlib.metadata import entry_points
+except ImportError:  # Python < 3.10
+    from importlib_metadata import entry_points
+
+import mtcli.plugins
+
+
+def load_internal_plugins(cli: click.Group) -> None:
+    """
+    Carrega plugins internos do pacote `mtcli.plugins`.
+
+    Cada módulo encontrado deve expor a função:
+
+        register(cli)
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    for module_info in pkgutil.iter_modules(mtcli.plugins.__path__):
+
+        module_name = f"mtcli.plugins.{module_info.name}"
+
+        module = importlib.import_module(module_name)
+
+        if hasattr(module, "register"):
+            module.register(cli)
+
+
+def load_external_plugins(cli: click.Group) -> None:
+    """
+    Carrega plugins externos instalados via entry points.
+
+    Os plugins devem declarar no pyproject.toml:
+
+        [project.entry-points."mtcli.plugins"]
+        nome = "pacote.plugin:register"
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    eps = entry_points()
+
+    plugins = (
+        eps.select(group="mtcli.plugins")
+        if hasattr(eps, "select")
+        else eps.get("mtcli.plugins", [])
+    )
+
+    for ep in plugins:
+
+        plugin = ep.load()
+
+        if callable(plugin) and not isinstance(plugin, click.Command):
+            plugin(cli)
+
+        elif isinstance(plugin, click.Command):
+            cli.add_command(plugin)
+
+        else:
+            raise TypeError(
+                f"Plugin {ep.name} inválido: deve ser um comando Click ou função register."
+            )
+
+
+def load_plugins(cli: click.Group) -> None:
+    """
+    Carrega todos os plugins (internos e externos).
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    load_internal_plugins(cli)
+    load_external_plugins(cli)

mtcli-3.6.0.dev1/mtcli/plugins/exemplo.py-dist

@@ -0,0 +1,30 @@
+"""
+Plugin interno de exemplo.
+
+Este módulo demonstra como criar um plugin interno
+para o mtcli utilizando a função `register`.
+"""
+
+import click
+
+
+@click.command()
+def exemplo():
+    """
+    Comando simples de demonstração.
+    """
+
+    click.echo("")
+    click.echo("Plugin interno funcionando.")
+    click.echo("Este é apenas um exemplo.")
+
+
+def _register(cli):
+    """
+    Registra o comando no CLI principal.
+
+    Args:
+        cli: grupo principal do Click.
+    """
+
+    cli.add_command(exemplo)

{mtcli-3.6.0.dev0 → mtcli-3.6.0.dev1}/mtcli/plugins/media_movel/__init__.py

@@ -1,5 +1,5 @@
-from .cli import mm
-
-
-def register(cli):
-    cli.add_command(mm, name="mm")
+from .cli import mm
+
+
+def register(cli):
+    cli.add_command(mm, name="mm")

{mtcli-3.6.0.dev0 → mtcli-3.6.0.dev1}/mtcli/plugins/media_movel/cli.py

@@ -1,98 +1,98 @@
-"""Comando da médiamóvel."""
-
-from datetime import datetime
-
-import click
-
-from mtcli.logger import setup_logger
-from mtcli.models.rates_model import RatesModel
-
-from . import conf
-from .models.model_media_movel import MediaMovelModel
-
-logger = setup_logger()
-
-
-@click.command(
-    "mm", help="Calcula a média móvel (SMA ou EMA) para o ativo e período especificado."
-)
-@click.argument("symbol")
-@click.option(
-    "--period",
-    "-p",
-    default="D1",
-    help="Tempo gráfico, default D1.",
-)
-@click.option(
-    "--periodos",
-    "-pe",
-    default=conf.periodos,
-    help="Quantidade de períodos da média, default 14.",
-)
-@click.option(
-    "--tipo",
-    default="sma",
-    type=click.Choice(["sma", "ema"]),
-    help="Tipo de média sma ou ema; default sma.",
-)
-@click.option(
-    "--limit",
-    type=int,
-    default=conf.limite_linhas,
-    help="Limita a quantidade de linhas exibidas; default: 5.",
-)
-@click.option(
-    "--inicio",
-    type=str,
-    help="Data/hora inicial no formato YYYY-MM-DD ou YYYY-MM-DD HH:MM.",
-)
-@click.option(
-    "--fim", type=str, help="Data/hora final no formato YYYY-MM-DD ou YYYY-MM-DD HH:MM."
-)
-def mm(symbol, period, periodos, tipo, limit, inicio, fim):
-    """
-    Calcula a média móvel (SMA ou EMA) do ativo SYMBOL.
-    """
-    logger.info(
-        f"Iniciando cálculo da média móvel: ativo {symbol} período {period} períodos {periodos} tipo {tipo} limite {limit}"
-    )
-
-    rates = RatesModel(symbol, period).get_data()
-    closes = [r[4] for r in rates]
-    datas = [r[0] for r in rates]
-
-    if len(closes) < periodos:
-        logger.warning("Dados insuficientes para calcular a média.")
-        click.echo("Dados insuficientes para calcular a média.")
-        return
-
-    model_mm = MediaMovelModel(closes, periodos)
-    if tipo == "sma":
-        media = model_mm.calcula_sma()
-    else:
-        media = model_mm.calcula_ema()
-
-    datas = datas[periodos - 1 :]
-
-    # Filtro por data/hora
-    dt_inicio = datetime.fromisoformat(inicio) if inicio else None
-    dt_fim = datetime.fromisoformat(fim) if fim else None
-
-    # formato compatível com '2023.08.31 00:00:00'
-    formato = "%Y.%m.%d %H:%M:%S"
-
-    filtrado = []
-    for d, m in zip(datas, media):
-        dt = datetime.strptime(d, formato)
-        if (not dt_inicio or dt >= dt_inicio) and (not dt_fim or dt <= dt_fim):
-            filtrado.append((d, m))
-
-    if not filtrado:
-        click.echo("Nenhum dado no intervalo especificado.")
-        return
-
-    if limit > 0:
-        filtrado = filtrado[-limit:]
-
-    for dt, valor in filtrado:
-        click.echo(f"{round(valor, conf.DIGITOS)}    {dt}")
+"""Comando da médiamóvel."""
+
+from datetime import datetime
+
+import click
+
+from mtcli.logger import setup_logger
+from mtcli.models.rates_model import RatesModel
+
+from . import conf
+from .models.model_media_movel import MediaMovelModel
+
+logger = setup_logger()
+
+
+@click.command(
+    "mm", help="Calcula a média móvel (SMA ou EMA) para o ativo e período especificado."
+)
+@click.argument("symbol")
+@click.option(
+    "--period",
+    "-p",
+    default="D1",
+    help="Tempo gráfico, default D1.",
+)
+@click.option(
+    "--periodos",
+    "-pe",
+    default=conf.periodos,
+    help="Quantidade de períodos da média, default 14.",
+)
+@click.option(
+    "--tipo",
+    default="sma",
+    type=click.Choice(["sma", "ema"]),
+    help="Tipo de média sma ou ema; default sma.",
+)
+@click.option(
+    "--limit",
+    type=int,
+    default=conf.limite_linhas,
+    help="Limita a quantidade de linhas exibidas; default: 5.",
+)
+@click.option(
+    "--inicio",
+    type=str,
+    help="Data/hora inicial no formato YYYY-MM-DD ou YYYY-MM-DD HH:MM.",
+)
+@click.option(
+    "--fim", type=str, help="Data/hora final no formato YYYY-MM-DD ou YYYY-MM-DD HH:MM."
+)
+def mm(symbol, period, periodos, tipo, limit, inicio, fim):
+    """
+    Calcula a média móvel (SMA ou EMA) do ativo SYMBOL.
+    """
+    logger.info(
+        f"Iniciando cálculo da média móvel: ativo {symbol} período {period} períodos {periodos} tipo {tipo} limite {limit}"
+    )
+
+    rates = RatesModel(symbol, period).get_data()
+    closes = [r[4] for r in rates]
+    datas = [r[0] for r in rates]
+
+    if len(closes) < periodos:
+        logger.warning("Dados insuficientes para calcular a média.")
+        click.echo("Dados insuficientes para calcular a média.")
+        return
+
+    model_mm = MediaMovelModel(closes, periodos)
+    if tipo == "sma":
+        media = model_mm.calcula_sma()
+    else:
+        media = model_mm.calcula_ema()
+
+    datas = datas[periodos - 1 :]
+
+    # Filtro por data/hora
+    dt_inicio = datetime.fromisoformat(inicio) if inicio else None
+    dt_fim = datetime.fromisoformat(fim) if fim else None
+
+    # formato compatível com '2023.08.31 00:00:00'
+    formato = "%Y.%m.%d %H:%M:%S"
+
+    filtrado = []
+    for d, m in zip(datas, media):
+        dt = datetime.strptime(d, formato)
+        if (not dt_inicio or dt >= dt_inicio) and (not dt_fim or dt <= dt_fim):
+            filtrado.append((d, m))
+
+    if not filtrado:
+        click.echo("Nenhum dado no intervalo especificado.")
+        return
+
+    if limit > 0:
+        filtrado = filtrado[-limit:]
+
+    for dt, valor in filtrado:
+        click.echo(f"{round(valor, conf.DIGITOS)}    {dt}")

{mtcli-3.6.0.dev0 → mtcli-3.6.0.dev1}/pyproject.toml

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

mtcli-3.6.0.dev0/mtcli/cli.py

@@ -1,32 +0,0 @@
-"""
-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/plugin_loader.py

@@ -1,57 +0,0 @@
-"""
-Módulo responsável pelo carregamento de plugins do mtcli.
-
-Carrega plugins internos (via mtcli.plugin.register) e plugins externos
-registrados via entry points (`mtcli.plugins`).
-"""
-
-import click
-
-try:
-    from importlib.metadata import entry_points
-except ImportError:
-    from importlib_metadata import entry_points  # Para Python < 3.8
-
-from mtcli import plugin as internal_plugin
-
-
-def load_plugins(cli: click.Group):
-    """
-    Carrega todos os plugins (internos e externos) e registra-os no CLI.
-
-    Args:
-        cli (click.Group): grupo Click principal (ex.: `mt`).
-
-    Comportamento:
-        - Plugins internos são registrados via `mtcli.plugin.register(cli)`.
-        - Plugins externos são carregados via entry points `mtcli.plugins`.
-          - Se o entry point for uma função, chama `plugin(cli)`.
-          - Se for um `click.Command`, adiciona diretamente com `cli.add_command()`.
-          - Caso contrário, lança TypeError.
-    """
-    # --- Carrega plugins internos ---
-    internal_plugin.register(cli)
-
-    # --- Carrega plugins externos via entry points ---
-    eps = entry_points()
-    plugins = (
-        eps.select(group="mtcli.plugins")
-        if hasattr(eps, "select")
-        else eps.get("mtcli.plugins", [])
-    )
-
-    for ep in plugins:
-        try:
-            plugin_obj = ep.load()
-        except Exception as e:
-            raise RuntimeError(f"Falha ao carregar plugin {ep.name}: {e}") from e
-
-        if callable(plugin_obj) and not isinstance(plugin_obj, click.Command):
-            # função register(cli)
-            plugin_obj(cli)
-        elif isinstance(plugin_obj, click.Command):
-            cli.add_command(plugin_obj)
-        else:
-            raise TypeError(
-                f"Plugin {ep.name} inválido: não é um comando nem função register."
-            )

mtcli-3.6.0.dev0/mtcli/plugins/hello.py

@@ -1,20 +0,0 @@
-"""
-Plugin interno de exemplo para mtcli.
-
-Este plugin demonstra como criar um comando interno simples.
-"""
-
-import click
-
-def register(cli):
-    """
-    Registra o comando `hello` no CLI principal.
-
-    Args:
-        cli (click.Group): grupo principal do Click (`mt`)
-    """
-    @cli.command()
-    @click.option("--name", "-n", default="Mundo", help="Nome para saudação")
-    def hello(name):
-        """Exibe uma saudação simples."""
-        click.echo(f"Olá, {name}! Este é um plugin interno de exemplo.")