mtcli-risco 2.4.1__tar.gz → 2.5.0__tar.gz

mtcli_risco-2.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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_risco-2.4.1 → mtcli_risco-2.5.0}/PKG-INFO

@@ -1,20 +1,25 @@
 Metadata-Version: 2.4
 Name: mtcli-risco
-Version: 2.4.1
+Version: 2.5.0
 Summary: Plugin mtcli para controle de loss diário
-License-Expression: GPL-3.0
+License-Expression: MIT
 License-File: LICENSE
-Author: Valmir França da Silva
+Keywords: trading,risk manager,risk,metatrader5,mt5,cli,acessibilidade,screen reader friendly
+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.1,<9.0.0)
 Requires-Dist: metatrader5 (>=5.0.5572,<6.0.0)
-Requires-Dist: mtcli (>=1.18.1)
+Requires-Dist: mtcli (>=3.7.2)
 Project-URL: Documentation, https://mtcli-risco.readthedocs.io
 Project-URL: Homepage, https://github.com/vfranca/mtcli-risco
 Project-URL: Repository, https://github.com/vfranca/mtcli-risco

{mtcli_risco-2.4.1 → mtcli_risco-2.5.0}/mtcli_risco/cli.py

@@ -1,27 +1,33 @@
-"""
-Comando principal e registro dos subcomandos
-"""
-
-import click
-from .commands.checar import checar_cmd
-from .commands.monitorar import monitorar_cmd
-from .commands.trades import trades_cmd
-from .commands.panic import panic_cmd
-
-
-@click.group()
-@click.version_option(package_name="mtcli-risco")
-def cli():
-    """
-    Plugin mtcli-risco.
-
-    Conjunto de comandos para gerenciamento e controle de risco diário
-    baseado em lucro/prejuízo no MetaTrader 5.
-    """
-    pass
-
-
-cli.add_command(checar_cmd, name="checar")
-cli.add_command(monitorar_cmd, name="monitorar")
-cli.add_command(trades_cmd, name="trades")
-cli.add_command(panic_cmd, name="panic")
+"""
+Comando principal e registro dos subcomandos
+"""
+
+import click
+from .commands.checar import checar_cmd
+from .commands.monitorar import monitorar_cmd
+from .commands.trades import trades_cmd
+from .commands.panic import panic_cmd
+from .commands.start import start_cmd
+from .commands.stop import stop_cmd
+from .commands.status import status_cmd
+
+
+@click.group()
+@click.version_option(package_name="mtcli-risco")
+def cli():
+    """
+    Plugin mtcli-risco.
+
+    Conjunto de comandos para gerenciamento e controle de risco diário
+    baseado em lucro/prejuízo no MetaTrader 5.
+    """
+    pass
+
+
+cli.add_command(checar_cmd, name="checar")
+cli.add_command(monitorar_cmd, name="monitorar")
+cli.add_command(trades_cmd, name="trades")
+cli.add_command(panic_cmd, name="panic")
+cli.add_command(start_cmd, name="start")
+cli.add_command(stop_cmd, name="stop")
+cli.add_command(status_cmd, name="status")

{mtcli_risco-2.4.1 → mtcli_risco-2.5.0}/mtcli_risco/commands/monitorar.py

