consulta-saldo-transurc

Consulte o saldo do seu bilhete único da Transurc via script.

Instruções para começar

Pré-requisitos

O que você precisa pra começar:

• Docker

Primeiro clone esse repositório (ou faça um fork e substitua /bartier pelo seu user do GitHub)

git clone https://github.com/bartier/consulta-saldo-transurc.git

Na raiz do projeto, construa a imagem consulta-saldo-transurc com o Dockerfile

docker build -t consulta-saldo-transurc .

Execução

Usage: main.py [OPTIONS]

  Obtém seu saldo do cartão de bilhete único da Transurc

Options:
  -n, --num-aplicacao TEXT       Número da aplicação só pode assumir os
                                 valores 03, 04, 07 e 11  [required]
  -c, --cartao TEXT              Número do cartão a ser consultado no formato
                                 XXXXXXXX, em que X é um algarismo  [required]
  -d, --digito-verificador TEXT  Digito verificador do cartão  [required]
  -t, --data-nascimento TEXT     Data de nascimento no formato DD/MM/AAAAA
                                 [required]
  -m, --imgur-client-id TEXT     A aplicação utiliza o Imgur para realizar o
                                 upload do captcha com o objetivo de gerar o
                                 link.  [required]
  --headless                     Se a flag é utilizada, o browser é iniciado
                                 no modo headless, isto é, sem interface
                                 gráfica
  -i, --timeout INTEGER          Timeout para esperar a página ser carrega
                                 após enviar o formulário e obter o saldo
  --help                         Show this message and exit.

Para executar o projeto, utilize o comando do docker com os dados de consulta:

Considere X um número qualquer (apenas 1 algarismo), DD o dia do aniversário (2 algarismos obrigatoriamente), MM o mês (2 algarismos obrigatoriamente) e AAAA o ano (4 algarismos obrigatoriamente).

1. Flag -n XX
2. Flag -c XXXXXXXX
3. Flag -d X
4. Flag -t DD/MM/AAAAA
5. Obtido na execução via input do terminal.

docker run -it --rm consulta-saldo-transurc -n XX -c XXXXXXXX -d X -t DD/MM/AAAA -m <imgur_client_id> --headless

#exemplo
docker run -it --rm consulta-saldo-transurc -n 03 -c 00123456 -d 4 -t 01/02/1980 -m 76e1a6fb36efa6f --headless

Execução com interface gráfica

Para executar com uma interface gráfica, basta omitir a flag --headless. No entanto, deverá ser usado o ambiente do host ao invés da imagem do Docker para a execução do script. Nesse sentido, utilize o pipenv para instalar as dependências e executar o script.

Dentro do diretório raiz do projeto, execute:

pipenv install
pipenv shell

python src/main.py -n XX -c XXXXXXXX -d X -t DD/MM/AAAA -m <imgur_client_id>

Contribuição

O projeto foi criado utilizando o Page Object Model pattern. Isso significa que existe uma classe representando a página de consulta BalancePage e ela é utilizada pelo script src/main.py.

Este projeto é open-source. Sinta-se à vontade para contribuir!

Licença

Esse projeto é licenciado através de uma licença MIT - veja o arquivo LICENSE para detalhes.