mtcli-volume 2.2.0.dev0__tar.gz → 2.2.0.dev1__tar.gz

{mtcli_volume-2.2.0.dev0 → mtcli_volume-2.2.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mtcli-volume
-Version: 2.2.0.dev0
+Version: 2.2.0.dev1
 Summary: Plugin mtcli para exibir o volume profile
 Author: Valmir França da Silva
 Author-email: vfranca3@gmail.com

mtcli_volume-2.2.0.dev1/mtcli_volume/controllers/volume_controller.py

@@ -0,0 +1,83 @@
+from datetime import datetime, timedelta, timezone
+import zoneinfo  # Python 3.9+
+
+import numpy as np
+
+from mtcli.logger import setup_logger
+from mtcli_volume.models.volume_model import (
+    calcular_estatisticas,
+    calcular_profile,
+    obter_rates,
+)
+
+log = setup_logger()
+
+
+def calcular_volume_profile(
+    symbol,
+    period,
+    bars,
+    step,
+    volume,
+    data_inicio=None,
+    data_fim=None,
+    verbose=False,
+    timezone_str="America/Sao_Paulo",
+):
+    """Controla o fluxo de cálculo do volume profile, com suporte a timezone configurável."""
+    volume = volume.lower().strip()
+    if volume not in ["tick", "real"]:
+        log.error(f"Tipo de volume inválido: {volume}. Use 'tick' ou 'real'.")
+        raise ValueError(f"Tipo de volume inválido: {volume}. Use 'tick' ou 'real'.")
+
+    rates = obter_rates(symbol, period, bars, data_inicio, data_fim)
+
+    if rates is None or len(rates) == 0:
+        log.error("Falha ao obter dados de preços para cálculo do volume profile.")
+        return {}, {}, {}
+
+    profile = calcular_profile(rates, step, volume)
+    stats = calcular_estatisticas(profile)
+
+    # Captura de informações de contexto
+    info = {}
+    if isinstance(rates, np.ndarray) and len(rates) > 0:
+        primeiro = rates[0]
+        ultimo = rates[-1]
+        if "time" in rates.dtype.names:
+            try:
+                # Define fuso horário desejado
+                try:
+                    fuso = zoneinfo.ZoneInfo(timezone_str)
+                except Exception:
+                    log.warning(
+                        f"Fuso horário '{timezone_str}' inválido. Usando UTC−3 (Brasília)."
+                    )
+                    fuso = timezone(timedelta(hours=-3))
+
+                inicio_real = (
+                    datetime.utcfromtimestamp(float(primeiro["time"]))
+                    .astimezone(fuso)
+                    .strftime("%Y-%m-%d %H:%M:%S")
+                )
+                fim_real = (
+                    datetime.utcfromtimestamp(float(ultimo["time"]))
+                    .astimezone(fuso)
+                    .strftime("%Y-%m-%d %H:%M:%S")
+                )
+            except Exception as e:
+                log.error(f"Erro ao converter timezone: {e}")
+                inicio_real = fim_real = "?"
+        else:
+            inicio_real = fim_real = "?"
+
+        info = {
+            "symbol": symbol,
+            "period": period,
+            "candles": len(rates),
+            "inicio": inicio_real,
+            "fim": fim_real,
+            "timezone": timezone_str,
+        }
+
+    return profile, stats, info

{mtcli_volume-2.2.0.dev0 → mtcli_volume-2.2.0.dev1}/mtcli_volume/models/volume_model.py

@@ -1,10 +1,9 @@
 from collections import defaultdict
 from collections.abc import Mapping
-from typing import Any, Dict, List, Union
 from datetime import datetime
-import numpy as np
 
 import MetaTrader5 as mt5
+import numpy as np
 
 from mtcli.logger import setup_logger
 from mtcli.mt5_context import mt5_conexao
@@ -33,7 +32,9 @@ def obter_rates(
 
         try:
             if data_inicio and data_fim:
-                log.debug(f"Obtendo candles de {symbol} entre {data_inicio} e {data_fim}")
+                log.debug(
+                    f"Obtendo candles de {symbol} entre {data_inicio} e {data_fim}"
+                )
                 rates = mt5.copy_rates_range(symbol, tf, data_inicio, data_fim)
             else:
                 log.debug(f"Obtendo {bars} candles de {symbol} a partir da posição 0")
@@ -51,10 +52,10 @@ def obter_rates(
 
 
 def calcular_profile(
-    rates: List[Union[dict, tuple, object]],
+    rates: list[dict | tuple | object],
     step: float,
     volume: str = "tick",
-) -> Dict[float, float]:
+) -> dict[float, float]:
     """Calcula o volume total por faixa de preço, suportando dicionários, numpy.void, objetos ou tuplas."""
     profile = defaultdict(int)
 
@@ -70,7 +71,9 @@ def calcular_profile(
             preco = float(r["close"])
             tick_volume = int(r["tick_volume"])
             # real_volume pode não existir dependendo da corretora
-            real_volume = int(r["real_volume"]) if "real_volume" in r.dtype.names else tick_volume
+            real_volume = (
+                int(r["real_volume"]) if "real_volume" in r.dtype.names else tick_volume
+            )
 
         # --- 3️⃣ Objeto com atributos (ex: namedtuple) ---
         elif hasattr(r, "close"):

mtcli_volume-2.2.0.dev1/mtcli_volume/views/volume_view.py

@@ -0,0 +1,69 @@
+import click
+
+from mtcli_volume.conf import DIGITOS
+
+BARRA_CHAR = "#"
+
+
+def exibir_volume_profile(profile, stats, symbol, info=None, verbose=False):
+    """Exibe o volume profile no terminal de forma acessível e organizada."""
+    if not profile:
+        click.echo(f"Nenhum dado disponível para {symbol}")
+        return
+
+    # ──────────────────────────────────────────────
+    # BLOCO VERBOSO: exibe detalhes da análise
+    # ──────────────────────────────────────────────
+    if verbose and info:
+        click.echo("\n=== Informações da Análise ===")
+        linhas = [
+            ("Símbolo", info.get("symbol", "?")),
+            ("Timeframe", info.get("period", "?").upper()),
+            ("Candles analisados", str(info.get("candles", "?"))),
+            (
+                "Período analisado",
+                f"{info.get('inicio', '?')} → {info.get('fim', '?')}",
+            ),
+            ("Fuso horário", info.get("timezone", "Desconhecido")),
+        ]
+        largura_esq = max(len(t[0]) for t in linhas) + 2
+        for chave, valor in linhas:
+            click.echo(f"{chave:<{largura_esq}}: {valor}")
+        click.echo("=" * (largura_esq + 30))
+
+    # ──────────────────────────────────────────────
+    # BLOCO PRINCIPAL: Volume Profile
+    # ──────────────────────────────────────────────
+    dados_ordenados = sorted(profile.items(), reverse=True)
+    click.echo(f"\n📊 Volume Profile — {symbol}\n")
+
+    max_vol = max(profile.values())
+    largura_preco = max(len(f"{p:.{DIGITOS}f}") for p in profile.keys())
+
+    # Cabeçalho
+    click.echo(f"{'Preço':>{largura_preco}} | Volume | Distribuição")
+    click.echo("-" * (largura_preco + 32))
+
+    # Corpo da tabela
+    for preco, vol in dados_ordenados:
+        barra_len = int(vol / max_vol * 50)
+        barra = BARRA_CHAR * barra_len
+        click.echo(f"{preco:>{largura_preco}.{DIGITOS}f} | {vol:>6} | {barra}")
+
+    # ──────────────────────────────────────────────
+    # BLOCO FINAL: Estatísticas
+    # ──────────────────────────────────────────────
+    click.echo("\n=== Estatísticas ===")
+    if stats.get("poc") is not None:
+        click.echo(f"POC              : {stats['poc']:.{DIGITOS}f}")
+        click.echo(
+            f"Área de Valor    : {stats['area_valor'][0]:.{DIGITOS}f} → {stats['area_valor'][1]:.{DIGITOS}f}"
+        )
+        click.echo(
+            f"HVNs (High Vol.) : {', '.join(map(lambda x: f'{x:.{DIGITOS}f}', stats['hvns'])) or 'Nenhum'}"
+        )
+        click.echo(
+            f"LVNs (Low Vol.)  : {', '.join(map(lambda x: f'{x:.{DIGITOS}f}', stats['lvns'])) or 'Nenhum'}"
+        )
+    else:
+        click.echo("Estatísticas indisponíveis (dados insuficientes).")

mtcli_volume-2.2.0.dev1/mtcli_volume/volume.py

@@ -0,0 +1,69 @@
+from datetime import datetime
+
+import click
+
+from mtcli_volume.conf import BARS, PERIOD, STEP, SYMBOL, VOLUME
+from mtcli_volume.controllers.volume_controller import calcular_volume_profile
+from mtcli_volume.views.volume_view import exibir_volume_profile
+
+
+@click.command(
+    "volume",
+    help="Exibe o Volume Profile, agrupando volumes por faixa de preço no histórico recente.",
+)
+@click.version_option(package_name="mtcli-volume")
+@click.option(
+    "--symbol", "-s", default=SYMBOL, show_default=True, help="Símbolo do ativo."
+)
+@click.option(
+    "--period",
+    "-p",
+    default=PERIOD,
+    show_default=True,
+    help="Timeframe (ex: M1, M5, H1).",
+)
+@click.option("--bars", "-b", default=BARS, show_default=True, help="Número de barras.")
+@click.option(
+    "--step",
+    "-e",
+    type=float,
+    default=STEP,
+    show_default=True,
+    help="Tamanho do agrupamento de preços.",
+)
+@click.option(
+    "--volume",
+    "-v",
+    default=VOLUME,
+    show_default=True,
+    help="Tipo de volume (tick ou real).",
+)
+@click.option(
+    "--from", "data_inicio", type=str, help="Data/hora inicial (YYYY-MM-DD HH:MM)."
+)
+@click.option("--to", "data_fim", type=str, help="Data/hora final (YYYY-MM-DD HH:MM).")
+@click.option(
+    "--verbose",
+    "-vv",
+    is_flag=True,
+    help="Mostra informações detalhadas sobre a análise.",
+)
+@click.option(
+    "--timezone",
+    "-tz",
+    type=str,
+    default="America/Sao_Paulo",
+    show_default=True,
+    help="Fuso horário para exibição das datas (ex: 'UTC', 'America/Sao_Paulo').",
+)
+def volume(
+    symbol, period, bars, step, volume, data_inicio, data_fim, verbose, timezone
+):
+    """Exibe o Volume Profile agrupando volumes por faixa de preço."""
+    inicio = datetime.strptime(data_inicio, "%Y-%m-%d %H:%M") if data_inicio else None
+    fim = datetime.strptime(data_fim, "%Y-%m-%d %H:%M") if data_fim else None
+
+    profile, stats, info = calcular_volume_profile(
+        symbol, period, bars, step, volume, inicio, fim, verbose, timezone
+    )
+    exibir_volume_profile(profile, stats, symbol, info, verbose)

{mtcli_volume-2.2.0.dev0 → mtcli_volume-2.2.0.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mtcli-volume"
-version = "2.2.0.dev0"
+version = "2.2.0.dev1"
 description = "Plugin mtcli para exibir o volume profile"
 authors = [
     {name = "Valmir França da Silva",email = "vfranca3@gmail.com"}

mtcli_volume-2.2.0.dev0/mtcli_volume/controllers/volume_controller.py

@@ -1,28 +0,0 @@
-from mtcli.logger import setup_logger
-from mtcli_volume.models.volume_model import (
-    calcular_estatisticas,
-    calcular_profile,
-    obter_rates,
-)
-
-log = setup_logger()
-
-
-def calcular_volume_profile(symbol, period, bars, step, volume, data_inicio=None, data_fim=None):
-    """Controla o fluxo de cálculo do volume profile."""
-    volume = volume.lower().strip()
-    if volume not in ["tick", "real"]:
-        log.error(f"Tipo de volume inválido: {volume}. Use 'tick' ou 'real'.")
-        raise ValueError(f"Tipo de volume inválido: {volume}. Use 'tick' ou 'real'.")
-
-    rates = obter_rates(symbol, period, bars, data_inicio, data_fim)
-
-    # ✅ Correção: checagem segura para arrays NumPy
-    if rates is None or len(rates) == 0:
-        log.error("Falha ao obter dados de preços para cálculo do volume profile.")
-        return {}, {}
-
-    profile = calcular_profile(rates, step, volume)
-    stats = calcular_estatisticas(profile)
-
-    return profile, stats

mtcli_volume-2.2.0.dev0/mtcli_volume/views/volume_view.py

@@ -1,29 +0,0 @@
-import click
-
-from mtcli_volume.conf import DIGITOS
-
-BARRA_CHAR = "#"  # Pode mudar para "■" ou "=" se UTF-8 for garantido
-
-
-def exibir_volume_profile(profile, stats, symbol):
-    """Exibe o volume profile no terminal."""
-    if not profile:
-        click.echo(f"Nenhum dado disponível para {symbol}")
-        return
-
-    dados_ordenados = sorted(profile.items(), reverse=True)
-
-    click.echo(f"\nVolume Profile {symbol}\n")
-    max_vol = max(profile.values())
-    for preco, vol in dados_ordenados:
-        barra = BARRA_CHAR * (vol // max(1, max_vol // 50))
-        click.echo(f"{preco:>8.{DIGITOS}f} {vol:>6} {barra}")
-
-    # Estatísticas
-    if stats.get("poc") is not None:
-        click.echo(f"\nPOC {stats['poc']:.{DIGITOS}f}")
-        click.echo(f"VA {stats['area_valor'][0]:.{DIGITOS}f} a {stats['area_valor'][1]:.{DIGITOS}f}")
-        click.echo(f"HVNs {stats['hvns']}")
-        click.echo(f"LVNs {stats['lvns']}")
-    else:
-        click.echo("\nEstatísticas indisponíveis (dados insuficientes).")

mtcli_volume-2.2.0.dev0/mtcli_volume/volume.py

@@ -1,31 +0,0 @@
-import click
-from datetime import datetime
-
-from mtcli_volume.conf import BARS, PERIOD, STEP, SYMBOL, VOLUME
-from mtcli_volume.controllers.volume_controller import calcular_volume_profile
-from mtcli_volume.views.volume_view import exibir_volume_profile
-
-
-@click.command(
-    "volume",
-    help="Exibe o Volume Profile, agrupando volumes por faixa de preço no histórico recente.",
-)
-@click.version_option(package_name="mtcli-volume")
-@click.option("--symbol", "-s", default=SYMBOL, show_default=True, help="Símbolo do ativo.")
-@click.option("--period", "-p", default=PERIOD, show_default=True, help="Timeframe (ex: M1, M5, H1).")
-@click.option("--bars", "-b", default=BARS, show_default=True, help="Número de barras.")
-@click.option("--step", "-e", type=float, default=STEP, show_default=True, help="Tamanho do agrupamento de preços.")
-@click.option("--volume", "-v", default=VOLUME, show_default=True, help="Tipo de volume (tick ou real).")
-@click.option("--from", "data_inicio", type=str, help="Data/hora inicial no formato 'YYYY-MM-DD HH:MM'.")
-@click.option("--to", "data_fim", type=str, help="Data/hora final no formato 'YYYY-MM-DD HH:MM'.")
-def volume(symbol, period, bars, step, volume, data_inicio, data_fim):
-    """Exibe o Volume Profile agrupando volumes por faixa de preço."""
-    inicio = datetime.strptime(data_inicio, "%Y-%m-%d %H:%M") if data_inicio else None
-    fim = datetime.strptime(data_fim, "%Y-%m-%d %H:%M") if data_fim else None
-
-    profile, stats = calcular_volume_profile(symbol, period, bars, step, volume, inicio, fim)
-    exibir_volume_profile(profile, stats, symbol)
-
-
-if __name__ == "__main__":
-    volume()