mtcli-volume 2.4.0.dev0__py3-none-any.whl → 2.4.0.dev1__py3-none-any.whl

mtcli_volume/{volume.py → cli.py}

@@ -1,97 +1,102 @@
-from datetime import datetime
-
-import click
-
-from mtcli_volume.conf import (
-    FROM,
-    PERIOD,
-    PERIODOS,
-    RANGE,
-    SYMBOL,
-    TIMEZONE,
-    TO,
-    VOLUME,
-)
-from mtcli_volume.controllers.volume_controller import calcular_volume_profile
-from mtcli_volume.views.volume_view import exibir_volume_profile
-
-
-@click.command(
-    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="Período do volume.",
-)
-@click.option(
-    "--periodos",
-    "-po",
-    "bars",
-    default=PERIODOS,
-    show_default=True,
-    help="Quantidade de períodos.",
-)
-@click.option(
-    "--range",
-    "-r",
-    "step",
-    type=float,
-    default=RANGE,
-    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,
-    default=FROM,
-    show_default=True,
-    help="Data/hora inicial (YYYY-MM-DD HH:MM).",
-)
-@click.option(
-    "--to",
-    "data_fim",
-    type=str,
-    default=TO,
-    show_default=True,
-    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=TIMEZONE,
-    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)
+from datetime import datetime
+
+import click
+
+from .conf import (
+    FIM,
+    INICIO,
+    LIMIT,
+    PERIOD,
+    RANGE,
+    SYMBOL,
+    TIMEZONE,
+    VOLUME,
+)
+from .controller import calcular_volume_profile
+from .view import exibir_volume_profile
+
+
+@click.command(
+    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 usado no calculo.",
+)
+@click.option(
+    "--limit",
+    "-l",
+    default=LIMIT,
+    show_default=True,
+    help="Quantidade de timeframes usados no calculo.",
+)
+@click.option(
+    "--range",
+    "-r",
+    type=float,
+    default=RANGE,
+    show_default=True,
+    help="Tamanho da faixa da distribuicao.",
+)
+@click.option(
+    "--volume",
+    "-v",
+    type=click.Choice(["tick", "real"], case_sensitive=False),
+    default=VOLUME,
+    show_default=True,
+    help="Tipo do volume .",
+)
+@click.option(
+    "--format",
+    "-fo",
+    type=click.Choice(["none", "k", "m", "auto"], case_sensitive=False),
+    default="k",
+    show_default=True,
+    help="Formatacao do volume.",
+)
+@click.option(
+    "--inicio",
+    "-i",
+    default=INICIO,
+    show_default=True,
+    help="Data/hora inicial (YYYY-MM-DD HH:MM).",
+)
+@click.option(
+    "--fim",
+    "-f",
+    default=FIM,
+    show_default=True,
+    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=TIMEZONE,
+    show_default=True,
+    help="Fuso horário para exibição das datas (ex: 'UTC', 'America/Sao_Paulo').",
+)
+def volume(
+    symbol, period, limit, range, volume, format, inicio, fim, timezone, verbose
+):
+    """Exibe o Volume Profile agrupando volumes por faixa de preço."""
+    inicio = datetime.strptime(inicio, "%Y-%m-%d %H:%M") if inicio else None
+    fim = datetime.strptime(fim, "%Y-%m-%d %H:%M") if fim else None
+
+    profile, stats, info = calcular_volume_profile(
+        symbol, period, limit, range, volume, inicio, fim, verbose, timezone
+    )
+    exibir_volume_profile(profile, stats, symbol, info, verbose, format)

mtcli_volume/conf.py

