Desenvolvimento¶

Preparando o ambiente¶

Primeiramente, baixe os arquivos do repositório e coloque-os em uma pasta da sua escolha.

Crie um ambiente virtual com Python:

python -m venv venv

Entre no ambiente virtual:

./venv/Scripts/activate

Instale todas as dependências:

pip install -r requirements.txt

Tudo pronto!

Entendendo os arquivos¶

requirements.txt: Arquivo que contém todas as dependências do projeto, deve ser atualizado com o seguinte comando sempre que houver alguma mudança de bibliotecas.

pip freeze > requirements.txt

conf_.py: Determina algumas variáveis globais, como o caminho de download e os dados necessários para a API do Telegram.

client_bot.py: Bot local dos clientes, cuja função é baixar o código principal da nuvem e executá-lo. Um ponto importante é a existência da verificação de um hash ao iniciar o programa, o que previne alguma pirataria.

main.py: Bot principal utilizado para o download dos episódios, com diversos planos e comunicação com o Telegram.

*.spec: Arquivos utilizados pelo pyinstaller para a geração de executáveis.

tests/test_bot.py: Arquivo que contém os testes automatizados para verificar o comportamento correto do bot.

Testando as modificações¶

Caso adicione ou retire um método do main.py, é necessário atualizar o arquivo de testes com essa modificação.

O comando para iniciar os testes automatizados é:

python -m pytest

Criando um novo executável¶

Para a criação de um novo executável, rode o comando a seguir, substituindo o asterisco pelo nome do arquivo modificado (main ou client_bot):

pyinstaller *.spec

Instalação bot da Voz do Brasil em clientes¶

Pré-requisitos¶

É necessário verificar a versão do Windows do cliente, se é 32 bits ou 64 bits, e baixar a versão correspondente do bot, que se encontra na aba de Arquivos.

Instalação¶

Primeiramente, cria uma unidade de rede que mapeie a pasta correta onde será baixado o arquivo (isso irá facilitar o trabalho em algumas etapas);
Já na máquina do cliente, criar uma pasta em Documentos, chamada Bot Voz do Brasil e passar os conteúdos baixados para este local;

Iniciar o programa AutomateVB e imediatamente clicar em cancelar;
Vá para a pasta AppData -> Roaming -> AutomateVB;
Abra o arquivo AutomateVB.sav com o bloco de notas e altere as variáveis CustomerID e DestinationPath para os dados corretos do cliente (caso o cliente deseje mandar mensagens de erro para um chat específico do Telegram, adicione a variável TelegramChatID);
Mude a codificação do AutomateVB.sav para "UTF-8 com BOM", rode o programa AutomateVB e espere baixar o arquivo, abra o .sav novamente, apague as linhas duplicadas, salve com a codificação "UTF-8", rode novamente o programa AutomateVB (essas modificações corrigem um erro de leitura do arquivo .sav);

Atenção , para todos os agendamentos a seguir, é necessário incluir o caminho até o bot no local de Iniciar Em;

Na aba de configurações, incluir as seguintes opções: interromper a tarefa se ela for executada por mais de uma hora e a regra para caso a tarefa já estiver sendo executada é iniciar uma nova instância em paralelo;
Crie agendamentos para a execução do AutomateVB, para todos os dias da semana e que sejam executados às 20:27 e às 20:45;
Crie um agendamento (chamado de Teste Voz do Brasil) para todos os dias da semana, às 15:30;
Caso a pasta baixada contenha um arquivo chamado excluir_vb.bat, edite com o arquivo com o bloco de notas, mudando o caminho onde o episódio da Voz do Brasil será baixado;

Caso tenha o arquivo excluir_vb.bat, crie agendamentos para sua execução, às 23:00, 16:00, 17:00 e 18:00.

Pós-Instalação¶

Abra manualmente o programa AutomateVB e, depois que ele terminar sua execução, verifique na pasta de destino se o arquivo se encontra lá;
Avise o Matheus Soppa que uma nova instalação foi realizada e passe os dados do AnyDesk para ele;
Tome um café para relaxar um pouco.

Documentação do bot da Voz do Brasil¶

Como modificar o código? Desenvolvimento
Como instalar em cliente? Instalação