pducontrol 1.2.1

A simple package to control PDUs

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)
• EG-PMS2-LAN (Energenie) (partial support only, no name getting setting and no reboot / powercycle)

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.