forked from TrueCloudLab/frostfs-testcases
update readme
This commit is contained in:
parent
0857de8f77
commit
61358128bd
2 changed files with 50 additions and 9 deletions
58
README.md
58
README.md
|
@ -1,24 +1,22 @@
|
||||||
|
## Запуск тесткейсов
|
||||||
|
|
||||||
### Локальный запуск тесткейсов
|
### Локальный запуск тесткейсов
|
||||||
|
|
||||||
1. Устаносить зависимости (только для первого запуска):
|
1. Устаносить зависимости (только для первого запуска):
|
||||||
- pip3 install robotframework
|
- pip3 install robotframework
|
||||||
- pip3 install neocore
|
- pip3 install pexpect
|
||||||
- pip3 install requests
|
- pip3 install requests
|
||||||
|
|
||||||
(pip3 заменить на соответсвующий менеджер пакетов python в системе).
|
(pip3 заменить на соответсвующий менеджер пакетов python в системе).
|
||||||
|
|
||||||
При этом должен быть запущен dev-env с тестируемым окружением.
|
При этом должен быть запущен dev-env с тестируемым окружением.
|
||||||
|
|
||||||
Из корня dev-env выполнить команду:
|
|
||||||
```
|
|
||||||
docker cp wallets/wallet.json main_chain:/wallets/
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Выпольнить `make run`
|
2. Выпольнить `make run`
|
||||||
|
|
||||||
3. Логи будут доступны в папке artifacts/ после завершения тестов с любым из статусов.
|
3. Логи будут доступны в папке artifacts/ после завершения тестов с любым из статусов.
|
||||||
|
|
||||||
### Запуск произвольного тесткейса
|
### Запуск произвольного тесткейса
|
||||||
|
|
||||||
Для запуска произвольного тесткейса нужно выполнить команду:
|
Для запуска произвольного тесткейса нужно выполнить команду:
|
||||||
`robot --timestampoutputs --outputdir artifacts/ robot/testsuites/integration/<testsuite name>.robot `
|
`robot --timestampoutputs --outputdir artifacts/ robot/testsuites/integration/<testsuite name>.robot `
|
||||||
|
|
||||||
|
@ -28,8 +26,8 @@ docker cp wallets/wallet.json main_chain:/wallets/
|
||||||
* object_complex.robot - операции над простым объектом
|
* object_complex.robot - операции над простым объектом
|
||||||
* object_simple.robot - операции над большим объектом
|
* object_simple.robot - операции над большим объектом
|
||||||
|
|
||||||
|
|
||||||
### Запуск тесткейсов в докере
|
### Запуск тесткейсов в докере
|
||||||
|
|
||||||
1. Задать переменные окружения для работы с dev-env:
|
1. Задать переменные окружения для работы с dev-env:
|
||||||
```
|
```
|
||||||
export REG_USR=<registry_user>
|
export REG_USR=<registry_user>
|
||||||
|
@ -49,5 +47,49 @@ docker cp wallets/wallet.json main_chain:/wallets/
|
||||||
Для этого достаточно задать переменные окружения перед запуском `make build`.
|
Для этого достаточно задать переменные окружения перед запуском `make build`.
|
||||||
```
|
```
|
||||||
export BUILD_NEOFS_NODE=<commit or branch>
|
export BUILD_NEOFS_NODE=<commit or branch>
|
||||||
export BUILD_CLI=<commit or branch>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Создание тесткейсов
|
||||||
|
|
||||||
|
### Source code overview
|
||||||
|
|
||||||
|
`robot/` - Files related/depended on Robot Framework.
|
||||||
|
|
||||||
|
`robot/resources/` - All resources (Robot Framework Keywords, Python Libraries, etc) which could be used for creating test suites.
|
||||||
|
|
||||||
|
`robot/resources/lib/` - Common Python Libraries depended on Robot Framework (with Keywords). For example neofs.py, payment.py.
|
||||||
|
|
||||||
|
`robot/variables/` - All variables for tests. It is possible to add the auto-loading logic of parameters from the smart-contract in the future. Contain python files.
|
||||||
|
|
||||||
|
`robot/testsuites/` - Robot Test Suites and Test Cases.
|
||||||
|
|
||||||
|
`robot/testsuites/integration/` - Integration test suites and test cases
|
||||||
|
|
||||||
|
`robot/testsuites/fi/` - Fault Injection test suites and test cases
|
||||||
|
|
||||||
|
## Code style
|
||||||
|
|
||||||
|
Robot Framework keyword should use space as a separator between particular words
|
||||||
|
|
||||||
|
The name of the library function in Robot Framework keyword usage and the name of the same function in the Python library must be identical.
|
||||||
|
|
||||||
|
The name of GLOBAL VARIABLE must be in UPPER CASE, the underscore ('_')' symbol must be used as a separator between words.
|
||||||
|
|
||||||
|
The name of local variable must be in lower case, the underscore symbol must be used as a separator between words.
|
||||||
|
|
||||||
|
The names of Python variables, functions and classes must comply with accepted rules, in particular:
|
||||||
|
Name of variable/function must be in lower case with underscore symbol between words
|
||||||
|
Name of class must start with a capital letter. It is not allowed to use underscore symbol in name, use capital for each particular word.
|
||||||
|
For example: NeoFSConf
|
||||||
|
|
||||||
|
Name of other variables should not be ended with underscore symbol
|
||||||
|
|
||||||
|
On keywords definition, one should specify variable type, e.g. path: str
|
||||||
|
|
||||||
|
## Robot style
|
||||||
|
|
||||||
|
Следует всегда заполнять секции [Tags] и [Documentation] для Testcase'ов и Documentation для Test Suite'ов.
|
||||||
|
|
||||||
|
## Robot-framework User Guide
|
||||||
|
|
||||||
|
http://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html
|
|
@ -14,7 +14,6 @@ import requests
|
||||||
import json
|
import json
|
||||||
|
|
||||||
from robot.libraries.BuiltIn import BuiltIn
|
from robot.libraries.BuiltIn import BuiltIn
|
||||||
from neocore.KeyPair import KeyPair
|
|
||||||
|
|
||||||
ROBOT_AUTO_KEYWORDS = False
|
ROBOT_AUTO_KEYWORDS = False
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue