mtcli 4.0.0.dev0__tar.gz → 4.0.0.dev1__tar.gz

mtcli-4.0.0.dev1/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-4.0.0.dev0 → mtcli-4.0.0.dev1}/PKG-INFO

@@ -1,22 +1,27 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: mtcli
-Version: 4.0.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
-Author: Valmir França da Silva
+Version: 4.0.0.dev1
+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
 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 :: 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.2.1,<9.0.0)
 Requires-Dist: metatrader5 (>=5.0.5260,<6.0.0)
+Requires-Dist: tzdata (>=2025.3,<2026.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 +170,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-4.0.0.dev0 → mtcli-4.0.0.dev1}/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-4.0.0.dev1/mtcli/__main__.py

@@ -0,0 +1,3 @@
+from .cli import mt
+
+mt()

mtcli-4.0.0.dev1/mtcli/cli.py

@@ -0,0 +1,51 @@
+"""
+CLI principal do mtcli.
+"""
+
+import os
+import click
+from .plugin_loader import load_plugins
+from .logger import setup_logger
+
+from .commands.bars import bars
+from .commands.doctor import doctor
+
+logger = setup_logger(__name__)
+
+
+@click.group(context_settings={"max_content_width": 120}, invoke_without_command=True)
+@click.version_option(package_name="mtcli")
+@click.pass_context
+def mt(ctx):
+    """
+    CLI principal do mtcli.
+    """
+
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+mt.add_command(doctor, name="doctor")
+mt.add_command(bars, name="bars")
+
+loaded_plugins = load_plugins(mt)
+logger.info("Plugins carregados: %s", loaded_plugins)
+
+
+@mt.command(name="plugins")
+def list_plugins():
+    """
+    Lista os plugins carregados no mtcli.
+    """
+
+    if not loaded_plugins:
+        click.echo("Nenhum plugin carregado.")
+        return
+
+    click.echo("Plugins carregados:\n")
+    for name in loaded_plugins:
+        click.echo(f"  {name}")
+
+
+if __name__ == "__main__":
+    mt()

mtcli-4.0.0.dev1/mtcli/commands/bars.py

@@ -0,0 +1,75 @@
+"""
+Comando CLI `bars`.
+
+Responsável por:
+- receber parâmetros via terminal (Click)
+- instanciar a fonte de dados
+- delegar execução ao BarsController
+- imprimir saída no terminal
+
+Este comando é a camada de entrada (CLI) no padrão MVC do mtcli.
+"""
+
+import click
+
+from ..controllers.bars_controller import BarsController
+from ..conf import (
+    DATA_SOURCE_NAME,
+    SYMBOL,
+    TIMEFRAME,
+    MAX_BARS,
+    VIEW,
+    VOLUME_TYPE,
+)
+from ..data.factory import create_data_source
+
+
+@click.command()
+@click.option("--symbol", "-s", default=SYMBOL, show_default=True, help="Código do ativo (ex: WINM26)")
+@click.option("--timeframe", "-t", "period", default=TIMEFRAME, show_default=True, help="Timeframe (ex: M1, M5, D1)")
+@click.option("--max-bars", "-mb", "count", default=MAX_BARS, show_default=True, help="Quantidade de barras")
+@click.option("--view", "-v", default=VIEW, show_default=True, help="Formato da view (hl_view, full_view, etc)")
+@click.option("--date", "-d", default=None, show_default=True, help="Filtrar pregão (YYYY-MM-DD)")
+@click.option("--numerator", "-n", is_flag=True, show_default=True, help="Numerar barras")
+@click.option("--show-date", "-sd", is_flag=True, show_default=True, help="Exibir data/hora")
+@click.option("--volume-type", "-vt", "volume", default=VOLUME_TYPE, show_default=True, help="Tipo de volume (tick/real)")
+@click.option("--data-source", "-ds", "source", default=None, show_default=True, help="Fonte de dados (mt5/csv)")
+def bars(symbol, period, count, view, date, numerator, show_date, volume, source):
+    """
+    Executa o comando `bars`.
+
+    Fluxo:
+    1. Resolve fonte de dados
+    2. Executa controller
+    3. Renderiza saída linha a linha
+
+    Args:
+        symbol (str): Ativo
+        period (str): Timeframe
+        count (int): Quantidade de barras
+        view (str): Nome da view
+        date (str | None): Filtro de pregão
+        numerator (bool): Numerar barras
+        show_date (bool): Mostrar timestamp
+        volume (str | None): Tipo de volume
+        source (str | None): Fonte de dados
+    """
+
+    source_name = source or DATA_SOURCE_NAME
+    data_source = create_data_source(source_name)
+
+    controller = BarsController(data_source)
+
+    lines = controller.execute(
+        symbol=symbol,
+        period=period,
+        count=count,
+        date=date,
+        view=view,
+        numerator=numerator,
+        show_date=show_date,
+        volume=volume,
+    )
+
+    for line in lines:
+        click.echo(line)

mtcli-4.0.0.dev1/mtcli/commands/conf.py

@@ -0,0 +1,44 @@
+"""
+Comando para exibir configurações disponíveis.
+"""
+
+import click
+
+from mtcli.config_registry import registry
+from mtcli.conf import conf
+
+
+@click.command()
+@click.argument("section", required=False)
+def conf_cmd(section):
+    """
+    Exibe configurações disponíveis.
+
+    Exemplos:
+
+        mt conf
+        mt conf renko
+    """
+
+    if section:
+        options = registry.get_section(section)
+    else:
+        options = registry.get_all()
+
+    if not options:
+        click.echo("Nenhuma configuração registrada.")
+        return
+
+    for opt in options:
+
+        value = conf.get(opt.name, section=opt.section, default=opt.default)
+
+        click.echo(
+            f"{opt.section}.{opt.name} = {value} "
+            f"(default={opt.default})"
+        )
+
+        if opt.description:
+            click.echo(f"  {opt.description}")
+
+        click.echo()