A base to implement Jeedom daemon in python
Project description
jeedom-daemon-py
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
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 80793486fabef5ed190c9bd46b0addddf46b0beee18ab0f075f7df12418cb20d |
|
MD5 | a99e0f234f141ef2ea55bc01f983bfcb |
|
BLAKE2b-256 | 500f804e792307972ddc8f76f126a6292bb02c89285397aecca0f9a2975a7380 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8f1b8364bfaec8ab60285321dcf065c2a156ef03cb61d97495ad3aca45cc279a |
|
MD5 | 1da6c4c0854874da02877f22bd0487e4 |
|
BLAKE2b-256 | 5919b6649ebf8d289578d37ab716531afb3099d8a3f1c1db7da9365d40a6f910 |