@@ -1,64 +1,64 @@
-"""
-Comando monitorar.
-
-Monitora continuamente o risco diário e executa PANIC CLOSE
-quando o limite é excedido.
-"""
-
-import time
-import click
-from datetime import date
-from mtcli.logger import setup_logger
-from mtcli_risco.conf import LOSS_LIMIT, STATUS_FILE, INTERVALO
-from mtcli_risco.models.checar_model import (
-    carregar_estado,
-    salvar_estado,
-    risco_excedido,
-)
-from mtcli_risco.models.panic_model import panic_close_all
-
-log = setup_logger()
-
-
-@click.command()
-@click.version_option(package_name="mtcli-risco")
-@click.option("--limite", "-l", default=LOSS_LIMIT, show_default=True)
-@click.option("--intervalo", "-i", default=INTERVALO, show_default=True)
-@click.option("--dry-run", is_flag=True, help="Simula o panic close.")
-def monitorar_cmd(limite: float, intervalo: int, dry_run: bool):
-    """
-    Inicia o monitoramento contínuo do risco diário.
-    """
-    click.echo(
-        f"Monitorando risco | limite={limite:.2f} intervalo={intervalo}s"
-    )
-    log.info(
-        f"[MONITOR] Iniciado | limite={limite} intervalo={intervalo}s dry_run={dry_run}"
-    )
-
-    try:
-        while True:
-            hoje = date.today()
-            estado = carregar_estado(STATUS_FILE)
-
-            if estado["data"] != hoje.isoformat():
-                salvar_estado(STATUS_FILE, hoje, False)
-                estado["bloqueado"] = False
-
-            if not estado["bloqueado"] and risco_excedido(limite):
-                click.echo("LIMITE DE RISCO EXCEDIDO — PANIC CLOSE")
-                log.critical("[MONITOR] Disparando PANIC CLOSE")
-
-                resultado = panic_close_all(
-                    retry_on_market_open=True,
-                    dry_run=dry_run,
-                )
-
-                salvar_estado(STATUS_FILE, hoje, True)
-                log.critical(f"[MONITOR] Panic finalizado: {resultado}")
-
-            time.sleep(intervalo)
-
-    except KeyboardInterrupt:
-        click.echo("Monitoramento interrompido.")
-        log.info("[MONITOR] Interrompido pelo usuário.")
+"""
+Comando monitorar.
+
+Monitora continuamente o risco diário e executa PANIC CLOSE
+quando o limite é excedido.
+"""
+
+import time
+import click
+from datetime import date
+from mtcli.logger import setup_logger
+from ..conf import LOSS_LIMIT, STATUS_FILE, INTERVALO
+from ..models.checar_model import (
+    carregar_estado,
+    salvar_estado,
+    risco_excedido,
+)
+from ..models.panic_model import panic_close_all
+
+log = setup_logger("risco")
+
+
+@click.command()
+@click.version_option(package_name="mtcli-risco")
+@click.option("--limite", "-l", default=LOSS_LIMIT, show_default=True)
+@click.option("--intervalo", "-i", default=INTERVALO, show_default=True)
+@click.option("--dry-run", is_flag=True, help="Simula o panic close.")
+def monitorar_cmd(limite: float, intervalo: int, dry_run: bool):
+    """
+    Inicia o monitoramento contínuo do risco diário.
+    """
+    click.echo(
+        f"Monitorando risco limite={limite:.2f} intervalo={intervalo}s"
+    )
+    log.info(
+        f"[MONITOR] Iniciado | limite={limite} intervalo={intervalo}s dry_run={dry_run}"
+    )
+
+    try:
+        while True:
+            hoje = date.today()
+            estado = carregar_estado(STATUS_FILE)
+
+            if estado["data"] != hoje.isoformat():
+                salvar_estado(STATUS_FILE, hoje, False)
+                estado["bloqueado"] = False
+
+            if not estado["bloqueado"] and risco_excedido(limite):
+                click.echo("LIMITE DE RISCO EXCEDIDO — PANIC CLOSE")
+                log.critical("[MONITOR] Disparando PANIC CLOSE")
+
+                resultado = panic_close_all(
+                    retry_on_market_open=True,
+                    dry_run=dry_run,
+                )
+
+                salvar_estado(STATUS_FILE, hoje, True)
+                log.critical(f"[MONITOR] Panic finalizado: {resultado}")
+
+            time.sleep(intervalo)
+
+    except KeyboardInterrupt:
+        click.echo("Monitoramento interrompido.")
+        log.info("[MONITOR] Interrompido pelo usuário.")

{mtcli_risco-2.4.1 → mtcli_risco-2.5.0}/mtcli_risco/commands/panic.py

@@ -4,10 +4,10 @@ Comando PANIC CLOSE.
 
 import click
 from mtcli.logger import setup_logger
-from mtcli_risco.models.panic_model import panic_close_all
+from ..models.panic_model import panic_close_all
 from mtcli_risco import conf
 
-log = setup_logger()
+log = setup_logger("risco")
 
 
 @click.command()

mtcli_risco-2.5.0/mtcli_risco/commands/start.py

@@ -0,0 +1,78 @@
+"""
+Comando start.
+
+Responsável por iniciar o monitor de risco em background.
+
+Este comando cria um novo processo Python que executa o módulo
+`mtcli_risco.services.run_monitor`, responsável por iniciar o
+loop de monitoramento contínuo do risco diário.
+
+Fluxo
+-----
+
+mt risco start
+    ->
+subprocess.Popen()
+    ->
+run_monitor.py
+    ->
+monitor_loop()
+
+O comando também verifica se já existe um processo ativo
+através do arquivo PID.
+"""
+
+import os
+import click
+import subprocess
+import sys
+
+from mtcli.logger import setup_logger
+from mtcli.conf import PID_FILE
+from ..conf import LOSS_LIMIT, INTERVALO
+
+log = setup_logger("risco")
+
+
+@click.command()
+@click.option("--limite", default=LOSS_LIMIT, show_default=True)
+@click.option("--intervalo", default=INTERVALO, show_default=True)
+@click.option("--dry-run", is_flag=True, help="Simula execução sem enviar ordens.")
+def start_cmd(limite: float, intervalo: int, dry_run: bool) -> None:
+    """
+    Inicia o monitor de risco em background.
+
+    Parameters
+    ----------
+    limite : float
+        Limite máximo de prejuízo diário permitido.
+    intervalo : int
+        Intervalo (segundos) entre verificações de risco.
+    dry_run : bool
+        Executa em modo simulação (sem enviar ordens ao MT5).
+    """
+
+    if os.path.exists(PID_FILE):
+        click.echo("Monitor já está rodando.")
+        log.warning("[START] Monitor já ativo | pid_file=%s", PID_FILE)
+        return
+
+    cmd = [
+        sys.executable,
+        "-m",
+        "mtcli_risco.services.run_monitor",
+        str(limite),
+        str(intervalo),
+        str(int(dry_run)),
+    ]
+
+    log.info(
+        "[START] Iniciando monitor | limite=%.2f intervalo=%ss dry_run=%s",
+        limite,
+        intervalo,
+        dry_run,
+    )
+
+    subprocess.Popen(cmd)
+
+    click.echo("Monitor iniciado em background.")

mtcli_risco-2.5.0/mtcli_risco/commands/status.py

@@ -0,0 +1,57 @@
+"""
+Comando status.
+
+Exibe o estado atual do monitor de risco.
+
+O comando verifica:
+
+1. Existência do arquivo PID
+2. Presença do heartbeat
+3. Tempo desde o último heartbeat
+
+Isso permite detectar se o monitor:
+
+- está rodando
+- travou
+- ou foi encerrado.
+"""
+
+import os
+import time
+import click
+
+from mtcli.logger import setup_logger
+from mtcli.conf import PID_FILE, HEARTBEAT_FILE
+
+log = setup_logger("risco")
+
+
+@click.command()
+def status_cmd() -> None:
+    """
+    Exibe o status atual do monitor de risco.
+    """
+
+    if not os.path.exists(PID_FILE):
+        click.echo("Monitor não está rodando.")
+        log.info("[STATUS] Monitor inativo")
+        return
+
+    with open(PID_FILE) as f:
+        pid = f.read().strip()
+
+    if os.path.exists(HEARTBEAT_FILE):
+
+        with open(HEARTBEAT_FILE) as f:
+            ts = float(f.read())
+
+        age = int(time.time() - ts)
+
+        click.echo(f"Monitor ativo (PID {pid})")
+        click.echo(f"Último heartbeat: {age}s")
+
+        log.debug("[STATUS] Monitor ativo | pid=%s heartbeat_age=%ss", pid, age)
+
+    else:
+        click.echo(f"Monitor rodando (PID {pid})")
+        log.warning("[STATUS] PID encontrado sem heartbeat | pid=%s", pid)

mtcli_risco-2.5.0/mtcli_risco/commands/stop.py

@@ -0,0 +1,29 @@
+"""
+Comando stop.
+
+Solicita a parada do monitor de risco.
+
+O comando cria um arquivo de sinal (`STOP_FILE`) que será
+detectado pelo loop de monitoramento, permitindo uma
+finalização controlada do processo.
+"""
+
+import click
+from mtcli.logger import setup_logger
+from mtcli.conf import STOP_FILE
+
+log = setup_logger("risco")
+
+
+@click.command()
+def stop_cmd() -> None:
+    """
+    Envia sinal de parada para o monitor de risco.
+    """
+
+    with open(STOP_FILE, "w") as f:
+        f.write("stop")
+
+    log.info("[STOP] Sinal de parada enviado")
+
+    click.echo("Sinal de parada enviado.")

