Skip to main content

A base to implement Jeedom daemon in python

Project description

jeedom-daemon-py

pytest 3.9

pytest 3.11

Description

This library provides everything needed to build a daemon for a plugin for Jeedom in python. It's possible to get a daemon skeleton by typing literally less than 5 lines of code.

Requirements

  • Python 3.9+

How to install

Make sure to add it in your requirements

Manually

pip3 install jeedomdaemon

Via Jeedom core packages.json

{
  "pre-install": {},
  "apt": {},
  "pip3": {
    "jeedomdaemon": {}
  },
  "npm": {},
  "yarn": {},
  "plugin": {},
  "post-install": {}
}

Via requirements.txt

jeedomdaemon~=1.0.0

Quick start

Create a file myDaemon.py and copy/past the 4 lines of code below and that's it, nothing else to do, your daemon is good to start:

from jeedomdaemon.base_daemon import BaseDaemon

class MyDaemon(BaseDaemon):
    pass

MyDaemon().run()

Of course, this does nothing so far except starting, accepting incoming requests from your php code and stopping when it is needed.

So let's add few lines in your daemon class:

from jeedomdaemon.base_daemon import BaseDaemon

class MyDaemon(BaseDaemon):
    def __init__(self) -> None:
        # Standard initialisation
        super().__init__(on_start_cb=self.on_start, on_message_cb=self.on_message, on_stop_cb=self.on_stop)

        # Add here any initialisation your daemon would need

    async def on_start(self):
        """
        This method will be called when your daemon starts.
        This is the place where you should create your tasks, login to remote system, etc
        """
        # if you don't have specific action to do on start, do not create this method
        pass


    async def on_message(self, message: list):
        """
        This function will be called once a message is received from Jeedom; check on api key is done already, just care about your logic
        You must implement the different actions that your daemon can handle.
        """
        pass

    async def on_stop(self):
        """
        This callback will be called when the daemon needs to stop`
        You need to close your remote connexions and cancel background tasks if any here.
        """
        # if you don't have specific action to do on stop, do not create this method
        pass

MyDaemon().run()

Configuration

Without additional work, your daemon will accept following argument when started by your php code:

  • --loglevel - a string (Jeedom format) giving the log Level for the daemon
  • --sockethost - usually not needed, default is '127.0.0.1'
  • --socketport - port on which the daemon will open a tcp socket to listen for incoming message from your php code
  • --callback - callback url to use by your daemon to send data to your php code
  • --apikey - the API key use to valid communication
  • --pid - the pid filename
  • --cycle - a float value giving at which frequency the daemon should send requests to your PHP code, by default every 0.5s (max)

It will happen that you need to receive some additional values from Jeedom to be able to start your daemon, like a user & password to login somewhere. In that case create a child class like in this example and provide it during daemon initialisation:

from jeedomdaemon.base_daemon import BaseDaemon
from jeedomdaemon.base_config import BaseConfig

class DemoConfig(BaseConfig):
    """This is where you declare your custom argument/configuration

    Remember that all usual arguments are managed by the BaseConfig class already so you only have to take care of yours; e.g. user & password in this case
    """
    def __init__(self):
        super().__init__()

        self.add_argument("--user", type=str, default='Harrison')
        self.add_argument("--password", type=str)

class MyDaemon(BaseDaemon):
    def __init__(self) -> None:
        # provide your custom config class during init
        super().__init__(config=DemoConfig(), on_start_cb=...)

        # ...

What's next

I suggest you to take a look at this demo plugin which implements this library

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

jeedomdaemon-1.0.2.tar.gz (12.2 kB view details)

Uploaded Source

Built Distribution

jeedomdaemon-1.0.2-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

Details for the file jeedomdaemon-1.0.2.tar.gz.

File metadata

  • Download URL: jeedomdaemon-1.0.2.tar.gz
  • Upload date:
  • Size: 12.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for jeedomdaemon-1.0.2.tar.gz
Algorithm Hash digest
SHA256 80793486fabef5ed190c9bd46b0addddf46b0beee18ab0f075f7df12418cb20d
MD5 a99e0f234f141ef2ea55bc01f983bfcb
BLAKE2b-256 500f804e792307972ddc8f76f126a6292bb02c89285397aecca0f9a2975a7380

See more details on using hashes here.

File details

Details for the file jeedomdaemon-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: jeedomdaemon-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 13.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for jeedomdaemon-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8f1b8364bfaec8ab60285321dcf065c2a156ef03cb61d97495ad3aca45cc279a
MD5 1da6c4c0854874da02877f22bd0487e4
BLAKE2b-256 5919b6649ebf8d289578d37ab716531afb3099d8a3f1c1db7da9365d40a6f910

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