@@ -1,17 +1,16 @@
-import os
-
-from mtcli.conf import config
-
-SYMBOL = os.getenv("SYMBOL", config["DEFAULT"].get("symbol", fallback="WIN$N"))
-DIGITOS = int(os.getenv("DIGITOS", config["DEFAULT"].getint("digitos", fallback=0)))
-PERIOD = os.getenv("PERIOD", config["DEFAULT"].get("period", fallback="M1"))
-PERIODOS = int(
-    os.getenv("PERIODOS", config["DEFAULT"].getint("periodos", fallback=566))
-)
-RANGE = float(os.getenv("RANGE", config["DEFAULT"].getfloat("range", fallback=100)))
-VOLUME = os.getenv("VOLUME", config["DEFAULT"].get("volume", fallback="tick"))
-FROM = os.getenv("FROM", config["DEFAULT"].get("from", fallback=""))
-TO = os.getenv("TO", config["DEFAULT"].get("to", fallback=""))
-TIMEZONE = os.getenv(
-    "TIMEZONE", config["DEFAULT"].get("timezone", fallback="America/Sao_Paulo")
-)
+import os
+
+from mtcli.conf import config
+
+SYMBOL = os.getenv("SYMBOL", config["DEFAULT"].get("symbol", fallback="WIN$N"))
+DIGITOS = int(os.getenv("DIGITOS", config["DEFAULT"].getint("digitos", fallback=0)))
+PERIOD = os.getenv("PERIOD", config["DEFAULT"].get("period", fallback="M1"))
+LIMIT = int(os.getenv("LIMIT", config["DEFAULT"].getint("limit", fallback=566)))
+RANGE = float(os.getenv("RANGE", config["DEFAULT"].getfloat("range", fallback=100)))
+VOLUME = os.getenv("VOLUME", config["DEFAULT"].get("volume", fallback="tick"))
+INICIO = os.getenv("INICIO", config["DEFAULT"].get("inicio", fallback=""))
+FIM = os.getenv("FIM", config["DEFAULT"].get("fim", fallback=""))
+TIMEZONE = os.getenv(
+    "TIMEZONE", config["DEFAULT"].get("timezone", fallback="America/Sao_Paulo")
+)
+FORMAT = os.getenv("FORMAT", config["DEFAULT"].get("format", fallback="k"))

mtcli_volume/{controllers/volume_controller.py → controller.py}

