mtcli 3.4.0.dev0__tar.gz → 3.5.0.dev0__tar.gz

mtcli-3.5.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 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-3.4.0.dev0 → mtcli-3.5.0.dev0}/PKG-INFO

@@ -1,22 +1,26 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: mtcli
-Version: 3.4.0.dev0
-Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 em texto acessível ao leitor de telas
-License: GPL-3.0
-Keywords: MetaTrader 5,trading,CLI
+Version: 3.5.0.dev0
+Summary: Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly
+License-Expression: MIT
+License-File: LICENSE
+Keywords: trading,candlestick,metatrader5,mt5,cli,price-action
 Author: Valmir França da Silva
 Author-email: vfranca3@gmail.com
 Requires-Python: >=3.10,<3.14.0
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Development Status :: 4 - Beta
+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.2.1,<9.0.0)
 Requires-Dist: metatrader5 (>=5.0.5260,<6.0.0)
 Project-URL: Documentation, https://mtcli.readthedocs.io/pt-br/latest
-Project-URL: Homepage, https://pypi.org/project/mtcli
+Project-URL: Homepage, https://github.com:vfranca/mtcli
 Project-URL: Repository, https://github.com/vfranca/mtcli
 Project-URL: issues, https://github.com/vfranca/mtcli/issues
 Description-Content-Type: text/markdown
