TIR - Test Interface Robot
TIR is a Python module used to create test scripts for web interfaces. With it, you can easily create and execute test suites and test cases for any supported web interface systems, such as Protheus Webapp.
Current Supported Technologies
- Protheus Webapp
- APW
Table of Contents
Documentation
Installation
Config
Usage
Docker
Samples
Contact Us
Contributing
Documentation
Our documentation can be found here:
This project has a docs folder with Sphinx files.
Our create_docs.cmd script handles the installation of dependencies and creates the offline documentation on the doc_files/build/html folder.
Installation
The installation is pretty simple. All you need as a requirement is Python 3.12 (Mozilla Firefox) installed in your system.
There are three ways of installing TIR:
1. Installing and Upgrade from PyPI
TIR can be installed via pip from Pypi
pip install tir_framework --upgrade
2. via Terminal(Deprecated For The Branch Master)
You can install TIR via the terminal. Make sure your Python and Git are installed and run this command:
pip install git+https://github.com/totvs/tir.git --upgrade
It will install the last release of TIR in the active Python instance.
Config
The environment must be configured through a config.json file. You can find one to be used as a base in this repository. To select your file, you can either put it in your workspace or pass its path as a parameter of any of our classes' initialization.
Config options
Here you can find all the supported keys: Config.json keys
Custom config path
Just pass the path as a parameter in your script:
Protheus WebApp Class example:
#To use a custom path for your config.json
test_helper = Webapp("C:\PATH_HERE\config.json")
Usage
After the module is installed, you could just import it into your Test Case. See the following example:
Samples
We have a repository with different samples of TIR scripts:
Utilizando TIR com ambiente virtual
Conhecendo o conceito
Para execução do TIR em ambiente virtual, utilizaremos a biblioteca Virtualenv. Essa é uma ferramenta usada em Python para criar ambientes isolados. Cada ambiente virtual tem seus próprios diretórios de instalação de pacotes, separados do ambiente global do sistema. Isso é útil para gerenciar dependências de diferentes projetos/versões sem conflito.
Configurando com VScode
Instalando a biblioteca e Criando o ambiente
-
Abra o terminal (Prompt de Comando ou terminal do VS Code).
-
Instale o Virtualenv com o seguinte comando:
-
Crie o ambiente virtual no diretório atual:
python -m virtualenv venv
Observação: Se você tiver mais de uma versão do Python instalada, pode ser necessário especificar o caminho do executável desejado. Exemplo:
"C:/caminho/python/pythonXY/python.exe" -m pip install virtualenv "C:/caminho/python/pythonXY/python.exe" -m virtualenv venvPor padrão, o Python costuma ser instalado em:
C:\Users\[seu_usuario]\AppData\Local\Programs\Python\Python[versão]
- Após executar o comando, uma pasta chamada
venvserá criada no diretório atual.
Esse é o seu ambiente virtual, pronto para uso!
Configurando o Vscode
Após a configuração do ambiente virtual iremos definir o interpretador do VScode para utiliza-lo
-
Com o VScode aberto na pasta do projeto, pressione
Ctrl + Shift + Pe pesquise pela opção>Python: Select Interpreter -
Na lista de interpretadores reconhecidos no sistema, selecione o interpretador anteriormente criado, caminho padrão é: ./venv/Scripts/python.exe . Ao selecionar, o interpretador padrao utilizado se tornara esse, caso deseje utilizar outro é só seleciona-lo na lista.
-
Abra um novo terminal no Vscode indo em "Terminal" e "Novo terminal"
-
Ao abrir o terminal veja se está inicializada a venv na linha de comando.
-
Agora rode o comando para instalação do TIR!
pip install tir_framework --no-cache-dir --force-reinstall --upgrade -
Pronto! Agora seu tir esta pronto para executar em um ambiente isolado!.
Contact
Contributing
To contribute be sure to follow the Contribution guidelines.
Also, it's important to understand the chosen architecture.
1 maintainer
Release files for tir-framework 2.14.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tir_framework-2.14.9.tar.gz | 18.8 MB | Details |
Release files / tir_framework-2.14.9.tar.gz
| Download URL | tir_framework-2.14.9.tar.gz |
|---|---|
| Size | 18.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9814ddcc49cbdcbd0f3fd04ecdb08ccb6fb8cf756c44378d143add9383c9a1ce
|
|
BLAKE2b-256 checksum How to use checksums |
06b43557fb0fe1401ba40334e7cf35f1cf9d0616583d8e89e1dad38d11311927
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
