mtcli-renko 1.0.0__tar.gz

mtcli_renko-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Valmir França
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mtcli_renko-1.0.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: mtcli-renko
+Version: 1.0.0
+Summary: Renko plugin institucional para mtcli (MetaTrader 5)
+License-Expression: MIT
+License-File: LICENSE
+Keywords: trading,renko,metatrader5,mt5,cli,price-action
+Author: Valmir França
+Author-email: vfranca3@gmail.com
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Dist: click (>=8.3.0,<9.0.0)
+Requires-Dist: metatrader5 (>=5.0.5370,<6.0.0)
+Requires-Dist: mtcli (>=3.2.0)
+Project-URL: Documentation, https://vfranca.github.io/mtcli-renko
+Project-URL: Homepage, https://github.com/vfranca/mtcli-renko
+Project-URL: Issues, https://github.com/vfranca/mtcli-renko/issues
+Project-URL: Repository, https://github.com/vfranca/mtcli-renko
+Description-Content-Type: text/markdown
+
+# mtcli-renko
+
+Renko institucional para MetaTrader 5 integrado ao ecossistema `mtcli`.
+
+Geração de gráfico Renko em modo texto (terminal), com:
+
+- Renko simples
+- Renko clássico (reversão 2x)
+- Ancoragem real no último pregão
+- Controle de barras por sessão
+- Compatível com B3, Forex e ativos 24h
+- Ideal para uso via CLI e automação
+
+---
+
+## Instalação
+
+Via pip:
+
+```bash
+pip install mtcli-renko
+````
+
+Ou via Poetry:
+
+```bash
+poetry add mtcli-renko
+```
+
+---
+
+## Requisitos
+
+* Python 3.10+
+* MetaTrader 5 instalado
+* Conta conectada ao terminal MT5
+* Plugin `mtcli` configurado
+
+---
+
+## Uso
+
+Após instalar, o comando fica disponível dentro do `mt`:
+
+```bash
+mt renko --symbol WINJ26 --brick 50
+```
+
+---
+
+## Parâmetros
+
+| Opção                | Descrição                         |
+| -------------------- | --------------------------------- |
+| `--symbol`, `-s`     | Ativo (ex: WINJ26)                |
+| `--brick`, `-b`      | Tamanho do brick                  |
+| `--timeframe`, `-t`  | Timeframe (m1, m5, m15, h1, etc.) |
+| `--bars`, `-n`       | Quantidade de barras base         |
+| `--modo`             | `simples` ou `classico`           |
+| `--ancorar-abertura` | Ancora no último pregão           |
+
+---
+
+## Exemplos
+
+### Renko simples padrão
+
+```bash
+mt renko -s WINJ26 -b 50
+```
+
+### Renko clássico (reversão 2x)
+
+```bash
+mt renko -s WINJ26 -b 50 --modo classico
+```
+
+### Ancorado no último pregão
+
+```bash
+mt renko -s WINJ26 -b 50 --ancorar-abertura
+```
+
+### Todas as barras do último pregão
+
+```bash
+mt renko -s WINJ26 -b 50 --ancorar-abertura --bars 0
+```
+
+### Últimas 20 barras do último pregão
+
+```bash
+mt renko -s WINJ26 -b 50 --ancorar-abertura --bars 20
+```
+
+---
+
+## Timeframes aceitos
+
+Use valores simplificados:
+
+* m1
+* m5
+* m15
+* m30
+* h1
+* h4
+* d1
+
+O sistema faz o mapeamento automático para as constantes do MetaTrader 5.
+
+---
+
+## Ancoragem Institucional
+
+Quando `--ancorar-abertura` é ativado:
+
+* Detecta o último candle disponível
+* Descobre a data do último pregão real
+* Filtra manualmente apenas aquele dia
+* Ignora histórico anterior
+* Funciona inclusive em domingos e feriados
+
+Comportamento:
+
+* `--bars 0` → todas as barras do último pregão
+* `--bars N` → últimas N barras daquele pregão
+
+---
+
+## Modos de Construção
+
+### Simples
+
+Cria bricks contínuos sem regra de reversão 2x.
+
+### Clássico
+
+Implementa reversão apenas quando o preço move 2x o tamanho do brick na direção oposta.
+
+---
+
+## Estrutura do Projeto
+
+```
+mtcli_renko/
+│
+├── commands/
+├── controllers/
+├── models/
+├── views/
+├── conf.py
+└── enums.py
+```
+
+Arquitetura baseada em MVC, alinhada ao padrão do `mtcli-trade`.
+
+---
+
+## Casos de Uso
+
+* Leitura de estrutura (H1, H2, H3, L1, L2)
+* Identificação de BRF / BLF
+* Automação de análise
+* Backtesting via script
+* Operação institucional via terminal
+
+---
+
+## Compatibilidade
+
+* B3 (ex: WIN, WDO)
+* Forex
+* Cripto
+* Ativos 24h
+
+---
+
+## Roadmap
+
+* [ ] Múltiplas sessões
+* [ ] Filtro de horário (09:00–18:00)
+* [ ] VWAP integrada
+* [ ] Detecção automática de estrutura (H1/H2/L2)
+* [ ] Exportação CSV
+
+---
+
+## Licença
+
+MIT License
+
+---
+
+## Autor
+
+Valmir França
+
+---
+
+## Contribuição
+
+Pull requests são bem-vindos.
+Para mudanças maiores, abra uma issue antes para discussão.
+
+---
+
+## Aviso
+
+Este software não constitui recomendação de investimento.
+Uso por conta e risco do operador.
+

mtcli_renko-1.0.0/README.md

@@ -0,0 +1,211 @@
+# mtcli-renko
+
+Renko institucional para MetaTrader 5 integrado ao ecossistema `mtcli`.
+
+Geração de gráfico Renko em modo texto (terminal), com:
+
+- Renko simples
+- Renko clássico (reversão 2x)
+- Ancoragem real no último pregão
+- Controle de barras por sessão
+- Compatível com B3, Forex e ativos 24h
+- Ideal para uso via CLI e automação
+
+---
+
+## Instalação
+
+Via pip:
+
+```bash
+pip install mtcli-renko
+````
+
+Ou via Poetry:
+
+```bash
+poetry add mtcli-renko
+```
+
+---
+
+## Requisitos
+
+* Python 3.10+
+* MetaTrader 5 instalado
+* Conta conectada ao terminal MT5
+* Plugin `mtcli` configurado
+
+---
+
+## Uso
+
+Após instalar, o comando fica disponível dentro do `mt`:
+
+```bash
+mt renko --symbol WINJ26 --brick 50
+```
+
+---
+
+## Parâmetros
+
+| Opção                | Descrição                         |
+| -------------------- | --------------------------------- |
+| `--symbol`, `-s`     | Ativo (ex: WINJ26)                |
+| `--brick`, `-b`      | Tamanho do brick                  |
+| `--timeframe`, `-t`  | Timeframe (m1, m5, m15, h1, etc.) |
+| `--bars`, `-n`       | Quantidade de barras base         |
+| `--modo`             | `simples` ou `classico`           |
+| `--ancorar-abertura` | Ancora no último pregão           |
+
+---
+
+## Exemplos
+
+### Renko simples padrão
+
+```bash
+mt renko -s WINJ26 -b 50
+```
+
+### Renko clássico (reversão 2x)
+
+```bash
+mt renko -s WINJ26 -b 50 --modo classico
+```
+
+### Ancorado no último pregão
+
+```bash
+mt renko -s WINJ26 -b 50 --ancorar-abertura
+```
+
+### Todas as barras do último pregão
+
+```bash
+mt renko -s WINJ26 -b 50 --ancorar-abertura --bars 0
+```
+
+### Últimas 20 barras do último pregão
+
+```bash
+mt renko -s WINJ26 -b 50 --ancorar-abertura --bars 20
+```
+
+---
+
+## Timeframes aceitos
+
+Use valores simplificados:
+
+* m1
+* m5
+* m15
+* m30
+* h1
+* h4
+* d1
+
+O sistema faz o mapeamento automático para as constantes do MetaTrader 5.
+
+---
+
+## Ancoragem Institucional
+
+Quando `--ancorar-abertura` é ativado:
+
+* Detecta o último candle disponível
+* Descobre a data do último pregão real
+* Filtra manualmente apenas aquele dia
+* Ignora histórico anterior
+* Funciona inclusive em domingos e feriados
+
+Comportamento:
+
+* `--bars 0` → todas as barras do último pregão
+* `--bars N` → últimas N barras daquele pregão
+
+---
+
+## Modos de Construção
+
+### Simples
+
+Cria bricks contínuos sem regra de reversão 2x.
+
+### Clássico
+
+Implementa reversão apenas quando o preço move 2x o tamanho do brick na direção oposta.
+
+---
+
+## Estrutura do Projeto
+
+```
+mtcli_renko/
+│
+├── commands/
+├── controllers/
+├── models/
+├── views/
+├── conf.py
+└── enums.py
+```
+
+Arquitetura baseada em MVC, alinhada ao padrão do `mtcli-trade`.
+
+---
+
+## Casos de Uso
+
+* Leitura de estrutura (H1, H2, H3, L1, L2)
+* Identificação de BRF / BLF
+* Automação de análise
+* Backtesting via script
+* Operação institucional via terminal
+
+---
+
+## Compatibilidade
+
+* B3 (ex: WIN, WDO)
+* Forex
+* Cripto
+* Ativos 24h
+
+---
+
+## Roadmap
+
+* [ ] Múltiplas sessões
+* [ ] Filtro de horário (09:00–18:00)
+* [ ] VWAP integrada
+* [ ] Detecção automática de estrutura (H1/H2/L2)
+* [ ] Exportação CSV
+
+---
+
+## Licença
+
+MIT License
+
+---
+
+## Autor
+
+Valmir França
+
+---
+
+## Contribuição
+
+Pull requests são bem-vindos.
+Para mudanças maiores, abra uma issue antes para discussão.
+
+---
+
+## Aviso
+
+Este software não constitui recomendação de investimento.
+Uso por conta e risco do operador.