@@ -165,5 +169,5 @@ GitHub: [@vfranca](https://github.com/vfranca)
   
 ## Licença
   
-Distribuído sob a licença GPL-3.0. Veja `LICENSE` para mais informações.
+Distribuído sob a licença MIT. Veja `LICENSE` para mais informações.
 

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/README.md

@@ -1,145 +1,145 @@
-# mtcli
-  
-*mtcli* é um aplicativo de linha de comando (CLI) acessível para leitura e análise de gráficos do MetaTrader 5, desenvolvido com foco em acessibilidade para usuários com deficiência visual.  
-  
-O projeto é modular e extensível por meio de plugins.
-  
----
-  
-## Instalação
-  
-Você pode instalar o `mtcli` diretamente via *pip*:
-  
-```bash
-pip install mtcli
-```
-  
-Ou diretamente a partir do código-fonte:
-  
-```bash
-git clone https://github.com/vfranca/mtcli.git
-cd mtcli
-pip install .
-```
-  
----
-  
-## Como usar
-  
-Após a instalação, o comando principal é:
-  
-```bash
-mt
-```
-  
-Você verá uma lista de comandos e plugins disponíveis.
-  
-Para executar um plugin específico, use:
-  
-```bash
-mt nome-do-plugin [opções]
-```
-  
-Exemplo com o plugin de média móvel:
-  
-```bash
-mt mm --symbol WIN$N --periodo 14
-```
-  
----
-  
-## Documentação
-  
-A documentação completa está disponível em:
-  
-*https://vfranca.github.io/mtcli*
-  
-Inclui guias de uso, instalação de plugins, exemplos e estrutura do projeto.
-  
----
-  
-## Como contribuir
-  
-Contribuições são bem-vindas!
-  
-Clonar o repositório
-  
-```bash
-git clone https://github.com/vfranca/mtcli.git
-cd mtcli
-```
-  
-Instalar dependências para desenvolvimento
-  
-```bash
-pip install -e ".[dev]"
-```
-Rodar os testes
-  
-```bash
-pymake test
-```
-  
-Estilo de código
-  
-- `black` para formatação
-- `isort` para ordenação de imports
-- `pydocstyle` para formatação de docstrings
-- `ruff` e `mypy` para linting e verificação estática
-  
----
-  
-## Criando plugins para o mtcli
-  
-Plugins permitem estender a funcionalidade do `mtcli`.
-  
-Estrutura básica de um plugin
-  
-```toml
-pyproject.toml
-[project.entry-points."mtcli.plugins"]
-nome_do_plugin = "modulo.caminho:funcao_principal"
-```
-  
-Exemplo
-  
-```toml
-[project.entry-points."mtcli.plugins"]
-volume_medio = "mtcli.plugins.volume_medio:vm"
-```
-  
-No código Python:
-  
-```python
-
-def vm():
-    print("Plugin de volume médio executado.")
-```
-  
-Como empacotar
-  
-Crie um projeto separado com sua lógica e registre o plugin no `pyproject.toml` ou `setup.py` como acima.
-  
-Depois, instale com:
-  
-```bash
-pip install .
-```
-  
-O `mtcli` reconhecerá o plugin automaticamente.
-  
----
-  
-## Contato
-  
-Autor: *Valmir França da Silva*  
-  
-Email: vfranca3@gmail.com  
-  
-GitHub: [@vfranca](https://github.com/vfranca)
-  
----
-  
-## Licença
-  
-Distribuído sob a licença GPL-3.0. Veja `LICENSE` para mais informações.
+# mtcli
+  
+*mtcli* é um aplicativo de linha de comando (CLI) acessível para leitura e análise de gráficos do MetaTrader 5, desenvolvido com foco em acessibilidade para usuários com deficiência visual.  
+  
+O projeto é modular e extensível por meio de plugins.
+  
+---
+  
+## Instalação
+  
+Você pode instalar o `mtcli` diretamente via *pip*:
+  
+```bash
+pip install mtcli
+```
+  
+Ou diretamente a partir do código-fonte:
+  
+```bash
+git clone https://github.com/vfranca/mtcli.git
+cd mtcli
+pip install .
+```
+  
+---
+  
+## Como usar
+  
+Após a instalação, o comando principal é:
+  
+```bash
+mt
+```
+  
+Você verá uma lista de comandos e plugins disponíveis.
+  
+Para executar um plugin específico, use:
+  
+```bash
+mt nome-do-plugin [opções]
+```
+  
+Exemplo com o plugin de média móvel:
+  
+```bash
+mt mm --symbol WIN$N --periodo 14
+```
+  
+---
+  
+## Documentação
+  
+A documentação completa está disponível em:
+  
+*https://vfranca.github.io/mtcli*
+  
+Inclui guias de uso, instalação de plugins, exemplos e estrutura do projeto.
+  
+---
+  
+## Como contribuir
+  
+Contribuições são bem-vindas!
+  
+Clonar o repositório
+  
+```bash
+git clone https://github.com/vfranca/mtcli.git
+cd mtcli
+```
+  
+Instalar dependências para desenvolvimento
+  
+```bash
+pip install -e ".[dev]"
+```
+Rodar os testes
+  
+```bash
+pymake test
+```
+  
+Estilo de código
+  
+- `black` para formatação
+- `isort` para ordenação de imports
+- `pydocstyle` para formatação de docstrings
+- `ruff` e `mypy` para linting e verificação estática
+  
+---
+  
+## Criando plugins para o mtcli
+  
+Plugins permitem estender a funcionalidade do `mtcli`.
+  
+Estrutura básica de um plugin
+  
+```toml
+pyproject.toml
+[project.entry-points."mtcli.plugins"]
+nome_do_plugin = "modulo.caminho:funcao_principal"
+```
+  
+Exemplo
+  
+```toml
+[project.entry-points."mtcli.plugins"]
+volume_medio = "mtcli.plugins.volume_medio:vm"
+```
+  
+No código Python:
+  
+```python
+
+def vm():
+    print("Plugin de volume médio executado.")
+```
+  
+Como empacotar
+  
+Crie um projeto separado com sua lógica e registre o plugin no `pyproject.toml` ou `setup.py` como acima.
+  
+Depois, instale com:
+  
+```bash
+pip install .
+```
+  
+O `mtcli` reconhecerá o plugin automaticamente.
+  
+---
+  
+## Contato
+  
+Autor: *Valmir França da Silva*  
+  
+Email: vfranca3@gmail.com  
+  
+GitHub: [@vfranca](https://github.com/vfranca)
+  
+---
+  
+## Licença
+  
+Distribuído sob a licença MIT. Veja `LICENSE` para mais informações.

mtcli-3.5.0.dev0/mtcli/database.py

@@ -0,0 +1,54 @@
+"""
+Database core para mtcli.
+
+Responsável por:
+- Criar conexão SQLite
+- Ativar WAL
+- Garantir schema
+"""
+
+import sqlite3
+from pathlib import Path
+
+
+DB_PATH = Path.home() / ".mtcli" / "marketdata.db"
+
+
+def get_connection():
+    """
+    Retorna conexão SQLite configurada.
+    """
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+
+    conn = sqlite3.connect(DB_PATH)
+    conn.execute("PRAGMA journal_mode=WAL;")
+    conn.execute("PRAGMA synchronous=NORMAL;")
+
+    _ensure_schema(conn)
+    return conn
+
+
+def _ensure_schema(conn):
+    conn.execute(
+        """
+        CREATE TABLE IF NOT EXISTS ticks (
+            symbol TEXT NOT NULL,
+            time INTEGER NOT NULL,
+            bid REAL,
+            ask REAL,
+            last REAL,
+            volume REAL,
+            flags INTEGER,
+            PRIMARY KEY (symbol, time)
+        );
+        """
+    )
+
+    conn.execute(
+        """
+        CREATE INDEX IF NOT EXISTS idx_ticks_symbol_time
+        ON ticks(symbol, time);
+        """
+    )
+
+    conn.commit()

mtcli-3.5.0.dev0/mtcli/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-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/logger.py

@@ -1,47 +1,47 @@
-import logging
-from logging.handlers import RotatingFileHandler
-import os
-
-
-base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
-LOG_DIR = os.path.join(base_dir, "mtcli", "logs")
-os.makedirs(LOG_DIR, exist_ok=True)
-LOG_FILE = os.path.join(LOG_DIR, "mtcli.log")
-
-
-def setup_logger(name: str = "mtcli") -> logging.Logger:
-    """Configura logger rotativo com saída em arquivo e console.
-
-    - Escreve logs em ~/.mtcli/mtcli.log (máx. 2 MB, 3 backups).
-    - Mostra logs também no console (stdout), capturáveis via pytest/caplog.
-    - Evita duplicar handlers.
-    """
-
-    logger = logging.getLogger(name)
-    logger.setLevel(logging.DEBUG)
-
-    formatter = logging.Formatter(
-        "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
-        datefmt="%Y-%m-%d %H:%M:%S",
-    )
-
-    # === File handler rotativo ===
-    if not any(isinstance(h, RotatingFileHandler) for h in logger.handlers):
-        file_handler = RotatingFileHandler(LOG_FILE, maxBytes=2_000_000, backupCount=3)
-        file_handler.setFormatter(formatter)
-        logger.addHandler(file_handler)
-
-    # === Stream handler (console) ===
-    if not any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
-        console_handler = logging.StreamHandler()
-        console_handler.setFormatter(formatter)
-        logger.addHandler(console_handler)
-
-    # Permite que pytest caplog capture logs
-    logger.propagate = True
-
-    return logger
-
-
-# Inicializa logger padrão
-log = setup_logger()
+import logging
+from logging.handlers import RotatingFileHandler
+import os
+
+
+base_dir = os.getenv("APPDATA", os.path.expanduser("~"))
+LOG_DIR = os.path.join(base_dir, "mtcli", "logs")
+os.makedirs(LOG_DIR, exist_ok=True)
+LOG_FILE = os.path.join(LOG_DIR, "mtcli.log")
+
+
+def setup_logger(name: str = "mtcli") -> logging.Logger:
+    """Configura logger rotativo com saída em arquivo e console.
+
+    - Escreve logs em ~/.mtcli/mtcli.log (máx. 2 MB, 3 backups).
+    - Mostra logs também no console (stdout), capturáveis via pytest/caplog.
+    - Evita duplicar handlers.
+    """
+
+    logger = logging.getLogger(name)
+    logger.setLevel(logging.DEBUG)
+
+    formatter = logging.Formatter(
+        "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+    # === File handler rotativo ===
+    if not any(isinstance(h, RotatingFileHandler) for h in logger.handlers):
+        file_handler = RotatingFileHandler(LOG_FILE, maxBytes=2_000_000, backupCount=3)
+        file_handler.setFormatter(formatter)
+        logger.addHandler(file_handler)
+
+    # === Stream handler (console) ===
+    if not any(isinstance(h, logging.StreamHandler) for h in logger.handlers):
+        console_handler = logging.StreamHandler()
+        console_handler.setFormatter(formatter)
+        logger.addHandler(console_handler)
+
+    # Permite que pytest caplog capture logs
+    logger.propagate = True
+
+    return logger
+
+
+# Inicializa logger padrão
+log = setup_logger()

mtcli-3.5.0.dev0/mtcli/marketdata/tick_cache.py

@@ -0,0 +1,24 @@
+"""
+Cache de ticks em memória.
+"""
+
+from collections import deque
+
+
+class TickCache:
+    """
+    Mantém janela recente de ticks em memória.
+    """
+
+    def __init__(self, max_size=10000):
+        self.buffer = deque(maxlen=max_size)
+
+    def add_many(self, ticks):
+        for t in ticks:
+            self.buffer.append(t)
+
+    def get_all(self):
+        return list(self.buffer)
+
+    def clear(self):
+        self.buffer.clear()

mtcli-3.5.0.dev0/mtcli/marketdata/tick_repository.py

@@ -0,0 +1,116 @@
+"""
+TickRepository centralizado.
+
+Responsável por:
+- Sincronizar com MT5
+- Persistir ticks
+- Fornecer ticks para modelos
+"""
+
+import MetaTrader5 as mt5
+from datetime import datetime, timedelta
+
+from ..database import get_connection
+from .tick_cache import TickCache
+
+
+class TickRepository:
+
+    def __init__(self):
+        self.conn = get_connection()
+        self.cache = TickCache()
+
+    # =========================
+    # SINCRONIZAÇÃO INCREMENTAL
+    # =========================
+
+    def sync(self, symbol: str, days_back: int = 1):
+        """
+        Sincroniza banco com MT5.
+
+        Busca apenas ticks após o último armazenado.
+        """
+
+        last_time = self._get_last_tick_time(symbol)
+
+        if last_time:
+            start = datetime.fromtimestamp(last_time)
+        else:
+            start = datetime.now() - timedelta(days=days_back)
+
+        ticks = mt5.copy_ticks_from(
+            symbol,
+            start,
+            100000,
+            mt5.COPY_TICKS_ALL,
+        )
+
+        if ticks is None or len(ticks) == 0:
+            return 0
+
+        inserted = self._insert_ticks(symbol, ticks)
+        self.cache.add_many(ticks)
+
+        return inserted
+
+    # =========================
+    # INSERÇÃO
+    # =========================
+
+    def _insert_ticks(self, symbol, ticks):
+        cursor = self.conn.cursor()
+
+        data = [
+            (
+                symbol,
+                int(t.time),
+                float(t.bid),
+                float(t.ask),
+                float(t.last),
+                float(t.volume),
+                int(t.flags),
+            )
+            for t in ticks
+        ]
+
+        cursor.executemany(
+            """
+            INSERT OR IGNORE INTO ticks
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+            """,
+            data,
+        )
+
+        self.conn.commit()
+        return cursor.rowcount
+
+    # =========================
+    # CONSULTAS
+    # =========================
+
+    def get_ticks_between(self, symbol, start_ts, end_ts):
+        cursor = self.conn.cursor()
+        cursor.execute(
+            """
+            SELECT time, bid, ask, last, volume, flags
+            FROM ticks
+            WHERE symbol = ?
+            AND time BETWEEN ? AND ?
+            ORDER BY time ASC
+            """,
+            (symbol, start_ts, end_ts),
+        )
+        return cursor.fetchall()
+
+    def _get_last_tick_time(self, symbol):
+        cursor = self.conn.cursor()
+        cursor.execute(
+            """
+            SELECT MAX(time)
+            FROM ticks
+            WHERE symbol = ?
+            """,
+            (symbol,),
+        )
+        result = cursor.fetchone()
+        return result[0] if result and result[0] else None

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/mt.py

@@ -11,7 +11,7 @@ except ImportError:
 @click.group(context_settings={"max_content_width": 120})
 @click.version_option(package_name="mtcli")
 def mt():
-    """Exibe o grafico do MetaTrader 5 em texto."""
+    """Exibe o grafico candlestick screen reader friendly."""
     pass
 
 

mtcli-3.5.0.dev0/mtcli/mt5_context.py

@@ -0,0 +1,62 @@
+"""
+Gerencia o ciclo de conexão com o MetaTrader 5.
+Fornece o contexto 'mt5_conexao' para uso seguro em blocos with.
+"""
+
+from contextlib import contextmanager
+import MetaTrader5 as mt5
+from mtcli.logger import setup_logger
+
+log = setup_logger()
+
+
+@contextmanager
+def mt5_conexao(login: int | None = None, password: str | None = None, server: str | None = None):
+    """
+    Context manager para conexão direta com o MetaTrader 5.
+
+    Parâmetros opcionais:
+        - login (int): número da conta MT5.
+        - password (str): senha da conta.
+        - server (str): nome do servidor.
+
+    Uso:
+        >>> with mt5_conexao(login=123456, password="senha", server="ClearInvestimentos-Real"):
+        ...     info = mt5.account_info()
+        ...     print(info)
+
+    Comportamento:
+        - Se as credenciais forem fornecidas, tenta autenticar a conta.
+        - Caso contrário, conecta-se à sessão já ativa do terminal MT5.
+        - Garante encerramento seguro da conexão.
+    """
+    try:
+        log.info("Inicializando conexão com MetaTrader 5 via API oficial...")
+
+        if login and password and server:
+            if not mt5.initialize(login=login, password=password, server=server):
+                error = mt5.last_error()
+                log.error(f"Falha ao conectar ao MetaTrader 5: {error}")
+                raise RuntimeError(f"Erro ao conectar ao MT5: {error}")
+            else:
+                log.info(f"Conectado à conta MT5 {login} ({server}).")
+        else:
+            if not mt5.initialize():
+                error = mt5.last_error()
+                log.error(f"Falha ao inicializar MetaTrader 5: {error}")
+                raise RuntimeError(f"Erro ao conectar ao MT5: {error}")
+            else:
+                log.info("Conectado à sessão ativa do MetaTrader 5.")
+
+        yield
+
+    except Exception as e:
+        log.error(f"Erro durante o uso da conexão MT5: {e}")
+        raise
+
+    finally:
+        try:
+            mt5.shutdown()
+            log.info("Conexão com MetaTrader 5 encerrada com sucesso.")
+        except Exception as e:
+            log.error(f"Erro ao encerrar conexão MT5: {e}")

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/plugins/media_movel/__init__.py

@@ -1,3 +1,3 @@
-from . import command, conf
-from .command import mm
-from .models.model_media_movel import MediaMovelModel
+from . import command, conf
+from .command import mm
+from .models.model_media_movel import MediaMovelModel

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/plugins/media_movel/conf.py

@@ -1,4 +1,4 @@
-from mtcli.conf import *
-
-periodos = 14
-limite_linhas = 5
+from mtcli.conf import *
+
+periodos = 14
+limite_linhas = 5

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/plugins/media_movel/models/__init__.py

@@ -1 +1 @@
-from . import model_media_movel
+from . import model_media_movel

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/plugins/media_movel/tests/test_mm.py

@@ -1,13 +1,13 @@
-from click.testing import CliRunner
-
-from mtcli.mt import mt
-
-run = CliRunner()
-
-
-def test_exibe_a_media_movel_simples():
-    res = run.invoke(
-        mt, ["mm", "BBDC4", "--period", "D1", "--periodos", "20", "--limit", "1"]
-    )
-    assert res.output == "11.98    2025.02.27 00:00:00\n"
-    assert res.exit_code == 0
+from click.testing import CliRunner
+
+from mtcli.mt import mt
+
+run = CliRunner()
+
+
+def test_exibe_a_media_movel_simples():
+    res = run.invoke(
+        mt, ["mm", "BBDC4", "--period", "D1", "--periodos", "20", "--limit", "1"]
+    )
+    assert res.output == "11.98    2025.02.27 00:00:00\n"
+    assert res.exit_code == 0

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/plugins/media_movel/tests/test_model_media_movel.py

@@ -1,9 +1,9 @@
-from ..models.model_media_movel import MediaMovelModel
-
-
-def test_sma():
-    assert MediaMovelModel([10, 20, 30], 3).calcula_sma() == [20.0]
-
-
-def test_ema():
-    assert MediaMovelModel([10, 20, 30], 3).calcula_ema() == [20.0]
+from ..models.model_media_movel import MediaMovelModel
+
+
+def test_sma():
+    assert MediaMovelModel([10, 20, 30], 3).calcula_sma() == [20.0]
+
+
+def test_ema():
+    assert MediaMovelModel([10, 20, 30], 3).calcula_ema() == [20.0]

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/mtcli/plugins/volume_medio/__init__.py

@@ -1,3 +1,3 @@
-from . import command, conf
-from .command import vm
-from .models import model_average_volume
+from . import command, conf
+from .command import vm
+from .models import model_average_volume

{mtcli-3.4.0.dev0 → mtcli-3.5.0.dev0}/pyproject.toml

@@ -1,21 +1,43 @@
 [project]
 name = "mtcli"
-version = "3.4.0.dev0"
-description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 em texto acessível ao leitor de telas"
+version = "3.5.0.dev0"
+description = "Aplicativo CLI para exibir gráficos do MetaTrader 5 screen reader friendly"
 authors = [
     {name = "Valmir França da Silva",email = "vfranca3@gmail.com"}
 ]
-license = "GPL-3.0"
+license = "MIT"
+license-files = ["LICENSE"]
 readme = "README.md"
-keywords = ["MetaTrader 5", "trading", "CLI"]
 requires-python = ">=3.10,<3.14.0"
+
+keywords = [
+    "trading",
+    "candlestick",
+    "metatrader5",
+    "mt5",
+    "cli",
+    "price-action"
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "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 = [
     "click (>=8.2.1,<9.0.0)",
     "metatrader5 (>=5.0.5260,<6.0.0)",
 ]
 
 [project.urls]
-homepage = "https://pypi.org/project/mtcli"
+homepage = "https://github.com:vfranca/mtcli"
 repository = "https://github.com/vfranca/mtcli"
 documentation = "https://mtcli.readthedocs.io/pt-br/latest"
 issues = "https://github.com/vfranca/mtcli/issues"

mtcli-3.4.0.dev0/LICENSE

@@ -1,17 +0,0 @@
-GNU GENERAL PUBLIC LICENSE
-Version 3, 29 June 2007
-
-Copyright (C) 2025 Valmir França da Silva
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program.  If not, see <https://www.gnu.org/licenses/>.

mtcli-3.4.0.dev0/mtcli/mt5_context.py

@@ -1,36 +0,0 @@
-"""
-Gerencia o ciclo de conexão com o MetaTrader 5.
-Fornece o contexto 'mt5_conexao' para uso seguro em blocos with.
-"""
-
-from contextlib import contextmanager
-import MetaTrader5 as mt5
-from mtcli.logger import setup_logger
-
-log = setup_logger()
-
-
-@contextmanager
-def mt5_conexao():
-    """
-    Context manager para conexão direta com o MetaTrader 5.
-    - Chama `mt5.initialize()` ao entrar no contexto.
-    - Chama `mt5.shutdown()` ao sair.
-    - Loga falhas e garante fechamento seguro.
-    """
-    try:
-        log.info("Inicializando conexão com MetaTrader 5 via API oficial...")
-        if not mt5.initialize():
-            error = mt5.last_error()
-            log.error(f"Falha ao inicializar MetaTrader 5: {error}")
-            raise RuntimeError(f"Erro ao conectar ao MT5: {error}")
-        yield
-    except Exception as e:
-        log.error(f"Erro durante o uso da conexão MT5: {e}")
-        raise
-    finally:
-        try:
-            mt5.shutdown()
-            log.info("Conexão com MetaTrader 5 encerrada com sucesso.")
-        except Exception as e:
-            log.error(f"Erro ao encerrar conexão MT5: {e}")