Introduction to the ByteBlower CLT
Posted by Pieter Vandercammen, Last modified by Pieter Vandercammen on 19 May 2021 05:06 PM
This article is a brief introduction to the ByteBlower CLT. This tool is strongly tied to the ByteBlower GUI. With the Command-Line-Tool (CLT) you can run your *.bbp project files from Windows CMD (Microsoft) or Terminal (MacOS and Linux). This is a fast way to start using your ByteBlower for automated testing.
We start this text with an example on the ByteBlower CLT. We will do a test run and store our reports in a specific folder. Next the article briefly lists the command line arguments to the CLT. This article comes with a number of attachments, these are found at the bottom the text.
Some familiarity with the ByteBlower GUI is assumed.
We'll use a project file created in ByteBlower GUI. This file is attached to this article, and it is found at the bottom of the text.
In summary it contains a single scenario called 'latency_under_load'. For this example, one might imagine running this scenario (and others!) as part of standard modem test. The scenario has several actions, but our main interest is running the scenario from a script. This scenario is ready to run, all ByteBlower ports are docked at the correct location. If you just downloaded the example, you will still need to perform this docking step ( how: Open the project in the GUI and dock the ports. Don't forget to save the project).
By default the CLT will store the results of a test-runs together with those of the ByteBlower GUI. As an added advantage, this allows you to access your CLT test runs from the GUI. Now, for the purpose of our example, we also wish to store all test-reports immediately at a convenient location. To this end we've created the folder latency_reports/ locally.
We're ready to start our test-run. The ByteBlower GUI is closed (remember same database-file) and we use following the command below. The explanation of the arguments is found lower. While the test-run is ongoing, the CLT will continuously output text. As we've preferred above, after the test run we will find the generated reports in the requested folder.
[Python 3.6 (and higher) code snippet]
Further steps include processing the generated reports in the CSV format. An example of such a file is found in the zip at the bottom of this article.
Of course, the ByteBlower CLT is limited to the capabilities of the GUI. Even more scriptability is possible with the ByteBlower API.
Command line arguments
To conclude, we add some more in detail on the ByteBlower CLT. The output below shows the available arguments. This list is also printed to the console on systems with a native shell.
$ ByteBlower-CLT -h