mtcli_renko-1.0.0/mtcli_renko/commands/renko.py

@@ -0,0 +1,52 @@
+"""
+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)
+@click.option("--brick", "-b", default=BRICK, show_default=True, type=float)
+@click.option("--timeframe", "-t", default=PERIOD, show_default=True)
+@click.option("--bars", "-n", default=BARS, show_default=True, type=int)
+@click.option("--numerar/--no-numerar", default=False, show_default=True)
+@click.option(
+    "--modo",
+    type=click.Choice(["simples", "classico"], case_sensitive=False),
+    default="simples",
+    show_default=True,
+)
+@click.option(
+    "--ancorar-abertura",
+    is_flag=True,
+    default=False,
+    show_default=True,
+)
+def renko(symbol, brick, timeframe, bars, numerar, modo, ancorar_abertura):
+
+    try:
+        tf_enum = Timeframe.from_string(timeframe)
+    except ValueError as e:
+        raise click.BadParameter(str(e))
+
+    controller = RenkoController(
+        symbol,
+        brick,
+        tf_enum.mt5_const,
+        bars,
+        modo,
+        ancorar_abertura,
+    )
+
+    bricks = controller.executar()
+    exibir_renko(bricks, numerar=numerar)

mtcli_renko-1.0.0/mtcli_renko/conf.py

@@ -0,0 +1,78 @@
+"""
+conf.py
+
+Módulo de configuração do plugin mtcli-delta.
+
+Responsável por:
+
+- Ler configurações do arquivo mtcli.ini
+- Utilizar a seção [RENKO]
+- Permitir override por variáveis de ambiente
+- Definir valores padrão seguros
+
+Ordem de precedência:
+
+1. Variáveis de ambiente
+2. Seção [RENKO] do mtcli.ini
+3. Seção [DEFAULT] do mtcli.ini
+4. Valores padrão definidos no código
+"""
+
+import os
+from mtcli.conf import config
+
+
+def _get_config_value(section: str, key: str, fallback):
+    """
+    Obtém valor do arquivo de configuração com fallback seguro.
+
+    Ordem:
+    - Se existir na seção informada
+    - Se existir em DEFAULT
+    - Caso contrário usa fallback
+
+    :param section: Nome da seção no ini.
+    :param key: Nome da chave.
+    :param fallback: Valor padrão final.
+    :return: Valor encontrado ou fallback.
+    """
+    if config.has_section(section) and key in config[section]:
+        return config[section].get(key, fallback=fallback)
+
+    return config["DEFAULT"].get(key, fallback=fallback)
+
+
+# -------------------------------------------------------
+# Leitura da seção [RENKO] do mtcli.ini
+# -------------------------------------------------------
+
+SYMBOL = os.getenv(
+    "SYMBOL",
+    _get_config_value("RENKO", "symbol", "WIN$N")
+)
+
+BRICK = float(os.getenv(
+    "BRICK",
+    _get_config_value("RENKO", "brick", 50)
+))
+
+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)
+))
+
+# Hora oficial de abertura do pregão (HH:MM)
+SESSION_OPEN = os.getenv(
+    "SESSION_OPEN",
+    _get_config_value("RENKO", "session_open", "09:00")
+)

mtcli_renko-1.0.0/mtcli_renko/controllers/renko_controller.py

@@ -0,0 +1,43 @@
+"""
+Renko controller.
+"""
+
+from ..models.renko_model import RenkoModel
+from mtcli.logger import setup_logger
+
+log = setup_logger(__name__)
+
+
+class RenkoController:
+
+    def __init__(
+        self,
+        symbol,
+        brick_size,
+        timeframe,
+        quantidade,
+        modo="simples",
+        ancorar_abertura=False,
+    ):
+        self.model = RenkoModel(symbol, brick_size)
+        self.timeframe = timeframe
+        self.quantidade = quantidade
+        self.modo = modo
+        self.ancorar_abertura = ancorar_abertura
+
+    def executar(self):
+
+        rates = self.model.obter_rates(
+            self.timeframe,
+            self.quantidade,
+            ancorar_abertura=self.ancorar_abertura,
+        )
+
+        if rates is None or len(rates) == 0:
+            return []
+
+        return self.model.construir_renko(
+            rates,
+            modo=self.modo,
+            ancorar_abertura=self.ancorar_abertura,
+        )

mtcli_renko-1.0.0/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/mtcli_renko/models/renko_model.py

@@ -0,0 +1,227 @@
+"""
+Renko model institucional.
+
+Ancoragem determinística no último pregão real.
+Nunca depende do filtro interno do MT5.
+"""
+
+from dataclasses import dataclass
+from typing import List, Optional
+from datetime import datetime
+
+import MetaTrader5 as mt5
+
+from mtcli.mt5_context import mt5_conexao
+from mtcli.logger import setup_logger
+
+log = setup_logger(__name__)
+
+
+# ==========================================================
+# DATA STRUCTURE
+# ==========================================================
+
+@dataclass
+class RenkoBrick:
+    direction: str
+    open: float
+    close: float
+
+
+# ==========================================================
+# MODEL
+# ==========================================================
+
+class RenkoModel:
+
+    def __init__(self, symbol: str, brick_size: float):
+        self.symbol = symbol
+        self.brick_size = brick_size
+
+    # ======================================================
+    # OBTENÇÃO DE DADOS
+    # ======================================================
+
+    def obter_rates(self, timeframe, quantidade: int, ancorar_abertura=False):
+
+        with mt5_conexao():
+
+            if not mt5.symbol_select(self.symbol, True):
+                raise RuntimeError(f"Erro ao selecionar símbolo {self.symbol}")
+
+            # -------------------------------------------------
+            # SEM ANCORAGEM
+            # -------------------------------------------------
+            if not ancorar_abertura:
+
+                if quantidade == 0:
+                    quantidade = 1000
+
+                return mt5.copy_rates_from_pos(
+                    self.symbol,
+                    timeframe,
+                    0,
+                    quantidade,
+                )
+
+            # -------------------------------------------------
+            # COM ANCORAGEM PROFISSIONAL
+            # -------------------------------------------------
+
+            # 1️⃣ Descobrir último candle real disponível
+            ultimo = mt5.copy_rates_from_pos(
+                self.symbol,
+                timeframe,
+                0,
+                1,
+            )
+
+            if ultimo is None or len(ultimo) == 0:
+                return None
+
+            ultimo_time = datetime.fromtimestamp(ultimo[0]["time"])
+            data_referencia = ultimo_time.date()
+
+            log.info(f"[Renko] Último pregão detectado: {data_referencia}")
+
+            # 2️⃣ Buscar bloco recente grande
+            bruto = mt5.copy_rates_from_pos(
+                self.symbol,
+                timeframe,
+                0,
+                5000,
+            )
+
+            if bruto is None:
+                return None
+
+            # 3️⃣ FILTRAGEM MANUAL POR DATA
+            filtrado = []
+
+            for r in bruto:
+                r_time = datetime.fromtimestamp(r["time"])
+                if r_time.date() == data_referencia:
+                    filtrado.append(r)
+
+            if not filtrado:
+                return None
+
+            total = len(filtrado)
+
+            log.info(f"[Renko] Barras no último pregão: {total}")
+
+            # 4️⃣ Aplicar regra de quantidade
+            if quantidade == 0:
+                return filtrado
+
+            if quantidade >= total:
+                return filtrado
+
+            return filtrado[-quantidade:]
+
+    # ======================================================
+    # CONSTRUÇÃO RENKO
+    # ======================================================
+
+    def construir_renko(
+        self,
+        rates,
+        modo="simples",
+        ancorar_abertura=False,
+    ) -> List[RenkoBrick]:
+
+        if not rates or len(rates) < 2:
+            return []
+
+        if modo == "classico":
+            return self._construir_classico(rates, ancorar_abertura)
+
+        return self._construir_simples(rates, ancorar_abertura)
+
+    # ======================================================
+    # RENKO SIMPLES
+    # ======================================================
+
+    def _construir_simples(self, rates, ancorar_abertura):
+
+        bricks: List[RenkoBrick] = []
+
+        last_price = float(rates[0]["open"]) if ancorar_abertura else float(
+            rates[0]["close"]
+        )
+
+        for rate in rates[1:]:
+
+            high = float(rate["high"])
+            low = float(rate["low"])
+
+            # Up bricks
+            while high - last_price >= self.brick_size:
+                novo = last_price + self.brick_size
+                bricks.append(RenkoBrick("up", last_price, novo))
+                last_price = novo
+
+            # Down bricks
+            while last_price - low >= self.brick_size:
+                novo = last_price - self.brick_size
+                bricks.append(RenkoBrick("down", last_price, novo))
+                last_price = novo
+
+        return bricks
+
+    # ======================================================
+    # RENKO CLÁSSICO (REVERSÃO 2x)
+    # ======================================================
+
+    def _construir_classico(self, rates, ancorar_abertura):
+
+        bricks: List[RenkoBrick] = []
+
+        last_price = float(rates[0]["open"]) if ancorar_abertura else float(
+            rates[0]["close"]
+        )
+
+        direction: Optional[str] = None
+
+        for rate in rates[1:]:
+
+            high = float(rate["high"])
+            low = float(rate["low"])
+
+            # -------------------------------------------------
+            # Continuação de alta
+            # -------------------------------------------------
+            if direction in (None, "up"):
+
+                while high - last_price >= self.brick_size:
+                    novo = last_price + self.brick_size
+                    bricks.append(RenkoBrick("up", last_price, novo))
+                    last_price = novo
+                    direction = "up"
+
+                # reversão 2x
+                if direction == "up" and last_price - low >= 2 * self.brick_size:
+                    novo = last_price - self.brick_size
+                    bricks.append(RenkoBrick("down", last_price, novo))
+                    last_price = novo
+                    direction = "down"
+
+            # -------------------------------------------------
+            # Continuação de baixa
+            # -------------------------------------------------
+            if direction in (None, "down"):
+
+                while last_price - low >= self.brick_size:
+                    novo = last_price - self.brick_size
+                    bricks.append(RenkoBrick("down", last_price, novo))
+                    last_price = novo
+                    direction = "down"
+
+                # reversão 2x
+                if direction == "down" and high - last_price >= 2 * self.brick_size:
+                    novo = last_price + self.brick_size
+                    bricks.append(RenkoBrick("up", last_price, novo))
+                    last_price = novo
+                    direction = "up"
+
+        return bricks

mtcli_renko-1.0.0/mtcli_renko/plugin.py

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

mtcli_renko-1.0.0/mtcli_renko/views/renko_view.py

@@ -0,0 +1,37 @@
+"""
+Renko view.
+
+Saída textual acessível para leitores de tela.
+"""
+
+import click
+from ..conf import DIGITS
+
+
+def exibir_renko(bricks, numerar: bool = False):
+
+    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/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "mtcli-renko"
+version = "1.0.0"
+description = "Renko plugin institucional para mtcli (MetaTrader 5)"
+authors = [
+    { name = "Valmir França", email = "vfranca3@gmail.com" }
+]
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10,<3.14"
+
+keywords = [
+    "trading",
+    "renko",
+    "metatrader5",
+    "mt5",
+    "cli",
+    "price-action"
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Financial and Insurance Industry",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+
+dependencies = [
+    "mtcli>=3.2.0",
+    "click>=8.3.0,<9.0.0",
+    "metatrader5>=5.0.5370,<6.0.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/vfranca/mtcli-renko"
+Repository = "https://github.com/vfranca/mtcli-renko"
+Issues = "https://github.com/vfranca/mtcli-renko/issues"
+Documentation = "https://vfranca.github.io/mtcli-renko"
+
+[project.entry-points."mtcli.plugins"]
+renko = "mtcli_renko.plugin:register"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.4.2"
+pytest-cov = "^6.2.1"
+pytest-mock = "^3.15.1"
+ruff = "^0.14.1"
+
+[tool.poetry.group.docs.dependencies]
+mkdocs = "^1.6.1"
+pymdown-extensions = "^10.16.1"
+
+[tool.ruff]
+line-length = 88
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "B", "I", "UP", "N"]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["mtcli", "mtcli_renko"]
+combine-as-imports = true
+force-sort-within-sections = true
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "auto"
+skip-magic-trailing-comma = false