forked from TrueCloudLab/frostfs-testlib
Add README and gitignore
Signed-off-by: Vladimir Domnich <v.domnich@yadro.com>
This commit is contained in:
parent
b4bc824b89
commit
c0bbfd1705
2 changed files with 48 additions and 0 deletions
8
.gitignore
vendored
Normal file
8
.gitignore
vendored
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
# ignore IDE files
|
||||||
|
.vscode
|
||||||
|
|
||||||
|
# ignore caches under any path
|
||||||
|
**/__pycache__
|
||||||
|
|
||||||
|
# ignore virtual environments
|
||||||
|
venv*/*
|
40
README.md
Normal file
40
README.md
Normal file
|
@ -0,0 +1,40 @@
|
||||||
|
# neofs-testlib
|
||||||
|
This library provides building blocks and utilities to facilitate development of automated tests for NeoFS system.
|
||||||
|
|
||||||
|
## Repository structure
|
||||||
|
TODO
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
TODO
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
Any contributions to the library should conform to the [contribution guideline](https://github.com/nspcc-dev/neofs-node/blob/master/CONTRIBUTING.md).
|
||||||
|
|
||||||
|
### Development Environment
|
||||||
|
To setup development environment for `neofs-testlib`, please, take the following steps:
|
||||||
|
1. Prepare virtualenv
|
||||||
|
|
||||||
|
```
|
||||||
|
$ virtualenv --python=python3.9 venv
|
||||||
|
$ source venv/bin/activate
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Install all dependencies:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ pip install -r requirements.txt
|
||||||
|
```
|
||||||
|
|
||||||
|
### Unit Tests
|
||||||
|
Before submitting any changes to the library, please, make sure that all unit tests are passing. To run the tests, please, use the following command:
|
||||||
|
```
|
||||||
|
python -m unittest discover --start-directory tests
|
||||||
|
```
|
||||||
|
|
||||||
|
To enable tests that interact with SSH server, please, setup SSH server and set the following environment variables before running the tests:
|
||||||
|
```
|
||||||
|
SSH_SHELL_HOST = <address of the server>
|
||||||
|
SSH_SHELL_LOGIN = <login that has permissions to run python3 on the server>
|
||||||
|
SSH_SHELL_PRIVATE_KEY_PATH = <path to SSH private key on your machine>
|
||||||
|
SSH_SHELL_PRIVATE_KEY_PASSPHRASE = <passphrase for the SSH private key>
|
||||||
|
```
|
Loading…
Reference in a new issue