Python support for using the FlockLab 2 testbed (flocklab CLI, creating flocklab xml, visualization).
Project description
FlockLab Tools
This Python package provides tools for working with the FlockLab testbed.
Features:
- Python API for managing FlockLab tests
- Command-line interface (CLI) for Interfacing with FlockLab
- Programmatic creation of FlockLab test xml files (in python)
- Visualization of FlockLab test results
PyPi Webpage
Source Code
Changelog
Installation
Dependencies:
python3.6+
setuptools
,pkg_resources
,pip
,wheel
(usually pre-installed when using a virtual environment)rocketlogger
(optional, required if flocklab-tools is used to visualize test results containing powerprofiling data in therld
file format)
Install with
python -m pip install flocklab-tools
or
pip install flocklab-tools
Uninstall
python3 -m pip uninstall flocklab-tools
Usage
Command Line Interface (CLI)
System wide command:
flocklab -h
Alternative (using the python module):
python -m flocklab -h
Command Line Options:
-h, --help show this help message and exit
-v <testconfig.xml>, --validate <testconfig.xml>
validate test config
-c <testconfig.xml>, --create <testconfig.xml>
create / schedule new test
-a <testid>, --abort <testid>
abort test
-d <testid>, --delete <testid>
delete test
-g <testid>, --get <testid>
get test results (via https)
-f <testid>, --fetch <testid>
fetch test results (via webdav) [NOT IMPLEMENTED YET!]
-o <platform>, --observers <platform>
get a list of the currently available (online)
observers
-p, --platforms get a list of the available platforms
-x <result directory>, --visualize <result directory>
Visualize FlockLab result data
Visualization of FlockLab Results
flocklab -x <result directory>
Python Support
Example
from flocklab import Flocklab as fl
from flocklab import *
testId = 0
fl.getResults(testId)
fc = FlocklabXmlConfig()
fc.generalConf.name = 'Example Test'
fc.generalConf.description = 'Description of example test'
fc.generalConf.duration = 60 # duration in seconds
# ...
Development
Bug Reports / Feature Requests
Please send bug reports and feature requests to rtrueb@ethz.ch.
Installation for Development
Clone this repository and run the following from inside the root folder of the project (where setup.py
is located):
python -m pip install -e .
You can edit the source files and the module will reflect the changes automatically (the -e
option which means editable install).
License & Copyright
This project is licensed under the BSD-3-Clause license. For details, see the LICENSE file.
Copyright (c) 2020, ETH Zurich, Computer Engineering Group (TEC)
List of Contributors
- Roman Trub
- Matthias Meyer
- Reto Da Forno
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for flocklab_tools-0.2.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fc72d9f8e50518c8464a09fe23fc85b9c8ec6b4153c7d7f133bf150a4b07b81 |
|
MD5 | 5188084d9e63c98b702114b2e17ee25f |
|
BLAKE2b-256 | 224930d214543dee5cc242a38a0fa4840d4b10020ed3061bddd1d1b475b6e107 |