A simple package to control PDUs
Project description
pducontrol
pducontrol is a Python library to control a wide variety of PDUs Currently we support the following models:
- SWH-1023J-08N1 (Dexlan, seems to be just an OEM rebadged unit)
- PDU81003 (CyberPower)
Installation
You can install pducontrol from source:
make pip
pip install /dist/pducontrol-*.tar.gz
or just call the refresh_package.sh
script
Usage
This package provides both Python and CLI interfaces, here is how you can use them:
In Python
from pducontrol import PDUControlREST
pdu = PDUControlREST("192.168.0.23")
print(pdu.get_all_names())
In CLI
pducontrol 192.168.0.23 get_name all
A configuration file named pdu_settings.cfg
, containing IP addresses and
credentials can be added in~/.config/pducontrol/
for ease of use and
autocompletion.
An example file is available in config
.
Contributing
Bug reports and comments are warmly welcome, but contributions, such as pull requests and patches, are not, for legal reasons only. If that's bothering you, don't hesitate to tell, with enough pressure, we could reconsider our position.
License
pducontrol is released under LGPL v3
Hacking
Execute the program from the source directory
python3 -m pducontrol
Generate a debian package
make debian
Execute the unit tests
They are located in tests/.
make test
Coding style
All python files should respect the PEP 8 coding style and shell scripts, the shellcheck coding style.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.