python-kasa/devtools/README.md
Teemu R d75e1adaba
Add perftest to devtools (#236)
* Add perftest to devtools

* Add example output from the perf script

* Rename to avoid pytest collection

* Fix git mv failing to remove the original file..
2021-10-13 19:22:24 +02:00

62 lines
1.9 KiB
Markdown

# Tools for developers
This directory contains some simple scripts that can be useful for developers.
## dump_devinfo
* Queries the device and returns a fixture that can be added to the test suite
```shell
Usage: dump_devinfo.py [OPTIONS] HOST
Generate devinfo file for given device.
Options:
-d, --debug
--help Show this message and exit.
```
## parse_pcap
* Requires dpkt (pip install dpkt)
* Reads a pcap file and prints out the device communications
```shell
Usage: parse_pcap.py [OPTIONS] FILE
Parse pcap file and pretty print the communications and some statistics.
Options:
--help Show this message and exit.
```
## perftest
* Runs several rounds of update cycles for the given list of addresses, and prints out statistics about the performance
```shell
Usage: perf_test.py [OPTIONS] [ADDRS]...
Options:
--rounds INTEGER
--help Show this message and exit.
```
```shell
$ python perf_test.py 192.168.xx.x 192.168.xx.y 192.168.xx.z 192.168.xx.f
Running 5 rounds on ('192.168.xx.x', '192.168.xx.y', '192.168.xx.z', '192.168.xx.f')
=== Testing using gather on all devices ===
took
count mean std min 25% 50% 75% max
type
concurrently 5.0 0.097161 0.045544 0.05260 0.055332 0.088811 0.143082 0.145981
sequential 5.0 0.150506 0.005798 0.14162 0.149065 0.150499 0.155579 0.155768
=== Testing per-device performance ===
took
count mean std min 25% 50% 75% max
id
<id>-HS110(EU) 5.0 0.044917 0.014984 0.035836 0.037728 0.037950 0.041610 0.071458
<id>-KL130(EU) 5.0 0.067626 0.032027 0.046451 0.046797 0.048406 0.076136 0.120342
<id>-HS110(EU) 5.0 0.055700 0.016174 0.042086 0.045578 0.048905 0.059869 0.082064
<id>-KP303(UK) 5.0 0.010298 0.003765 0.007773 0.007968 0.008546 0.010439 0.016763
```