Metadata-Version: 2.4
Name: mtcli
Version: 3.7.3.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
Author-email: vfranca3@gmail.com
Requires-Python: >=3.10,<3.14.0
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://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

# 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.

