Python "Olá Bot"¶

Este tutorial o guiará pelo processo de criação de uma automação Python simples.

Pré-requisitos¶

• Conta BotCity
• BotCity Studio SDK
• Python 3.7 ou superior

Criando seu Primeiro Projeto¶

A BotCity oferece um modelo de projeto que pode ser personalizado por meio de uma ferramenta chamada cookiecutter.

Instalando o Cookiecutter¶

Para criarmos um projeto, precisamos primeiro instalar o pacote Python do cookiecutter, executando o seguinte comando em seu terminal de linha de comando:

python -m pip install --upgrade cookiecutter

Depois de fazer isso, você está pronto para criar sua primeira automação Python utilizando o framework da BotCity.

Utilizando o Modelo de Projeto¶

Com o cookiecutter devidamente instalado, é hora de fazer uso dele e criar um novo projeto.

Para criarmos um novo projeto usando o modelo de projeto, vamos invocar o cookiecutter e fornecer como argumento a URL do repositório onde os templates da BotCity estão localizados:

python -m cookiecutter https://github.com/botcity-dev/bot-python-template/archive/main.zip

O sistema irá solicitar algumas respostas para criar seu projeto.

• Quando solicitado project_type escolha a opção 1 para Desktop e pressione enter;
• Para bot_id, digite HelloBot e pressione enter;
• Em project_name, digite Hello Bot e pressione enter;
• Para project_short_description, digite Meu primeiro projeto utilizando BotCity e pressione enter.

Após o término do processo acima, uma nova pasta chamada HelloBot estará disponível.

Explorando o Projeto¶

Dentro da pasta do seu projeto HelloBot, você deverá ter a seguinte estrutura:

HelloBot
├── MANIFEST.in      <- Este arquivo define o conteúdo do pacote.
├── README.md        <- Arquivo README simples para seu projeto de bot.
├── VERSION          <- Este arquivo define a versão do pacote do Bot.
├── HelloBot         <- Módulo principal para o pacote do Bot.
│   ├── __init__.py
│   ├── __main__.py  <- Ponto de entrada para o módulo. Não há necessidade de se preocupar com este arquivo.
│   ├── bot.py       <- Aqui é onde iremos trabalhar e desenvolver nosso robô.
│   └── resources    <- Pasta contendo os arquivos auxiliares para o robô.
├── build.bat        <- Script em Batch para gerar o pacote.
├── build.sh         <- Shell script para gerar o pacote.
├── requirements.txt <- Arquivo descrevendo todas dependencias externas para seu robô.
└── setup.py         <- Arquivo de configuração para o pacote.

Testando seu Projeto Localmente¶

Para testarmos nosso projeto localmente, vamos primeiro instalá-lo para termos todas as dependências do Python configuradas.

Utilizando a linha de comando, acesse a pasta HelloBot que descrevemos acima.

Instalando o Projeto¶

A partir desta pasta execute o comando abaixo para instalar seu projeto em modo de desenvolvimento:

pip install -e .

Este comando vai produzir uma saída grande referente a instalação de todas as dependências como, por exemplo, o botcity-framework-core e outras.

Depois que esse processo terminar, você deverá ver uma saída semelhante a esta:

<... other output from installation ...>
  Running setup.py develop for HelloBot
Successfully installed HelloBot-1.0 ...

A mensagem importante aqui é: Successfuly installed HelloBot-1.0.

Isso significa que seu projeto já está pronto para ser executado.

Executando o Robô¶

Nosso modelo de projeto roda um código de exemplo bem simples. Este projeto apenas abre seu navegador padrão e carrega a página da BotCity.

Você pode executar seu HelloBot com o seguinte comando:

python -m HelloBot

Aqui está uma captura de tela do resultado esperado:

Conclusão¶

Neste tutorial você aprendeu:

• As dependências necessárias para desenvolver automações usando o framework Python da BotCity e como instalá-las.

• Como criar novos projetos de Bot usando o cookiecutter e o modelo de projeto da BotCity.

• Como instalar e executar seu novo projeto localmente.

Divirta-se automatizando 🤖

Próximos Passos¶

Agora é hora de carregar seu projeto com o BotCity Studio e começar a criar suas automações com Visão Computacional e toda a produtividade que nossa ferramenta oferece.