Skip to main content

Openhab python rule engine

Project description

OpenHAB python rule engine

A python 3.x rule engine for OpenHAB. This rule engine allows defining rule by using python 3.x.

Please consider that the OpenHAB username/password auhentication (basic authentication) needs to be enabled. To do this, open API security settings and activate advanced setting Allow Basic Authentication.

To run this software you may use Docker or PIP package manager such as shown below

Docker approach

sudo docker run -e openhab_uri=http://192.168.1.17:8080 -e user=me -e pwd=secret -v /etc/openhab2/automation/rules/python:/rules grro/pythonrule_engine 

PIP approach

sudo pip install openhab-pythonrule-engine

After this installation you may start the rule engine inside your python code or via command line using

sudo pyrule --command listen --openhab_uri http://localhost:8080 --python_rule_directory /etc/openhab2/automation/rules/python --user me --pwd secret

Here, the rule engine will connect the openhab instance running on the local machine on port 8080. Furthermore, the directory /etc/openhab2/automation/rules/python will be used to scan for python-based rules

By running a systemd-based Linux distribution you may use the register command to register and start the rule engine as systemd unit. By doing this the rule engine will be started automatically on boot. Starting the rule engine manually using the listen command is no longer necessary.

sudo pyrule --command register --openhab_uri http://localhost:8080 --python_rule_directory /etc/openhab2/automation/rules/python --user me --pwd secret

Rules

To trigger a rule methode the @when decorator has to be used. Currently, the conditions listed below are supported

condition example description
cron @when('Time cron */1 * * * *') fires based on cron expression
item state change @when('Item PhoneLisaLastSeen changed') fires when the specified Item's State changes
item command @when('Item SelectDoorCam received command ON')
@when('Item SelectDoorCam received command OFF')
fires when the specified Item receives a Command

Example: my_rule.py (located within /etc/openhab2/automation/rules/python)

from openhab_pythonrule_engine.condition import when
from openhab_pythonrule_engine.item_registry import ItemRegistry



@when("Time cron */1 * * * *") # each minute
@when("Item PhoneLisaLastSeen changed")
@when("Item PhoneTimLastSeen changed")
def update_presence_based_on_phone_seen(item_registry: ItemRegistry):
    last_time_present = item_registry.get_state_as_datetime('LastDateTimePresence')
    for phone_name in item_registry.get_group_membernames('Phones'):
        last_seen = item_registry.get_state_as_datetime(phone_name)
        print(last_seen)
        if last_seen > last_time_present:
            last_time_present = last_seen
    item_registry.set_state('LastDateTimePresence', last_time_present)

If the rule method defines a (single!) argument, the item_registry object will be injected automatically. The item_registry provides methods to get and set the item state. By setting the state the data value will be auto converted into the item specific data type

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

openhab_pythonrule_engine-1.1.5.tar.gz (14.5 kB view details)

Uploaded Source

Built Distribution

openhab_pythonrule_engine-1.1.5-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

Details for the file openhab_pythonrule_engine-1.1.5.tar.gz.

File metadata

  • Download URL: openhab_pythonrule_engine-1.1.5.tar.gz
  • Upload date:
  • Size: 14.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for openhab_pythonrule_engine-1.1.5.tar.gz
Algorithm Hash digest
SHA256 9f81c3b0ad2d3d5ec1dd84214a62ce01b5beba655052a2bdccf0c6b8d6b10bb8
MD5 e5e8185d3c785dce3f5a3aad83d57d73
BLAKE2b-256 ef7ee640a8916c63d52e869c2c4d8f612b778b2ec2f7892b2eb57ffbbfa282fc

See more details on using hashes here.

File details

Details for the file openhab_pythonrule_engine-1.1.5-py3-none-any.whl.

File metadata

  • Download URL: openhab_pythonrule_engine-1.1.5-py3-none-any.whl
  • Upload date:
  • Size: 21.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for openhab_pythonrule_engine-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 27fe37103f40fe5aae7b4ad948c21284f717f9813b34102e70a8a87c2dda877e
MD5 1a29f88e64b13b943b8914870bf1864a
BLAKE2b-256 f4ea477bccd312b14bd2d88339f010767ddd06de03c6826fe74c7c0dd8c464e2

See more details on using hashes here.

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