mtcli-renko 1.0.0.dev0__tar.gz → 1.0.0.dev2__tar.gz

{mtcli_renko-1.0.0.dev0 → mtcli_renko-1.0.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mtcli-renko
-Version: 1.0.0.dev0
+Version: 1.0.0.dev2
 Summary: Plugin do mtcli
 License-Expression: GPL-3.0
 License-File: LICENSE

mtcli_renko-1.0.0.dev2/mtcli_renko/commands/renko.py

@@ -0,0 +1,82 @@
+"""
+Comando CLI para geração de gráfico Renko.
+"""
+
+import click
+
+from ..controllers.renko_controller import RenkoController
+from ..views.renko_view import exibir_renko
+from ..domain.timeframe import Timeframe
+from mtcli.logger import setup_logger
+from ..conf import (
+    SYMBOL,
+    BRICK,
+    PERIOD,
+    BARS
+)
+
+log = setup_logger(__name__)
+
+
+@click.command()
+@click.version_option(package_name="mtcli-renko")
+@click.option(
+    "--symbol",
+    "-s",
+    default=SYMBOL,
+    show_default=True,
+    help="Ativo (ex: WINJ26)",
+)
+@click.option(
+    "--brick",
+    "-b",
+    default=BRICK,
+    show_default=True,
+    type=float,
+    help="Tamanho do brick em pontos",
+)
+@click.option(
+    "--timeframe",
+    "-t",
+    default=PERIOD,
+    show_default=True,
+    help=f"Timeframe ({', '.join(Timeframe.valid_labels())})",
+)
+@click.option(
+    "--bars",
+    "-n",
+    default=BARS,
+    show_default=True,
+    help="Quantidade de candles para cálculo",
+)
+@click.option(
+    "--numerar/--no-numerar",
+    default=False,
+    show_default=True,
+    help="Exibir numeração das linhas",
+)
+def renko(symbol, brick, timeframe, bars, numerar):
+    """
+    Gera gráfico Renko em modo texto (screen reader friendly).
+    """
+
+    try:
+        tf_enum = Timeframe.from_string(timeframe)
+    except ValueError as e:
+        raise click.BadParameter(str(e))
+
+    log.info(
+        f"[Renko CLI] symbol={symbol} | brick={brick} | "
+        f"timeframe={tf_enum.label} | bars={bars} | "
+        f"numerar={numerar}"
+    )
+
+    controller = RenkoController(
+        symbol,
+        brick,
+        tf_enum.mt5_const,
+        bars,
+    )
+
+    bricks = controller.executar()
+    exibir_renko(bricks, numerar=numerar)

{mtcli_renko-1.0.0.dev0 → mtcli_renko-1.0.0.dev2}/mtcli_renko/conf.py

@@ -53,10 +53,20 @@ SYMBOL = os.getenv(
 
 BRICK = float(os.getenv(
     "BRICK",
-    _get_config_value("RENKO", "brick", 5)
+    _get_config_value("RENKO", "brick", 50)
 ))
 
-INTERVAL = float(os.getenv(
-    "INTERVAL",
-    _get_config_value("delta", "interval", 0.5)
+PERIOD = os.getenv(
+    "PERIOD",
+    _get_config_value("RENKO", "period", "M5")
+)
+
+BARS = int(os.getenv(
+    "BARS",
+    _get_config_value("RENKO", "bars", 500)
+))
+
+DIGITS = int(os.getenv(
+    "DIGITS",
+    _get_config_value("RENKO", "digits", 2)
 ))

mtcli_renko-1.0.0.dev2/mtcli_renko/domain/timeframe.py

@@ -0,0 +1,87 @@
+"""
+Enum de Timeframes suportados pelo MTCLI Renko.
+
+Fornece:
+- Conversão amigável (m5, 5m, h1, 1h)
+- Mapeamento para constante MT5
+- Lista de valores válidos para CLI
+"""
+
+from enum import Enum
+import MetaTrader5 as mt5
+
+
+class Timeframe(Enum):
+    """
+    Representa timeframes suportados pelo MT5.
+    """
+
+    M1 = ("m1", mt5.TIMEFRAME_M1)
+    M2 = ("m2", mt5.TIMEFRAME_M2)
+    M3 = ("m3", mt5.TIMEFRAME_M3)
+    M4 = ("m4", mt5.TIMEFRAME_M4)
+    M5 = ("m5", mt5.TIMEFRAME_M5)
+    M10 = ("m10", mt5.TIMEFRAME_M10)
+    M15 = ("m15", mt5.TIMEFRAME_M15)
+    M30 = ("m30", mt5.TIMEFRAME_M30)
+
+    H1 = ("h1", mt5.TIMEFRAME_H1)
+    H2 = ("h2", mt5.TIMEFRAME_H2)
+    H3 = ("h3", mt5.TIMEFRAME_H3)
+    H4 = ("h4", mt5.TIMEFRAME_H4)
+    H6 = ("h6", mt5.TIMEFRAME_H6)
+    H8 = ("h8", mt5.TIMEFRAME_H8)
+    H12 = ("h12", mt5.TIMEFRAME_H12)
+
+    D1 = ("d1", mt5.TIMEFRAME_D1)
+    W1 = ("w1", mt5.TIMEFRAME_W1)
+    MN1 = ("mn1", mt5.TIMEFRAME_MN1)
+
+    def __init__(self, label: str, mt5_const: int):
+        self.label = label
+        self.mt5_const = mt5_const
+
+    @classmethod
+    def from_string(cls, value: str) -> "Timeframe":
+        """
+        Converte string amigável para Enum Timeframe.
+
+        Aceita:
+            m5, 5m
+            h1, 1h
+            d1, 1d
+        """
+
+        value = value.strip().lower()
+
+        # Aliases humanos
+        aliases = {
+            "1m": "m1",
+            "5m": "m5",
+            "15m": "m15",
+            "30m": "m30",
+            "1h": "h1",
+            "4h": "h4",
+            "1d": "d1",
+            "1w": "w1",
+            "1mo": "mn1",
+        }
+
+        if value in aliases:
+            value = aliases[value]
+
+        for tf in cls:
+            if tf.label == value:
+                return tf
+
+        raise ValueError(
+            f"Timeframe inválido: {value}. "
+            f"Use: {', '.join(cls.valid_labels())}"
+        )
+
+    @classmethod
+    def valid_labels(cls):
+        """
+        Retorna lista de labels válidos.
+        """
+        return [tf.label for tf in cls]

mtcli_renko-1.0.0.dev2/mtcli_renko/views/renko_view.py

@@ -0,0 +1,43 @@
+"""
+Renko view.
+
+Saída textual acessível para leitores de tela.
+"""
+
+import click
+from ..conf import DIGITS
+
+
+def exibir_renko(bricks, numerar: bool = False):
+    """
+    Exibe blocos Renko em formato textual linear.
+
+    :param bricks: lista de RenkoBrick
+    :param numerar: se True, exibe índice das linhas
+    """
+
+    if not bricks:
+        click.echo("Nenhum bloco Renko gerado.")
+        return
+
+    click.echo("=== GRAFICO RENKO ===")
+    click.echo(f"Total de blocos: {len(bricks)}")
+    click.echo()
+
+    for i, brick in enumerate(bricks, start=1):
+
+        if numerar:
+            linha = (
+                f"{i} "
+                f"{brick.direction.upper()} "
+                f"{brick.open:.{DIGITS}f} "
+                f"{brick.close:.{DIGITS}f}"
+            )
+        else:
+            linha = (
+                f"{brick.direction.upper()} "
+                f"{brick.open:.{DIGITS}f} "
+                f"{brick.close:.{DIGITS}f}"
+            )
+
+        click.echo(linha)

{mtcli_renko-1.0.0.dev0 → mtcli_renko-1.0.0.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli-renko"
-version = "1.0.0.dev0"
+version = "1.0.0.dev2"
 description = "Plugin do mtcli"
 authors = [
     {name = "Valmir França",email = "vfranca3@gmail.com"}

mtcli_renko-1.0.0.dev0/mtcli_renko/commands/renko.py

@@ -1,24 +0,0 @@
-"""
-Comando CLI para geração de gráfico Renko.
-"""
-
-import click
-from ..controllers.renko_controller import RenkoController
-from ..views.renko_view import exibir_renko
-import MetaTrader5 as mt5
-
-
-@click.command()
-@click.option("--symbol", "-s", required=True)
-@click.option("--brick", "-b", required=True, type=float)
-@click.option("--timeframe", "-t", default=mt5.TIMEFRAME_M5)
-@click.option("--bars", "-n", default=500)
-def renko(symbol, brick, timeframe, bars):
-    """
-    Gera gráfico Renko em modo texto.
-    """
-
-    controller = RenkoController(symbol, brick, timeframe, bars)
-    bricks = controller.executar()
-
-    exibir_renko(bricks)

mtcli_renko-1.0.0.dev0/mtcli_renko/views/renko_view.py

@@ -1,28 +0,0 @@
-"""
-Renko view.
-
-Saída textual acessível para leitores de tela.
-"""
-
-def exibir_renko(bricks):
-    """
-    Exibe blocos Renko em formato textual linear.
-
-    :param bricks: lista de RenkoBrick
-    """
-
-    if not bricks:
-        print("Nenhum bloco Renko gerado.")
-        return
-
-    print("=== GRAFICO RENKO ===")
-    print(f"Total de blocos: {len(bricks)}")
-    print()
-
-    for i, brick in enumerate(bricks, start=1):
-        print(
-            f"{i} "
-            f"{brick.direction.upper()} "
-            f"{brick.open:.0f} "
-            f"{brick.close:.0f}"
-        )