BBTest - TestCase based black box testing and lab

BBTest automation framework for black box testing and a virtual lab. The lab supports multiple Hosts & OSs and well as flexible network.

The test cases themselvs are written using bbtest.BBTestCase as a base class. Inherits from TestCase, so we use setup and destroy and test* methods. To run the tests you can use your favorite python tests runner (ours is pytest).

We've added a class property LAB that holds a dictionary defining the lab enviornment.

Installation

Fork and clone this repo.

Testing

In order to run all tests, you need to have python environment with all packages installed. Open a shell in the cloned repo folder:

$ pipenv shell
$ pipenv install
$ pipenv install --dev

Then take a look at pytest custom options and run tests:

$ pytest --help
$ pytest [custom options] tests

To run tests on local machine simply run

$ pytest tests

To run tests on remote machine you need to run FTP server and RPyC server on remote machine.

• Download and install python 3.7 and RPyC:

$ pip3 install rpyc
$ rpyc_classic.py --host 0.0.0.0

• Start FTP server on the remote machine with root directory set to "temp" directory (c:\temp, /tmp).
• Now you can run tests on the remote host:

$ python setup.py sdist
$ pytest --os (win|linux) --ip <IP> [--user <USER> --pw <PASSWORD>]

The examples contain tutorials and how-tos demoing parts of bbtest. You are welcome to browse the docs.
If you want to play with the framework, run ipython and you'll get an env where you can simply import bbtest.

Documentation

We are using Sphinx to publish our documentation. To generate and serve the documentation:

$ pipenv shell
$ cd docs
$ make html
$ cd _build/html
$ python -m http.server