@@ -1,83 +1,84 @@
-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
+from datetime import datetime, timedelta, timezone
+import zoneinfo  # Python 3.9+
+
+import numpy as np
+
+from mtcli.logger import setup_logger
+
+from .model import (
+    calcular_estatisticas,
+    calcular_profile,
+    obter_rates,
+)
+
+log = setup_logger()
+
+
+def calcular_volume_profile(
+    symbol,
+    period,
+    limit,
+    range,
+    volume,
+    inicio=None,
+    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, limit, inicio, 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, range, 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/plugin.py

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

mtcli_volume/{views/volume_view.py → view.py}

@@ -1,11 +1,39 @@
 import click
 
-from mtcli_volume.conf import DIGITOS
+from .conf import DIGITOS as D
 
 BARRA_CHAR = "#"
 
 
-def exibir_volume_profile(profile, stats, symbol, info=None, verbose=False):
+def formatar_numero(valor: float, modo: str) -> str:
+    """
+    Formata o volume conforme o modo escolhido:
+    - none: valor bruto
+    - k: milhares
+    - m: milhões
+    - auto: decide automaticamente
+    """
+    modo = (modo or "k").lower()
+
+    if modo == "none":
+        return f"{valor:.{D}f}"
+
+    if modo == "k":
+        return f"{valor / 1000:.{D}f}"
+
+    if modo == "m":
+        return f"{valor / 1_000_000:.{D}f}M"
+
+    # auto
+    if valor >= 1_000_000:
+        return f"{valor / 1_000_000:.{D}f}M"
+    if valor >= 1000:
+        return f"{valor / 1000:.{D}f}K"
+
+    return f"{valor:.{D}f}"
+
+
+def exibir_volume_profile(profile, stats, symbol, info=None, verbose=False, format="k"):
     """Exibe o volume profile no terminal de forma acessível e organizada."""
     if not profile:
         click.echo(f"Nenhum dado disponível para {symbol}")
@@ -38,32 +66,34 @@ def exibir_volume_profile(profile, stats, symbol, info=None, verbose=False):
     click.echo(f"\nVolume Profile — {symbol}\n")
 
     max_vol = max(profile.values())
-    largura_preco = max(len(f"{p:.{DIGITOS}f}") for p in profile.keys())
+    largura_preco = max(len(f"{p:.{D}f}") for p in profile.keys())
 
     # Cabeçalho
-    click.echo(f"{'Preço':>{largura_preco}} | Volume 1000X | Distribuição")
-    click.echo("-" * (largura_preco + 32))
+    click.echo(f"{'Preço':>{largura_preco}} | Volume({format.upper()}) | Distribuição")
+    click.echo("-" * (largura_preco + 44))
 
     # 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/1000:>6.0f} | {barra}")
+        click.echo(
+            f"{preco:>{largura_preco}.{D}f} | {formatar_numero(vol, format):>10} | {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"POC              {stats['poc']:.{D}f}")
         click.echo(
-            f"VA {stats['area_valor'][0]:.{DIGITOS}f} a {stats['area_valor'][1]:.{DIGITOS}f}"
+            f"VA {stats['area_valor'][0]:.{D}f} a {stats['area_valor'][1]:.{D}f}"
         )
         click.echo(
-            f"HVNs {', '.join(map(lambda x: f'{x:.{DIGITOS}f}', stats['hvns'])) or 'Nenhum'}"
+            f"HVNs {', '.join(map(lambda x: f'{x:.{D}f}', stats['hvns'])) or 'Nenhum'}"
         )
         click.echo(
-            f"LVNs {', '.join(map(lambda x: f'{x:.{DIGITOS}f}', stats['lvns'])) or 'Nenhum'}"
+            f"LVNs {', '.join(map(lambda x: f'{x:.{D}f}', stats['lvns'])) or 'Nenhum'}"
         )
     else:
         click.echo("Estatísticas indisponíveis (dados insuficientes).")

{mtcli_volume-2.4.0.dev0.dist-info → mtcli_volume-2.4.0.dev1.dist-info}/METADATA

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

mtcli_volume-2.4.0.dev1.dist-info/RECORD

@@ -0,0 +1,12 @@
+mtcli_volume/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mtcli_volume/cli.py,sha256=5IpQyl87CNTfxK9y50Oh1lf67lkDm4vWA10q0jXdPr0,2500
+mtcli_volume/conf.py,sha256=U4aucZ260sj6M4d8LOKnqC7T2X00DAnypgaZU93ifjI,866
+mtcli_volume/controller.py,sha256=1Iy96JPc0Sh7y_JPniRzHXZ1ypF1B7sdFhKBignpNHU,2636
+mtcli_volume/model.py,sha256=I8wn3rSQjRlVHaVMFIdZKX-HQpwSVyCgzaYgJK2H7Fk,4221
+mtcli_volume/plugin.py,sha256=EitEOP0FCSf0aSsjHB51tJ0vY3YUucmh3u0avub6oWg,89
+mtcli_volume/view.py,sha256=YySEDxavjcKWN_oPGOFj6Asvvir3dNzlnUJErzdNpDY,3926
+mtcli_volume-2.4.0.dev1.dist-info/entry_points.txt,sha256=JZQvJocNZRSGJF_bOkVJT8JVFERaYC2jCEmm28lMsa0,59
+mtcli_volume-2.4.0.dev1.dist-info/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+mtcli_volume-2.4.0.dev1.dist-info/METADATA,sha256=ZeccXhrYRSQh536WF-Mx0mk2o4tB5FsLDAA-sJI8OSA,3060
+mtcli_volume-2.4.0.dev1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+mtcli_volume-2.4.0.dev1.dist-info/RECORD,,

mtcli_volume-2.4.0.dev0.dist-info/RECORD

@@ -1,12 +0,0 @@
-mtcli_volume/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mtcli_volume/conf.py,sha256=voyjod5SmIK9O0Xs9HmZbL6gX2qi4dhHTcp1u6-TP0g,780
-mtcli_volume/controllers/volume_controller.py,sha256=MpSIyzUaRwU5vM3BqHkJ8fvFcsVP5ZRFoSI5TUJbONI,2593
-mtcli_volume/models/volume_model.py,sha256=I8wn3rSQjRlVHaVMFIdZKX-HQpwSVyCgzaYgJK2H7Fk,4221
-mtcli_volume/plugin.py,sha256=NQf2buPpM9r0ZGAN9OjXJ6mAu9q26WISvZHIILsd9WU,99
-mtcli_volume/views/volume_view.py,sha256=efrI8g5QKz6IyahqUHXsWfsqkamG_VGWKlpDfhhBKYs,3277
-mtcli_volume/volume.py,sha256=nEkTfXfy30m5lSq3Qwse2mkLZl4ni8ll8kjCyPvoqtA,2278
-mtcli_volume-2.4.0.dev0.dist-info/entry_points.txt,sha256=JZQvJocNZRSGJF_bOkVJT8JVFERaYC2jCEmm28lMsa0,59
-mtcli_volume-2.4.0.dev0.dist-info/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-mtcli_volume-2.4.0.dev0.dist-info/METADATA,sha256=pw0TOqRpvqHwkvUI0rPRm13RoMLTEpEP-h1DkS8uWMw,3060
-mtcli_volume-2.4.0.dev0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-mtcli_volume-2.4.0.dev0.dist-info/RECORD,,