Skip to main content

PyNetem is a tool that allow the user to limit the bandwidth or simulate weak network.

Project description


PyNetem is a tool that allow the user to limit the bandwidth or simulate weak network. It does so by using iproute's tc command, but greatly simplifies its operation. And provide apis if you need in your work.


pip install pynetem

How to Use It?

In command mode, type pynetem -h, you will see help information, parameters in this tool is same as 'tc/netem'.

If the host cannot download package from PyPI, you can use PyNetem (>=0.1.2) in your PC (no mater Windows or Linux) with the following parameters in addition:

--host          The host IP, which you will send command to
--usrname       The username of host
--password      The password of host

You can also use original command of tc/netem. For more information about tc/netem, you can click here: netem

It is recommended to use web mode, when you have several hosts to control, or you want to build a web page for easier usage.

Run in web mode: pynetem --web, default port is 8899, you can specify by yourself pynetem --web --port=9090

There are 8 APIs:

[GET] /pynetem/help                                     -- Get demo post data and simple description
[GET] /pynetem/listInterfaces                           -- Get interfaces name of host
[GET] /pynetem/getRules?eth=<interface name>            -- Get qdisc rules by interface
[GET/DELETE] /pynetem/clear?eth=<interface name>        -- Clear all rules
[POST] /pynetem/setRules?eth=<interface name>           -- Set tc qdisc rule

[POST] /pynetem/brctl/addbr                             -- Set bridge, the bridge name is pynetem_bridge by defaut
[GET/DELETE] /pynetem/brctl/delbr                       -- Delete pynetem_bridge
[POST] /pynetem/brctl/addif                             -- Add interface(s) to pynetem_bridge

Post Body, if you set parameter None or '', the parameter will be ignored.

[POST] /pynetem/setRules?eth=<interface name>

    "delay": "100ms 10ms 25%",
    "distribution": "normal",
    "reorder": "25% 50%",
    "loss": "0.3% 25%",
    "duplicate": "1%",
    "corrupt": "0.1%",
    "rate": "256kbit",
    "buffer": 1600,
    "limit": 3000,
    "dst": ""

[POST] /pynetem/brctl/addbr

stp is "on" by default.

    "interfaces": ["eth0", "eth1"],
    "stp": "on"

[POST] /pynetem/brctl/addif

    "interfaces": ["eth2"]


When you press ctrl + c to stop the web server, ALL qdisc rules in all interfaces AND the pynetem_bridge will be cleared automatically.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release. See tutorial on generating distribution archives.

Built Distribution

pynetem-0.1.4-py2.py3-none-any.whl (10.9 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page