Mutate Mininet topology files with MrTopo
Project description
Mr. Topo
- Author: Faizaan Chishtie
Description
MrTopo is a python application that generates mutant Mininet topology files for network testing purposes.
MrTopo is developed in conjunction with the IoT research being conducted by Dr. Shiva Nejati at the University of Ottawa.
Basic Usage
Option 1: Install the package through pip
:
$ pip install mrtopo
- Run the following:
$ mrtopo
Usage: mrtopo [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
config-file Generate mutations from a configuration file.
python-file Mutate a Mininet python file.
validate-dir Validate a directory of Mininet topologies.
validate-file Validate a Mininet topology python file.
Option 2: Clone the repo:
- Clone this repository
- In the project directory run
$ sh set-test-env.sh
- This creates a temporary venv where mrtopo will be installed
- Run
$ mrtopo --help
- If this doesn't work try
$ source tmpenv/bin/activate
and retry$ mrtopo --help
- If this doesn't work try
Examples
- Copy the
/examples/temp_topo.py
code to a local python file namedtemp_topo.py
- Run
mrtopo python-file -f temp_topo.py
- This should create a
MrTopoGenerated
folder containing the mutated topology files generated from thetemp_topo.py
file. - Replace
temp_topo.py
with the path to your Mininet topology file.
Further Notes
Further documentation is available on the MrTopo GitHub pages site.
Links
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
mrtopo-0.1.0.tar.gz
(12.6 kB
view hashes)
Built Distribution
mrtopo-0.1.0-py3-none-any.whl
(17.2 kB
view hashes)