Metadata-Version: 2.3
Name: mtcli-volume
Version: 1.3.0
Summary: Plugin mtcli para exibir o volume profile
Author: Valmir França da Silva
Author-email: vfranca3@gmail.com
Requires-Python: >=3.10,<3.14.0
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
Requires-Dist: mtcli (>=1.18.1)
Project-URL: Documentation, https://mtcli-volume.readthedocs.io
Project-URL: Homepage, https://github.com/vfranca/mtcli-volume
Project-URL: Repository, https://github.com/vfranca/mtcli-volume
Project-URL: issues, https://github.com/vfranca/mtcli-volume/issues
Description-Content-Type: text/markdown

Claro! Aqui está o README.md do plugin mtcli-volume, já atualizado com a nova opção --sem-barras:

---

markdown
mtcli-volume

Plugin para exibir o *Volume Profile* no terminal, com suporte a *acessibilidade total* para leitores de tela. Ideal para traders cegos, com baixa visão ou que preferem trabalhar no terminal.

O que é?

O `mtcli-volume` integra-se ao [mtcli](https://github.com/vfranca/mtcli) e mostra a distribuição de volume por faixas de preço (Volume Profile), incluindo:

- *POC (Ponto de Controle)* — faixa com maior volume.
- *VA (Área de Valor)* — onde ocorre cerca de 70% do volume.
- *HVNs e LVNs* — regiões de alto/baixo volume.
- Saída 100% textual.
- Compatível com leitores como NVDA, Orca, VoiceOver.

---

Exemplo de uso

bash
mt volume --symbol WINV25 --periods 566 --step 100


Saída típica:


Volume Profile WINV25

 117400 |   2100 ██████████████████████
 117200 |    850 █████████
 117000 |    420 ████
 116800 |    120 █
 116600 |     60 

POC (Preço de Maior Volume): 117400
Área de Valor: 117200 a 117600
HVNs: [117400, 117200]
LVNs: [116600]


---

Modo acessível: sem barras

Use `--sem-barras` para desativar a visualização com caracteres de barra (`█`), ideal para leitores de tela:

bash
mt volume --symbol WINV25 --sem-barras
```
Saída:


Volume Profile WINV25

 117400 |   2100
 117200 |    850
 117000 |    420
...

POC (Preço de Maior Volume): 117400
Área de Valor: 117200 a 117600


---

Exportar para CSV

bash
mt volume --symbol WINV25 --exporta-csv


Cria um arquivo como:


volume_profile_WINV25_20250914_1130.csv


---

Instalação

bash
pip install mtcli-volume


No plugins.conf:

ini
[volume]
path = plugins/mtcli-volume
enabled = true


---

Repositórios relacionados

- Plugin: [vfranca/mtcli-volume](https://github.com/vfranca/mtcli-volume)
- Base: [vfranca/mtcli](https://github.com/vfranca/mtcli)
- Exemplo: [vfranca/plugin-exemplo](https://github.com/vfranca/plugin-exemplo)

---

Contribua

Sinta-se à vontade para abrir issues, pull requests, ou sugerir novas funcionalidades relacionadas à acessibilidade e análise técnica via terminal.
```

---

Se quiser, posso também atualizar o setup.py com metadados mais claros para PyPI. Deseja isso também?