{mtcli_risco-2.4.1 → mtcli_risco-2.5.0}/mtcli_risco/conf.py

@@ -17,7 +17,7 @@ STATUS_FILE = os.getenv(
 INTERVALO = int(
     os.getenv(
         "INTERVALO",
-        config["DEFAULT"].getint("intervalo", fallback=60),
+        config["DEFAULT"].getint("intervalo", fallback=1),
     )
 )
 

{mtcli_risco-2.4.1 → mtcli_risco-2.5.0}/mtcli_risco/models/checar_model.py

@@ -1,117 +1,117 @@
-"""
-Model de controle de risco.
-
-Responsável por:
-- persistência de estado diário
-- verificação de limite de prejuízo
-- encerramento de posições
-- cancelamento de ordens
-"""
-
-import json
-import os
-from datetime import date
-import MetaTrader5 as mt5
-from mtcli.logger import setup_logger
-from mtcli.mt5_context import mt5_conexao
-from .trades_model import calcular_lucro_total_dia
-
-log = setup_logger()
-
-
-def carregar_estado(status_file: str) -> dict:
-    """
-    Carrega o estado persistido do controle de risco.
-    """
-    if os.path.exists(status_file):
-        with open(status_file, "r") as f:
-            log.info(f"[ESTADO] Carregando {status_file}")
-            return json.load(f)
-    return {"data": "", "bloqueado": False}
-
-
-def salvar_estado(status_file: str, data: date, bloqueado: bool) -> None:
-    """
-    Persiste o estado diário do controle de risco.
-    """
-    with open(status_file, "w") as f:
-        json.dump(
-            {"data": data.isoformat(), "bloqueado": bloqueado},
-            f,
-            indent=2,
-        )
-    log.info(f"[ESTADO] Salvo | data={data.isoformat()} bloqueado={bloqueado}")
-
-
-def encerrar_todas_posicoes() -> None:
-    """
-    Encerra todas as posições abertas no MT5.
-    """
-    with mt5_conexao():
-        positions = mt5.positions_get()
-
-        if not positions:
-            log.info("[MT5] Nenhuma posição aberta.")
-            return
-
-        for pos in positions:
-            tipo_oposto = (
-                mt5.ORDER_TYPE_SELL
-                if pos.type == mt5.ORDER_TYPE_BUY
-                else mt5.ORDER_TYPE_BUY
-            )
-
-            ordem = {
-                "action": mt5.TRADE_ACTION_DEAL,
-                "symbol": pos.symbol,
-                "volume": pos.volume,
-                "type": tipo_oposto,
-                "position": pos.ticket,
-                "deviation": 10,
-                "magic": 1000,
-                "comment": "Fechamento por limite de risco",
-            }
-
-            log.warning(f"[MT5] Encerrando posição {pos.ticket}")
-            resultado = mt5.order_send(ordem)
-
-            if not resultado or resultado.retcode != mt5.TRADE_RETCODE_DONE:
-                log.error(f"[MT5] Falha ao fechar {pos.ticket}: {resultado}")
-            else:
-                log.info(f"[MT5] Posição {pos.ticket} encerrada.")
-
-
-def cancelar_todas_ordens() -> None:
-    """
-    Cancela todas as ordens pendentes.
-    """
-    with mt5_conexao():
-        ordens = mt5.orders_get()
-
-        if not ordens:
-            log.info("[MT5] Nenhuma ordem pendente.")
-            return
-
-        for ordem in ordens:
-            resultado = mt5.order_delete(ordem.ticket)
-            if not resultado or resultado.retcode != mt5.TRADE_RETCODE_DONE:
-                log.error(f"[MT5] Falha ao cancelar ordem {ordem.ticket}")
-            else:
-                log.info(f"[MT5] Ordem {ordem.ticket} cancelada.")
-
-
-def risco_excedido(limite: float) -> bool:
-    """
-    Verifica se o prejuízo diário ultrapassou o limite configurado.
-    """
-    try:
-        total = calcular_lucro_total_dia()
-        if total <= limite:
-            log.warning(
-                f"[RISCO] Excedido | resultado={total:.2f} limite={limite:.2f}"
-            )
-            return True
-        return False
-    except Exception as exc:
-        log.error(f"[RISCO] Erro ao verificar limite: {exc}")
-        return False
+"""
+Model de controle de risco.
+
+Responsável por:
+- persistência de estado diário
+- verificação de limite de prejuízo
+- encerramento de posições
+- cancelamento de ordens
+"""
+
+import json
+import os
+from datetime import date
+import MetaTrader5 as mt5
+from mtcli.logger import setup_logger
+from mtcli.mt5_context import mt5_conexao
+from .trades_model import calcular_lucro_total_dia
+
+log = setup_logger("risco")
+
+
+def carregar_estado(status_file: str) -> dict:
+    """
+    Carrega o estado persistido do controle de risco.
+    """
+    if os.path.exists(status_file):
+        with open(status_file, "r") as f:
+            log.info(f"[ESTADO] Carregando {status_file}")
+            return json.load(f)
+    return {"data": "", "bloqueado": False}
+
+
+def salvar_estado(status_file: str, data: date, bloqueado: bool) -> None:
+    """
+    Persiste o estado diário do controle de risco.
+    """
+    with open(status_file, "w") as f:
+        json.dump(
+            {"data": data.isoformat(), "bloqueado": bloqueado},
+            f,
+            indent=2,
+        )
+    log.info(f"[ESTADO] Salvo | data={data.isoformat()} bloqueado={bloqueado}")
+
+
+def encerrar_todas_posicoes() -> None:
+    """
+    Encerra todas as posições abertas no MT5.
+    """
+    with mt5_conexao():
+        positions = mt5.positions_get()
+
+        if not positions:
+            log.info("[MT5] Nenhuma posição aberta.")
+            return
+
+        for pos in positions:
+            tipo_oposto = (
+                mt5.ORDER_TYPE_SELL
+                if pos.type == mt5.ORDER_TYPE_BUY
+                else mt5.ORDER_TYPE_BUY
+            )
+
+            ordem = {
+                "action": mt5.TRADE_ACTION_DEAL,
+                "symbol": pos.symbol,
+                "volume": pos.volume,
+                "type": tipo_oposto,
+                "position": pos.ticket,
+                "deviation": 10,
+                "magic": 1000,
+                "comment": "Fechamento por limite de risco",
+            }
+
+            log.warning(f"[MT5] Encerrando posição {pos.ticket}")
+            resultado = mt5.order_send(ordem)
+
+            if not resultado or resultado.retcode != mt5.TRADE_RETCODE_DONE:
+                log.error(f"[MT5] Falha ao fechar {pos.ticket}: {resultado}")
+            else:
+                log.info(f"[MT5] Posição {pos.ticket} encerrada.")
+
+
+def cancelar_todas_ordens() -> None:
+    """
+    Cancela todas as ordens pendentes.
+    """
+    with mt5_conexao():
+        ordens = mt5.orders_get()
+
+        if not ordens:
+            log.info("[MT5] Nenhuma ordem pendente.")
+            return
+
+        for ordem in ordens:
+            resultado = mt5.order_delete(ordem.ticket)
+            if not resultado or resultado.retcode != mt5.TRADE_RETCODE_DONE:
+                log.error(f"[MT5] Falha ao cancelar ordem {ordem.ticket}")
+            else:
+                log.info(f"[MT5] Ordem {ordem.ticket} cancelada.")
+
+
+def risco_excedido(limite: float) -> bool:
+    """
+    Verifica se o prejuízo diário ultrapassou o limite configurado.
+    """
+    try:
+        total = calcular_lucro_total_dia()
+        if total <= limite:
+            log.warning(
+                f"[RISCO] Excedido | resultado={total:.2f} limite={limite:.2f}"
+            )
+            return True
+        return False
+    except Exception as exc:
+        log.error(f"[RISCO] Erro ao verificar limite: {exc}")
+        return False

{mtcli_risco-2.4.1 → mtcli_risco-2.5.0}/mtcli_risco/models/hardstop_model.py

@@ -12,7 +12,7 @@ import subprocess
 from mtcli.logger import setup_logger
 from mtcli_risco.conf import MT5_TERMINAL_PATH
 
-log = setup_logger()
+log = setup_logger("risco")
 
 FIREWALL_RULE_NAME = "MT5_HARDSTOP_BLOCK"