noix (French for nut, pronounced /nwa/) is a client library that allows to communicate with a compatible Network UPS Tools (NUT) server.

To use this package, create a virtual environment and install with PIP:

python -m venv .venv
source .venv/bin/activate
pip install noix

First, create a NUT object with your server information. For instance, if your server runs on the same machine and your UPS is named my_ups:

from noix import NUT

server = NUT("127.0.0.1", "my_ups", username="myusername", password="myverysecurepassword")

You can now use your object to get your UPS information:

# Print the battery charge:
print(await server.get("battery.charge"))

To change a variable value:

# Set the battery charge low alert threshold to 15%:
await server.set("battery.charge.low", 15)

You can also call a command:

# Turn off the UPS:
await server.call("load.off")

To get a list of the commands and variables exposed by the UPS:

await server.list_commands()
await server.list_vars()