Skip to main content

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:

pip install mtcli

Ou diretamente a partir do código-fonte:

git clone https://github.com/vfranca/mtcli.git
cd mtcli
pip install .

Como usar

Após a instalação, o comando principal é:

mt

Você verá uma lista de comandos e plugins disponíveis.

Para executar um plugin específico, use:

mt nome-do-plugin [opções]

Exemplo com o plugin de média móvel:

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

git clone https://github.com/vfranca/mtcli.git
cd mtcli

Instalar dependências para desenvolvimento

pip install -e ".[dev]"

Rodar os testes

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

pyproject.toml
[project.entry-points."mtcli.plugins"]
nome_do_plugin = "modulo.caminho:funcao_principal"

Exemplo

[project.entry-points."mtcli.plugins"]
volume_medio = "mtcli.plugins.volume_medio:vm"

No código 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:

pip install .

O mtcli reconhecerá o plugin automaticamente.


Contato

Autor: Valmir França da Silva

Email: vfranca3@gmail.com

GitHub: @vfranca


Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mtcli-3.7.4.tar.gz (24.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mtcli-3.7.4-py3-none-any.whl (43.8 kB view details)

Uploaded Python 3

File details

Details for the file mtcli-3.7.4.tar.gz.

File metadata

  • Download URL: mtcli-3.7.4.tar.gz
  • Upload date:
  • Size: 24.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.13.12 Windows/11

File hashes

Hashes for mtcli-3.7.4.tar.gz
Algorithm Hash digest
SHA256 c48cd1dd2fac380d6c8bed608fa90d9e488fcf3e2e2b614e17a97054a7977710
MD5 f305ac86d8d29e83b1a9ff0bbc9f08eb
BLAKE2b-256 ee2c5611a5351f951030ac774b46bb5e86aacadc26b137dc379c63be469d48d8

See more details on using hashes here.

File details

Details for the file mtcli-3.7.4-py3-none-any.whl.

File metadata

  • Download URL: mtcli-3.7.4-py3-none-any.whl
  • Upload date:
  • Size: 43.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.2.1 CPython/3.13.12 Windows/11

File hashes

Hashes for mtcli-3.7.4-py3-none-any.whl
Algorithm Hash digest
SHA256 d5ce6d0c9f32f8a384085a998296b2131e7d76695c0bc1e9fe289138f1b36dd3
MD5 d823845fc7d29f3ea1236f3142ffba6c
BLAKE2b-256 58f4974388f8bac444d3bab068106fa0d9164df4795fda78e85e8a97e2af59f6

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

3.7.4 This release

2 files

3.7.3

2 files

3.7.2

2 files

3.7.1

2 files

3.7.0

2 files

3.6.1

2 files

3.6.0

2 files

3.5.1

2 files

3.5.0

2 files

3.4.0

2 files

3.3.0

2 files

3.2.1

2 files

3.2.0

2 files

3.1.0

2 files

3.0.0

2 files

2.6.1

2 files

2.6.0

2 files

2.5.0

2 files

2.4.0

2 files

2.3.0

2 files

2.2.0

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.0

2 files

1.20.1

2 files

1.20.0

2 files

1.19.4

2 files

1.19.3

2 files

1.19.2

2 files

1.19.1

2 files

1.19.0

2 files

1.18.3

2 files

1.18.2

2 files

1.18.1

2 files

1.18.0

2 files

1.17.0

2 files

1.16.0

2 files

1.15.0

2 files

1.14.6

2 files

1.14.5

2 files

1.14.4

2 files

1.14.3

2 files

1.14.2

2 files

1.14.1

2 files

1.14.0

2 files

1.13.0

2 files

1.12.3

2 files

1.12.2

2 files

1.12.1

2 files

1.12.0

2 files

1.11.0

2 files

1.10.1

2 files

1.10.0

2 files

1.9.1

2 files

1.9.0

2 files

1.8.1

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.1

2 files

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.1

2 files

1.1.0

2 files

1.0.0

2 files

0.32.0

2 files

0.31.2

2 files

0.31.1

2 files

0.31.0

2 files

0.30.0

2 files

0.29.1

2 files

0.29.0

2 files

0.28.2

2 files

0.28.1

2 files

0.28.0

2 files

0.27.8

2 files

0.27.7

2 files

0.27.6

2 files

0.27.5

2 files

0.27.4

2 files

0.27.3

2 files

0.27.2

2 files

0.27.1

2 files

0.27

2 files

0.26

2 files

0.25.0

2 files

0.24.0

2 files

0.23.0

2 files

0.22.2

2 files

0.22.1

2 files

0.22

2 files

0.21.1

2 files

0.21

2 files

0.20.1

2 files

0.20

2 files

0.19

2 files

0.18

2 files

0.17.2

2 files

0.17.1

2 files

0.17

2 files

0.16

2 files

0.15

2 files

0.14

2 files

0.13.1

2 files

0.13.0

2 files

0.12.0

2 files

0.11.0

2 files

0.10.1

2 files

0.10.0

2 files

0.9.0

2 files

0.8.1

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.7

2 files

0.4.6

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page