Skip to main content

A Python3 abstraction class to access NUT servers for uninterruptible power supplies (UPS).

Project description

pynut3

(aka python-nut3)

PyPI version Supported Python versions PyPI downloads Code style: Black

This is a Python3 library to allow communication with NUT (Network UPS Tools) Uninterruptible Power Supply servers.

Note: This is an unofficial project, and is in no way supported or endorsed by the Network UPS Tools developers.

Requirements

Development of this package is done in Python 3.9. The package is considered forwards compatible at least upto Python 3.11 and probably also beyond. Backwards compatibility is not guaranteed; if it works on Python 3.7 or before consider yourself lucky. Python versions that are end-of-life are not supported.

Installation

pip install pynut3

Usage

Assuming you have a UPS which is connected to a host on the network with IP 192.168.2.17 it can be interogated as follows:

from pynut3 import nut3
client = nut3.PyNUT3Client(host='192.168.2.17')
print(client.help())
ups_dict = client.get_dict_ups()
for k1, v1 in ups_dict.items():
    print(f"{v1} is called with id {k1}")
    vars_dict = client.get_dict_vars(k1)
    for k2, v2 in vars_dict.items():
        print(f"{k2}\t:\t{v2}")

Please note that this module has completely and intentionally broken backwards compatibility with (previous) versions of PyNUT.

Acknowledgements

Based on various NUT Client related Python scripts, written by David Goncalves as PyNUT, and released under GPL v3.
Later overhauled by rshipp with Python3 modifications by hordurk, george2 and mezz64. Others will have contributed along the way. I was not able to reliably find their names.

Further updates in this fork are by me (Mausy5043) and based/inspired on prior work from timurlenk07, StSAV012, rshipp & Rojer-X86

License

The GPL v3 license continues to apply. See LICENSE.

Project details


Download files

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

Source Distribution

pynut3-1.4.7.tar.gz (30.4 kB view hashes)

Uploaded Source

Built Distribution

pynut3-1.4.7-py3-none-any.whl (19.0 kB view hashes)

Uploaded Python 3

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